Cmdlet

ConvertTo-OfficeVisual

Aliases: OfficeVisual

Module: PSWriteOffice
Aliases: OfficeVisual
Inputs: System.Object
Outputs: OfficeIMO.ChartForgeX.OfficeVisualConversionResult
Source: ConvertToOfficeVisualCommand.cs:17 Edit on GitHub

Converts a ChartForgeX visual artifact into a reusable OfficeIMO representation.

Syntax

ConvertTo-OfficeVisual
[-AlternativeText <String>]
[-Height <Double>]
[-Id <String>]
[-InputObject] <Object>
[-MaximumSvgElements <Int32>]
[-MaximumSvgViewportDimension <Double>]
[-MaximumSvgViewportPixels <Double>]
[-PointsPerPixel <Double>]
[-SvgPolicy <PreserveVector|RasterizeWhenNeeded|RequireVector>]
[-Title <String>]
[-Width <Double>]
[<CommonParameters>]

Parameter set: All Parameter Sets

Examples

Prepare one chart for multiple Office outputs.

$officeVisual = $artifact | ConvertTo-OfficeVisual -Width 420 -SvgPolicy RasterizeWhenNeeded

Creates one fidelity report and placement payload that can be reused in Word, Excel, PowerPoint, and PDF.

Parameters

-AlternativeText String optional: Optional accessible description for an SVG file input.
-Height Double optional: Optional output height in Office points.
-Id String optional: Optional stable identifier for an SVG file input.
-InputObject Object requiredposition: 0pipeline: True (ByValue): ChartForgeX VisualArtifact, OfficeVisualSource, prepared conversion, or portable SVG file path.
-MaximumSvgElements Int32 optional: Optional OfficeIMO SVG import element limit.
-MaximumSvgViewportDimension Double optional: Optional maximum SVG viewport width or height. Increase the safe default only for trusted input.
-MaximumSvgViewportPixels Double optional: Optional maximum SVG viewport area in pixels. Increase the safe default only for trusted input.
-PointsPerPixel Double optional: Conversion factor from ChartForgeX pixels to Office points.
-SvgPolicy OfficeVisualSvgPolicy optional: SVG fidelity policy used by OfficeIMO.ChartForgeX.; Possible values: PreserveVector, RasterizeWhenNeeded, RequireVector
-Title String optional: Optional title for an SVG file input.
-Width Double optional: Optional output width in Office points.

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.