> 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/image-transformations/analysis/measure-position-distance.md).

# Measure Position Distance

Esta función calcula la distancia horizontal, vertical y en línea recta entre dos posiciones en una imagen. Úsala cuando necesites información de separación a nivel de píxel entre dos puntos (formato: (x, y)).

## 📥 Inputs <a href="#inputs" id="inputs"></a>

`Point` Primera posición (x, y) a comparar.\
`Point` Segunda posición (x, y) a comparar.

(pista: ambas entradas aceptan un único par de coordenadas. Proporciona las dos posiciones en el orden que quieras medir.)

## 📤 Outputs <a href="#outputs" id="outputs"></a>

`X Distance` Diferencia horizontal entre las dos posiciones (valor absoluto, píxeles).\
`Y Distance` Diferencia vertical entre las dos posiciones (valor absoluto, píxeles).\
`Distance` Distancia euclidiana entre las dos posiciones (píxeles).

## 🕹️ Controls <a href="#controls" id="controls"></a>

Este bloque no tiene controles interactivos ni deslizadores — simplemente calcula las distancias a partir de las entradas proporcionadas.

## 🎯 Features <a href="#features" id="features"></a>

* Cálculo directo de distancias en coordenadas de píxeles de imagen.
* Devuelve tanto las distancias por eje como la distancia euclidiana combinada para facilitar su uso posterior.
* Funciona con resultados generados por bloques de detección y anotación (centros, puntos de referencia, etc.).

## 📝 How to use <a href="#usage" id="usage"></a>

1. Proporciona el primer par de coordenadas a la primera entrada `Point`.
2. Proporciona el segundo par de coordenadas a la segunda entrada `Point`.
3. Lee los resultados en las tres salidas: `X Distance`, `Y Distance` y `Distance`.
4. Usa las salidas directamente para visualización, decisiones lógicas, registro o exportación.

## 📊 Evaluation <a href="#evaluation" id="evaluation"></a>

Al ejecutarse, el bloque calcula la diferencia absoluta en los ejes X e Y y la distancia euclidiana entre las dos posiciones proporcionadas, y luego devuelve estos valores numéricos.

## 💡 Tips and Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Si necesitas coordenadas de detectores automáticos, combínalo con `Find Object` o `Object Detection` / `Object Detection - Custom` para obtener centros de objetos y luego alimenta esos centros a este bloque.
* Para objetos rastreados en el tiempo, usa `Object_Detection_Tracker` para obtener listas de posiciones y medir distancias entre IDs rastreados.
* Visualiza resultados conectando las salidas a `Draw Point` o `Draw Line` (para dibujar el segmento medido) y muestra la imagen anotada con `Show Image`.
* Grafica valores numéricos en vivo (por ejemplo distancia en el tiempo) enviando la salida `Distance` a `Scope`.
* Para medir distancias dentro de una región recortada, recorta primero con `Image ROI` o `Image ROI Select` y luego alimenta coordenadas en el espacio local del ROI.
* Si necesitas comparar distancias entre dos objetos encontrados directamente, considera emparejar este bloque con `Measure Object Distance` para flujos de trabajo basados en objetos a un nivel más alto.

## 🛠️ Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

* Si las distancias parecen incorrectas, confirma que ambas entradas son pares válidos `(x, y)` y que usan el mismo sistema de coordenadas (imagen completa vs. ROI recortada).
* Si falta una entrada, el bloque no puede calcular distancias significativas — asegúrate de que ambas entradas estén conectadas o protegidas con bloques como `Is None` / `Replace None` en flujos más grandes.
* Recuerda que los resultados están en píxeles. Convierte a unidades del mundo real externamente si dispones de una calibración o factor de escala.
