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);

Imports IronBarCode

Private x1 As Integer = 62
Private y1 As Integer = 29
Private x2 As Integer = 345
Private y2 As Integer = 522

Private crop1 As 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);
}

Imports IronBarCode
Imports System

Private x1 As Integer = 62
Private y1 As Integer = 29
Private x2 As Integer = 345
Private y2 As Integer = 522

Private crop1 As New IronSoftware.Drawing.Rectangle(x:= x1, y:= y1, width:= x2 - x1, height:= y2 - y1)

Private options As New BarcodeReaderOptions() With {.CropArea = crop1}

Private result = BarcodeReader.Read("sample.png", options)
For Each item In result
	Console.WriteLine(item.Value)
Next item

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

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

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

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

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

クロップ領域の効果を最大化する：

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

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

結論

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