> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/image-transformations/operations/image-padding.md).

# Image Padding

هذا البلوك يضيف إطارًا (padding) بلون ثابت حول الصورة. استخدمه لإنشاء هوامش، توحيد أحجام الصور، أو تجهيز الصور للدمج والتخطيط دون تغيير المحتوى الأصلي.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

`Input Image`\
الصورة التي سيُطبق عليها الـ padding.

`Padding Size`\
عدد البكسلات التي ستُضاف (تُطبق بحسب الجانب المختار).

`Color`\
قيمة لون البكسل بصيغة (B, G, R) تُستخدم كلون تعبئة للهامش. إذا لم تُحدد، سيُستخدم اللون الأسود.

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

`Padded Image`\
الصورة الناتجة بعد إضافة الـ padding.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Padding Side`\
اختر الجانب/الأطراف التي سيتم تطبيق الهامش عليها. الخيارات المتاحة:

* `ALL`
* `VERTICAL`
* `HORIZONTAL`
* `LEFT`
* `RIGHT`
* `TOP`
* `BOTTOM`

يحدد هذا التحكم مواضع إضافة بكسلات الـ padding بالنسبة للصورة المدخلة.

## 🎨 الميزات <a href="#features" id="features"></a>

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

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. قم بإدخال صورة إلى `Input Image`.
2. أدخل عدد البكسلات في `Padding Size` لتحديد عرض الهامش.
3. اختياريًا قم بتزويد `Color` (بالتنسيق: (Blue, Green, Red)). إذا تُرك فارغًا، سيكون الهامش أسود.
4. اختر الجانب المطلوب عبر `Padding Side` وشغّل السيناريو لتحصل على `Padded Image`.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

عند التنفيذ، يُرجع هذا البلوك الصورة مع الـ padding المطبق وفق الجانب، الحجم، واللون المختارين. يمكن استخدام المخرج مباشرة في كتل العرض أو المعالجة التالية.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* لجعل عدة صور بنفس حجم اللوحة للمقارنة البصرية، استخدم أولًا `Image Resize` لمطابقة الارتفاع أو العرض، ثم استخدم هذا البلوك لإضافة padding متماثل بحيث تتوافق الصور بصريًا.
* إذا رغبت بالتركيز على منطقة مقطوعة ثم إضافة خلفية، اجمع `Image ROI Select` (لقص) → هذا البلوك (لإضافة الهامش) → `Show Image` للمعاينة.
* لإنشاء هوامش قبل دمج الصور جنبًا إلى جنب، أضف padding ثم استخدم `Image Concatenate` أو `Collage Images` لتجميع تخطيط نظيف.
* استخدم `Make Image` لإنشاء خلفية ملونة ثم طبق هذا البلوك عندما تحتاج هوامش تتطابق مع لون خلفية محدد.
* احفظ النتائج ذات الـ padding تلقائيًا بربط `Padded Image` إلى `Image Logger` أو `Image Write`.

(تلميح) عند تزويد اللون، تذكر أن النظام يتوقع قيم البكسل بترتيب BGR.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* إذا ظهر الهامش بلون غير متوقع، تأكد أن مدخل `Color` مُعطى بصيغة (Blue, Green, Red) وأن القيم بين 0–255.
* إذا لم يظهر أي تغيير، تأكد أن قيمة `Padding Size` أكبر من صفر وأن الخيار الصحيح في `Padding Side` مُحدد.
* عند دمج عدة صور بعد إضافة الـ padding، تحقّق من المحاذاة النهائية باستخدام `Show Image` للتأكد من اتساق الفراغات والحدود.