Numerical Matrix Format
User Reference
SELECTION array

MATRIX Array Level: 1

The SELECTION array groups all selected figures, and stores them in a "named" selection set. Each SELECTION array represents one "named" selection set only. Selection sets are distinguished by their name. Unlimited Selection sets are permitted, and referenced solely by their name.

Note
If you create multiple selection sets using the same "name" - the results will be appended to the existing selection set.
If the Selection Name is empty, the "default" selection set will be used.
If the Selection Name is defined as "active" or "current" - the last selection set will be used.
If a Selection Filter is assigned, it should be defined before this Selection array. Selection Filters are optional.
Fields in the SELECTION array
Description
NAME=VALUE Assign Selection set name to use. See notes above about special Selection Set Names.
FILTER=VALUE Assign optional Selection filter name to use. Important: The selection filter should be defined before this Selection array. Default: ""
JOB=NAME The name of the Job to transform objects. Required. Dynamic Job References are also supported.
UNITS=VALUE Units to use for this SELECTION array only. Choose from: mil mm cm inch um (default: mm)
SELECT_ALL Selects All Objects in the active job (Visible or Not Visible)
SELECT_VISIBLE Selects all objects in the active job (Visible layers only)
SELECT_WINDOW=L,B,R,T Selects all objects contained inside a defined rectangle (Visible layers only)
SELECT_CROSSING=L,B,R,T Selects all objects intersecting or contained inside a defined rectangle (Visible layers only)
SELECT_SUBTRACT Subtract the selected objects from the named selection set.
RESET=VALUE Clears the selection set by name. If empty, clears the active selection set.

Example SELECTION Array:

# Comment
SELECTION {
Name=Set1
FILTER=TopPaste Pads Less Than 0.5mm
SELECT_ALL
}

XML example:

<!-- Comment -->
<SELECTION>
<Name>Set1</Name>
<FILTER>TopPaste Pads Less Than 0.5mm</FILTER>
<SELECT_ALL/>
</SELECTION>

JSON example:

"SELECTION": {
"Name": "Set1",
"FILTER": "TopPaste Pads Less Than 0.5mm",
"SELECT_ALL": ""
}