diff options
author | Thomas White <taw@physics.org> | 2022-11-12 11:13:53 +0100 |
---|---|---|
committer | Thomas White <taw@physics.org> | 2022-11-12 11:37:03 +0100 |
commit | 5a02170f9e1952cd335b6b097e8ce33de7bb35b1 (patch) | |
tree | ca21feda4181e444e10e11ce863cc017c69461e7 /docs/physical-control.rst | |
parent | f99311300912814ccaf4fdd6b3c753d1206e024c (diff) |
Introduce new type for attribute names
There's a serious problem with the design so far, where symbols are used
for attribute names (intensity, strobe, colour etc), and also for
attribute values (on, off, random etc). There's no way for 'at' to
tell the difference between the two. For example, this form is
ambiguous: (at myfixture 'strobe 'on)
This commit introduces a new class, <starlet-attribute>, to replace the
use of symbols here. The attributes are enumerated in (starlet attributes),
and new ones can be added later. The attribute objects remember their
'canonical' names, to allow states to be printed.
Apart from solving the ambiguity problem, this has two further
advantages. First, attribute names no longer need to be quoted
everywhere. Second, multiple names can be used to refer to the same
attribute. For example: (define color colour).
Diffstat (limited to 'docs/physical-control.rst')
-rw-r--r-- | docs/physical-control.rst | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/docs/physical-control.rst b/docs/physical-control.rst index 9f5b162..43eb510 100644 --- a/docs/physical-control.rst +++ b/docs/physical-control.rst @@ -90,13 +90,13 @@ programmer state. Here's an example:: (set-midi-control-map! controller - (fader 16 'intensity #:congruent 108 #:incongruent 72) - (jogwheel 0 'pan #:active 124) - (jogwheel 1 'tilt #:active 125) - (fader 4 (colour-component-id 'cyan) #:congruent 120 #:incongruent 84) - (fader 5 (colour-component-id 'magenta) #:congruent 121 #:incongruent 85) - (fader 6 (colour-component-id 'yellow) #:congruent 122 #:incongruent 86) - (fader 7 'colour-temperature #:congruent 123 #:incongruent 87)) + (fader 16 intensity #:congruent 108 #:incongruent 72) + (jogwheel 0 pan #:active 124) + (jogwheel 1 tilt #:active 125) + (fader 4 (colour-component-id 'cyan) #:congruent 120 #:incongruent 84) + (fader 5 (colour-component-id 'magenta) #:congruent 121 #:incongruent 85) + (fader 6 (colour-component-id 'yellow) #:congruent 122 #:incongruent 86) + (fader 7 colour-temperature #:congruent 123 #:incongruent 87)) Use ``fader`` for MIDI *continuous control* parameters (CCs), which might physically correspond to faders or rotary potentiometers with a minimum and |