TrainPatMaxRedLine
パターンを抽出して登録します。FindPatMaxRedLine 関数と共に使用するために、画像から検出する対象物の登録済み (内部) 幾何学記述です。
- In-Sight ファームウェア 5.5.0 以降、ツールのアルゴリズムが変更され、条件によっては、より正確な結果を返すようになり、実行時間が短縮されました。
- この変更により、In-Sight ファームウェア 5.5.0 以降で作成されたこのツールを含むジョブを、ファームウェアバージョン 5.4.x 以前を搭載した In-Sight ビジョンシステムにロードしようとすると、エラーメッセージが表示されます。
- この関数は、In-Sight ファームウェア 5.1.0 以上を実行している In-Sight ビジョンシステムだけで使用できます。モデル一覧およびサポートされているファームウェアバージョンについては、「ファームウェアバージョン」を参照してください。
- 登録されたパターンは、デフォルトのパターン領域 (320 × 440) を使用する場合には約 1MB を消費しますが、登録済みのパターンのサイズに応じてパターンのサイズは大きく変わります。
TrainPatMaxRedLineの入力パラメータ
Syntax:TrainPatMaxRedLine(画像,フィクスチャ.行,フィクスチャ.列,フィクスチャ.角度,パターン領域.X,パターン領域.Y,パターン領域.高さ,パターン領域.幅,パターン領域.角度,パターン領域.カーブ,外部定義領域,パターン原点.行オフセット,パターン原点.列オフセット,粗粒度自動選択,微粒度自動選択,粗粒度,微粒度,特徴しきい値,登録画像の再使用,タイムアウト,表示)
画像データ構造体を含んだスプレッドシートセルを参照するように指定します。デフォルトでは、このパラメータは、AcquireImage 画像データ構造体を含むセル A0 を参照しています。また、このパラメータは、ビジョンツールのグラフィックス関数や、座標補正関数により返された、そのほかの画像データ構造体も参照できます。 |
|||||||||||||
フィクスチャ入力、またはビジョンツール関数の画像座標系の出力に関連する対象領域 (ROI) を定義します。フィクスチャに関連する ROI を設定すると、フィクスチャが回転または移動した場合に、フィクスチャに対応して ROI を確実に回転または移動できます。 デフォルト設定は画像の左上隅で、(0, 0, 0) になります。
|
|||||||||||||
これは対象領域 (ROI) とも呼ばれ、解析の対象となる画像の領域を表します。変換および回転可能な矩形の画像領域を作成します。このパラメータを選択して、プロパティシートのツールバーにある [領域の最大化] ボタンを押すと、画像全体が対象になるように領域が自動的に拡張されます。
|
|||||||||||||
注 : [フィクスチャ] および [領域] パラメータは、画像の範囲内で定義されている必要があります。画像の範囲内で定義されていない場合、この関数は #ERR を返します。
|
|||||||||||||
このパラメータは、Annulus、Circle、Region、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、EditRegion、または Mask を含んだスプレッドシートセルを参照できます。このパラメータを使用すると、関数は [領域] と [フィクスチャ] の設定を無視し、参照先領域で指定された画像領域を検査します。EditCompositeRegion 関数コントロールを参照している場合は、検査領域がさまざまな形状の混合となることがあります。合成領域内の各形状は、検査領域に対して加算または減算 (マスキング) されるように割り当てることができます。 注 : このパラメータが外部定義領域の参照として設定されている場合に、この関数の内部領域を使用するには、セル参照に値 0 を入力し、このパラメータを手動で 0 に設定する必要があります。それ以外の場合、この関数は引き続き外部定義領域を参照します。
|
|||||||||||||
登録パターンの原点の行および列を、登録領域の中心からのオフセットとして指定します。
|
|||||||||||||
粗粒度サーチフェーズで使用する画像粒度を自動的に指定するかどうかを指定します。粗粒度は、大きな特徴を検出して、画像内の大まかなパターン一致を実行時に迅速に検出するために使用されます。0 = OFF1 = ON (デフォルト)![]() |
|||||||||||||
微粒度自動選択 |
微粒度サーチフェーズで使用する画像粒度を自動的に指定するかどうかを指定します。微粒度は、小さな特徴を検出して、パターン位置を正確に判定するために使用されます。
|
||||||||||||
粗粒度 |
粗粒度をピクセル単位で指定します。粗粒度は、大きな特徴を検出して、画像内の大まかなパターン一致を実行時に迅速に検出するために使用されます (1 ~ 30、デフォルト = 4)。 注 : [粗粒度自動選択] パラメータはデフォルトで有効になっています。このパラメータを有効にするには [粗粒度自動選択] パラメータを無効にします。
|
||||||||||||
微粒度 |
微粒度をピクセル単位で指定します。微粒度は、小さな特徴を検出して、パターン位置を正確に判定するために使用されます (1~10、デフォルト = 1)。 注 :
|
||||||||||||
特徴しきい値 |
登録した特徴の最小コントラストを指定します。他の低コントラストの特徴を登録する場合、値を下げてください。無視するには、値を上げてください (1 ~ 100、20 = デフォルト)。 |
||||||||||||
登録画像の再使用 |
パターンの登録に使用された画像を保存し、[パターンの設定] パラメータ ([パターン原点]、[粗粒度自動選択]、[微粒度自動選択]、[粗粒度]、[微粒度]、または [ノイズしきい値]) を変更するときに使用するかどうかを指定します。
|
||||||||||||
関数が有効なパターンをサーチする時間をミリ秒単位で指定します (0~30000、デフォルト = 0、タイムアウトの無効化)。この時間が経過すると、処理は中止され、#ERR が返されます。 |
|||||||||||||
画像上のグラフィックスの表示モードを指定します。
|
TrainPatMaxRedLineの出力
戻り値 | 登録されたパターンを含んでいるパターンデータ構造体。入力パラメータが無効であれば #ERR を返します。次の取り込みで新しいパターンを誤って登録することを避けるために、この関数はデフォルトで無効に設定されています。 |
結果 | 初めてTrainPatMaxRedLine関数が初めてセルに挿入されると、登録状態が右隣のセルに自動的に表示されます。パターンを登録できない場合は #ERR が挿入されます。 |
TrainPatMaxRedLineデータアクセス関数
1 つのデータアクセス関数がスプレッドシートに自動挿入されます。
登録 | GetTrained(パターン) | パターンを登録できた場合には 1、登録できなかった場合には 0 を返します。 |