C#で複数ページの GIF や TIFF から BarCode を読み取る方法

なぜIronBarcodeはマルチフレーム画像を自動的に処理するのですか？

IronBarcodeはマルチフレーム画像を自動的に処理し、ワークフローを簡素化します。 従来のバーコード読み取りライブラリは、処理前にGIFアニメーションから個々のフレームを抽出したり、TIFFファイルからページを分離したりする必要があることが多い。 これは、不必要な複雑さと潜在的な失敗のポイントを追加します。 IronBarcodeのインテリジェントなフレーム検出は、内部で画像構造を解析し、各フレームまたはページを自動的に繰り返し処理することにより、この負担を軽減します。 このアプローチは、最適化されたメモリ管理によって高いパフォーマンスを維持しながら、フレーム数に関係なく一貫した結果を保証します。

以下のコード例では、マルチページのGIFファイルとTIFFファイルの読み取りを実演しています：

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-multi-page-frame-tiff-gif-read-tif.cs

using IronBarCode;
using System;

// Read barcode from TIF image
BarcodeResults results = BarcodeReader.Read("sample.tif");

// Output the barcodes value to console
foreach (var result in results)
{
    Console.WriteLine(result.Value);
}

Imports IronBarCode
Imports System

' Read barcode from TIF image
Private results As BarcodeResults = BarcodeReader.Read("sample.tif")

' Output the barcodes value to console
For Each result In results
	Console.WriteLine(result.Value)
Next result

マルチページ読み取りに対応している画像形式は何ですか?

IronBarcodeのマルチページ読み取り機能は、GIFやTIFFフォーマットだけではありません。 このライブラリは、JPEG、PNG、BMP、単一ページ画像用のSVGなど、すべての標準画像形式をサポートしています。 特にマルチページのサポートについては、TIFFとアニメーションGIFが主なフォーマットです。 TIFFは、さまざまな圧縮方式で複数のフル解像度画像を保存できるため、特に汎用性が高く、文書のスキャニングシーンに最適です。 アニメーションGIFは、256色に制限されていますが、コンパクトでウェブに適した形式で複数のバーコードフレームを保存するのに優れています。 専門的なニーズには、バーコードが埋め込まれた複数のページを含むことが多い PDF 文書からバーコードを読み取ることもできます。

バーコードのスキャンにマルチフレーム画像を使用するのはどのような場合ですか?

マルチフレーム画像は、いくつかのビジネスシナリオに最適です。 文書管理システムでは、スキャンした請求書、出荷書類、または各ページに異なるBarCodeが含まれる可能性のあるフォームを保存するために、複数ページのTIFFファイルを標準として使用します。 製造およびロジスティクス業務では、複数の BarCode の状態や連続したスキャン手順を示す視覚的なワークフローを作成するために、アニメーション GIF を使用することがよくあります。 バッチ処理アプリケーションでは、ファイル管理のオーバーヘッドを減らすことができるため、マルチフレーム形式のメリットがあります。さらに、ストリームからの BarCode 読み取りを実装する場合、マルチフレーム形式はメモリ割り当てを大幅に削減し、パフォーマンスを向上させます。

マルチフレーム TIFF ファイルを作成するプロセスは何ですか?

マルチフレームTIFFファイルを作成するには、複数の画像ソースを1つのTIFFコンテナにまとめる必要があります。 個々の画像をビットマップオブジェクトとしてメモリにロードすることから始めます。 IronDrawing の AnyBitmap クラスは、さまざまな画像形式を処理し、形式変換を自動的に管理し、互換性を確保するための統一されたインターフェイスを提供します。 マルチフレームTIFFを作成する際、ライブラリは圧縮設定を最適化し、ファイルサイズと画質のバランスをとる。

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-multi-page-frame-tiff-gif-create-tiff-gif.cs

using IronBarCode;
using IronSoftware.Drawing;
using System.Collections.Generic;

// Import images
List<AnyBitmap> images = new List<AnyBitmap>()
{
    AnyBitmap.FromFile("image1.png"),
    AnyBitmap.FromFile("image2.png"),
    AnyBitmap.FromFile("image3.png"),
    AnyBitmap.FromFile("image4.jpg"),
    AnyBitmap.FromFile("image5.jpg")
};

// Convert TIFF from images
AnyBitmap tiffImage = AnyBitmap.CreateMultiFrameTiff(images);

