ハートコア株式会社
HeartCore Robo Desktop 4.4 Docコレクション
GUIリファレンス
21/06/18

HeartCore Robo Desktop 4.4 CompareToコマンドウィンドウ

目次
1. CompareToコマンドウィンドウの概要
2. 画像検索機能

1. CompareToコマンドウィンドウの概要

このウィンドウでは、GUIを使用してCompareToスクリプトコマンドを簡単に作成し、アクティブエディタに挿入することができます。エディタ内の既存のCompareToコマンド上にキャレットがある間にウィンドウを開くと、ウィンドウはそのパラメータをロードし、コマンドを編集することができます。ウィンドウで定義されているフィールドと値の詳細については、../scripting/commref.html#compareto">Comparetoコマンドの仕様を参照してください。ウィンドウを開くには、Script - > Compareto Commandを選択するか、メインGUIメニューの対応するツールバーボタンをクリックします。既存のコマンドを編集するには、エディタでコマンドを右クリックし 、コンテキストポップアップメニューで[ プロパティ ] を選択します。

主要なウィンドウコンポーネント、テンプレートプロパティパネルは、WaitforコマンドScreenshotコマンドウィンドウでも使用される共有コンポーネントです。これは、テンプレート画像および/または画像コレクションのリストを定義し、画像比較パラメータを構成する一般的な方法を提供する。パネルは5つのコンポーネントで構成されています。

