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

4.3 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
عرض بيانات وصفية تفصيلية للصورة وخصائصها وإحصائيات الرسم البياني لكل قناة.	8a0f7a0b0153	human	709f24e5d07c

معلومات الصورة

أداة تحليل للقراءة فقط تُرجع بيانات وصفية شاملة للصورة تشمل الأبعاد والصيغة ومساحة اللون ووجود EXIF/ICC/XMP وإحصائيات الرسم البياني لكل قناة. لا تُنتج ملف مخرجات معالجاً.

نقطة نهاية API

POST /api/v1/tools/image/info

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

المعاملات

لا تحتوي هذه الأداة على معاملات قابلة للتكوين. ما عليك سوى رفع ملف الصورة.

الحقل	النوع	مطلوب	الوصف
file	file	نعم	الصورة المراد تحليلها

مثال على طلب

curl -X POST http://localhost:1349/api/v1/tools/image/info \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg"

مثال على استجابة

{
  "filename": "photo.jpg",
  "fileSize": 2450000,
  "width": 4032,
  "height": 3024,
  "format": "jpeg",
  "channels": 3,
  "hasAlpha": false,
  "colorSpace": "srgb",
  "density": 72,
  "isProgressive": false,
  "orientation": 1,
  "hasProfile": true,
  "hasExif": true,
  "hasIcc": true,
  "hasXmp": false,
  "bitDepth": "8",
  "pages": 1,
  "histogram": [
    { "channel": "red", "min": 0, "max": 255, "mean": 128.45, "stdev": 52.31 },
    { "channel": "green", "min": 2, "max": 253, "mean": 115.22, "stdev": 48.76 },
    { "channel": "blue", "min": 0, "max": 250, "mean": 102.89, "stdev": 55.14 }
  ]
}

حقول الاستجابة

الحقل	النوع	الوصف
filename	string	اسم الملف المُطهَّر
fileSize	number	حجم الملف بالبايت
width	number	عرض الصورة بالبكسل
height	number	ارتفاع الصورة بالبكسل
format	string	الصيغة المكتشفة (jpeg، png، webp، إلخ)
channels	number	عدد قنوات الألوان
hasAlpha	boolean	ما إذا كانت الصورة تحتوي على قناة alpha
colorSpace	string	مساحة اللون (srgb، cmyk، إلخ)
density	number أو null	دقة DPI/PPI
isProgressive	boolean	ما إذا كان JPEG يستخدم الترميز التدريجي
orientation	number أو null	قيمة اتجاه EXIF (1-8)
hasProfile	boolean	ما إذا كان ملف تعريف ICC مُضمّناً
hasExif	boolean	ما إذا كانت بيانات EXIF الوصفية موجودة
hasIcc	boolean	ما إذا كان ملف تعريف لون ICC موجوداً
hasXmp	boolean	ما إذا كانت بيانات XMP الوصفية موجودة
bitDepth	string أو null	البتات لكل عينة
pages	number	عدد الصفحات (للصيغ متعددة الصفحات مثل TIFF وGIF)
histogram	array	إحصائيات لكل قناة (الأدنى، الأعلى، المتوسط، الانحراف المعياري)

ملاحظات

هذه نقطة نهاية للقراءة فقط. لا تُنتج ملف مخرجات قابلاً للتنزيل ولا jobId.
بالنسبة لصور صيغة RAW (DNG وCR2 وNEF وARW وإلخ)، يُستخدم ExifTool لاستخراج أبعاد المستشعر الحقيقية وأعلام البيانات الوصفية التي لا يستطيع Sharp قراءتها مباشرة.
تُفك ترميز ملفات HEIC/HEIF إلى PNG داخلياً لاستخراج إحصائيات البكسل، لأن Sharp لا يستطيع فك ترميز بكسلات HEVC.
يوفّر الرسم البياني الأدنى/الأعلى/المتوسط/الانحراف المعياري لكل قناة، وليس توزيعاً كاملاً من 256 خانة.
يعكس حقل density بيانات DPI الوصفية المُضمّنة، إن وُجدت.

4.3 KiB Raw Blame History