// Export TIFF
tiffImage.SaveAs("multiframetiff.tiff");

// Convert GIF from images
AnyBitmap gifImage = AnyBitmap.CreateMultiFrameGif(images);

// Export GIF
gifImage.SaveAs("multiframegif1.gif");

Imports IronBarCode
Imports IronSoftware.Drawing
Imports System.Collections.Generic

' Import images
Private images As New List(Of AnyBitmap)() From {AnyBitmap.FromFile("image1.png"), AnyBitmap.FromFile("image2.png"), AnyBitmap.FromFile("image3.png"), AnyBitmap.FromFile("image4.jpg"), AnyBitmap.FromFile("image5.jpg")}

' Convert TIFF from images
Private tiffImage As AnyBitmap = AnyBitmap.CreateMultiFrameTiff(images)

' Export TIFF
tiffImage.SaveAs("multiframetiff.tiff")

' Convert GIF from images
Dim gifImage As AnyBitmap = AnyBitmap.CreateMultiFrameGif(images)

' Export GIF
gifImage.SaveAs("multiframegif1.gif")

上記のコード スニペットでは、まず画像ファイルを AnyBitmap オブジェクトのリストにインポートしてグループ化します。 AnyBitmap.CreateMultiFrameTiff メソッドと AnyBitmap.CreateMultiFrameGif メソッドを呼び出して、それぞれマルチページ TIFF オブジェクトとマルチページ GIF オブジェクトを取得するときに、このリストをパラメータとして使用します。

バーコード ストレージの GIF と TIFF フォーマットの違いは何ですか?

マルチページGIFもTIFFも、画像を1つのファイルにまとめる方法を提供しますが、両者は大きく異なります：

マルチページバーコード画像にはどの形式を選べばよいですか?

特定のユースケースに基づいて、GIFとTIFFのどちらかを選択してください。 ドキュメントアーカイブやプロフェッショナルスキャニングアプリケーションなど、細部まで正確に保存する必要がある高解像度のBarCode画像を扱う場合は、TIFFを選択してください。 TIFF はさまざまな圧縮方式と色深度をサポートしているため、2D Data Matrix コードのような細かいディテールを含む、さまざまな種類のバーコードの品質を維持するのに理想的です。

ファイルサイズが気になり、バーコードがCode 39やCode 128のような単純な線形形式である場合は、GIFを選択してください。GIFはウェブとの互換性が高いため、ユーザーがバーコードシーケンスをプレビューするようなオンラインアプリケーションに適しています。 ただし、複雑なQRコードやカラーグラデーションのあるBarCodeは、256色の制限が読みやすさに影響する可能性があるため、GIFは避けてください。

ファイルサイズの注意点は何ですか?

ファイルサイズはフォーマットによって大きく異なり、保存、送信、処理速度に影響します。 可逆圧縮のTIFFファイルは、通常、バーコード画像1枚あたり10～50KB、300DPIで、アーカイブ品質に適しています。 TIFF内のJPEG圧縮により、バーコードの可読性を維持したまま、サイズを70～80%縮小することができます。 GIFファイルは一般的に小さく、カラーパレットが限られているため、標準的なバーコードの場合、1フレームあたり平均5～15KBです。 特定のパフォーマンス要件でBarCode読み取りを実装する場合、ファイルが小さいほど処理が速くなりますが、エッジケースでは精度が犠牲になる可能性があることを考慮してください。

精度を高めるには、どのような場合に画像フィルタを使用すればよいですか?

画像フィルタは、最適でない画質を扱う場合に不可欠です。これは、フレームによって画質が異なる可能性のあるマルチフレームファイルでよくあるシナリオです。 スキャナーの制限によりバーコードがぼやけて見えたり、照明条件が悪いためにコントラストが低かったり、圧縮アーチファクトによるノイズが含まれていたりする場合は、フィルターを適用します。 IronBarcode の画像補正機能には、さまざまな光条件に対する適応閾値処理、モーションブラーに対するシャープニングフィルタ、色あせたプリントに対するコントラスト強調などがあります。 マルチフレームファイルの場合、手作業による介入なしにフレーム間の画質のばらつきを補正するフィルターが特に有用です。

以下のコード スニペットは、BarcodeReaderOptions クラスのプロパティの構成を示しています。

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-multi-page-frame-tiff-gif-advance.cs

