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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
إضافة حدود وحشوة وزوايا مستديرة وظلال مسقطة إلى الصور بترتيب قابل للتنبّؤ والتحكّم.	8845150736a9	human	22b7c5cf11d2

الحدود والإطار

أضِف حدودًا وحشوة وزوايا مستديرة وظلالًا مسقطة إلى الصور. تطبّق الأداة المؤثّرات بالترتيب: الحشوة، الحدّ، نصف قطر الزوايا، ثم الظلّ.

نقطة نهاية API

POST /api/v1/tools/image/border

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
borderWidth	number	لا	10	سُمك الحدّ بالبكسل (0 إلى 2000)
borderColor	string	لا	`"#000000"`	لون الحدّ بصيغة hex (مثل `#FF0000`)
padding	number	لا	0	الحشوة الداخلية بين الصورة والحدّ بالبكسل (0 إلى 200)
paddingColor	string	لا	`"#FFFFFF"`	لون تعبئة الحشوة بصيغة hex
cornerRadius	number	لا	0	نصف قطر الزوايا بالبكسل (0 إلى 2000)
shadow	boolean	لا	`false`	ما إذا كان يُضاف ظلّ مسقط
shadowBlur	number	لا	15	نصف قطر ضبابية الظلّ (1 إلى 200)
shadowOffsetX	number	لا	0	إزاحة الظلّ الأفقية (-50 إلى 50)
shadowOffsetY	number	لا	5	إزاحة الظلّ العمودية (-50 إلى 50)
shadowColor	string	لا	`"#000000"`	لون الظلّ بصيغة hex
shadowOpacity	number	لا	40	نسبة تعتيم الظلّ (0 إلى 100)

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

curl -X POST http://localhost:1349/api/v1/tools/image/border \
  -F "file=@photo.jpg" \
  -F 'settings={"borderWidth":20,"borderColor":"#333333","cornerRadius":16,"shadow":true,"shadowBlur":25,"shadowOpacity":50}'

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

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

ملاحظات

يستخدم مصنع createToolRoute القياسي. يقبل ملف صورة واحدًا عبر رفع multipart.
يدعم صيغ الإدخال HEIC وRAW وPSD وSVG (تُفكَّك تلقائيًا).
ترتيب المعالجة: تُضاف الحشوة أولًا، ثم يلتفّ الحدّ حولها، ثم يُطبَّق نصف قطر الزوايا، ثم يُركَّب الظلّ.
عند تفعيل cornerRadius أو shadow، تُفرَض المخرجات إلى PNG (بغضّ النظر عن صيغة الإدخال) للحفاظ على الشفافية. أما الصيغ التي تدعم قناة ألفا (PNG، WebP، AVIF) فتحتفظ بصيغتها الأصلية.
الظلّ واعٍ بالشكل: فهو يتبع الزوايا المستديرة بدلًا من إنشاء ظلّ مستطيل.
يؤدّي ضبط borderWidth على 0 واستخدام cornerRadius + shadow فقط إلى إنشاء تأثير ظلّ مستدير بلا إطار.

3.3 KiB Raw Blame History