コンテンツにスキップ

QR Code Reader vTool#

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

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

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

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

QR Code Reader vTool

QR Code Readerバージョン#

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

Starter Basic Pro
検出できるQRコードの数はいくつですか? 3 3 無制限
GS1コードおよびMicro QRコードを検出できますか? いいえ はい はい
検出のタイムアウトを指定できますか? いいえ はい はい
どのモジュールサイズが許可されていますか? 側面の長さが2~80ピクセル 側面の長さが6~20ピクセル 側面の長さが2~100ピクセル
モジュール間のギャップは許容されますか? はい(小さなギャップ) はい(小さなギャップ) はい(大きなギャップ)
ファインダーパターンは何個表示する必要がありますか?
(Micro QRコードではなく、QRコードにのみ適用されます。)
3つすべて 3つすべて 2
暗い背景色のQRコードを検出できますか? いいえ
これには前処理手順が必要です。
いいえ
これには前処理手順が必要です。
はい
ミラーリングされたQRコードを検出できますか? はい はい はい
画像のコントラストに制限はありますか? 画像の暗い部分と明るい部分の間に十分なコントラストが必要です。 画像の暗い部分と明るい部分の間に十分なコントラストが必要です。 画像の明るい部分と暗い部分の差は、少なくとも10のグレー値である必要があります。
Enhanced検出モードは使用できますか? いいえ いいえ はい
Roi入力ピンに有効なデータタイプ RectangleF RectangleF、RectangleF配列、領域、領域配列 RectangleF、RectangleF配列、領域、領域配列

仕組み#

情報

QR Code Reader Starter vToolは、GS1またはMicro QRコードの検出をサポートしていません。

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

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

一般的な使用例#

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

QR Code Reader Starter#

1つの画像で最大3つのQRコードを検出できます。画像で予想されるコード数に制限すると、処理時間が短縮される場合があります。GS1またはMicro QRコードの検出はサポートされていません。これらのコードを検出するには、BasicまたはProバージョンのvToolが必要です。

検出基準#

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

  • コード構造:QR Code Readerは、21 x 21~177 x 177モジュールに対応する1~40個のシンボルの標準範囲をサポートしています。
  • モジュールサイズ:コード内の個々のモジュールの側面は、2~80ピクセルの長さにする必要があります。
  • モジュール間のギャップ:モジュール間には小さなギャップが許容されます。
  • ファインダーパターンの数:QRコードには3つのファインダーパターンが含まれます。コードを読み取るには、3つすべてが表示されている必要があります。
  • 極性:QRコードは明るい背景色のパターンでなければなりません。暗い背景色のパターンの場合は、前処理手順を実行して、入力画像を反転させます。例えば、Gray Value Transformer vToolを使用します。
  • ミラーリング:垂直方向、水平方向、または両方向にミラーリングされたQRコードを検出できます。
  • コントラスト:暗い画像と明るい画像の間に十分なコントラストが必要です。
  • 判読性:コードには、反射や汚れなどの視覚的な欠陥がなく、十分な解像度とコントラストが必要です。

vToolの設定#

QR Code Reader Starter vToolを設定するには:

QR Code Reader Starter vToolの設定

  1. [vToolの設定]エリアの[レシピ管理]ペインで、[設定を開く]をクリックするか、[vTool]をダブルクリックします。
    [QR Code Reader Starter]ダイアログが開きます。
  2. [Number of QR Codes]エリアで、検出するQRコードの数を選択します。

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

QR Code Reader Basic#

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

検出基準#

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

  • コード構造:QR Code Readerは、21 x 21~177 x 177モジュールに対応する1~40個のシンボルの標準範囲をサポートしています。
  • モジュールサイズ:コード内の個々のモジュールの側面は、2~100ピクセルの長さにする必要があります。
  • モジュール間のギャップ:モジュール間には小さなギャップが許容されます。
  • ファインダーパターンの数:QRコードには3つのファインダーパターンが含まれます。コードを読み取るには、3つすべてが表示されている必要があります。
  • 極性:QRコードは明るい背景色のパターンでなければなりません。暗い背景色のパターンの場合は、前処理手順を実行して、入力画像を反転させます。例えば、Gray Value Transformer vToolを使用します。
  • ミラーリング:垂直方向、水平方向、または両方向にミラーリングされたQRコードを検出できます。
  • コントラスト:暗い画像と明るい画像の間に十分なコントラストが必要です。
  • 判読性:コードには、反射や汚れなどの視覚的な欠陥がなく、十分な解像度とコントラストが必要です。

データコードの種類#

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

  • QRコード
  • GS1 QRコード
  • Micro QRコード

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

標準のQRコードをデコードする場合、QR Code Readerは生の文字列を出力します。GS1 QRコードを選択すると、QR Code ReaderはGS1標準に準拠した形式で文字列をデコードします。

タイムアウト#

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

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

vToolの設定#

QR Code Reader Basic vToolを設定するには:

QR Code Reader Basic vTool設定

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

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

QR Code Reader Pro#

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

検出基準#

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

  • コード構造:QR Code Readerは、21 x 21~177 x 177モジュールに対応する1~40個のシンボルの標準範囲をサポートしています。
  • モジュールサイズ:コード内の個々のモジュールの側面は、2~100ピクセルの長さにする必要があります。
  • モジュール間のギャップ:モジュール間には大きなギャップが許容されます。
  • ファインダーパターンの数:QRコードには3つのファインダーパターンが含まれます。コードを読み取るには、2つが表示されている必要があります。
  • 極性:QRコードには、明るい背景色のパターンまたは暗い背景色のパターン、またはその両方が混ざっている場合があります。
  • ミラーリング:垂直方向、水平方向、または両方向にミラーリングされたQRコードを検出できます。
  • コントラスト:画像の明るい部分と暗い部分の差は、少なくとも10のグレー値である必要があります。
  • 判読性:反射や汚れなどの視覚的な欠陥のあるコード、および低解像度または低コントラストのコードが検出されることがあります。

データコードの種類#

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

  • QRコード
  • GS1 QRコード
  • Micro QRコード

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

標準のQRコードをデコードする場合、QR Code Readerは生の文字列を出力します。GS1 QRコードを選択すると、QR Code ReaderはGS1標準に準拠した形式で文字列をデコードします。

検出モード#

Enhanced検出モードでは、QR Code Readerは、QRコードの品質に対してより寛容になります。つまり、検出基準の1部を満たしていないコードでも検出します。このオプションを有効にすると、検出プロセスが遅くなります。

タイムアウト#

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

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

vToolの設定#

QR Code Reader Pro vToolを設定するには:

QR Code Reader Pro vTool設定

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

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

入力#

画像#

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

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

Roi#

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

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

出力#

テキスト#

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

  • データ型:String Array

領域#

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

  • データ型:Region Array

典型的な先行機#

典型的な後継機#