Image Explorer

Overview

The Image Explorer allows you to view the images taken with the designer and to modify the parameters of the captured images. The process of taking images with the Designer is described in chapter Capture Mode and Screen Editor

Viewing the Images

You can view the images taken with the Designer simply by selecting the Image Explorer from the TestResults.io menu and docking it to your Visual Studio. Afterwards whenever you will select an image within your solution you will see all of the details of the selected image.

Modifying the Image parameters

Each image taken with the designer contains metadata with several parameters:
Parameter name
Description
Modifiable
Example
Capture Date
Shows the Date and Time of image creation
No
03/05/2019 12:37
Capture Environment
Shows the name of the environment where the image was taken
No
Test Env.
Original Screen Size
Shows the screen resolution of the Environment where the image was taken (width, height)
No
1600, 900
Original Location
Top left coordinates of the image location followed by the size of the image (x, y, width, height)
No
658, 463, 123, 37
Description
Not mandatory image description (free text)
Yes
This is a button
HotSpot
The exact location where the engine will interact with the image, e.g. for a click. The coordinates are relative to the top left corner of the image. By default no hotspot coordinates are set and the hotspot is placed in the center of the image.
The hotspot can also be modified by moving the hotspot marker (crosshair) directly in the image.
Yes
X: 64, Y: 21
Engine
Type of the Engine which is to be used for the Image Search. You can select from Default, Precise or Template matching.
Yes
Default
Precision
The precision which is to be used when looking for the image on the SUT. Precision 1.0 looks for a perfect match, whereas a lower precision allows some deviations of the image (e.g. subtle mouse hover effects)
Yes
0.9
Processing Mode
Determines how the image shall be processed. The engine has the possibly of smoothing the image (e.g. to improve detection of text that might be rendered differently).
Yes
None

Modifying the Hotspot position

You can modify the Hotspot position simply by dragging the
cross to the desired position as shown in the picture below

Cropping the Image

If you want to crop the already taken image simply follow the steps below:
  • Select the Crop button in the Image Explorer
  • The Cropping window will be shown where you will be able to redefine the rectangle of the image. Once completed hit the Crop button in the bottom of the window
  • As a result you will see a new cropped image

Masking the image

For more complex images you might want the engine to ignore some parts of the image. The masking functionality allows you to introduce regions which will be fully ignored by the engine while executing the test case. Follow the steps below to introduce a masking for your image:
  • Select the Mask button in the Image Explorer
  • Draw the first region which should be ignored and press the Mask button. Afterwards you can draw additional regions which shall be ignored. Each time you want to add a new region to ignore simply press the Mask button
  • To finish masking the image press the Save button.