メインコンテンツまでスキップ
バージョン:23.3

画像の参照

コマンドや関数のパラメータとして画像を参照する方法はいくつかあります:

画像名

画像名はテキスト文字列で、引用符で囲む必要があります。ファイル拡張子はオプションです。

例:

Click "ImageOne"
Click "ImageOne.jpg"

画像コレクション

画像コレクションは、基本的な画像のすべての許容バージョンを含む関連画像のフォルダです。たとえば、画像コレクションにはボタンの「通常」画像、選択されたバージョン、無効化されたバージョンが含まれているかもしれません。

スイート内の任意の画像フォルダを画像コレクションとして使用できます。ただし、Eggplant Functionalは画像コレクション内のすべての画像を探しますので、非常に大きなフォルダはスクリプトの実行を遅くし、興味のない一致をEggplant Functionalが見つける原因となる可能性があります。

画像コレクションは、画像名のようなテキスト文字列です。画像コレクションの作成方法については、画像コレクションの作成を参照してください。

例:

Click "SaveButton"
ノート

関数ImageSize()とImageHotSpot()は、パラメータとして画像コレクションを持つことはできません。

コレクションフィルタ

グローバルプロパティthe CollectionFilterを使用して、スクリプト内でEggplant Functionalが探す画像を名前、画像の説明、または両方で絞り込むことができます。

例:

Set the CollectionFilter to {Name: "German"}
Set the CollectionFilter to {Name: "German", Description: "New version"}

最初の例では、Eggplant Functionalは画像名に文字列"German"が含まれる画像に検索を限定します。第二の例では、名前に"German"、画像の説明に"New version"が含まれる画像に検索を限定します(スイートエディタの画像ペインで記録されています)。

ノート

フィルタリングの目的で、画像コレクション内の画像のサブパスはその名前の一部と見なされます。

画像プロパティリスト

画像プロパティリストは、既存の画像または画像コレクションを参照し、そのデフォルトのプロパティを上書きする能力を持っています。すべての画像プロパティリストには ImageName プロパティが含まれていなければならず、以下のリストから任意の追加プロパティを含むことができます。

  • ImageName: File name. 画像ファイルの名前。(必須)

  • HotSpot: Coordinate pair. 画像のホットスポットで、座標は画像の左上隅に対して相対的です。

  • WaitFor: Number. Eggplant FunctionalがSUT上に指定された画像が表示されるのを待つ最大時間。デフォルトの時間単位は秒ですが、分も指定できます。

  • SearchType: Tolerant of Background, Smoothed for Text, Adaptive to Image は最も一般的な画像検索タイプです。それ以外にも、Precise to Pixel, Pulsing to Element, Smooth and Pulsing などのあまり使用されないタイプも利用可能です。さまざまな検索タイプとその機能についての詳細な説明は、Image Capture Best PracticesChoosing the Best Search Type を参照してください。

    ノート

    検索タイプ Smoothed for Textは以前はSmoothと呼ばれていました。

    • Pulsing: ブーリアン型. 検索タイプがパルス画像を許可するかどうか。
    • Tolerance: 整数. 画像のピクセルとビューアウィンドウのマッチング部分との間の許容色差を表す数値。赤、緑、青の値を一つだけ設定するか、またはコンマで区切って三つの値を設定できます。
    • Discrepancy: 整数. 画像とビューアウィンドウのマッチング部分との間で異なることが許容されるピクセルのパーセンテージ(パーセント記号あり)またはピクセル数(パーセント記号なし)。

      ノート

      Discrepancyの使用は遅くなることがあり、誤検出が発生することもあります。推奨されるアプローチとしては、Image Update パネルでSearch TypeSmoothed for Text に設定する、Image Editorを使用して画像をクロッピングする、基本画像のいくつかの許容されるバージョンを含むImage Collectionを作成するなどがあります。現在の画像がDiscrepancy検索を使用しなければ見つけられない場合は、新しい画像をキャプチャすることもできます。

    • CollectionFilter: テキスト文字列. Image Collections専用で、CollectionFilterはImage Collection内で検索される画像を制限します。(詳細は、上記のCollection Filtersを参照してください。)
    • ClipRectangle: 矩形. (0,0)が画像の左上隅であるとき、cliprectangleはキャプチャ画像内の矩形を定義する座標の組み合わせです。この矩形内のピクセルのみが画像のマッチング対象とされます。
    • SearchRectangle: 座標ペア(左上隅、右下隅)によって定義された矩形. (0,0)が画面の左上隅であるとき、SearchRectangleはSUTの画面上の矩形を定義する座標のペアです。Eggplant Functionalはこの定義された矩形内でのみ画像を検索します。
    • Rotate: 数値. キャプチャされた角度から指定された数の度数の回転で画像を検索します。Image Rotationを参照してください。

例:

Click {ImageName: "CloseButton", HotSpot: [10, 23], SearchType: "Tolerant"}

画像のスケーリング

デフォルトでは、Eggplant Functionalはすべての画像をそのネイティブ解像度(スケール1.0)で検索します。スケーリング因子、サイズ、動的などのいくつかの方法でスケールを変更できます。具体的な使用例については、Finding Imagesを参照してください。

キャラクターコレクション

キャラクターコレクション検索は、OCRがSUT上のカスタムフォントを見つけられない場合に使用するための特別な形式の画像検索です。これらのフォントは、OCR検索をより困難にする不思議な背景と一緒に使用されているかもしれません。こういった問題を克服するために、OCR検索の代わりにキャラクターコレクション検索を使用します。詳細については、Working with Character Collectionsを参照してください。