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

2.8 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
تطبيق تأثير التبكسل على الصورة بالكامل أو على منطقة محددة.	a3ad29841f7b	human	e713378c97a7

التبكسل

طبّق تأثير التبكسل على صورة كاملة أو على منطقة مستطيلة محددة. مفيد لإخفاء المحتوى الحساس مثل الوجوه أو لوحات المركبات أو المعلومات الشخصية.

نقطة نهاية الـ API

POST /api/v1/tools/image/pixelate

يقبل بيانات نموذج متعدد الأجزاء مع ملف صورة وحقل JSON باسم settings.

المعاملات

المعامل	النوع	مطلوب	القيمة الافتراضية	الوصف
blockSize	integer	لا	`12`	حجم كتلة البكسل (2-128)؛ القيم الأكبر تنتج تبكسلًا أخشن
region	object	لا	-	تقييد التبكسل بمستطيل (انظر أدناه)

كائن المنطقة

الحقل	النوع	مطلوب	الوصف
left	integer	نعم	الإزاحة اليسرى بالبكسل (>= 0)
top	integer	نعم	الإزاحة العلوية بالبكسل (>= 0)
width	integer	نعم	عرض المنطقة بالبكسل (>= 1)
height	integer	نعم	ارتفاع المنطقة بالبكسل (>= 1)

مثال على الطلب

تبكسل الصورة بالكامل:

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

تبكسل منطقة محددة:

curl -X POST http://localhost:1349/api/v1/tools/image/pixelate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"blockSize": 16, "region": {"left": 100, "top": 50, "width": 200, "height": 150}}'

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

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

ملاحظات

عند حذف region، تُبكسل الصورة بالكامل.
إحداثيات المنطقة بالبكسل نسبةً إلى الركن العلوي الأيسر للصورة. يجب أن تقع المنطقة ضمن حدود الصورة.
تطابق صيغة الإخراج صيغة الإدخال. تُفكّ ترميزات مدخلات HEIC وRAW وPSD وSVG تلقائيًا قبل المعالجة.

2.8 KiB Raw Blame History