# New-ImageChartOptions

Creates renderer options for New-ImageChart. Review available syntax, parameters, pipeline guidance, and reference details in ImagePlayground API Reference.

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**

`None`

**Outputs**

`ImagePlayground.ChartRenderOptions`

Creates renderer options for New-ImageChart.

## Syntax

```
New-ImageChartOptions
[-DonutCenterLabel <String>]
[-DonutCenterValue <String>]
[-DonutInnerRadiusRatio <Double>]
[-HeatmapScale <Sequential|Semantic>]
[-LegendPosition <Bottom|Top|Left|Right>]
[-NoAxes]
[-NoCard]
[-NoHeatmapScale]
[-NoLegend]
[-NoPlotBackground]
[-NoProgressHandles]
[-Palette <ChartColor[]>]
[-PictorialColumns <Int32>]
[-PictorialSymbol <ChartPictorialSymbol>]
[-PieLabelContent <Label|Value|Percent|LabelAndValue|LabelAndPercent>]
[-ProgressMaximum <Double>]
[-ShowDataLabels]
[-ShowLegend]
[-ShowPointLegend]
[-TickCount <Int32>]
[-Transparent]
[-WordCloudMaximumTerms <Int32>]
[<CommonParameters>]
```

[#](#member-3d1cd2927492d84925a5c6eb)

Parameter set: `All Parameter Sets`

## Examples

### Create options for a labeled chart with a right-side legend

```powershell
New-ImageChartOptions -ShowLegend -LegendPosition Right -ShowDataLabels -Palette '#8B5CF6','#2DD4BF'
```

## Parameters

**-DonutCenterLabel String optional**

Donut center label text.

**-DonutCenterValue String optional**

Donut center value text.

**-DonutInnerRadiusRatio Double optional**

Donut inner radius ratio.

**-HeatmapScale ChartHeatmapColorScale optional**

Heatmap color scale.

Possible values: `Sequential`, `Semantic`

**-LegendPosition ChartLegendPosition optional**

Legend placement.

Possible values: `Bottom`, `Top`, `Left`, `Right`

**-NoAxes SwitchParameter optional**

Hide axes.

**-NoCard SwitchParameter optional**

Hide chart card surface.

**-NoHeatmapScale SwitchParameter optional**

Hide heatmap scale legend.

**-NoLegend SwitchParameter optional**

Hide the legend.

**-NoPlotBackground SwitchParameter optional**

Hide plot background surface.

**-NoProgressHandles SwitchParameter optional**

Hide progress handles.

**-Palette ChartColor[] optional**

Palette colors used by series and point-based charts.

**-PictorialColumns Int32 optional**

Pictorial columns per row.

**-PictorialSymbol ChartPictorialSymbol optional**

Pictorial symbol.

Possible values: `Circle`, `Square`, `Diamond`, `Triangle`, `Star`, `Person`

**-PieLabelContent ChartPieLabelContent optional**

Pie and donut slice label content.

Possible values: `Label`, `Value`, `Percent`, `LabelAndValue`, `LabelAndPercent`

**-ProgressMaximum Double optional**

Progress maximum.

**-ShowDataLabels SwitchParameter optional**

Show data labels.

**-ShowLegend SwitchParameter optional**

Show the legend.

**-ShowPointLegend SwitchParameter optional**

Show point-level legend entries.

**-TickCount Int32 optional**

Preferred number of axis ticks.

**-Transparent SwitchParameter optional**

Use transparent background.

**-WordCloudMaximumTerms Int32 optional**

Maximum number of word cloud terms.

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

## Outputs

ImagePlayground.ChartRenderOptions: Renderer-neutral chart options exposed by ImagePlayground.

Evotec API Reference Copyright 2026 Evotec Services

<!-- PowerForge markdown artifact sha256:99BD11265ED892D4A0D83A29545871A39A55FCA4B020F755DB6204770EE7C08E -->
