This shows you the differences between two versions of the page.
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. |