mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

2.3 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Melapisi logo atau gambar sebagai watermark dengan posisi, opasitas, dan skala yang dapat dikonfigurasi.	c73ab0ef8ab9	human	62e699511ea6

Image Watermark

Melapisi logo atau gambar sekunder sebagai watermark pada gambar dasar. Watermark diskalakan relatif terhadap lebar gambar dasar dan diposisikan di sudut atau tengah.

API Endpoint

POST /api/v1/tools/image/watermark-image

Menerima data formulir multipart dengan dua file gambar dan field JSON settings.

Parameters

Parameter	Type	Required	Default	Description
position	string	No	`"bottom-right"`	Penempatan watermark: `center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`
opacity	number	No	`50`	Persentase opasitas watermark (0 hingga 100)
scale	number	No	`25`	Lebar watermark sebagai persentase dari lebar gambar utama (1 hingga 100)

File Fields

Field Name	Required	Description
file	Yes	Gambar utama/dasar
watermark	Yes	Gambar watermark/logo

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/watermark-image \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F "watermark=@logo.png" \
  -F 'settings={"position": "bottom-right", "opacity": 60, "scale": 20}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 2520000
}

Notes

Kedua gambar divalidasi dan didekode (HEIC, RAW, PSD, SVG didukung).
Watermark diubah ukurannya secara proporsional sehingga lebarnya sama dengan scale% dari lebar gambar utama.
Opasitas diterapkan melalui alpha mask yang dikomposit dengan pemaduan dest-in.
Posisi sudut menggunakan padding 20px dari tepi gambar.
Jika gambar watermark memiliki transparansi (mis., logo PNG), transparansi tersebut dipertahankan selama pengomposisian.
Orientasi EXIF diterapkan secara otomatis pada kedua gambar sebelum diproses.

2.3 KiB Raw Blame History