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

# Measure Position Distance

Ce bloc fonction calcule la distance horizontale, verticale et la distance en ligne droite (euclidienne) entre deux positions dans une image. Utilisez-le lorsque vous avez besoin d'informations d'espacement au niveau des pixels entre deux points (format : (x, y)).

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

`Point` Première position (x, y) à comparer.\
`Point` Deuxième position (x, y) à comparer.

(astuce : les deux entrées acceptent une seule paire de coordonnées. Fournissez les deux positions dans l'ordre où vous souhaitez mesurer.)

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

`X Distance` Différence horizontale entre les deux positions (valeur absolue, pixels).\
`Y Distance` Différence verticale entre les deux positions (valeur absolue, pixels).\
`Distance` Distance euclidienne entre les deux positions (pixels).

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

Ce bloc n'a pas de contrôles interactifs ni de curseurs — il calcule simplement les distances à partir des entrées fournies.

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

* Calcul simple des distances en coordonnées de pixels d'image.
* Renvoie à la fois les distances par axe et la distance euclidienne combinée pour faciliter les traitements en aval.
* Fonctionne avec les résultats produits par les blocs de détection et d'annotation (centres, points de repère, etc.).

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

1. Fournissez la première paire de coordonnées à l'entrée `Point` du premier emplacement.
2. Fournissez la seconde paire de coordonnées à l'entrée `Point` du second emplacement.
3. Lisez les résultats sur les trois sorties : `X Distance`, `Y Distance` et `Distance`.
4. Utilisez les sorties directement pour la visualisation, les décisions logiques, la journalisation ou l'export.

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

Lors de l'exécution, le bloc calcule la différence absolue sur les axes X et Y et la distance euclidienne entre les deux positions fournies, puis renvoie ces valeurs numériques.

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

* Si vous avez besoin de coordonnées provenant de détecteurs automatiques, combinez avec `Find Object` ou `Object Detection` / `Object Detection - Custom` pour obtenir les centres d'objet, puis alimentez ces centres dans ce bloc.
* Pour des objets suivis dans le temps, utilisez `Object_Detection_Tracker` pour obtenir des listes de positions et mesurer les distances entre des IDs suivis.
* Visualisez les résultats en connectant les sorties à `Draw Point` ou `Draw Line` (pour dessiner le segment mesuré) et affichez l'image annotée avec `Show Image`.
* Tracez des valeurs numériques en direct (par exemple la distance au fil du temps) en envoyant la sortie `Distance` vers `Scope`.
* Pour mesurer des distances à l'intérieur d'une région recadrée, recadrez d'abord avec `Image ROI` ou `Image ROI Select` puis fournissez les coordonnées dans l'espace ROI local.
* Si vous devez comparer des distances entre deux objets trouvés directement, envisagez d’associer ce bloc à `Measure Object Distance` pour des flux de travail centrés sur les objets.

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

* Si les distances semblent incorrectes, vérifiez que les deux entrées sont des paires `(x, y)` valides et qu'elles utilisent le même système de coordonnées (image entière vs ROI recadrée).
* Si une entrée est manquante, le bloc ne peut pas calculer de distances significatives — assurez-vous que les deux entrées sont connectées ou protégées avec des blocs tels que `Is None` / `Replace None` dans des flux plus larges.
* N'oubliez pas que les résultats sont en pixels. Convertissez en unités réelles en externe si vous disposez d'une calibration ou d'un facteur d'échelle.
