Measure Object Distance

Este bloque mide la distancia entre dos ocurrencias de un objeto objetivo encontradas en una imagen fuente. Proporciona una vista previa visual con marcadores y salidas numéricas para las distancias X, Y y euclidiana. Úsalo cuando necesites mediciones espaciales rápidas entre dos objetos similares en una imagen.

📥 Entradas

• Main Image La imagen donde se localizarán y medirán los dos objetos.

• 1st Object Image Una imagen de plantilla (ejemplo) del primer objeto a encontrar.

• 2nd Object Image Una imagen de plantilla (ejemplo) del segundo objeto a encontrar.

📤 Salidas

• Image Any Resultado visual que muestra los objetos medidos y los marcadores.

• Distance Distancia euclidiana calculada entre los dos centros detectados (mostrada con el factor de medida elegido).

• X Distance Distancia horizontal entre los dos centros detectados.

• Y Distance Distancia vertical entre los dos centros detectados.

🕹️ Controles

• Measure Factor Introduce un factor numérico para convertir la distancia en píxeles a unidades del mundo real (por ejemplo, mm por píxel).

• Measured distance Etiqueta de lectura que muestra la distancia calculada para referencia rápida.

• Image Preview Área visual que muestra la imagen de entrada y los marcadores de medición.

⚙️ Mecanismo de ejecución

Al ejecutarse, el bloque busca en la Main Image coincidencias para los dos ejemplos de objeto proporcionados, determina las posiciones de centro para cada objeto encontrado y luego calcula las distancias X, Y y euclidiana entre esos centros. La distancia medida se multiplica por el Measure Factor para obtener resultados en la unidad deseada. La imagen de vista previa se actualiza mostrando las posiciones detectadas y la medición.

✨ Características

• Retroalimentación visual con marcadores y vista previa anotada para verificación sencilla.

• Salidas numéricas para informes de medición precisos y procesamiento posterior.

• Control sencillo mediante un único campo Measure Factor para convertir píxeles a unidades reales.

• Área de vista previa redimensionable para inspección más clara de los resultados.

📝 Uso

1. Proporciona la imagen de la escena en Main Image.

2. Suministra imágenes de ejemplo para los dos objetos en 1st Object Image y 2nd Object Image (deben representar lo que esperas encontrar).

3. Ajusta Measure Factor para convertir las distancias en píxeles a unidades reales (déjalo en 1 si quieres unidades en píxeles).

4. Ejecuta el flujo y revisa la vista previa en Image Any y las salidas Distance, X Distance, Y Distance.

💡 Consejos y trucos

• Si las plantillas son difíciles de encontrar en toda la escena, recorta el área primero con Image ROI Select para limitar la región de búsqueda y acelerar el emparejamiento.

• Usa Image Resizer o Image Resize para estandarizar tamaños si las plantillas se capturaron a una resolución distinta de la imagen principal.

• Mejora la fiabilidad del emparejamiento preprocesando con Adjust Colors, Contrast Optimization o Blur para reducir ruido y realzar características.

• Para verificar visualmente los resultados, conecta la salida Image Any a Show Image y abre la vista previa en un visor más grande.

• Si mides sobre pares múltiples o haces seguimiento en el tiempo, guarda fotogramas con Image Logger o exporta las mediciones vía CSV Export para análisis posterior.

• Si ya tienes rectángulos detectados de un detector de objetos, puedes combinar este bloque con bloques de detección (por ejemplo Find Object u otras salidas de detección) para localizar plantillas de forma más robusta antes de medir.

🛠️ Solución de problemas

• No se encuentran objetos: asegúrate de que las imágenes de ejemplo se parezcan a cómo aparecen los objetos en la Main Image (escala, orientación e iluminación similares). Considera usar Image Resize o Adjust Colors.

• Escala de distancia incorrecta: verifica el valor de Measure Factor. Para una escala real exacta, mide un objeto de referencia conocido en píxeles y deriva el factor.

• Coincidencias múltiples o incorrectas: recorta el área de búsqueda con Image ROI Select o aumenta el contraste con Contrast Optimization para reducir coincidencias falsas.

• Vista previa no se actualiza: asegúrate de que Main Image contenga una imagen válida y vuelve a abrir la vista previa (para vista ampliada usa Show Image).