Image Explorer
Last updated
Last updated
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
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.
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 |
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
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.
You can modify the Hotspot position simply by dragging the cross to the desired position as shown in the picture below
