v2 エンジン（高速・多件ヒットに強い）を使う ImageSearchV2 / FindImageV2 系コマンドの初期値になります（コマンド引数で上書き可）。

項目

• デフォルト合格基準（%）

  テンプレートと画面の一致率の下限。この値以上を「見つかった」と判定します。

  • 例：50% → 類似に寛容（ヒットしやすいが誤検出リスク増）
  • 厳しめにしたい：70–85%
  • RDP/VNCや拡縮ありで粗い画：40–60%

• 一致の最大数

  一度の検索で返す候補の上限。大量に並ぶアイコンを扱う/「全件クリック」などで使います。

  • 例：1000（実質無制限に近い）
  • パフォーマンス優先：20–200（不要な候補を切る）
  • 1件だけ欲しい：1（最初の高スコアのみ）

使い分けの目安

• ローカルPCで精度重視：合格基準 75–85%／最大数 1–10
• RDP/VNC・圧縮で画質が落ちる：合格基準 45–65%／最大数 20–200
• 同種ボタンをまとめて拾う処理：合格基準 50–70%／最大数 100–1000（後段で座標や文脈で絞り込み）

<aside> 💡

ミニTIPS

• まずは高めの基準で試し、見つからないときだけ下げるのがセオリー。
• 多件ヒット運用では、取得後に領域・並び順・近傍テキストなどで追加フィルタを。
• 既定はプロジェクト全体に影響するので、画面ごとに違う場合はコマンド引数で調整してください。 </aside>