IMAGESEARCH
(Copy URL in PhpBB Forum Format - Info)From iMacros
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.
Contents |
Syntax 
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. The smaller the input image, the faster the search.
- CONFIDENCE
- The confidence level, i.e. level of similarity between the input and the remote picture. Must between 1 and 100. Typically values between 40...100 give good and reliable results.
- ALGORITHM (default if unspecified = B)
- Optional parameter to select the image recognition algorithm:
- "A" uses a classic machine vision algorithm based on edge detection.
- "B" uses a new, general purpose algorithm optimized for web pages.
- For typical websites we recommend algorithm B. Method B will be useful if your website or image changes color, as method B switches automatically to grey scale mode when the confidence level is set to 90 or below, so color changes are ignored.
- Optional parameter to select the image recognition algorithm:
Notes
FAQ:
Q: Can IMAGESEARCH find items "below the fold" (on the web page but not currently displayed in the browser window)?
A: Yes! IMAGESEARCH works by scanning the entire web page, even the parts that aren't visible in the browser window.
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.png CONFIDENCE=100
Q: I would like to know how to change the number of retries 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
See Also
Image Recognition, IMAGECLICK, DS, Which technologies are supported in tray/silent mode
