# Get Dimension

This function block returns the dimensions of an input image as a list. It is useful when you need to know image width, height and channel information before applying other image operations.

## 📥 Inputs <a href="#inputs" id="inputs"></a>

`Image Any` This input accepts any image data from other function blocks.

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

`Dimensions` Returns the image dimensions (for example: height, width, channels) as a list of numbers.

## 🕹️ Controls <a href="#controls" id="controls"></a>

This function block has no controls.

## 🎯 Features <a href="#features" id="features"></a>

* Quick retrieval of image shape information to guide downstream processing.
* Works with color and grayscale images; output reflects the image shape format provided.

## 📝 Usage Instructions <a href="#usage" id="usage"></a>

1. Connect an image-producing block (camera, loader or processing block) to the `Image Any` input.
2. Read the `Dimensions` output to get the image shape information.
3. Use the dimension values to configure other blocks or to validate image sizes in your scenario.

## 📊 Evaluation <a href="#evaluation" id="evaluation"></a>

When evaluated, this block inspects the connected image and outputs a numeric list describing its dimensions (e.g., height, width, channels). If no image is provided, no dimension list will be produced.

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

* Use `Load Image` or camera input blocks such as `Camera USB` and `Camera IP (ONVIF)` as image sources to quickly check incoming image sizes.
* If you need to preview the image before checking dimensions, attach a `Show Image` block to the same image source.
* To measure a cropped region, connect a cropping block like `Image ROI` or `Image ROI Select` before this block — the `Dimensions` output will then reflect the cropped area.
* When working with very large images, consider feeding a resized version using `Image Resize` or `Image Resizer` before asking for dimensions to speed up downstream processing.
* Use `Image Resolution and Channel Value` if you also want separate width/height/channel outputs or more detailed channel information.

## 🛠️ Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

* No output or empty result: ensure an image source is connected to the `Image Any` input.
* Unexpected number of elements in the result: some images are grayscale (height, width) while color images include a channel count (height, width, channels). Use `Split Image` or `Image Resolution and Channel Value` if you need per-channel information.
* If the input may occasionally be missing, use blocks like `Is None` or `Replace None` upstream to provide fallback data and avoid interruptions.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/function-blocks/image-transformations/analysis/get-dimension.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
