This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
Found_Image [2019/07/08 01:02] peternlewis |
Found_Image [2024/10/12 05:23] (current) peternlewis [Specifying Fields in Found Image Actions] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Found Image ====== | ====== Found Image ====== | ||
- | Although it is generally better to use high level actions like Press Button or Resize Window, it is sometimes necessary to resort to looking at the screen for a specific image and responding appropriately (behaving differently if it exists, clicking on it, moving things to it, etc). | + | Although it is generally better to use high level actions like [[action:Press_a_Button|Press Button]] or [[action:Resize_a_Window|Resize Window]] action, it is sometimes necessary to resort to looking at the screen for a specific image and responding appropriately (behaving differently if it exists, clicking on it, moving things to it, etc). |
There are various actions ([[action:Move or Click Mouse|Move or Click Mouse]], [[action:Find Image on Screen|Find Image on Screen]], [[condition:Found Image|conditions]] and [[collection:Found Images|collections]] that search the screen for a matching image. | There are various actions ([[action:Move or Click Mouse|Move or Click Mouse]], [[action:Find Image on Screen|Find Image on Screen]], [[condition:Found Image|conditions]] and [[collection:Found Images|collections]] that search the screen for a matching image. | ||
Line 20: | Line 20: | ||
* To view the image in the image well, click on it and press <key>SPACE</key>. | * To view the image in the image well, click on it and press <key>SPACE</key>. | ||
* You can copy the image from the Image Well. | * You can copy the image from the Image Well. | ||
- | * Alternatively (v9.0+), you can get the image to search from the System Clipboard, Trigger Clipboard, a Named Clipboard, a file, or from an image elsewhere on the screen. | + | * Alternatively, you can get the image to search from the System Clipboard, Trigger Clipboard, a Named Clipboard, an Icon, a file, or from an image elsewhere on the screen. |
- **Specify the amount of fuzziness allowed** | - **Specify the amount of fuzziness allowed** | ||
Line 34: | Line 34: | ||
* You can search in all screens, or on a specific screen. | * You can search in all screens, or on a specific screen. | ||
* Alternatively, you can search within a specific window. | * Alternatively, you can search within a specific window. | ||
+ | * However, the window must be in the frontmost, active, application, in order for it to be seen by this Action. | ||
* Or you can search within a specific area on the screen. | * Or you can search within a specific area on the screen. | ||
* For instructions on how to get data for area, see [Determine Location of Area to Search for Found Image](https://forum.keyboardmaestro.com/t/using-mouse-display-window-to-get-window-specific-locations/7112/9) | * For instructions on how to get data for area, see [Determine Location of Area to Search for Found Image](https://forum.keyboardmaestro.com/t/using-mouse-display-window-to-get-window-specific-locations/7112/9) | ||
Line 44: | Line 45: | ||
{{ action:click-found-image-action-example.png?nolink&503x407 | Click at Found Image Example }} | {{ action:click-found-image-action-example.png?nolink&503x407 | Click at Found Image Example }} | ||
+ | |||
+ | Note that in the above screen shot, the `WINDOW(0,Left)` function is referring to the frontmost window in the frontmost app. To refer to other windows in the frontmost app, you need to change the `index` parameter of the [[function:WINDOW|WINDOW function]]. | ||
===== Search Speed and Accuracy ===== | ===== Search Speed and Accuracy ===== |