For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

📤 Salidas

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

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

  • 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

  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

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

  • 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

  • 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.

Última actualización