Mit IronBarcode die Lesegeschwindigkeit in C# anpassen

Wann sollte ich die Option "Schnellere Geschwindigkeit" verwenden?

Die Option Faster ermöglicht das schnellste Auslesen von Barcodes mit minimalem Ressourcenaufwand, verringert jedoch die Genauigkeit. Dieser Prozess überspringt die Bildvorverarbeitung und funktioniert am besten, wenn die Eingabebilder bereits scharf und klar sind.

Dieses Beispiel setzt die Eigenschaft Speed auf ReadingSpeed.Faster, importiert ein Verzeichnis von Barcodes und gibt die gefundenen Barcodes mit ihren Werten, Typen und ihrer Anzahl pro Bild aus. Um das Lesen von Barcodes aus verschiedenen Bildformaten besser zu verstehen, lesen Sie unseren Leitfaden zum Lesen von Barcodes aus Bildern.

:path=/static-assets/barcode/content-code-examples/how-to/reading-speed-option-faster.cs

using IronBarCode;
using System;
using System.Diagnostics;
using System.IO;
using System.Linq;

var optionsFaster = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Faster
};

// Directory containing PDF files
string folderPath = @"YOUR_FILE_PATH";

// Get all PDF files in the directory
var pdfFiles = Directory.GetFiles(folderPath, "*.jpg");

int countFaster = 0;
var stopwatch = Stopwatch.StartNew();
foreach (var file in pdfFiles)
{
    // Read the barcode
    var results = BarcodeReader.Read(file, optionsFaster);

    if (results.Any())
    {
        Console.WriteLine($"Barcode(s) found in: {Path.GetFileName(file)}");
        foreach (var result in results)
        {
            Console.WriteLine($"  Value: {result.Value}, Type: {result.BarcodeType}");
            countFaster++;
        }
    }
    else
    {
        Console.WriteLine($"No barcode found in: {Path.GetFileName(file)}");
    }
}

stopwatch.Stop();

// Print number of images the barcode reader could decode
Console.WriteLine($"Faster could read = {countFaster} out of {pdfFiles.Length} in {stopwatch.ElapsedMilliseconds}ms");

Die Option Faster erkannte 146 von 430 Barcode-Ergebnissen in 25 Sekunden, was einer Genauigkeit von 33,95 % entspricht. Diese Methode ist zwar schnell, eignet sich aber nur für makellose Bildbedingungen. Wenn Sie mit mehreren BarCodes in einem einzigen Bild arbeiten, sollten Sie unseren Leitfaden zum Lesen mehrerer BarCodes für eine optimale Konfiguration beachten.

Warum ist Balanced die empfohlene Geschwindigkeitsoption?

Die Option Balanced bietet ein ausgewogenes Verhältnis zwischen Genauigkeit und Leseleistung. IronBarcode wendet eine leichte Bildverarbeitung an, um den Barcodebereich zu verdeutlichen, so dass er leichter zu erkennen und zu lesen ist. Diese Einstellung wird für die meisten modernen Bilder empfohlen, da eine leichte Bearbeitung in der Regel genaue Ergebnisse liefert.

Lassen Sie uns anhand derselben Bilder demonstrieren, wie sich Balanced auf die Ausgaberesultate auswirkt. Für asynchrone Operationen lesen Sie bitte unseren Leitfaden zu async und multithreading mit IronBarcode.

:path=/static-assets/barcode/content-code-examples/how-to/reading-speed-option-balanced.cs

using IronBarCode;
using System;
using System.Diagnostics;
using System.IO;
using System.Linq;

var optionsFaster = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced
};

// Directory containing PDF files
string folderPath = @"YOUR_FILE_PATH";

// Get all PDF files in the directory
var pdfFiles = Directory.GetFiles(folderPath, "*.jpg");

int countFaster = 0;
var stopwatch = Stopwatch.StartNew();
foreach (var file in pdfFiles)
{
    // Read the barcode
    var results = BarcodeReader.Read(file, optionsFaster);

    if (results.Any())
    {
        Console.WriteLine($"Barcode(s) found in: {Path.GetFileName(file)}");
        foreach (var result in results)
        {
            Console.WriteLine($"  Value: {result.Value}, Type: {result.BarcodeType}");
            countFaster++;
        }
    }
    else
    {
        Console.WriteLine($"No barcode found in: {Path.GetFileName(file)}");
    }
}

stopwatch.Stop();

// Print number of images the barcode reader could decode
Console.WriteLine($"Balanced could read = {countFaster} out of {pdfFiles.Length} in {stopwatch.ElapsedMilliseconds}ms");

Die Option Balanced erkannte 237 von 430 Barcode-Ergebnissen in 43 Sekunden. Es bietet eine Genauigkeit von 55,11 % – eine deutliche Verbesserung gegenüber Faster – bei nur geringfügig längerer Bearbeitungszeit. Diese Option hält ein effizientes Gleichgewicht zwischen Speicherplatz und Geschwindigkeit aufrecht, was sie für die meisten Situationen ideal und zum empfohlenen Ausgangspunkt macht. Dieser ausgewogene Ansatz funktioniert besonders gut mit geeigneten Bildvorverarbeitungstechniken.

