> 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/spanish/function-blocks/blocks-reference/image-transformations/analysis/get-dimension.md).

# Get Dimension

Este bloque de función devuelve las dimensiones de una imagen de entrada como una lista. Es útil cuando necesitas conocer el ancho, la altura y la información de canales de la imagen antes de aplicar otras operaciones de imagen.

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

`Image Any` Esta entrada acepta cualquier dato de imagen proveniente de otros bloques de función.

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

`Dimensions` Devuelve las dimensiones de la imagen (por ejemplo: height, width, channels) como una lista de números.

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

Este bloque de función no tiene controles.

## 🎯 Características <a href="#features" id="features"></a>

* Recuperación rápida de la información de forma de la imagen para guiar el procesamiento posterior.
* Funciona con imágenes en color y en escala de grises; la salida refleja el formato de la imagen proporcionada.

## 📝 Instrucciones de uso <a href="#usage" id="usage"></a>

1. Conecta un bloque que produzca imagen (cámara, loader o bloque de procesamiento) a la entrada `Image Any`.
2. Lee la salida `Dimensions` para obtener la información de forma de la imagen.
3. Usa los valores de las dimensiones para configurar otros bloques o validar tamaños de imagen en tu escenario.

## 📊 Evaluación <a href="#evaluation" id="evaluation"></a>

Al ejecutarse, este bloque inspecciona la imagen conectada y emite una lista numérica que describe sus dimensiones (por ejemplo, height, width, channels). Si no se proporciona ninguna imagen, no se producirá ninguna lista de dimensiones.

## 💡 Consejos y trucos <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Usa `Load Image` o bloques de entrada de cámara como `Camera USB` y `Camera IP (ONVIF)` como fuentes de imagen para comprobar rápidamente los tamaños entrantes.
* Si quieres previsualizar la imagen antes de comprobar las dimensiones, conecta un bloque `Show Image` a la misma fuente de imagen.
* Para medir una región recortada, conecta un bloque de recorte como `Image ROI` o `Image ROI Select` antes de este bloque: la salida `Dimensions` reflejará entonces el área recortada.
* Cuando trabajes con imágenes muy grandes, considera alimentar una versión redimensionada usando `Image Resize` o `Image Resizer` antes de pedir dimensiones para acelerar el procesamiento posterior.
* Usa `Image Resolution and Channel Value` si además quieres salidas separadas de width/height/channels o información de canales más detallada.

## 🛠️ Solución de problemas <a href="#troubleshooting" id="troubleshooting"></a>

* Sin salida o resultado vacío: asegúrate de que una fuente de imagen esté conectada a la entrada `Image Any`.
* Número inesperado de elementos en el resultado: algunas imágenes son en escala de grises (height, width) mientras que las imágenes en color incluyen el conteo de canales (height, width, channels). Usa `Split Image` o `Image Resolution and Channel Value` si necesitas información por canal.
* Si la entrada puede faltar ocasionalmente, usa bloques como `Is None` o `Replace None` aguas arriba para proporcionar datos alternativos y evitar interrupciones.
