> 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/draw/draw-point.md).

# Draw Point

Este bloque de función dibuja uno o más puntos marcadores sobre una imagen de entrada en las coordenadas que proporciones. Es útil para visualizar posiciones detectadas, anotaciones o resultados de medición.

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

`Image Any` La imagen fuente donde se dibujarán los puntos (RGB/BGR o escala de grises).

`Points` Una coordenada o una lista de coordenadas para dibujar. Las coordenadas están en formato (x, y) o (col, row) y pueden ser una sola tupla o una lista de tuplas.

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

`Image Any` La imagen con los puntos dibujados como superposición.

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

Este bloque no tiene controles de UI adicionales. Usa las entradas conectadas para determinar dónde y cómo se dibujan los puntos.

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

* Marcadores visuales: Dibuja marcadores circulares rellenos con un contorno de dos colores para que los puntos sean visibles sobre diferentes fondos.
* Tamaño de marcador autoescalado: El tamaño del marcador se adapta a la resolución de la imagen para que los puntos sean visibles en imágenes pequeñas y grandes.
* Acepta punto único o múltiples: Funciona con una única coordenada o con una lista de coordenadas para anotaciones por lotes.
* No destructivo: Genera una copia de la imagen de entrada con las superposiciones, preservando la imagen original corriente arriba.

## 📊 Mecanismo de ejecución <a href="#evaluation" id="evaluation"></a>

Cuando está activo, el bloque lee la imagen y las coordenadas proporcionadas, coloca marcadores visibles en la imagen en cada coordenada y produce la imagen anotada para bloques posteriores o para visualización.

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

1. Conecta un bloque que produzca imagen a la entrada `Image Any`.
2. Proporciona una coordenada única o una lista de coordenadas a la entrada `Points`.
3. Usa la salida `Image Any` resultante para previsualizar (por ejemplo con el bloque `Show Image`) o para pasar la imagen anotada a bloques de exportación o procesamiento adicional.

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

* Para obtener coordenadas mediante clic del usuario, combina este bloque con `Get Pixel Mouse` para dibujar las posiciones clicadas en la imagen.
* Para visualizar centros de objetos detectados, alimenta las coordenadas desde `Object Detection`, `Object Detection - Custom` o `Object_Detection_Tracker` a la entrada `Points`.
* Para puntos basados en contornos, usa `Find Contour` o `Approximate Contour` para extraer puntos y luego dibujarlos con este bloque.
* Recorta primero a una región de interés usando `Image ROI Select` o `Image ROI` para dibujar solo dentro de un área específica.
* Combínalo con `Draw Detections` si quieres tanto cajas delimitadoras como marcadores de puntos en la misma imagen.
* Si necesitas guardar fotogramas anotados, conecta la salida a `Image Logger` o `Image Write`.
* Usa `Slice Image` o `Image Resize` en etapas anteriores si el tamaño o la densidad de los marcadores necesita ajuste para presentación o exportación.

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

* Si los marcadores no aparecen, verifica que la entrada `Points` contenga coordenadas válidas dentro de los límites de la imagen (0 ≤ x < width, 0 ≤ y < height).
* Si solo aparece un marcador cuando esperabas varios, asegúrate de que la entrada `Points` sea una lista de tuplas de coordenadas y no una sola tupla.
* Si los marcadores son demasiado pequeños o grandes para la imagen, redimensiona la imagen usando `Image Resize` o recorta con `Image ROI` antes de dibujar.
