> 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-point.md).

# Draw Point

Ce bloc fonction dessine un ou plusieurs points repères sur une image d'entrée aux coordonnées que vous fournissez. Il est utile pour visualiser des positions détectées, des annotations ou des résultats de mesure.

## 📥 Entrées

* `Image Any` — L'image source sur laquelle les points seront dessinés (RGB/BGR ou niveaux de gris).
* `Points` — Une coordonnée ou une liste de coordonnées à dessiner. Les coordonnées sont au format (x, y) ou (col, row) et peuvent être un seul tuple ou une liste de tuples.

## 📤 Sorties

* `Image Any` — L'image annotée avec les points dessinés en superposition.

## 🕹️ Contrôles

Ce bloc n'a pas de contrôles d'interface supplémentaires. Il utilise les entrées connectées pour déterminer où et comment les points sont dessinés.

## 🎨 Caractéristiques

* Repères visuels : Dessine des marqueurs en cercle rempli avec un contour bicolore pour rendre les points visibles sur différents arrière-plans.
* Taille de marqueur auto-adaptée : La taille du marqueur s'adapte à la résolution de l'image afin que les points restent visibles sur les images petites et grandes.
* Accepte un ou plusieurs points : Fonctionne avec une seule coordonnée ou une liste de coordonnées pour des annotations en lot.
* Non destructif : Produit une copie de l'image d'entrée avec les superpositions, préservant l'image originale en amont.

## 📊 Mécanisme d'exécution

Lorsque le bloc est actif, il lit l'image fournie et l'entrée de coordonnées, place des marqueurs visibles sur l'image à chaque coordonnée, puis renvoie l'image annotée pour les blocs en aval ou l'affichage.

## 📝 Instructions d'utilisation

1. Connectez un bloc producteur d'image à l'entrée `Image Any`.
2. Fournissez une coordonnée unique ou une liste de coordonnées à l'entrée `Points`.
3. Utilisez la sortie `Image Any` résultante pour prévisualiser (par exemple avec le bloc `Show Image`) ou pour passer l'image annotée à des blocs d'export ou de traitement ultérieur.

## 💡 Astuces et conseils

* Pour obtenir des coordonnées depuis un clic utilisateur, associez ce bloc à `Get Pixel Mouse` afin de dessiner les positions cliquées sur l'image.
* Pour visualiser les centres d'objets détectés, alimentez `Points` avec les coordonnées provenant de `Object Detection`, `Object Detection - Custom` ou `Object_Detection_Tracker`.
* Pour des points basés sur des contours, utilisez `Find Contour` ou `Approximate Contour` pour extraire des points puis dessinez-les avec ce bloc.
* Recadrez d'abord sur une région d'intérêt à l'aide de `Image ROI Select` ou `Image ROI` afin de ne dessiner que dans une zone spécifique.
* Combinez avec `Draw Detections` si vous souhaitez à la fois des boîtes englobantes et des marqueurs de points sur la même image.
* Si vous devez sauvegarder des images annotées, connectez la sortie à `Image Logger` ou `Image Write`.
* Utilisez `Slice Image` ou `Image Resize` en amont si la taille ou la densité des marqueurs doit être ajustée pour la présentation ou l'export.

## 🛠️ Dépannage

* Si les marqueurs n'apparaissent pas, vérifiez que l'entrée `Points` contient des coordonnées valides à l'intérieur des limites de l'image (0 ≤ x < largeur, 0 ≤ y < hauteur).
* Si un seul marqueur apparaît alors que vous en attendez plusieurs, assurez-vous que l'entrée `Points` est une liste de tuples de coordonnées plutôt qu'un seul tuple.
* Si les marqueurs sont trop petits ou trop grands pour l'image, redimensionnez l'image avec `Image Resize` ou recadrez avec `Image ROI` avant de dessiner.