> 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/operations/image-autorotator.md).

# Image AutoRotator

Este bloque de función orienta automáticamente una imagen para que su contenido principal aparezca en posición vertical. Es útil cuando las imágenes pueden estar rotadas al capturarlas y deseas una orientación consistente antes de procesarlas más.

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

`Image Any` La entrada acepta cualquier imagen que quieras auto-rotar.

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

`Image Any` La salida es la imagen rotada, ajustada a una orientación más vertical.

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

Este bloque no tiene controles visibles para el usuario. Se ejecuta automáticamente cuando se le proporciona una imagen.

## 🎨 Funcionalidades <a href="#features" id="features"></a>

* Corrección automática de orientación para imágenes con un eje dominante u objeto alargado.
* Operación transparente — no se requiere afinado manual en casos de uso típico.
* Procesado rápido en un solo paso, adecuado para transmisiones en vivo o lotes de imágenes.

## ⚙️ Mecanismo de funcionamiento <a href="#running-mechanism" id="running-mechanism"></a>

Cuando se suministra una imagen al bloque, analiza la imagen para determinar la orientación principal y devuelve una versión rotada para alinear ese eje principal verticalmente. Esto ocurre cada vez que se evalúa el bloque, por lo que recibirás una imagen orientada actualizada siempre que cambie la entrada.

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

1. Conecta un bloque productor de imagen a la entrada `Image Any`.
2. El bloque emitirá la imagen rotada en la salida `Image Any`.
3. Usa la imagen rotada con bloques posteriores para mediciones o visualización más fiables.

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

* Previsualiza rápidamente conectando la salida a `Show Image` para confirmar la orientación correcta.
* Si las imágenes son grandes y lentas de procesar, combínalo con `Image Resizer` antes de este bloque para acelerar la evaluación.
* Cuando esperes que solo una pequeña región determine la orientación, recorta primero con `Image ROI Select` y ejecuta este bloque sobre el ROI para obtener resultados más robustos.
* Usa `Blur` o `Image Threshold` antes de la auto-rotación si el ruido o el desorden de fondo confunden la detección de orientación — el preprocesado puede mejorar la estabilidad.
* Si necesitas una rotación manual fija después de la auto-orientación, encadena con `Rotate Image Angle` para aplicar un ajuste personalizado.

(pista: combina este bloque con otros de análisis y detección como `Find Object` o `Histogram On Line` para asegurar que el procesamiento posterior use imágenes con orientación consistente.)

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

* Si la salida parece sin cambios o aún inclinada, intenta preprocesar la entrada con `Blur` o `Image Threshold` para reducir el ruido de fondo.
* Si el sujeto ocupa solo una pequeña porción de la imagen, recorta con `Image ROI Select` para que el bloque analice el área relevante.
* Para imágenes muy grandes que tardan en procesarse, redimensiónalas con `Image Resizer` para equilibrar velocidad y precisión.
