C#で複数の BarCode を一度に読み取る方法

高度な複数の BarCode 読み取りシナリオ

複数の BarCode を扱う場合、追加設定が必要なシナリオに遭遇する可能性があります。 以下は、複雑な文書から異なるフォーマットの複数の BarCode を読み取る方法を示す包括的な例です：

using IronBarCode;
using System;
using System.Linq;

// Configure advanced options for mixed barcode types
BarcodeReaderOptions advancedOptions = new BarcodeReaderOptions()
{
    複数のバーコードを期待 = true,
    // Read both 1D and 2D barcodes
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode | BarcodeEncoding.DataMatrix,
    // Apply image correction filters for better accuracy
    ImageFilters = new ImageFilterCollection() {
        new SharpenFilter(),
        new ContrastFilter()
    },
    // Set speed vs accuracy balance
    Speed = ReadingSpeed.Balanced
};

// Read from various sources
var imageResults = BarcodeReader.Read("mixed-barcodes.jpg", advancedOptions);
var pdfResults = BarcodeReader.ReadPdf("document-with-barcodes.pdf", advancedOptions);

// Process results with error handling
foreach (var result in imageResults)
{
    Console.WriteLine($"Barcode Type: {result.BarcodeType}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
    Console.WriteLine($"Page: {result.PageNumber}");
    Console.WriteLine("---");
}

using IronBarCode;
using System;
using System.Linq;

// Configure advanced options for mixed barcode types
BarcodeReaderOptions advancedOptions = new BarcodeReaderOptions()
{
    複数のバーコードを期待 = true,
    // Read both 1D and 2D barcodes
    ExpectBarcodeTypes = BarcodeEncoding.AllOneDimensional | BarcodeEncoding.QRCode | BarcodeEncoding.DataMatrix,
    // Apply image correction filters for better accuracy
    ImageFilters = new ImageFilterCollection() {
        new SharpenFilter(),
        new ContrastFilter()
    },
    // Set speed vs accuracy balance
    Speed = ReadingSpeed.Balanced
};

// Read from various sources
var imageResults = BarcodeReader.Read("mixed-barcodes.jpg", advancedOptions);
var pdfResults = BarcodeReader.ReadPdf("document-with-barcodes.pdf", advancedOptions);

// Process results with error handling
foreach (var result in imageResults)
{
    Console.WriteLine($"Barcode Type: {result.BarcodeType}");
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
    Console.WriteLine($"Page: {result.PageNumber}");
    Console.WriteLine("---");
}

この高度な例では、いくつかの重要な機能を紹介します：

• 混合バーコード形式のサポート：異なるバーコードエンコーディングタイプを組み合わせます。
• 画像補正フィルター：画像フィルタを使用して読み取り精度を向上させます。
• 読書速度の最適化: 読書速度オプションで速度と正確さのバランスをとる。
• 信頼度スコア：検出された各バーコードの 信頼度しきい値 にアクセスします。

クロップ領域による単一 BarCode 読み取りの最適化

単一バーコードを読み取る際のパフォーマンスをさらに向上させるには、複数のバーコードを期待 = false 設定と crop region specification を組み合わせてください。 このテクニックは、バーコードのおおよその位置がわかっている場合に特に役立ちます：

using IronBarCode;
using IronSoftware.Drawing;

// Define a crop region where the barcode is likely located
var cropRegion = new Rectangle(100, 100, 300, 200);

// Configure options for optimal single barcode reading
BarcodeReaderOptions optimizedOptions = new BarcodeReaderOptions()
{
    複数のバーコードを期待 = false,
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    CropArea = cropRegion,
    Speed = ReadingSpeed.Faster
};

// Read with optimized settings
var result = BarcodeReader.Read("product-label.png", optimizedOptions).FirstOrDefault();

if (result != null)
{
    Console.WriteLine($"Barcode found: {result.Value}");
    Console.WriteLine($"Read time: {result.ReadTime}ms");
}

using IronBarCode;
using IronSoftware.Drawing;

// Define a crop region where the barcode is likely located
var cropRegion = new Rectangle(100, 100, 300, 200);

// Configure options for optimal single barcode reading
BarcodeReaderOptions optimizedOptions = new BarcodeReaderOptions()
{
    複数のバーコードを期待 = false,
    ExpectBarcodeTypes = BarcodeEncoding.Code128,
    CropArea = cropRegion,
    Speed = ReadingSpeed.Faster
};

// Read with optimized settings
var result = BarcodeReader.Read("product-label.png", optimizedOptions).FirstOrDefault();

if (result != null)
{
    Console.WriteLine($"Barcode found: {result.Value}");
    Console.WriteLine($"Read time: {result.ReadTime}ms");
}

シングルバーコード読み取りはどれくらい速いですか?

ExpectMultipleBarcodes を false に設定すると、単一バーコードの読み取り効率が大幅に向上します。 パフォーマンスの向上は、高解像度の画像を扱う場合や、高スループットのアプリケーションで非同期バーコード読み取りを実装する場合に特に顕著です。

提供されたコードスニペットを使用すると、同じマシンでExpectMultipleBarcodesをtrueとfalseに設定した場合のパフォーマンス差の大まかな推定は次のとおりです。

これは、単一の BarCode を読み取る際に、約 9 倍のパフォーマンス向上を意味します。 実際のパフォーマンスは、以下の条件によって異なります：

• 画像の解像度と複雑さ
• 画像に含まれる BarCode の数
• 選択されたバーコード形式
• 応用画像フィルタ
• ハードウェア仕様

複数の BarCode を読み取るためのベストプラクティス

本番アプリケーションで複数の BarCode 読み取りを実装する場合は、以下のベストプラクティスを考慮してください：

1.Specify Expected Barcode Types: BarcodeEncoding.Allを使用する代わりに、期待するフォーマットのみを指定してください。 これにより、パフォーマンスが大幅に向上します。

2.適切な画像形式を使用する：最良の結果を得るためには、コントラストの高い画像を使用してください。 最適な BarCode 画像の作成については、こちらをご覧ください。

3.不完全なBarCodeを扱う：実世界のBarCodeは破損していたり、印刷が不完全だったりすることがあります。 画像修正技術を使用して、読解の成功率を高めます。

4.ストリーム処理：大きなバッチでは、ストリームからの読み取りを検討して、メモリ使用量を最適化します。

5.エラー処理：BarCodeが読み取れないシナリオに対しては、常に適切なエラー処理を実装してください：

try
{
    var results = BarcodeReader.Read("barcodes.png", new BarcodeReaderOptions 
    { 
        複数のバーコードを期待 = true 
    });

    if (!results.Any())
    {
        Console.WriteLine("No barcodes found in the image");
    }
    else
    {
        Console.WriteLine($"Found {results.Count()} barcodes");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading barcodes: {ex.Message}");
    // Log error for debugging
}

try
{
    var results = BarcodeReader.Read("barcodes.png", new BarcodeReaderOptions 
    { 
        複数のバーコードを期待 = true 
    });

    if (!results.Any())
    {
        Console.WriteLine("No barcodes found in the image");
    }
    else
    {
        Console.WriteLine($"Found {results.Count()} barcodes");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading barcodes: {ex.Message}");
    // Log error for debugging
}

これらのプラクティスに従い、IronBarcodeの包括的な機能を活用することで、様々な業界やユースケースにおける複数のバーコード読み取りシナリオを効率的に処理する堅牢なアプリケーションを構築することができます。