Conditions & regions
Diatom/User guide/Conditions & regions

Conditions and regions

Append conditions to the command name with &. All conditions on the selected definition must pass.

ini
[last_r+r&max]
type=f
code='''
MsgBox("The target window is maximized.")
'''

&key normally requires a value of 1. &key=value compares or invokes that condition's own matcher. Custom fields need an information provider.

Coordinate families

Prefix Reference
d Mouse-down region on the current screen
a Mouse-down region in the window
u Mouse-up region on the current screen
t Mouse-up region in the window

c1/c2/c3/c4 are upper-left, upper-right, lower-left and lower-right corners. l/r/u/d indicate edges, with numbered subdivisions. b indicates the interior. Edge widths come from the configured thresholds.

For example, &d=c1 restricts a command to gestures that start in the upper-left screen corner. Negative screen coordinates are possible on multiple monitors. w1/h1 are integer window width/height divided by 100.

Content and state

max, full and top describe window state. pc_name matches the normalized machine name. acv/acn, url and other semantic fields require their corresponding data source. Last-input fields refer to prior activity.

Numeric operators can be part of the key, such as dx> in &dx>=100. Condition variants use internal registration numbers and ordering keys. Test one condition at a time before combining overlapping rules.

User guide

Loading the guide…