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

# Draw Rectangle

Este bloque de función dibuja uno o varios rectángulos sobre una imagen de entrada. Cada rectángulo puede trazarse en verde o rojo según una entrada opcional de estado. Es útil para visualizar resultados de detección, resaltar regiones de interés o anotar imágenes para inspección y registro.

## 📥 Entradas

* `Image Any`\
  Imagen fuente donde se dibujarán los rectángulos (requerido).
* `Rectangle`\
  Un rectángulo o una lista de rectángulos. Cada rectángulo se define por los puntos superior-izquierdo e inferior-derecho en formato ((x0, y0), (x1, y1)) (requerido). Se admiten múltiples rectángulos.
* `Status`\
  Booleano opcional o lista de booleanos. `True` dibuja en verde, `False` dibuja en rojo. Si se omite, los rectángulos se dibujan en verde por defecto. Si se proporcionan múltiples rectángulos, puede suministrar una lista de estados correspondiente.

## 📤 Salidas

* `Image Any`\
  La imagen fuente con los rectángulos dibujados en una copia (la imagen original no se modifica).

## 🕹️ Controles

Este bloque no tiene widgets interactivos; su comportamiento se controla íntegramente mediante los puertos de entrada.

## 🎨 Características

* Dibuja uno o varios rectángulos con codificación de color clara (verde/rojo) según el estado.
* Acepta un único rectángulo o una lista de rectángulos.
* Acepta un único `Status` o una lista de `Status`; si no se proporciona, el estado por defecto es `True` (verde).
* Devuelve una copia de la imagen de entrada anotada con los rectángulos, de modo que las imágenes ascendentes permanezcan sin cambios.
* Usa un grosor de línea visible y adecuado para inspección en tamaños de imagen típicos.

## 📝 Instrucciones de uso

1. Proporcione una imagen en la entrada `Image Any`.
2. Proporcione un rectángulo o una lista de rectángulos en la entrada `Rectangle` en formato ((x0, y0), (x1, y1)).
3. Opcionalmente, proporcione un booleano o una lista de booleanos en la entrada `Status` para controlar los colores de los rectángulos.
4. Lea la imagen anotada desde la salida `Image Any` y conéctela a visores, registradores o bloques de procesamiento posteriores.

## 📊 Evaluación

Al ejecutarse, el bloque copia la imagen de entrada, dibuja cada rectángulo provisto en verde para `True` y en rojo para `False` (por defecto verde) y devuelve la imagen anotada. Entradas individuales devuelven una sola imagen anotada; listas de rectángulos aplican el mismo comportamiento a cada uno.

## 💡 Consejos y trucos

* Para visualizar resultados de detección: alimente los bounding boxes desde `Find Object` o `Object Detection` a la entrada `Rectangle` y opcionalmente coloree por condición usando `Status`.
* Para objetos rastreados, conecte las salidas del tracker `Object_Detection_Tracker` para dibujar rectángulos persistentes con IDs y estados.
* Pre-filtre regiones usando `Image ROI Select` antes de dibujar para limitar anotaciones a un área recortada.
* Combine con `Rectangles in Rectangle` para filtrar detecciones no deseadas y dibujar solo rectángulos que caigan dentro de un área de referencia.
* Use `Draw Detections` o `Draw Result On Image` si necesita etiquetas de texto o superposiciones estructuradas además de los rectángulos.
* Envíe la imagen anotada a `Show Image` para inspección rápida o a `Image Logger` / `Image Write` para guardar fotogramas anotados para auditorías e informes.

## 🛠️ Solución de problemas

* Rectángulos no visibles: verifique el orden de las coordenadas y que estén dentro de los límites de la imagen ((x0, y0), (x1, y1)).
* Colores inesperados: asegúrese de que la entrada `Status` coincida con el número de rectángulos o proporcione un único booleano para aplicar a todos.
* Anotaciones superpuestas se ven desordenadas: intente dibujar en una región recortada o use menos rectángulos más grandes producidos por preprocesos como `Find Object` con filtrado por área.
* Si necesita etiquetas o recuentos junto a los rectángulos, agregue `Write Text On Image` o `Draw Result On Image` aguas abajo.