Image ROI Select Multi

Bloque interactivo para seleccionar y editar múltiples Regiones de Interés (ROIs) rectangulares en una imagen. Dibuja, mueve y cambia el tamaño de los rectángulos directamente en la vista previa de la imagen para obtener recortes y coordenadas de rectángulos en píxeles que se usarán en pasos posteriores del flujo.

📥 Entradas

Image Conecta una imagen en color o en escala de grises que se usará como fuente para la selección de ROIs.

📤 Salidas

Images Imagen recortada para cada ROI (lista). Rectangles Rectángulos en píxeles para cada ROI (lista). Selected Image Recorte para el ROI actualmente seleccionado (imagen única o None). Selected Rectangle Rectángulo en píxeles del ROI seleccionado (rectángulo único o None).

🕹️ Controles

• Draw: haz click y arrastra en un área vacía de la imagen para crear un nuevo ROI.

• Move: haz click y arrastra dentro de un rectángulo para moverlo.

• Resize: haz click y arrastra los bordes o las esquinas del rectángulo para cambiar su tamaño.

• Ctrl Mantén pulsado mientras arrastras para forzar la creación de un nuevo rectángulo (incluso si estás sobre un ROI existente).

• C Pulsa para borrar todos los ROIs.

• U Pulsa para deshacer el último ROI creado.

• Delete / Backspace Pulsa para eliminar el ROI seleccionado.

• Escape Pulsa para cancelar la selección/arrastre.

La vista previa muestra superposiciones y manejadores para indicar estados de hover, selección y previsualización.

🎨 Características

• Edición multi-ROI: crea múltiples ROIs rectangulares en una misma sesión de imagen.

• Previsualización en vivo: superposición interactiva y actualizaciones de vista previa mientras editas.

• Salidas con precisión de píxeles: Rectangles y Selected Rectangle se devuelven en coordenadas de píxeles relativas a la imagen fuente.

• Interfaz responsiva: la vista previa se redimensiona para ajustarse al área del bloque y mantiene las superposiciones consistentes.

• Serialización: los ROIs y la selección se preservan al guardar/cargar un escenario.

📊 How it runs

• Cuando llega una imagen al input Image, el bloque la almacena como fuente actual y actualiza la vista previa.

• El bloque convierte las definiciones de ROI actuales a rectángulos en píxeles usando el tamaño de la imagen fuente y produce las salidas: Images (recortes por ROI), Rectangles (coordenadas en píxeles), Selected Image y Selected Rectangle.

• Si no hay imagen conectada, el bloque emite listas vacías y valores None (sin recortes).

📝 Instrucciones de uso

1. Conecta un bloque que genere imágenes al input Image (cámara, loader, stream).

2. Haz click y arrastra en la vista previa para crear ROIs. Usa los bordes/esquinas para ajustar el tamaño.

3. Haz click dentro de un rectángulo para seleccionarlo; el recorte seleccionado estará disponible en Selected Image.

4. Usa los atajos de teclado (C, U, Delete/Backspace, Escape) y mantén Ctrl para modificar el comportamiento de creación.

5. Usar las salidas en bloques posteriores para analizar o guardar los recortes.

💡 Consejos y trucos

• Inspección rápida: conecta la salida Selected Image al bloque Show Image para previsualizar el recorte seleccionado en un visor más grande.

• Procesamiento por lotes: alimenta la salida Images a Collage Images para crear una vista combinada de todos los recortes, o a Image Logger / Image Write para guardar los recortes automáticamente.

• Análisis focalizado: usa la salida Rectangles como entrada a Get ROI si quieres aplicar la misma lista de rectángulos a otras imágenes (por ejemplo series temporales o distintos fotogramas).

• Combinar con detectores: crea ROIs para localizar áreas de interés y luego envía los recortes (Images) a bloques como Find Object, Feature Detector, Blob Detector u OCR para ejecutar detección/reconocimiento específico por recorte.

• Visualización: dibuja los Rectangles devueltos sobre la imagen fuente usando Draw Rectangle o Draw Detections para ver los resultados junto a otras anotaciones.

• Preprocesado: antes de la selección manual de ROIs puedes preparar la imagen fuente con Blur, Image Threshold o HSV Filter para que las estructuras sean más fáciles de ver y seleccionar.

• Uso en pipelines con bucles: pasa los recortes de ROI a bloques de Analysis o AI (por ejemplo Object Detection o Background Removal) para crear flujos de procesamiento por región eficientes.

🛠️ Solución de problemas

• Sin vista previa o controles deshabilitados: asegúrate de que hay una imagen válida conectada al input Image.

• ROIs no exportados correctamente: verifica que la imagen fuente tenga las dimensiones correctas; el bloque emite rectángulos en píxeles relativos al tamaño de la imagen de entrada.

• Comportamiento de selección inesperado: mantén Ctrl mientras arrastras para forzar la creación de un nuevo ROI en lugar de modificar uno existente.

• Demasiados o faltantes ROIs en pasos posteriores: confirma que estás usando la salida correcta (Images vs Selected Image) y que los bloques aguas abajo aceptan entradas en formato lista cuando alimentas múltiples recortes.