Image Not Found

This dialog automatically opens during the execution of tests in the Squish IDE if a ScreenRectangle findImage(imageFile, [parameterMap], [searchRegion]) function fails to find a specific occurrence of the template image or the ScreenRectangle waitForImage(imageFile, [parameterMap], [searchRegion]) function runs into the specified (or default) timeout.

"Image Not Found dialog"

The dialog shows the template image(s) that were not found on the desktop screenshot, and the latest desktop screenshot used for image search. You can try to solve the error in the following ways.

Click the Update Image button to open the Image Selection Editor view, where you can select a new image that replaces the failed image that you selected in the Image Not Found dialog.

Click the Add New Image button to open the Image Selection Editor view, where you can select a new image. The selected image is added to the image group that was not found on the desktop. If a single image was used in the image search, it will be converted into a group.

Click the Adjust Search Parameters button to open the Image Search Preview dialog, where you can adjust image search parameters, such as the tolerance, and observe the results.

Click the Throw Error button to let the test execution continue and generate the appropriate error. This may end the test unless the test script catches the lookup error to recover from it itself.

Click the Retry button to re-execute the image search. It can be useful to determine if the image search error is triggered because the image takes longer to appear on the screen than the timeout. If you introduced changes to the search image(s), the new template images are used.

Select the Do not show this dialog again checkbox and click the Throw Error button to hide the dialog on any future lookup errors until you re-enable it in the Playback preferences pane.

If you select the Attempt to fix image search errors automatically option and click the Retry button, the Squish IDE attempts to fix any subsequent image search errors by adjusting the default tolerance and image resize range.