エンハンストサーチ ("enhanced") (JA)

4.2.5 エンハンストサーチ（以下、エンハンスト）

search2アルゴリズムと同様に、入力テンプレート画像またはイメージコレクションと合格率によって表されるコンポーネントをデスクトップ上で検索します。特徴マッチングの原理に基づいて設計されており、以下のような大幅な改善を実現します：

色の変化に対応する能力
わずかなサイズ変更や回転にも対応
インターネット接続不要（AIに依存しない）

「search2」アルゴリズムに対する欠点は以下の通りです：：

性能が低下する（通常2～4倍遅くなる）
合格率の低い値は幻覚を引き起こす可能性がある（存在しないコンポーネントを検出する）
古いLinuxシステム（Ubuntu 18やRHEL 8など）ではサポートされていません（今後有効化予定）

他の検索アルゴリズムとの互換性を維持するため、結果として得られた一致位置は、_SEARCH 接頭辞付きの変数群の形で呼び出し元スクリプトに公開されます。結果は常に類似度順にソートされ、最も一致度の高い位置が最上位に配置されます。

作成方法変数	説明
_SEARCH_MATCH_COUNT=<number>	オブジェクト検索によって特定された一致する位置の数。
_SEARCH_X<n>=<X-coordinate> _SEARCH_Y<n>=<Y-coordinate>	n番目のマッチ位置のX,Y座標。ここで「n」は1から_SEARCH_MATCH_COUNT値の範囲にある。
_SEARCH_X=<X-coordinate> _SEARCH_Y=<Y-coordinate>	最初の一致位置のX座標とY座標（_SEARCH_X_1 および _SEARCH_Y_1 の同義語）。

オプション

このメソッドは、ホスティングコマンドまたはJavaメソッド呼び出しを通じて指定された1つ以上の テンプレート画像 および/またはイメージコレクションを必要とします。。

“ passrate "パラメータは、テンプレート画像と画面上の対応位置との間に必要な最小類似度を指定します。デフォルト値は80%です。値が低いほど検索が曖昧になり、誤った一致（漠然と類似したコンポーネント）や幻影すら引き起こす可能性があります。

“ cmparea “パラメータはオプションで、省略された場合はデフォルトで全画面表示となります。

戻り値

このメソッドは、少なくとも1つの一致する位置が見つかった場合に呼び出しコマンド（メソッド呼び出し）が0（成功）を返し、それ以外の場合は1を返します。

使用例

JS

Compareto ok.png  method="enhanced" passrate="85"

if ({_EXIT_CODE} > 0) {
  Screenshot failure.png desc="Failed to find the OK button."
  Exit 1 desc="Failed to find the OK button."
} else {
  Mouse click to=x:{_SEARCH_X},y:{_SEARCH_Y}
}

OKボタンを見つけてクリックします。ボタンが見つからない場合は、終了スクリーンショットを撮り、終了コード1でスクリプトを終了します。