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.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Ein Logo oder Bild als Wasserzeichen mit konfigurierbarer Position, Deckkraft und Skalierung überlagern.	c73ab0ef8ab9	human	83d4a51e2169

Bild-Wasserzeichen

Überlagert ein Logo oder ein sekundäres Bild als Wasserzeichen auf einem Basisbild. Das Wasserzeichen wird relativ zur Breite des Basisbildes skaliert und an einer Ecke oder in der Mitte positioniert.

API-Endpunkt

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

Nimmt Multipart-Formulardaten mit zwei Bilddateien und einem JSON-Feld settings entgegen.

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
position	string	Nein	`"bottom-right"`	Platzierung des Wasserzeichens: `center`, `top-left`, `top-right`, `bottom-left`, `bottom-right`
opacity	number	Nein	`50`	Deckkraft des Wasserzeichens in Prozent (0 bis 100)
scale	number	Nein	`25`	Breite des Wasserzeichens als Prozentsatz der Hauptbildbreite (1 bis 100)

Dateifelder

Feldname	Erforderlich	Beschreibung
file	Ja	Das Haupt-/Basisbild
watermark	Ja	Das Wasserzeichen-/Logobild

Beispielanfrage

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

Beispielantwort

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

Hinweise

Beide Bilder werden validiert und dekodiert (HEIC, RAW, PSD, SVG werden unterstützt).
Das Wasserzeichen wird proportional so skaliert, dass seine Breite scale % der Hauptbildbreite entspricht.
Die Deckkraft wird über eine mit dest-in-Überblendung komponierte Alphamaske angewendet.
Eckpositionen verwenden einen Abstand von 20px zum Bildrand.
Wenn das Wasserzeichenbild Transparenz aufweist (z. B. ein PNG-Logo), wird diese beim Zusammensetzen erhalten.
Die EXIF-Ausrichtung wird bei beiden Bildern vor der Verarbeitung automatisch angewendet.

2.4 KiB Raw Blame History