> 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/roi-processing/check-area.md).

# Check Area

This function block lets you draw a rectangular area on an image and check whether one or more point coordinates fall inside that area. It is ideal for simple region-of-interest checks and quick presence/absence detection inside a selected rectangle.

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

`Image Any` Image de référence utilisée comme canevas de coordonnées sur laquelle vous dessinez la zone rectangulaire.

`Position Coordinate(s)` Un point ou une liste de points à tester par rapport à la zone sélectionnée. Fournissez des coordonnées en pixels (x, y).

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

`Area Rectangle` Le rectangle que vous avez sélectionné, exprimé en coordonnées de pixels de l'image.

`Object In Area` Valeur booléenne indiquant si au moins un des points fournis se trouve à l'intérieur du rectangle sélectionné.

`Detection Count` Nombre de points d'entrée qui ont été trouvés à l'intérieur du rectangle sélectionné.

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

`Image Preview` Cliquez et faites glisser directement sur l'aperçu pour dessiner une zone rectangulaire. L'aperçu affichera la superposition du rectangle en temps réel.

`Drag to Select` Utilisez un geste cliquer-glisser pour définir les coins supérieur-gauche et inférieur-droit du rectangle. Redessiner met à jour immédiatement la zone sélectionnée.

`Overlay Display` Des marqueurs visuels apparaissent sur l'image pour le rectangle sélectionné et pour tous les points qui se trouvent à l'intérieur.

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

* Sélection visuelle et interactive d'une unique région rectangulaire sur l'image d'entrée.
* Prend en charge la vérification d'une coordonnée unique ou d'une liste de coordonnées.
* Marque les points détectés à l'intérieur de la zone avec un marqueur visible sur l'aperçu.
* Fournit en sortie le rectangle sélectionné ainsi que des résultats simples (booléen / compteur) pour une logique en aval facile.

## 📊 Comment ça fonctionne <a href="#evaluation" id="evaluation"></a>

* Fournissez une image valide à l'entrée `Image Any` pour que l'aperçu devienne actif.
* Dessinez le rectangle directement sur l'aperçu en utilisant cliquer-glisser. La région sélectionnée est interprétée en coordonnées pixels de l'image.
* Alimentez des points dans `Position Coordinate(s)` (coordonnée unique ou liste). À l'évaluation, le bloc vérifie chaque point par rapport au rectangle sélectionné et renvoie le rectangle, si des points se trouvent à l'intérieur, et combien. L'aperçu est mis à jour pour afficher le rectangle et les points à l'intérieur.

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

1. Connectez une source d'image à `Image Any` afin que l'aperçu interactif apparaisse.
2. Cliquez et faites glisser sur l'aperçu pour dessiner la zone que vous souhaitez surveiller.
3. Fournissez des coordonnées de points à `Position Coordinate(s)` (par exemple la sortie d'un bloc de détection).
4. Exécutez le scénario ; les résultats apparaissent sous les noms `Area Rectangle`, `Object In Area` et `Detection Count`. L'aperçu affiche des marqueurs pour les points situés à l'intérieur du rectangle.

## 💡 Conseils et astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Pour obtenir des coordonnées de points depuis des détecteurs automatiques, connectez les sorties de blocs tels que `Find Object` ou `Object Detection` (ou `Object Detection - Custom`) à l'entrée `Position Coordinate(s)`.
* Si vous avez besoin de plusieurs zones de découpe ou de formes ROI plus flexibles, envisagez d'utiliser `Image ROI Select` ou `Image ROI Polygon Multi` puis d'alimenter les résultats dans des blocs de filtrage spécialisés.
* Utilisez `Draw Rectangle` ou `Draw Point` pour créer une sortie visuelle combinée pour des rapports ou des présentations après la vérification.
* Pour des filtrages plus avancés (par ex. comparer un rectangle avec de nombreux rectangles détectés), combinez avec `Rectangles in Rectangle` pour affiner les résultats.
* Si les coordonnées proviennent de détecteurs de pose ou de points-clés, essayez d'associer avec `Pose Estimation` ou `Hand Pose Estimation` pour vérifier des points-clés spécifiques du corps ou de la main à l'intérieur de la zone.

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

* Aucun aperçu n'apparaît : assurez-vous qu'une image valide est connectée à `Image Any` et exécutez au moins une fois pour initialiser l'aperçu.
* Les coordonnées ne sont pas détectées comme étant à l'intérieur : vérifiez que les coordonnées sont au format pixels (x, y) correspondant à la résolution de l'image, et non des valeurs normalisées.
* Point unique vs liste : le bloc accepte une coordonnée unique ou une liste — si votre source fournit une structure différente, convertissez-la en un simple (x, y) ou en une liste de paires (x, y) avant de connecter.
