# New-ImageCanvas

Creates a fixed-size visual canvas for social images, wallpapers, report covers, and announcement cards.

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

`ChartForgeX.Composition.VisualCanvas` `ChartForgeX.Composition.VisualCanvasLayer[]`

**Outputs**

`ChartForgeX.Composition.VisualCanvas`

Creates a fixed-size visual canvas for social images, wallpapers, report covers, and announcement cards.

## Syntax

```
New-ImageCanvas
[-Backdrop <Transparent|Plain|TechHorizon>]
[-BackgroundBottom <ChartColor>]
[-BackgroundTop <ChartColor>]
-FilePath <String>
[-Height <Int32>]
[-LayerDefinition] <ScriptBlock>
[-PassThru]
[-PngOutputScale <Int32>]
[-Preset <Custom|SocialPreview|DesktopWallpaper>]
[-Show]
[-Title <String>]
[-Width <Int32>]
[<CommonParameters>]
```

[#](#method-new-imagecanvas-visualcanvasbackdropstyle-chartcolor-chartcolor-string-int32-scriptblock-switchparameter-int32-imagecanvaspreset-switchparameter-string-int32)

Parameter set: `Definition`

```
New-ImageCanvas
[-Backdrop <Transparent|Plain|TechHorizon>]
[-BackgroundBottom <ChartColor>]
[-BackgroundTop <ChartColor>]
-FilePath <String>
[-Height <Int32>]
-Layer <VisualCanvasLayer[]>
[-PassThru]
[-PngOutputScale <Int32>]
[-Preset <Custom|SocialPreview|DesktopWallpaper>]
[-Show]
[-Title <String>]
[-Width <Int32>]
[<CommonParameters>]
```

[#](#method-new-imagecanvas-visualcanvasbackdropstyle-chartcolor-chartcolor-string-int32-visualcanvaslayer-switchparameter-int32-imagecanvaspreset-switchparameter-string-int32)

Parameter set: `Layer`

```
New-ImageCanvas
[-Backdrop <Transparent|Plain|TechHorizon>]
[-BackgroundBottom <ChartColor>]
[-BackgroundTop <ChartColor>]
-Canvas <VisualCanvas>
-FilePath <String>
[-PassThru]
[-PngOutputScale <Int32>]
[-Show]
[-Title <String>]
[<CommonParameters>]
```

[#](#method-new-imagecanvas-visualcanvasbackdropstyle-chartcolor-chartcolor-visualcanvas-string-switchparameter-int32-switchparameter-string)

Parameter set: `Canvas`

## Description

Layer commands emit native ChartForgeX layers; ImagePlayground only binds PowerShell inputs and selects the output format.

## Guides & Samples

Authored walkthroughs and practical samples linked to this command.

- [Choose an ImagePlayground workflow](/projects/imageplayground/docs/workflows/) Guide
  
  Choose between image processing, codes, metadata, charts, topology, and visual-story workflows.
- [Curated ImagePlayground examples](/projects/imageplayground/examples/) Example
  
  Start with focused PowerShell examples, including branch-aware organization hierarchy rendering.

## Examples

### Create a social preview

```powershell
New-ImageCanvas -Preset SocialPreview -Title 'ChartForgeX 1.3' -Backdrop TechHorizon -LayerDefinition { New-ImageCanvasText -X 72 -Y 72 -Width 1000 -Text 'ChartForgeX 1.3' -FontSize 58 -Color White -Emphasized; New-ImageCanvasInfoTile -X 72 -Y 190 -Width 360 -Height 150 -Icon SVG -Label 'Renderer' -Value 'Dependency-free' } -FilePath preview.png
```

## Parameters

**-Backdrop VisualCanvasBackdropStyle optional**

Built-in canvas backdrop.

Possible values: `Transparent`, `Plain`, `TechHorizon`

**-BackgroundBottom ChartColor optional**

Bottom background color for a vertical gradient.

**-BackgroundTop ChartColor optional**

Top or solid background color.

**-FilePath String required**

Output image path.

**-Height Int32 optionalsets: Definition, Layer**

Custom canvas height.

**-LayerDefinition ScriptBlock requiredposition: 0sets: Definition**

Script block that emits visual canvas layers.

**-PassThru SwitchParameter optional**

Write the configured ChartForgeX canvas to the pipeline.

**-PngOutputScale Int32 optional**

PNG output pixel multiplier.

**-Preset ImageCanvasPreset optionalsets: Definition, Layer**

Built-in canvas size preset.

Possible values: `Custom`, `SocialPreview`, `DesktopWallpaper`

**-Show SwitchParameter optional**

Open the generated canvas.

**-Title String optional**

Accessibility title for SVG output.

**-Width Int32 optionalsets: Definition, Layer**

Custom canvas width.

**-Layer VisualCanvasLayer[] requiredpipeline: True (ByValue)sets: Layer**

Canvas layers supplied directly or through the pipeline.

**-Canvas VisualCanvas requiredpipeline: True (ByValue)sets: Canvas**

Existing ChartForgeX visual canvas to render.

## 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:7BA6CFF9A8C65ABA1630EF891B895CE9E3A40FAC9ACCC992D970E78CEE1D5872 -->
