> 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/detections-shapes/detectors/barcode-reader.md).

# Barcode Reader

Ce bloc de fonction lit les codes-barres et QR codes à partir d'une image et renvoie une image annotée ainsi que les informations décodées. Il prend en charge les formats de codes-barres courants et est conçu pour une intégration rapide dans des flux d'inspection ou de journalisation.

## 📥 Entrées

`Barcode Image`\
Image contenant un code-barres ou un QR code à décoder. Peut être en couleur ou en niveaux de gris.

## 📤 Sorties

`Barcode Image`\
Image annotée. Lorsqu'un code est détecté, des marqueurs visuels (cadres/étiquettes) s'affichent sur l'image.

`Barcode Type`\
Type de code détecté (par exemple QR, CODE128, etc.).

`Barcode Data`\
Contenu décodé présent dans le code-barres ou le QR code (texte ou valeur numérique).

## 🕹️ Contrôles

Ce bloc n'a pas de contrôles interactifs. Il s'exécute automatiquement dès qu'une image est fournie.

## 🎨 Fonctionnalités

* Décodage rapide de codes-barres et QR sur une image unique.
* Retour visuel via une image annotée pour confirmer la position de la détection.
* Fournit à la fois les données décodées et le type de code détecté pour un traitement en aval.

## 📝 Instructions d'utilisation

1. Fournissez une image sur l'entrée `Barcode Image` depuis n'importe quel bloc producteur d'image (par exemple une caméra ou un chargeur d'images).
2. Inspectez la sortie `Barcode Image` pour vérifier visuellement la détection.
3. Utilisez les sorties `Barcode Type` et `Barcode Data` pour déclencher des logiques, de la journalisation ou du stockage.

## 📊 Évaluation

Lorsque le bloc reçoit une image, il analyse la trame à la recherche de motifs de codes-barres. Si un code est trouvé, le bloc renvoie une image annotée, le type de code détecté et les données décodées. Si rien n'est trouvé, l'image annotée est renvoyée inchangée et les sorties de données indiqueront l'absence de détection.

## 💡 Astuces

* Combinez avec `Image ROI Select` pour recadrer la zone autour d'une étiquette ou d'un colis avant de la passer au bloc. Le recadrage réduit les détections erronées et accélère le traitement.
* Si le code est petit ou de faible contraste, essayez `Image Resize` pour agrandir la zone d'intérêt avant le décodage.
* Utilisez `Blur` avec parcimonie pour réduire le bruit sur des images granuleuses ; dans certains cas un léger flou améliore la détection.
* Sur des fonds complexes, appliquez `Image Threshold` pour augmenter le contraste entre le code et l'arrière-plan.
* Prévisualisez les résultats avec `Show Image` pour confirmer la détection et les éléments visuels dans l'interface.
* Pour la journalisation automatisée des valeurs décodées, envoyez `Barcode Data` vers `CSV Export` ou enregistrez des images avec `Image Logger` pour des traces d'audit.
* Pour des workflows par lots ou basés sur des fichiers, chargez les images avec `Load Image From Path` et traitez-les via ce bloc.

## 🛠️ Dépannage

* Aucun code détecté
  * Assurez-vous que la zone du code-barres est bien visible et pas trop floue, masquée ou trop petite.
  * Essayez de recadrer la zone avec `Image ROI Select` et d'augmenter la taille avec `Image Resize`.
  * Améliorez le contraste avec `Image Threshold` ou ajustez l'éclairage au moment de la capture.
* Données incorrectes ou corrompues
  * Vérifiez la qualité de l'image et l'alignement du code. La rotation ou la distorsion en perspective peut nuire au décodage — recadrez et alignez la zone d'abord.
  * Si plusieurs codes se chevauchent, isolez-les avec `Image ROI Select` ou des filtres de prétraitement.
* Trop de faux positifs
  * Restreignez la zone d'entrée via `Image ROI Select` ou ajoutez des filtrages simples (seuillage, filtres de couleur) avant le décodage.

Si vous avez besoin d'inspecter visuellement les trames lors de la configuration, connectez la sortie à `Show Image` pour confirmer l'annotation des codes détectés.