~ubuntu-branches/ubuntu/trusty/csound-manual/trusty-proposed

 

<refentry id="integ">

<indexterm id="IndexInteg"><primary>integ</primary></indexterm>

  <refentryinfo><title>Signal Modifiers:Sample Level Operators</title></refentryinfo>

  <refmeta>

    <refentrytitle>integ</refentrytitle>

  </refmeta>

 

 

 

  <refnamediv>

    <refname>integ</refname>

    <refpurpose>

      Modify a signal by integration.

          </refpurpose>

  </refnamediv>

 

  <refsect1>

    <title>Description</title>

    <para>

      Modify a signal by integration.

    </para>

  </refsect1>

 

  <refsect1>

    <title>Syntax</title>

    <synopsis>ares <command>integ</command> asig [, iskip]</synopsis>

 

    <synopsis>kres <command>integ</command> ksig [, iskip]</synopsis>

  </refsect1>

 

  <refsect1>

    <title>Initialization</title>

    <para>

      <emphasis>iskip</emphasis> (optional) -- initial disposition of internal save space (see <link linkend="reson"><citetitle>reson</citetitle></link>). The default value is 0.

    </para>

  </refsect1>

 

  <refsect1>

    <title>Performance</title>

    <para>

      <emphasis>integ</emphasis> and <link linkend="diff"><citetitle>diff</citetitle></link> perform integration and differentiation on an input control signal or audio signal. Each is the converse of the other, and applying both will reconstruct the original signal. Since these units are special cases of low-pass and high-pass filters, they produce a scaled (and phase shifted) output that is frequency-dependent. Thus <emphasis>diff</emphasis> of a sine produces a cosine, with amplitude <emphasis>2 * sin(pi * Hz / <emphasis>sr</emphasis>)</emphasis> that of the original (for each component partial); <emphasis>integ</emphasis> will inversely affect the magnitudes of its component inputs. With this understanding, these units can provide useful signal modification.

    </para>

  </refsect1>

 

  <refsect1>

    <title>Examples</title>

    <para>

      Here is an example of the integ opcode. It uses the file <ulink url="examples/integ.csd"><citetitle>integ.csd</citetitle></ulink>.

 

      <example>

        <title>Example of the integ 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/integ.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>

      </example>

    </para>

  </refsect1>

 

  <refsect1>

    <title>See Also</title>

    <para>

      <link linkend="diff"><citetitle>diff</citetitle></link>,

      <link linkend="downsamp"><citetitle>downsamp</citetitle></link>,

      <link linkend="interp"><citetitle>interp</citetitle></link>,

      <link linkend="samphold"><citetitle>samphold</citetitle></link>,

      <link linkend="upsamp"><citetitle>upsamp</citetitle></link>

    </para>

  </refsect1>

 

  <refsect1>

    <title>Credits</title>

    <para>Example written by &namekevin;.</para>

  </refsect1>

</refentry>