Batch Image Watermark

batch-image-watermark

Use Batch Image Watermark through the Zavilo SDK. Check input limits, parameters, output and supported modes below.

H · HeadlessI · InteractiveE · Embedded

Tool IDbatch-image-watermark

バージョン1

実行方式CLIENT

対応モードHeadless, Interactive, Embedded

クイック操作

入力ファイル 1–30出力ファイル 1–30

結果処理ガイド → レシピ → 統合サンプル → Playground →

入力

この Tool が受け付ける入力形式とファイル数です。

入力種類	file
ファイル数	1 – 30
対応 MIME	image/jpeg, image/png, image/webp

パラメータ

これらの値は request.options で渡します。

パラメータ	型	必須	既定値	許可値 / 範囲	説明
`type`	enum	任意	`text`	text \| image	Watermark type. For image type, pass input.data.watermarkFile as a File.
`text`	string	任意	`© Your Brand`	—	Text watermark content.
`color`	string	任意	`#ffffff`	—	Text watermark color.
`opacity`	number	任意	`55`	5 – 100	Watermark opacity percentage.
`size`	number	任意	`24`	5 – 60	Watermark width as percentage of source width.
`rotation`	number	任意	`-30`	-180 – 180	Watermark rotation in degrees.
`margin`	number	任意	`4`	0 – 15	Edge margin percentage.
`position`	enum	任意	`bottom-right`	top-left \| top-center \| top-right \| middle-left \| center \| middle-right \| bottom-left \| bottom-center \| bottom-right	Watermark position.
`format`	enum	任意	`jpg`	jpg \| png	Output format.
`quality`	number	任意	`0.92`	0.6 – 1	JPG quality.

出力

処理完了後に返される結果形式です。

型	files
ファイル数	1 – 30
出力 MIME	image/jpeg, image/png
Metadata	inputBytes, outputBytes, outputCount
ZIP アーカイブ	対応 · threshold 2

基本例

対応する統合モードを確認し、生成された開始コードをコピーできます。

Headless

const result = await client.run("batch-image-watermark", {
  files: selectedFiles,
  options: { type: "text", text: "© Your Brand", color: "#ffffff", opacity: 55 }
});
console.log(result.files, result.data, result.metadata);

Interactive

await client.open({
  tool: "batch-image-watermark",
  input: { files: selectedFiles },
  options: { type: "text", text: "© Your Brand", color: "#ffffff", opacity: 55 },
  onComplete(result) { console.log(result.files, result.data, result.metadata); }
});

Embedded

await client.mount({ tool: "batch-image-watermark", target: "#zavilo-tool", mode: "embedded" });

This page is generated from the SDK Tool Definition used by the runtime.