Comparetoコマンドウィンドウ
  1. テンプレート画像ファイルリストは、一つ以上のテンプレート画像や画像コレクション(画像付きのディレクトリ)のリストを作成することができます。左側の画像には、2つの画像を含む電卓という1つの画像コレクションのリストが表示されています。この  プラスアイコン  ボタンはファイルブラウザを開き、ファイルシステムから既存のイメージファイルまたはコレクションを選択できます。現在のデスクトップイメージから新しいテンプレートを作成するには、ブラウザの[ファイル名]フィールドにまだ終了していないファイル名を入力します。マイナスアイコン  ボタンは、リストから選択したテンプレートを削除します。プラスアイコンボタンは、選択したファイルを現在のリモートデスクトップイメージで書き換えます(これは、ダイアログが[OK]ボタンで閉じられた後にのみ行われます)。

    ファイルブラウザは、最初に_TEMPLATE_DIRスクリプト変数で定義されたテンプレートフォルダで開きます。この変数が定義されていない場合、パスはデフォルトでユーザー設定の値になります(言語設定グループを検索してください)。デフォルトのパスが設定されていない場合、テンプレートフォルダは最終的にデフォルトのユーザホームフォルダになります。

    矢印ボタン  プラスアイコン  と  プラスアイコン  テンプレートの順序を変更できます。一度に1つのテンプレートに対してイメージ比較が実行され、単一の一致が達成されたとき、またはテンプレートリストの最後に到達したときに停止すると、その順序がパフォーマンスに影響を及ぼす可能性があります。最高のパフォーマンスを得るためには、発生確率の高いテンプレートを先に配置します。
  2. ファイルリストコンポーネントの下のパネルには、合格率比較方法比較領域などの画像比較パラメータが含まれています。詳細は、CompareTo コマンドの仕様を参照してください。

    v2.1で提供されている興味深い拡張点は、画像検索パラメータ グループ内の これらのパラメータは、選択された方法に応じて動的に表示され、アルゴリズム固有の値を選択された画像比較方法に渡すことができます。この機能は現在、背景色の独立した比較を新たにサポートする画像検索だけで使用されています。特定のパラメータの詳細については、CompareTo コマンドの仕様を参照してください。これらのパラメータはテンプレートエディタでもサポートされている ため、テンプレートイメージエディタのヘルプトピックにも追加情報があります。
  3. [ 比較 ]ボタンを使用すると、ウィンドウで指定されたパラメータを使用して、現在選択されているテンプレート(一度に1つずつ)に対してイメージ比較を実行できます。[ RDイメージロード ]ボタンを使用してカスタムイメージがファイルからロードされた場合、このイメージに対して比較が実行されます。それ以外の場合、現在接続されているデスクトップが使用されます。

    この機能は、コマンドが期待どおりに機能することを確認するのに便利です。以前のファイルに保存されたデスクトップイメージとの比較をデバッグするためにも使用できます(これは 、2.2で提供されたStatic Image Clientの機能に似ています)。もし「検索」比較モジュールが指定されている場合には、個々のピクセルの不一致のレベルに対する比較をデバッグすることを可能にする付加的な機能がある。後の「イメージ検索機能」の章を参照してください。
  4. [ テンプレート編集 ]ボタンは、現在選択されているテンプレートを画像エディタで開き、それをトリミングすることができます。このウィンドウは、テンプレートプレビューコンポーネントのサムネイル画像をダブルクリックすることによっても開くことができます。イメージプレビューコンポーネントにはクロップされたイメージが表示されますが、テンプレートの編集ウィンドウでは再オープンされた場合にフルサイズイメージが常に表示され、必要に応じてクロップ領域を何度も編集できます。イメージは、ウィンドウがOKボタンで終了したときにのみ、実際にトリミングされてファイルに保存されます。
  5. [ 削除]ボタンをクリックすると、選択したテンプレートファイルがファイルシステムから削除されます。他のアクションとは異なり、このアクションは即座に実行されるため、注意して使用する必要があります。
  6. ボタンロードRDイメージを使用すると、ファイルからイメージをロードし、リモートデスクトップイメージではなく比較ボタンを使用してイメージ比較を実行できます。この機能は、自動テストの実行中など、過去に発生した失敗したイメージの比較のトラブルシューティングに役立ちます。スクリプトコマンドには影響しません。ダイアログを現在のリモートデスクトップイメージに戻すには、同じボタンをもう一度クリックします(カスタムイメージがロードされるとReset RD Imageが表示されるはずです)。単にダイアログを閉じて再度開く必要があります。
  7. [ 環境設定]ボタンは、CompareToコマンドの画像比較設定へのショートカットとして機能します。これらのパラメータは、WaitForおよびScreenshotコマンドと共有されます。
  8. 「環境設定」の横にある「ヘルプ」ボタンには、言語仕様の「画像比較機能」セクションが表示されます。
  9. テンプレートプレビューコンポーネントは、実際の寸法と一緒に選択されたテンプレート画像のサムネイル画像を示しています。画像がコンポーネントの表示領域に合っている場合は、スケーリングされず、上の図のテンプレートなどのフルサイズで表示されます。イメージをダブルクリックすると、イメージエディタが開きます(前述のテンプレートの編集ボタンと同様)。

2.画像​​検索機能

比較方法が "search2"、 "search"、 "object"、 "text"などの場所を生成するように設定されている場合、比較ボタンは追加の機能を提供します。少なくとも1つの一致がある場合、ウィンドウには、下に表示されているような座標のリストを含むメッセージボックスが表示されます。[ 一致を表示]ボタンを

画像検索結果

選択すると、リモートデスクトップイメージのコピー(または最終的に [ RDイメージロード ]ボタンを使用してロードされたイメージ)のウィンドウが開きます。次の例があります。 ウィンドウにはいくつかの重要な機能があります。コントロールの最初の行には、表示されたMatch(es)と呼ばれるドロップダウンが含まれています。

検索ヒットダイアログ 

テンプレートの場所(四角形)、リモートデスクトップ上に見つかったオブジェクトまたはテキストインスタンス。特定の一致を選択すると、対応する矩形が赤い枠線で強調表示されます([矩形の一致]チェックボックスがオフの場合を除く)。赤色がデスクトップの色と矛盾する場合、右の色のドロップダウンで色を設定できます。

2番目のコントロールの行はピクセルとピクセルの差分を扱います。この機能は画像検索(「検索」)方法に特有であり、他の方法では使用されません。合格率が100%未満の数値に設定されている場合、コントロールは選択した色の不一致ピクセルを表示します(デフォルトで緑色)。