Valuetext - Mackie C4 Commander Programming Manual

C4 Commander

ValueText

Valuetext are look-up tables that can be used
for parameters to display text strings instead
of numerical values. An example of this might
be a reverb algorithm that has values from 0-
15. Instead of displaying these values, a far
more intuitive approach would be to display the
words "Plate," "Arena," "Lg. hall," etc., on the
C4's display. Other examples of where Valuetext
can be useful are:
• LFO waveforms (SINE, SAW, S/H, TRI)
• Sample waveforms (Piano, Sax, vocal,
strings)
• Envelope times (displaying the number of
milliseconds for compressor attack and re-
lease)
• Keyboard modes – mono, poly, omni
• Amplifier selections – British, 2x10, 1x12,
Metal, Jazz
• On/Off messages for portamento, arpeggia-
tor settings, etc.
The Valuetext parameter is a very powerful
and useful tool to simplify and clarify the read-
outs for the C4 controls.

Programmer's Guide
<ValueTextList> This element contains a list
of all value text lists defined. After you create
this header, begin typing your valuetext state-
ments.
<ValueText name="xxxxxxx"> This element is
used to substitute text in place of a V-Pot nu-
merical value. So instead of seeing 0 and 1 for
a V-Pot value, you can have on and off.
<Text value = "n">VALUETEXT</Text>
A single value text substitution. The tag value
(VALUETEXT) determines what will be substi-
tuted in place of the numerical parameter value.
If a value="n" attribute is present, the tag value
will be substituted for the parameter value n. If
min="a", max="b" attributes are used, the tag
value will be substituted whenever the parame-
ter's value lies between a and b.
Value Text Example:
<ValueTextList>
<ValueText name="onoff">
<Text value="0">Off</Text>
<Text value="1">On</Text>
</ValueText>
<ValueText name="alg">
<Text value="0">Algorithm 1</Text>
<Text value="1">Algorithm 2</Text>
<Text value="2">Algorithm 3</Text>
<Text value="3">Algorithm 4</Text>
</ValueText>
<ValueText name="MegaOnOff">
<Text min="0" max="63">Off</Text>
<Text min="64" max="127">On</Text>
</ValueText>
</ValueTextList>
A single valuetext can be used for multiple
parameters. In the example above, the "onoff"
valuetext can be referenced to reflect any pa-
rameter that has a 0-1 setting, such as "glide
on/off", "Layer on/off", etc.