Screen Actions

Actions in the Screen group. They narrow down where the robot looks, which both speeds up detection and removes false matches.

Set Working Area

Restricts all following searches to one region of the screen. Everything outside it is ignored until the area is removed.

📸 Screenshot needed — /img/editor/actions/screen/working_area.png

Capture: the Set Working Area form together with the live view showing the restricted region highlighted.

Parameter	Description
Search object	The region for subsequent searches. Use an Area for a fixed rectangle or a CustomBox to derive the region from an element.

Remove Working Area

Resets the search region back to the whole screen. Takes no parameters.

note

Renamed from Reset Working Area.

Add Mask

Hides part of the screen from the detection model. Masking out a noisy region — a scrolling log, an advertisement, a clock — makes the elements you care about easier to find.

📸 Screenshot needed — /img/editor/actions/screen/mask.png

Capture: the Add Mask form plus a live view with a mask applied, so the darkened region is visible.

Parameter	Description
Search object	Element or area that defines the mask.
Inside	When on (default), the inside of the selected region is masked. When off, everything outside it is masked.

Remove Masks

Removes every mask currently applied. Takes no parameters.

note

Renamed from Clear Masks.

---

Working area vs. mask

• Set Working Area changes where the robot searches — the fastest way to disambiguate a value that appears identically in two panes.
• Add Mask changes what the robot can see — use it to stop irrelevant, changing content from confusing detection.

Both are stateful and stay in force until removed, so pair each one with its Remove counterpart at the end of the section. A left-over working area is a common cause of "the element is right there but the robot cannot find it".