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
Last revision Both sides next revision
condition:Found_Image [2016/03/03 17:58]
JMichaelTX ADDed screenshots, added sections, reformat instructions
condition:Found_Image [2018/01/18 21:13]
JMichaelTX ADD FoundImage token ref
Line 2: Line 2:
 ====== 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.txt · Last modified: 2019/07/08 01:17 by peternlewis