Image Comparison Overview
4.1 Image Comparison Overview
画像比較メソッド は、接続されたデスクトップの画像を分析するアルゴリズムおよび/またはテクノロジーです。スクリプト内でデスクトップのコンテンツを検証し、GUIコンポーネントやテキストなどのアーティファクトを取得し、その結果に基づいて処理するために使用されます。ほとんどのメソッドは、1つ以上の画像ファイル（「テンプレート画像」）および/または画像フォルダ（「テンプレート画像コレクション」）を使用します。これらのアーティファクトについては、Image CollectionsそしてImage Meta Dataの章で詳しく説明します。
画像比較メソッドプラグインは、以下の3つの スクリプト言語コマンド と、それに 対応するJavaメソッドと密接に統合されています。これらは、比較メソッドのコンテキストでは通常、 ホスティングコマンドまたはJavaメソッドと呼ばれます。:
コマンド | Javaメソッド | 説明 |
|---|---|---|
選択した画像比較方法を、現在接続されているデスクトップに一度だけ適用します。通常、コンポーネントの存在を確認したり、その座標を取得したり、テキストを取得したり、画面の内容が期待されるものかどうかを確認するために使用されます。 | ||
リモートデスクトップのスクリーンショットをファイルに保存し、オプションとしてcompareto コマンドを使用します。 | ||
選択された画像比較メソッドが「成功」（リターンコード0）という結果を出すまで（'match'）、または（'mismatch'）実行を一時停止します。通常、期待するコンポーネントまたはテキストが画面に表示されるか、または画面から消えるまで待機するために使用されます。 |
各比較メソッドは、例えば "search2 "や "object "のように、そのユニークな名前（コードとも呼ばれる）によって識別されます。コマンドフレームワークによってサポートされる標準的な "passrate "と "cmparea "パラメーターの他に、各メソッドは特定のアルゴリズムに特有の任意の数のオプションパラメーターを宣言することができます。これらのパラメータは、呼び出し元のコマンドから参照できます。
すべての画像比較メソッドは内部的にプラグインとして実装されているため、ユーザーは自由にカスタム・アルゴリズムを開発し、スクリプト言語とJavaスクリプトAPIに統合することができます。詳細は画像比較モジュールインターフェイスを参照ください。
以下の例は、フレームワークが提供するすべてのパラメータ "passrate "と "cmparea "と、独自のパラメータ "order "を使用して、最も頻繁に使用される "search2 "アルゴリズムの呼び出しを示しています：
Compareto "buttonOk.png" passrate="70" method="search2" cmparea="x:258,y:114,w:417,h:298" sort="none"
Screenshot "s.jpg" template="buttonOk.png" passrate="70" method="search2" cmparea="x:258,y:114,w:417,h:298" sort="none"
Waitfor "match" template="buttonOk.png" passrate="70" method="search2" cmparea="x:258,y:114,w:417,h:298" sort="none" Java Script 形式での同じ例:：
compareTo(new File[] { new File( "buttonOk.png" ) }, 70.0f, new Rectangle(258, 114, 417, 298), "none" );
screenshot(new File( "s.jpg" ), (String) null , (Rectangle) null , new File[] { new File( "buttonOk.png" ) }, 70.0f, new Rectangle(258, 114, 417, 298), "none" , false);
waitForMatch(new File[] { new File( "buttonOk.png" ) }, 70.0f, (String) null , new Rectangle(258, 114, 417, 298), (String) null , "none" , (String) null);失敗した画像の比較を一般的な方法で処理できる組み込みメカニズムが 2 つあります。：
ComparisonFailureFallback フォールバック手順(v2.3以降)、
Image Doctor ウィザードとimagedoctor コマンドを使用します（v3.5以降）。