FindPatMaxRedLineColor
登録されたパターンに基づいて、カラー画像内の対象物を検出します。FindPatMaxRedLineColorTrainPatMaxRedLineColor 関数のパターン構造体から登録されたパターンに基づいて、カラー画像内のパターンを検出します。
-
TrainPatMaxRedLineColor 関数と FindPatMaxRedLineColor 関数は、In-Sight ファームウェア 5.6.0 以上を実行している In-Sight 7000 Gen2 シリーズのカラービジョンシステムおよび In-Sight 8000 シリーズのカラービジョンシステムだけで使用できます。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
- グレースケール画像を使用する場合は、TrainPatMaxRedLine 関数と FindPatMaxRedLine 関数を使用する必要があります。グレースケール画像 (ColorToGreyscaleFilter の出力など) に対して TrainPatMaxRedLineColor 関数と FindPatMaxRedLineColor 関数を使用しようとすると、#ERR が返されます。
- FindPatMaxRedLineColor 関数は TrainPatMaxRedLineColor 関数を参照する必要があります。別の関数 (TrainPatMaxRedLine 関数など) を参照すると、#ERR が返されます。
FindPatMaxRedLineColorの入力パラメータ
Syntax:FindPatMaxRedLineColor(画像,フィクスチャ.行,フィクスチャ.列,フィクスチャ.角度,サーチ領域.X,サーチ領域.Y,サーチ領域.高さ,サーチ領域.幅,サーチ領域.角度,サーチ領域.カーブ,外部定義領域,パターン,検出する数,アクセプトしきい値、パターン,アクセプトしきい値、カラー,精度モード,クラッタ,コントラストしきい値,許容値.開始角度,許容値.終了角度,許容値.開始スケール,許容値.終了スケール,XY のオーバーラップ,詳細設定.粗粒度パーセンテージの使用,詳細設定.粗粒度アクセプトパーセンテージ,タイムアウト,グラフィックス表示)
|
画像データ構造体を含んだスプレッドシートセルを参照するように指定します。デフォルトでは、このパラメータは、AcquireImage 画像データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールのグラフィックス関数や、座標補正関数により返された、そのほかの画像データ構造体も参照できます。 注 : このパラメータはカラー画像を参照している必要があります。
|
|||||||||||||||||||||||||
|
フィクスチャ入力、またはビジョンツール関数の画像座標系の出力に関連するサーチ領域を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。 デフォルト設定は画像の左上隅で、(0, 0, 0) になります。
|
|||||||||||||||||||||||||
|
これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。変換および回転可能な矩形の画像領域を作成します。このパラメータを選択して、プロパティシートのツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
|
|||||||||||||||||||||||||
|
このパラメータは、Annulus、Circle、Region、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、EditRegion、または Mask を含んだスプレッドシートセルを参照できます。このパラメータを使用すると、関数は [領域] と [フィクスチャ] の設定を無視し、参照先領域で指定された画像領域を検査します。EditCompositeRegion 関数コントロールを参照している場合は、検査領域がさまざまな形状の混合となることがあります。合成領域内の各形状は、検査領域に対して加算または減算 (マスキング) されるように割り当てることができます。 注 : このパラメータが外部定義領域の参照として設定されている場合に、この関数の内部領域を使用するには、セル参照に値 0 を入力し、このパラメータを手動で 0 に設定する必要があります。それ以外の場合、この関数は引き続き外部定義領域を参照します。
|
|||||||||||||||||||||||||
|
このパラメータは、TrainPatMaxRedLineColor 関数によって返される有効な パターン データ構造体を含むスプレッドシートのセルを参照している必要があります。 |
|||||||||||||||||||||||||
|
返される一致したパターンの最大数を指定します (1 ～ 1000、デフォルト = 1)。 |
|||||||||||||||||||||||||
|
有効なインスタンスの最も低い得点である、パターンのアクセプトしきい値を指定します。一致する可能性がある得点は、アクセプトしきい値よりも大きな値である必要があります。得点がアクセプトしきい値よりも大きな値でない場合は、その一致した得点は返されません (0 ～ 100、デフォルト = 50)。 |
|||||||||||||||||||||||||
|
有効なインスタンスの最も低い得点である、カラーのアクセプトしきい値を指定します。一致する可能性がある得点は、アクセプトしきい値よりも大きな値である必要があります。得点がアクセプトしきい値よりも大きな値でない場合は、その一致した得点は返されません (0 ～ 100、デフォルト = 85)。 |
|||||||||||||||||||||||||
|
これを有効にすると、照明の違いによって生じるカラーの変化で許容値が大きくなります。 注 : TrainPatMaxRedLineColor 関数の [マッチカラー] パラメータが [マッチなし] に設定されている場合、このパラメータは無効になります。
 照明に対する許容の例
