summaryrefslogtreecommitdiff
path: root/opcodes/STKModalBar.xml
diff options
context:
space:
mode:
Diffstat (limited to 'opcodes/STKModalBar.xml')
-rw-r--r--[-rwxr-xr-x]opcodes/STKModalBar.xml29
1 files changed, 13 insertions, 16 deletions
diff --git a/opcodes/STKModalBar.xml b/opcodes/STKModalBar.xml
index 5eb29d6..df90e89 100755..100644
--- a/opcodes/STKModalBar.xml
+++ b/opcodes/STKModalBar.xml
@@ -20,7 +20,7 @@
<refsect1>
<title>Syntax</title>
- <synopsis>asignal <command>STKModalBar</command> ifrequency, iamplitude, [kc1, kv1[, kc2, kv2[, kc3, kv3[, kc4, kv4[, kc5, kv5[, kc6, kv6[, kc7, kv7]]]]]]]</synopsis>
+ <synopsis>asignal <command>STKModalBar</command> ifrequency, iamplitude, [khard, kv1[, kpos, kv2[, klfo, kv3[, klfodepth, kv4[, kmix, kv5[, kvol, kv6[, kinstr, kv7]]]]]]]</synopsis>
</refsect1>
<refsect1>
@@ -36,19 +36,13 @@
<refsect1>
<title>Performance</title>
- <para>
- <emphasis>kc1, kv1, kc2, kv2, kc3, kv3, kc4, kv4, kc5, kv5, kc6, kv6, kc7, kv7, kc8, kv8</emphasis> -- Up to 8 optional k-rate controller pairs for the STK opcodes.
- Each controller pair consists of a controller number (kc) followed by a controller value (kv). The 7 controller numbers and values that work for STKModalBar are:
- <itemizedlist>
- <listitem><para><emphasis>kc, kv</emphasis> -- 2, hardness of the stick.</para></listitem>
- <listitem><para><emphasis>kc, kv</emphasis> -- 4, stick position.</para></listitem>
- <listitem><para><emphasis>kc, kv</emphasis> -- 11, speed of low-frequency oscillator.</para></listitem>
- <listitem><para><emphasis>kc, kv</emphasis> -- 1, depth of low-frequency oscillator.</para></listitem>
- <listitem><para><emphasis>kc, kv</emphasis> -- 8, direct stick mix</para></listitem>
- <listitem><para><emphasis>kc, kv</emphasis> -- 128, volume.</para></listitem>
- <listitem><para><emphasis>kc, kv</emphasis> -- 16, instrument presets (0 = marimba, 1 = vibraphone, 2 = agogo, 3 = wood1, 4 = reso, 5 = wood2, 6 = beats, 7 = two fixed, 8 = clump)</para></listitem>
- </itemizedlist>
- </para>
+<para><emphasis>khard</emphasis> -- controller 2, hardness of the stick. Value range of kv1 is 0-127.</para>
+<para><emphasis>kpos</emphasis> -- controller 4, stick position. Value range of kv2 is 0-127.</para>
+<para><emphasis>klfo</emphasis> -- controller 11, speed of low-frequency oscillator. Value range of kv3 is 0-127.</para>
+<para><emphasis>klfodepth</emphasis> -- controller 1, depth of low-frequency oscillator. Value range of kv4 is 0-127.</para>
+<para><emphasis>kmix</emphasis> -- controller 8, direct stick mix. Value range of kv5 is 0-127.</para>
+<para><emphasis>kvol</emphasis> -- controller 128, volume. Value range of kv6 is 0-127.</para>
+<para><emphasis>kinstr</emphasis> -- controller 16, instrument presets (0 = marimba, 1 = vibraphone, 2 = agogo, 3 = wood1, 4 = reso, 5 = wood2, 6 = beats, 7 = two fixed, 8 = clump). Value range of kv7 is 0-16.</para>
</refsect1>
<refsect1>
@@ -58,6 +52,11 @@
The code for this opcode is taken directly from the ModalBar class in the Synthesis Toolkit in C++ by Perry R. Cook and Gary P. Scavone. More on the STK classes can be found here:
<ulink url="https://ccrma.stanford.edu/software/stk/classes.html"><citetitle>https://ccrma.stanford.edu/software/stk/classes.html</citetitle></ulink>
</para>
+ <para>
+ <emphasis>kc1, kv1, kc2, kv2, kc3, kv3, kc4, kv4, kc5, kv5, kc6, kv6, kc7, kv7, kc8, kv8</emphasis> -- Up to 8 optional k-rate controller pairs for the STK opcodes.
+ Each controller pair consists of a controller number (kc) followed by a controller value (kv). Both the controller numbers and the controller values are krate variables. However, during a performance, normally the controller numbers stay fixed while the corresponding controller values may change at any time.
+The order of the controller pair is arbitrary, as long as they are after <emphasis>iamplitude</emphasis>. Also, it is not needed that all controller pairs are used.
+</para>
</note>
</refsect1>
@@ -86,5 +85,3 @@
</refsect1>
</refentry>
-
-