summaryrefslogtreecommitdiff
path: root/opcodes/fluidSetInterpMethod.xml
blob: da6fef30c4152a94dc24a0298971cefe3cc96240 (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
<refentry id="fluidSetInterpMethod">
<indexterm id="IndexFluidSetInterpMethod"><primary>fluidSetInterpMethod</primary></indexterm>
  <refentryinfo><title>Signal Generators:Sample Playback</title></refentryinfo>
  <refmeta>
    <refentrytitle>fluidSetInterpMethod</refentrytitle>
  </refmeta>
  <refnamediv>
    <refname>fluidSetInterpMethod</refname>
    <refpurpose>
      Set interpolation method for channel in Fluid Engine
           </refpurpose>
  </refnamediv>

  <refsect1>
    <title>Syntax</title>
    <synopsis><command>fluidSetInterpMethod</command> ienginenum, ichannelnum, iInterpMethod</synopsis>
  </refsect1>

  <refsect1>
    <title>Description</title> 
    <para>Set interpolation method for channel in Fluid Engine.  Lower 
    order interpolation methods will render faster at lower fidelity while 
    higher order interpolation methods will render slower at higher fidelity.
    Default interpolation for a channel is 4th order interpolation. 
    </para>  
    </refsect1>

  <refsect1>
    <title>Initialization</title>
    <para><emphasis>ienginenum</emphasis> -- engine number assigned from fluidEngine</para>
    <para><emphasis>ichannelnum</emphasis> -- which channel number to use for the preset in the given fluidEngine</para>
    <para><emphasis>iInterpMethod</emphasis>
    	-- interpolation method, can be any of the following

    	<itemizedlist>
    		<listitem>
    			<para>
    				<emphasis>0</emphasis>
    				-- No Interpolation
    			</para>
    		</listitem>
    		<listitem>
    			<para>
    				<emphasis>1</emphasis>
    				-- Linear Interpolation
    			</para>
    		</listitem>
    		<listitem>
    			<para>
    				<emphasis>4</emphasis>
    				-- 4th Order Interpolation (Default)
    			</para>
    		</listitem>
    		<listitem>
                <para>
                    <emphasis>7</emphasis>
                    -- 7th Order Interpolation (Highest)
                </para>
            </listitem>
    	</itemizedlist>

    </para>

  </refsect1>
  
  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the fluidSetInterpMethod opcode. It uses the file <ulink url="examples/fluidSetInterpMethod.csd"><citetitle>fluidSetInterpMethod.csd</citetitle></ulink> and <ulink url="examples/07AcousticGuitar.sf2"><citetitle>07AcousticGuitar.sf2</citetitle></ulink>.
      <example>
        <title>Example of the fluidSetInterpMethod opcode.</title>
        <para>See the sections <link linkend="UsingRealTime"><citetitle>Real-time Audio</citetitle></link> and <link linkend="CommandFlags"><citetitle>Command Line Flags</citetitle></link> for more information on using command line flags.</para>
          <xi:include href="examples-xml/fluidSetInterpMethod.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
      </example>
    </para>
  </refsect1>
  
  <refsect1>
    <title>See Also</title>
    <para><link linkend="fluidEngine"><citetitle>fluidEngine</citetitle></link></para>
            <para> More information on soundfonts in the Floss Manuals: <ulink url="http://en.flossmanuals.net/csound/ch048_d-reading-midi-files"><citetitle>http://en.flossmanuals.net/csound/ch048_d-reading-midi-files</citetitle></ulink></para>
        <para> Other information on soundfonts on Wikipedia: <ulink url="http://en.wikipedia.org/wiki/Soundfont"><citetitle>http://en.wikipedia.org/wiki/Soundfont</citetitle></ulink></para>   
  </refsect1>
  
  <refsect1>
    <title>Credits</title>
    <para>Author: &namesteven;</para>
    <para>New in version 5.07</para>
  </refsect1>
</refentry>