複数のプラットフォームで画像比較を成功させるための方法
※本記事は、Ranorexの画像検証に関する基礎知識をお持ちの方を対象としています。
※Ranorex ハンズオンセミナー(初級・中級)を受講することで、Ranorexの画像検証について学習いただけます。
Ranorexの画像比較は、ピクセル単位でRGB値(赤・緑・青の色を組み合わせた数値)を参照した厳密で高精度な検証です。そのため、複数のテスト実行環境でテストする場合に、期待画像との微細な色の違いや文字・グラフィックの位置の微妙なズレなどが発生すると、規定の設定では失敗しやすくなります。
本記事では、テスト実行環境の違いにより、人の目で認識できない微細な差分で失敗する画像比較を成功させるための設定方法について説明します。
本記事の最後に、詳細資料を公開しておりますので、ダウンロードください。
Ranorexの画像比較
テスト実行時に表示された画像が期待画像と一致しているかを判断する指標として、類似度 (Similarity)が使用されます。類似度は0.0から1.0の範囲で表され、1.0は100%の一致を意味します。具体的には、比較対象の画像のすべてのピクセルにおいて、赤（R）、緑（G）、青（B）の各色の値が完全に一致している状態を指します。このため、類似度が1.0の場合、完全一致となり、画像検証の結果は成功と判断されます。
詳しくは、以下のイメージバリデーションのブログをご確認ください。
画像比較が失敗する主な要因
Ranorexの画像比較が失敗する主な要因は、以下の通りです。
- マシンの解像度やウィンドウサイズが統一されていない複数環境でのテスト
- Windows OSの異なるバージョンでのテスト
- クラウド環境でのテスト
- リモートデスクトップ接続によるリモートテスト
- 検証対象の画像内に動的なコンテンツが含まれるテスト
画像比較が失敗する主な要因の解決策
「画像比較が失敗する主な要因」であげた内容は、大きく分けて次の3パターンに分類できます。それぞれの要因に対応する解決策をお試しください。
- 解像度・ウィンドウサイズの違いが原因の場合
- マシンの解像度やテスト対象アプリケーションのウィンドウサイズを統一する
- Windows OSバージョン・クラウド環境・リモートデスクトップ環境の違いが原因の場合
- Ranorexの標準機能（プリプロセスフィルター・類似度）で差分を許容する
- 他ツール連携により、文字・画像の位置ズレを自動検出して検証する (例：OpenCV利用)
- 環境ごとに期待画像を切り替えて、テストを実行する (ユーザーコード利用)
- 動的なコンテンツやテスト環境によって変化するコンテンツが含まれる場合
- 差分が発生しやすい箇所や動的に変わる箇所をマスキングして検証する
資料ダウンロードのご案内
複数のプラットフォームでの画像比較を成功させるための方法に関する詳細資料は、以下のリンクからダウンロード可能です。
※ファイルをダウンロードできない場合は、ブラウザーのセキュリティ設定をご確認ください。
