screenshot

スクリーンショットウィンドウ

このウィンドウでは、GUIを介して簡単にスクリーンショットコマンドを作成し、アクティブなエディタに挿入できます。アクティブなエディタで既存のスクリーンショットコマンド上にカーソルがある状態でウィンドウを開くと、そのコマンドを編集できます。ウィンドウ内で定義されているフィールドと値の詳細については、スクリーンショットコマンド仕様を参照してください。ウィンドウを開くには、スクリプト -> スクリーンショットコマンドを選択するか、メインGUIメニューの対応するツールバーボタンをクリックします。既存コマンドを編集するには、エディタ内でコマンドを右クリックし、コンテキストポップアップメニューからプロパティを選択します。

必須入力項目はスクリーンショット画像ファイル名のみです。このフィールドには拡張子を除いたファイル名のみを入力してください。拡張子はドロップダウンで選択した形式に基づいて自動的に付加されます。利用可能な画像形式はローカルのJavaバージョンに依存します。Java 6ではデフォルトでBMP、GIF、JPEG、JPG、PNG、WBMP形式をサポートしています。JAI（Java Advanced Imaging）などの画像ライブラリをインストールすることで追加形式がサポートされる場合があります。ご使用の環境でサポートされている画像形式を確認するには、ヘルプ＞バージョン情報ウィンドウを開き、システム情報タブを選択し、サポートされている画像形式フィールドの内容を確認してください。

画像比較を行う場合は、スクリーンショットを非可逆画像形式（PNGなど）で保存することをお勧めします。これにより、後で 静的画像クライアント を使用してスクリーンショット画像との画像比較の失敗をデバッグし、最終的にはその画像を新しいテンプレート画像や追加のテンプレート画像の作成に再利用することが可能になります。圧縮アルゴリズムで画像のピクセル値を変更する非可逆形式（JPG など）では、これは不可能です。

スクリーンショットコマンド引数パネルにリストされているその他のパラメータは、スクリーンショットコマンド仕様に準拠しています。

説明はスクリプト内にパラメータとして保存されます。画像ファイルには保存されません。通常、レポートプロバイダーによって取得され、スクリーンショットの横にレポート内で表示されます。

添付ファイルフィールドでは、セミコロン区切りの添付ファイルリストを指定できます。このフィールドはHTMLレポートでのみ使用されます。レポートプロバイダーに対し、スクリーンショットがスクリプトによって出力フォルダにコピー済み（またはコピー予定）のファイルに関連付けられていることを伝えるためのものです。レポートプロバイダーは通常、この情報を使用してレポート内のスクリーンショット横にHTTPリンク一覧を生成します。このコマンドは添付ファイルを物理的に出力フォルダへコピーまたは移動せず、またウィンドウやコマンド自体が引数で指定されたファイルが出力フォルダに存在するかどうかを確認しない点に注意してください。スクリプトが添付ファイルを物理的に出力フォルダにコピーしない限り（例：ExecによるローカルOS内/共有ネットワークドライブからのファイルコピー、またはリモートデスクトップ上のファイル転送機構（FTP等）を介したコピー）、レポート内のリンクは機能しません。

領域フィールドでは、デスクトップ画像から切り取る矩形領域を指定できます。右側のボタンをクリックすると、現在のリモートデスクトップ画像を表示する簡易ウィンドウが開き、マウスドラッグでスクリーンショット領域を簡単に定義できます。

画像比較結果を描画する... チェックボックスは、画像比較の結果をキャプチャしたスクリーンショットに描画するかどうかを制御します。デフォルト値は false（結果を描画しないことを意味します）です。

コマンドが画像比較を使用しない場合、または指定された比較方法が結果の描画をサポートしない場合、このパラメータは無視されます。

結果の描画は現在、search2、search、object、text の比較メソッドでサポートされています。描画に使用される色はデフォルトで赤色であり、コマンド設定でカスタマイズ可能です。

スクリーンショットコマンドは画像比較もサポートします。目的は「スクリーンショットを撮影し、デスクトップ画像も検証する」といったタスクを支援することです。スクリーンショットコマンドで生成された画像比較結果は、デフォルトのHTML/XMLレポートに追加で表示されます。この機能はCompareToコマンドおよびWaitForコマンドでは利用できません。

画像比較を有効にするチェックボックスがオンに設定されると、比較パラメータが表示されます。画像比較パラメータは、テンプレートパラメータコンポーネントで指定できます。詳細については、CompareToコマンドウィンドウヘルプトピックを参照してください。