Translate Shape

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

📥 المدخلات

Shape شكل ليتم نقله. الأنواع المقبولة:

• نقطة مفردة (x, y)

• مستطيل معرف بنقطتي زاويتين

• دائرة معرف بمركز center_x, center_y ونصف القطر

• Contour (قائمة مرتبة أو مصفوفة من نقاط (x,y))

X قيمة الإزاحة الأفقية (اختياري). عدد صحيح يمثل بكسلات لتحريك الشكل على المحور X. القيمة الافتراضية 0 إذا لم تُعطَ.

Y قيمة الإزاحة العمودية (اختياري). عدد صحيح يمثل بكسلات لتحريك الشكل على المحور Y. القيمة الافتراضية 0 إذا لم تُعطَ.

(جميع ما سبق هي مقابس إدخال.)

📤 المخرجات

Shape الشكل بعد النقل معاد بنفس صيغة الإدخال (نقطة، مستطيل، دائرة أو contour).

(هذا مقبس إخراج.)

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

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

⚙️ آلية التشغيل

• عند التنفيذ، يقرأ البلوك الشكل المقدم وقيم الإزاحة الاختيارية X وY.

• تُطبق الإزاحات كقيم بكسل صحيحة. القيم الموجبة تحرك الشكل إلى اليمين/أسفل، والقيم السالبة تحركه إلى اليسار/أعلى.

• يعيد البلوك نفس نوع الشكل بعد إزاحته بالمقدار المحدد. بالنسبة للـ contour، تُنقل كل رأس بنفس الإزاحة (X, Y).

• إذا تم تقديم نوع شكل غير مدعوم أو بيانات غير صالحة، سيُشير البلوك إلى خطأ في التكوين — تأكد أن مدخل Shape مطابق لأحد الصيغ المقبولة.

✨ الميزات

• يدعم أنواع الأشكال الشائعة: نقطة، مستطيل، دائرة و contour.

• يحافظ على صيغة الإخراج مطابقة لصيغة الإدخال لتسلسل المعالجات بسهولة.

• إزاحة بسيطة تعتمد على أعداد صحيحة لضمان تحديد موضع محدد.

• يعمل مع شكل مفرد أو مصفوفات contour لتحويل عدة أشكال دفعة واحدة.

📝 إرشادات الاستخدام

1. أدخل الشكل إلى مقبس Shape (مثال: contour المرجع من كاشف).

2. أدخل قيمة الإزاحة الأفقية إلى مقبس X (اختياري).

3. أدخل قيمة الإزاحة العمودية إلى مقبس Y (اختياري).

4. اقرأ الشكل المنقول من مخرج Shape واستخدمه للرسم، القياس أو المعالجة اللاحقة.

💡 نصائح وحيل

• الدمج مع كتل الكشف و ROI:

  • استخدم Find Contour, Find Object أو Approximate Contour للحصول على أشكال، ثم أرسلها إلى هذا البلوك لمحاذاة أو تعويض النتائج.

  • استخدم Image ROI, Image ROI Select أو Get ROI لاقتصاص أو التركيز على منطقة قبل نقل الأشكال حتى تبقى الإحداثيات متسقة داخل المنطقة العاملة.

• العمل مع أشكال متعددة أو قوائم:

  • استخدم Batch Processing, Debatch أو Batch Concatenation لنقل قائمة من الأشكال بشكل تكراري.

  • لعرض النتائج المنقولة للتحقق بصريًا، أرسل الإخراج إلى Draw Point, Draw Rectangle أو Draw Result On Image.

• لعمليات القياس:

  • بعد نقل الأشكال، استخدم Measure Position Distance لحساب المسافات بين المواضع المنقولة والمرجعية.

  • استخدم Minimum Rectangle, Hull Convex أو Contour to Image لتحويل ومقارنة الملخصات الهندسية بعد النقل.

• التصور وتصحيح الأخطاء:

  • لعرض الـ contours أو المستطيلات المنقولة على الصور، مرّر الشكل المنقول إلى Draw Rectangle أو Draw Result On Image وشاهد المعاينة عبر Show Image.

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

• لا يظهر أي تغيير بعد النقل:

  • تحقق من تقديم قيم غير صفرية إلى X أو Y.

  • تأكد أن بلوك العرض/الرسم (مثال: Show Image أو Draw Rectangle) يستقبل الشكل المنقول ونظام الإحداثيات المستخدم هو نفسه.

• حدوث أخطاء بتنسيق الشكل:

  • تأكد من أن شكل الإدخال يتوافق مع أحد الصيغ المدعومة (نقطة، مستطيل، دائرة، أو contour).

  • إذا كنت تعمل مع قوائم، فتأكد من إرسالها عبر تدفق متوافق مع الدُفعات أو القوائم (استخدم Batch Processing / Debatch عند الحاجة).

• خروج الأشكال عن حدود الصورة:

  • قد تحرك الإزاحات الأشكال خارج مساحة الصورة. إذا كان ذلك مشكلة، فقم بتقييد الإحداثيات عبر فحوصات لاحقة أو اقترح اقتصاص ROI قبل النقل.