imageWatermark

Add centered watermark text to selected supported images or every supported image in the current folder.

Function

imageWatermark(watermarkText="PREETAM", textSize=100, transparency=45, angle=25, source=None)

Parameters

watermarkText

Type: str, default "PREETAM"

Text drawn over the center of each image.

textSize

Type: int, default 100

Font size in pixels. Must be greater than zero.

transparency

Type: int, default 45

Pillow alpha value from 0 to 255. `0` is invisible and `255` is fully opaque.

angle

Type: number, default 25

Rotation angle in degrees. `0` is horizontal; positive and negative values rotate the watermark.

source

Type: path, iterable of paths, or None

Optional image input. If omitted, all supported images in the current folder are discovered.

Returns

A list of `Path` objects for the watermarked images, or `None` when no images are found.

Examples

Watermark all images

imageWatermark()

Customize the watermark

imageWatermark("CONFIDENTIAL", textSize=80, transparency=70, angle=30)

Watermark resized images

imageWatermark(source=imageResize(1600, 1200))

Dynamic input behavior

When source is omitted, Toolvix discovers matching files in the current working folder. When source is supplied, only the supplied files are processed. This makes nested pipelines deterministic.

Back to function index · Nesting and chaining