> 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/ai-blocks/ocr-easyocr.md).

# OCR (EasyOCR)

Un bloque de función que detecta texto en imágenes usando el motor EasyOCR. Puede devolver texto reconocido, segmentos de texto individuales, bounding boxes y una imagen anotada opcional. Incluye intentos de rotación automática para manejar texto rotado.

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

`Image` Imagen en escala de grises o color que contiene el texto a reconocer.

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

`Result` Imagen anotada con los cuadros de texto detectados y etiquetas de texto opcionales.

`Whole Text` Todo el texto reconocido concatenado en una sola cadena.

`Texts` Lista de segmentos de texto reconocidos.

`Boxes` Lista de polígonos (4 puntos por caja) para cada texto detectado.

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

`Use auto rotation` Habilita intentos de rotación de la imagen (90°, -90°, 180°) para mejorar la detección en textos rotados.

`Show Texts` Alternar la visualización de las etiquetas de texto reconocidas en la imagen anotada `Result`.

`Threshold` Deslizador de umbral de confianza para filtrar detecciones de texto de baja confianza (0–100%).

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

* Detección multi-ángulo: intenta rotaciones sencillas para manejar texto rotado cuando `Use auto rotation` está habilitado.
* Filtrado por confianza: elimina detecciones débiles ajustando el `Threshold`.
* Salida visual: devuelve una imagen anotada en `Result` con cuadros y etiquetas de texto opcionales cuando se producen detecciones.
* Devuelve tanto el `Whole Text` agregado como los `Texts` y `Boxes` individuales para su procesamiento posterior.

## 📝 Uso <a href="#usage" id="usage"></a>

1. Conecta un bloque que produzca imagen al socket `Image`.
2. Opcionalmente habilita `Use auto rotation` si las imágenes de origen pueden estar rotadas.
3. Ajusta el `Threshold` para equilibrar sensibilidad frente a detecciones falsas.
4. Habilita `Show Texts` si deseas que las etiquetas de texto se dibujen en la imagen `Result`.
5. Usa las salidas para guardar, registrar o procesar más el texto reconocido y las coordenadas de las cajas.

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

Al ejecutarse, el bloque analiza la imagen de entrada (y las variantes rotadas si están habilitadas), filtra las detecciones según el `Threshold` y devuelve la imagen anotada (si hay), el texto completo concatenado, una lista de segmentos de texto y la lista de cajas poligonales.

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

* Preprocesa imágenes de baja calidad con `Image Resizer` o `Super Resolution` para mejorar el reconocimiento de texto pequeño o borroso.
* Recorta primero al área de texto usando `Image ROI Select` o `Image ROI` para que el bloque se concentre en las regiones relevantes.
* Reduce el ruido de fondo con `Background Removal (RMBG-1.4)` o `Background Removal (BiRefNet)` antes del OCR cuando el texto esté sobre fondos complejos.
* Mejora el contraste y la legibilidad usando `Auto Contrast`, `Adjust Colors`, `Denoising` o `Image Threshold` según la entrada.
* Para inspección en vivo, enruta el `Result` a `Show Image` para previsualizar las detecciones anotadas.
* Guarda imágenes de detección o registros con `Image Logger`, `Image Write`, o exporta el texto reconocido usando `Data to JSON` o `CSV Export`.
* Si necesitas un comportamiento OCR alternativo, compara resultados con el bloque genérico `OCR` o combínalo con `Draw Detections` para superponer visuales personalizados.

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

* No se detecta texto: baja el `Threshold` y asegúrate de que la imagen de entrada no sea demasiado pequeña — prueba `Image Resizer` o `Super Resolution`.
* Falsos positivos o texto garabateado: sube el `Threshold` y aplica `Denoising` o `Auto Contrast` para estabilizar las entradas.
* Texto rotado no encontrado: habilita `Use auto rotation` para intentar rotaciones comunes, o alinea previamente usando `Auto Alignment` si tienes una referencia.
* Demasiadas detecciones pequeñas: recorta a la región de interés con `Image ROI Select` y filtra resultados por tamaño de bounding box en bloques posteriores.