Tolerant Image Search

検索方法（アルゴリズム）により、デスクトップ上のテンプレート画像の出現箇所を特定し、一致した領域の左上隅の位置を返すことができます。これは、あるコンポーネントが画面上に表示されていることを確認し、最終的にその座標を使用するために効率的に使用することができます。アルゴリズム・パラメータの完全な仕様についてはImage Search specification.

このアルゴリズムは、いくつかの許容レベルを提供します。最初のものは、コマンドで提供される通過率パラメータです。デフォルト値の100%はピクセルの完全一致を検索する。より低い合格率の値は、異なる可能性のあるピクセルの相対数を定義する。例えば、テンプレートが 10x10 (=100pixels) で、パスレートが 95% に設定されている場合、このメソッドはテンプレートのピクセルと少なくとも 95 ピクセルが一致するすべての領域をデスクトップ画像から検索します。

2番目の許容範囲は画像の透明度に依存します。テンプレートに透明（アルファバイトがゼロに設定されている）または半透明（アルファ %26lt; 255）のピクセルが含まれている場合、画像検索時に比較されず、自動的に一致するとみなされます。

T-Plan Robot Enterprise version 2.1以降では、removebg,bgcolor,minalpha パラメータにより、背景色の自動透過をサポートしています。この機能がオン（removebg=true）の場合、画像検索アルゴリズムはテンプレート画像から背景色のピクセルをすべて取り除き、コンポーネントのベタ塗り部分のみを検索します。これにより、さまざまな背景に現れる可能性のあるオブジェクトの検索タスクを構築することができます。背景色のデフォルトは、テンプレート画像の一番最初のピクセルです。

画像の透明度は、サードパーティのツール（WindowsのCorrel DrawやWindows/Linux/UnixのGimpなど）を使って、画像に物理的に精緻化することもできます。

最後の許容度は、RGB分散許容度（パラメータ許容度）と呼ばれます。これはRGB距離に基づいています。これは 0 から 255 までの数値で、デスクトップピクセルの色の赤、緑、青の各成分が、対応するテンプレートピクセルと同等とみなすために、最大でどの程度異なるかを指定します。この値によって、例えばぼかしやハイライト、背景との合成の結果、ピクセルがわずかに変化している画像に対処することができます。この機能は、装飾テキストや一部の画像が一定にレンダリングされないFlashアプリケーションに不可欠です。許容値が高いほど、誤マッチの確率が高くなることに注意してください。ほとんどの場合、色の変更範囲に応じて [0, 100] の範囲に設定する必要があります。tolerance パラメータが指定されていない場合、デフォルト値はゼロとなり（画像検索環境設定でデフォルト値が変更されていない限り）、アルゴリズムは以前のバージョンと互換性のある正確なカラーマッチを使ってピクセルを比較します。

画像検索を行うコマンドは常に1（「見つからなかった」を意味する）か0（「少なくとも1つ一致した」を意味する）を返します。この値は、コマンド終了後に_EXIT_CODEvariableからアクセスできます。マッチした場所の数と座標は、コンテキスト変数(_SEARCH_MATCH_COUNT,_SEARCH_X,_SEARCH_Y)の形で提供されます。

画像検索コマンドができたら、それをテストスクリプトに組み込んで、その返り値をテストすることができる。最も典型的なスクリプトのコード例を以下に示す。これらのコード・スニペットは、スクリプトに挿入することができるので、自分でコードを書く必要はありません。editor#writing.

画像検索を使用して、テンプレート画像が画面に表示されるまでスクリプトの実行を中断します。画像検索が30秒以上失敗し続ける場合は、スクリーンショットを撮り、終了コードを1にしてスクリプトを終了する。
Waitfor match template="mytemplate.png" method="search"timeout=30s
if ( {_EXIT_CODE} > 0) {
Screenshot "failure.png" desc="Failed to find mytemplate.png"
Exit 1
}.
デスクトップからOKボタンを探してクリックする。ボタンが見つからない場合は、終了コード5でスクリプトを終了する。
比較対象ボタンOK.pngメソッド"検索"onfail="終了5"
マウスクリックto=x:{_SEARCH_X},y:{_SEARCH_Y}