> 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/detections-shapes/roi-processing/get-pixel.md).

# Get Pixel

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

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

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

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

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

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

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

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

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

## 🎨 الميزات <a href="#features" id="features"></a>

* أخذ عينة بسيطة لبكسل واحد عن طريق الإحداثيات.
* يعمل مع الصور الملونة (BGR) والتدرجية.
* تحقق من صحة المدخلات مع رسائل خطأ واضحة عند وجود صورة غير صالحة أو إحداثيات خارج حدود الصورة.
* يعيد القيم بتنسيق يمكن توصيله مباشرة إلى بلوكات أخرى تقبل بيانات بكسل أو أرقام.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

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

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. ربط بلوك ينتج صورة إلى مدخل `Image Any`.
2. تزويد مدخل `Point` بالإحداثيات بصيغة (x, y).
3. استخدم مخرج `(Blue, Green, Red)` حيث تحتاجه (عرض، مقارنة، تسجيل، إلخ).

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* ادمجه مع `Get Pixel Mouse` لاختيار الإحداثيات تفاعلياً بالنقر على الصورة.
* استخدم `Show Image` لمعاينة الصورة أثناء اختيار نقطة العينة.
* أمِن موضع العينة بصرياً عبر إرسال الإحداثيات إلى `Draw Point` للتأكد من قراءة البكسل الصحيح.
* قص الصورة أولاً باستخدام `Image ROI` أو `Image ROI Select` لتقييد منطقة الاهتمام وتجنّب إحداثيات خارج النطاق.
* تحقق أن النقطة داخل منطقة مختارة باستخدام `Check Area` قبل العينات لتفادي الأخطاء.
* سجّل أو صدّر القيم المقروءة باستخدام `Image Logger` أو `CSV Export` للتحليل لاحقاً.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

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