Differences

This shows you the differences between two versions of the page.

--- Found_Image [2019/07/08 05:02] – peternlewis
+++ Found_Image [2024/10/12 09:23] (current) – [Specifying Fields in Found Image Actions] peternlewis
@@ Line 1: / Line 1: @@
 ====== 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.
@@ Line 20: / Line 20: @@
       * 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.
-      * 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**
@@ Line 34: / Line 34: @@
   * You can search in all screens, or on a specific screen.
   * 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.
     * 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 }}
+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 =====