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

# Get Pixel

Este bloque de función lee el valor de color en una coordenada específica de una imagen y lo devuelve para uso posterior. Soporta imágenes en color (BGR) y en escala de grises, y valida la coordenada antes de muestrear.

## 📥 Entradas <a href="#inputs" id="inputs"></a>

`Image Any` Imagen principal de la que se tomará la muestra.

`Point` Coordenada del píxel a leer (formato: (x, y)).

## 📤 Salidas <a href="#outputs" id="outputs"></a>

`(Blue, Green, Red)` Valor del píxel leído en la coordenada indicada.

* Para imágenes en color, se devuelven los canales B, G, R juntos.
* Para imágenes en escala de grises, se devuelve un único valor de canal.

## 🕹️ Controles <a href="#controls" id="controls"></a>

Este bloque no tiene controles interactivos ni widgets.

## 🎨 Características <a href="#features" id="features"></a>

* Muestreo simple de un píxel por coordenada.
* Funciona con imágenes en color (BGR) y en escala de grises.
* Validación de entradas con mensajes de error claros si la imagen no es válida o la coordenada está fuera de los límites.
* Devuelve valores en un formato listo para conectar a otros bloques que acepten datos de píxel o valores numéricos.

## ⚙️ Mecanismo de ejecución <a href="#running-mechanism" id="running-mechanism"></a>

* El bloque lee la imagen desde el primer conector de entrada y la coordenada desde el segundo.
* Si la imagen o la coordenada no son válidas, el bloque muestra un error para que puedas corregir las entradas.
* Si todo es válido, el bloque muestrea el píxel en la posición (x, y) indicada y emite sus valores de canal.

## 📝 Instrucciones de uso <a href="#usage" id="usage"></a>

1. Conecta un bloque que produzca imagen al input `Image Any`.
2. Proporciona una coordenada al input `Point` (formato (x, y)).
3. Usa la salida `(Blue, Green, Red)` donde la necesites (visualización, comparación, registro, etc.).

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Combínalo con `Get Pixel Mouse` para elegir coordenadas de forma interactiva haciendo clic en la imagen.
* Usa `Show Image` para previsualizar la imagen mientras eliges la coordenada de muestreo.
* Visualiza la posición muestreada enviando la coordenada a `Draw Point` para confirmar que se lee el píxel correcto.
* Recorta la imagen primero con `Image ROI` o `Image ROI Select` para limitar el muestreo a una región de interés y evitar coordenadas fuera de rango.
* Valida que un punto esté dentro de un área seleccionada usando `Check Area` antes de muestrear para evitar errores.
* Registra o exporta los valores muestreados con `Image Logger` o `CSV Export` para análisis posterior.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* Si aparece un error sobre la entrada de imagen, verifica que el bloque conectado realmente proporcione una imagen y que los datos no estén vacíos.
* Si hay un error sobre la coordenada, comprueba que los valores (x, y) sean enteros y estén dentro del ancho y alto de la imagen.
* Al muestrear desde una imagen en escala de grises, espera un único valor de canal en lugar de tres.
