Lettore di codici a barre 1D per .NET

Guida introduttiva al Lettore di codici a barre 1D per .NET

Il Aspose.BarCode 1D Reader for .NET è un’API potente ed efficiente progettata per gli sviluppatori per leggere e decodificare un’ampia gamma di 1D barcodes da immagini all’interno dei loro .NET applicazioni. Questa guida fornisce una panoramica completa delle funzionalità e delle capacità dell’API, con esempi pratici di codice C# per aiutarti a integrarla rapidamente ed efficacemente.

Simboli di codici a barre 1D supportati

Il nostro 1D barcode reader supporta tutti i principali tipi di codici a barre lineari, consentendoti di gestire una varietà di esigenze aziendali. Puoi specificare una o più simbologie per sessione di decodifica per migliorare sia la precisione sia le prestazioni.

Il seguente barcode symbologies sono supportati:

  • UPC-A
  • UPC-E
  • EAN-13
  • EAN-8
  • Code 39
  • Code 93
  • Code 128
  • Interleaved 2 of 5
  • Code 11

Ecco un esempio di come specificare una symbology da leggere usando il 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}");
        }
    }
}

Lettura e Decodifica di Codici a Barre 1D dalle Immagini

La BarcodeReader class è il componente centrale per la lettura dei codici a barre. Può gestire file immagine, stream o bitmap in memoria, fornendo un’integrazione fluida con varie fonti di dati come scanner, fotocamere o flussi di lavoro basati su file.

Lettura da un percorso file

Il modo più semplice per leggere un codice a barre è fornendo il percorso del file immagine:

// 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}");
    }
}

Lettura da un flusso di immagine

Per le applicazioni che gestiscono immagini dalla memoria o da fonti di rete, è possibile utilizzare un flusso:

// 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}");
        }
    }
}

Accesso ai dati del codice a barre decodificato

Ogni barcode decodificato restituisce un BarCodeResult oggetto, che fornisce ricchi metadati, includendo il decoded text, il symbology type e le coordinate del bounding box.

// 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}");
}

Funzionalità avanzate e ottimizzazione

Oltre la lettura di base, il 1D Barcode Reader offre funzionalità potenti per migliorare precisione e prestazioni in scenari complessi.

  • Rotazione e Compensazione dell’Inclinazione: La nostra API rileva e corregge automaticamente la rotazione e la distorsione prospettica. I codici a barre catturati da angoli insoliti vengono letti in modo affidabile senza alcuna pre-elaborazione.
  • Regione di Interesse Personalizzata (ROI): Limita la scansione a un’area rettangolare specifica all’interno di un’immagine. Questo accelera notevolmente la decodifica quando conosci la posizione del codice a barre e riduce i falsi positivi.
  • Elaborazione Batch e Parallela: Per servizi ad alto volume, la libreria supporta la decodifica parallela su più immagini o thread.
  • Rilevamento e Correzione degli Errori: Il lettore sfrutta i meccanismi di checksum e correzione degli errori integrati, dove supportati, segnalando i codici a barre non validi e fornendo punteggi di affidabilità per ogni lettura.

Esempio: Gestire gli errori in modo elegante

È fondamentale implementare la gestione degli errori per gestire scenari in cui un codice a barre è illeggibile o non trovato.

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}");
}

Installazione e configurazione

Iniziare con il Aspose.BarCode 1D Reader è semplice. Basta aggiungere il pacchetto al tuo progetto.

  1. Installa tramite NuGet: Aggiungi il Aspose.BarCode pacchetto al tuo progetto usando il Gestore pacchetti NuGet.
  2. Licenze: Per l’uso in produzione, configura licenza a consumo come descritto nella Guida alla licenza a consumo .

Seguendo questa guida, puoi creare soluzioni robuste e scalabili per l’estrazione 1D barcode data da praticamente qualsiasi fonte di immagini utilizzando il Aspose.BarCode 1D Reader for .NET.

 Italiano