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つのコンポーネントで構成されています。
テンプレート画像ファイルリストは、
一つ以上のテンプレート画像や画像コレクション(画像付きのディレクトリ)のリストを作成することができます。左側の画像には、2つの画像を含む電卓という1つの画像コレクションのリストが表示されています。この
ボタンはファイルブラウザを開き、ファイルシステムから既存のイメージファイルまたはコレクションを選択できます。現在のデスクトップイメージから新しいテンプレートを作成するには、ブラウザの
[ファイル名]
フィールドにまだ終了していないファイル名を入力します。
ボタンは、リストから選択したテンプレートを削除します。
ボタンは、選択したファイルを現在のリモートデスクトップイメージで書き換えます(これは、ダイアログが[OK]ボタンで閉じられた後にのみ行われます)。
ファイルブラウザは、最初に
_TEMPLATE_DIRスクリプト変数
で定義されたテンプレートフォルダで開きます。この変数が定義されていない場合、パスはデフォルトでユーザー設定の値になります(
言語
設定グループを検索してください)。デフォルトのパスが設定されていない場合、テンプレートフォルダは最終的にデフォルトのユーザホームフォルダになります。
矢印ボタン
と
テンプレートの順序を変更できます。一度に1つのテンプレートに対してイメージ比較が実行され、単一の一致が達成されたとき、またはテンプレートリストの最後に到達したときに停止すると、その順序がパフォーマンスに影響を及ぼす可能性があります。最高のパフォーマンスを得るためには、発生確率の高いテンプレートを先に配置します。
ファイルリストコンポーネントの下のパネルには、
合格率
、
比較方法
、
比較領域
などの画像比較パラメータが含まれています。詳細は、
CompareTo
コマンドの仕様を参照してください。
v2.1で提供されている興味深い拡張点は、
画像検索パラメータ
グループ内の これらのパラメータは、選択された方法に応じて動的に表示され、アルゴリズム固有の値を選択された画像比較方法に渡すことができます。この機能は現在、背景色の独立した比較を新たにサポートする画像検索だけで使用されています。特定のパラメータの詳細については、
CompareTo
コマンドの仕様を参照してください。これらのパラメータはテンプレートエディタでもサポートされている ため、
テンプレートイメージエディタ
のヘルプトピックにも追加情報があります。
[
比較
]ボタンを使用すると、ウィンドウで指定されたパラメータを使用して、現在選択されているテンプレート(一度に1つずつ)に対してイメージ比較を実行できます。[
RDイメージ
の
ロード
]ボタンを使用してカスタムイメージがファイルからロードされた場合、このイメージに対して比較が実行されます。それ以外の場合、現在接続されているデスクトップが使用されます。
この機能は、コマンドが期待どおりに機能することを確認するのに便利です。以前のファイルに保存されたデスクトップイメージとの比較をデバッグするためにも使用できます(これは 、2.2で提供された
Static Image Client
の機能に似ています)。もし
「検索」
比較モジュールが指定されている場合には、個々のピクセルの不一致のレベルに対する比較をデバッグすることを可能にする付加的な機能がある。後の「
イメージ検索機能」
の章を参照してください。
[
テンプレート
を
編集
]ボタンは、現在選択されているテンプレートを画像エディタで開き、それをトリミングすることができます。このウィンドウは、
テンプレートプレビュー
コンポーネントのサムネイル画像をダブルクリックすることによっても開くことができます。イメージプレビューコンポーネントにはクロップされたイメージが表示されますが、テンプレートの編集ウィンドウでは再オープンされた場合にフルサイズイメージが常に表示され、必要に応じてクロップ領域を何度も編集できます。イメージは、ウィンドウがOKボタンで終了したときにのみ、実際にトリミングされてファイルに保存されます。
[
削除]
ボタンをクリックすると、選択したテンプレートファイルがファイルシステムから削除されます。他のアクションとは異なり、このアクションは即座に実行されるため、注意して使用する必要があります。
ボタン
ロードRDイメージを
使用すると、ファイルからイメージをロードし、リモートデスクトップイメージではなく
比較
ボタンを使用してイメージ比較を実行できます。この機能は、自動テストの実行中など、過去に発生した失敗したイメージの比較のトラブルシューティングに役立ちます。スクリプトコマンドには影響しません。ダイアログを現在のリモートデスクトップイメージに戻すには、同じボタンをもう一度クリックします(カスタムイメージがロードされると
Reset RD Image
が表示されるはずです)。単にダイアログを閉じて再度開く必要があります。
[
環境設定]
ボタンは、CompareToコマンドの画像比較設定へのショートカットとして機能します。これらのパラメータは、WaitForおよびScreenshotコマンドと共有されます。
「環境設定
」の
横にある「
ヘルプ」
ボタンには、言語仕様の「
画像比較機能」
セクションが表示されます。
テンプレートプレビュー
コンポーネントは、実際の寸法と一緒に選択されたテンプレート画像のサムネイル画像を示しています。画像がコンポーネントの表示領域に合っている場合は、スケーリングされず、上の図のテンプレートなどのフルサイズで表示されます。イメージをダブルクリックすると、
イメージエディタ
が開きます(前述のテンプレートの編集ボタンと同様)。
2.画像検索機能
比較方法が "search2"、 "search"、 "object"、 "text"などの場所を生成するように設定されている場合、
比較
ボタンは追加の機能を提供します。少なくとも1つの一致がある場合、ウィンドウには、下に表示されているような座標のリストを含むメッセージボックスが表示されます。[
一致を
表示]ボタンを
選択すると、リモートデスクトップイメージのコピー(または最終的に [
RDイメージ
の
ロード
]ボタンを使用して
ロード
された
イメージ
)のウィンドウが開きます。次の例があります。 ウィンドウにはいくつかの重要な機能があります。コントロールの最初の行には、
表示さ
れた
Match(es)
と呼ばれるドロップダウンが含まれています。
テンプレートの場所(四角形)、リモートデスクトップ上に見つかったオブジェクトまたはテキストインスタンス。特定の一致を選択すると、対応する矩形が赤い枠線で強調表示されます([矩形の
一致]
チェックボックスがオフの場合を除く)。赤色がデスクトップの色と矛盾する場合、右の色のドロップダウンで色を設定できます。
2番目のコントロールの行は
ピクセルとピクセルの差分
を扱います。この機能は
画像検索(「検索」)
方法に特有であり、他の方法では使用されません。合格率が100%未満の数値に設定されている場合、コントロールは選択した色の不一致ピクセルを表示します(デフォルトで緑色)。