# New-ImageVisualWatermark

Creates a deterministic text or image watermark for ChartForgeX visual artifacts.

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.VisualArtifacts.VisualWatermark`

Creates a deterministic text or image watermark for ChartForgeX visual artifacts.

## Syntax

```
New-ImageVisualWatermark
[-Anchor <VisualCanvasAnchor>]
[-Color <ChartColor>]
[-FontSize <Double>]
[-OffsetX <Double>]
[-OffsetY <Double>]
[-Opacity <Double>]
[-Padding <Double>]
[-Repeat]
[-RepeatSpacingX <Double>]
[-RepeatSpacingY <Double>]
[-RotationDegrees <Double>]
[-Scale <Double>]
[-Text] <String>
[<CommonParameters>]
```

[#](#method-new-imagevisualwatermark-visualcanvasanchor-chartcolor-double-double-double-double-double-switchparameter-double-double-double-double-string)

Parameter set: `Text`

```
New-ImageVisualWatermark
[-Anchor <VisualCanvasAnchor>]
[-ImagePath] <String>
[-OffsetX <Double>]
[-OffsetY <Double>]
[-Opacity <Double>]
[-Padding <Double>]
[-Repeat]
[-RepeatSpacingX <Double>]
[-RepeatSpacingY <Double>]
[-RotationDegrees <Double>]
[-Scale <Double>]
[<CommonParameters>]
```

[#](#method-new-imagevisualwatermark-visualcanvasanchor-string-double-double-double-double-switchparameter-double-double-double-double)

Parameter set: `Image`

## Examples

### Create a centered confidential watermark

```powershell
$mark = New-ImageVisualWatermark -Text CONFIDENTIAL -Anchor Center -RotationDegrees -28 -Opacity 0.15
```

The watermark can be passed to Export-ImageVisualArtifact or New-ImageTopology.

## Parameters

**-Anchor VisualCanvasAnchor optional**

Watermark anchor on the artifact canvas.

Possible values: `TopLeft`, `TopCenter`, `TopRight`, `MiddleLeft`, `Center`, `MiddleRight`, `BottomLeft`, `BottomCenter`, `BottomRight`

**-Color ChartColor optionalsets: Text**

Text color.

**-FontSize Double optionalsets: Text**

Base text size in pixels.

**-OffsetX Double optional**

Horizontal offset from the selected anchor.

**-OffsetY Double optional**

Vertical offset from the selected anchor.

**-Opacity Double optional**

Watermark opacity from zero to one.

**-Padding Double optional**

Inset from anchored canvas edges.

**-Repeat SwitchParameter optional**

Render repeated watermark tiles across the canvas.

**-RepeatSpacingX Double optional**

Horizontal spacing between repeated watermark anchors.

**-RepeatSpacingY Double optional**

Vertical spacing between repeated watermark anchors.

**-RotationDegrees Double optional**

Clockwise watermark rotation in degrees.

**-Scale Double optional**

Positive watermark scale.

**-Text String requiredposition: 0sets: Text**

Watermark text.

**-ImagePath String requiredposition: 0sets: Image**

Raster watermark image path.

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