summaryrefslogtreecommitdiff
path: root/opcodes/fluidAllOut.xml
blob: bbadbd01644c500394500fc98e14c8795dbfefb1 (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
<refentry id="fluidAllOut">
<indexterm id="IndexFluidAllOut"><primary>fluidAllOut</primary></indexterm>
  <refentryinfo><title>Signal Generators:Sample Playback</title></refentryinfo>
  <refmeta>
    <refentrytitle>fluidAllOut</refentrytitle>
  </refmeta>

  <refnamediv>
    <refname>fluidAllOut</refname>
    <refpurpose>
      Collects all audio from all Fluidsynth engines in a performance
           </refpurpose>
  </refnamediv>

  <refsect1>
    <title>Syntax</title>
    <synopsis>aleft, aright <command>fluidAllOut</command></synopsis>
  </refsect1>

  <refsect1>
    <title>Description</title> 
    <para>Collects all audio from all Fluidsynth engines in a performance
    </para>  
    </refsect1>

  <refsect1>
    <title>Performance</title>
    <para><emphasis>aleft</emphasis> -- Left channel audio output.</para>
    <para><emphasis>aright</emphasis> -- Right channel audio output.</para>
    <para>Invoke fluidAllOut in an instrument definition numbered higher than
    any fluidcontrol instrument definitions. All SoundFonts send their
    audio output to this one opcode. Send a note with an indefinite duration to
    this instrument to turn the SoundFonts on for as long as
    required.</para>
    <para>In this implementation, SoundFont effects such as chorus or
    reverb are used if and only if they are defaults for the preset. There
    is no means of turning such effects on or off, or of changing their
    parameters, from Csound.</para>
  </refsect1>

  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the fluidsynth opcodes. It uses the file <ulink url="examples/fluidAllOut.orc"><citetitle>fluidAllOut.orc</citetitle></ulink>.
    </para>
    <xi:include href="examples-xml/fluidAllOut.orc.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
    <para>
      Here is another more complex example of the fluidsynth opcodes written by Istvan Varga. It uses the file <ulink url="examples/fluidcomplex.csd"><citetitle>fluidcomplex.csd</citetitle></ulink>.
    </para>
    <xi:include href="examples-xml/fluidcomplex.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

  </refsect1>
  <refsect1>
    <title>See Also</title>
    <para><link linkend="fluidEngine"><citetitle>fluidEngine</citetitle></link>, <link linkend="fluidNote"><citetitle>fluidNote</citetitle></link>, <link linkend="fluidLoad"><citetitle>fluidLoad</citetitle></link></para>
  </refsect1>
  <refsect1>
    <title>Credits</title>
    <para>Opcode by Michael Gogins (gogins at pipeline dot
  com). Thanks to Peter Hanappe for Fluidsynth, and to Steven Yi for
  seeing that it is necessary to break up the Fluidsynth into several
  different Csound opcodes.</para>
  </refsect1>
</refentry>