ATSpartialtap.xml


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

    <refnamediv>
        <refname>ATSpartialtap</refname>
        <refpurpose> returns a frequency, amplitude pair from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> opcode.
        </refpurpose>
    </refnamediv>
    <refsect1>
        <title>Description</title>
        <para>
            <emphasis>ATSpartialtap</emphasis> takes a partial number and returns a frequency, amplitude pair. The frequency and amplitude data comes from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> opcode.
        </para>
    </refsect1>
    <refsect1>
        <title>Syntax</title>
        <synopsis>kfrq, kamp <command>ATSpartialtap</command> ipartialnum</synopsis>
    </refsect1>
    <refsect1>
    <title>Initialization</title>
    <para>
        <emphasis>ipartialnum</emphasis> - indicates the partial that the <emphasis>ATSpartialtap</emphasis> opcode should read from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>.
    </para>
    </refsect1>
    <refsect1>
        <title>Performance</title>
        <para><emphasis>kfrq</emphasis> - returns the frequency value for the requested partial.</para>
        <para><emphasis>kamp</emphasis> - returns the amplitude value for the requested partial.</para>
        <para><emphasis>ATSpartialtap</emphasis> takes a partial number and returns a frequency, amplitude pair. The frequency and amplitude data comes from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> opcode. This is more restricted version of <link linkend="ATSread"><citetitle>ATSread</citetitle></link>, since each <link linkend="ATSread"><citetitle>ATSread</citetitle></link> opcode has its own independent time pointer, and <emphasis>ATSpartialtap</emphasis> is restricted to the data given by an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>. Its simplicity is its attractive feature.</para>
    </refsect1>
 <refsect1>
    <title>Examples</title>
    <para>
      Here is an example of the ATSpartialtap opcode. It uses the file <ulink url="examples/ATSpartialtap.csd"><citetitle>ATSpartialtap.csd</citetitle></ulink>.

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

        

          <xi:include href="examples-xml/ATSpartialtap.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
      </example>
    </para>
        <para> This example here uses an <emphasis>ATSpartialtap</emphasis>, and an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> to read partials 5, 20 and 30 from 'beats.ats'. These amplitudes and frequencies could be used to re-synthesize those partials, or something all together different.
        </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="ATSinterpread"><citetitle>ATSinterpread</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>