# Minimum Rotated Rectangle

Esta función calcula el rectángulo rotado de área mínima que encierra una forma (contorno) dada en una imagen. Es útil para medir el tamaño orientado y la orientación de un objeto, y para visualizar una caja delimitadora que no esté alineada con los ejes.

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

* `Image`\
  La imagen de referencia utilizada para visualización.
* `Contour`\
  La forma/contorno que se usará para calcular el rectángulo rotado mínimo.

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

* `Image`\
  La imagen de origen anotada con el rectángulo rotado calculado y el contorno.
* `Center`\
  Punto central del rectángulo rotado calculado.
* `Width`\
  Anchura del rectángulo rotado.
* `Height`\
  Altura del rectángulo rotado.
* `Angle`\
  Ángulo de rotación del rectángulo (orientación).
* `Contour`\
  La representación del contorno del rectángulo rotado (como salida de forma).
* `Rectangle Image`\
  Visualización separada que muestra la región del rectángulo recortada/rectificada.

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

Esta función no tiene controles editables por el usuario. Se ejecuta automáticamente cuando ambas entradas están conectadas.

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

* Calcula un rectángulo de área mínima que puede estar rotado respecto a los ejes de la imagen.
* Proporciona medidas geométricas: centro, anchura, altura y ángulo.
* Visualiza los resultados directamente sobre la imagen de origen y como una imagen de rectángulo separada.
* Devuelve el rectángulo como un contorno/forma para poder reenviarlo a otros bloques y procesarlo más.

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

Cuando se proporcionan una imagen y un contorno, el bloque analiza la forma del contorno para determinar el rectángulo de área mínima que lo encierra. A continuación genera medidas numéricas de tamaño y orientación, dibuja el rectángulo sobre la imagen para feedback visual inmediato y también ofrece el rectángulo como salida en forma y como imagen separada. Si no se proporciona un contorno válido, el bloque no producirá resultados geométricos (emitirá salidas vacías o por defecto).

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

1. Proporcione una entrada de contorno que represente el objeto de interés (vea Consejos y Trucos para cómo obtener contornos).
2. Envíe la misma imagen de referencia (o una copia) a la entrada `Image` si desea la visualización anotada.
3. Lea los valores de `Center`, `Width`, `Height` y `Angle` para mediciones o lógica de decisión.
4. Use la salida `Rectangle Image` cuando necesite una vista recortada o rectificada del objeto detectado.

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

* Para obtener contornos a partir de imágenes crudas, combínelo con `Find Contour` o `Feature Detector` para extraer los contornos antes de enviar al bloque.
* Si los contornos son ruidosos o tienen muchos puntos, use `Approximate Contour` para simplificarlos y mejorar la estabilidad de las medidas.
* Para formas que se ajustan mejor con una envolvente convexa, pruebe primero con `Hull Convex` y use el hull como entrada.
* Compare geometrías envolventes distintas emparejando este bloque con `Minimum Circle`, `Minimum Ellipse` o `Minimum Rectangle` para elegir la mejor opción.
* Use `Image ROI Select` o `Image ROI` para recortar la región antes de extraer contornos cuando solo le interese una subregión.
* Visualice o exporte resultados con `Draw Rectangle` o `Draw Result On Image` para superposiciones claras en informes o UI.

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

* No se producen medidas: asegúrese de que un contorno válido está conectado a la entrada `Contour` y que el contorno no esté vacío.
* Orientación o tamaño inesperados: pruebe a simplificar el contorno con `Approximate Contour` o verifique que el contorno corresponde al objeto deseado (use `Contour to Image` para inspeccionar).
* El rectángulo no cubre correctamente el objeto: compruebe la extracción de contorno por huecos o fragmentos desconectados; considere usar `Hull Convex` para crear una envolvente antes de medir.
