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

# Get ROI

Esta función extrae una región rectangular de una imagen de entrada. Úsala cuando quieras recortar un área específica para análisis posterior o visualización.

## 📥 Entradas

`Image Any` Imagen de origen desde la que se extraerá la región.

`Rectangle` Coordenadas del rectángulo que definen la región a extraer (normalmente dos puntos esquina).

## 📤 Salidas

`Image Any` La región recortada como una imagen.

## 🕹️ Controles

Este bloque de función no tiene widgets interactivos internos. Proporciona el rectángulo mediante una entrada de forma o desde otros bloques de selección de ROI.

## 🎨 Características

* Recorte rectangular simple entregado como salida de imagen para bloques posteriores.
* Acepta la entrada de rectángulo como dos coordenadas de esquina (por ejemplo, top-left y bottom-right).
* Maneja automáticamente valores de rectángulo fuera de los límites de la imagen para evitar errores en tiempo de ejecución.

## 📝 Instrucciones de uso

1. Conecta la imagen de origen a la entrada `Image Any`.
2. Proporciona un `Rectangle` que describa la región a extraer. Esto puede producirse mediante bloques interactivos de selección ROI o por otros bloques que produzcan coordenadas de rectángulo.
3. Usa la salida `Image Any` para enviar la región recortada a los bloques posteriores.

## 📊 Evaluación

Al ejecutarse, este bloque devuelve la imagen dentro del rectángulo proporcionado. Si el rectángulo se extiende más allá de los bordes de la imagen, la región se recortará al área válida de la imagen.

## 💡 Consejos y trucos

* Para selección interactiva, combínalo con `Image ROI Select` para dibujar un rectángulo sobre la fuente y conectar su salida al input `Rectangle`.
* Para extraer múltiples regiones a la vez, usa `Image ROI Select Multi` o `Image ROI Polygon Multi` para generar varios rectángulos o polígonos, y luego alimenta cada rectángulo a instancias separadas de este bloque o itera usando bloques de control de flujo.
* Previsualiza el resultado recortado conectando la salida a `Show Image`.
* Usa `Image Resize` o `Image Padding` después de este bloque si un bloque posterior requiere un tamaño de imagen específico.
* En flujos basados en objetos, recorta la región primero (con este bloque) y luego ejecuta `Find Object`, `Template Match` o `Histogram On Line` sobre el área extraída para mejorar la velocidad y reducir falsos positivos.
* Si necesitas un recorte centrado, combínalo con `Image ROI Center` para generar un rectángulo alrededor de un punto centro elegido.
* Usa `Draw Rectangle` en una ruta de visualización para mostrar el ROI seleccionado sobre la imagen original y verificarlo.

## 🛠️ Solución de problemas

* Si la salida está vacía o recortada inesperadamente, verifica que el `Rectangle` contiene dos coordenadas de esquina válidas dentro de los límites de la imagen.
* Si el recorte aparece desplazado o invertido, asegúrate de que el rectángulo se proporcione como pares de esquinas top-left y bottom-right (o el orden de coordenadas que acepte tu fuente de ROI).
* Si necesitas un ROI de tamaño consistente con resoluciones de imagen variables, añade `Image Resize` antes o después de este bloque para normalizar dimensiones.