> 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/ai-blocks/depth-estimation-depthany-v2.md).

# Depth Estimation (DepthAny. V2)

هذا بلوك دالة يقدّر المسافة لكل بكسل (العمق) باستخدام صورة RGB/BGR مفردة. ينتج تصوّر ملون للعمق وخريطة عمق رمادية يمكنك عرضها، تسجيلها، أو تمريرها إلى بلوكات معالجة أخرى.

## 📥 المدخلات

`Image` الصورة بصيغة RGB/BGR المستخدمة كمدخل لتقدير العمق.

## 📤 المخرجات

`Depth Vis` تصوّر ملون للعمق المقدر (سهل الفحص بصريًا).

`Depth Map` خريطة عمق تدرّجية (رمادية) مُطبّعة إلى المجال 0–255 (مفيدة للتحليل والبلوكات اللاحقة).

## 🕹️ الضوابط

`Model Size` اختر توازن الدقّة/السرعة للنموذج. الخيارات عادةً تشمل Small, Base, Large.\
`Max Size` شريط منزلق يحدّ أكبر بُعد للصورة يُستخدم أثناء المعالجة. القيم الأكبر تعطي تفاصيل أكثر لكنها تطلب زمن معالجة أكبر.

## 🎨 الميزات

* ينتج كلاً من خريطة عمق مرئية وصورة عمق رمادية خام للاستخدامات المختلفة.
* التحكم في حجم النموذج يتيح موازنة بين سرعة الاستدلال ودقّته.
* `Max Size` يمنع بطء المعالجة مع الصور الكبيرة؛ البلوك يعيد تغيير حجم المدخلات تلقائيًا لكفاءة أفضل.
* يستخدم الموارد المتاحة تلقائيًا لتحسين الإنتاجية (سلوك على مستوى UI).

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

عند تشغيل البلوك يأخذ الصورة الحالية، قد يعيد تغيير حجمها حسب إعداد `Max Size`، يعالجها بالنموذج المختار، ويُرجع مخرجين: تصوّر ملون وخرائط عمق رمادية مُطَبّعة. النماذج الأكبر وقيم `Max Size` الأكبر تزيد زمن المعالجة.

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

1. اوصِل بلوك يولد صورة إلى مدخل `Image`.
2. اختر `Model Size` بحسب حاجتك بين الدقة والسرعة.
3. اضبط `Max Size` لتقليل زمن المعالجة مع الحفاظ على التفاصيل الكافية.
4. استخدم `Depth Vis` للفحص السريع؛ واستخدم `Depth Map` كمدخل رقمي لبلوكات معالجة أخرى.

## 💡 نصائح وحِيَل

* للصور الكبيرة جدًا، استخدم `Image Resizer` قبل هذا البلوك لتقليل زمن المعالجة مع الحفاظ على المنطقة المهمة.
* إذا كانت الصورة قليلة الدقّة، جرّب تشغيل `Super Resolution` أعلى البلوك لتحسين التفاصيل قبل تقدير العمق.
* لعرض النتائج بصريًا في سير العمل، اوصل `Depth Vis` إلى `Show Image`.
* احفظ النتائج تلقائيًا بإرسال `Depth Vis` أو `Depth Map` إلى `Image Logger` أو `Image Write`.
* عند التجريب، ابدأ بـ `Model Size` = Small للحصول على ملاحظات سريعة ثم انتقل إلى Base أو Large بعد استقرار الإعدادات.

(تلميح: البلوكات المرافقة الموصى بها — `Image Resizer`, `Super Resolution`, `Show Image`, `Image Logger`, `Image Write`)

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

* إن كان المعالجة بطيئة جدًا: خفّض `Model Size` أو قلّل قيمة `Max Size`.
* إن كانت النتائج خشنة: زيّن `Max Size` أو جرّب نموذجًا أكبر (إن سمحت موارد المعالجة).
* إن لم يظهر أي مخرج أو تجمّد البلوك: تأكد أن بلوك الصورة المتصل بالأعلى يزوّد إطارات صورة صحيحة.
* للحفاظ على نتائج حديثة للمراجعة، قم بتوجيه المخرجات إلى `Image Logger` أو `Show Image` للتحقق من التوقعات.