To access

Select Tools > Options > GUI Testing tab > Text Recognition node.

Important information

The Restore Factory Defaults button resets all Options dialog box options to their defaults.

The settings in this pane are used when using OCR (optical character recognition) to identify text, as described in Text recognition in run-time.

Related tasks

• Configure text recognition settings

• Insert a checkpoint step

• Insert an output value step

See also

• Text recognition in run-time

• Checking Text in an image - Use-case scenario

• Text and text area checkpoints

The manner in which to recognize text in the application:

• Single text block mode: The single text block mode instructs the OCR mechanism to focus on the area and treat it as a single text block. This is especially useful when trying to capture text on small objects or in a small text area. Select this radio button if the text on the object is uniform in font, size, color, and background. For example:

  

• Multiple text block mode: The multiple text block mode instructs the OCR mechanism to handle each text area in the object that has a different background font and size. The OCR mechanism decides where to divide the text blocks according to an internal algorithm. Select this radio button only if the text on the object comprises different fonts, font sizes, colors, and/or backgrounds. For example:

  

Lists all of the language dictionaries that the OCR mechanism can potentially use when retrieving text from the object.

To specify the language dictionaries used by the OCR mechanism: Move a language to the Supported languages list box by selecting a language and clicking the right arrow button (>).

Lists the language dictionaries that the OCR mechanism uses when capturing text.

Add languages from the Available languages to the Supported languages to specify which languages to use for text recognition.

UFT One 15.0.1 or later: You can select multiple languages to support.

UFT One 15.0 or earlier: The Supported languages list box can contain either:

• One CJK (Chinese, Japanese, Korean) language.

  By default, English is also supported when capturing text in CJK languages.)

• One or more non-CJK languages.

(Baidu only)

A single language to support for text recognition, or the combination Chinese and English.

If your Internet connection requires a proxy, specify the proxy server address and authentication details.

Proxy type. Defines the type of proxy to use when connecting to the UFT Mobile server:

• System Proxy

• HTTP Proxy

Proxy address. The proxy IP address and port. If System proxy is selected, this field is populated automatically, and is read-only.

Specify authentication. Enables you to connect to the UFT Mobile server using a specific account.

Proxy user name and password. The credentials used to connect to the UFT Mobile server, if Specify authentication is selected.

UFT One 15.0.1: When proxy settings are deselected, the default proxy settings are used.

UFT One 15.0.2 and later: When proxy settings are deselected, no proxy is used for this connection.

Test Connection

Press Test Connection to test your connection details and make sure UFT One can connect to the cloud OCR service.

The manner in which to recognize text in the application:

• Single text block mode: The single text block mode instructs the OCR mechanism to focus on the area and treat it as a single text block. This is especially useful when trying to capture text on small objects or in a small text area. Select this radio button if the text on the object is uniform in font, size, color, and background. For example:

  

• Multiple text block mode: The multiple text block mode instructs the OCR mechanism to handle each text area in the object that has a different background font and size. The OCR mechanism decides where to divide the text blocks according to an internal algorithm. Select this radio button only if the text on the object comprises different fonts, font sizes, colors, and/or backgrounds. For example:

  

Enables you to restrict text recognition to specific characters.

This option is supported for English only.

The current language to use in text recognition. Only one language pack can be used at a time.

To download and install a new language pack, you can visit the Tesseract OCR language pack download site: https://sourceforge.net/projects/tesseract-ocr-alt/files/?source=navbar or by clicking the link in the pane.

Once you download the language pack, you can add the files to the OCR engine folder, found at <UFT One installation folder>/dat/tessdata.

Enables you to load configuration settings from an externally defined file.

Not all configuration options are supported for use in UFT One. The Output pane displays a list of parameters that are ignored when running a test( e.g., the interactive_display_mode parameter):

• % parameter_name% parameter is not supported

• The Tesseract OCR engine has stopped due to an error. Check your Tesseract configuration and try again.

• The value type for the % parameter_name% parameter is incorrect. The parameter was ignored during the test run

• The %parameter_name% parameter is not supported by the Tesseract OCR engine

For details on how to create your own configuration file, see http://www.sk-spell.sk.cx/tesseract-ocr-parameters-in-302-version.

Enables the text recognition to identify image elements before identifying the text in the specified object or area.

When you use this option, UFT One converts the image to a black and white image and resizes it. However, this slows the performance of UFT One when performing text recognition. Therefore, expect additional time in test runs when performing text recognition with this option.

This option should be used when your application uses very small font size (10 pt. and lower)