C#を使用して画像からBarCodeを読み取る方法</#35;

画像のどの領域を読み取るかを指定するにはどうすればよいですか?

CropArea は、BarcodeReaderOptions で利用可能な IronSoftware.Drawing.CropRectangle 型のプロパティであり、ユーザーが IronBarcode に読み取らせる画像内の領域を指定できるようにします。 これは読み取りパフォーマンスの向上に役立ちます。なぜなら、読み取り範囲が指定されたため、バーコードリーダーが画像全体をスキャンしてバーコードを探すことを避け、読み取りの精度も向上します。 最適なパフォーマンスを得るためのクロップ・リージョンの指定方法については、こちらをご覧ください。

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

// Example of setting CropArea
var cropArea = new IronSoftware.Drawing.Rectangle(x: 100, y: 100, width: 300, height: 300);
var options = new BarcodeReaderOptions()
{
    CropArea = cropArea
};

// Example of setting CropArea
var cropArea = new IronSoftware.Drawing.Rectangle(x: 100, y: 100, width: 300, height: 300);
var options = new BarcodeReaderOptions()
{
    CropArea = cropArea
};

Imports IronSoftware.Drawing

' Example of setting CropArea
Dim cropArea As New Rectangle(x:=100, y:=100, width:=300, height:=300)
Dim options As New BarcodeReaderOptions() With {
    .CropArea = cropArea
}

より速く読み取るには、どのバーコードタイプを指定すればよいですか?

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

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

// Example: Expect only QR codes and Code128
var options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

// Example: Expect only QR codes and Code128
var options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

' Example: Expect only QR codes and Code128
Dim options As New BarcodeReaderOptions() With {
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128
}

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

いつ複数の BarCode 読み取りを無効にすべきですか?

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

画像フィルタはバーコード認識をどのように向上させますか?

BarcodeReaderOptions に追加できるプロパティの一つに、画像フィルターのコレクションがあります。 画像フィルタは IronBarcode に入力される生の画像を前処理するために重要です。 ImageFilterコレクションを初期化し、指定する必要があります。 フィルター アプリケーションを含む、画像補正技術に関する包括的なガイダンスについては、チュートリアルをご覧ください。

パフォーマンスを向上させるためにスレッドを最適化するにはどうすればよいですか?

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

マルチスレッド処理を有効にしますか?

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

なぜ誤検出を削除する必要があるのでしょうか

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

MinScanLinesは検出精度にどのような影響を与えますか？

MinScanLines は、BARCODEの結果を有効とみなすために、一致しなければならないスキャンラインの最小数を設定します。 デフォルト値は 2 です。この値を大きくすると誤検出は減りますが、薄かったり品質の低い BARCODE が検出されなくなる可能性があります。 感度を1に下げると、ノイズが発生するリスクはあるものの、読み取りにくいBARCODEに対する感度が向上します。

どのようなスキャン モードがさまざまな使用ケースで利用できますか?

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

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

読み取り速度の設定は精度にどのように影響しますか?

名前が示すように、Speedプロパティは、ユーザーがIronBarcodeリーダーのパフォーマンスをさらに最適化できるようにしています。 RemoveFalsePositive プロパティに類似し、このプロパティを調整することで、パフォーマンスを精度のコストで改善します。 パフォーマンスのベンチマークを含む、読み込み速度のオプションの詳細については、詳細ガイドをご覧ください。これはReadingSpeed列挙型を受け付けます：

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

Code39拡張モードはいつ使用すべきですか?

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