Wait for Image

Pauses the execution of macro until a specific image is (or not) found on the screen, or wait for the specified area on the screen to be changed. "Wait for Image" is an extremely useful action. You can use it to inspect whether the processing has been completed.


  • Wait type Specifies whether to wait until the image to be (or not) found on the screen, or the specified area on the screen changes.

  • Image file name Specifies the path name of the image files. When more than one file is used, only first file should be full-path name if all files are in a folder. Every file must be separated by the semicolon (;) from each other. For example: f:\2.bmp;3.bmp;4.bmp.

  • Tolerance Specifies the value (0 - 10) for how much the image searched for can differ from the specified image.

  • Color of transparent pixels Specifies the color of transparent pixels. Transparent pixels will be ignored during searching.

  • Convert image to shape for searching Specifies whether to use shape searching mode. The shape searching mode converts the color image to the binary before searching for the image. It improves search result in case where the color changes.

  • Search area Specifies the area of searching for.

  • Carry out action if image does appear Chooses what action should be executed if the image is found. It can be one of the follow actions:

    • Do nothing
    • Move mouse pointer to position
    • Click mouse button at position
    • Double-click mouse button at position
    • Hold down mouse button
    • Release mouse button at position
  • Which button Chooses which mouse button.

  • Offset position of image found Specifies whether to offset the position of the image found. It can be one of the follow:

    • Left-top of image (default)
    • Center of image
    • Right-top of image
    • Left-bottom of image
    • Right-bottom of image
  • Return coordinates into variables If the image is found on the screen, return the X and Y coordinate.

    • Populate variable with X Specifies a variable to store the coordinate X.

    • Populate variable with Y Specifies a variable to store the coordinate Y.


For time-out options, please refer to "Time out".