Click on the image Version 4 (Python)

Action group: Vision

Description

The action clicks on the image. 

Action icon

Parameters

Input parameters

Image - path to the template image file. Supported image formats: (jpeg, jpg, bmp, png, tif, tiff). 

Click option - mouse click options (right mouse button, left mouse button, double click). 

Similarity rate - the similarity index between the template and the searched image. The maximum value is "1". 

Element index - order number of the element of the found images collection, numbering starts from 0. Type - Robin.Numeric. Field must be filled in, it's mandatory. 

X-axis shift - the number of pixels by which the coordinate point will move horizontally from the center of the found image. 

Y-axis shift - the number of pixels by which the coordinate point will move vertically from the center of the found image. 

Timeout (ms) - time in milliseconds during which the image will be searched.

Search area - if the field is filled in, the search is performed only within the specified area.

Settings

Property

Description

Type

Filling example

Mandatory field

Параметры

Image

Path to the template image file. Supported image formats: (jpeg, jpg, bmp, png, tif, tiff).

Robin.Image

C:\doc\img.png

Yes

Click option

Mouse click options.

Robin.String


Yes

Similarity rate

The similarity index between the image indicated in the action and the image on the screen.

Robin.Numeric


Yes

Element index

Order number of the element in the collection of found image coordinates. Numbering starts from 0.

Robin.Numeric


Yes

X-axis shift

The number of pixels by which the coordinate point will move horizontally from the center of the found image.

Robin.Numeric


No

Y-axis shift

The number of pixels by which the coordinate point will move vertically from the center of the found image.

Robin.Numeric


No

Timeout, ms

Time in milliseconds during which the image will be searched.

Robin.Numeric


Yes

Search areaIf the field is filled in, the search is performed only within the specified area.Robin.RectangleL ocation
No

Special conditions of use

If the image that the action is trying to click on does not appear on the screen, the robot will exit with an error related to the end of the timeout.

Example of use

Task  

There is an open document, click left mouse button in the "View all tools" tab.

Solution

Use the "Click on the image" action. 

Implementation 

  1. Assemble a robot scheme with the actions: 


  2. Transfer the "Click on the image" action to the workspace and set its parameters. Beforehand, take a screenshot of the image to be clicked by the robot.


  3. Click on the "Start" button in the top panel. 

Result

The program robot completed successfully. The given image was clicked on. 

The "View all tools" tab is active.