> 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-mouse.md).

# Get Pixel Mouse

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

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

`Image Any` الصورة التي سيتم عرضها واختيار بكسل منها.

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

`(Blue, Green, Red)` قيمة البكسل المأخوذة. بالنسبة للصور الملونة تُرجع هذه القيمة كثلاثية BGR، وبالنسبة للصور بتدرج الرمادي تُرجع قيمة أحادية القناة.

`Point` إحداثيات البكسل في فضاء الصورة بصيغة `(x, y)`.

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

`Image Display` مساحة عرض تفاعلية للصورة حيث يمكنك النقر لاختيار بكسل.

`Click to Select` انقر على الصورة المعروضة لاختيار نقطة. توضع علامة مرئية حول النقطة المحددة (علامات متحدة المركز) لتأكيد الاختيار.

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

* تغذية بصرية: يتم تمييز البكسل المحدد مباشرة على الصورة بحيث ترى فورًا مكان العينة.
* مخرجات اللون والموقع: يوفر كل من لون/قيمة البكسل وإحداثياته لاستخدامها في المعالجة اللاحقة.
* يعمل مع الصور الملونة وتدرج الرمادي: يرجع ثلاثية BGR للصور الملونة وقيمة واحدة للصور الرمادية.
* يحفظ آخر اختيار: يبقى الموضع الذي نقرت عليه محفوظًا حتى تختار نقطة جديدة، فيبقى العرض والمخرجات ثابتة.

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

1. اربط كتلة تُنتج صورة مع مدخل `Image Any`.
2. ستظهر الصورة في منطقة `Image Display`.
3. انقر على أي نقطة في الصورة المعروضة لاختيارها. سيظهر الاختيار بعلامات على الصورة.
4. استخدم المخرجات `(Blue, Green, Red)` و`Point` لتمريرها إلى كتل أخرى أو لتسجيل القيمة المأخوذة.

## 📊 ماذا يحدث عند التشغيل <a href="#evaluation" id="evaluation"></a>

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

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

* لمعاينة أو تكبير الصور قبل النقر، اربط مع `Show Image` حتى تتمكن من فتح الصورة في عارض أكبر وفحص التفاصيل قبل أخذ العينة.
* إذا كنت بحاجة لأخذ عينة ضمن منطقة محددة فقط، قُم بقص الصورة أولًا باستخدام `Image ROI Select` أو `Image ROI` ثم اربط النتيجة المقتطعة بهذه الكتلة.
* لوضع تعليقات أو تعليم المواقع المأخوذة على صورة الإخراج النهائية، استخدم بعد العينة `Draw Point` أو `Draw Rectangle`.
* إذا كانت الإضاءة أو الألوان تسبب ضوضاء في العينات، جرب المعالجة المسبقة بـ `Blur`, `Image Threshold`، أو `HSV Filter` قبل إدخال الصورة هنا لتحسين ثبات العينة.
* لحفظ الصور المأخوذة أو التسجيلات، اربط مخرجات المسار مع `Image Logger` أو `Image Write` للأرشفة أو التقارير.

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

* لا تظهر علامة بعد النقر: تأكد من وجود صورة متصلة ومرئية في `Image Display`. إذا لم تكن هناك صورة، فلن يكون للنقر أي تأثير.
* قيم بكسل غير متوقعة: تحقق إذا ما كانت الصورة الملحقة ملونة أم رمادية — الصور الملونة ترجع ثلاثية BGR، والرمادية ترجع قيمة واحدة.
* إحداثيات خارج النطاق: مواقع النقر مقيدة بمنطقة الصورة المعروضة. إذا ظهرت إحداثيات غير متوقعة، تأكد أن الصورة المعروضة تطابق دقة الصورة الفعلية (استخدم `Image Resize` إذا لزم الأمر).