カラーマッチは、非均一な照明および制御できない照明の変化の影響を受けやすくなっています。[照明に対する許容] パラメータを有効にすると、色の得点が照明のために登録されている色と異なる場合に、色の得点がより高くなります。つまり、同じ色か、わずかに暗い、または明るい色になります。 例えば、カプセル薬のパッケージで、照明は均一ではありません。左上隅にあるカプセル薬は、中央にあるカプセル薬より暗くなっています。
左上のカプセル薬を登録する場合、[照明に対する許容] オプションを有効にしないと、中央近くのカプセル薬は得点が低くなります。このパラメータを有効にすると、得点が増加してより多くのマッチが検出されます。
|
|||||||||||||||||||||||||
|
精度/信頼性と実行速度の間のトレードオフを指定します。
|
|||||||||||||||||||||||||
|
欠落している、またはふさがれているパターン特徴によって、レスポンス得点が減少するかどうかを指定します。
|
|||||||||||||||||||||||||
|
有効なインスタンスの最も低いコントラストを指定します。一致する可能性があるコントラストは、コントラストしきい値よりも大きな値である必要があります。コントラストがコントラストしきい値よりも大きな値でない場合は、その一致したインスタンスは考慮されません (0 ～ 100、デフォルト = 0)。FindPatMaxRedLineColor と FindPatMaxRedLine のコントラスト値は、登録パターン内の特徴とサーチ画像内の一致する特徴との間のコントラスト差をパーセンテージで表した、「相対」コントラストが報告されます。よって、特徴のコントラストがパターンコントラストと同じまたはより高い場合、報告されるコントラストは ～100 となります。パターンコントラストが特徴のコントラストを超えた場合、報告されるコントラストは <100 となります。 注 : FindPatMaxRedLineColor と FindPatMaxRedLine のコントラストは、FindPatMaxPatterns のコントラストとは異なります。FindPatMaxPatterns では、サーチ ROI 内の「絶対」画像コントラストがグレースケール値で報告されます。
|
|||||||||||||||||||||||||
|
登録されたパターンに対して回転またはスケーリングされたパターンを検出するための設定を指定します。 注 : 許容値がハードリミットの場合、つまり、指定の許容値外で見つかった結果はスプレッドシートに返されません。
|
|||||||||||||||||||||||||
|
おおよそ同じ X、Y 位置にある、複数のオーバーラップしているパターン間の予想される位置の差を、登録されたパターンのサイズの割合 (%) で指定します (0 ～ 100、デフォルト = 70)。 注 : この値を高くすることによって、同じパターンが複数オーバーラップしている一致部分を検出することができます。
|
|||||||||||||||||||||||||
|
|
|
||||||||||||||||||||||||
|
関数がパターンをサーチする時間をミリ秒単位で指定します (0～30000、デフォルト = 5000、タイムアウトの無効化)。この時間が経過すると、処理は中止され、#ERR が返されます。 |
|||||||||||||||||||||||||
|
画像上のグラフィックスオーバーレイの表示モードを指定します。
|
|||||||||||||||||||||||||
FindPatMaxRedLineColor出力
| 戻り値 | 得点によってソートされたモデルとパターンレスポンスのリストを含むパターンデータ構造体。入力パラメータが無効である場合、または一致パターンが検出されない場合は #ERR を返します。 |
| 結果 | 初めてFindPatMaxRedLineColorセルに挿入すると、スプレッドシートに結果テーブルが作成されます |
FindPatMaxRedLineColorデータアクセス関数
次のデータアクセス関数がスプレッドシートに自動挿入され、結果テーブルが作成されます。
| 行 | GetRow(パターン, インデックス) | パターン位置の行座標 | |||||||
| 列 | GetCol(パターン, インデックス) | パターン位置の列座標 | |||||||
| 角度 | GetAngle(パターン, インデックス) | パターン位置の角度 | |||||||
| スケール | GetScale(パターン, インデックス) | 登録されたモデルと比較したパターンのサイズ (モデルサイズのパーセントで表示) | |||||||
| 得点 | GetScore(パターン, インデックス) | パターンのレスポンス全体の得点 (0 ～ 100) | |||||||
| カラー得点 | GetAngle(パターン, インデックス) |
カラー得点の値 (0 ～ 100) 注 :
参照先 TrainPatMaxRedLineColor の [カラーマッチ] パラメータが [マッチなし] に設定されている場合、GetColorScore 関数は 100.000 を返します。
|
パターンの得点とカラー得点
FindPatMaxRedLineColor 関数によって 2 つの得点の値が自動的にスプレッドシートに挿入されます。[得点] と [カラー得点] です。[得点] は、「パターン」の得点を返し、検出されたパターンが登録されているパターンとどの程度似ているかを示します。これは色とは無関係です。[カラー得点] は、検出されたパターンの色が登録されている色とどの程度似ているかを示します。
[カラー得点] の値が低いと、[得点] の値には影響しません。次の例では、インデックスの 2 つのパターンが低い [カラー得点] を示していますが、[得点] の値は非常に高いままです。[得点] または [カラー得点] のいずれかが、その [アクセプトしきい値] ([アクセプトしきい値、パターン] または [アクセプトしきい値、カラー]) に該当する場合、このパターンはマッチとはみなされず、返されることはありません。
| 登録パターン |
|
| サーチ結果 |
|
