User Tools
Found_Image
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision | Next revision Both sides next revision | ||
|
Found_Image [2019/07/08 00:35] peternlewis [Search in Specified Area] |
Found_Image [2019/07/08 01:02] peternlewis |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | {{:condition:image-icon.png?nolink|}} | ||
| ====== Found Image ====== | ====== Found Image ====== | ||
| Line 6: | Line 5: | ||
| There are various actions ([[action:Move or Click Mouse|Move or Click Mouse]], [[action:Find Image on Screen|Find Image on Screen]], [[condition:Found Image|conditions]] and [[collection:Found Images|collections]] that search the screen for a matching image. | There are various actions ([[action:Move or Click Mouse|Move or Click Mouse]], [[action:Find Image on Screen|Find Image on Screen]], [[condition:Found Image|conditions]] and [[collection:Found Images|collections]] that search the screen for a matching image. | ||
| - | **Example: Click on Found Image**\\ | + | ===== Example Click on Found Image ===== |
| - | This is how the Action appears when first inserted into your macro.{{:click-found-image-action-initial-setup-km-7.3.png?nolink|}} | + | |
| + | This is how the Action appears when first inserted into your macro. | ||
| + | {{ action:clickatfoundimagedescription.png?nolink&611x290 | Click at Found Image Description }} | ||
| ===== How To Use ===== | ===== How To Use ===== | ||
| + | |||
| ==== Specifying Fields in Found Image Actions ==== | ==== Specifying Fields in Found Image Actions ==== | ||
| Line 19: | Line 20: | ||
| * To view the image in the image well, click on it and press <key>SPACE</key>. | * To view the image in the image well, click on it and press <key>SPACE</key>. | ||
| * You can copy the image from the Image Well. | * You can copy the image from the Image Well. | ||
| + | * Alternatively (v9.0+), you can get the image to search from the System Clipboard, Trigger Clipboard, a Named Clipboard, a file, or from an image elsewhere on the screen. | ||
| - **Specify the amount of fuzziness allowed** | - **Specify the amount of fuzziness allowed** | ||
| * Because of transparency and anti-aliasing almost all screen matches are fuzzy to some degree. | * 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. | * But usually about 20% is a good place to start. | ||
| - | - **//Must be Unique// Checkbox** | + | - **//Unique// Menu** |
| - | * If //checked//, then the image must be the only image in the specified area, or the //Action// will fail. | + | * By default, the image must be unique on the screen so that Keyboard Maestro knows where to click, otherwise the action will fail. |
| - | * If //not checked//, then best one of the images (based on an internal algorithm) will be selected. If there are multiple similarly good matches then it is unpredictable which one will be used. | + | * Alternatively, you can have Keyboard Maestro click based on the best match, or (v9.0+) click on the topmost, leftmost, bottommost, or rightmost match. |
| - **//Display// Checkbox -- If //checked//, it will highlight on the screen all found matches** | - **//Display// Checkbox -- If //checked//, it will highlight on the screen all found matches** | ||
| * This can be helpful in debugging, like determining the right amount of fuzz to use. | * This can be helpful in debugging, like determining the right amount of fuzz to use. | ||
| * It will also show when an image is being found in more than one location. | * It will also show when an image is being found in more than one location. | ||
| - **Choose Where to Search for Image** | - **Choose Where to Search for Image** | ||
| - | * All screens. | + | * You can search in all screens, or on a specific screen. |
| - | * Main screen. | + | * Alternatively, you can search within a specific window. |
| - | * Specified screen (counting from the left). | + | * Or you can search within a specific area on the screen. |
| - | * 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. | + | |
| * For instructions on how to get data for area, see [Determine Location of Area to Search for Found Image](https://forum.keyboardmaestro.com/t/using-mouse-display-window-to-get-window-specific-locations/7112/9) | * For instructions on how to get data for area, see [Determine Location of Area to Search for Found Image](https://forum.keyboardmaestro.com/t/using-mouse-display-window-to-get-window-specific-locations/7112/9) | ||
| Line 53: | Line 49: | ||
| Keyboard Maestro uses a relatively fast search to make the action perform in a reasonable amount of time, but it can result in not finding some images. | Keyboard Maestro uses a relatively fast search to make the action perform in a reasonable amount of time, but it can result in not finding some images. | ||
| * Images Difficult to Match | * Images Difficult to Match | ||
| - | * The most difficult images to match are small grey images (like icons or text). | + | * The most difficult images to match are small grey images (like grey icons or text). |
| * Since the screen tends to be filled with small grey areas, it is hard for Keyboard Maestro to find the best locations to look. | * Since the screen tends to be filled with small grey areas, it is hard for Keyboard Maestro to find the best locations to look. | ||
| * Increasing Search Accuracy | * Increasing Search Accuracy | ||
| - | * Set Search Area to less than a quarter of the whole desktop | + | * Set Search Area to less than a quarter of the whole desktop. |
| - | * This will improve ability to find smaller images that have low contrast | + | * This will improve ability to find smaller images that have low contrast. |
| ===== Testing ===== | ===== Testing ===== | ||
| Line 63: | Line 59: | ||
| When testing found image macros: | When testing found image macros: | ||
| - | * ALWAYS hide the Keyboard Maestro editor – as the image in the found image action may be found too under some circumstances. | + | * Hide the action or the Keyboard Maestro editor as the image within the action may be found. |
| - | * ALWAYS turn ON the “Display” checkmark, so you get visual confirmation an image has been found. | + | * Turn on the “Display” checkmark, so you get visual confirmation an image has been found. |
| - | * If the image is NOT found ALWAYS play with the fuzz slider. | + | * If the image is not found, play with the fuzz slider. |
| - | * It's generally a good idea to initially test on the main monitor in the front window. | + | |
Found_Image.txt · Last modified: 2023/09/12 04:11 by peternlewis
Page Tools
