This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
condition:Found_Image [2016/03/03 17:58] JMichaelTX ADDed screenshots, added sections, reformat instructions |
condition:Found_Image [2016/03/03 23:14] peternlewis |
||
---|---|---|---|
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 |}} |
+ | ===== How To Use ===== | ||
- | It can be used with a variety of [[:Actions|Macro Actions]]. Two of the most common are: | + | {{page>::Found_Image#How To Use&noheader&nofooter}} |
- | * [[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|}} | + | ===== Related ===== |
- | {{:condition:km-find-image-action.png?nolink|}} | + | |
- | + | ||
- | + | ||
- | ---- | + | |
- | + | ||
- | ===== How To Use ===== | + | |
- | - **Add an [[:Actions|Action]] which uses Found Image to your [[:Macros|Macro]]** | + | |
- | * [[action:Move_or_Click_Mouse|Move or Click Mouse]] | + | |
- | * [[action:Find_Image_on_Screen|Find Image on Screen]] | + | |
- | * [[action:If_Then_Else|If Then Else]] | + | |
- | * [[action:Pause_Until]] | + | |
- | * [[action:While]]\\ . | + | |
- | - **Configure the Action** | + | |
- | - **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]]) | + | |
- | * To view the image in the image well, click on it and press <key>SPACE</key> | + | |
- | - **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. | + | |
- | - **Optionally highlight Found Matches** | + | |
- | * Can be helpful in determining the right amount of fuzz to use. | + | |
- | - **Choose Where to Search for Image** | + | |
- | * All screens | + | |
- | * Main screen | + | |
- | * Specified screen (counting from the left) | + | |
- | * Front window | + | |
- | * Window with a specified title | + | |
- | * 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. | + | See also the [Found Images](https://wiki.keyboardmaestro.com/collection/Found_Images) collection, [Move or Click Mouse](https://wiki.keyboardmaestro.com/action/Move_or_Click_Mouse) action, and [Find Image on Screen](https://wiki.keyboardmaestro.com/action/Find_Image_on_Screen) action. |