> 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/detectors/measure-object-distance.md).

# 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 <a href="#inputs" id="inputs"></a>

* `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 <a href="#outputs" id="outputs"></a>

* `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 <a href="#controls" id="controls"></a>

* `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 <a href="#running-mechanism" id="running-mechanism"></a>

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 <a href="#features" id="features"></a>

* 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 <a href="#usage" id="usage"></a>

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 <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* 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 <a href="#troubleshooting" id="troubleshooting"></a>

* 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`).