> 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/transformation-filters/auto-alignment.md).

# Auto Alignment

Ce bloc de fonction aligne une image d'entrée sur une `Reference Image` fournie afin que les objets des deux images correspondent en position et en échelle. Utilisez-le lorsque vous avez besoin que l'image d'entrée ait le même cadrage ou enregistrement que la référence pour comparaison, mesure ou traitement ultérieur.

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

* `Input Image`\
  L'image qui sera transformée pour correspondre à la référence.
* `Reference Image`\
  L'image cible qui définit l'alignement souhaité (position, échelle et perspective) pour l'entrée.

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

* `Aligned Image`\
  L'image résultante après alignement. Si l'alignement ne peut pas être effectué, cette sortie restera vide ou inchangée et un message d'erreur sera signalé.

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

* `No Controls`\
  Ce bloc n'a pas de widgets supplémentaires. L'alignement est entièrement déterminé par les entrées fournies.

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

* Alignement simple et dédié : fournissez deux images et obtenez un résultat aligné sans configuration supplémentaire.
* Rapport d'échec automatique : le bloc affiche des messages clairs lorsque l'alignement échoue (par exemple si la référence ne peut pas être appariée).
* Léger et facile à intégrer dans toute chaîne de traitement d'image nécessitant une registration.

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

* Lorsque `Input Image` et `Reference Image` sont fournies, le bloc tente d'apparier l'entrée à la référence et produit `Aligned Image`.
* Si l'alignement réussit, la sortie contient l'image transformée correspondant au cadrage de la référence.
* Si l'alignement ne peut pas être établi, le bloc signale une erreur et ne produit pas d'`Aligned Image` valide.

## 📝 Instructions d'utilisation <a href="#usage" id="usage"></a>

1. Fournissez une `Reference Image` claire et bien éclairée contenant la même scène ou le même objet que vous attendez dans `Input Image`.
2. Connectez l'image à aligner à `Input Image`.
3. Exécutez le scénario. Le bloc renverra `Aligned Image` en cas de succès.
4. Si l'alignement échoue, ajustez les entrées (voir Dépannage) puis réessayez.

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

* Si vos images contiennent du désordre en arrière-plan ou des zones non pertinentes, recadrez-les d'abord avec `Image ROI Select` ou `Image ROI` pour concentrer l'alignement sur la zone d'intérêt.
* Si les tailles d'image diffèrent fortement, utilisez `Image Resizer` ou `Image Resize` pour rapprocher les dimensions avant l'alignement.
* Pour les images peu détaillées ou bruyantes, améliorez le contraste avec `Contrast Optimization` ou `Auto Contrast` et réduisez le bruit avec `Denoising` pour renforcer la fiabilité de l'alignement.
* Visualisez les résultats avec `Show Image` pour confirmer l'alignement de manière interactive. Utilisez `Image Logger` ou `Image Write` pour sauvegarder les sorties alignées.
* Lorsque l'alignement fait partie d'un pipeline (p. ex. mesures ou détections), exécutez l'alignement avant des détecteurs tels que `Find Object` ou `Template Match` pour garantir des coordonnées cohérentes.
* Pour mesurer entre plusieurs régions, pensez à recadrer les résultats alignés avec `Get ROI` puis utilisez des blocs de mesure ou d'analyse.

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

* Alignement échoue ou produit un résultat déformé :
  * Vérifiez que les deux images contiennent les mêmes caractéristiques visibles et un recouvrement suffisant.
  * Améliorez le contraste avec `Contrast Optimization` ou réduisez le bruit avec `Denoising`.
  * Recadrez pour supprimer les arrière-plans distrayants avec `Image ROI Select` puis réessayez.
* Aucune sortie produite :
  * Confirmez que `Input Image` et `Reference Image` sont bien connectées et que leurs types sont valides.
  * Consultez les messages d'erreur dans l'interface du bloc et utilisez `Show Image` pour visualiser les entrées avant l'alignement.

Utilisez ces recommandations pour intégrer efficacement ce bloc avec d'autres blocs de fonction dans votre flux de travail et obtenir un enregistrement d'image robuste et reproductible.