PDF417 Code Reader vTool#

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

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

リージョン出力には、PDF417コードが見つかった領域が含まれます。テキスト出力は、PDF417コードでエンコードされたテキスト文字列です。

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

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

PDF417 Code Readerバージョン#

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

仕組み#

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

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

一般的な使用例#

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

PDF417 Code Reader Basic#

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

検出基準#

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

• モジュールサイズ：個々のモジュールの側面は、3～15ピクセルの長さにする必要があります。
• 行と列の制限：詳細については、PDF417 Code Reader バージョンの表を参照してください。
• 極性：PDF417コードは明るい背景色のパターンでなければなりません。暗い背景色のパターンの場合は、前処理手順を実行して、入力画像を反転させます。例えば、Gray Value Transformer vToolを使用します。
• ミラーリング：垂直方向、水平方向、または両方向にミラーリングされたPDF417コードを検出できます。
• 判読性：コードには、反射や汚れなどの視覚的な欠陥がなく、十分な解像度が必要です。

タイムアウト#

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

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

vToolの設定#

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

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

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

PDF417 Code Reader Pro#

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

検出基準#

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

• モジュールサイズ: Enhanced 検出モードでは、個々のモジュールの一辺の長さを 2〜100 ピクセルにする必要があります。Maximum 検出モードでは、個々のモジュールの一辺の長さを 1〜100 ピクセルにする必要があります。
• 行と列の制限：詳細については、PDF417 Code Reader バージョンの表を参照してください。
• 極性：PDF417コードには、明るい背景色のパターンまたは暗い背景色のパターン、またはその両方が混ざっている場合があります。
• ミラーリング：垂直方向、水平方向、または両方向にミラーリングされたPDF417コードを検出できます。
• 判読性：反射や汚れなどの視覚的な欠陥のあるコード、および低解像度のコードが検出できます。

検出モード#

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

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

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

タイムアウト#

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

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

vToolの設定#

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

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

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

入力#

画像#

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

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

Roi#

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

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

出力#

テキスト#

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

• データ型：String Array

領域#

検出された各PDF417コードの領域を返します。領域は長方形の形状をしています。視覚化目的または後続の特徴抽出に使用できます。

• データ型：Region Array

OrientedBoxes_px#

検出された各PDF417コードの方向付きバウンディングボックスを返します。

• データ型：RectangleF Array

関連するvTools#

典型的な先行機#

• カメラvTool
• Image Format Converter vTool

典型的な後継機#

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