# New-ImageCanvasText

Creates a positioned text layer for a visual canvas.

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

`ChartForgeX.Composition.VisualCanvasTextLayer`

Creates a positioned text layer for a visual canvas.

## Syntax

```
New-ImageCanvasText
[-Alignment <Left|Center|Right>]
[-Color <ChartColor>]
[-Emphasized]
[-FontSize <Double>]
[-Text] <String>
[-Width] <Double>
[-X] <Double>
[-Y] <Double>
[<CommonParameters>]
```

[#](#method-new-imagecanvastext-textalignment-chartcolor-switchparameter-double-string-double-double-double)

Parameter set: `All Parameter Sets`

## Examples

### Create a social-preview heading

```powershell
New-ImageCanvasText -X 72 -Y 70 -Width 900 -Text 'Release 3.3' -FontSize 56 -Color White -Emphasized
```

## Parameters

**-Alignment TextAlignment optional**

Text alignment within the layer width.

Possible values: `Left`, `Center`, `Right`

**-Color ChartColor optional**

Text color.

**-Emphasized SwitchParameter optional**

Use the emphasized text treatment.

**-FontSize Double optional**

Font size in canvas design pixels.

**-Text String requiredposition: 3**

Text to render.

**-Width Double requiredposition: 2**

Text layout width.

**-X Double requiredposition: 0**

Horizontal position in canvas design pixels.

**-Y Double requiredposition: 1**

Vertical position in canvas design pixels.

## 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:71927C4FFC86457E151AA7E59E755B99B28E1F16895CF4CCC73046747CD69193 -->
