Lecteur de code-barres 1D pour .NET
Premiers pas avec le Lecteur de code-barres 1D pour .NET
Le Aspose.BarCode 1D Reader for .NET est une API puissante et efficace conçue pour les développeurs afin de lire et décoder un large éventail de 1D barcodes à partir d’images dans leurs .NET applications. Ce guide fournit un aperçu complet des fonctionnalités et des capacités de l’API, avec des exemples de code C# pratiques pour vous aider à l’intégrer rapidement et efficacement.
Symbologies de codes-barres 1D prises en charge
Notre 1D barcode reader prend en charge tous les principaux types de codes-barres linéaires, vous permettant de répondre à une variété de besoins métier. Vous pouvez spécifier une ou plusieurs symbologies par session de décodage afin d’améliorer à la fois la précision et les performances.
Ce qui suit symbologies de codes-barres sont prises en charge :
- UPC-A
- UPC-E
- EAN-13
- EAN-8
- Code 39
- Code 93
- Code 128
- Interleaved 2 of 5
- Code 11
Voici un exemple de la façon de spécifier une symbologie à lire en utilisant le BarcodeReader classe :
// Read from a stream
using (System.IO.Stream stream = System.IO.File.OpenRead("image.png"))
{
using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader(stream))
{
foreach (var result in reader.ReadBarCodes())
{
Console.WriteLine($"Found Code: {result.CodeText}, Type: {result.CodeType}");
}
}
}Lecture et décodage de codes-barres 1D à partir d’images
Le BarcodeReader La classe est le composant central pour la lecture des codes-barres. Elle peut gérer les fichiers image, les flux ou les bitmaps en mémoire, offrant une intégration transparente avec diverses sources de données telles que les scanners, les caméras ou les flux de travail basés sur des fichiers.
Lecture à partir d’un chemin de fichier
La façon la plus simple de lire un code-barres consiste à fournir le chemin du fichier image :
// Read from an image file
using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader("image.png"))
{
foreach (var result in reader.ReadBarCodes())
{
Console.WriteLine($"Found Code: {result.CodeText}, Type: {result.CodeType}");
}
}Lecture à partir d’un flux d’image
Pour les applications qui traitent des images depuis la mémoire ou des sources réseau, vous pouvez utiliser un flux :
// Read from a stream
using (System.IO.Stream stream = System.IO.File.OpenRead("image.png"))
{
using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader(stream))
{
foreach (var result in reader.ReadBarCodes())
{
Console.WriteLine($"Found Code: {result.CodeText}, Type: {result.CodeType}");
}
}
}Accès aux données de code-barres décodées
Chaque code-barres décodé renvoie un BarCodeResult objet, qui fournit des métadonnées riches, incluant le texte décodé, le type de symbologie et les coordonnées de la boîte englobante.
// Get decoded information
using (Aspose.BarCode.BarCodeRecognition.BarCodeReader reader = new Aspose.BarCode.BarCodeRecognition.BarCodeReader("image.png"))
{
var result = reader.ReadBarCodes()[0];
// Get the symbology and code text
string symbology = result.CodeType.ToString();
string codeText = result.CodeText;
Console.WriteLine($"Symbology: {symbology}, Code Text: {codeText}");
}Fonctionnalités avancées et optimisation
Au-delà de la lecture de base, le 1D Barcode Reader offre des fonctionnalités puissantes pour améliorer la précision et les performances dans des scénarios complexes.
- Compensation de rotation et d’inclinaison: Notre API détecte et corrige automatiquement la rotation et la distorsion de perspective. Les codes-barres capturés sous des angles inhabituels sont lus de manière fiable sans aucun prétraitement.
- Région d’intérêt personnalisée (ROI): Restreignez le balayage à une zone rectangulaire spécifique au sein d’une image. Cela accélère considérablement le décodage lorsque vous connaissez l’emplacement du code-barres et réduit les faux positifs.
- Traitement par lots et parallèle: Pour les services à haut volume, la bibliothèque prend en charge le décodage parallèle sur plusieurs images ou threads.
- Détection et correction d’erreurs: Le lecteur exploite les mécanismes de somme de contrôle et de correction d’erreurs intégrés lorsqu’ils sont pris en charge, signale les codes-barres invalides et fournit des scores de confiance pour chaque lecture.
Exemple : gérer les erreurs avec élégance
Il est crucial de mettre en œuvre la gestion des erreurs pour gérer les scénarios où un code‑barres est illisible ou introuvable.
using Aspose.BarCode.BarCodeRecognition;
using System;
using System.IO;
// Example of reading a barcode from a file
try
{
using (BarCodeReader reader = new BarCodeReader(Path.Combine("C:", "path", "to", "your", "image.png")))
{
foreach (BarCodeResult result in reader.ReadBarCodes())
{
Console.WriteLine("Code Text: " + result.CodeText);
Console.WriteLine("Symbology: " + result.CodeType);
}
}
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred: {ex.Message}");
}Installation et configuration
Commencer avec le Aspose.BarCode 1D Reader est simple. Ajoutez simplement le package à votre projet.
- Installer via NuGet: Ajoutez le
Aspose.BarCodeAjoutez le package à votre projet en utilisant le Gestionnaire de packages NuGet. - Licence: Pour une utilisation en production, configurez licence à la consommation comme décrit dans le Guide de la licence à la consommation .
En suivant ce guide, vous pouvez créer des solutions robustes et évolutives pour extraire 1D barcode data pratiquement de n’importe quelle source d’image en utilisant le Aspose.BarCode 1D Reader for .NET.