summaryrefslogtreecommitdiff
path: root/opcodes/STKFMVoices.xml
blob: c48a831c7730cb7557158dd7a16177dc3fb6c246 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<refentry id="STKFMVoices">
  <indexterm id="IndexStkfmvoices"><primary>STKFMVoices</primary></indexterm>
  <refentryinfo><title>Signal Generators:STK Opcodes</title></refentryinfo>
  <refmeta>
    <refentrytitle>STKFMVoices</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>STKFMVoices</refname>
    <refpurpose>
      STKFMVoices is a singing FM synthesis instrument. 
      </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      STKFMVoices is a singing FM synthesis instrument. It has 3 carriers and a common modulator, also referred to as algorithm 6 of the TX81Z.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis>asignal <command>STKFMVoices</command> ifrequency, iamplitude, [kc1, kv1[, kc2, kv2[, kc3, kv3[, kc4, kv4[, kc5, kv5]]]]]</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
        <para>
      <emphasis>ifrequency</emphasis> -- Frequency of note played, in Hertz.
    </para>
   
    <para>
      <emphasis>iamplitude</emphasis> -- Amplitude of note played (range 0-1).
    </para>
  </refsect1>
 
  <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 5 controller numbers and values that work for STKFMVoices are:
      <itemizedlist>
        <listitem><para><emphasis>kc, kv</emphasis> -- 2,   vowel.</para></listitem>
        <listitem><para><emphasis>kc, kv</emphasis> -- 4,   spectral tilt </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> -- 128, ADSR 2 and 4 Target.</para></listitem>
      </itemizedlist>
    </para>
  </refsect1>
 
    <refsect1>
    <note>
      <title>Note</title>
      <para>
          The code for this opcode is taken directly from the FMVoices 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>
    </note>
  </refsect1>
  
  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the STKFMVoices opcode. It uses the file <ulink url="examples/STKFMVoices.csd"><citetitle>STKFMVoices.csd</citetitle></ulink>, and <ulink url="examples/fwavblnk.aiff"><citetitle>fwavblnk.aiff</citetitle></ulink>.
     
      <example>
        <title>Example of the STKFMVoices opcode.</title>
        <xi:include href="examples-xml/STKFMVoices.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
      </example>
    </para>
  </refsect1>
 
  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="STKBeeThree"><citetitle>STKBeeThree</citetitle></link>,
    </para>
  </refsect1>
 
  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &namemichael; (after &nameperry;)</member>
        <member>Irreducible Productions</member>
        <member>New York, NY</member>
      </simplelist>
    </para>
    <para>New in Csound version 5.11</para>
  </refsect1>
</refentry>