General Visual Analysis parameters

The key sequence to perform the backlight operation.

Example: VOL_UP

For best practice, use a key that will not change the screen.

The column name to be used for grid view in the report. Selecting this parameter creates the grid report.

The minimum time interval, in seconds, for a single analysis.

If the analysis operation takes less than the interval, wait the remaining time before the next analysis operation.

The label position relative to the button. Used alongside the offset parameter.

Rightmost and Leftmost label position values represent the distance from the screen edge.

none: The label is part of the button

above: The label is above the button

below: The label is below the button

left: The label is to the left of the button

right: The label is to the right of the button

leftmost: The Button is aligned to the right, and its label is to the left

rightmost: The Button is aligned to the left, and its label is to the right

The value can be in pixels or in percentage of screen height (0-100). For percentage, use the % sign.

Example: 20%

Used alongside the Label position parameter. If label position is "none", then label offset is "0". Otherwise, the label offset default is 10%.

The needle comparison method.

Same size: Needle and haystack are from the same origin (device screen) and size. Matching is faster and simpler.

Any size: Needle and haystack are either not from the same origin (needle is from another device or other source) or not in the same size (different ratio or size), matching is slower and more complex. Selecting any size increases the analysis time. The timeout values should respectively be increased.

Bounded size: Same as any size, but with restrictions on possible needle sizes.
This mode decreases the any size analysis time by using apriori knowledge on needle sizes or by decreasing the size of a haystack.

The maximum number of scroll actions to perform before returning. Finding the label will stop the scrolling.

Effective values are in the range of 0-100.

Default: 5

The key sequence to perform the scroll operation. For more information see the Create custom swipe gestures post.

The touch operation to perform on the found label location.

The direction of the related region, stored in memory from the last found needle, in relation to the searched needle. For more information, see Visual Relations.

left: The related region is to the left of the searched needle

right: The related region is to the right of the searched needle

above: The related region is above the searched needle

below: The related region is below the searched needle

left-above: The related region is to the left and above the searched needle

left-below: The related region is to the left and below the searched needle

right-above: The related region is to the right and above the searched needle

right-below: The related region is to the right and below to the searched needle

inside: The searched needle is inside the related region boundaries of the related region

The search area is in-line with the related region, stored in memory from the last found needle. For more information, see Visual Relations.

horizontal: The needle is within the height (top to button) boundaries of the related region

vertical: The needle is within the width (left to right) boundaries of the related region

The number of times to repeat the operation. Relevant for tap and double tap actions only. Default: 1

The value to display in the report.

Screenshot (default): Display screenshot

Screenshot on error: Display screenshots only for actions in error

None: Display nothing

It is recommended to reduce the report image resolution in very long scripts that result in large report files.

The image resolution.

It is recommended to reduce the resolution in very long scripts that result in large report files.

The height value of the screen area where to search for the label. Values can be in pixels or in percentage of screen height (0-100).

For percentagem use the % sign.

Example: 20%

The default is to search the entire screen.

It is recommended to use the percentage value because it does not rely on the screen resolution.

The left value of the screen area where to search for the label. Values can be in pixels or in percentage of screen width (0-100). For percentage, use the % sign.

Example: 20%

Default is to search the entire screen.

It is recommended to use the percentage value because it does not rely on the screen resolution.

The top value of the screen area where to search for the label. The value can be in pixels or in percentage of screen height (0-100). For percentage, use the % sign.

Example: 20%

The default is to search the entire screen.

It is recommended to use the percentage value because it does not rely on the screen resolution.

The width value of the screen area where to search for the label. Values can be in pixels or in percentage of screen width (0-100). For percentage, use the % sign.

Example: 20%

The default is to search the entire screen.

It is recommended to use the percentage value because it does not rely on the screen resolution.

Scroll until the label is found.

noscroll (default): Do not scroll

scroll: Scroll

Scroll cannot be used together with a positive timeout value because this would dictate a different behavior when the needle is not found. When scrolling is enabled, the timeout must be zero.

Scroll results in a longer execution time.

The source for retrieving the screen content.

primary: Screenshot taken from the device (higher resolution but slower)
native: Native device controls

camera: Screenshot taken from the video stream (lower resolution but faster)

auto: (default) Native device controls, if available. If not available, a digital screen image is used, if available. If not availabe, an analog screen image is used.

The height value of the image area defining the label. The value is in pixels. Default is the entire image.

The left value of the image area defining the label. The value is in pixels. Default is the entire image.

The top value of the image area defining the label. The value is in pixels. Default is the entire image.

The image analysis mode. The device screen may contain text and images.

automatic: OCR distinguishes between text and images, filtering out images.

manual: OCR assumes text only. Use alongside the Inverted text parameter. 

full: OCR tries both automatic and manual.

This parameter is irrelevant when using native screen source.

The option to find the exact needle phrase with no errors.

This parameter is irrelevant when using native screen source.

The search pattern case sensitivity.

nocase: Insensitive

case: Sensitive

The option to ignore punctuation characters when matching text.

nopunct: Ignore

punct: Do not ignore

The option to ignore spaces within search pattern words.

nospace: Ignore

space: Do not ignore

If the needle has multiple occurrences on the screen, enter the index of the required occurrence.

The text is likely to appear in inverted colors (dark text on light background). Use only if 'analysis' is set to 'manual'.

yes: Text is inverted

no: Text is normal, not inverted

any: Text might be inverted or not, checked automatically by the system

This parameter is irrelevant when using native screen source.

The OCR language to use. It is possible to select multiple languages.

For languages that do not appear in the drop down menu, contact Perfecto Support.

This parameter is irrelevant when using native screen source.

A generic OCR parameter. Use this to provide additional OCR specifications that are not exposed as function parameters.

Example: "isolate=true"

It is possible to provide multiple specifications.

This parameter is irrelevant when using native screen source.

The text recognition accuracy policy. Selecting the Accuracy value will increase the operation time.

auto: (default) Shifted toward recognition accuracy with a moderate impact on the recognition speed.

accuracy: Shifted toward maximum recognition accuracy. 

performance: Shifted toward recognition speed.

This parameter is irrelevant when using native screen source.

Use when text cannot be found on the device screen.

Try all profiles with the word accuracy. Per profile, try changing the DPI (96 or 300 or 120).

The target search in case the needle includes more than one word.

As is: Search for the entire string content as is, as a complete phrase

Any: Search for any word in the string. When selecting Any, the words in the Expected text parameter can be divided into phrases with quotation marks.

Example: "new contact" "add contact"

Barcode recognition.

Book-formatted text recognition, accuracy mode.

Book-formatted text recognition, speed mode.

Archived text recognition, accuracy mode.

Archived text recognition, speed mode.

Text recognition, accuracy mode.

Text recognition, speed mode.

Field text recognition (e.g. bank account balance).

Text image recognition (such as pdf or scan), accuracy mode.