# New-ImageChartAnnotation

Creates chart annotation data item. 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`

Creates chart annotation data item.

## Syntax

```
New-ImageChartAnnotation
[-Arrow]
[-Text] <String>
[-X] <Double>
[-Y] <Double>
[<CommonParameters>]
```

[#](#method-new-imagechartannotation-switchparameter-string-double-double)

Parameter set: `All Parameter Sets`

## Description

Use this cmdlet with New-ImageChart to highlight notable points on a generated chart.

## Examples

### Create a chart annotation

```powershell
New-ImageChartAnnotation -X 3 -Y 61 -Text 'Peak usage' -Arrow
```

Creates an annotation definition that can be passed to New-ImageChart via -Annotation or -AnnotationsDefinition.

## Parameters

**-Arrow SwitchParameter optional**

Display arrow.

**-Text String requiredposition: 2**

Annotation text.

**-X Double requiredposition: 0**

X coordinate for annotation.

**-Y Double requiredposition: 1**

Y coordinate for annotation.

## 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:5A80F211CE52EDE9BE8207D2692A0EC2BB3973E0178F7111F30C7D69984195D6 -->
