summaryrefslogtreecommitdiff
path: root/opcodes/midic7.xml
blob: 62ec9d8a7abd486928ebd87e6275541cbb00ac28 (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
100
101
102
103
104
<refentry id="midic7">
<indexterm id="IndexMidic7"><primary>midic7</primary></indexterm>
  <refentryinfo><title>Real-time MIDI:Input</title></refentryinfo>
  <refmeta>
    <refentrytitle>midic7</refentrytitle>
  </refmeta>


 
  <refnamediv>
    <refname>midic7</refname>

    <refpurpose>
      Allows a floating-point 7-bit MIDI signal scaled with a minimum and a maximum range.
          </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      Allows a floating-point 7-bit MIDI signal scaled with a minimum and a maximum range.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis>idest <command>midic7</command> ictlno, imin, imax [, ifn]</synopsis>

    <synopsis>kdest <command>midic7</command> ictlno, kmin, kmax [, ifn]</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>idest</emphasis> -- output signal
    </para>

    <para>
      <emphasis>ictlno</emphasis> -- MIDI controller number (0-127)
    </para>

    <para>
      <emphasis>imin</emphasis> -- user-defined minimum floating-point value of output
    </para>

    <para>
      <emphasis>imax</emphasis> -- user-defined maximum floating-point value of output
    </para>

    <para>
      <emphasis>ifn</emphasis> (optional) -- table to be read when indexing is required. Table must be normalized. Output is scaled according to the <emphasis>imin</emphasis> and <emphasis>imax</emphasis> values.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>kdest</emphasis> -- output signal
    </para>

    <para>
      <emphasis>kmin</emphasis> -- user-defined minimum floating-point value of output
    </para>

    <para>
      <emphasis>kmax</emphasis> -- user-defined maximum floating-point value of output
    </para>

    <para>
      <emphasis>midic7</emphasis> (i- and k-rate 7 bit MIDI control) allows a floating-point 7-bit MIDI signal scaled with a minimum and a maximum range. It also allows optional non-interpolated table indexing. In <emphasis>midic7</emphasis> minimum and maximum values can be varied at k-rate. 
    </para>
    <note>
      <para>Please note that the <emphasis>midic</emphasis> family of opcodes are designed for MIDI triggered events, and don't require a channel number since they will respond to the same channel as the one that triggered the instrument (see <link linkend="massign"><citetitle>massign</citetitle></link>). However they will crash if called from a score driven event.</para>
    </note>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="ctrl7"><citetitle>ctrl7</citetitle></link>,
      <link linkend="ctrl14"><citetitle>ctrl14</citetitle></link>,
      <link linkend="ctrl21"><citetitle>ctrl21</citetitle></link>,
      <link linkend="initc7"><citetitle>initc7</citetitle></link>,
      <link linkend="initc14"><citetitle>initc14</citetitle></link>,
      <link linkend="initc21"><citetitle>initc21</citetitle></link>,
      <link linkend="midic14"><citetitle>midic14</citetitle></link>,
      <link linkend="midic21"><citetitle>midic21</citetitle></link>
    </para>
  </refsect1>
 
  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &namegabriel;</member>
        <member>Italy</member>
      </simplelist>
    </para>

    <para>New in Csound version 3.47</para>
    <para>Thanks goes to &namerasmus; for pointing out the correct controller number range.</para>
  </refsect1>
</refentry>