API Reference

Cmdlet

ConvertTo-OfficeVisioPng

Aliases: ConvertTo-VisioPng
Namespace PSWriteOffice
Aliases
ConvertTo-VisioPng
Inputs
System.String OfficeIMO.Visio.VisioDocument
Outputs
System.Byte[] System.IO.FileInfo

Exports a Visio document page to native dependency-free PNG.

Remarks

Exports a Visio document page to native dependency-free PNG.

Examples

Authored help example

Export a diagram preview to PNG.

PS>


New-OfficeVisio -Path .\ServiceMap.vsdx { VisioRectangle -Text 'API' -X 2 -Y 4 }
            ConvertTo-OfficeVisioPng -Path .\ServiceMap.vsdx -OutputPath .\ServiceMap.png -PixelsPerInch 144
        

Creates a diagram and exports the first page to a PNG preview.

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.

Syntax

ConvertTo-OfficeVisioPng [-BackgroundColor <String>] [-FontCollectionIndex <Nullable`1>] [-FontFaceName <String>] [-FontFilePath <String>] [-NoConnectorLabelOverlapResolution] [-NoConnectorLabels] [-NoStencilArtwork] [-NoText] [-OutputPath <String>] [-PageIndex <Int32>] -Path <String> [-PixelsPerInch <Nullable`1>] [-Show] [-Supersampling <Nullable`1>] [-Transparent] [<CommonParameters>]
#
Parameter set: Path

Parameters

BackgroundColor String optionalposition: namedpipeline: False
Background color name or hex value. Use -Transparent for transparent output.
FontCollectionIndex Nullable`1 optionalposition: namedpipeline: False
Optional zero-based font collection index.
FontFaceName String optionalposition: namedpipeline: False
Optional font face name used when selecting from a font collection.
FontFilePath String optionalposition: namedpipeline: False
Optional TrueType/OpenType font file used for text outlines.
NoConnectorLabelOverlapResolution SwitchParameter optionalposition: namedpipeline: False
Do not resolve connector label overlaps at export time.
NoConnectorLabels SwitchParameter optionalposition: namedpipeline: False
Do not render connector labels.
NoStencilArtwork SwitchParameter optionalposition: namedpipeline: False
Do not render built-in stencil artwork.
NoText SwitchParameter optionalposition: namedpipeline: False
Do not render shape text.
OutputPath String optionalposition: namedpipeline: Falsealiases: OutPath
Optional output PNG path.
PageIndex Int32 optionalposition: namedpipeline: False
Zero-based page index to export.
Path String requiredposition: 0pipeline: True (ByValue)aliases: FilePath
Visio .vsdx path.
PixelsPerInch Nullable`1 optionalposition: namedpipeline: False
PNG pixels per Visio inch.
Show SwitchParameter optionalposition: namedpipeline: False
Open the PNG after saving.
Supersampling Nullable`1 optionalposition: namedpipeline: False
Supersampling factor for smoother raster output.
Transparent SwitchParameter optionalposition: namedpipeline: False
Use transparent PNG background.

Outputs

System.Byte[] System.IO.FileInfo

ConvertTo-OfficeVisioPng [-BackgroundColor <String>] -Document <VisioDocument> [-FontCollectionIndex <Nullable`1>] [-FontFaceName <String>] [-FontFilePath <String>] [-NoConnectorLabelOverlapResolution] [-NoConnectorLabels] [-NoStencilArtwork] [-NoText] [-OutputPath <String>] [-PageIndex <Int32>] [-PixelsPerInch <Nullable`1>] [-Show] [-Supersampling <Nullable`1>] [-Transparent] [<CommonParameters>]
#
Parameter set: Document

Parameters

BackgroundColor String optionalposition: namedpipeline: False
Background color name or hex value. Use -Transparent for transparent output.
Document VisioDocument requiredposition: namedpipeline: True (ByValue)
Visio document object.
FontCollectionIndex Nullable`1 optionalposition: namedpipeline: False
Optional zero-based font collection index.
FontFaceName String optionalposition: namedpipeline: False
Optional font face name used when selecting from a font collection.
FontFilePath String optionalposition: namedpipeline: False
Optional TrueType/OpenType font file used for text outlines.
NoConnectorLabelOverlapResolution SwitchParameter optionalposition: namedpipeline: False
Do not resolve connector label overlaps at export time.
NoConnectorLabels SwitchParameter optionalposition: namedpipeline: False
Do not render connector labels.
NoStencilArtwork SwitchParameter optionalposition: namedpipeline: False
Do not render built-in stencil artwork.
NoText SwitchParameter optionalposition: namedpipeline: False
Do not render shape text.
OutputPath String optionalposition: namedpipeline: Falsealiases: OutPath
Optional output PNG path.
PageIndex Int32 optionalposition: namedpipeline: False
Zero-based page index to export.
PixelsPerInch Nullable`1 optionalposition: namedpipeline: False
PNG pixels per Visio inch.
Show SwitchParameter optionalposition: namedpipeline: False
Open the PNG after saving.
Supersampling Nullable`1 optionalposition: namedpipeline: False
Supersampling factor for smoother raster output.
Transparent SwitchParameter optionalposition: namedpipeline: False
Use transparent PNG background.

Outputs

System.Byte[] System.IO.FileInfo