summaryrefslogtreecommitdiff
path: root/opcodes/ATSaddnz.xml
blob: a8e53f4f9d28849dd74ec9d677d65e39db3a78f1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<refentry id="ATSaddnz">
<indexterm id="IndexATSaddnz"><primary>ATSaddnz</primary></indexterm>
  <refentryinfo><title>Spectral Processing:ATS</title></refentryinfo>
    <refmeta>
        <refentrytitle>ATSaddnz</refentrytitle>
    </refmeta>


    <refnamediv>
        <refname>ATSaddnz</refname>
        <refpurpose> uses the data from an ATS analysis file to perform noise resynthesis.
                    </refpurpose>
    </refnamediv>
    <refsect1>
        <title>Description</title>
        <para>
            <emphasis>ATSaddnz</emphasis> reads from an ATS analysis file and uses the data to perform additive synthesis using a modified randi function.
        </para>
    </refsect1>
    <refsect1>
        <title>Syntax</title>
        <synopsis>ar <command>ATSaddnz</command> ktimepnt, iatsfile, ibands[, ibandoffset, ibandincr]</synopsis>
    </refsect1>
    <refsect1>
        <title>Initialization</title>
        <para>
            <emphasis>iatsfile</emphasis> – the ATS number (n in ats.n) or the name in quotes of the analysis file made using <ulink url="http://www-ccrma.stanford.edu/~juan/ATS.html"><citetitle>ATS</citetitle></ulink>.
        </para>
        <para><emphasis>ibands</emphasis> – number of noise bands that will be used in the resynthesis (the noise has a maximum of 25 bands)
        </para>
        <para><emphasis>ibandoffset</emphasis> (optional) – is the first noise band used (defaults to 0).
        </para>
        <para><emphasis>ibandincr</emphasis> (optional) – sets an increment by which these synthesis opcodes counts up from <emphasis>ibandoffset</emphasis> for ibins components in the re-synthesis (defaults to 1).
        </para>
    </refsect1>
    <refsect1>
        <title>Performance</title>
        <para><emphasis>ktimepnt</emphasis> – The time pointer in seconds used to index the ATS file. Used for <emphasis>ATSaddnz</emphasis> exactly the same as for <link linkend="pvoc"><citetitle>pvoc</citetitle></link> and <link linkend="ATSadd"><citetitle>ATSadd</citetitle></link>.</para>
        <para><emphasis>ATSaddnz</emphasis> and <link linkend="ATSadd"><citetitle>ATSadd</citetitle></link> are based on <link linkend="pvadd"><citetitle>pvadd</citetitle></link> by Richard Karpen and use files created by Juan Pampin's ATS (<ulink url="http://www-ccrma.stanford.edu/~juan/ATS.html"><citetitle>Analysis - Transformation - Synthesis</citetitle></ulink>).
        </para>
        <para><emphasis>ATSaddnz</emphasis> also reads from an ATS file but it resynthesizes the noise from noise energy data contained in the ATS file. It uses a modified randi function to create band limited noise and modulates that with a cosine wave, to synthesize a user specified selection of frequency bands. Modulating the noise is required to put the band limited noise in the correct place in the frequency spectrum.
        </para>
    </refsect1>
    <refsect1>
        <title>Examples</title>
        <programlisting>  ktime line  0, p3, 2.5
  asig  atsaddnz ktime, "clarinet.ats", 25
        </programlisting>
        <para>In the example above we're synthesizing all 25 noise bands from the data contained in the ATS analysis file called "clarinet.ats".
        </para>
        <programlisting>  ktime line  2.5, p3, 0
  asig atsaddnz ktime, 1, "clarinet.ats", 1, 24
        </programlisting>
        <para>Here we synthesize only the 25th noise band (<emphasis>ibandoffset</emphasis> of 24 and <emphasis>ibands</emphasis> of 1). Also our time pointer is going from 2.5 to 0 over the duration of the note so we're reading backwards from 2.5 seconds in the analysis file.
        </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="ATSbufread"><citetitle>ATSbufread</citetitle></link>, 
            <link linkend="ATScross"><citetitle>ATScross</citetitle></link>, 
            <link linkend="ATSinterpread"><citetitle>ATSinterpread</citetitle></link>, 
            <link linkend="ATSpartialtap"><citetitle>ATSpartialtap</citetitle></link>, 
            <link linkend="ATSaddnz"><citetitle>ATSaddnz</citetitle></link>, 
            <link linkend="ATSsinnoi"><citetitle>ATSsinnoi</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>