User Tools

Site Tools


condition:Found_Image

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
condition:Found_Image [2016/03/03 17:58]
JMichaelTX ADDed screenshots, added sections, reformat instructions
condition:Found_Image [2019/07/08 01:17] (current)
peternlewis
Line 1: Line 1:
-{{:​condition:​image-icon.png?​nolink|}} 
 ====== Found Image Condition ====== ====== 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. 
condition/Found_Image.1457045919.txt.gz · Last modified: 2016/03/03 17:58 by JMichaelTX