Image-based automation settings

Image-based automation settings are to specify the behavior of Ranorex in detecting and identifying UI-elements in an image-based way. The settings can either be made generally (by means of the settings dialog) or on an action-based way (by means of the action properties).

In this chapter

Image-based settings

To set up the default values for image-based recording, open up the ‘Settings‘ dialog and continue with activating the ‘Imaging‘ tab.

Return the best match (and not the first one): If ‘Best Match’ is set to true, the result position with the highest similarity is used for validation. If is set to false, the first available result position will be used for the validation. The first is more accurate and the second is faster.
Similarity threshold (0.0-1.0): Specifies the minimum similarity (0.0-1.0), that the image region to search for needs to have in common with the image in order to be considered a match
Downsize quality
Preprocessing steps: Defines preprocessing steps that can be performed on an image before search. Available options are ‘Downsize’, ‘Edges’, ‘EdgesSobel’, ‘Grayscale’ and ‘Threshold’

Timeout (ms)

Default validation options

These options control the default reporting values for image-based validations (ContainsImage and CompareImage).

You can set them for individual validations in the respective validation action’s properties.

Report difference image: If and when an image showing the differences between the expected and the actual image will be included in the report. Default setting = Never.
Report screenshot: If and when a screenshot of the validated UI element will be included in the report. Default setting = Never.
Report similarity: If and when the similarity of the expected and the actual image will be included in the report. Default setting = Never.
Report expected and actual images: If and when the expected and the actual image will be included in the report. Default setting = On Fail.

Image-based properties

Image-based properties are available on an action-based access by selecting an action and pressing the F4 key. Remember that image-based properties only affect the corresponding action and not the image-based behavior of Ranorex generally.

Select an action and press F4 to open the action properties
See the image-based properties in the action properties pane

You find the same settings and configurations as in the image-based settings dialog.

See the preprocessing settings
See the similarity factor setting