Regions
Advanced mode. Regions are set up on the App groups page and in the action editor, and both controls appear in Advanced mode only. Regions you set up keep working in Simple mode.
Regions divide a window into a grid of cells. A gesture trigger then names the cells it applies in, so the same shape can run one action when you start it in the left half of a window and another in the right half.
Turning regions on for a group
- On App groups, select the group and open its Gesture regions tab.
- Choose a layout ①:
- Off: no regions (the default).
- Halves: one row, two columns, a left and a right half.
- Quadrants: two rows, two columns.
- Custom grid: choose Rows and Columns, each from 1 to 16.
- Choose the cells on each of the group's gesture triggers (below).
- Apply your changes.
The cells are equal in size. Rows count from the top and columns from the left, in every language.
What is divided
| Group | Divided rectangle |
|---|---|
| An ordinary app group | The top-level window under the pointer at the press: its whole visible frame, title bar included, never a control inside it. A maximized window is divided across the whole window. |
| The Global group | The whole monitor you pressed on, taskbar included. |
The cell is decided once, at the press. The cell is the one the press point is in. Drawing into another cell, or across monitors, doesn't change it.
Choosing a trigger's cells
- On Actions, select the action and expand its gesture trigger.
- Under Regions, select the cells ① the trigger applies in. Select a cell again to clear it.
A trigger can name any number of cells. See The Actions page for the rest of the trigger.
Rules
Every trigger needs cells
Once a group's regions are on, every gesture trigger in that group must name at least one cell. There is no "any cell": a trigger with no cells never matches, and the App groups page warns A gesture can never match. To keep a trigger working everywhere, select all its cells.
Turning regions off again makes every trigger in the group match anywhere; the cells stay stored for when you turn regions back on.
Fewer cells wins
Within one group, when two triggers for the same shape both fit (same draw button, the modifiers you pressed, the active profile) and both cover the cell you pressed in, the trigger with fewer cells wins. Only when they cover equally many cells does the one higher in the action list win. This is the one place where list order comes second.
Example: in Browsers (Quadrants), "Minimize" has Swipe down in all four cells and "Close" has Swipe down in the top-right cell only. Started in the top-right cell, Swipe down runs "Close" (one cell beats four), whichever action is higher in the list. Started in any other cell, it runs "Minimize".
The group still comes first
Regions only choose among the actions of one group. An app group's action always wins over a Global one, whatever their cells. See Scope and fallback rules.
Global's regions
The Global group can have regions too, on its own grid over the monitor:
- When a window has no group of its own, its gestures use Global's grid.
- When a gesture falls back from a group to Global, Global's actions are checked against Global's own cell, worked out from the monitor at the same press, not against the group's window cell.
Example: Browsers has Halves; Global has Quadrants. You press in the left half of a Chrome window that sits in the top-right quarter of the monitor. Browsers' triggers are checked against the left half; if none fits and the gesture falls back, Global's triggers are checked against the top-right quarter.
Changing the grid
Triggers keep their cells when you change a group's layout. A cell that the new grid doesn't have (row 3 after you go from three rows to two) never matches; the App groups page warns A gesture points outside the grid. Choose that trigger's cells again.
Moving or copying an action to another group keeps its cells only when both groups have the same grid; otherwise you are asked to confirm that the cells will be cleared.