This article describes the RPA Screen functionality to count image matches on the screen.

For a full list of available functions, please read SCREEN functions.

Description

The SCREEN Count image matches on screen function counts how many times a specified image appears on the screen.

Setting it up

To use the SCREEN Count image matches on screen function, follow these instructions:

Once on a process map:

Navigate to the process where you would like to add the SCREEN Count image matches on screen function
Click on the green button's drop-down (right side of the green button labelled "Process")
On the menu that appears, click on the "+ Activity" item
From here you can select the SCREEN Count image matches on screen option
Click "Add" once you are done

Parameter	Required	Type	Default	Description
Image path	Yes	Text	-	The file path to the reference image to count on screen
Confidence	No	Number (0.0-1.0)	0.9	The minimum confidence threshold for a match
Region	No	Array [x, y, w, h]	-	Restrict the search to a specific screen region
Variable	No	Text	count	The variable name to store the result

The {count} variable contains an integer representing the number of matches found.

Error	Description
Image file not found	The specified image file path does not exist

Use this function to count items like rows, icons, or notification badges visible on the screen