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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Bildern in einer vorhersehbaren, steuerbaren Reihenfolge Rahmen, Abstände, abgerundete Ecken und Schlagschatten hinzufügen.	8845150736a9	human	d78cfae90fa8

Rahmen & Einfassung

Fügt Bildern Rahmen, Abstände, abgerundete Ecken und Schlagschatten hinzu. Das Werkzeug wendet die Effekte in dieser Reihenfolge an: Abstand, Rahmen, Eckenradius, dann Schatten.

API-Endpunkt

POST /api/v1/tools/image/border

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
borderWidth	number	Nein	10	Rahmenstärke in Pixeln (0 bis 2000)
borderColor	string	Nein	`"#000000"`	Rahmenfarbe als hex (z. B. `#FF0000`)
padding	number	Nein	0	Innenabstand zwischen Bild und Rahmen in Pixeln (0 bis 200)
paddingColor	string	Nein	`"#FFFFFF"`	Füllfarbe des Abstands als hex
cornerRadius	number	Nein	0	Eckenradius in Pixeln (0 bis 2000)
shadow	boolean	Nein	`false`	Ob ein Schlagschatten hinzugefügt wird
shadowBlur	number	Nein	15	Schattenweichzeichnungsradius (1 bis 200)
shadowOffsetX	number	Nein	0	Horizontaler Schattenversatz (-50 bis 50)
shadowOffsetY	number	Nein	5	Vertikaler Schattenversatz (-50 bis 50)
shadowColor	string	Nein	`"#000000"`	Schattenfarbe als hex
shadowOpacity	number	Nein	40	Schattendeckkraft in Prozent (0 bis 100)

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/border \
  -F "file=@photo.jpg" \
  -F 'settings={"borderWidth":20,"borderColor":"#333333","cornerRadius":16,"shadow":true,"shadowBlur":25,"shadowOpacity":50}'

Beispielantwort

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.png",
  "originalSize": 456789,
  "processedSize": 523456
}

Hinweise

Verwendet die Standard-Factory createToolRoute. Nimmt eine einzelne Bilddatei über einen Multipart-Upload entgegen.
Unterstützt die Eingabeformate HEIC, RAW, PSD und SVG (automatisch dekodiert).
Verarbeitungsreihenfolge: Zuerst wird der Abstand hinzugefügt, dann legt sich der Rahmen darum, dann wird der Eckenradius angewendet, dann wird der Schatten eingesetzt.
Wenn cornerRadius oder shadow aktiviert ist, wird die Ausgabe (unabhängig vom Eingabeformat) auf PNG erzwungen, um die Transparenz zu erhalten. Formate, die Alpha unterstützen (PNG, WebP, AVIF), behalten ihr ursprüngliches Format.
Der Schatten ist formbewusst: Er folgt den abgerundeten Ecken, statt einen rechteckigen Schatten zu erzeugen.
Setzt man borderWidth auf 0 und verwendet nur cornerRadius + shadow, entsteht ein rahmenloser abgerundeter Schatteneffekt.

2.9 KiB Raw Blame History