> 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/detections-shapes/roi-processing/image-roi-center.md).

# Image ROI Center

This function block crops an image around a specified center point using a desired width and height. If no center or sizes are provided, it defaults to the full image center and full image dimensions. It returns the cropped image and the rectangle coordinates used for the crop.

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

`Image Any`\
الصورة المصدرية التي سيتم اقتصاصها.

`Center`\
إحداثية المركز للقص. إذا لم تُقدم فسيُستخدم مركز الصورة الافتراضي. التنسيق: (x, y) أو (col, row) اعتمادًا على سير العمل لديك.

`Width`\
العرض المطلوب للقص بوحدة البكسل. إذا لم يُقدم فسيُستخدم عرض الصورة الكامل.

`Height`\
الارتفاع المطلوب للقص بوحدة البكسل. إذا لم يُقدم فسيُستخدم ارتفاع الصورة الكامل.

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

`Image Any`\
الصورة المقصوصة (منطقة الاهتمام) المعادة كبيانات صورة.

`Rectangle`\
المستطيل المستخدم للقص، معبراً عنه بالإحداثيات التي يمكنك إعادة استخدامها مع كتل أخرى.

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

This block has no additional interactive controls inside its widget area. All behavior is driven by the input sockets.

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

* اقتصاص بسيط معتمد على المركز لاستخراج ROI بسرعة.
* يقبل إدخالات اختيارية لـ `Width`، `Height` و `Center` بحيث يمكنك تغيير منطقة الاهتمام ديناميكياً أثناء التشغيل.
* يعيد الصورة المقصوصة وإحداثيات المستطيل حتى تتمكن الكتل التالية من عرض أو إعادة استخدام الـ ROI.

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

1. صِل مصدر الصورة إلى مدخل `Image Any`.
2. اختياريًا قدّم إحداثية `Center` لتغيير مركز القص.
3. اختياريًا قدّم `Width` و/أو `Height` لتحديد حجم القص.
4. استخدم مخرج `Image Any` كالصورة المقصوصة ومخرج `Rectangle` لرسم أو حفظ منطقة الاهتمام.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

عند تشغيل الكتلة، تحدد المركز والعرض والارتفاع من المدخلات (أو تستخدم القيم الافتراضية المعقولة)، ثم تحسب المستطيل داخل حدود الصورة وتخرج الصورة المقصوصة مع إحداثيات المستطيل.

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

* ادمجها مع `Show Image` لمعاينة الناتج المقصوص بسرعة.
* استخدم `Image ROI Select` أو `Image ROI Polygon` في مسار التدفق قبلها لتحديد أو ضبط المركز تفاعليًا قبل تغذيته لهذه الكتلة.
* أرسل المخرج المقصوص إلى `Find Object`، `Object Detection` أو `Mask Detection` لتركيز الكشف على مساحة أصغر وتسريع المعالجة.
* أضف `Image Resize` بعد هذه الكتلة لتطبيع حجم القص للخوارزميات التي تتطلب أبعاد إدخال ثابتة.
* أرسل الصورة المقصوصة إلى `Image Logger` أو `Image Write` لحفظ عينات من منطقة الاهتمام للمراجعة أو للتدريب.

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

* إذا كان القص فارغًا أو يبدو غير صحيح، فتحقق من مدخلات `Center` و `Width` و `Height` للتأكد من أنها داخل حدود الصورة.
* إذا كانت الكتلة التالية تتوقع ترتيب قنوات أو حجمًا محددًا، تأكد من إضافة `Image Resize` أو تحويلات الألوان قبل تلك الكتلة.
* إذا رأيت إحداثيات غير متوقعة، استخدم `Show Image` أو `Draw Rectangle` لتصوير مخرج `Rectangle` والتحقق من موضع الـ ROI.