Cmdlet
ConvertTo-OfficeVisual
Converts a ChartForgeX visual artifact into a reusable OfficeIMO representation.
Syntax
ConvertTo-OfficeVisual
[-AlternativeText <String>]
[-Height <OfficeLength>]
[-Id <String>]
[-InputObject] <Object>
[-MaximumSvgElements <Int32>]
[-MaximumSvgViewportDimension <Double>]
[-MaximumSvgViewportPixelCount <Int64>]
[-PointsPerPixel <Double>]
[-SvgPolicy <PreserveVector| RasterizeWhenNeeded| RequireVector>]
[-Title <String>]
[-Width <OfficeLength>]
[<CommonParameters>]#Parameter set:
VisualExamples
Prepare one chart for multiple Office outputs.
$officeVisual = $artifact | ConvertTo-OfficeVisual -Width 420 -SvgPolicy RasterizeWhenNeededCreates one fidelity report and placement payload that can be reused in Word, Excel, PowerPoint, and PDF.
Parameters
- -AlternativeText String
- Accessible description for the visual or placed image.
- -Height OfficeLength
- Optional output height; numbers mean points and unit suffixes are accepted.
- -Id String
- Optional stable identifier for an SVG file input.
- -InputObject Object
- ChartForgeX VisualArtifact, OfficeVisualSource, prepared conversion, or portable SVG file path.
- -MaximumSvgElements Int32
- Optional OfficeIMO SVG import element limit.
- -MaximumSvgViewportDimension Double
- Optional maximum SVG viewport width or height. Increase the safe default only for trusted input.
- -MaximumSvgViewportPixelCount Int64
- Optional maximum SVG viewport area in pixels. Increase the safe default only for trusted input.
- -PointsPerPixel Double
- Conversion factor from ChartForgeX pixels to Office points.
- -SvgPolicy OfficeVisualSvgPolicy
- SVG fidelity policy used by OfficeIMO.ChartForgeX.
- Possible values:
PreserveVector,RasterizeWhenNeeded,RequireVector - -Title String
- Optional title for an SVG file input.
- -Width OfficeLength
- Optional output width; numbers mean points and unit suffixes are accepted.
Common Parameters
This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
For more information, see about_CommonParameters.