الخياطة / الدمج

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

نقطة نهاية API

POST /api/v1/tools/image/stitch

المعاملات

المعامل	النوع	مطلوب	الافتراضي	الوصف
direction	string	لا	"horizontal"	اتجاه التخطيط: horizontal، vertical، grid
gridColumns	integer	لا	2	عدد الأعمدة عندما يكون الاتجاه grid (2 إلى 100)
resizeMode	string	لا	"fit"	كيفية إعادة تحجيم الصور: fit، original، stretch، crop
alignment	string	لا	"center"	المحاذاة عبر المحور المتقاطع: start، center، end
gap	number	لا	0	الفجوة بين الصور بالبكسل (0 إلى 1000)
border	number	لا	0	عرض الحد الخارجي بالبكسل (0 إلى 500)
cornerRadius	number	لا	0	نصف قطر الزوايا المطبّق على المخرجات النهائية (0 إلى 500)
backgroundColor	string	لا	"#FFFFFF"	لون الخلفية/الحد بصيغة hex (مثل #FF0000)
format	string	لا	"png"	صيغة المخرجات: png، jpeg، webp، avif، jxl
quality	number	لا	90	جودة المخرجات (1 إلى 100)

مثال طلب

curl -X POST http://localhost:1349/api/v1/tools/image/stitch \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"direction":"horizontal","resizeMode":"fit","gap":10,"backgroundColor":"#FFFFFF","format":"png"}'

مثال استجابة

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/stitch.png",
  "originalSize": 1234567,
  "processedSize": 987654
}

ملاحظات

• يتطلب صورتين على الأقل. ارفع عدة ملفات صور في الطلب متعدد الأجزاء.
• يدعم صيغ المدخلات HEIC وRAW وPSD وSVG (تُفكّ ترميزاتها تلقائيًا).
• أوضاع إعادة التحجيم:
  • fit - تحجيم الصور لتطابق أصغر بُعد على طول محور الضم.
  • original - الإبقاء على الأحجام الأصلية (قد ينتج عنه حواف غير متساوية).
  • stretch - إجبار الصور على مطابقة أصغر بُعد دون الحفاظ على نسبة الأبعاد.
  • crop - اقتصاص تغطية للصور لتطابق أصغر بُعد.
• في وضع grid، تُحدد أحجام الخلايا وفق الأبعاد الوسيطة لجميع الصور.
• يُطبّق cornerRadius على كامل المخرجات النهائية، وليس على الصور الفردية.
• حجم القماش محدود بتهيئة الخادم MAX_CANVAS_PIXELS لمنع استنفاد الذاكرة.