For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get Pixel

هذه الدالة تقرأ قيمة اللون عند إحداثيات معينة داخل صورة وتعيدها لاستخدامات لاحقة. تدعم الصور الملونة (BGR) والصور التدرجية (grayscale)، وتتحقق من صحة الإحداثيات قبل القراءة.

📥 المدخلات

Image Any الصورة الرئيسية التي سيتم أخذ العينة منها.

Point إحداثيات البكسل المطلوب قراءته (الشكل: (x, y)).

📤 المخرجات

(Blue, Green, Red) قيمة البكسل المقروءة عند الإحداثيات المحددة.

  • في الصور الملونة تعود القيم كقنوات B, G, R معاً.

  • في الصور التدرجية تُعيد قيمة قناة واحدة.

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

لا يحتوي هذا البلوك على عناصر تحكم تفاعلية أو واجهات للويدجت.

🎨 الميزات

  • أخذ عينة بسيطة لبكسل واحد عن طريق الإحداثيات.

  • يعمل مع الصور الملونة (BGR) والتدرجية.

  • تحقق من صحة المدخلات مع رسائل خطأ واضحة عند وجود صورة غير صالحة أو إحداثيات خارج حدود الصورة.

  • يعيد القيم بتنسيق يمكن توصيله مباشرة إلى بلوكات أخرى تقبل بيانات بكسل أو أرقام.

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

  • يقرأ البلوك الصورة من مقبس الإدخال الأول والإحداثيات من المقبس الثاني.

  • إذا كانت الصورة أو الإحداثيات غير صالحة، يعرض البلوك خطأ لمساعدتك في تصحيح المدخلات.

  • عند أن تكون المدخلات صحيحة، يأخذ عينة البكسل عند الموضع (x, y) ويخرج قيم قنواته.

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

  1. ربط بلوك ينتج صورة إلى مدخل Image Any.

  2. تزويد مدخل Point بالإحداثيات بصيغة (x, y).

  3. استخدم مخرج (Blue, Green, Red) حيث تحتاجه (عرض، مقارنة، تسجيل، إلخ).

💡 نصائح وحيل

  • ادمجه مع Get Pixel Mouse لاختيار الإحداثيات تفاعلياً بالنقر على الصورة.

  • استخدم Show Image لمعاينة الصورة أثناء اختيار نقطة العينة.

  • أمِن موضع العينة بصرياً عبر إرسال الإحداثيات إلى Draw Point للتأكد من قراءة البكسل الصحيح.

  • قص الصورة أولاً باستخدام Image ROI أو Image ROI Select لتقييد منطقة الاهتمام وتجنّب إحداثيات خارج النطاق.

  • تحقق أن النقطة داخل منطقة مختارة باستخدام Check Area قبل العينات لتفادي الأخطاء.

  • سجّل أو صدّر القيم المقروءة باستخدام Image Logger أو CSV Export للتحليل لاحقاً.

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

  • إذا ظهر خطأ يتعلق بمدخل الصورة، تأكد أن البلوك المربوط يوفّر فعلاً صورة وأن البيانات ليست فارغة.

  • إذا ظهر خطأ بخصوص الإحداثيات، تحقق أن قيم (x, y) أعداد صحيحة وتقع ضمن عرض وارتفاع الصورة.

  • عند أخذ عينة من صورة تدرجية، توقع قيمة قناة واحدة بدلاً من ثلاث قنوات.

آخر تحديث