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

# Measure Object Distance

Ce bloc mesure la distance entre deux occurrences d’un même objet trouvées dans une image source. Il affiche un aperçu visuel avec des marqueurs et fournit des sorties numériques pour les distances X, Y et euclidienne. Utilisez-le lorsque vous avez besoin de mesures spatiales rapides entre deux objets similaires dans une image.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

* `Main Image` L’image dans laquelle les deux objets seront localisés et mesurés.
* `1st Object Image` Une image modèle (exemple) du premier objet à trouver.
* `2nd Object Image` Une image modèle (exemple) du deuxième objet à trouver.

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

* `Image Any` Résultat visuel montrant les objets mesurés et les marqueurs.
* `Distance` Distance euclidienne calculée entre les deux centres d’objet détectés (affichée avec le facteur de mesure choisi).
* `X Distance` Distance horizontale entre les deux centres détectés.
* `Y Distance` Distance verticale entre les deux centres détectés.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

* `Measure Factor` Saisissez un facteur numérique pour convertir la distance en pixels en unités réelles (par exemple, mm par pixel).
* `Measured distance` Étiquette d'affichage montrant la distance calculée pour un accès rapide.
* `Image Preview` Zone visuelle qui affiche l’image d’entrée et les marqueurs de mesure.

## ⚙️ Mécanisme d’exécution <a href="#running-mechanism" id="running-mechanism"></a>

Quand le bloc s’exécute, il recherche dans la `Main Image` des correspondances avec les deux exemples d’objets fournis, détermine les positions centrées de chaque objet trouvé, puis calcule les distances X, Y et euclidienne entre ces centres. La distance mesurée est multipliée par le `Measure Factor` pour fournir les résultats dans l’unité souhaitée. L’image d’aperçu est mise à jour pour montrer les positions détectées et la mesure.

## ✨ Fonctionnalités <a href="#features" id="features"></a>

* Rétroaction visuelle avec marqueurs et image d’aperçu annotée pour une vérification facile.
* Sorties numériques pour un rapport de mesure précis et pour un traitement ultérieur.
* Contrôle simple via un seul champ `Measure Factor` pour convertir les pixels en unités réelles.
* Zone d’aperçu redimensionnable pour une inspection plus claire des résultats.

## 📝 Utilisation <a href="#usage" id="usage"></a>

1. Fournissez l’image de la scène à `Main Image`.
2. Fournissez les images exemples pour les deux objets à `1st Object Image` et `2nd Object Image` (elles doivent représenter ce que vous attendez de trouver).
3. Réglez le `Measure Factor` pour convertir les distances en pixels vers des unités réelles (laisser 1 pour obtenir des unités en pixels).
4. Exécutez le flux et consultez l’aperçu `Image Any` ainsi que les sorties `Distance`, `X Distance`, `Y Distance`.

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

* Si les modèles sont difficiles à trouver dans l’ensemble de la scène, recadrez d’abord la zone avec `Image ROI Select` pour limiter la zone de recherche et accélérer la correspondance.
* Utilisez `Image Resizer` ou `Image Resize` pour standardiser les tailles d’image si les modèles ont été capturés à une résolution différente de l’image principale.
* Améliorez la fiabilité de la correspondance en prétraitant avec `Adjust Colors`, `Contrast Optimization` ou `Blur` pour réduire le bruit et renforcer les caractéristiques.
* Pour vérifier visuellement les résultats, connectez la sortie `Image Any` à `Show Image` afin d’ouvrir l’aperçu dans un visualiseur plus grand.
* Pour mesurer sur plusieurs paires trouvées ou suivre dans le temps, enregistrez les images avec `Image Logger` ou exportez les mesures via `CSV Export` pour une analyse ultérieure.
* Si vous disposez déjà de rectangles détectés par un détecteur d’objets, combinez ce bloc avec des blocs de détection (par exemple `Find Object`) pour localiser plus robustement les modèles avant la mesure.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Aucun objet trouvé : assurez-vous que les images exemples ressemblent bien à l’apparence des objets dans la `Main Image` (échelle, orientation et éclairage similaires). Envisagez d’utiliser `Image Resize` ou `Adjust Colors`.
* Échelle de distance incorrecte : vérifiez la valeur du `Measure Factor`. Pour obtenir une échelle réelle précise, mesurez un objet de référence connu en pixels et déduisez le facteur.
* Correspondances multiples ou incorrectes : recadrez la zone de recherche avec `Image ROI Select` ou augmentez le contraste avec `Contrast Optimization` pour réduire les faux positifs.
* Aperçu qui ne se met pas à jour : assurez-vous qu’une image valide est fournie à `Main Image` et rouvrez l’aperçu (pour une vue plus grande, utilisez `Show Image`).