> 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/input-output/data-inputs/number-input.md).

# Number Input

هذه دالة (function block) تتيح لك كتابة قيمة رقمية يمكن استخدامها في أجزاء أخرى من السيناريو. مفيدة للعتبات (thresholds)، الفهارس، العدادات أو أي معلمة يحتاجها المستخدم أن يحددها كرقم.

## 📥 المدخلات

هذه الدالة لا تحتوي على أي مدخلات.

## 📤 المخرجات

`Number` القيمة الرقمية التي يُدخلها المستخدم. يمكن أن تكون عددًا صحيحًا أو عشرياً (تدعم الفاصلة بنقطة أو بفاصلة).

## 🕹️ الضوابط (Controls)

`Number` حقل قابل للتحرير في سطر واحد حيث تدخل القيمة الرقمية التي سيتم تصديرها من البلوك.

* يقبل أعدادًا صحيحة (مثال: 5) وقيم عشرية (مثال: 3.14 أو 3,14).
* تجاهل المسافات؛ تجنب الأحرف الخاصة أو النصوص.
* إذا تعذّر تحليل القيمة كرقم، سيعرض البلوك حالة خطأ ولن يخرج قيمة صالحة.

## 🎯 الميزات (Features)

* إدخال رقمي بسيط ومباشر لاستخدامه كمعامل في التدفق.
* يقبل صيغ الأعداد الصحيحة والعشرية مع فواصل عشرية مرنة.
* تحقق بصري: يشير البلوك عندما تكون القيمة المدخلة غير صالحة.

## ⚙️ سلوك التشغيل (Running behavior)

عند تشغيل السيناريو، يقرأ البلوك محتوى الحقل القابل للتحرير ويزوّد المخرج `Number` بالقيمة الرقمية المُحلّلة. إذا فشل التحليل، يبلغ البلوك عن خطأ ولا يخرج قيمة صحيحة حتى يتم تصحيح الإدخال.

## 📝 نصائح الاستخدام (Usage tips)

* استخدم هذا البلوك لتعيين العتبات، الأحجام، العدّادات، أو أي معلمة رقمية قابلة للتهيئة في السيناريو.
* اجعل الحقل بسيطًا — لا تضف وحدات أو نصًا إضافيًا (على سبيل المثال اكتب 100 وليس "100 px").

## 💡 نصائح وحِيل (Tips and Tricks)

* استخدمه مع `Greater`، `Smaller`، أو `Equals` لبناء منطق المقارنة لاتخاذ القرارات.
* استخدمه مع `Number Range` عندما تريد زوج شريط تمرير/قيمة لاختيار نطاق ديناميكي.
* وفّر مواقع الأسطر أو العتبات لبلوكات التحليل مثل `Histogram On Line` أو `Histogram On Curve` باستخدام هذا البلوك.
* أدخل قيم العرض/الارتفاع إلى بلوكات تحويل الصور مثل `Image Resize` أو `Image ROI Center`.
* استخدمه مع بلوكات التصدير مثل `Image Write`، `Image Logger`، أو `CSV Export` للتحكم بالتسمية أو الحدود أو عتبات السجل.

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

* إذا رُفضت القيمة: أزل الأحرف الزائدة (حروف، رموز)، استبدل الفواصل بنقاط أو العكس إذا لزم، وتجنّب المسافات.
* إذا ظهر رسالة خطأ بعد تعديل الحقل، صحّح الإدخال وأعد التشغيل؛ سيعود البلوك إلى الوضع الطبيعي عند إدخال رقم صالح.