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

« back to all changes in this revision

Viewing changes to opcodes/ATSpartialtap.xml

  • Committer: Bazaar Package Importer
  • Author(s): Felipe Sateler
  • Date: 2011-08-01 22:21:58 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20110801222158-90kslkp5ujci2f5d
Tags: 1:5.13~dfsg-1
* New upstream release
 - Add Menno Knevel to the copyright file
 - Refresh patch 2000-stripped-opcodes.diff
 - Update copyright hints file
* Update Vcs-* headers
* Bump Standards-Version

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
 
 
1

2
2
<refentry id="ATSpartialtap">
3
3
<indexterm id="IndexATSpartialtap"><primary>ATSpartialtap</primary></indexterm>
4
4
  <refentryinfo><title>Spectral Processing:ATS</title></refentryinfo>
6
6
        <refentrytitle>ATSpartialtap</refentrytitle>
7
7
    </refmeta>
8
8
 
9
 
 
10
9
    <refnamediv>
11
10
        <refname>ATSpartialtap</refname>
12
11
        <refpurpose> returns a frequency, amplitude pair from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> opcode.
13
 
                    </refpurpose>
 
12
        </refpurpose>
14
13
    </refnamediv>
15
14
    <refsect1>
16
15
        <title>Description</title>
17
16
        <para>
18
 
            <emphasis>ATSpartialtap</emphasis> takes a partial number and returns a frequency, amplitude pair. The frequency and amplitude data comes from an atsbufread <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> opcode.
 
17
            <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.
19
18
        </para>
20
19
    </refsect1>
21
20
    <refsect1>
34
33
        <para><emphasis>kamp</emphasis> - returns the amplitude value for the requested partial.</para>
35
34
        <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>
36
35
    </refsect1>
37
 
    <refsect1>
38
 
        <title>Examples</title>
39
 
        <programlisting>  ktime line 0, p3, 2.4
40
 
  atsbufread  ktime, 1, "crt.ats", 20
41
 
  kfreq1, kamp1 atspartialtap 1
42
 
  kfreq2, kamp2 atspartialtap 10
43
 
  kfreq3, kamp3 atspartialtap 20
44
 
        </programlisting>
45
 
        <para> This example here uses an <emphasis>ATSpartialtap</emphasis>, and an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> to read partials 1, 10 and 20 from 'crt.ats'. These amplitudes and frequencies could be used to re-synthesize those partials, or something all together different.
 
36
 <refsect1>
 
37
    <title>Examples</title>
 
38
    <para>
 
39
      Here is an example of the ATSpartialtap opcode. It uses the file <ulink url="examples/ATSpartialtap.csd"><citetitle>ATSpartialtap.csd</citetitle></ulink>.
 
40
 
 
41
      <example>
 
42
        <title>Example of the ATSpartialtap opcode.</title>
 
43
 
 
44
        
 
45
 
 
46
          <xi:include href="examples-xml/ATSpartialtap.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
 
47
      </example>
 
48
    </para>
 
49
        <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.
46
50
        </para>
47
51
    </refsect1>
48
52
    <refsect1>