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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
قصّ صورة إلى دائرة موسّطة بزوايا شفّافة.	06c50ccd96b2	human	1a1acaa9d988

القصّ الدائري

اقصص صورة إلى دائرة موسّطة بزوايا شفّافة. يدعم تكبيرًا وإزاحة وحدًّا وحجم مخرجات قابلة للضبط.

نقطة نهاية API

POST /api/v1/tools/image/circle-crop

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

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
zoom	number	لا	`1`	عامل التكبير (1-5)؛ القيم الأعلى تقصّ بإحكام أكبر
offsetX	number	لا	`0.5`	موضع المركز الأفقي (0-1)
offsetY	number	لا	`0.5`	موضع المركز العمودي (0-1)
borderWidth	integer	لا	`0`	عرض الحدّ بالبكسل (0-200)
borderColor	string	لا	`"#ffffff"`	لون الحدّ بصيغة hex
background	string	لا	`"transparent"`	تعبئة الزوايا: `"transparent"` أو لون بصيغة hex
outputSize	integer	لا	-	البُعد المربّع النهائي بالبكسل (16-4096)

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

curl -X POST http://localhost:1349/api/v1/tools/image/circle-crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"zoom": 1.2, "borderWidth": 4, "borderColor": "#333333"}'

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

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

ملاحظات

تكون المخرجات دائمًا بصيغة PNG للحفاظ على الزوايا الشفّافة (ما لم تُضبَط background على لون خالص).
تُرسَم الدائرة داخل البُعد الأقصر للصورة. استخدم zoom للقصّ بإحكام أكبر وoffsetX/offsetY لإزاحة المنطقة المرئية.
عند توفير outputSize، يُعاد ضبط حجم النتيجة إلى ذلك البُعد المربّع بعد القصّ.
تُفكَّك مدخلات HEIC وRAW وPSD وSVG تلقائيًا قبل المعالجة.

2.6 KiB Raw Blame History