> 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/draw/draw-line.md).

# Draw Line

Ce bloc de fonction vous permet de tracer des lignes directement sur une image de façon interactive en utilisant la souris et des raccourcis clavier simples. Utilisez-le pour dessiner une ou plusieurs lignes connectées, extraire les coordonnées et obtenir l'angle de chaque segment.

## 📥 Entrées

`Image Any`\
L'image sur laquelle les lignes seront tracées. Connectez ici n'importe quel bloc produisant une image.

`Calculate All Points`\
Quand vrai, le bloc renvoie chaque coordonnée de pixel le long de chaque segment dessiné au lieu de ne renvoyer que les points d'extrémité.

## 📤 Sorties

`Image Any`\
L'image annotée montrant les lignes tracées ou les points calculés.

`Line Coordinates`\
Une liste de shapes représentant chaque segment de ligne tracé.

`Angles`\
Les valeurs de rotation ou d'angle pour chaque segment de ligne.

## 🕹️ Contrôles

`Image Area`\
Cliquez avec le bouton gauche de la souris sur la zone d'image pour ajouter des points et construire des lignes.

`Press U`\
Annule le dernier point ou segment ajouté.

`Press C`\
Efface tous les points et lignes tracés.

(astuce) La zone d'image affiche un retour visuel en temps réel au fur et à mesure que vous ajoutez, annulez ou effacez des marques.

## 🎨 Fonctionnalités

* Dessin interactif directement sur l'image avec retour visuel immédiat.
* Raccourcis clavier pour un édition rapide : annuler (`Press U`) et effacer (`Press C`).
* Option pour renvoyer des listes denses de coordonnées le long de chaque ligne lorsque `Calculate All Points` est activé.
* Estimation d'angle par segment, utile pour les tâches d'orientation ou d'alignement.

## 📝 Instructions d'utilisation

1. Connectez un bloc produisant une image à l'entrée `Image Any` (par exemple, une caméra ou un chargeur d'images).
2. Cliquez sur la zone d'image pour placer des points. Les clics consécutifs forment des segments de ligne.
3. Pour obtenir chaque coordonnée de pixel le long des segments, fournissez la valeur TRUE à l'entrée `Calculate All Points`.
4. Utilisez `Press U` pour annuler le dernier point ou `Press C` pour effacer toutes les marques.
5. Consultez les sorties pour obtenir l'image annotée, la liste `Line Coordinates` et les `Angles`.

## 📊 Évaluation

Lors de l'exécution, ce bloc met à jour l'aperçu interactif de l'image avec les lignes tracées et calcule les sorties en fonction des points actuels. Si `Calculate All Points` est activé, le bloc développe chaque segment en ses coordonnées de pixels constituantes avant de renvoyer les résultats.

## 💡 Astuces et conseils

* Pour une entrée caméra en direct, connectez `Camera USB` ou `Stream Reader` à l'entrée `Image Any` pour dessiner directement sur des images en flux.
* Pour inspecter visuellement les résultats dans une fenêtre plus grande, associez ce bloc à `Show Image` après les sorties.
* Si vous devez restreindre le dessin à une zone spécifique, recadrez d'abord avec `Image ROI Select` ou `Image ROI`, puis alimentez l'image recadrée dans ce bloc.
* Pour une analyse fine le long d'une ligne tracée, activez `Calculate All Points` et utilisez `Measure Position Distance` ou `Histogram On Line` sur les coordonnées ou l'image résultante.
* Réduisez le bruit avant de dessiner en prétraitant l'entrée avec `Blur` ou `Denoising` si les contours sont bruyants.
* Pour travailler avec des images très grandes, utilisez `Image Resizer` pour réduire la résolution et améliorer la réactivité, puis remappez les coordonnées si nécessaire.

## 🛠️ Dépannage

* Aucune réponse au dessin : assurez-vous qu'une image valide est connectée à l'entrée `Image Any` et que le scénario est en cours d'exécution.
* Points mal alignés : zoomez ou redimensionnez la source d'image de manière cohérente entre l'aperçu et l'utilisation en aval, ou recadrez avec `Image ROI Select` avant de dessiner.
* Trop de coordonnées renvoyées : désactivez `Calculate All Points` si vous n'avez besoin que des points d'extrémité, ou redimensionnez l'image pour réduire la densité de points.