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

# Draw Line

Este bloque de función te permite marcar líneas de forma interactiva directamente sobre una imagen usando el ratón y atajos de teclado sencillos. Úsalo para dibujar líneas simples o múltiples líneas conectadas, extraer coordenadas y obtener información de ángulos para cada segmento.

## 📥 Entradas

`Image Any`\
La imagen en la que se dibujarán las líneas. Conecta aquí cualquier bloque que produzca imágenes.

`Calculate All Points`\
Cuando está en TRUE, el bloque devuelve cada coordenada de píxel a lo largo de cada segmento dibujado en lugar de solo los puntos finales.

## 📤 Salidas

`Image Any`\
La imagen anotada que muestra las líneas dibujadas o los puntos calculados.

`Line Coordinates`\
Una lista de formas de línea que representan cada segmento dibujado.

`Angles`\
Valores de rotación o ángulo para cada segmento de línea.

## 🕹️ Controles

`Image Area`\
Haz clic con el botón izquierdo del ratón en el área de la imagen para añadir puntos y formar líneas.

`Press U`\
Deshace el último punto o segmento añadido.

`Press C`\
Borra todos los puntos y líneas dibujados.

Sugerencia: el área de imagen muestra retroalimentación visual en tiempo real mientras añades, deshaces o borras marcas.

## 🎨 Características

* Dibujo interactivo directamente sobre la imagen con retroalimentación visual inmediata.
* Atajos de teclado para edición rápida: deshacer (`Press U`) y borrar (`Press C`).
* Opción para devolver listas densas de coordenadas a lo largo de cada línea cuando `Calculate All Points` está activado.
* Estimación de ángulo por segmento, útil para tareas de orientación o alineación.

## 📝 Instrucciones de uso

1. Conecta un bloque productor de imágenes al input `Image Any` (por ejemplo, `Camera USB` o un cargador de imágenes).
2. Haz clic en el área de la imagen para colocar puntos. Los clics consecutivos forman segmentos de línea.
3. Para obtener cada coordenada de píxel a lo largo de los segmentos, establece el input `Calculate All Points` en TRUE.
4. Usa `Press U` para deshacer el último punto o `Press C` para borrar todas las marcas.
5. Consulta las salidas para obtener la imagen anotada, la lista `Line Coordinates` y los `Angles`.

## 📊 Evaluación

Al ejecutarse, este bloque actualiza la vista previa interactiva de la imagen con las líneas dibujadas y calcula las salidas según los puntos actuales. Si `Calculate All Points` está activado, el bloque expande cada segmento en sus coordenadas de píxeles constituyentes antes de devolver los resultados.

## 💡 Consejos y trucos

* Para entrada de cámara en vivo, conecta `Camera USB` o `Stream Reader` al input `Image Any` para dibujar directamente sobre frames en tiempo real.
* Para inspeccionar resultados en una ventana más grande, combina este bloque con `Show Image` después de las salidas.
* Si necesitas restringir el dibujo a un área específica, recorta primero con `Image ROI Select` o `Image ROI` y alimenta la imagen recortada a este bloque.
* Para análisis detallado a lo largo de una línea dibujada, activa `Calculate All Points` y usa `Measure Position Distance` o `Histogram On Line` sobre las coordenadas o la imagen resultante.
* Reduce el ruido antes de dibujar preprocesando la entrada con `Blur` o `Denoising` cuando los bordes estén ruidosos.
* Con imágenes muy grandes, usa `Image Resizer` para bajar la resolución y mejorar la interactividad; si es necesario, vuelve a mapear las coordenadas a la resolución original.

## 🛠️ Solución de problemas

* Sin respuesta al dibujar: verifica que haya una imagen válida conectada a `Image Any` y que el escenario esté en ejecución.
* Puntos no alineados como se espera: ajusta el zoom o el tamaño de la imagen para que la vista previa y el uso posterior coincidan, o recorta con `Image ROI Select` antes de dibujar.
* Demasiadas coordenadas devueltas: desactiva `Calculate All Points` si solo necesitas los extremos de los segmentos, o reduce la resolución de la imagen para disminuir la densidad de puntos.