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
Nałóż logo lub obraz jako znak wodny z konfigurowalną pozycją, nieprzezroczystością i skalą.	c73ab0ef8ab9	human	e20ea49a024c

Znak wodny z obrazu

Nałóż logo lub dodatkowy obraz jako znak wodny na obraz bazowy. Znak wodny jest skalowany względem szerokości obrazu bazowego i umieszczany w narożniku lub na środku.

Punkt końcowy API

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

Przyjmuje dane formularza multipart z dwoma plikami obrazów i polem JSON settings.

Parametry

Parametr	Typ	Wymagany	Domyślny	Opis
position	string	Nie	`"bottom-right"`	Umieszczenie znaku wodnego: `center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`
opacity	number	Nie	`50`	Procent nieprzezroczystości znaku wodnego (0 do 100)
scale	number	Nie	`25`	Szerokość znaku wodnego jako procent szerokości głównego obrazu (1 do 100)

Pola plików

Nazwa pola	Wymagany	Opis
file	Tak	Główny/bazowy obraz
watermark	Tak	Obraz znaku wodnego/logo

Przykładowe żądanie

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}'

Przykładowa odpowiedź

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

Uwagi

Oba obrazy są walidowane i dekodowane (obsługiwane HEIC, RAW, PSD, SVG).
Znak wodny jest skalowany proporcjonalnie tak, aby jego szerokość równała się scale% szerokości głównego obrazu.
Nieprzezroczystość jest stosowana przez maskę alfa złożoną z mieszaniem dest-in.
Pozycje narożne stosują margines 20px od krawędzi obrazu.
Jeśli obraz znaku wodnego ma przezroczystość (np. logo PNG), jest ona zachowywana podczas komponowania.
Orientacja EXIF jest automatycznie stosowana do obu obrazów przed przetwarzaniem.

2.3 KiB Raw Blame History