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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
アダプティブ、アンシャープマスク、ハイパスの各手法で画像をシャープ化し、オプションでノイズ低減も行います。	66dce4068899	human	d5113ae4e40c

画像をシャープに

3つの手法を備えた高度なシャープ化ツールです。アダプティブ（スマートなエッジ認識）、アンシャープマスク（従来のradius/amount指定）、ハイパス（テクスチャ強調）に対応します。シャープ化によるアーティファクトを防ぐノイズ低減機能を内蔵しています。

API Endpoint

POST /api/v1/tools/image/sharpening

画像ファイルとJSON形式のsettingsフィールドを含むmultipartフォームデータを受け付けます。

Parameters

Parameter	Type	Required	Default	Description
method	string	No	`"adaptive"`	シャープ化アルゴリズム: `adaptive`, `unsharp-mask`, `high-pass`
sigma	number	No	`1.0`	アダプティブ: ガウシアンのsigma（0.5〜10）
m1	number	No	`1.0`	アダプティブ: 平坦領域のシャープ化（0〜10）
m2	number	No	`3.0`	アダプティブ: ギザギザ領域のシャープ化（0〜20）
x1	number	No	`2.0`	アダプティブ: 平坦/ギザギザのしきい値（0〜10）
y2	number	No	`12`	アダプティブ: 平坦領域の最大シャープ化（0〜50）
y3	number	No	`20`	アダプティブ: ギザギザ領域の最大シャープ化（0〜50）
amount	number	No	`100`	アンシャープマスク: シャープ化の強さ（0〜1000）
radius	number	No	`1.0`	アンシャープマスク: ぼかし半径（ピクセル、0.1〜5）
threshold	number	No	`0`	アンシャープマスク: シャープ化する最小の明度差（0〜255）
strength	number	No	`50`	ハイパス: フィルター強度（0〜100）
kernelSize	number	No	`3`	ハイパス: 畳み込みカーネルサイズ（3または5）
denoise	string	No	`"off"`	シャープ化前のノイズ低減: `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}'

しきい値を指定したアンシャープマスクで滑らかな領域を保護する例:

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

選択した手法に関連するパラメータだけが使用されます。たとえばmethodがadaptiveの場合、amount、radius、thresholdは無視されます。
アダプティブ手法は、平坦/ギザギザ領域の挙動を設定できるSharp組み込みのアダプティブシャープ化を使用します。
denoiseオプションは、ノイズや粒状感の増幅を防ぐために、シャープ化の前にノイズ低減を適用します。
ハイパスシャープ化は、元画像からぼかしたものを差し引いて細部を抽出し、それをブレンドし直すことで細かなディテールを取り出します。
出力フォーマットは入力フォーマットに一致します。HEIC、RAW、PSD、SVGの入力は処理前に自動的にデコードされます。

3.9 KiB Raw Blame History Unescape Escape