using IronBarCode;
using System;

// Configure filters
ImageFilterCollection filters = new ImageFilterCollection()
{
    new SharpenFilter(3.5f),
    new ContrastFilter(2)
};

// Configure options
BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = IronBarCode.BarcodeEncoding.QRCode,
    ImageFilters = filters,
    ExpectMultipleBarcodes = true,
    Speed = ReadingSpeed.Balanced
};

// Read barcode from TIF image
BarcodeResults results = BarcodeReader.Read("sample.tif", options);

// Output the barcodes value to console
foreach (var result in results)
{
    Console.WriteLine(result.Value);
}

Imports IronBarCode
Imports System

' Configure filters
Private filters As New ImageFilterCollection() From {
	New SharpenFilter(3.5F),
	New ContrastFilter(2)
}

' Configure options
Private options As New BarcodeReaderOptions() With {
	.ExpectBarcodeTypes = IronBarCode.BarcodeEncoding.QRCode,
	.ImageFilters = filters,
	.ExpectMultipleBarcodes = True,
	.Speed = ReadingSpeed.Balanced
}

' Read barcode from TIF image
Private results As BarcodeResults = BarcodeReader.Read("sample.tif", options)

' Output the barcodes value to console
For Each result In results
	Console.WriteLine(result.Value)
Next result

マルチページ ファイルにはどのようなパフォーマンス設定を使用すればよいですか?

マルチページファイルのパフォーマンスを最適化するには、要件に基づいて速度と精度のバランスを取る必要があります。 速度が重要となる大量処理の場合は、ReadingSpeed.Faster または ReadingSpeed.Fastest を使用します。これにより、スキャンの徹底性は低下しますが、スループットは大幅に向上します。これは、制御された環境できれいに印刷されたバーコードに最適です。 精度が最重要となるミッションクリティカルなアプリケーションでは、ReadingSpeed.Detailed の設定により、処理時間は長くなりますが、最大限の検出率を確保できます。ReadingSpeed.Balanced の設定は、ほとんどのビジネスアプリケーションに最適な中間的な設定です。 マルチページ ファイルを処理するときは、非同期読み取りパターンを実装してフレームを並列処理し、全体のスループットを劇的に向上させることを検討してください。

読む速度と正確さを最適化するにはどうすればよいですか?

スピードと精度のトレードオフを最適化するには、いくつかの戦略的な設定が必要です。 まず、ExpectBarcodeTypes を使用して予想されるバーコード タイプを指定して、不要な形式チェックを排除します。これだけで速度が 40 ～ 60% 向上します。 次に、バーコードがフレーム間で一貫した位置に表示される場合は、クロップ領域を使用し、検索領域を減らします。 3 番目に、フレームの並列処理を最適化するために、CPU 機能に合わせて MaxParallelThreads プロパティを調整します。 精度を最適化するために、フレームに複数のバーコードが含まれている可能性がある場合は ExpectMultipleBarcodes を有効にし、画像の特性に基づいて適切な画像フィルターを適用します。 ML信頼度しきい値機能は、複雑な画像の誤検出をフィルタリングするのにも役立ちます。

読み取り失敗の一般的なトラブルシューティング手順は何ですか?

マルチフレームファイルの読み込みに失敗した場合は、この体系的なアプローチに従ってください。 まず、単一フレームを抽出してテストすることで、個々のフレームの品質を確認します。個々のフレームが失敗する場合、問題はマルチフレーム固有のものではありません。 不十分なクワイエットゾーン、傾いた BarCode、破損したシンボルなどの一般的な認識問題がないか確認してください。 処理が難しいバーコードの場合は、TryHarder モードを有効にしてください。ただし、処理時間は長くなります。問題が解決しない場合は、回転したバーコードが失敗することが多いため、画像の向きを修正してください。 通常、BarCodeは200～300DPIで最も読みやすく、400DPIを超えると読みやすさが低下します。 特定の BarCode タイプで問題が解決しない場合は、supported formats documentation を参照して互換性を確認してください。

BarcodeReaderOptions オブジェクトの設定はほとんどのユースケースではオプションですが、複数ページの GIF および TIFF 画像ファイルからバーコードを読み取るときにIronBarcodeを最大限に活用するのに役立ちます。 本番環境では、デフォルトの設定から始め、特定のパフォーマンス指標と精度の要件に基づいて徐々に最適化してください。