Skip to main content
Version: 0.23.1

Special Objects

These objects do not represent interactive controls. They describe regions of the screen and are used mainly by the Screen actionsSet Working Area and Add Mask.

Area

A fixed rectangle given in screen coordinates. Create one in the live view with Add New Box, then drag its edges.

ParameterDescription
X minLeft edge of the rectangle.
Y minTop edge.
X maxRight edge.
Y maxBottom edge.
📸 Screenshot needed — /img/editor/objects/so-area.png

Capture: the live view with an Area box drawn over a region, and the parameter editor next to it showing all four coordinate fields. Why it must be retaken: the toolbar button is now called Add New Box.

warning

Coordinates are absolute. An Area stops working as soon as the window moves, the resolution changes or the remote session reconnects at a different size. Use it for stable full-screen regions (a fixed sidebar, a status bar) rather than for individual controls.

CustomBox

A rectangle derived from another element, so it moves with the UI. This is the robust alternative to Area.

ParameterDescription
Search objectThe reference element the box is built around.
Top offsetHow far to extend the box above the reference. Optional.
Bottom offsetHow far to extend it below. Optional.
Left offsetHow far to extend it to the left. Optional.
Right offsetHow far to extend it to the right. Optional.

Any offset you leave empty keeps the reference element's own edge.

📸 Screenshot needed — /img/editor/objects/so-custombox.png

Capture: the CustomBox editor with a reference element chosen and two offsets filled in, plus the resulting box drawn in the live view. Annotate: arrows showing which offset extends which edge.

tip

A CustomBox around a table header is a good way to restrict a search to one column: anchor on the header, extend Bottom offset down over the rows, and set that box as the working area before reading values.