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

# OCR (EasyOCR)

Un bloc de fonction qui détecte le texte dans les images en utilisant le moteur EasyOCR. Il peut renvoyer le texte reconnu, des segments de texte individuels, des boîtes de délimitation et une image annotée optionnelle. Inclut des tentatives automatiques de rotation pour gérer le texte tourné.

## 📥 Entrées

`Image`\
Image en niveaux de gris ou en couleur contenant le texte à reconnaître.

## 📤 Sorties

`Result`\
Image annotée avec les boîtes de texte détectées et, en option, les étiquettes de texte.

`Whole Text`\
Tout le texte reconnu concaténé en une seule chaîne.

`Texts`\
Liste des segments de texte reconnus.

`Boxes`\
Liste de boîtes polygonales pour chaque texte détecté (4 points par boîte).

## 🕹️ Contrôles

`Use auto rotation`\
Activer les tentatives de rotation de l’image (90°, -90°, 180°) pour améliorer la détection du texte orienté.

`Show Texts`\
Activer/désactiver l’affichage des étiquettes de texte reconnues sur l’image annotée `Result`.

`Threshold`\
Curseur de confiance pour filtrer les détections de texte à faible confiance (0–100 %).

## 🎯 Fonctionnalités

* Détection multi-angle : effectue des rotations simples pour gérer le texte tourné lorsque `Use auto rotation` est activé.
* Filtrage par confiance : élimine les détections faibles en ajustant le `Threshold`.
* Sortie visuelle : renvoie une image annotée `Result` avec boîtes et étiquettes de texte optionnelles lorsqu’il y a des détections.
* Résultats détaillés : retourne à la fois le `Whole Text` agrégé, les `Texts` individuels et les `Boxes` pour traitement ultérieur.

## 📝 Utilisation

1. Connectez un bloc producteur d’images à la prise `Image`.
2. Activez éventuellement `Use auto rotation` si les images sources peuvent être tournées.
3. Ajustez le `Threshold` pour équilibrer sensibilité et faux positifs.
4. Activez `Show Texts` si vous souhaitez que les étiquettes de texte soient dessinées sur l’image `Result`.
5. Utilisez les sorties pour enregistrer, consigner ou traiter davantage le texte reconnu et les coordonnées des boîtes.

## 📊 Évaluation

À l’exécution, le bloc analyse l’image d’entrée (et ses variantes tournées si activées), filtre les détections selon le `Threshold` et renvoie l’image annotée (le cas échéant), le texte complet concaténé, la liste des segments de texte et la liste des boîtes polygonales.

## 💡 Conseils et astuces

* Prétraitez les images de faible qualité avec `Image Resizer` ou `Super Resolution` pour améliorer la reconnaissance sur du texte petit ou flou.
* Recadrez d’abord la zone de texte avec `Image ROI Select` ou `Image ROI` afin que le bloc se concentre sur les régions pertinentes.
* Réduisez le bruit d’arrière-plan avec `Background Removal (RMBG-1.4)` ou `Background Removal (BiRefNet)` avant l’OCR lorsque le texte se trouve sur des fonds complexes.
* Améliorez le contraste et la lisibilité en utilisant `Auto Contrast`, `Adjust Colors`, `Denoising` ou `Image Threshold` selon l’entrée.
* Pour une inspection en direct, envoyez le `Result` vers `Show Image` pour prévisualiser les détections annotées.
* Sauvegardez les images de détection ou les logs avec `Image Logger`, `Image Write`, ou exportez le texte reconnu via `Data to JSON` ou `CSV Export`.
* Si vous souhaitez un comportement OCR alternatif, comparez les résultats avec le bloc générique `OCR` ou combinez avec `Draw Detections` pour superposer des visuels personnalisés.

## 🛠️ Dépannage

* Aucun texte détecté : baissez le `Threshold` et vérifiez que l’image d’entrée n’est pas trop petite — essayez `Image Resizer` ou `Super Resolution`.
* Faux positifs ou texte brouillé : augmentez le `Threshold` et appliquez `Denoising` ou `Auto Contrast` pour stabiliser l’entrée.
* Texte tourné non trouvé : activez `Use auto rotation` pour tenter des rotations courantes, ou réalignez préalablement avec `Auto Alignment` si vous disposez d’une référence.
* Trop de petites détections : recadrez la région d’intérêt avec `Image ROI Select` et filtrez les résultats par taille de boîte dans des blocs en aval.