> 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/spanish/function-blocks/blocks-reference/detections-shapes/roi-processing/get-pixel-mouse.md).

# Get Pixel Mouse

Esta función permite seleccionar interactivamente un píxel de una imagen haciendo clic en la imagen mostrada. Muestra la posición clicada en la imagen y entrega el color del píxel (o el valor en escala de grises) y las coordenadas del píxel.

## 📥 Entradas (sockets)

`Image Any`\
La imagen que se mostrará y de la cual se seleccionará un píxel.

## 📤 Salidas (sockets)

`(Blue, Green, Red)`\
El valor muestreado del píxel. Para imágenes en color se devuelve una tupla BGR; para imágenes en escala de grises se devuelve un único valor de canal.

`Point`\
Las coordenadas del píxel en el espacio de la imagen como `(x, y)`.

## 🕹️ Controles

`Image Display`\
Área de imagen interactiva donde puedes hacer clic para seleccionar un píxel.

`Click to Select`\
Haz clic en la imagen mostrada para elegir un punto. El punto seleccionado se marca visualmente (marcadores concéntricos) para que puedas confirmar la selección.

## 🎯 Características

* Retroalimentación visual: el píxel seleccionado se resalta directamente en la imagen para que veas inmediatamente de dónde se tomó la muestra.
* Salidas de color y posición: proporciona tanto el color/valor del píxel como sus coordenadas en la imagen para uso posterior.
* Funciona con imágenes en color y en escala de grises: devuelve una tupla BGR para imágenes en color y un solo valor para imágenes en escala de grises.
* Conserva la última selección: la última posición clicada se mantiene para que la visualización y las salidas sean consistentes hasta que selecciones un nuevo punto.

## 📝 Cómo usar

1. Conecta un bloque de función que produzca imagen al input `Image Any`.
2. La imagen aparecerá en el área `Image Display`.
3. Haz clic en cualquier punto de la imagen mostrada para seleccionarlo. La selección se muestra con marcadores en la imagen.
4. Usa las salidas `(Blue, Green, Red)` y `Point` para alimentar otros bloques o registrar el valor muestreado.

## 📊 Qué ocurre al ejecutarlo

Al ejecutarse, el bloque muestra la imagen más reciente desde su entrada. Si has hecho clic en la imagen, actualiza la visualización con un marcador visual y proporciona el valor muestreado del píxel y su coordenada a través de las salidas.

## 💡 Consejos y trucos

* Para previsualizar o hacer zoom antes de clicar, combínalo con `Show Image` para abrir la imagen en un visor más grande e inspeccionar detalles antes de muestrear.
* Si solo necesitas muestrear dentro de un área específica, recorta la imagen primero usando `Image ROI Select` o `Image ROI` y conecta el resultado recortado a este bloque.
* Para anotar resultados o marcar posiciones muestreadas en una imagen de salida final, usa `Draw Point` o `Draw Rectangle` después de muestrear.
* Si la iluminación o el color generan ruido en la muestra, prueba el preprocesado con `Blur`, `Image Threshold` o `HSV Filter` antes de alimentar la imagen a este bloque para mejorar la consistencia.
* Para guardar imágenes muestreadas o registros, conecta la salida de imagen de este bloque a `Image Logger` o `Image Write` para archivo o informes.

## 🛠️ Solución de problemas

* No aparece marcador tras hacer clic: asegúrate de que una imagen esté conectada y visible en `Image Display`. Si no hay imagen, el clic no tendrá efecto.
* Valores de píxel inesperados: verifica si la imagen de entrada es color o escala de grises—las imágenes en color devuelven una tupla BGR; las de escala de grises devuelven un único valor.
* Coordenadas fuera de rango: las posiciones de clic están limitadas al área de imagen mostrada. Si ves coordenadas inesperadas, asegúrate de que la imagen mostrada coincide con la resolución real de la imagen (usa `Image Resize` si es necesario).