Wann benötige ich die Option "Detaillierte Geschwindigkeit"?

Wenn Bilder stark verschwommen oder verzerrt sind und Balanced keine klaren Ergebnisse liefern kann, verwenden Sie die Option Detailed. Sie wendet eine mittlere Vorverarbeitung an, um den Barcodebereich zu klären und digitales Rauschen für eine bessere Erkennung zu reduzieren. Für stark beeinträchtigte Bilder lesen Sie bitte unseren Leitfaden zur Bildkorrektur, der verschiedene Vorverarbeitungstechniken behandelt.

Lassen Sie uns die Einstellung Detailed anwenden und deren Auswirkung auf die Ausgabe beobachten.

:path=/static-assets/barcode/content-code-examples/how-to/reading-speed-option-detailed.cs

using IronBarCode;
using System;
using System.Diagnostics;
using System.IO;
using System.Linq;

var optionsFaster = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed
};

// Directory containing PDF files
string folderPath = @"YOUR_FILE_PATH";

// Get all PDF files in the directory
var pdfFiles = Directory.GetFiles(folderPath, "*.jpg");

int countFaster = 0;
var stopwatch = Stopwatch.StartNew();
foreach (var file in pdfFiles)
{
    // Read the barcode
    var results = BarcodeReader.Read(file, optionsFaster);

    if (results.Any())
    {
        Console.WriteLine($"Barcode(s) found in: {Path.GetFileName(file)}");
        foreach (var result in results)
        {
            Console.WriteLine($"  Value: {result.Value}, Type: {result.BarcodeType}");
            countFaster++;
        }
    }
    else
    {
        Console.WriteLine($"No barcode found in: {Path.GetFileName(file)}");
    }
}

stopwatch.Stop();

// Print number of images the barcode reader could decode
Console.WriteLine($"Detailed could read = {countFaster} out of {pdfFiles.Length} in {stopwatch.ElapsedMilliseconds}ms");

Die Option Detailed erkannte 237 von 430 Barcode-Ergebnissen in 5 Minuten und 30 Sekunden. Die Erfolgsquote von 55,11 % bei stark degradierten Barcodes beweist ihre Genauigkeit. Aufgrund der erheblich längeren Bearbeitungszeit sollte diese Option jedoch ausschließlich für minderwertige Barcode-Bilder verwendet werden. Wenn Sie mit unvollständigen Barcodes arbeiten, finden Sie in unserem Beispiel für die Behandlung unvollständiger Barcodes zusätzliche Strategien.

Welche Situationen erfordern extreme Detailgeschwindigkeit?

Die Einstellung ExtremeDetail wendet eine intensive Verarbeitung auf Barcode-Bilder an, was die Leseleistung erheblich reduziert. Diese CPU-intensive Option eignet sich am besten für das Scannen mehrerer unklarer oder verschwommener Barcodes in einer Eingabedatei. Verwenden Sie sie als letzten Ausweg, wenn andere Optionen nicht zu den gewünschten Ergebnissen führen. Für hochvolumige Verarbeitungsszenarien sollten Sie das Lesen von Barcodes aus PDF-Dateien erkunden, die oft mehrere Barcodes pro Seite enthalten.

Lassen Sie uns die Einstellung ExtremeDetail anwenden, um ihre Auswirkungen zu beobachten.

:path=/static-assets/barcode/content-code-examples/how-to/reading-speed-option-extreme-detailed.cs

using IronBarCode;
using System;
using System.Diagnostics;
using System.IO;
using System.Linq;

var optionsFaster = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail
};

// Directory containing PDF files
string folderPath = @"YOUR_FILE_PATH";

// Get all PDF files in the directory
var pdfFiles = Directory.GetFiles(folderPath, "*.jpg");

int countFaster = 0;
var stopwatch = Stopwatch.StartNew();
foreach (var file in pdfFiles)
{
    // Read the barcode
    var results = BarcodeReader.Read(file, optionsFaster);

    if (results.Any())
    {
        Console.WriteLine($"Barcode(s) found in: {Path.GetFileName(file)}");
        foreach (var result in results)
        {
            Console.WriteLine($"  Value: {result.Value}, Type: {result.BarcodeType}");
            countFaster++;
        }
    }
    else
    {
        Console.WriteLine($"No barcode found in: {Path.GetFileName(file)}");
    }
}

stopwatch.Stop();

// Print number of images the barcode reader could decode
Console.WriteLine($"ExtremeDetail could read = {countFaster} out of {pdfFiles.Length} in {stopwatch.ElapsedMilliseconds}ms");

Die Option ExtremeDetail identifizierte 313 von 430 Barcode-Bildern in etwa 10 Minuten. Obwohl es bei stark degradierten Barcodes eine beeindruckende Genauigkeit von 72,79 % erreicht, ist es aufgrund seines hohen Ressourcenverbrauchs nur als letzte Möglichkeit geeignet. Ziehen Sie eine Vorverarbeitung der Bilder in Betracht, bevor Sie diese Option verwenden.

Wie lassen sich die verschiedenen Geschwindigkeiten vergleichen?

Welche Geschwindigkeitseinstellung passt zu meinem Anwendungsfall?