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.

Select any recorded image in the Solution Explorer to see all its details and parameters in the Image explorer

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/2023 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 click Save Image 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.