Aztec Code Reader vTool#

Aztec Code Reader vToolにより、画像内のAztecコードを検出してデコードできます。

Aztec Code Readerは、Image入力ピンを介して受信した画像で、Aztecコードを検出およびデコードできます。結果は、RegionsおよびTexts出力ピンを介して出力されます。

region出力には、Aztec codeが見つかった領域が含まれます。text出力は、Aztec codeによってエンコードされたテキスト文字列です。

検出する前に、ROI Creator vToolを使用して関心領域を指定する場合、Aztec Code ReaderはROI入力ピンを介してROIデータを受け入れます。これにより、Aztec Code Readerがコードを検索する画像の領域が減少し、誤った候補が除外されます。その結果、処理が高速かつ堅牢になります。

Aztec Code Reader vToolは、単体ライセンス（BasicまたはPro）、またはCode Reader Bundleライセンスの一部として購入できます。ライセンスを購入するには、Baslerウェブサイトをご覧ください。

Aztec Code Readerバージョン#

Aztec Code Readerには2つのバージョンがあります。次の表にバージョン間の違いを示します。表見出しのバージョンをクリックすると、このトピックの関連セクションに直接ジャンプします。

仕組み#

Aztec Code Readerのバージョンに応じて、画像で最大3つまたは無制限の数のAztecコードを検出できます。

特定の時間が経過した後に検出を終了するタイムアウトを指定できます。画像に1つのAztecコードしか含まれていないことがわかっている場合は、Aztec Code Readerを1つのコードのみを検索するように設定すると、処理時間が短縮される可能性があります。

一般的な使用例#

• 読み取りAztecコード：この場合、Texts出力ピンを接続し、デコードされた文字列を出力するだけで済みます。
• Aztecコードの位置の決定：Regions出力ピンから返されるAztecコードの位置とサイズを使用して、後続の処理を行います。

Aztec Code Reader Basic#

1つの画像で最大3つのAztecコードを検出できます。画像で予想されるコード数に制限すると、処理時間が短縮される場合があります。

検出基準#

Aztecコードを検出してデコードするには、次の基準を満たす必要があります。

• コード構造: Aztec Code Reader Basic は、標準的な Aztec コードの構造（11〜151行および列ののマトリックス）をサポートしています。
• モジュールサイズ：個々のモジュールの側面は、6～20ピクセルの長さにする必要があります。
• モジュール間のギャップ：モジュール間には小さなギャップが許容されます。
• ファインダーパターンの許容値：ファインダーパターンのすべてのリングが画像内で明確に表示される必要があります。
• 極性：Aztecコードは明るい背景色のパターンでなければなりません。暗い背景色のパターンの場合は、前処理手順を実行して、入力画像を反転させます。例えば、Gray Value Transformer vToolを使用します。
• ミラーリング：垂直方向、水平方向、または両方向にミラーリングされたAztecコードを検出できます。
• 判読性：コードには、反射や汚れなどの視覚的な欠陥がなく、十分な解像度が必要です。

データコードの種類#

[Data Code Type]ドロップダウンリストでは、検索するデータコードの種類を選択できます。

• Aztecコード
• GS1 Aztecコード

AztecコードとGS1 Azteコードのシンボル構造は同じですが、各コード化スキームが異なります。

標準的な Aztec コードのデコード時、Aztec Code Reader Basic は生文字列を出力します。GS1 Aztec コードを選択した場合、Aztec Code Reader Basic は GS1 標準に準拠したフォーマットで文字列をデコードします。

タイムアウト#

タイムクリティカルなアプリケーションの場合、タイムアウトを指定できます。タイムアウトは、画像にAztecコードが含まれていない場合など、処理時間が変動する場合や予測できない場合に役立ちます。指定されたタイムアウトを超えると、検出プロセスが停止し、次の画像に進みます。

Baslerは、タイムアウトを目的の時間制限より少し短く設定することを推奨します。これは、vToolが検出プロセスを直ちに停止しないためです。そのため、タイムアウトを目的の時間制限の70～80%に設定します。

vToolの設定#

Aztec Code Reader Basic vToolを設定するには：

1. [vTool Settings]エリアの[Recipe Management]ペインで、[Open Settings]をクリックするか、[vTool]をダブルクリックします。
   [Aztec Code Reader Basic]ダイアログが開きます。
2. [Data Code Type]ドロップダウンリストでデータコードの種類を選択します。
3. [Number of Aztec Codes]エリアで、検出するAztecコードの数を選択します。
4. [Timeout]エリアで、一定時間後に検出を終了するかどうかを指定します。タイムアウトを指定する場合は、[No timeout]チェックボックスをオフにして、入力フィールドに目的のタイムアウトを入力します。

Aztec Code Reader Basicの結果は、ピンデータビューに表示できます。ここで、表示する出力を選択できます。

Aztec Code Reader Pro#

1つの画像で数に制限なくAztecコードを検出できます。画像で予想されるコード数に制限すると、処理時間が短縮される場合があります。

検出基準#

Aztecコードを検出してデコードするには、次の基準を満たす必要があります。

