The renewal maintenance has officially ended for Progress iMacros effective November 30, 2023.
This Wiki site will also no longer be moderated from the Progress side.
Thank you again for your business and support.
Sincerely, The Progress Team
IMAGESEARCH
Searches for the input image specified via the IMAGE attribute. The input image is searched on the currently displayed website using image recognition algorithms. CONFIDENCE specifies how closely the found image must match the input image. A value of 100 means exact match. If the input image is not found at the given confidence level an error occurs.
If the image is found then !IMAGEX and !IMAGEY hold the coordinates of where it was found.
Syntax
IMAGESEARCH IMAGE=image_file CONFIDENCE=n
Since iMacros V6.30
IMAGESEARCH POS=<n> IMAGE=image_file CONFIDENCE=n [ALGORITHM=A/B]
Parameters
- POS
- Find the n-th image. Same as the POS attribute in TAG
- IMAGE
- The path to the image to be searched. Supported file formats are BMP and PNG.
- CONFIDENCE
- The confidence level, i.e. level of similarity between the input and the remote picture. Must between 1 and 100.
- ALGORITHM (default if unspecified = B)
- Optional parameter to select the image recognition algorithm:
- "A" stands for a new, general purpose algorithm optimized for web pages.
- "B" uses a classic machine vision algorithm based on edge detection.
- For typical websites we recommend algorithm A. Algorithm A is also more tolerant of other formats (e.g. gif).
- Method B will be useful if your website or image changes color, as method B is color-blind (it looks at shapes and shades of grey).
- Optional parameter to select the image recognition algorithm:
The time used by the IMAGESEARCH command is added to the measured response time. If you use a CONFIDENCE value below 100 then the image recognition search can take a few seconds (depending on your PC and the size of the image you look for). The smaller the searched image the faster is the search.
If speed is critical we recommend using CONFIDENCE=100. In this case only a very fast binary comparison is done. When the image does not change size or color, the binary comparison can be used.
Notes
IMAGESEARCH is currently not supported in silent or tray modes.
FAQ:
Q: Is it possible to set the folder that the IMAGESEARCH command uses to load images from? It seems to default to: C:\Users\Public\Documents\iMacros\datasources\
A: There are two options
- Change the default datasource folder
- Or, use the specific path directly in the command, e. g. IMAGESEARCH IMAGE=d:\testimages\image1.bmp CONFIDENCE=100
Q: I would like to know how to change the number ofretries" for the image recognition feature.
A: You can do this with SET !TIMEOUT_STEP <x>
x = number of retries, default = 6 (one retry each second)
Examples
Example macro: Demo-ImageRecognition