aboutsummaryrefslogtreecommitdiff
path: root/docs/physical-control.rst
diff options
context:
space:
mode:
authorThomas White <taw@physics.org>2022-11-12 11:13:53 +0100
committerThomas White <taw@physics.org>2022-11-12 11:37:03 +0100
commit5a02170f9e1952cd335b6b097e8ce33de7bb35b1 (patch)
treeca21feda4181e444e10e11ce863cc017c69461e7 /docs/physical-control.rst
parentf99311300912814ccaf4fdd6b3c753d1206e024c (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.rst14
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