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
تحويل الصور بين الصيغ بما في ذلك الصيغ الحديثة مثل AVIF وJXL وHEIC.	562f8270e8c3	human	c4d219043dd6

Convert

حوّل الصور بين الصيغ. يدعم صيغ الويب الشائعة إضافة إلى صيغ متخصصة مثل HEIC وJXL وBMP وICO وJP2 وQOI وPSD.

API Endpoint

POST /api/v1/tools/image/convert

يقبل بيانات نموذج multipart تحتوي على ملف صورة وحقل JSON باسم settings.

Parameters

Parameter	Type	Required	Default	Description
format	string	Yes	-	الصيغة المستهدفة: `jpg`، `png`، `webp`، `avif`، `tiff`، `gif`، `heic`، `heif`، `jxl`، `bmp`، `ico`، `jp2`، `qoi`، `psd`، `ppm`، `eps`، `tga`
quality	number	No	-	جودة الإخراج (1-100). تنطبق على الصيغ ذات الفقد مثل jpg وwebp وavif وheic.

Supported Output Formats

Format	Type	Notes
jpg	ذات فقد	JPEG، أفضل توافق
png	بلا فقد	يدعم الشفافية
webp	كلاهما	صيغة ويب حديثة، ضغط جيد
avif	ذات فقد	صيغة الجيل القادم، ضغط ممتاز
tiff	كلاهما	سير عمل الطباعة/النشر
gif	بلا فقد	محدودة بـ 256 لونًا
heic / heif	ذات فقد	صيغة منظومة Apple
jxl	كلاهما	JPEG XL، صيغة الجيل القادم
bmp	بلا فقد	صورة نقطية غير مضغوطة
ico	بلا فقد	صيغة أيقونة Windows
jp2	ذات فقد	JPEG 2000
qoi	بلا فقد	صيغة Quite OK Image
psd	متعددة الطبقات	Adobe Photoshop (يتطلب ImageMagick)
ppm	بلا فقد	Portable Pixmap (PPM/PGM/PBM)
eps	متجهية	Encapsulated PostScript
tga	بلا فقد	صيغة صورة Targa

Example Request

التحويل إلى WebP:

curl -X POST http://localhost:1349/api/v1/tools/image/convert \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"format": "webp", "quality": 85}'

التحويل إلى PNG (بلا فقد):

curl -X POST http://localhost:1349/api/v1/tools/image/convert \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"format": "png"}'

Example Response

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

Notes

يُحدَّث امتداد اسم ملف الإخراج تلقائيًا ليطابق الصيغة المستهدفة.
تُنقَّط مدخلات SVG عند 300 DPI قبل التحويل.
يتطلب تحويل PSD تثبيت ImageMagick على الخادم.
تستخدم BMP وEPS وICO وJP2 وJXL وPPM وQOI وTGA مُرمِّزات CLI متخصصة وتتجاوز معالجة Sharp.
يستخدم ترميز HEIC/HEIF مكتبة مُرمِّز HEIC في النظام.
صيغ الإدخال واسعة: JPEG وPNG وWebP وAVIF وTIFF وGIF وHEIC وRAW (CR2 وNEF وARW وغيرها) وPSD وSVG وBMP والمزيد.

3.5 KiB Raw Blame History