QR コードの読み取り
このツールでは、画像内の QR または Micro QR タイプのコードを 1 つ以上検出して、読み取ります。このツールを追加した場合、現在の処理画像が自動的にスキャンされ、デフォルトで、画像上の最初の通常の QR コードが読み取られます。
トレーニング
このツールは、トレーニングモードとともに使用されます。 easyTouch および easyTouch+ は実処理モードで現行画像の値を推定するのに使います。画像の中のコードが完全に読めるのかどうか確認するのに使えます。次にトレーニングモードを使って一連の画像の中で最高のパラメーターを決定します。
- トレーニング画像として使用する画像がツールに表れるまで「1 回実行」ボタンかショートカット F6 でアプリケーションを段階的に実行します。
-
ボタンをクリックするか、ショートカット F3 を使用して、トレーニング画像セットに現在の画像を追加します。ツールは、画像内のコードの輪郭候補を自動的にハイライト表示します。 - 必要に応じて、コード上に ROI を描画します。
- さらにトレーニング画像を追加するには、以上のステップを繰り返します。
- 「トレーニングデータを適用」ボタンをクリックしてトレーニングを実施します。トレーニング画像セットのパラメータは、自動的に決まります。さらに、このツールでは、処理モードに自動的に切り替わり、現在の画像に、検出したコードが表示されます。
トレーニングを確認
- 処理画像をクリックして処理モードに切り替えます。
- コードが検出されて読み込まれているかを、一連の画像で MERLIC を実行して確認します。
- 特定のコードのデコーディッドデータを確認するには、画像内のコード上にマウスポインタを移動します。デコーディッドデータは、ツールチップにただちに表示されます。または、それぞれのツールの結果で、デコーディッドデータを確認することもできます。
データコード検出領域を制限できます。トレーニング画像としてコードを読み取り、画像を加える画像の部分に ROI を描画します。これでコードが定義された画像部分でのみ読めるようになりました。
ツール構造
ツールボード は、 の左側のトレーニングエリアと右側のグラフィックウィンドウに分割されます。
トレーニングエリア
グラフィックウィンドウ
ツールボード 左側の最初の画像には、現在読み込まれている画像が表示されます。デフォルトパラメータ設定で読み取りが成功した場合、この段階で、MERLIC は、見つかったすべてのコードのプレビューを出力し、結果を返します。
画像を「処理」から「トレーニング」エリアに転送するには、 ボタンをクリックしてトレーニング画像を選択します。また、さらに画像を追加することもできます。その場合、トレーニング画像として使用する画像が「処理中」に表示されるまでプログラムをシングルステップで実行し、 ボタンを押します。いずれの場合も、「トレーニングデータを適用」ボタンを押して、パラメータをトレーニング画像に適合させます。
その後、同じツール内で、別の画像を使用してパラメーターをテストすることができます。トレーニングが必要なツールの使用方法の詳細については、トピックトレーニングモードの使用を参照してください。
パラメーター
パラメーター「コードタイプ」で選択したコードタイプや、パラメーター「規格に適合」で選択した値によっては、コネクターの一部がグレイ表示になります。現在選択されているパラメーターには適用されないため効果がないということです。
基本パラメーター
画像:
このパラメーターは、QR コード を読み取る画像を表します。
色画像をこのツールの入力として使用すると、最初のチャンネル (赤いチャンネル) のみが処理の対象になります。
コードタイプ:
画像の中でどのコードタイプを検知、デコードするのか選択します。
|
値 |
説明 |
|---|---|
|
QR コード |
QRタイプのコードの検知と読み取りQR コード のファインダー要素は、位置検知パターンと呼ばれる 3 つの正方形で構成されます。 |
|
Micro QR Code |
MicroQRタイプのコードの検知と読み取り小さい Micro QR Code には、正方形のファインダーパターンが 1 つだけあります。 |
コードの予想数:
このパラメーターは画像内にある予想コード数を定義します。デフォルトでは、この値は 1 に設定されます。見つかったコード数が予想値よりも少ない場合、コードの読み取りは失敗です。使用中の画像処理のため、ツールによってコードの予想数の最小値を超えるコードが発見される可能性があります。この場合、ROI を使用してデータコード検出領域を制限します。
追加パラメーター
処理領域:
このパラメーターは、処理する領域を定義します。ROI と「処理領域」の結合部分の外側にある画像部分は処理の対象外になります。また、そのどちらかが空の場合、他の一方の内部にある画像部分は処理されます。どちらも空の場合、画像全体が処理されます。
デフォルトで、「処理領域」は空の領域として定義されます。「処理領域」を指定するには、領域が現在のツールに渡されるよう、パラメーターを前のツールの適切な領域結果に接続します。
easyTouch でパラメータ値を決定すると、画像全体が検索対象になります。
ROI:
パラメーター ROI は、コード検知の関心領域 (ROI) を定義します。「ROI」と「処理済み領域」の結合部分の外側の画像部分は処理の対象外になります。また、そのどちらかが空の場合、他の一方の内部にある画像部分は処理されます。どちらも空の場合、画像全体が処理されます。 ただし、easyTouch でパラメータ値を決定すると、画像全体が処理に適用されます。
デフォルトで、「ROI」は空 ROI として定義されます。空でない ROI を処理に使用する場合は、前のツールの適切な ROI 結果にパラメーターを接続するか、使用可能な ROI ボタンで新しい ROI を画像に描画します。
easyTouch でパラメータ値を決定すると、画像全体が検索対象になります。
アライメントデータ:
このパラメータは、ROI のアライメントに使用するアライメントデータを表します。デフォルトでは、アライメントデータが接続されていないため、効果はありません。特定のアライメントデータを使用するには、マッチングによるアライメント、直線境界でアライメントを決定、画像をアライメント、あるいは 画像を回転 など、パラメータを適切な前のツールの結果に接続します。
タイムアウト:
このパラメータを使用すると、実行しているツールを、定義された時間 (ミリセカンド単位) 後に中止できます。これは最大サイクル時間を確認する場合に特に有効です。中断の時間的精度は約10msです。精度はコンピュータの速度のような複数の因子に依存します。トレーニングモードではタイムアウトが無視されます。デフォルトタイムアウトは 0 ms です。
|
値 |
説明 |
|---|---|
|
0 |
デフォルトで、タイムアウトは設定しません。 |
|
1 ～ 1000 |
これは、タイムアウトをミリ秒単位で設定できる値の範囲です。 |
コントラスト許容範囲:
このパラメーターは、ローカルコントラスト変動 (たとえばグレアや反射がある場合) に対する検索の許容範囲を定義します。パラメーター値に応じて 2 種類のアルゴリズムが適用されます。デフォルト設定は「低」です。
|
値 |
説明 |
|---|---|
|
低 |
高速アルゴリズム：この設定は、ローカルコントラスト変動がほとんどない場合に便利です。強いローカルコントラスト変動がある場合にはロバスト性が下がります。 |
|
高 |
ロバスト性があるが遅いアルゴリズム：強いローカルコントラスト変動がある場合に便利です。 |
|
任意 |
強いコントラスト変動がある場合もない場合もあります。両方のアルゴリズムが適用されます。 |
最小コントラスト:
このパラメーターは、土台の HALCON のバージョンにより現在では効力がないことから、無効化されています。互換性のみを目的として残されています。
ミラーリングコード:
このパラメータは、シンボルがミラーリングされたか、あるいはミラーリングができるかを記述します。ミラーリングはシンボルの行と列の交換に相当します。デフォルト設定は「いいえ」です。
|
値 |
説明 |
|---|---|
|
いいえ |
コードはミラーリングされたことを示しません。 |
|
はい |
コードは常にミラーリングされたことを示します。 |
|
任意 |
コードはミラーリングされているかもしれません。 |
最小ギャップ幅
このパラメーターは、シンボル行および列方向の最小ギャップ幅を定義します。デフォルト設定は「いいえ」です。
|
値 |
説明 |
|---|---|
|
いいえ |
最小ギャップ幅はありません。 |
|
小 |
ギャップ幅は少なくとも小です。 |
|
大 |
ギャップ幅は大です。 |
最大ギャップ幅
このパラメーターは、シンボル行および列方向の最大ギャップ幅を定義します。デフォルト設定は「小」です。
|
値 |
説明 |
|---|---|
|
いいえ |
最大ギャップ幅はありません。 |
|
小 |
小規模のギャップが許容されます。 |
|
大 |
大規模のギャップが許容されます。 |
最小モジュールサイズ:
このパラメーターは、画像内のモジュールの最小サイズを指定します。このパラメーターはピクセル単位で定義され、デフォルト設定値は 6 ピクセルです。
|
値 |
説明 |
|---|---|
|
6 |
これは、デフォルトの最小モジュールサイズです。モジュールサイズが 6 ピクセルを超えるすべてのシンボルは読み取れられます。 |
|
1 ～ 100 |
これは、最小モジュールサイズを設定できる値の範囲です。 |
最大モジュールサイズ:
このパラメーターは、シンボルモジュールの最大サイズを指定します。このパラメーターはピクセル単位で定義され、デフォルト設定値は 20 ピクセルです。
|
値 |
説明 |
|---|---|
|
20 |
これは、デフォルトの最大モジュールサイズです。モジュールサイズが 20 ピクセルまでのすべてのシンボルは読み取られます。 |
|
6 ～ 100 |
これは、最大モジュールサイズを設定できる値の範囲です。 |
コードプロパティ:
このパラメータは、明るい背景に暗く、あるいは暗い背景に明るくシンボルを表示するかを決定します。デフォルト設定は「暗い」です。
|
値 |
説明 |
|---|---|
|
暗い |
これは、デフォルト設定です。 シンボルは明るい背景に暗く現れます。 |
|
明るい |
シンボルは暗い背景に明るく現れます。 |
|
任意 |
シンボルは、明るい背景に暗く現れるか、暗い背景に明るく現れるかのどちらかです。 |
位置パターンの最小数:
このパラメーターは、新しいシンボル候補を生成するために可視化が必要な位置検知パターン数を表します。この値は「QR コード」が「コードタイプ」として選択されている時のみ変更できます。「Micro QR Code」が「コードタイプ」として選択されている場合、パラメーターは適用されないためグレイ表示されます。デフォルト設定値は 2 です。
|
値 |
説明 |
|---|---|
|
2 |
これは、可視化が必要な位置パターン数のデフォルト値です。可視位置パターンが 2 行以上のシンボルはすべて読み取られます。 |
|
2 ～ 3 |
これは、位置パターンの最小数を設定できる値の範囲です。 |
小モジュールに対してロバスト:
このパラメータは、非常に小さいモジュールサイズのデータコードのデコーディングのロバスト性を定義します。パラメータ「小モジュールに対してロバスト」を 1 (高) に設定すると、非常に小さいモジュールサイズでデータコードをデコードできる可能性が高くなります。さらにその場合それに応じて最小モジュールサイズが使用されます。「小モジュールに対してロバスト」を 1 に設定すると、ツールの内部メモリ使用量を大幅に増加できます。従って、デフォルト設定は 0、低です。
|
値 |
説明 |
|---|---|
|
0 |
これは、デフォルト設定です。 この設定は、小さいモジュールに対してロバスト性が低い場合に使用してください。 |
|
1 |
この設定は、小さいモジュールに対して高いロバスト性が必要な場合に使用してください。この設定では、メモリ使用量が増えます。 |
規格に適合:
このパラメーターは、そのサイズがパラメーター「最小モジュールサイズ」および「最大モジュールサイズ」で定義されるモデル制限に適合しないシンボルを読み取る際にツールの挙動を制御します。パラメーターの設定値はデフォルトで 0 です。
|
値 |
説明 |
|---|---|
|
0 |
このコードには、以下の標準は適用されません。サイズやモデルで指定されたサイズとは独立してすべてのシンボルが結果として返されます。 |
|
1 |
このコードには、以下の標準が適用されます。規格制限に適合していないその他全てのシンボルが拒否されます。 |
利用できるクワイエットゾーン:
このパラメーターは、読み取り可能でも、そのクワイエットゾーンに欠陥があるシンボル検出中のツールの挙動を制御します。パラメーターの設定値はデフォルトで 0 です。
|
値 |
説明 |
|---|---|
|
0 |
クワイエットゾーンが欠陥を示す時でも結果として全ての読み取れるコードが返されます。 |
|
1 |
検証されたクワイエットゾーンを持つコードだけが読み取られます。クワイエットゾーンのために低いグレードのシンボルは結果として返されません。 |
最小コードバージョン:
このパラメーターは、QR コード規格に従って行および列数にリンクされる最小コードバージョンを制御します。バージョン番号が大きいほど、シンボルが大きくなります。「規格に適合」が 1 に設定されている場合にのみ、「最小コードバージョン」が適用されます。したがって、「規格に適合」が 0 に設定されている場合、パラメーターは適用されないためグレイ表示されます。
- 「QR コード」モジュールの数: 各サイドで 4 x バージョン番号 + 17 ドット。すなわち、バージョン 1 の場合 21 x 21 モジュール、バージョン 40 の場合 177 x 177 モジュールです。古いモデル 1 シンボルの最大サイズは、バージョン 14、すなわち、73 x 73 です。
- 「Micro QR Code」モジュールの数: 各サイドで 2 x バージョン番号 + 9 ドット。すなわち、バージョン M1 の場合 11 x 11 モジュール、バージョン M4 の場合 17 x 17 モジュールです。
|
QR コード の値 |
Micro QR Code の値 |
説明 |
|---|---|---|
|
1 |
1 |
これは、デフォルトの最小コードバージョンです。すべてのコードが読み取られます。 |
|
1 ～ 40 |
1 ～ 4 |
これは、最小コードバージョンを設定できる値の範囲です。 |
最大コードバージョン:
このパラメーターは、QR コード規格に従って行および列数にリンクされる最大コードバージョンを定義します。バージョン番号が大きいほど、シンボルが大きくなります。「規格に適合」が 1 に設定されている場合にのみ、「最大コードバージョン」が適用されます。したがって、「規格に適合」が 0 に設定されている場合、パラメーターは適用されないためグレイ表示されます。
- 「QR コード」モジュールの数: 各サイドで 4 x バージョン番号 + 17 ドット。すなわち、バージョン 1 の場合 21 x 21 モジュール、バージョン 40 の場合 177 x 177 モジュールです。古いモデル 1 シンボルの最大サイズは、バージョン 14、すなわち、73 x 73 です。
- 「Micro QR Code」モジュールの数: 各サイドで 2 x バージョン番号 + 9 ドット。すなわち、バージョン M1 の場合 11 x 11 モジュール、バージョン M4 の場合 17 x 17 モジュールです。
|
QR コード の値 |
Micro QR Code の値 |
説明 |
|---|---|---|
|
40 |
4 |
これは、デフォルトの最大コードバージョンです。すべてのコードが読み取られます。 |
|
1 ～ 40 |
1 ～ 4 |
これは、最大コードバージョンを設定できる値の範囲です。 |
エンコーディング:
このパラメーターは、QR コードの読み取り時にどのエンコーディングを使用するかを定義します。デフォルト値を指定すると、エンコーディングタイプとして「UTF-8」が使用されます。アジア QR コードなど、特殊文字の入った QR コードを読み取る場合、エンコーディングは対応するタイプに変更してください。
サポート対象のエンコーディングタイプのリストについては、以下の表を展開してください。
エンコーディングタイプのリスト
|
エンコーディングタイプ |
|---|
|
デフォルト (UTF-8) |
|
ネイティブ (システムのエンコーディング) |
|
Big5 |
|
Big5-HKSCS |
|
CP949 |
|
EUC-JP |
|
EUC-KR |
|
GB18030 |
|
HP-ROMAN8 |
|
IBM 850 |
|
IBM 866 |
|
IBM 874 |
|
ISO 2022-JP |
|
ISO 8859-1 |
|
ISO 8859-2 |
|
ISO 8859-3 |
|
ISO 8859-4 |
|
ISO 8859-5 |
|
ISO 8859-6 |
|
ISO 8859-7 |
|
ISO 8859-8 |
|
ISO 8859-9 |
|
ISO 8859-10 |
|
ISO 8859-13 |
|
ISO 8859-14 |
|
ISO 8859-15 |
|
Iscii-Bng |
|
Iscii-Dev |
|
Iscii-Gjr |
|
Iscii-Knd |
|
Iscii-Mlm |
|
Iscii-Ori |
|
Iscii-Pnj |
|
Iscii-Tlg |
|
Iscii-Tml |
|
KOI8-R |
|
KOI8-U |
|
Macintosh |
|
Shift-JIS |
|
TIS-620 |
|
TSCII |
|
UTF-8 |
|
UTF-16 |
|
UTF-16BE |
|
UTF-16LE |
|
UTF-32 |
|
UTF-32BE |
|
UTF-32LE |
|
Windows-1250 |
|
Windows-1251 |
|
Windows-1252 |
|
Windows-1253 |
|
Windows-1254 |
|
Windows-1255 |
|
Windows-1256 |
|
Windows-1257 |
|
Windows-1258 |
印刷品質:
このパラメーターは、印刷品質を評価するかどうか、およびどの検証基準に基づいて評価するかを定義します。デフォルト設定は「なし」です。
|
値 |
説明 |
|---|---|
|
なし |
印刷品質判定は無効です。 |
|
ISO/IEC 15415 |
検証基準 ISO/IEC 15415 に基づいて印刷品質を評価します。 |
|
ISO/IEC TR 29158 (AIM DPM-1-2006) |
検証基準 ISO/IEC TR 29158 (AIM DPM-1-2006) に基づいて印刷品質を評価します。 |
結果
基本結果
デコーディッドデータ:
結果として、デコーディッドデータを伴う文字列が返ります。複数のコードを読み取ると、結果はタプルで返ります。タプルエントリは、画像に表示されるときの「行」と「列」の値を基準に保存されます。したがって、複数行を読み取ると、デコードした最初の行のデータが最初に返り、次に 2 行目のデータと、以下同様に返ります。1 行に複数のコードがある場合、テキストのように、次の行が処理されるまで左から右に返ります。
特定のコードのデコーディッドデータは、画像内のコード上にマウスポインタを移動することでも表示されます。このようにして、コードは画像で直接すばやく確認できます。
ツール状態:
「ツール状態」はツール状態の情報を返します。したがって、エラー処理に使うことができます。さまざまなツールの状態結果の詳細については、 ツール状態 結果 のトピックを参照してください。
追加結果
抽出輪郭:
この結果では、検出したデータコードの輪郭が返ります。
印刷品質の値:
この結果は、選択した検証基準の印刷品質機能に対して評価された値を返します。これらはタプルとして返され、結果「印刷品質機能」内の印刷品質機能のラベルの順序に従って整列されます。したがって、タプルの最初の値は、「印刷品質機能」の結果で返される最初の機能の印刷品質値を表します。2 番目の値は 2 番目の特徴を表し、以下同様になります。返される可能性がある最大値は 4 です。印刷品質が低すぎる 印刷品質機能 の場合は、値 0 が返されます。検証基準が選択されていない場合、つまり「印刷品質」が「なし」に設定されている場合、この結果には空のタプルが返されます。
印刷品質機能:
この結果は、選択した検証基準に対して評価された印刷品質機能のラベルを返します。サポートされている検証基準の機能リストは事前に定義されており、処理中に変更されることはありません。これらは、文字列のタプルで返ります。各機能に対して返されるタプル値は、同じインデックスを持つ結果「印刷品質の値」内の個々の値に対応します。検証基準が選択されていない場合、つまり「印刷品質」が「なし」に設定されている場合、この結果には空のリストが返されます。
処理時間:
この結果は、ツールの直近の実行の持続時間をミリ秒単位で返します。結果は、追加結果として提供されます。したがって、デフォルトでは非表示になっていますが、ツール結果の横にある ボタンを使用して表示できます。詳細については、ツールリファレンス概要の処理時間の節を参照してください。
トレーニング結果
基本トレーニング結果
コードの予想数外れ:
この結果では、以下のパラメーターに使用する値が返ります: コードの予想数.この値は、画像内のコードの予想数を定義します。
追加トレーニング結果
コントラスト許容範囲外れ:
この結果では、以下のパラメーターに使用する値が返ります: コントラスト許容範囲.このパラメータは、ローカルコントラスト変動を基準に検索許容誤差を記述します。
最小コントラスト外れ:
この結果は、対応するツールパラメーター「最小コントラスト」が無効化されたことから、特定されなくなりました。互換性のみを目的として残されています。結果に引き続き値が表示される場合がありますが、この値は意味を持たないため、無視する必要があります。
ミラーリングコード外れ:
この結果では、以下のパラメーターに使用する値が返ります: ミラーリングコード.この結果は、シンボルがミラーリングされたか、あるいはミラーリングされた可能性があることを記述します。ミラーリングはシンボルの行と列の入れ替えと同じ操作です。
最大ギャップ幅外れ:
この結果では、以下のパラメーターに使用する値が返ります: 最大ギャップ幅.
最小ギャップ幅外れ:
この結果では、以下のパラメーターに使用する値が返ります: 最小ギャップ幅.
最大モジュールサイズ外れ:
この結果では、以下のパラメーターに使用する値が返ります: 最大モジュールサイズ.この結果は、シンボルモジュールの最大サイズを定義します。
最小モジュールサイズ外れ:
この結果では、以下のパラメーターに使用する値が返ります:「最小モジュールサイズ」。このパラメーターは、画像内のモジュールの最小サイズを表します。
コードプロパティ外れ:
この結果では、以下のパラメーターに使用する値が返ります: コードプロパティ.このパラメータはシンボルが明るい背景に暗く表示されるか、暗い背景に明るく表示されるかを決定します。
位置パターンの最小数外れ:
この結果では、以下のパラメーターに使用する値が返ります: 位置パターンの最小数.この結果は、新しいシンボル候補を生成するために可視化が必要な位置検知パターン数を表します。
小モジュールに対してロバスト外れ:
この結果では、以下のパラメーターに使用する値が返ります: 小モジュールに対してロバスト.この結果は、非常に小さいモジュールサイズのデータコードのデコーディングのロバスト性を定義します。
規格に適合外れ:
この結果では、以下のパラメーターに使用する値が返ります: 規格に適合.この結果は、サイズがモデル制限に合わないシンボルを読み取る際のツールの挙動を制御します。
利用できるクワイエットゾーン外れ:
この結果では、以下のパラメーターに使用する値が返ります: 利用できるクワイエットゾーン.このパラメータは、読み取り可能でも、そのクワイエットゾーンに欠陥があるシンボル検出時のツールの挙動を制御します。
最大コードバージョン外れ:
この結果では、以下のパラメーターに使用する値が返ります: 最大コードバージョン.この結果は、最大シンボルバージョンを定義します。
最小コードバージョン外れ:
この結果では、以下のパラメーターに使用する値が返ります: 最小コードバージョン.この結果は、最大シンボルバージョンを定義します。
