FindPatMaxRedLine

画像データ構造体を含んだスプレッドシートセルを参照するように指定します。デフォルトでは、このパラメータは、AcquireImage 画像データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールのグラフィックス関数や、座標補正関数により返された、そのほかの画像データ構造体も参照できます。

フィクスチャ入力、またはビジョンツール関数の画像座標系の出力に関連するサーチ領域を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。

デフォルト設定は画像の左上隅で、(0, 0, 0) になります。

これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。変換および回転可能な矩形の画像領域を作成します。このパラメータを選択して、プロパティシートのツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。

このパラメータは、Annulus、Circle、Region、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、EditRegion、または Mask を含んだスプレッドシートセルを参照できます。このパラメータを使用すると、関数は [領域] と [フィクスチャ] の設定を無視し、参照先領域で指定された画像領域を検査します。EditCompositeRegion 関数コントロールを参照している場合は、検査領域がさまざまな形状の混合となることがあります。合成領域内の各形状は、検査領域に対して加算または減算 (マスキング) されるように割り当てることができます。

このパラメータは、TrainPatMaxRedLine 関数によって返される有効な パターン データ構造体を含むスプレッドシートのセルを参照している必要があります。

返される一致したパターンの最大数を指定します (1 ～ 1000、デフォルト = 1)。

有効なインスタンスの最も低い得点である、アクセプトしきい値を指定します。一致する可能性がある得点は、アクセプトしきい値よりも大きな値である必要があります。得点がアクセプトしきい値よりも大きな値でない場合は、その一致した得点は返されません　(0 ～ 100、デフォルト = 50)。

登録パターンに対して、色が反転した一致特徴を含む一致を検出可能かどうかを指定します。

極性を無視すると、PatMax が検出するパターンの種類が増加します。下記の図は、一致する極性とミスマッチの極性の例を示しています。PatMaxRedLine 関数で極性を無視するように設定した場合、図に示されているすべてのパターンが検出されます。PatMaxRedLine 関数で極性を考慮するように設定した場合は、下の行のパターンは検出されないことがあります。または、検出されても、上の行のパターンよりも低い得点が割り当てられる場合があります。

精度/信頼性と実行速度の間のトレードオフを指定します。

欠落している、またはふさがれているパターン特徴によって、レスポンス得点が減少するかどうかを指定します。

有効なインスタンスの最も低いコントラストを指定します。一致する可能性があるコントラストは、コントラストしきい値よりも大きな値である必要があります。コントラストがコントラストしきい値よりも大きな値でない場合は、その一致したインスタンスは考慮されません (0 ～ 100、デフォルト = 0)。FindPatMaxRedLineColor と FindPatMaxRedLine のコントラスト値は、登録パターン内の特徴とサーチ画像内の一致する特徴との間のコントラスト差をパーセンテージで表した、「相対」コントラストが報告されます。よって、特徴のコントラストがパターンコントラストと同じまたはより高い場合、報告されるコントラストは ～100 となります。パターンコントラストが特徴のコントラストを超えた場合、報告されるコントラストは <100 となります。

登録されたパターンに対して回転またはスケーリングされたパターンを検出するための設定を指定します。

おおよそ同じ X、Y 位置にある、複数のオーバーラップしているパターン間の予想される位置の差を、登録されたパターンのサイズの割合 (%) で指定します　(0 ～ 100、デフォルト = 70)。

関数がパターンをサーチする時間をミリ秒単位で指定します (0～30000、デフォルト = 5000、タイムアウトの無効化)。この時間が経過すると、処理は中止され、#ERR が返されます。

画像上のグラフィックスオーバーレイの表示モードを指定します。