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)
إذا رُفضت القيمة: أزل الأحرف الزائدة (حروف، رموز)، استبدل الفواصل بنقاط أو العكس إذا لزم، وتجنّب المسافات.
إذا ظهر رسالة خطأ بعد تعديل الحقل، صحّح الإدخال وأعد التشغيل؛ سيعود البلوك إلى الوضع الطبيعي عند إدخال رقم صالح.
آخر تحديث