User Tools

Site Tools


en:actions:actionfindimage

This is an old revision of the document!


Find image

This action allows you to search for an image on the screen, on a window or on another image.

[Added in Actionaz 3.2.0.]

Standard parameters

Input parameters

Source

The source of the image where to search.

  • Screenshot (search on the screen)
  • Window (search on a window)
  • Image (search in another image)
Window name

The title of the window where to search. You can use wildcards here like * (any character) or ? (one character).

Window relative position

The position is relative to the window. If this parameter is set to false (not checked) then the position is absolute.

Image where to seach

The path of the image where to search.

Output parameters

Position

The name of the variable where to search for the image. If the image cannot be found an exception is triggered.

Advanced parameters

Input parameters

Confidence minimum

The minimum confidence percentage required to select a possible matching image.

Maximum matches

The maximum matching images count. Setting this parameter higher will increase the duration of the search.

Down pyramid count

The number of down pyramids to use. A pyramid is a subdivision of the image used to accelerate the search. Enter 1 here if the searched image is not very different from the source image.

Search expansion

The number of pixels to shift when searching for another matching image.

Exceptions

Error while searching

<BOOKMARK:errorwhilesearching>

This exception is thrown when an error occured while searching.

  • Default action: stop the script execution

Cannot find the image

<BOOKMARK:cannotfindimage>

[Removed in Actionaz 3.7.0.]

This exception is thrown when the image cannot be found.

  • Default action: stop the script execution
en/actions/actionfindimage.1372499234.txt.gz · Last modified: 2021/02/13 11:23 (external edit)