Project

ImagePlayground

Automate image processing, codes, metadata, charts, topology, and visual stories from PowerShell.

View on GitHub Releases Get package
Stars 100
Forks 7
Total downloads 712,347
Release ImagePlayground-PowerShellModule.v3.2.7
Language: C# Updated: 2026-08-25

API Reference

Command

Add-ImageWatermark

Namespace ImagePlayground
Inputs
None

Adds a watermark image to another image.

Remarks

Adds a watermark image to another image.

Examples

Authored help example

Watermark a photo


Add-ImageWatermark -FilePath photo.png -OutputPath out.png -WatermarkPath logo.png -Placement BottomRight

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.

Syntax

Add-ImageWatermark -FilePath <String> [-FlipMode <Horizontal|Vertical>] [-Opacity <Single>] -OutputPath <String> [-Padding <Single>] [-Placement <TopLeft|TopRight|BottomLeft|BottomRight|Middle>] [-Rotate <Int32>] [-Spacing <Int32>] -WatermarkPath <String> [-WatermarkPercentage <Int32>] [<CommonParameters>]
#
Parameter set: Placement

Parameters

FilePath String requiredposition: 0pipeline: False
Path to the source image.
FlipMode FlipMode optionalposition: namedpipeline: Falsevalues: 2
Flip mode for the image.
Possible values: Horizontal, Vertical
Opacity Single optionalposition: namedpipeline: False
Opacity of the watermark.
OutputPath String requiredposition: 1pipeline: False
Destination path for the watermarked image.
Padding Single optionalposition: namedpipeline: False
Padding around the watermark.
Placement WatermarkPlacement optionalposition: namedpipeline: Falsevalues: 5
Watermark placement when coordinates are not specified.
Possible values: TopLeft, TopRight, BottomLeft, BottomRight, Middle
Rotate Int32 optionalposition: namedpipeline: False
Rotation angle in degrees.
Spacing Int32 optionalposition: namedpipeline: False
Tile watermark across the image with given spacing.
WatermarkPath String requiredposition: 2pipeline: False
Image used as the watermark.
WatermarkPercentage Int32 optionalposition: namedpipeline: False
Scale of the watermark relative to the image.
Add-ImageWatermark -FilePath <String> [-FlipMode <Horizontal|Vertical>] [-Opacity <Single>] -OutputPath <String> [-Rotate <Int32>] [-Spacing <Int32>] -WatermarkPath <String> [-WatermarkPercentage <Int32>] [-X <Int32>] [-Y <Int32>] [<CommonParameters>]
#
Parameter set: Coordinates

Parameters

FilePath String requiredposition: 0pipeline: False
Path to the source image.
FlipMode FlipMode optionalposition: namedpipeline: Falsevalues: 2
Flip mode for the image.
Possible values: Horizontal, Vertical
Opacity Single optionalposition: namedpipeline: False
Opacity of the watermark.
OutputPath String requiredposition: 1pipeline: False
Destination path for the watermarked image.
Rotate Int32 optionalposition: namedpipeline: False
Rotation angle in degrees.
Spacing Int32 optionalposition: namedpipeline: False
Tile watermark across the image with given spacing.
WatermarkPath String requiredposition: 2pipeline: False
Image used as the watermark.
WatermarkPercentage Int32 optionalposition: namedpipeline: False
Scale of the watermark relative to the image.
X Int32 optionalposition: namedpipeline: False
X coordinate for custom placement.
Y Int32 optionalposition: namedpipeline: False
Y coordinate for custom placement.