# ConvertTo-ImageVisualArtifact

Converts a ChartForgeX chart, grid, canvas, story, diagram, table, sequence, flow, or visual block into a reusable visual artifact.

Project

ImagePlayground

Automate image processing, codes, metadata, charts, topology, and visual stories from PowerShell.

[View on GitHub](https://github.com/EvotecIT/ImagePlayground) [Visit Website](#) [Releases](https://github.com/EvotecIT/ImagePlayground/releases) [Changelog](#) [Get package](https://www.powershellgallery.com/packages/ImagePlayground)

Stars **102**

Forks **7**

Open issues 

Total downloads **708,853**

Release **ImagePlayground-PowerShellModule.v3.2.7**

Language: C# Updated: 2026-11-18

Command 

**Module**

`ImagePlayground`

**Inputs**

`System.Object`

**Outputs**

`ChartForgeX.VisualArtifacts.VisualArtifact`

Converts a ChartForgeX chart, grid, canvas, story, diagram, table, sequence, flow, or visual block into a reusable visual artifact.

## Syntax

```
ConvertTo-ImageVisualArtifact
[-AccessibleDescription <String>]
[-AccessibleName <String>]
[-Decorative]
[-Id <String>]
[-InputObject] <Object>
[-Language <String>]
[-Subtitle <String>]
[-Title <String>]
[<CommonParameters>]
```

[#](#method-convertto-imagevisualartifact-string-string-switchparameter-string-object-string-string-string)

Parameter set: `All Parameter Sets`

## Description

The artifact is the portable handoff contract for static export, OfficeIMO document placement, and native editable Visio projection.

## Examples

### Create an artifact from a topology

```powershell
$artifact = $topology | ConvertTo-ImageVisualArtifact -Id service-map -AccessibleDescription 'Gateway to database service path.'
```

Creates a reusable artifact that can be exported by ImagePlayground or placed by PSWriteOffice.

## Parameters

**-AccessibleDescription String optional**

Longer accessible description for the visual.

**-AccessibleName String optional**

Concise accessible name for the visual.

**-Decorative SwitchParameter optional**

Marks the visual as decorative.

**-Id String optional**

Stable artifact identifier. Existing artifact ids are preserved when omitted.

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

ChartForgeX model or existing visual artifact.

**-Language String optional**

Optional BCP 47 language tag for accessible text.

**-Subtitle String optional**

Optional artifact subtitle override.

**-Title String optional**

Optional artifact title override.

## 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).

Evotec API Reference Copyright 2026 Evotec Services

<!-- PowerForge markdown artifact sha256:7923A8A7548E02043B28E6CC92FBA38C6985310B2C0005DCF0569D8F867BB0EB -->
