How to Read Barcodes From Image Files (JPEG, PNG, GIF, TIFF, SVG, BMP)

CropArea

CropArea は BarcodeReaderOptions に存在する IronSoftware.Drawing.CropRectangle タイプのプロパティで、IronBarcode が読み取るべき画像内の領域をユーザーが指定できます。 これは読み取りパフォーマンスの向上に役立ちます。なぜなら、読み取り範囲が指定されたため、バーコードリーダーが画像全体をスキャンしてバーコードを探すことを避け、読み取りの精度も向上します。

CropArea プロパティを設定するには、新しい Rectangle 型オブジェクトをインスタンス化し、長方形の座標、幅、および長さを引数として指定するだけです。 測定単位として受け入れられるのはピクセル (px) です。

// Example of setting CropArea
var cropArea = new IronSoftware.Drawing.Rectangle(x, y, width, height);

// Example of setting CropArea
var cropArea = new IronSoftware.Drawing.Rectangle(x, y, width, height);

' Example of setting CropArea
Dim cropArea = New IronSoftware.Drawing.Rectangle(x, y, width, height)

ExpectBarcodeTypes

デフォルトでは、IronBarcode でサポートされているすべてのバーコードが画像でスキャンされます。 しかし、ユーザーが画像にどんな種類のバーコードがあるか、または読み取るのかを知っている場合、このプロパティを特定の種類のバーコードだけを読み取るように設定すれば、読み取りパフォーマンスと精度が大幅に向上します。なぜなら、バーコードリーダーがバーコードのコレクションを通過して解釈し読み取る必要がないからです。

このプロパティを使用するには、ExpectBarcodeTypes を BarcodeEncoding 列挙体の一つのフィールドに設定すればよいです。 以下に、IronBarcode がサポートしているすべてのバーコードタイプの例を示します。

前述の例と説明を含むバーコードタイプのリストです。

ExpectMultipleBarcodes

IronBarcode は画像内の利用可能なすべてのバーコードをデフォルトでスキャンします。これには画像ファイル全体のスキャンが含まれ、読み取ったバーコード値を文字列配列に追加します。 しかし、ユーザーが画像ファイル内の複数のバーコードを読み取りたくない場合は、このプロパティを false に設定できます。これにより、バーコード値が見つかった時点でバーコードリーダーはスキャンを中止します。 これもまた、IronBarcode のパフォーマンスと読み取り速度の改善につながります。

ImageFilters

BarcodeReaderOptions に追加できるプロパティの一つが、画像フィルタのコレクションです。 画像フィルタは IronBarcode に入力される生の画像を前処理するために重要です。 画像フィルタを BarcodeReaderOptions 内で適用するために、まずは使用する ImageFilter コレクションを初期化し指定する必要があります。

MaxParallelThreads

IronBarcode はユーザーにパラレルスレッド実行量を有効化および調整することを可能にし、これによりプロセスの速度と効率が向上します。 並列スレッドとは、異なるプロセッサコアで同時に複数のスレッドを実行することを意味します。 IronBarcode における MaxParallelThread プロパティのデフォルト数は 4 です。ユーザーは、そのマシンが持つ能力とリソースの量に基づいてそれらを調整できます。

Multithreaded

このプロパティは、IronBarcode が複数の画像を並行して読み取ることを可能にします。 Multithreaded のデフォルトは true であり、そのため複数のスレッドはバッチバーコード読み取りタスクのパフォーマンスを向上させるために自動的に管理されます。

RemoveFalsePositive

このプロパティは偽陽性バーコード読み取りを除去します。 偽陽性バーコード読み取りは、バーコード値の誤読を意味するが、有効として識別されます。 これはシーケンシングプロセスでのエラーやバーコードラベリングや準備プロセスでのエラーにより起こる可能性があります。 従って、RemoveFalsePositive を true に設定することにより、偽陽性バーコード読み取りを除去し、バーコード読み取り精度を向上させます。 しかし、ユーザーが精度の代わりにパフォーマンスを選ぶ場合、このプロパティを false に設定すると助けになるでしょう。このプロパティのデフォルト値は true です。

ScanMode

IronBarcode が画像内でバーコードをスキャンし検出する方法を定義します。

• Auto: バーコードを自動画像前処理と最適なリーダーオプションの構成で読み取ります。 最良の結果とパフォーマンスのために推奨されます。
• OnlyDetectionModel: 画像内のバーコードをスキャンし、それらの位置を IronSoftware.Drawing.PointF の配列として返します。 このモードは検出されたバーコードを読みません; それはそれぞれのバーコードの位置のみを返します。
• MachineLearningScan: 機械学習検出でバーコードをスキャンして読みます。
• OnlyBasicScan: 機械学習検出、画像自動前処理、またはリーダーオプションの構成なしでバーコードを読み取ります。 このオプションは IronBarCode.Slim と単独で使用できます。

Reading Speed

名前が示すように、Speed プロパティは IronBarcode リーダーのパフォーマンスをさらに最適化するためにユーザーを可能にします。 RemoveFalsePositive プロパティに類似し、このプロパティを調整することで、パフォーマンスを精度のコストで改善します。 それは ReadingSpeed 列挙体を受け入れ、以下の4段階を持っている:

• Faster: 最速のバーコード読み取りを有効にするが、精度を下げる。 このプロセスは画像の前処理をスキップし、しばしば空のバーコード結果をもたらします。 この設定を使用するのは、入力画像がシャープで明確な場合のみです。
• Balanced: この設定は Speed プロパティのために 推奨 されています。 それは精度と読み取りパフォーマンスのバランスをとり、画像に軽い処理を試みて、バーコードエリアを明確にし、バーコードリーダーが検出できるようにします。 この設定は、ほとんどの時間に IronBarcode がバーコード画像を読み取り、正確な出力を生成するために十分です。
• Detailed: ReadingSpeed.Balanced 設定を使用しても読み取りでバーコード値を生成するのが成功しない場合、ユーザーは ReadingSpeed.Detailed を使用できます。 IronBarcode は中程度の処理を画像に行い、バーコードエリアをさらに明確にして、バーコードリーダーが検出できるようにします。 この設定は、小さなまたはシャープでないバーコード画像を検出するために非常に役に立ちます。
• ExtremeDetail: この設定は非常に CPU 集中なプロセスのため 最も推奨されません。 重い処理がバーコード画像に施され、リーダーがバーコードを読み取るようになります。 これにより、IronBarcode の読み取りパフォーマンスが大幅に低下します。 ユーザーはこの設定を選ぶ前にイメージ前処理を行うこと/画像にフィルタを適用することを推奨されます。

UseCode39ExtendedMode

この設定により、Code39 型バーコードは拡張モードで読み取られ解釈され、完全な ASCII 文字セットが適用されます。 UseCode39ExtendedMode を true に設定すると、Code39 バーコードのより正確な読み取りが可能になります。