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
Seam-Carving-Skalierung, die Pixel entlang wenig wichtiger Pfade hinzufügt oder entfernt, um Schlüsselinhalte und Gesichter zu bewahren.	f383b28ab62a	human	f93b84234ca9

Inhaltsbasierte Skalierung

Seam-Carving-Skalierung, die Pixel entlang der Pfade mit der geringsten visuellen Bedeutung intelligent entfernt oder hinzufügt, dabei wichtige Inhalte bewahrt und optional Gesichter schützt.

API-Endpunkt

POST /api/v1/tools/image/content-aware-resize

Verarbeitung: Synchron (gibt das Ergebnis direkt zurück)

Modell-Bundle: Für den Grundbetrieb keines erforderlich. Der Gesichtsschutz verwendet, sofern aktiviert, das Bundle face-detection (200-300 MB).

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
file	file	Ja	-	Bilddatei (Multipart)
width	number	Nein	-	Zielbreite in Pixeln
height	number	Nein	-	Zielhöhe in Pixeln
protectFaces	boolean	Nein	`false`	Gesichter erkennen und vor der Seam-Entfernung schützen
blurRadius	number	Nein	`4`	Weichzeichnungsradius für die Vorverarbeitung zur Energieberechnung (0-20)
sobelThreshold	number	Nein	`2`	Schwellenwert für die Sobel-Kantenerkennung (1-20). Höhere Werte machen den Algorithmus aggressiver
square	boolean	Nein	`false`	Auf ein Quadrat skalieren (verwendet die kleinere Abmessung)

Mindestens eines von width, height oder square muss angegeben werden.

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/content-aware-resize \
  -F "file=@landscape.jpg" \
  -F 'settings={"width":800,"protectFaces":true}'

Antwort (200 OK)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/{jobId}/landscape_seam.png",
  "originalSize": 450000,
  "processedSize": 380000,
  "width": 800,
  "height": 600
}

Hinweise

Diese benutzerdefinierte Route gibt derzeit eine synchrone 200-Antwort zurück.
Verwendet die Seam-Carving-Bibliothek caire für die inhaltsbasierte Skalierung.
Verkleinert nur die Abmessungen (entfernt Seams). Kann ein Bild nicht über seine ursprüngliche Größe hinaus vergrößern.
Die Option protectFaces nutzt die KI-Gesichtserkennung, um Gesichtsbereiche als hochenergetisch zu markieren und zu verhindern, dass Seams durch Gesichter verlaufen.
blurRadius steuert die Glättung vor der Berechnung der Energiekarte. Höhere Werte machen die Energiekarte gleichmäßiger, was bei verrauschten Bildern helfen kann.
sobelThreshold beeinflusst, wie aggressiv Kanten erkannt werden. Niedrigere Werte bewahren feinere Kanten.
Die Ausgabe ist immer im PNG-Format.
Unterstützt die Eingabeformate HEIC/HEIF, RAW, TGA, PSD, EXR und HDR durch automatische Dekodierung.

2.9 KiB Raw Blame History