• コード構造: Aztec Code Reader Pro は、標準的な Aztec コードの構造（11〜151行および列のマトリックス）をサポートしています。
• モジュールサイズ: Enhanced 検出モードでは、個々のモジュールの一辺の長さを 2〜100 ピクセルにする必要があります。Maximum 検出モードでは、個々のモジュールの一辺の長さを 1〜100 ピクセルにする必要があります。
• モジュール間のギャップ：モジュール間には大きなギャップが許容されます。
• ファインダーパターンの許容値：ファインダーパターンのリングが画像内で部分的に表示される必要があります。
• 極性：Aztecコードには、明るい背景色のパターンまたは暗い背景色のパターン、またはその両方が混ざっている場合があります。
• ミラーリング：垂直方向、水平方向、または両方向にミラーリングされたAztecコードを検出できます。
• 判読性：反射や汚れなどの視覚的な欠陥のあるコード、および低解像度のコードが検出できます。

データコードの種類#

[Data Code Type]ドロップダウンリストでは、検索するデータコードの種類を選択できます。

• Aztecコード
• GS1 Aztecコード

AztecコードとGS1 Azteコードのシンボル構造は同じですが、各コード化スキームが異なります。

標準的な Aztec コードのデコード時、Aztec Code Reader Pro は生文字列を出力します。GS1 Aztec コードを選択した場合、Aztec Code Reader Pro は GS1 標準に準拠したフォーマットで文字列をデコードします。

検出モード#

Standard: 高速な検出モードですが、変形しているデータコードや低解像度のデータコードは検出されません。

Enhanced: この検出モードでは、Aztec Code Reader Pro は Aztec コードの Quality に対してより高い許容度を持ちます。つまり、すべての検出基準を満たしていないコードでも検出できる場合があります。このオプションを有効にすると、検出処理が遅くなります。

Maximum: この検出モードでは、Enhanced 検出モードの利点に加え、より小さなモジュールサイズに対応し、より小さなモジュールの検出において堅牢性が向上します。つまり、すべての検出基準を満たしていないコードをさらに多く検出できるようになります。このオプションを有効にすると、検出処理が遅くなります。

タイムアウト#

タイムクリティカルなアプリケーションの場合、タイムアウトを指定できます。タイムアウトは、画像にAztecコードが含まれていない場合など、処理時間が変動する場合や予測できない場合に役立ちます。指定されたタイムアウトを超えると、検出プロセスが停止し、次の画像に進みます。

Baslerは、タイムアウトを目的の時間制限より少し短く設定することを推奨します。これは、vToolが検出プロセスを直ちに停止しないためです。そのため、タイムアウトを目的の時間制限の70～80%に設定します。

vToolの設定#

Aztec Code Reader Pro vToolを設定するには：

1. [vTool Settings]エリアの[Recipe Management]ペインで、[Open Settings]をクリックするか、[vTool]をダブルクリックします。
   [Aztec Code Reader Pro]ダイアログが開きます。
2. [Data Code Type]ドロップダウンリストでデータコードの種類を選択します。
3. [Number of Aztec Codes]エリアで、検出するAztecコードの数を選択します。検出するコードの最大数が不明な場合は、[Unlimited]を選択します。
4. Detection Mode エリアで、目的の検出モードを選択します。
5. [Polarity]ドロップダウンリストで、アプリケーションに適したオプションを選択します。
   アプリケーションのコードに特定の極性がある場合は、それに応じて設定を選択します。画像内のコードの極性が不明な場合、または極性が異なる複数のコードがある場合は、[Any]を選択します。
6. [Timeout]エリアで、一定時間後に検出を終了するかどうかを指定します。タイムアウトを指定する場合は、[No timeout]チェックボックスをオフにして、入力フィールドに目的のタイムアウトを入力します。

Aztec Code Reader Proの結果は、ピンデータビューに表示できます。ここで、表示する出力を選択できます。

入力#

画像#

Camera vToolから、またはImage Format ConvertervToolなどの画像を出力するvToolから、直接画像を受け入れます。

• データ型：Image
• 画像形式：8ビットのモノクロまたはカラー画像。カラー画像は内部でモノクロ画像に変換されます。

Roi#

領域または矩形を出力するROI Creator vToolなどのvToolから、関心領域を受け入れます。複数の矩形または領域が内部で結合されて、単一の関心領域が形成されます。

• データタイプ：RectangleF、RectangleF配列、領域、領域配列

出力#

テキスト#

Aztecコードでエンコードされたテキスト文字列を返します。

• データ型：String Array

領域#

検出された各 Aztec コードのリージョンを返します。リージョンは長方形の形状をしています。可視化目的や、その後の特徴量抽出に使用できます。

• データ型：Region Array

OrientedBoxes_px#

検出された各 Aztec コードの方向付き外接矩形を返します。

• データ型：RectangleF Array

関連するvTools#

典型的な先行機#

• カメラvTool
• Image Format Converter vTool

典型的な後継機#

• Region Feature Extraction vTool
  を接続し、検出されたAztecコードの中心、サイズ、方向を決定します。