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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
إضافة تراكبات نصية منسّقة مع ظلال ساقطة وصناديق خلفية.	9f8e697188fc	human	dfff166544c2

تراكب النص

أضف نصًا منسّقًا إلى الصور مع ظل ساقط اختياري وصندوق خلفية شبه شفاف. مناسب للعناوين أو التعليقات أو الشروح على الصور.

نقطة نهاية API

POST /api/v1/tools/image/text-overlay

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

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
text	string	نعم	-	النص المراد تراكبه (1 إلى 500 حرف)
fontSize	number	لا	`48`	حجم الخط بالبكسل (8 إلى 200)
color	string	لا	`"#FFFFFF"`	لون النص بصيغة hex (`#RRGGBB`)
position	string	لا	`"bottom"`	الموضع العمودي: `top`، `center`، `bottom`
backgroundBox	boolean	لا	`false`	إظهار مستطيل خلفية شبه شفاف خلف النص
backgroundColor	string	لا	`"#000000"`	لون صندوق الخلفية بصيغة hex (`#RRGGBB`)
shadow	boolean	لا	`true`	تطبيق ظل ساقط خلف النص

مثال طلب

curl -X POST http://localhost:1349/api/v1/tools/image/text-overlay \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"text": "Hello World", "fontSize": 64, "color": "#FFFFFF", "position": "bottom", "shadow": true}'

مع صندوق خلفية:

curl -X POST http://localhost:1349/api/v1/tools/image/text-overlay \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"text": "Caption", "fontSize": 36, "position": "bottom", "backgroundBox": true, "backgroundColor": "#000000"}'

مثال استجابة

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

ملاحظات

يُوسَّط النص دائمًا أفقيًا داخل الصورة.
يستخدم الظل الساقط إزاحة 2 بكسل مع تمويه 3 بكسل وعتامة سوداء بنسبة 70%.
يمتد صندوق الخلفية على كامل عرض الصورة بعتامة 70%، وبارتفاع متناسب مع حجم الخط (1.8 مرة).
يُصيَّر النص عبر تركيب SVG، لذا يُستخدم خط sans-serif الافتراضي للنظام.
تُهرَّب الأحرف الخاصة بـ XML في النص بأمان.
تطابق صيغة المخرجات صيغة المدخلات. تُفكّ ترميزات مدخلات HEIC وRAW وPSD وSVG تلقائيًا قبل المعالجة.

3.1 KiB Raw Blame History