> 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/image-transformations/operations/image-resize.md).

# 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`.
  * إذا أردت تغيير بعد واحد فقط، اترك البعد الآخر فارغاً للحفاظ على حجمه الأصلي.
