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

3.5 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Bilder mit adaptiven, Unschärfemaskierungs- oder Hochpass-Verfahren schärfen, optional mit Rauschreduzierung.	ccb60af9faae	human	0d7818436c69

Schärfen

Erweitertes Schärfungswerkzeug mit drei Verfahren: adaptiv (intelligent kantenbewusst), Unschärfemaskierung (klassisch mit Radius/Stärke) und Hochpass (Texturbetonung). Enthält eine integrierte Rauschreduzierung, um Schärfungsartefakte zu vermeiden.

API-Endpunkt

POST /api/v1/tools/image/sharpening

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

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
method	string	Nein	`"adaptive"`	Schärfungsalgorithmus: `adaptive`, `unsharp-mask`, `high-pass`
sigma	number	Nein	`1.0`	Adaptiv: Gauß-Sigma (0,5 bis 10)
m1	number	Nein	`1.0`	Adaptiv: Schärfung in flachen Bereichen (0 bis 10)
m2	number	Nein	`3.0`	Adaptiv: Schärfung in zerklüfteten Bereichen (0 bis 20)
x1	number	Nein	`2.0`	Adaptiv: Schwellenwert flach/zerklüftet (0 bis 10)
y2	number	Nein	`12`	Adaptiv: maximale Schärfung in flachen Bereichen (0 bis 50)
y3	number	Nein	`20`	Adaptiv: maximale Schärfung in zerklüfteten Bereichen (0 bis 50)
amount	number	Nein	`100`	Unschärfemaskierung: Schärfungsstärke (0 bis 1000)
radius	number	Nein	`1.0`	Unschärfemaskierung: Weichzeichnungsradius in Pixeln (0,1 bis 5)
threshold	number	Nein	`0`	Unschärfemaskierung: minimaler Helligkeitsunterschied zum Schärfen (0 bis 255)
strength	number	Nein	`50`	Hochpass: Filterstärke (0 bis 100)
kernelSize	number	Nein	`3`	Hochpass: Größe des Faltungskerns (3 oder 5)
denoise	string	Nein	`"off"`	Rauschreduzierung vor dem Schärfen: `off`, `light`, `medium`, `strong`

Beispielanfrage

curl -X POST http://localhost:1349/api/v1/tools/image/sharpening \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"method": "adaptive", "sigma": 1.5}'

Unschärfemaskierung mit Schwellenwert, um glatte Bereiche zu schützen:

curl -X POST http://localhost:1349/api/v1/tools/image/sharpening \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"method": "unsharp-mask", "amount": 150, "radius": 1.5, "threshold": 10}'

Beispielantwort

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

Hinweise

Es werden nur die für das gewählte Verfahren relevanten Parameter verwendet. Beispielsweise werden amount, radius und threshold ignoriert, wenn method den Wert adaptive hat.
Das adaptive Verfahren nutzt die integrierte adaptive Schärfung von Sharp mit konfigurierbarem Verhalten für flache/zerklüftete Regionen.
Die Option denoise wendet vor dem Schärfen eine Rauschreduzierung an, um eine Verstärkung von Rauschen/Körnung zu verhindern.
Die Hochpass-Schärfung extrahiert feine Details, indem eine weichgezeichnete Version vom Original subtrahiert und anschließend wieder eingemischt wird.
Das Ausgabeformat entspricht dem Eingabeformat. HEIC-, RAW-, PSD- und SVG-Eingaben werden vor der Verarbeitung automatisch dekodiert.

3.5 KiB Raw Blame History