Image Search

Searches a region of the screen for an image.

Image Search (F7)

Parameters

Start X/Y / End X/Y
Defines the Search area of the screen/window.
Make Screenshot
Use this tool to take a screenshot of an area of the screen (see Instructions for details on usage).
File
Path for the image file, which is assumed to be in the same folder as MacroCreator.exe if an absolute path isn't specified. This field accepts Variables & Expressions.
Search
Opens the File Select dialog to select an Image File.
If found
Selects an action to execute when an image/pixel is found.
To execute a different action Select 'Continue' (or 'Break' to exit the command's loop) and use the 'If Image/Pixel Found' option in the If Statements window.
If not found / Error
Selects an action to execute when an image/pixel is not found or if the command finds an error.
To execute a different action Select 'Continue' (or 'Break' to exit the command's loop) and use the 'If Image/Pixel Not Found' option in the If Statements window.
Add "If Statement"
Automatically adds an If Image/Pixel Found statement below the command. You may select a range of rows to be wrapped by the statement block.
Preview
Previews the selected image.
Double-Click an image to open the file with the associated application.
Variables
Names of the Output variables where to store the X and Y coordinates when found.
Adjust coordinates to the center of the image
Check this option to automatically correct the coordinates in the output variables to the center of the image, instead of the upper-left corner.
Coord
Sets coordinate mode for the search to be relative to either the active window or the screen.
Variations
Specify for n a number between 0 and 255 (inclusive) to indicate the allowed number of shades of variation in either direction for the intensity of the red, green, and blue components of each pixel's color.
Icon
Specify for n a number between 0 and 255 (inclusive) to indicate the allowed number of shades of variation in either direction for the intensity of the red, green, and blue components of each pixel's color.
Transparent
Specify one color within the image that will match any color on the screen.
Scale
Width and height to which to scale the image (this width and height also determines which icon to load from a multi-icon .ICO file).
Repeat until
Loops the command until the image is found or not found, according to the option selected.
When this option is checked you can use the Repeat counter to define the maximum number of times to search. If Repeat is 1, it will loop indefinitely until the image is found/not found or the user stops execution. And if it's a number higher than 1 or a variable, it will loop until the image is found/not found but no more than that number.

Remarks

You may use the variables %FoundX% and %FoundY% (or the ones defined by you) in other commands like Mouse Move & Click when the image/pixel is found. To save the values to a different variable or increment the values, use the Variables window.

ImageSearch

Make Screenshot Tool Instructions

Make Screenshot

Make Screenshot of a Control

Make Screenshot of Window

Adjust the area of the Screenshot

Set Region to the same area of the Screenshot