Comment lire les BarCodes et les QR Codes en C# ; avec IronOCR
IronOCR lit les codes-barres et QR codes en C# en configurant ReadBarCodes = true. Ce paramètre unique permet l'extraction automatique des valeurs de codes-barres à partir de PDF et d'images, parallèlement à la reconnaissance de texte ordinaire, prenant en charge plus de 20 formats de codes-barres, notamment les codes QR, le Code 128 et Data Matrix.
Activez la détection des codes-barres à l'aide d'un seul paramètre et numérisez des PDF avec IronOcr. Le code ci-dessous montre comment activer la lecture des codes-barres, traiter un PDF et récupérer les valeurs décodées.
-
1Install IronOCR with NuGet Package Manager
-
2Copiez et exécutez cet extrait de code.
var result = new IronOcr.IronTesseract() { Configuration = new IronOcr.TesseractConfiguration { ReadBarCodes = true } }.Read(new IronOcr.OcrPdfInput("document.pdf")); foreach(var bc in result.Barcodes) Console.WriteLine(bc.Value);C# -
3Déployez pour tester sur votre environnement de production.
Commencez à utiliser IronOCR dans votre projet dès aujourd'hui avec un essai gratuit
Comment lire les BarCodes et les QR Codes en C# avec IronOCR
- Téléchargez une bibliothèque C# pour lire les codes-barres et les codes QR.
- Importez l'image cible et le document PDF.
- Activez la lecture des codes-barres en définissant la propriété ReadBarCodes sur true.
- Utilisez la méthode
Readpour effectuer la reconnaissance optique de caractères (OCR) comme d'habitude. - Afficher le texte détecté et les valeurs du code-barres.
Comment lire des BarCodes à partir de documents PDF?
Créez un objet IronTesseract pour effectuer la lecture. Définissez la propriété ReadBarCodes sur vrai pour activer la détection des codes-barres. Importez le document PDF en utilisant le constructeur OcrPdfInput. Utilisez la méthode Read pour effectuer l'OCR sur le PDF importé.
Voici un exemple utilisant ce document PDF :
using IronOcr;
using System;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Enable barcode reading
ocrTesseract.Configuration.ReadBarCodes = true;
// Add PDF
using var imageInput = new OcrPdfInput("pdfWithBarcodes.pdf");
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);
// Output detected barcodes and text values
Console.WriteLine("Extracted text:");
Console.WriteLine(ocrResult.Text);
Console.WriteLine("Extracted barcodes:");
foreach (var barcode in ocrResult.Barcodes)
{
Console.WriteLine(barcode.Value);
}Imports IronOcr
Imports System
' Instantiate IronTesseract
Private ocrTesseract As New IronTesseract()
' Enable barcode reading
ocrTesseract.Configuration.ReadBarCodes = True
' Add PDF
Dim imageInput = New OcrPdfInput("pdfWithBarcodes.pdf")
' Perform OCR
Dim ocrResult As OcrResult = ocrTesseract.Read(imageInput)
' Output detected barcodes and text values
Console.WriteLine("Extracted text:")
Console.WriteLine(ocrResult.Text)
Console.WriteLine("Extracted barcodes:")
For Each barcode In ocrResult.Barcodes
Console.WriteLine(barcode.Value)
Next barcode
Les valeurs des codes-barres multiples apparaissent sous les codes-barres et sont incluses dans le texte extrait.
Pourquoi IronOcr extrait-il à la fois des valeurs de texte et de code-barres?
La double extraction d'IronOCR permet une analyse complète des documents. Lors du traitement de documents contenant à la fois du texte et des codes-barres, la bibliothèque effectue l'extraction de texte OCR standard tout en décodant simultanément les symbologies de codes-barres. Cette approche unifiée élimine le besoin de traitements multiples ou de bibliothèques séparées.
L'extraction de texte capture les éléments lisibles par l'homme, tandis que la détection des codes-barres identifie et décode les données lisibles par la machine. Cela profite aux documents tels que les factures, les étiquettes d'expédition ou les rapports d'inventaire où les valeurs des codes-barres sont en corrélation avec le texte imprimé. La classe OcrResult sépare ces sorties — accédez au texte via la propriété Text et aux données de codes-barres via la collection Barcodes.
Quels sont les formats de BarCode pris en charge?
IronOCR prend en charge plus de 20 formats de codes-barres :
BarCodes 1D:
- Code 128, Code 39, Code 93
- EAN-13, EAN-8
- UPC-A, UPC-E
- Codabar
- ITF (entrelacé 2 sur 5)
- MSI
- Plessey
BarCodes 2D:
- Code QR
- Matrice de données
- PDF417
- Code aztèque
- MaxiCode
Pour les applications spécialisées telles que la lecture de chèques MICR ou le traitement de documents d'identité, les fonctionnalités de code-barres d'IronOCR complètent ses fonctions d'extraction de texte.
Quand devrais-je utiliser l'OCR pour la lecture des codes-barres plutôt que des bibliothèques dédiées aux codes-barres?
Choisissez la lecture de codes-barres intégrée d'IronOCR quand :
- Traitement de contenu mixte : Les documents contiennent à la fois du texte et des BarCodes (étiquettes d'expédition, factures ou documents scannés)
- Préférence pour une bibliothèque unique : Vous souhaitez minimiser les dépendances et utiliser une solution unique
- Traitement des PDF : vous utilisez déjà IronOCR pour l'extraction de texte OCR de PDF
- Mise en page de documents complexes : Les documents comportent des BarCodes intégrés dans des régions de texte ou des tables
Utilisez des bibliothèques de codes-barres dédiées lorsque :
- Traitement d'images de codes-barres en grand volume
- Nécessitant une lecture de codes-barres en temps réel (< 50ms de temps de réponse)
- Travailler avec des BarCodes endommagés ou de mauvaise qualité nécessitant des algorithmes spécialisés
- Mise en œuvre de la lecture mobile de codes-barres avec optimisation de la caméra
Comment lire les codes QR dans les documents?
Comme la lecture de codes-barres, définissez la propriété ReadBarCodes sur vrai. Aucune autre modification du code n'est nécessaire en dehors du chemin d'accès au fichier. Traitez ce document PDF avec des codes QR :
using IronOcr;
using System;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Enable barcode reading
ocrTesseract.Configuration.ReadBarCodes = true;
// Add PDF
using var imageInput = new OcrPdfInput("pdfWithQrCodes.pdf");
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);
// Output detected barcodes and text values
Console.WriteLine("Extracted text:");
Console.WriteLine(ocrResult.Text);
Console.WriteLine("Extracted barcodes:");
foreach (var barcode in ocrResult.Barcodes)
{
Console.WriteLine(barcode.Value);
}Imports IronOcr
Imports System
' Instantiate IronTesseract
Private ocrTesseract As New IronTesseract()
' Enable barcode reading
ocrTesseract.Configuration.ReadBarCodes = True
' Add PDF
Dim imageInput = New OcrPdfInput("pdfWithQrCodes.pdf")
' Perform OCR
Dim ocrResult As OcrResult = ocrTesseract.Read(imageInput)
' Output detected barcodes and text values
Console.WriteLine("Extracted text:")
Console.WriteLine(ocrResult.Text)
Console.WriteLine("Extracted barcodes:")
For Each barcode In ocrResult.Barcodes
Console.WriteLine(barcode.Value)
Next barcode
Pourquoi la même configuration fonctionne-t-elle pour les BarCodes et les QR Codes?
Le moteur unifié de détection des codes-barres d'IronOcr traite tous les codes lisibles par machine de la même manière. La configuration ReadBarCodes active un détecteur de symbologie complet qui reconnaît les formats 1D (codes-barres linéaires) et 2D (QR codes, Data Matrix) sans nécessiter de réglages spécifiques au format. Cette conception simplifie la mise en œuvre et réduit la complexité de la configuration.
L'algorithme de détection est automatique :
- Identifie le type de symbologie sur la base de la reconnaissance des formes
- Appliquer les algorithmes de décodage appropriés
- Prise en charge des variations d'orientation et de taille
- Renvoie les résultats dans un format cohérent, quel que soit le type de code-barres
Cette approche reflète la manière dont fonctionnent les modèles de vision par ordinateur (Computer Vision models), c'est-à-dire la formation à de multiples formats afin de fournir des capacités de détection universelles.
Quels sont les problèmes courants lors de la lecture de codes QR avec l'OCR?
Les défis courants lors du traitement des codes QR sont les suivants :
-
Résolution des problèmes : Les codes QR dans les PDF peuvent être sous-échantillonnés en dessous de la taille minimale du module. Utilisez les paramètres DPI pour garantir une résolution adéquate (300 DPI minimum recommandé).
-
Qualité de l'image : les codes QR scannés sont souvent flous, bruités ou déformés. Appliquez des filtres de correction d'image pour améliorer la clarté :
// Apply filters to improve QR code readability
ocrTesseract.Configuration.ReadBarCodes = true;
var input = new OcrImageInput("qr-code-scan.jpg");
input.DeNoise();
input.Sharpen();
input.EnhanceResolution();
var result = ocrTesseract.Read(input);' Apply filters to improve QR code readability
ocrTesseract.Configuration.ReadBarCodes = True
Dim input As New OcrImageInput("qr-code-scan.jpg")
input.DeNoise()
input.Sharpen()
input.EnhanceResolution()
Dim result = ocrTesseract.Read(input)-
Problèmes d'orientation : Les codes QR inclinés peuvent ne pas se décoder correctement. Activez la détection de la rotation des pages pour gérer les documents mal alignés.
-
Interférence de contenu mixte : le texte ou les graphiques qui se superposent aux codes QR peuvent empêcher leur détection. Utilisez crop regions pour isoler les zones du code QR si nécessaire.
Comment améliorer la précision de la reconnaissance des codes QR?
Optimisez la reconnaissance des codes QR grâce à ces techniques :
- Prétraiter les images : Utilisez l'Assistant de filtrage pour déterminer les paramètres d'amélioration optimaux :
// Enhanced QR code reading with preprocessing
var ocrTesseract = new IronTesseract();
ocrTesseract.Configuration.ReadBarCodes = true;
// Configure for better QR detection
var input = new OcrImageInput("document-with-qr.pdf");
input.TargetDPI = 300; // Ensure sufficient resolution
input.Binarize(); // Convert to black and white
input.DeNoise(); // Remove image artifacts
var result = ocrTesseract.Read(input);Imports IronTesseract
' Enhanced QR code reading with preprocessing
Dim ocrTesseract = New IronTesseract()
ocrTesseract.Configuration.ReadBarCodes = True
' Configure for better QR detection
Dim input = New OcrImageInput("document-with-qr.pdf")
input.TargetDPI = 300 ' Ensure sufficient resolution
input.Binarize() ' Convert to black and white
input.DeNoise() ' Remove image artifacts
Dim result = ocrTesseract.Read(input)- Gérer plusieurs pages : Pour les documents multipages comportant des codes QR sur plusieurs pages :
// Process multi-page documents efficiently
using var pdfInput = new OcrPdfInput("multi-page-qr-document.pdf");
pdfInput.TargetDPI = 300;
var results = ocrTesseract.Read(pdfInput);
foreach (var page in results.Pages)
{
Console.WriteLine($"Page {page.PageNumber}:");
foreach (var barcode in page.Barcodes)
{
Console.WriteLine($" QR Code: {barcode.Value}");
Console.WriteLine($" Location: X={barcode.X}, Y={barcode.Y}");
}
}Imports System
' Process multi-page documents efficiently
Using pdfInput As New OcrPdfInput("multi-page-qr-document.pdf")
pdfInput.TargetDPI = 300
Dim results = ocrTesseract.Read(pdfInput)
For Each page In results.Pages
Console.WriteLine($"Page {page.PageNumber}:")
For Each barcode In page.Barcodes
Console.WriteLine($" QR Code: {barcode.Value}")
Console.WriteLine($" Location: X={barcode.X}, Y={barcode.Y}")
Next
Next
End Using- Traitement asynchrone : Pour de meilleures performances avec plusieurs documents, utilisez les méthodes async :
// Asynchronous QR code reading
var result = await ocrTesseract.ReadAsync(imageInput);' Asynchronous QR code reading
Dim result = Await ocrTesseract.ReadAsync(imageInput)- Problèmes de reconnaissance de débogage : Activez la mise en évidence des résultats pour visualiser ce qu'IronOCR détecte :
result.SaveAsHighlightedImage("qr-detection-debug.png");result.SaveAsHighlightedImage("qr-detection-debug.png")Optimisation des performances pour le traitement des BarCodes à grande échelle
Lorsque vous traitez des milliers de documents avec des BarCodes et des codes QR, mettez en œuvre ces stratégies d'optimisation :
- Multithreading : Tirez parti de traitement multithread pour traiter plusieurs documents simultanément :
// Process multiple documents in parallel
var documents = new[] { "doc1.pdf", "doc2.pdf", "doc3.pdf" };
var results = documents.AsParallel().Select(doc =>
{
var tesseract = new IronTesseract();
tesseract.Configuration.ReadBarCodes = true;
return tesseract.Read(new OcrPdfInput(doc));
}).ToList();Imports IronTesseract
' Process multiple documents in parallel
Dim documents = {"doc1.pdf", "doc2.pdf", "doc3.pdf"}
Dim results = documents.AsParallel().Select(Function(doc)
Dim tesseract = New IronTesseract()
tesseract.Configuration.ReadBarCodes = True
Return tesseract.Read(New OcrPdfInput(doc))
End Function).ToList()- Gestion de la mémoire : Utilisez les jetons abort tokens pour les opérations de longue durée :
// Implement cancellation for large batch processing
using var cts = new CancellationTokenSource();
ocrTesseract.Configuration.CancellationToken = cts.Token;
// Cancel if processing takes too long
cts.CancelAfter(TimeSpan.FromMinutes(5));' Implement cancellation for large batch processing
Using cts As New CancellationTokenSource()
ocrTesseract.Configuration.CancellationToken = cts.Token
' Cancel if processing takes too long
cts.CancelAfter(TimeSpan.FromMinutes(5))
End Using- Exportation des résultats : enregistrez les résultats sous forme de PDF consultables pour conserver à la fois le texte et les données des codes-barres :
// Export results with embedded barcode values
result.SaveAsSearchablePdf("output-with-barcodes.pdf");' Export results with embedded barcode values
result.SaveAsSearchablePdf("output-with-barcodes.pdf")Intégration avec les applications d'entreprise
Les fonctionnalités d'IronOCR pour les codes-barres s'intègrent parfaitement aux applications .NET existantes. Les scénarios d'intégration les plus courants sont les suivants :
- Gestion des stocks : Extraire les codes produits des manifestes d'expédition
- Archivage de documents : Indexer des documents numérisés par des identifiants de codes-barres intégrés
- Traitement des factures : Faire correspondre les UGS des codes-barres avec les postes dans les documents financiers
- Dossiers de santé : Traiter les codes-barres des bracelets des patients parallèlement aux formulaires médicaux
Pour les applications de production traitant de gros volumes de codes-barres et de codes QR, envisagez de mettre en œuvre le suivi de progression pour surveiller l'état du traitement et optimiser les performances en fonction de mesures réelles.
Questions Fréquemment Posées
Comment activer la lecture de codes-barres dans mon application C# ?
Avec IronOcr, activez la lecture des codes-barres en définissant ReadBarCodes = true dans la TesseractConfiguration. Ce simple paramètre active l'extraction automatique des valeurs des codes-barres dans les PDF et les images, parallèlement à la reconnaissance du texte normal, en prenant en charge plus de 20 formats de codes-barres.
Puis-je lire à la fois du texte et des codes-barres dans le même document ?
Oui, IronOcr effectue une double extraction - il capture le texte lisible par l'homme grâce à l'OCR standard tout en décodant simultanément les codes-barres lisibles par la machine. La classe OcrResult sépare ces sorties, le texte étant accessible via la propriété Text et les données des codes-barres via la collection Barcodes.
Quels sont les formats de codes-barres qui peuvent être détectés ?
IronOcr prend en charge plus de 20 formats de codes-barres, notamment les codes-barres 1D (Code 128, Code 39, Code 93, EAN-13, EAN-8, UPC-A, UPC-E, Codabar, ITF, MSI, Plessey) et les codes-barres 2D (QR Code, Data Matrix, etc.).
Comment extraire des codes-barres de documents PDF ?
Créez un objet IronTesseract, attribuez la valeur true à ReadBarCodes, importez votre PDF à l'aide du constructeur OcrPdfInput, puis utilisez la méthode Read. IronOcr effectuera l'OCR et extraira toutes les valeurs de code-barres détectées, auxquelles vous pourrez accéder par le biais de la collection result.Barcodes.
Ai-je besoin de bibliothèques distinctes pour l'OCR de texte et la lecture de codes-barres ?
Non, l'approche unifiée d'IronOCR élimine le besoin de plusieurs passes de traitement ou de bibliothèques distinctes. Elle effectue l'extraction de texte OCR standard tout en décodant simultanément les symbologies de codes-barres en une seule opération.
How can I improve the accuracy of QR code recognition with IronOCR?
Improve QR code recognition by ensuring high resolution, applying image corrections like de-noising and sharpening, and handling orientation issues.
What are common challenges when reading QR codes with OCR?
Common challenges include resolution issues, image quality problems, orientation errors, and interference from overlapping text or graphics.
Can IronOCR handle multi-page PDF documents with barcodes?
Yes, IronOCR can process multi-page PDF documents with barcodes by reading each page individually and outputting detected barcode values and formats.
What is the benefit of using IronOCR for PDF text extraction and barcode reading?
Using IronOCR allows for unified text and barcode extraction from PDF documents, reducing the need for separate libraries and processing steps for each type of data.
How can IronOCR's barcode capabilities integrate into business applications?
IronOCR can be used in various business applications such as inventory management, document archiving, invoice processing, and healthcare records by extracting and processing barcode information.
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
