mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
f858c4cea0
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.
4.2 KiB
4.2 KiB
description, i18n_source_hash, i18n_provenance, i18n_output_hash
| description | i18n_source_hash | i18n_provenance | i18n_output_hash |
|---|---|---|---|
| زيادة حدة الصور باستخدام طرق التكيف أو قناع إلغاء الحدة أو الترشيح عالي التمرير مع خفض اختياري للضوضاء. | 66dce4068899 | human | 4545c1bf0c38 |
زيادة حدة الصورة
أداة متقدمة لزيادة الحدة بثلاث طرق: التكيف (إدراك ذكي للحواف)، وقناع إلغاء الحدة (نصف قطر/مقدار كلاسيكي)، والترشيح عالي التمرير (إبراز الملمس). تتضمن خفضًا مدمجًا للضوضاء لمنع نشوء تشوهات ناتجة عن زيادة الحدة.
نقطة نهاية API
POST /api/v1/tools/image/sharpening
تقبل بيانات نموذج متعدد الأجزاء تحتوي على ملف صورة وحقل settings بصيغة JSON.
المعاملات
| المعامل | النوع | مطلوب | الافتراضي | الوصف |
|---|---|---|---|---|
| method | string | لا | "adaptive" |
خوارزمية زيادة الحدة: adaptive، unsharp-mask، high-pass |
| sigma | number | لا | 1.0 |
التكيف: سيغما غاوس (0.5 إلى 10) |
| m1 | number | لا | 1.0 |
التكيف: زيادة حدة المناطق المسطحة (0 إلى 10) |
| m2 | number | لا | 3.0 |
التكيف: زيادة حدة المناطق المسننة (0 إلى 20) |
| x1 | number | لا | 2.0 |
التكيف: عتبة المسطح/المسنن (0 إلى 10) |
| y2 | number | لا | 12 |
التكيف: أقصى زيادة حدة للمسطح (0 إلى 50) |
| y3 | number | لا | 20 |
التكيف: أقصى زيادة حدة للمسنن (0 إلى 50) |
| amount | number | لا | 100 |
قناع إلغاء الحدة: مقدار زيادة الحدة (0 إلى 1000) |
| radius | number | لا | 1.0 |
قناع إلغاء الحدة: نصف قطر التمويه بالبكسل (0.1 إلى 5) |
| threshold | number | لا | 0 |
قناع إلغاء الحدة: أدنى فرق سطوع لتطبيق زيادة الحدة (0 إلى 255) |
| strength | number | لا | 50 |
عالي التمرير: قوة المرشح (0 إلى 100) |
| kernelSize | number | لا | 3 |
عالي التمرير: حجم نواة الالتفاف (3 أو 5) |
| denoise | string | لا | "off" |
خفض الضوضاء قبل زيادة الحدة: off، light، medium، strong |
مثال طلب
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}'
مثال استجابة
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
"originalSize": 2450000,
"processedSize": 2510000
}
ملاحظات
- لا تُستخدم إلا المعاملات ذات الصلة بالطريقة المختارة. على سبيل المثال، يجري تجاهل
amountوradiusوthresholdعندما تكونmethodهيadaptive. - تستخدم طريقة التكيف زيادة الحدة التكيفية المدمجة في Sharp مع سلوك قابل للتهيئة للمناطق المسطحة/المسننة.
- يطبّق خيار
denoiseخفض الضوضاء قبل زيادة الحدة لمنع تضخيم الضوضاء/التحبب. - تستخرج زيادة الحدة عالية التمرير التفاصيل الدقيقة بطرح نسخة مموّهة من الأصل ثم دمجها مرة أخرى.
- تطابق صيغة المخرجات صيغة المدخلات. تُفكّ ترميزات مدخلات HEIC وRAW وPSD وSVG تلقائيًا قبل المعالجة.