Welcome to the Ranorex Support Portal

Image editor

When using image-based testing, it’s often necessary or useful to edit the captured screenshots for better results. Ranorex Studio has a simple built-in image editor for this purpose. On this page, we’ll explain how it works and what functions it offers.

In this chapter

Start the image editor

To start the image editor:

  1. In the actions table, click the breadcrumbs  next to a screenshot.

  2. The image editor opens, displaying the screenshot.

Image editor functions

  1. Select image find region: Select a region in the image by dragging a rectangle. This region is what Ranorex Studio will try to find during test execution.

  2. Select image ignore region: Select one or more regions by dragging a rectangle. Ranorex Studio will ignore these regions when trying to find the image find region during test execution.

Note Icon


This function works differently depending on what mechanism Ranorex Studio uses in an action to identify an image-find region during execution. There are two mechanisms: CompareImage and ContainsImage. They are based on the available image-based validations in Ranorex Studio.

All non-validation actions (Mouse click, Key sequence, etc.) use ContainsImage. Validations can use one or the other.

In short: For ContainsImage, image-find and image-ignore regions should not overlap (likely test failure). For CompareImage, the image-ignore region must be inside the image-find region. For more details, refer to CompareImage/ContainsImage under Validation in ⇢ Action properties.

  1. Autoselect image find region: Click an area to auto-select a viable image find region.

  2. Zoom in/out: Lets you zoom in and out. Press the middle button to reset the zoom to 100 %.

  3. Crop function: First click the Select image find region button and specify a region. Then click the crop button to crop the image to that region.

Note Icon


A single image may be used for several validations. Therefore, be careful with cropping an image because you may lose important validation information.

Note Icon


Cropping overwrites the previous image. If you used the image in other actions as well, they may not work correctly with the new cropped image.

Cropping confirmation dialog
  1. New screenshot: Lets you add another screenshot. Useful if something changed in the UI. When adding a new screenshot, it will be stored under the respective repository item along with the previous screenshot. Use the drop-down menu to choose between available screenshots.

  1. Open screenshot from file: Same as adding a new screenshot, except that you browse to an existing file on your computer



Get the latest test automation information right in your mailbox.


© 2024 Ranorex GmbH. All Rights Reserved