Text References

There are several ways to use text property references:

Text Property List

テキストプロパティリスト（旧名、テキスト画像プロパティリスト）は、SUT上のテキストの説明です。すべてのテキストプロパティリストは、検索する実際のテキスト文字列を定義するテキストプロパティを含まなければなりません。また、以下で説明するプロパティを追加で含みます。当該プロパティリストに含まれないプロパティは、テキストプリファレンス設定でデフォルト設定されます。

よく使用されるテキストプロパティ

以下のテキストプロパティは、あらゆるテキストプロパティリストで使用可能です。

  • Text: Text string. SUTで検索対象とする文字列です。（必須。）
  • TextPlatform: Text-platform name. テキスト画像を作成するテキストプラットフォームの名前です。（詳細については、TextPlatforms Global Propertyをご覧ください。）
  • TextStyle: Text-style name. 事前定義テキストプロパティのグループです。（詳細については、テキストパネル結果を検出をご覧ください。）

Generic (OCR) Text Properties

The following text properties can be used with the generic text platform, or with any text platform that uses the Optical Character Recognition (OCR) text engine:

  • CaseSensitive: Boolean. Whether or not Eggplant Functional considers case in text searches.
  • Contrast: Boolean. SUTディスプレイを内部で高コントラスト二色画像に変換するかどうか。コントラストをオンにすると、コントラストカラーがSUTディスプレイの主要色とみなされ、すべてその他のカラーは二次色として扱われます。Text can be found in either color.
  • Color: Color name or value. When contrast is on, Color is the color that is considered the primary color of the SUT display.
  • ContrastTolerance: Integer. コントラストがオンである場合、contrastToleranceはピクセルをコントラストカラーと見なす際に許容される色の差異の、チャンネルあたりの最大値です。デフォルトのコントラスト許容値は45です。
  • DPI: Integer. DPIプロパティは、SUTディスプレイのDPI（インチあたりドット数）を指します。デフォルトのDPIは72です。SUT上でのテキスト検出に問題がある場合、SUTのDPI設定をチェックし、テキストプロパティリストのDPIプロパティを適宜調整してください。
  • Enable Aggressive Text Extraction: Enable this property if you want OCR to extract as much text from the image as possible.
  • Enhance Local Contrast: Enable this property if you want OCR to automatically increase the local contrast of the image.
  • IgnoreNewlines: Boolean. When set to Yes, ignoreNewlines causes OCR text searches to ignore line breaks, so a search will match a string even if it's broken over several lines.
  • IgnoreSpaces: Boolean. ignoreSpacesプロパティを使用すると、OCRテキスト検索で、テキスト文字列内のスペースが無視されます。例えば文字列"My Computer"は、MyComputerまたはM y C o m p u t e rに一致します。ignoreSpacesプロパティはデフォルトでオンになっています。なぜならOCRは、意図しないスペースを（特にディスクリートな語ではない文字列や不自然な文字間隔を使うテキストで）読み取ることがあるからです。
  • IgnoreUnderscores: Boolean. ignoreUnderscoresプロパティを使用すると、OCRテキスト検索で、アンダースコアがスペースとして扱われます。例えば文字列"My_Computer"は、My_ComputerまたはMy Computerに一致します。ignoreUnderscoresプロパティはデフォルトでオンになっています。なぜならOCRは、アンダースコアを認識できないことがあるからです。
  • Language: Language name. The natural language of the text you are searching for.
  • TextDifference: Integer. This property causes text searches to find text that differs from your search by a given number of characters. For example,

    moveTo text:"armadillo", searchRectangle:(305,241,372,274),TextDifference:2

    would find text written as "armadolli" or any other variation that differs from "armadillo" by one or two characters.
  • ValidCharacters: Text string. The validCharacters property limits the characters that may be found by the OCR text engine. ValidCharactersは、文字列を"*"に設定して、検索中の文字列内の文字に制限可能です。これは、認識されない文字からテキスト一致を「強制」する場合に有用です。If the OCR determines that characters are present in the defined area but they do not match characters provided in the validCharacters string, it will return "^".

  • ValidPattern: String. This property takes a regular expression value and returns only characters or words that match the pattern specified. See OCR Text-Reading Functions for a list of valid expression characters.

  • ValidWords: String or list. This property determines the words that may be found by the OCR text engine. The validWords property overrides the Language property.

 

This topic was last updated on 2月 01, 2019, at 11:13:23 午前.

Eggplant icon Eggplant.io | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant