Image ROI Circle

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

📥 المدخلات

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

📤 المخرجات

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

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

🕹️ عناصر التحكم

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

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

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

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

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

⚙️ آلية العمل

• يعرض البلوك الصورة المزودة على اللوحة التفاعلية ويضع فوقها الدائرة الحالية (إن وُجدت).

• أثناء التشغيل، تستمع اللوحة لأحداث سحب وتحريك الماوس لإنشاء أو نقل أو تغيير حجم الدائرة.

• بمجرد وجود دائرة صحيحة، يقوم البلوك بإنتاج الصورة المقتطعة الدائرية (مقنعة) ومخرج شكل يحتوي قيم المركز ونصف القطر.

• إذا لم تكن الدائرة معرفة أو كان نصف القطر صفرًا، يقوم البلوك بإخراج None لكلا المخرجين حتى تتمكن البلوكات التالية من التعامل مع عدم وجود ROI.

✨ الميزات

• تفاعل سحب وإفلات بسيط intuitif لإنشاء ROI.

• مقابض منفصلة لتحريك المركز وتغيير نصف القطر.

• تغذية بصرية فورية مع تراكب ملون وتمييز المقبض.

• يخرج كل من القص المقنع ووصف الشكل القابل لإعادة الاستخدام.

📝 تعليمات الاستخدام

1. ربط بلوك مصدر للصورة إلى مدخل Image وتشغيل مرة حتى تظهر الصورة على اللوحة.

2. انقر واسحب على ROI Canvas لإنشاء دائرة.

3. اسحب مركز الدائرة لتحريكها أو اسحب مقبض نصف القطر لتغيير الحجم.

4. اضغط C للمسح وإعادة الرسم عند الحاجة.

5. استخدم مخرجات Image وCircle لإرسال القص أو الشكل إلى بلوكات أخرى.

💡 نصائح وحيل

• عاين القص المحدد في نافذة أكبر باستخدام 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 حيثما كان مدعومًا.

🛠️ استكشاف الأخطاء وإصلاحها

• لا تظهر صورة على اللوحة: تأكد أن البلوك السابق يُنتج صورة وقم بتشغيل السيناريو مرة لتحميل الصورة.

• المخرجات تُظهر None: مركز الدائرة أو نصف القطر غير معرفان أو نصف القطر فعليًا صفر — أعد رسم الدائرة.

• الدائرة تبدو خارج الإطار أو صغيرة جدًا: جرّب تغيير قياس الصورة عبر Image Resize upstream أو أعد رسم الدائرة بمقياس أكبر.

• التفاعل بطيء أو غير مستجيب: تأكد أن الصورة قُدمت مرة على الأقل وأن اللوحة تعرض الصورة؛ أعد تشغيل البلوك إذا لزم.