ATSinterpread.xml


<refentry id="ATSinterpread">
<indexterm id="IndexATSinterpread"><primary>ATSinterpread</primary></indexterm>
  <refentryinfo><title>Spectral Processing:ATS</title></refentryinfo>
    <refmeta>
        <refentrytitle>ATSinterpread</refentrytitle>
    </refmeta>

    <refnamediv>
        <refname>ATSinterpread</refname>
        <refpurpose> allows a user to determine the frequency envelope of any <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>.
                    </refpurpose>
    </refnamediv>
    <refsect1>
        <title>Description</title>
        <para>
            <emphasis>ATSinterpread</emphasis> allows a user to determine the frequency envelope of any <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>.
        </para>
    </refsect1>
    <refsect1>
        <title>Syntax</title>
        <synopsis>kamp <command>ATSinterpread</command> kfreq</synopsis>
    </refsect1>
    <refsect1>
        <title>Performance</title>
        <para><emphasis>kfreq</emphasis> - a frequency value (given in Hertz) used by <emphasis>ATSinterpread</emphasis> as in index into the table produced by an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>.</para>
        <para><emphasis>ATSinterpread</emphasis> takes a frequency value (<emphasis>kfreq</emphasis> in Hz). This frequency is used to index the data of an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>. The return value is an amplitude gained from the <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>  after interpolation. <emphasis>ATSinterpread</emphasis> allows a user to determine the frequency envelope of any <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>. This data could be useful for an number of reasons, one might be performing cross synthesis of data from an ATS file and non ATS data.</para>
    </refsect1>
  <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the ATSinterpread opcode. It uses the file <ulink url="examples/ATSinterpread.csd"><citetitle>ATSinterpread.csd</citetitle></ulink>.

      <example>
        <title>Example of the ATSinterpread opcode.</title>

        

          <xi:include href="examples-xml/ATSinterpread.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
      </example>
    </para>
        <para>
            This example shows how to use <emphasis>ATSinterpread</emphasis>. Here a frequency is given by the score (p4) and this frequency is given to an <emphasis>ATSinterpread</emphasis> (with a corresponding <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>). The <emphasis>ATSinterpread</emphasis> uses this frequency to output a corresponding amplitude value, based on the atsfile given by the <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> (beats.ats in this case). We then use that amplitude to scale a sine-wave that is synthesized with the same frequency (p4). You could extend this to include multiple sine-waves. This way you could synthesize any reasonable frequency (within the low and high frequencies of the indicated ATS file), and maintain the shape (in frequency) of the indicated atsfile (given by the <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>).
        </para>
    </refsect1>
    <refsect1>
        <title>See also</title>
        <para><link linkend="ATSread"><citetitle>ATSread</citetitle></link>, 
            <link linkend="ATSreadnz"><citetitle>ATSreadnz</citetitle></link>, 
            <link linkend="ATSinfo"><citetitle>ATSinfo</citetitle></link>, 
            <link linkend="ATSsinnoi"><citetitle>ATSsinnoi</citetitle></link>, 
            <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>, 
            <link linkend="ATScross"><citetitle>ATScross</citetitle></link>, 
            <link linkend="ATSpartialtap"><citetitle>ATSpartialtap</citetitle></link>, 
            <link linkend="ATSadd"><citetitle>ATSadd</citetitle></link>, 
            <link linkend="ATSaddnz"><citetitle>ATSaddnz</citetitle></link></para>
    </refsect1>
    <refsect1>
        <title>Credits</title>
        <para>
            <simplelist>
                <member>Author: Alex Norman</member>
                <member>Seattle,Washington</member>
                <member>2004</member>
            </simplelist>
        </para>
    </refsect1>
</refentry>