Image Resize

هذه الدالة تقوم بتغيير حجم الصورة الواردة. استخدمها لتكبير أو تصغير الصور مع اختيار طريقة الاستيفاء المناسبة حتى تستقبل البلوكات التالية صوراً بالأبعاد المطلوبة.

📥 المدخلات

• Image Any الصورة التي تريد تغيير حجمها.

• Width العرض المطلوب بالمقاس بالبكسل. اختياري — اتركه فارغاً للحفاظ على العرض الأصلي.

• Height الارتفاع المطلوب بالمقاس بالبكسل. اختياري — اتركه فارغاً للحفاظ على الارتفاع الأصلي.

📤 المخرجات

• Image Any الصورة بعد إعادة تحجيمها.

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

• Interpolation Method اختر كيف يتم أخذ عينات البكسلات عند تغيير الحجم. الخيارات الشائعة: INTER_NEAREST، INTER_LINEAR، INTER_AREA، INTER_CUBIC، INTER_LANCZOS4.

  • استخدم INTER_AREA عند التصغير (جيد لتقليل التمويج aliasing).

  • استخدم INTER_LINEAR للاستخدام العام (توازن بين السرعة والجودة).

  • استخدم INTER_CUBIC أو INTER_LANCZOS4 عند التكبير إذا كنت بحاجة لجودة أعلى (أبطأ).

⚙️ آلية العمل

عند تشغيل هذا البلوك، يأخذ Image Any المُدخل ويطبّق Interpolation Method المختار لإنتاج صورة جديدة بالأبعاد المحددة في Width وHeight. إذا تُرِك أحد البُعدين فارغاً، تبقى تلك المحور بالحجم الأصلي. الصورة المعدلة تُرسَل إلى المخرج لتُستخدم من قبل البلوكات التالية في السيناريو.

🎯 الميزات الرئيسية

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

• خيارات استيفاء متعددة لموازنة السرعة والجودة.

• يعمل مع أي بلوك يولد صوراً ويحضر الصور للنماذج أو للعرض.

📝 نصائح للاستخدام

• إن أردت معاينة النتيجة، قم بربط المخرج بـ Show Image.

• لنتائج أفضل عند المنطقة الصغيرة من الصورة، قص أولاً ثم أعد التحجيم. استخدم Image ROI أو Slice Image قبل هذا البلوك.

• لتجنب التشويه والحفاظ على نسبة العرض إلى الارتفاع، قص أو أضف حواف للصورة أولاً. استخدم Image Padding لإضافة حدود بدل تشويه الصورة.

• للنماذج التي تتوقع مدخلات أصغر (مثل كشف الكائنات أو OCR)، غير حجم الصورة إلى أبعاد النموذج المفضلة قبل تمريرها إلى بلوكات مثل Object Detection (D-FINE)، Object Detection - Custom، OCR، أو OCR (EasyOCR).

💡 نصائح وحلول عملية

• التحضير لـ OCR: كبر منطقة النص المقطوعة باستخدام هذا البلوك قبل توصيلها إلى OCR أو OCR (EasyOCR) لتحسين دقة التعرف.

• التحضير للكشف: اجعل إطارات الكاميرا بحجم ثابت قبل Object Detection (D-FINE) أو Object Detection - Custom حتى تعمل العتبات وأحجام المربعات بشكل متوقع.

• الحفاظ على التفاصيل عند التكبير: عند الاضطرار لتكبير صور صغيرة، اختر INTER_CUBIC أو INTER_LANCZOS4 للحصول على جودة بصرية أفضل.

• حماية نسبة العرض إلى الارتفاع: لتجنب تشويه العناصر، استخدم Image ROI أو Image Padding لجعل القص مربعاً (أو ليطابق مدخل النموذج) ثم أعد التحجيم.

• فحوصات سريعة: اربط Show Image مباشرة بعد هذا البلوك للتحقق بصرياً من الناتج المعاد تحجيمه.

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

• نتيجة ضبابية بعد التكبير

  • جرّب استيفاء أعلى جودة مثل INTER_CUBIC أو INTER_LANCZOS4.

• الكائن المهم يظهر مضغوطاً أو ممدوداً

  • تأكد من الحفاظ على نسبة العرض إلى الارتفاع. قص أو أضف حواف قبل إعادة التحجيم.

• حجم أو اتجاه غير متوقع

  • تحقق من القيم الرقمية في Width وHeight ومعاينتها بواسطة Show Image.

  • إذا أردت تغيير بعد واحد فقط، اترك البعد الآخر فارغاً للحفاظ على حجمه الأصلي.