Differences

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

--- condition:Found_Image [2016/03/03 22:58] – ADDed screenshots, added sections, reformat instructions JMichaelTX
+++ condition:Found_Image [2019/07/08 05:17] (current) – peternlewis
@@ Line 1: / Line 1: @@
-{{:condition:image-icon.png?nolink|}}
 ====== Found Image Condition ======
+The //Found Image [[:Conditions|condition]]// tests for a matching image on your screen(s) or windows.
-The //Found Image [[:Conditions|condition]]// looks for a matching image on your screen(s) or windows.
+===== Example =====
-===== Example Actions =====
+{{ :condition:pause-until-screen-contains.png?nolink&668 |}}
+After an Action like this is executed, and an image was found, then the [[token:FoundImage|%FoundImage%]] token (v8+) will return the coordinates, size, and fuzz of the image.
-It can be used with a variety of [[:Actions|Macro Actions]].  Two of the most common are:
+===== How To Use =====
-  * [[action:Move_or_Click_Mouse|Move or Click Mouse]]
-  * [[action:Find_Image_on_Screen|Find Image on Screen]]
-{{:condition:km-move-and-click-action.png?nolink|}}
+{{page>::Found_Image#How To Use&noheader&nofooter}}
-{{:condition:km-find-image-action.png?nolink|}}
+===== See Also =====
-----
+==== Actions ====
-===== How To Use =====
+* [[action:Find Image on Screen|Find Image on Screen]]
-  - **Add an [[:Actions|Action]] which uses Found Image to your [[:Macros|Macro]]**
+* [[action:Move or Click Mouse|Move or Click Mouse]]
-    * [[action:Move_or_Click_Mouse|Move or Click Mouse]]
+* [[:Actions|See all Actions]]
-    * [[action:Find_Image_on_Screen|Find Image on Screen]]
-    * [[action:If_Then_Else|If Then Else]]
+==== Collections ====
-    * [[action:Pause_Until]]
-    * [[action:While]]\\ .
+* [[collection:Found Images|Found Images]]
-  - **Configure the Action**
+* [[:Collections |See all Collections]]
-    - **Specify the image to match**
-      * Paste an image into the image well\\ (Use <key>⌘</key><key>⇧</key><key>4</key> [[https://support.apple.com/en-us/HT201361|to Take a screenshot of part of your screen]])
+====  Conditions ====
-      * To view the image in the image well, click on it and press <key>SPACE</key>
-    - **Specify the amount of fuzziness allowed**
+* [[:Conditions|See all Conditions]]
-        * Because of transparency and anti-aliasing almost all screen matches are fuzzy to some degree
-        * But usually about 20% is a good place to start.
+==== Tokens ====
-    - **Optionally highlight Found Matches**
-        * Can be helpful in determining the right amount of fuzz to use.
+* [[token:FoundImage|FoundImage]]
-    - **Choose Where to Search for Image**
-      * All screens
+==== Forum ====
-      * Main screen
-      * Specified screen (counting from the left)
+- [[https://forum.keyboardmaestro.com/t/how-to-search-for-multiple-found-image-actions/3093|How To Search For Multiple "Found Image" Actions]]
-      * Front window
-      * Window with a specified title
+- [[https://forum.keyboardmaestro.com/search?q=%22Found%20Images%22|Keyboard Maestro Forum topics about Found Images]]
-      * Window with a title containing a given string
-      * Window with a title matching a given regular expression
-      * Specified window (counting from the frontmost window)
-      * Specified area on the screen
-Remember when specifying the area, as with all [numeric fields](:Text_Fields), the numbers can be calculations including [functions](:Functions), and the fields expand to allow for longer expressions as soon as you type something other than a number, so this allows very precise control of where you can match.