C#でより速く読み取るための BarCode クロップ領域の定義方法

画像の切り抜き領域の座標とサイズを見つけるにはどうすればよいですか?

画像内の点の座標を求める方法はたくさんあります。 1つの方法は、コンピュータのペイント・アプリケーションを使って画像を読み込むことです。 クロップ領域の最初の座標を取得するには、所望の最初の位置、すなわちRectangleの左上の隅になる場所にカーソルを移動し、画面左下に表示されるアプリから得られるx、y座標を取得します。 次に、Rectangleの右下の隅となる第2の点を見つけます。 より明確な理解のために、以下の画像を参照してください。

より高度なシナリオでは、正確なピクセル座標と測定ツールを提供するGIMPやPhotoshopのような画像編集ソフトウェアの使用も検討してください。 開発者の中には、オンラインの座標検索ツールを使用したり、画像のホバー時にマウス座標を表示するシンプルなHTML/JavaScriptユーティリティを作成したりすることを好む人もいます。

CropRegionリファレンスの設定

:path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-instantiate-CropRegion.cs

using IronBarCode;

int x1 = 62;
int y1 = 29;
int x2 = 345;
int y2 = 522;

IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2-x1, height: y2-y1);

CropRegionを適用してBarCodeを読み取るにはどうすればよいですか?

IronBarcodeに読み取らせたいCropRegionsを定義したら、他の設定と一緒にプロパティの1つとしてBarcodeReaderOptionsにオブジェクトを適用することができます。 これをBarcodeReader.Read()メソッドのパラメータとして使用できます。 以下のコードスニペットはこのプロセスを示しています。

:path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-apply-CropRegion.cs

using IronBarCode;
using System;

int x1 = 62;
int y1 = 29;
int x2 = 345;
int y2 = 522;

IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2 - x1, height: y2 - y1);

BarcodeReaderOptions options = new BarcodeReaderOptions()
{
    CropArea = crop1
};

var result = BarcodeReader.Read("sample.png", options);
foreach (var item in result)
{
    Console.WriteLine(item.Value);
}

クロップ・リージョンの高度なテクニック

本番アプリケーションでは、次のような高度な戦略を検討してください：

1.ダイナミッククロップ領域：ドキュメント テンプレートまたは OCR 結果に基づいて切り抜き領域を計算します。 2.複数のリージョン：複雑なレイアウトのために、1つの画像で複数のクロップ領域を処理します。 3.パフォーマンスの最適化：async処理とクロップリージョンを組み合わせて、最大のスループットを実現します。 4.エラー処理: バーコードが期待される領域で見つからない場合のフォールバック戦略を実装する。

PDFドキュメントで作業する場合、特定のページに切り取り領域を適用して、大きなファイルの処理時間を劇的に短縮することができます。 これは、請求書、出荷ラベル、バーコードの位置が標準化されているフォームに特に役立ちます。

作物の地域定義のベストプラクティス

作物地域の効果を最大化する：

• パディングを追加する: 若干のばらつきを考慮し、予想されるBarCode位置の周囲に10～20ピクセルを含める。
• 徹底的にテストする：クロップ領域がドキュメントセット全体で機能することを確認する。
• ドキュメント座標：アプリケーションの一般的な作物地域の参照シートを維持する。
• スケーリングを考慮する：異なる画像解像度やDPI設定を考慮する
• パフォーマンスを監視する：作物地域の有効性を検証するために処理時間を追跡する。

フォールト トレランスを必要とするアプリケーションでは、2 パス アプローチを実装します。まずクロップ領域をスキャンし、次に期待される領域で BarCode が見つからなかった場合にフル イメージ スキャンにフォールバックします。

結論

クロップ領域の定義は、.NETアプリケーションのバーコード読み取りパフォーマンスを最適化するための強力なテクニックです。 スキャン範囲を特定の領域に限定することで、誤検出を減らしながら大幅なスピードアップを実現できます。 単一の画像を処理する場合でも、バッチ処理を行う場合でも、クロップリージョンは本番環境で必要とされる精度とパフォーマンスを提供します。