PDF 워터마크

pdf-watermark

Add Watermark to PDF 기능을 Zavilo SDK에서 사용하는 방법입니다. 아래에서 입력 제한, 파라미터, 출력 형식과 지원 모드를 확인할 수 있습니다.

H · HeadlessI · InteractiveE · Embedded

도구 IDpdf-watermark

버전1

실행 방식CLIENT

지원 모드Headless, Interactive, Embedded

빠른 이동

입력 파일 1출력 파일 1

결과 처리 가이드 → 레시피 → 연동 예제 → 플레이그라운드 →

입력

이 Tool이 허용하는 입력 형식과 파일 개수입니다.

입력 종류	file
파일 수	1 – 1
허용 MIME 형식	application/pdf

파라미터

아래 값은 request.options에 전달합니다.

파라미터	타입	필수	기본값	허용값 / 범위	설명
`type`	enum	선택	`text`	text \| image	Text or image watermark. Image mode requires input.data.watermarkFile as a PNG/JPG File.
`text`	string	선택	`CONFIDENTIAL`	—	Watermark text for text mode.
`color`	string	선택	`#64748b`	—	처리에 사용할 색상을 지정합니다.
`opacity`	number	선택	`28`	5 – 100	투명도를 설정합니다.
`size`	number	선택	`42`	10 – 80	출력 크기를 설정합니다.
`rotation`	number	선택	`-35`	-90 – 90	회전 각도를 설정합니다.
`position`	enum	선택	`center`	top-left \| top-center \| top-right \| middle-left \| center \| middle-right \| bottom-left \| bottom-center \| bottom-right \| custom	결과에서 적용할 위치를 설정합니다.
`pages`	enum	선택	`all`	all \| selected	Apply to all pages or only pageRange.
`pageRange`	string	선택	`1`	—	Selected pages, for example 1,3,5-8.
`boxX`	number	선택	`0.29`	0 – 1	Custom box left coordinate from 0 to 1.
`boxY`	number	선택	`0.43`	0 – 1	Custom box top coordinate from 0 to 1.
`boxWidth`	number	선택	`0.42`	0.08 – 0.9	Custom box width from 0 to 1.

출력

처리가 완료되면 반환되는 결과 형식입니다.

출력 종류	files
파일 수	1 – 1
출력 MIME	application/pdf
Metadata	pageCount, appliedPages, inputBytes, outputBytes, outputCount
ZIP 묶음	미지원

기본 사용 예제

지원되는 연동 모드를 확인하고 생성된 시작 코드를 바로 복사할 수 있습니다.

Headless

const result = await client.run("pdf-watermark", {
  file,
  options: { type: "text", text: "CONFIDENTIAL", color: "#64748b", opacity: 28 }
});
console.log(result.files, result.data, result.metadata);

Interactive

await client.open({
  tool: "pdf-watermark",
  input: { file },
  options: { type: "text", text: "CONFIDENTIAL", color: "#64748b", opacity: 28 },
  onComplete(result) { console.log(result.files, result.data, result.metadata); }
});

Embedded

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

이 명세는 실제 SDK 런타임이 사용하는 Tool Definition을 기준으로 자동 생성됩니다.