IDVerify
- 返される値はすべて、参照元の IDVerify 構造体から取得され、VerifyIDCode 関数の作成時にスプレッドシートに挿入されます。
- ReadIDCode 関数は、In-Sight ファームウェア 4.x.x を搭載した In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行する In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
- レガシー関数である ReadIDCode 関数の代わりに ReadIDMax 関数を使用することを推奨します。ReadIDMax 関数には拡張性能機能が搭載されています。
- VerifyIDCode 関数が ReadIDMax 関数を参照する場合、必要に応じてインデックスを使用して、ReadIDMax 関数の結果テーブルからインデックス付き文字列を参照することができます。
- ReadIDMax 関数の場合、次の関数をサポートするために、[照合] パラメータを有効にする必要があります。
- ReadIDCode 関数の場合、次の関数をサポートするために、[アルゴリズム] パラメータを参照元の ReadIDCode 関数で有効にする必要があります。これらの関数は、Data Matrix、QR コード、またはポスタルPOSTNET、PLANET、UPU 4-State、Australia Post 4-State、Japan Post 4-State、USPS OneCode
4-Stateのシンボルのみで使用できます。
汎用データアクセス関数
関数 | 説明 |
---|---|
|
選択した測定を基に、シンボルの全体的な品質のグレードを返します。 |
GetHigh(ID 照合,[インデックス]) |
シンボルの高さを返します。 |
GetWide(ID 照合,[インデックス]) |
シンボルの幅を返します。 |
GetRow(ID 照合,[インデックス]) |
バーコードの左上隅の行座標、または 2D シンボルのインデックス付き (0 ~ 3) ファインダパターン頂点の列座標をピクセル単位で返します。 注 :
|
GetCol(ID 照合,[インデックス]) |
バーコードの左上隅の列座標、または 2D シンボルのインデックス付き (0 ~ 3) ファインダパターン頂点の列座標をピクセル単位で返します。 注 :
|
GetAngle(ID 照合,[インデックス]) |
シンボルの角度を返します。 |
選択した測定方法で定義したシンボルの変調を返します。ISO 15415 または AIM-DPM 測定のいずれかを VerifyIDCode 関数で有効にする必要があります。 注 :
Data Matrix ECC 200 シンボルではないシンボルの場合、Get2DModulation は #ERR を返します。
|
|
ReadIDCode の失敗に関する情報を提供するために、診断文字列を返します。照合されているコードの種類に応じて、グリッドサイズ、極性、解像度、ECC レベル、および場合によってはコードの種類も返されます。 |
|
ReadIDCode の失敗に関する情報を提供するために、診断コードを返します。 |
ISO 16022/18004 データアクセス関数
関数 | 説明 |
---|---|
ISO 15415 が選択された場合、シンボルコントラスト測定結果を返します。これは、前景と背景のグレースケール階調間の割合の差です。
AIM-DPM (プロセス管理または契約適合性のいずれか) が選択された場合、シンボルコントラスト測定を返します。これは、明分布と暗分布の平均の間の差が明分布の平均の割合として計算されます。AIM-DPM 規格では、明分布が ± 8% の許容差範囲内で 78 パーセントになるように、画像を取り込む必要があります。
|
|
2D シンボルの印刷太り測定水平および垂直の印刷拡張が個別に計算され、低い方の得点が返されます。結果を返します。
|
|
2D シンボルの水平寸法の印刷太りを返します。
|
|
2D シンボルの垂直寸法の印刷太りを返します。
|
|
2D シンボルの軸の歪み度合い測定の結果を返します。
|
|
シンボルが適切にデコードされたかどうかを示します。
|
|
2D シンボルの未使用誤り訂正測定の結果 (%) を返します。
|
ISO 15415/AIM-DPM データアクセス関数
関数 | 説明 |
---|---|
選択した測定方法で定義したシンボルの変調を返します。ISO 15415 または AIM-DPM 測定のいずれかを VerifyIDCode 関数で有効にする必要があります。 注 :
Data Matrix ECC 200 シンボルではないシンボルの場合、Get2DModulation は #ERR を返します。
|
|
ISO 15415 が選択された場合、シンボルコントラスト測定結果を返します。これは、前景と背景のグレースケール階調間の割合の差です。
AIM-DPM (プロセス管理または契約適合性のいずれか) が選択された場合、シンボルコントラスト測定を返します。これは、明分布と暗分布の平均の間の差が明分布の平均の割合として計算されます。AIM-DPM 規格では、明分布が ± 8% の許容差範囲内で 78 パーセントになるように、画像を取り込む必要があります。
|
|
シンボルの ISO 15415 最大反射率を返します。ISO 15415 測定を VerifyIDCode 関数で有効にする必要があります。この測定は AIM-DPM 規格の一部ではありません。AIM-DPM が選択された場合は #ERR を返します。
|
|
シンボルの固定パターン損傷測定を返します。ISO 15415 または AIM-DPM 測定のいずれかを VerifyIDCode 関数で有効にする必要があります。固定パターン損傷の測定方法は、ISO 15415 と AIM-DPM では異なります。
|
|
シンボルのグリッドの歪み度合いを返します。ISO 15415 または AIM-DPM 測定のいずれかを VerifyIDCode 関数で有効にする必要があります。
|
|
2D シンボルの印刷太り測定水平および垂直の印刷拡張が個別に計算され、低い方の得点が返されます。結果を返します。15415 と AIM-DPM 双方で印刷太りをプロセス管理測定として分類します。両方とも、グレードマッピングを定義せず、シンボルのグレードの計算に使用しません。 注 :
|
|
2D シンボルの水平寸法の印刷太りを返します。
|
|
2D シンボルの垂直寸法の印刷太りを返します。
|
|
2D シンボルの軸の歪み度合い測定の結果を返します。
|
|
シンボルが適切にデコードされたかどうかを示します。
|
|
2D シンボルの未使用誤り訂正測定の結果 (%) を返します。
|
Cognex サプリメンタルデータアクセス関数
関数 | 説明 |
---|---|
2D シンボル (クワイエットゾーンを含む) のグレースケール背景の非均一性を返します。クワイエットゾーンのグレースケール階調が非均一で、モジュールがバイナリデータビット 0 を表すシンボルは、高品質と見なされます。
|
|
バイナリデータビット 1 または 0 を表すモジュールの二峰性特性を返します。モジュールのグレースケール階調は、AIM リファレンスのデコードアルゴリズムで定義されたサンプリンググリッドから抽出されます。
|
|
シンボルのパターン (タイミングパターンを含む) が AIM シンボルの仕様に適合する範囲の値を返します。特に、同色の隣接モジュールがどの程度きれいに実線を形成しているか、異なる色のモジュールが同じサイズかどうかを測定します。この測定の値が低い場合、AIM リファレンスのデコードアルゴリズムによるシンボルの位置特定ステップが成功する可能性が低くなります。この関数は、予測されるバイナリデータビット 0 または 1 を表す、ファインダパターン (タイミングパターンを含む) 内にあるモジュールの数の比率も測定します。
|
|
ドット刻印されたシンボルのファインダパターンが AIM 仕様にどのくらい適合しているかを示す値を返します。
|
|
3x3 Sobel エッジ検出から取得したエッジ強度と画像コントラストを比較して、画像のエッジのシャープネス値を返します。シャープネス値が高い画像は、焦点がよく合っていて高品質と見なされます。
|
|
シンボルが画像全体の中で明瞭かどうかを示します。画像の最小および最大グレースケール階調の中間にグローバルしきい値があって、背景から明瞭に区別できるシンボルは、高品質と見なされます。
|
IAQG/AS-9132 データアクセス関数
関数 | 説明 |
---|---|
GetIAQGOverallGrade(ID 照合,[インデックス]) |
GetPercDotOSFailGrade、GetPercDotPositionFailGrade、GetDistortionAngleGrade の最小限の抽出されたグレードを使って、IAQG 9132 仕様に従った全体的なシンボルのグレードを返します。 |
シンボル X 軸と Y 軸の垂直からの偏差を度単位で返します。
|
|
角度の歪みの IAQG 9132 グレードを返します。
|
|
シンボル内のセルの中央が、予測された位置にどのくらい適切に配置されたかを示す割合を返します。 注 : この関数は、ドット刻印されたデータマトリックスシンボルを検証するときにだけ適用されます。
|
|
予測されたセルの直径の割合として、セルの直径の平均を返します。 注 : この関数は、ドット刻印されたデータマトリックスシンボルを検証するときにだけ適用されます。
|
|
予測されたセルのサイズの割合として、セルの幅と高さの平均的な差を返します。 注 : この関数は、ドット刻印されたデータマトリックスシンボルを検証するときにだけ適用されます。
|
|
ドットのサイズまたは楕円率の範囲のいずれかから外れた、シンボル内の ON セルの割合を返します。 |
|
ドットのサイズまたは楕円率の範囲から外れた ON セルの割合について IAQG 9132 グレードを返します。値が 2% を上回る場合、この測定は不合格 (0) グレードです。上回らない場合、合格 (4) です。 |
|
位置の許容差範囲を超えた、シンボル内の ON セルの割合を返します。 |
|
位置の許容差範囲を超えた ON セルの割合について IAQG 9132 グレードを返します。
|
|
ドット位置のシフトエラーの標準偏差を返します。 注 : この関数は、ドット刻印されたデータマトリックスシンボルを検証するときにだけ適用されます。
|
|
すべてのセルの直径の標準偏差を返します。 注 : この関数は、ドット刻印されたデータマトリックスシンボルを検証するときにだけ適用されます。
|
|
セルの幅と高さの間の標準偏差を返します。 注 : この関数は、ドット刻印されたデータマトリックスシンボルを検証するときにだけ適用されます。
|
郵便番号データアクセス関数
関数 | 説明 |
---|---|
GetBarPitch(ID 照合,[インデックス]) |
ポスタルPOSTNET、PLANET、UPU 4-State、Australia Post 4-State、Japan Post 4-State、USPS OneCode |
GetBarSkew(ID 照合,[インデックス]) |
ポスタルバーコードのバーの平均スキューを返します。 |
GetBarSpace(ID 照合,[インデックス]) |
ポスタルバーコードのバー間の平均間隔を返します。 |
GetBarVoid(ID 照合,[インデックス]) |
ポスタルバーコードのバーの平均空間 (インクのない領域) を返します。 |
GetBarHeight(ID 照合,[インデックス]) |
ポスタルバーコードのバーの指定された種類の平均高さを返します (インデックス入力値: 0 = ショート/タイミング、1 = アセンダ、2 = ディセンダ、3 = トール/フル)。 |
GetBarWidth(ID 照合,[インデックス]) |
ポスタルバーコードのバーの平均幅を返します。 |
GetBaselineShift(ID 照合,[インデックス]) |
ポスタルバーコードのベースラインからのバーの平均シフトを返します。 |
GetBGReflectance(ID 照合,[インデックス]) |
背景の平均反射率を返します。 |
GetClearanceBottom(ID 照合,[インデックス]) |
コード下部に対する間隔 (クワイエットゾーン) を返します。 注 : シンボルが適切にデコードされた場合にのみ有効です。
|
GetClearanceLeft(ID 照合,[インデックス]) |
コード左に対する間隔 (クワイエットゾーン) を返します。 注 : シンボルが適切にデコードされた場合にのみ有効です。
|
GetClearanceRight(ID 照合,[インデックス]) |
コード右に対する間隔 (クワイエットゾーン) を返します。 注 : シンボルが適切にデコードされた場合にのみ有効です。
|
GetClearanceTop(ID 照合,[インデックス]) |
コード上部に対する間隔 (クワイエットゾーン) を返します。 注 : シンボルが適切にデコードされた場合にのみ有効です。
|
GetContrast(ID 照合,[インデックス]) |
シンボルコントラスト測定結果を返します。これは、前景と背景のグレースケール階調間の割合の差です。 |
GetMaxBarHeight(ID 照合,[インデックス]) |
ポスタルバーコードのバーの指定された種類の最大高さを返します (インデックス入力値: 0 = ショート/タイミング、1 = アセンダ、2 = ディセンダ、3 = トール/フル)。 |
GetMaxBarPitch(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最大ピッチを返します。 |
GetMaxBarSkew(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最大スキューを返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetMaxBarSpace(ID 照合,[インデックス]) |
ポスタルバーコードのバー間の最大間隔を返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetMaxBarVoid(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最大空間 (インクのない領域) を返します。 |
GetMaxBarWidth(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最大幅を返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetMaxBaselineShift(ID 照合,[インデックス]) |
ポスタルバーコードのベースラインからのバーの最大シフトを返します。 |
GetMaxBGReflectance(ID 照合,[インデックス]) |
背景の最大反射率を返します。 |
GetMaxContrast(ID 照合,[インデックス]) |
(グレースケール階調における) 前景と背景間の最大コントラストを返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetMaxOverInkSize(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最大オーバーインクサイズを返します。 |
GetMinBarHeight(ID 照合,[インデックス]) |
ポスタルバーコードのバーの指定された種類の最低高さを返します (インデックス入力値: 0 = ショート/タイミング、1 = アセンダ、2 = ディセンダ、3 = トール/フル)。 |
GetMinBarPitch(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最小ピッチを返します。 |
GetMinBarSpace(ID 照合,[インデックス]) |
ポスタルバーコードのバー間の最小間隔を返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetMinBarVoid(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最小空間 (インクのない領域) を返します。 |
GetMinBarWidth(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最小幅を返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetMinBarSkew(ID 照合,[インデックス]) |
ポスタルバーコードのバーの最小スキューを返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetMinBaselineShift(ID 照合,[インデックス]) |
ベースラインからのバーの最小シフトを返します。 |
GetMinBGReflectance(ID 照合,[インデックス]) |
背景の最小反射率を返します。 |
GetMinContrast(ID 照合,[インデックス]) |
(グレースケール階調における) 前景と背景間の最小コントラストを返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetMinOverInkSize(ID 照合,[インデックス]) |
バーの最小オーバーインクサイズを返します。 |
GetModulation(ID 照合,[インデックス]) |
ポスタルバーコードの平均コントラストに対する最小エッジレスポンス (ECMin) の比率を返します。 |
GetNBars(ID 照合,[インデックス]) |
ポスタルバーコードで検出されるバーの数を返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetOneBarBaselineShift(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーのベースラインシフトを返します。 |
GetOneBarBGReflectance(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーの背景反射率を返します。 |
GetOneBarCol(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーの列番号を返します。2 State コードのPOSTNET と PLANET の場合、バーの位置は、バーの下部エッジの中央になります。4 State コードのUPU 4-State、USPS OneCode 4-State、Japan Post 4-State、Australia Post 4-State の場合、これはバーの T エレメントの中央になります。 |
GetOneBarContrast(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーのコントラストを返します。 |
GetOneBarHeight(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーの高さを返します。 |
GetOneBarOverInkSize(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーのオーバーインクサイズを返します。 |
GetOneBarPitch(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーのピッチを返します。 |
GetOneBarRow(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーの行番号を返します。2 State コードのPOSTNET と PLANET の場合、バーの位置は、バーの下部エッジの中央になります。4 State コードのUPU 4-State、USPS OneCode 4-State、Japan Post 4-State、Australia Post 4-State の場合、これはバーの T エレメントの中央になります。 |
GetOneBarSkew(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーのスキューを返します。 |
GetOneBarSpace(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーの間隔を返します。 |
GetOneBarType(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーの種類を返します (出力値: 0 = ショート/タイミング、1 = アセンダ、2 = ディセンダ、3 = トール/フル)。 注 : パラメータのインデックス値は、ポスタルバーコードの個々のバーを参照し、出力値は個々のバーの種類を示します。
|
GetOneBarVoid(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーの空間を返します。 |
GetOneBarWidth(ID 照合, [インデックス]) |
ポスタルバーコードのインデックス付きバーの幅を返します。 |
GetOverInkSize(ID 照合,[インデックス]) |
ポスタルバーコードのバーの平均オーバーインクサイズを返します。 |
GetSDevBarHeight(ID 照合,[インデックス]) |
ポスタルバーコードのバーの指定された種類の高さの標準偏差を返します (インデックス入力値: 0 = ショート/タイミング、1 = アセンダ、2 = ディセンダ、3 = トール/フル)。 |
GetSDevBarPitch(ID 照合,[インデックス]) |
ポスタルバーコードのバーのピッチの標準偏差を返します。 |
GetSDevBarSkew(ID 照合,[インデックス]) |
ポスタルバーコードのバーのスキューの標準偏差を返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetSDevBarSpace(ID 照合,[インデックス]) |
ポスタルバーコードのバーの間隔の標準偏差を返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetSDevBarVoid(ID 照合,[インデックス]) |
ポスタルバーコードのバーの空間 (インクのない領域) の標準偏差を返します。 |
GetSDevBarWidth(ID 照合,[インデックス]) |
ポスタルバーコードのバーの幅の標準偏差を返します。 注 : この関数は、In-Sight ファームウェア 4.x.x を実行している In-Sight ビジョンシステムでのみ使用可能です。In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムでは使用できません。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
|
GetSDevBaselineShift(ID 照合,[インデックス]) |
ベースラインからのバーのシフトの標準偏差を返します。 |
GetSDevBGReflectance(ID 照合,[インデックス]) |
背景反射率の標準偏差を返します。 |
GetSDevOverInkSize(ID 照合,[インデックス]) |
バーのオーバーインクサイズの標準偏差を返します。 |
GetVerifyDecoded(ID 照合,[インデックス]) |
シンボルが適切にデコードされたかどうかの結果を返します (出力値: 0 = 不成功、1 = 成功)。 |