> 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-circle.md).

# Image ROI Circle

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

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

`Image` الصورة التي سيتم اقتطاعها والتحكم في تراكب الدائرة عليها (رمادية أو ملونة).

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

`Image` الصورة المقتطعة التي تحتوي المنطقة الدائرية (الخلفية خارج الدائرة مُقنّعة/محوَّلة).

`Circle` شكل الدائرة الذي يصف ROI المحددة كمركز ونصف قطر (مفيد للبلوكات التي تتعامل مع الهندسة).

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

`ROI Canvas` منطقة الصورة التفاعلية حيث تنشئ وتحرر الدائرة بالماوس.

`Create by Drag` انقر واسحب على اللوحة لإنشاء دائرة جديدة.

`Move Center` اسحب مركز الدائرة لإعادة موقع ROI.

`Resize Radius` اسحب مقبض نصف القطر لتغيير حجم الدائرة.

`Clear (C)` اضغط مفتاح C لمسح الدائرة الحالية والبدء من جديد.

## ⚙️ آلية العمل <a href="#how-it-works" id="how-it-works"></a>

* يعرض البلوك الصورة المزودة على اللوحة التفاعلية ويضع فوقها الدائرة الحالية (إن وُجدت).
* أثناء التشغيل، تستمع اللوحة لأحداث سحب وتحريك الماوس لإنشاء أو نقل أو تغيير حجم الدائرة.
* بمجرد وجود دائرة صحيحة، يقوم البلوك بإنتاج الصورة المقتطعة الدائرية (مقنعة) ومخرج شكل يحتوي قيم المركز ونصف القطر.
* إذا لم تكن الدائرة معرفة أو كان نصف القطر صفرًا، يقوم البلوك بإخراج `None` لكلا المخرجين حتى تتمكن البلوكات التالية من التعامل مع عدم وجود ROI.

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

* تفاعل سحب وإفلات بسيط intuitif لإنشاء ROI.
* مقابض منفصلة لتحريك المركز وتغيير نصف القطر.
* تغذية بصرية فورية مع تراكب ملون وتمييز المقبض.
* يخرج كل من القص المقنع ووصف الشكل القابل لإعادة الاستخدام.

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

1. ربط بلوك مصدر للصورة إلى مدخل `Image` وتشغيل مرة حتى تظهر الصورة على اللوحة.
2. انقر واسحب على `ROI Canvas` لإنشاء دائرة.
3. اسحب مركز الدائرة لتحريكها أو اسحب مقبض نصف القطر لتغيير الحجم.
4. اضغط `C` للمسح وإعادة الرسم عند الحاجة.
5. استخدم مخرجات `Image` و`Circle` لإرسال القص أو الشكل إلى بلوكات أخرى.

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

* عاين القص المحدد في نافذة أكبر باستخدام `Show Image` لفحص أدق قبل التصدير.
* إذا كانت الصورة المصدر كبيرة، استخدم `Image Resize` قبل هذا البلوك لتسريع التفاعل وضمان ملاءمة ROI workspace.
* استخدم `Apply Mask` لدمج القناع الدائري مع صور أخرى أو لوضع نتيجة القناع على خلفية مختلفة.
* لاختيار مناطق أكثر تعقيدًا أو متعددة، فكّر في استخدام `Image ROI Select` أو `Image ROI Polygon Multi` ثم صقل النتيجة بهذه الدائرة عند الحاجة.
* احفظ القصوص مباشرةً باستخدام `Image Logger` أو `Image Write` للاحتفاظ بسجل أو للمعالجة اللاحقة.
* قم بتمهيد المدخلات الصاخبة باستخدام `Blur` أو `Image Threshold` حتى تتماشى المنطقة المرئية بشكل أفضل مع تدفقات الكشف أو القياس لديك.
* اجمع مخرجات الدائرة مع بلوكات القياس أو التحليل (مثلاً shape-analysis أو detectors) بتمرير شكل `Circle` حيثما كان مدعومًا.

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

* لا تظهر صورة على اللوحة: تأكد أن البلوك السابق يُنتج صورة وقم بتشغيل السيناريو مرة لتحميل الصورة.
* المخرجات تُظهر `None`: مركز الدائرة أو نصف القطر غير معرفان أو نصف القطر فعليًا صفر — أعد رسم الدائرة.
* الدائرة تبدو خارج الإطار أو صغيرة جدًا: جرّب تغيير قياس الصورة عبر `Image Resize` upstream أو أعد رسم الدائرة بمقياس أكبر.
* التفاعل بطيء أو غير مستجيب: تأكد أن الصورة قُدمت مرة على الأقل وأن اللوحة تعرض الصورة؛ أعد تشغيل البلوك إذا لزم.