Capture Mode

The capture mode allows you to take pictures of the controls present on your SUT and save them for later usage within the designer and your source code.

Selecting an image and defining the hotspot

Drawing a Rectangle

To select an image you will need to define the rectangle of the image to take. To do so you simply need to draw a rectangle using your mouse. You can draw the rectangle from whichever side you wish. Once you are done drawing simply release the mouse button.

How to draw a rectangle for your control

Once you are done you will see the image taken in the preview section.

Selecting the Hotspot

Once you have selected the rectangle you will notice that hotspot indicator ( ) is located in the middle of the rectangle. The hotspot is used to determine where the interaction with the control should take place (e.g. clicking). You can change the position of the hotspot by simply dragging and dropping it in the desired location:

You can also move the hotspot outside of the image boundaries. Please be careful when selecting a hotspot

You can also modify the position of the hotspot within the preview area by following simply drag and dropping it:

Setting the image parameters before saving

You can modify the parameters of the image before saving it to you solution. The following parameters can be modified before the image is saved:

Parameter name

Description

Example

Description

Not mandatory image description (free text)

This is a button

HotSpot

HotSpot of the image i.e. the relative location where the engine will click on the image. By default the hotspot is placed in the center

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

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 the deviations of the image (e.g. highlighted image vs not highlighted image)

0.9

Processing Mode

Determines how the search image and the screen image shall be pre-processed. The engine has the possibility of smoothing the image which can help to overcome text aliasing or rendering differences on different systems.

When using smooth, make sure that your search image contains as little space around the text or icon as possible (in other words, the color should not change just outside of the search image).

None

Target Project

Determines for which project of solution should the image be saved.

TC001_Rev1

Saving the image

In order to save the image simply press the Save Image button . You will be prompted with the Windows Explorer where you will be able to save your image to the desired location.

Save the image in a directory which is a part of the selected project. Otherwise the designer might have problems in locating the desired image.