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
- Click and hold the Draw Button (button can be changed in options) and drag to create a rectangle of the area.
- Release (or press Enter if set in options) to make the screenshot.
Make Screenshot of a Control
- Point the mouse to the control area (the control's name should be showing in the tooltip).
- Click and release the button without moving.
Make Screenshot of Window
- Point the mouse to an area where no control name is shown.
- Click and release the button without moving.
Adjust the area of the Screenshot
- Go to Settings > Screenshots (you can use the Options button in the Image/Pixel Search command window) and check the option Press Enter to capture.
- Follow on of the instructions above. Now when you draw a rectangle it will remain visible in the screen until you press Enter.
- Use the hotkeys Ctrl + Arrow keys to move the selection area and Shift + Arrow keys to resize it.
Set Region to the same area of the Screenshot
- Hold the Alt key in the keyboard right before releasing the mouse button, or pressing Enter, to automatically set the Region area to the same as the area of the screenshot taken.