Image ROI

Este bloque de función permite recortar una región de interés de una imagen de entrada usando deslizadores de rango. Ajusta los deslizadores Width y Height para definir un recorte rectangular; el bloque devuelve la imagen recortada y las coordenadas del rectángulo para su uso posterior.

📥 Entradas

Image Any Proporciona la imagen fuente que se va a recortar.

📤 Salidas

Image Any Imagen recortada correspondiente al rectángulo seleccionado.

Rectangle Coordenadas del ROI seleccionado en forma de rectángulo.

🕹️ Controles

Width Deslizador de rango horizontal para establecer los límites de recorte izquierda/derecha (min y max).

Height Deslizador de rango vertical para establecer los límites de recorte superior/inferior (min y max).

Input Image Size (H, W) Etiqueta informativa que muestra las dimensiones de la imagen de entrada y actualiza automáticamente los rangos de los deslizadores.

⚙️ Mecanismo de ejecución

Cuando el bloque recibe una imagen de entrada, lee las dimensiones de la imagen y ajusta los rangos de los deslizadores Width y Height para que coincidan con el tamaño de la imagen. Los deslizadores proporcionan valores enteros de mínimo/máximo que definen el rectángulo de recorte. Al evaluarse, el bloque devuelve la imagen recortada y una forma de Rectangle que representa el ROI.

🎯 Características

• Rangos de deslizadores dinámicos que se adaptan automáticamente al tamaño de la imagen conectada.

• Devuelve tanto la imagen recortada como las coordenadas del rectángulo para uso posterior.

• Conserva la disposición de canales de la imagen (color o escala de grises) en el resultado recortado.

• Recuerda y restaura el tamaño de la imagen de entrada al guardar/cargar escenarios (soporte de serialización).

📝 Instrucciones de uso

1. Conecta un bloque que produzca imagen a la entrada Image Any.

2. Observa la etiqueta Input Image Size (H, W) para confirmar las dimensiones.

3. Ajusta el deslizador Width (min/max) para establecer los límites de recorte horizontales.

4. Ajusta el deslizador Height (min/max) para establecer los límites de recorte verticales.

5. Usa las salidas según necesites: pasa la imagen recortada a bloques de análisis o emplea las coordenadas del rectángulo para visualización.

💡 Consejos y trucos

• Para inspeccionar visualmente el ROI seleccionado mientras ajustas los deslizadores, envía la salida Image Any al bloque Show Image.

• Si la imagen de entrada es muy grande, coloca un bloque Image Resizer antes de este bloque para acelerar los ajustes interactivos de los deslizadores.

• Usa Image ROI Select o Image ROI Select Multi si prefieres seleccionar áreas de recorte con el ratón en lugar de los deslizadores; luego alimenta el Rectangle resultante a este bloque o usa sus salidas en la cadena de procesamiento.

• Para detección enfocada en el área recortada, conecta la imagen recortada a bloques detectores como Find Object, Object Detection o Blob Detector para reducir coincidencias falsas y acelerar el procesamiento.

• Para guardar ejemplos del ROI o registrarlos, conecta la salida de la imagen recortada a Image Logger o Image Write.

• Para marcar el ROI en la imagen original para visualización, usa la salida Rectangle con Draw Rectangle y luego previsualiza con Show Image.

• Combínalo con Histogram On Line o Histogram On Curve para análisis de perfil limitado al área recortada.

• Usa las coordenadas del rectángulo con bloques conscientes del ROI como Get ROI o Check Area para crear lógica posterior basada en posiciones de objetos dentro de la región seleccionada.

🛠️ Solución de problemas

• Si los deslizadores no cubren toda la extensión de la imagen, confirma que hay una imagen conectada y visible en la etiqueta Input Image Size (H, W) — los deslizadores se actualizan solo después de recibir la imagen.

• Si la salida recortada está vacía o en negro, asegúrate de que los valores min/max de los deslizadores definan un área no nula y estén dentro de los límites de la imagen.

• Si los bloques posteriores esperan un formato de canal específico (escala de grises vs RGB), usa conversión de color o un bloque de preprocesamiento como Image Resizer antes o después del recorte para ajustar al formato esperado.