CataRT Internals Documentation
There are three ways to specify the target (i.e., the point in an m-dimensional subspace of the n-dimensional descriptor space of which the closest grain will be searched):
1. like the lcd does:
- declare which m descriptors to use with set-descriptors <list: m descr. index>
- set target with select <list: m target values>
- weights are set to 1 for used descriptors
2. the flexible way for external controllers:
- use setselect descriptor index> <value> <weight> to add any descriptor you wish to control to target.
- to clear all existing selections (notably those set by the lcd), use the unselect-all message
3. the wholesale way (as used by catart.target):
- set the target for all n dimensions with set-target <fmat(1, n)>
- set weights with set-weights <fmat(1, n)>
Beware that all these methods share and overwrite the weights, i.e. the lcd also adds the descriptors of its chosen dimensions, etc. That's why with the reporting functions and outlets, catart.select can show you what's going on (see help patch).
In the following messages, descriptors can be given by name or index. All parameters at the tail are optional and don't change if omitted.
Changing Axes by Message
set-descriptors <x axis descriptor> <y axis descriptor> [<colour axis descriptor> <colour axis label group on/off> [ <label descriptor> <labels on/off> [ <label colour descriptor> <label colour on/off> ] ] ]
Changing Colours by Message
set-colours <colour axis descriptor> <colour axis label group on/off> <x axis descriptor> <y axis descriptor> [ <colour axis descriptor> <colour axis label group on/off> ]
Changing Tile Descriptors (lcd3 only)
set-tile-descriptors <x tile descriptor> <x tiling on/off> <y tile descriptor> <y tiling on/off>