> 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/analysis/get-dimension.md).

# Get Dimension

Ce bloc de fonction renvoie les dimensions d'une image d'entrée sous forme de liste. Il est utile lorsque vous avez besoin de connaître la largeur, la hauteur et le nombre de canaux d'une image avant d'appliquer d'autres opérations d'image.

## 📥 Entrées

`Image Any`\
Accepte n'importe quelle donnée d'image provenant d'autres blocs de fonction.

## 📤 Sorties

`Dimensions`\
Renvoie les dimensions de l'image (par exemple : height, width, channels) sous forme d'une liste de nombres.

## 🕹️ Contrôles

Ce bloc n'a pas de contrôles.

## 🎯 Fonctionnalités

* Récupération rapide des informations de forme de l'image pour orienter le traitement en aval.
* Fonctionne avec des images couleur et niveaux de gris ; la sortie reflète le format fourni (par ex. hauteur/largeur/ canaux).

## 📝 Instructions d'utilisation

1. Connectez un bloc producteur d'images (caméra, loader ou un bloc de traitement) à l'entrée `Image Any`.
2. Lisez la sortie `Dimensions` pour obtenir les informations sur la forme de l'image.
3. Utilisez ces valeurs de dimensions pour configurer d'autres blocs ou pour valider les tailles d'image dans votre scénario.

## 📊 Évaluation

À l'exécution, ce bloc inspecte l'image connectée et produit une liste numérique décrivant ses dimensions (par ex. height, width, channels). Si aucune image n'est fournie, aucune liste de dimensions ne sera produite.

## 💡 Astuces

* Utilisez `Load Image` ou des blocs d'entrée caméra comme `Camera USB` et `Camera IP (ONVIF)` pour vérifier rapidement la taille des images entrantes.
* Si vous souhaitez prévisualiser l'image avant de vérifier ses dimensions, attachez un bloc `Show Image` à la même source d'image.
* Pour mesurer une zone recadrée, connectez un bloc de recadrage tel que `Image ROI` ou `Image ROI Select` avant ce bloc — la sortie `Dimensions` reflétera alors la zone recadrée.
* Pour de très grandes images, pensez à alimenter une version redimensionnée via `Image Resize` ou `Image Resizer` avant de demander les dimensions afin d'accélérer le traitement en aval.
* Utilisez `Image Resolution and Channel Value` si vous souhaitez des sorties séparées pour width/height/channel ou des informations de canal plus détaillées.

## 🛠️ Dépannage

* Aucune sortie ou résultat vide : assurez-vous qu'une source d'image est connectée à l'entrée `Image Any`.
* Nombre inattendu d'éléments dans le résultat : certaines images sont en niveaux de gris (height, width) tandis que les images couleur incluent le compte de canaux (height, width, channels). Utilisez `Split Image` ou `Image Resolution and Channel Value` si vous avez besoin d'informations par canal.
* Si l'entrée peut parfois manquer, utilisez en amont des blocs comme `Is None` ou `Replace None` pour fournir des données de secours et éviter les interruptions.