# ConvertTo-OfficeVisioVisual

Converts CFX semantic visual-artifact input into a native editable OfficeIMO.Visio document.

Cmdlet 

**Module**

`PSWriteOffice`

**Inputs**

`System.Object`

**Outputs**

`OfficeIMO.ChartForgeX.OfficeVisioVisualConversionResult`

**Source**

[ConvertToOfficeVisioVisualCommand.cs:17](https://github.com/EvotecIT/OfficeIMO/blob/3b680b1b6fb15a268ff5525a4ca6cdd70b2f6613/PowerShell/PSWriteOffice/Sources/PSWriteOffice/Cmdlets/Visio/ConvertToOfficeVisioVisualCommand.cs#L17) 

Converts CFX semantic visual-artifact input into a native editable OfficeIMO.Visio document.

## Syntax

```
ConvertTo-OfficeVisioVisual
[-InputObject] <Object>
[-NoGroups]
[-NoHyperlinks]
[-NoShapeData]
[-NoTitle]
[-PageName <String>]
[-PixelsPerInch <Double>]
[-UseNaturalPageSize]
[<CommonParameters>]
```

[#](#method-convertto-officevisiovisual-object-switchparameter-switchparameter-switchparameter-switchparameter-string-double-switchparameter)

Parameter set: `InputObject`

## Examples

### Convert an ImagePlayground topology into editable Visio objects.

```powershell
$visio = $topology | ConvertTo-ImageVisualArtifact | ConvertTo-OfficeVisioVisual
$visio.Document | Save-OfficeVisio -Path .\Topology.vsdx
```

Consumes the portable CFX semantic payload and returns the document, page, and fidelity report.

## Parameters

**-InputObject Object requiredposition: 0pipeline: True (ByValue)**

Typed CFX artifact, semantic envelope/JSON, ImagePlayground portable artifact, or prior conversion result.

**-NoGroups SwitchParameter optional**

Do not create native Visio containers for CFX groups or lanes.

**-NoHyperlinks SwitchParameter optional**

Do not copy safe CFX links onto native Visio shapes and connectors.

**-NoShapeData SwitchParameter optional**

Do not copy CFX metadata, ports, and details into Visio Shape Data.

**-NoTitle SwitchParameter optional**

Do not add the artifact title as an editable Visio title.

**-PageName String optional**

Name of the generated Visio page.

**-PixelsPerInch Double optional**

Pixel density used with -UseNaturalPageSize.

**-UseNaturalPageSize SwitchParameter optional**

Use the CFX natural pixel size as the minimum Visio page size.

## 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](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters).

<!-- PowerForge markdown artifact sha256:77C16C6E2187B69F88F2DFDE95C50F420EBB243FF7F82206AA248975582AA32F -->
