mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.

2026-07-15 21:55:51 +08:00

3.3 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Menajamkan gambar menggunakan metode adaptive, unsharp mask, atau high-pass dengan pengurangan noise opsional.	66dce4068899	human	1990226b51e3

Pertajam Gambar

Alat penajaman lanjutan dengan tiga metode: adaptive (cerdas dan sadar-tepi), unsharp mask (radius/amount klasik), dan high-pass (penekanan tekstur). Menyertakan pengurangan noise bawaan untuk mencegah artefak penajaman.

API Endpoint

POST /api/v1/tools/image/sharpening

Menerima data formulir multipart dengan sebuah file gambar dan field JSON settings.

Parameters

Parameter	Type	Required	Default	Description
method	string	No	`"adaptive"`	Algoritma penajaman: `adaptive`, `unsharp-mask`, `high-pass`
sigma	number	No	`1.0`	Adaptive: sigma Gaussian (0.5 hingga 10)
m1	number	No	`1.0`	Adaptive: penajaman area datar (0 hingga 10)
m2	number	No	`3.0`	Adaptive: penajaman area bergerigi (0 hingga 20)
x1	number	No	`2.0`	Adaptive: ambang datar/bergerigi (0 hingga 10)
y2	number	No	`12`	Adaptive: penajaman datar maksimum (0 hingga 50)
y3	number	No	`20`	Adaptive: penajaman bergerigi maksimum (0 hingga 50)
amount	number	No	`100`	Unsharp mask: jumlah penajaman (0 hingga 1000)
radius	number	No	`1.0`	Unsharp mask: radius blur dalam piksel (0.1 hingga 5)
threshold	number	No	`0`	Unsharp mask: perbedaan kecerahan minimum untuk menajamkan (0 hingga 255)
strength	number	No	`50`	High-pass: kekuatan filter (0 hingga 100)
kernelSize	number	No	`3`	High-pass: ukuran kernel konvolusi (3 atau 5)
denoise	string	No	`"off"`	Pengurangan noise sebelum penajaman: `off`, `light`, `medium`, `strong`

Example Request

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

Unsharp mask dengan threshold untuk melindungi area yang halus:

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

Example Response

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

Notes

Hanya parameter yang relevan dengan metode yang dipilih yang digunakan. Misalnya, amount, radius, dan threshold diabaikan ketika method bernilai adaptive.
Metode adaptive menggunakan penajaman adaptif bawaan Sharp dengan perilaku area datar/bergerigi yang dapat dikonfigurasi.
Opsi denoise menerapkan pengurangan noise sebelum penajaman untuk mencegah penguatan noise/grain.
Penajaman high-pass mengekstrak detail halus dengan mengurangi versi yang di-blur dari gambar asli, lalu memadukannya kembali.
Format keluaran mengikuti format masukan. Masukan HEIC, RAW, PSD, dan SVG otomatis didekode sebelum diproses.

3.3 KiB Raw Blame History