This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
condition:Found_Image [2015/08/02 20:58] peternlewis |
condition:Found_Image [2018/01/18 21:13] JMichaelTX ADD FoundImage token ref |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | The //Found Image condition// looks on your screen for a matching image. | + | {{:condition:image-icon.png?nolink|}} |
+ | ====== Found Image Condition ====== | ||
- | You specify the image to match (usually got with a Command-Control-Shift-4 screen capture) by pasting an image into the image well. You also specify the amount of fuzziness allowed — 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. | + | The //Found Image [[:Conditions|condition]]// tests for a matching image on your screen(s) or windows. |
- | You can optionally display all the matches on the screen which can be helpful in determining the right amount of fuzz to use. | + | ===== Example ===== |
- | You can search for the image on: | + | {{ :condition:pause-until-screen-contains.png?nolink&668 |}} |
- | * all screens. | + | 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. |
- | * the main screen. | + | |
- | * the specified screen (counting from the left). | + | |
- | * the front window. | + | |
- | * the window with a specified title. | + | |
- | * the window with a title containing a given string. | + | |
- | * the window with a title matching a given regular expression. | + | |
- | * the specified window (counting from the frontmost window). | + | |
- | * a 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. | + | ===== How To Use ===== |
+ | |||
+ | {{page>::Found_Image#How To Use&noheader&nofooter}} | ||
+ | |||
+ | ===== See Also ===== | ||
+ | |||
+ | === Actions === | ||
+ | |||
+ | * [[action:Find Image on Screen|Find Image on Screen]] | ||
+ | * [[action:Move or Click Mouse|Move or Click Mouse]] | ||
+ | * [[:Actions|See all Actions]] | ||
+ | |||
+ | === Collections === | ||
+ | |||
+ | * [[collection:Found Images|Found Images]] | ||
+ | * [[:Collections |See all Collections]] | ||
+ | |||
+ | === Conditions === | ||
+ | |||
+ | * [[:Conditions|See all Conditions]] | ||
+ | |||
+ | === Tokens === | ||
+ | |||
+ | * [[token:FoundImage|FoundImage]] | ||
+ | |||
+ | ==== Forum ==== | ||
+ | |||
+ | - [[https://forum.keyboardmaestro.com/t/how-to-search-for-multiple-found-image-actions/3093|How To Search For Multiple "Found Image" Actions]] | ||
+ | |||
+ | - [[https://forum.keyboardmaestro.com/search?q=%22Found%20Images%22|Keyboard Maestro Forum topics about Found Images]] | ||