Help files

Wait for Image Action

Description:

This action waits until a specific image appears on the screen or on the foreground window. This action uses the Image Recognition feature.

waitforimage.png
Properties:

Image to wait for:

Select the Image that the action will wait to see. If you need to open a menu or perform steps first, choose 'Capture with Delay'.

Search for Image on:

Choose whether you want to search for the specified Image in the foreground Window only, or the entire visible screen. Neither choice will find the Image if it is not clearly visible on the screen.

Search Mode:

Specify whether you want to scan the entire screen (or window) to find the supplied image or only a narrowed down subregion of it.

X1, Y1, X2, Y2:

Specify the subregion of the screen or window to narrow down the scan for the supplied image to. You can visually select a subregion of the screen or window by pressing the "Select a Different Subregion" button.

Tolerance:

Specify a value for how much the Image searched for can differ from the originally chosen Image.

Fail if image does not appear:

Choose whether the action will throw an exception after a set number of seconds if the specified Image has not been found. Then go to the Exception Handling tab at top to specify how the Exception will be handled. Otherwise, the Process will stop and issue an error message.

Location of Image Found:

Enter the names to be the variables that will hold the X and Y coordinates of the point where the image is found on the screen. If the image is being searched for on the foreground window, the coordinates returned are relative to the top left corner of the window.