<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="vincr">
  <refmeta>
    <refentrytitle>vincr</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>vincr</refname>
    <refpurpose>
      Accumulates audio signals.
      <indexterm id="IndexVincr"><primary>vincr</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      <emphasis>vincr</emphasis> increments an audio variable of another signal, i.e. accumulates output.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>vincr</command> asig, aincr</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      <emphasis>asig</emphasis> -- audio variable to be incremented 
    </para>

    <para>
      <emphasis>aincr</emphasis> -- incrementing signal 
    </para>

    <para>
      <emphasis>vincr</emphasis> (variable increment) and <link linkend="clear"><citetitle>clear</citetitle></link> are intended to be used together. <emphasis>vincr</emphasis> stores the result of the sum of two audio variables into the first variable itself (which is intended to be used as an accumulator in polyphony). The accumulator variable can be used for output signal by means of <link linkend="fout"><citetitle>fout</citetitle></link> opcode. After the disk writing operation, the accumulator variable should be set to zero by means of <emphasis>clear</emphasis> opcode (or it will explode).
    </para>
  </refsect1>

  <refsect1>
    <title>Examples</title>
    <para>
      See the <link linkend="fout"><citetitle>fout</citetitle></link> opcode for an example.
    </para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para>
      <link linkend="clear"><citetitle>clear</citetitle></link>
    </para>
  </refsect1>
 
  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &namegabriel;</member>
        <member>Italy</member>
        <member>1999</member>
      </simplelist>
    </para>

    <para>New in Csound version 3.56</para>
  </refsect1>
</refentry>
