Eggplant Functional テキスト設定
これらの設定は、テキストプロパティリストで使用できるテキストプラットフォームを定義します。各プラットフォームにはテキストエンジンが含まれ、予め定義されたテキストスタイルが任意の数含まれます。Advanced Platform Optionsをクリックして、Eggplant FunctionalでOCR検索に使用したい言語を選択します。{#text-preferences}
テキストプロパティパネルの概要
テキストスタイル
テキストスタイルとは、Eggplant Functionalのテキスト設定、OCRチューナー、またはOCR更新パネルで定義されたテキストプロパティの保存セットです。各テキストスタイルは、テスト対象のアプリケーションで繰り返し出会う特定のフォントやGUI要素(例えば、メニューアイテムやタイトルバー)に特化しています。テキストスタイルは、OCR検索とReadText()
の両方に適用することができます。読み込みと検索の違いについては、OCRの使用方法を参照してください。
パネルはデフォルトスタイルが選択された状態で開きます。この下のセクションでOCRプロパティを変更すると、現在のスタイルが変更されます。この新しいスタイルを保存するには、Text Styleのドロップダウンメニューで"Default"を選択して名前を変更するか、上書きしたいスタイルを選択します(デフォルトスタイルは変更可能です)。Save Styleをクリックします。
現在選択されているスタイルを削除するには、Delete Styleをクリックします。このオプションは、デフォルトスタイルが選択されているときは無効になります。
このセクションの右側にはコピーアイコンがあります。これは、次のセクションで設定した現在のテキストプロパティをスクリプトで使用するためにコピーするために使用できます。詳細については、プロパティ設定の保存またはコピーを参照してください。
コントラストセクション
Contrastセクションでは、Contrast
プロパティと関連プロパティを設定し、作業することができます。Contrast
設定は、システムアンダーテスト(SUT)の画像をOCRが黒と白に変換し、それを認識するためのOCRエンジンに送信する前に変換します。このインタラクティブなセクションには、右側にライブアップデートエリアがあり、ビューアウィンドウで描かれる現在の検索矩形と、現在のContrast
設定でOCRエンジンに送信される方法を示します。
-
Contrast: SUTディスプレイがOCR分析に送信する前に高コントラストの二色画像に変換されるかどうか。
contrast
がオンの場合、ContrastColor
プロパティを使用して設定できる色(これを"contrast color"と呼びます)がSUTディスプレイの主色と見なされ、他のすべての色は二次色として扱われます。テキストはどちらの色でも見つけることができます。Contrast
プロパティは、テキストの検索(見つける)とテキストの読み取りの両方で使用できます。- Contrast Color:
Contrast
がオンの場合、コントラストカラーはSUTディスプレイの主色と見なされ、他のすべての色は二次色として扱われます。背景色の見つけ方についての指示は、背景色の判定を参照してください。 - Contrast Tolerance:
Contrast
がオンの場合、contrastTolerance
は、ピクセルがコントラストカラーとして見られるために許される最大のチャンネルごとの色差を設定します。
- Contrast Color:
Findタブ
パネルの右上の四分の一にはFindとReadの2つのタブがあります。これは、OCRを使用して特定のテキスト文字列を見つけるため、またはSUT画面から未知のテキストを読み取るためです。一部のプロパティはテキストの読み取りまたは検索にのみ使用でき、両方では使用できません。Findタブは、特定のテキスト文字列を検索するときに設定できる次のプロパティを表示します。テキストの読み取りと検索の違いについては、OCRの使い方を参照してください。
Case Sensitive:{#casesensitive}Eggplant Functionalがテキスト検索で大文字と小文字を区別するかどうか。このプロパティを有効にすると、テキスト検索が大文字と小文字を尊重し、テキスト文字列の大文字と小文字の使用を正 確に一致させるテキストのみを見つけます。このプロパティはテキストの検索に使用され、テキストの読み取りには使用されません。
Ignore Spaces: ignoreSpaces
プロパティにより、OCRテキスト検索はテキスト文字列のスペースを無視します。たとえば、文字列"My Computer"は"MyComputer"または"M y C o m p u t e r"と一致します。ignoreSpaces
プロパティはデフォルトでオンになっています。これは、OCRが特に個々の単語でない文字列や、通常とは異なる文字間隔のテキストで意図しないスペースを読み取ることがあるためです。
Ignore Underscores: ignoreUnderscores
プロパティにより、OCRテキスト検索は検索中にアンダースコアをスペースとして扱います。たとえば、文字列"My_Computer"は"My_Computer"または"My Computer"と一致します。ignoreUnderscores
プロパティはデフォルトでオンになっています。これは、OCRがアンダースコアを認識しないことがあるためです。
Ignore Newlines: {#ignorenewlines}有効にすると、ignoreNewlines
はOCRテキスト検索で改行を無視し、検索は複数の行に分割された文字列でも一致します。このプロパティはテキスト検索専用で、ReadText
には使用できません。
Text Difference: このプロパティにより、テキスト検索は、検索と特定の文字数だけ異なるテキストを見つけます。OCR検索専用。
Readタブ
パネルの右上の四分の一にはFindとReadの2つのタブがあります。これは、OCRを使用して特定のテキスト文字列を見つけるため、またはSUT画面から未知のテキストを読み取るためです。一部のプロパティはテキストの読み取りまたは検索にのみ使用でき、両方では使用できません。Readタブは、テスト対象システム(SUT)の画面からテキストを読み取るときに設定できる次のプロパティを表示します。テキストの読み取りと検索の違いについては、OCRの使い方を参照してください。
Trim Whitespace: TrimWhitespace
がオンの場合、返されるテキストの始まりと終わりからすべての空白文字が削除されます。TrimWhitespace
がオフの場合、ReadText
関数は、空白文字で始まるまたは終わるテキストを返すことができます。テキストの読み取り専用で、事前に定義された文字列の検索には使用できません。
Multi-Line: このプロパティは、矩形内のテキストを読み取るのではなく、点近くのテキストを読み取るときにのみ適用されます。MultiLine
がオンの場合、ReadText
関数は、指定した点に関連するテキスト行と、同じテキストブロックに属していると見えるその点の上下のテキスト行を返します。MultiLine
がオフの場合、ReadText
関数は点に関連するテキスト行のみを返します。