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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Formatierte Textüberlagerungen mit Schlagschatten und Hintergrundflächen hinzufügen.	9f8e697188fc	human	ba2b534496b5

Textüberlagerung

Fügt Bildern formatierten Text mit optionalem Schlagschatten und halbtransparenter Hintergrundfläche hinzu. Geeignet für Titel, Bildunterschriften oder Anmerkungen auf Fotos.

API-Endpunkt

POST /api/v1/tools/image/text-overlay

Nimmt Multipart-Formulardaten mit einer Bilddatei und einem JSON-Feld settings entgegen.

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
text	string	Ja	-	Zu überlagernder Text (1 bis 500 Zeichen)
fontSize	number	Nein	`48`	Schriftgröße in Pixeln (8 bis 200)
color	string	Nein	`"#FFFFFF"`	Textfarbe im Hexformat (`#RRGGBB`)
position	string	Nein	`"bottom"`	Vertikale Platzierung: `top`, `center`, `bottom`
backgroundBox	boolean	Nein	`false`	Ein halbtransparentes Hintergrundrechteck hinter dem Text anzeigen
backgroundColor	string	Nein	`"#000000"`	Farbe der Hintergrundfläche im Hexformat (`#RRGGBB`)
shadow	boolean	Nein	`true`	Einen Schlagschatten hinter dem Text anwenden

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/text-overlay \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"text": "Hello World", "fontSize": 64, "color": "#FFFFFF", "position": "bottom", "shadow": true}'

Mit einer Hintergrundfläche:

curl -X POST http://localhost:1349/api/v1/tools/image/text-overlay \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"text": "Caption", "fontSize": 36, "position": "bottom", "backgroundBox": true, "backgroundColor": "#000000"}'

Beispielantwort

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

Hinweise

Der Text ist innerhalb des Bildes immer horizontal zentriert.
Der Schlagschatten verwendet einen Versatz von 2px mit 3px Weichzeichnung bei 70 % schwarzer Deckkraft.
Die Hintergrundfläche erstreckt sich über die gesamte Bildbreite bei 70 % Deckkraft, mit einer Höhe proportional zur Schriftgröße (1,8-fach).
Der Text wird über eine SVG-Komposition gerendert, daher wird die serifenlose Standardschriftart des Systems verwendet.
XML-Sonderzeichen im Text werden sicher maskiert.
Das Ausgabeformat entspricht dem Eingabeformat. HEIC-, RAW-, PSD- und SVG-Eingaben werden vor der Verarbeitung automatisch dekodiert.

2.8 KiB Raw Blame History