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
81
82
83
84
85
86
|
<refentry id="ATScross">
<indexterm id="IndexATScross"><primary>ATScross</primary></indexterm>
<refentryinfo><title>Spectral Processing:ATS</title></refentryinfo>
<refmeta>
<refentrytitle>ATScross</refentrytitle>
</refmeta>
<refnamediv>
<refname>ATScross</refname>
<refpurpose> perform cross synthesis from ATS analysis files.
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<para>
<emphasis>ATScross</emphasis> uses data from an ATS analysis file and data from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> to perform cross synthesis.
</para>
</refsect1>
<refsect1>
<title>Syntax</title>
<synopsis>ar <command>ATScross</command> ktimepnt, kfmod, iatsfile, ifn, kmylev, kbuflev, ipartials \
[, ipartialoffset, ipartialincr]</synopsis>
</refsect1>
<refsect1>
<title>Initialization</title>
<para>
<emphasis>iatsfile</emphasis> – integer or character-string denoting a control-file derived from ATS analysis of an audio signal. An integer denotes the suffix of a file ATS.m; a character-string (in double quotes) gives a filename, optionally a full pathname. If not full-path, the file is sought first in the current directory, then in the one given by the environment variable SADIR (if defined).
</para>
<para><emphasis>ifn</emphasis> – table number of a stored function containing a sine wave.</para>
<para><emphasis>ipartials</emphasis> – number of partials that will be used in the resynthesis
</para>
<para><emphasis>ipartialoffset</emphasis> (optional) – is the first partial used (defaults to 0).
</para>
<para><emphasis>ipartialincr</emphasis> (optional) – sets an increment by which these synthesis opcodes counts up from <emphasis>ipartialoffset</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>ATScross</emphasis> exactly the same as for <link linkend="pvoc"><citetitle>pvoc</citetitle></link>.</para>
<para>
<emphasis>kfmod</emphasis> – an input for performing pitch transposition or frequency modulation on all of the synthesized partials, if no fm or pitch change is desired then use a 1 for this value.
</para>
<para><emphasis>kmylev</emphasis> - scales the <emphasis>ATScross</emphasis> component of the frequency spectrum applied to the partials from the ATS file indicated by the atscross opcode. The frequency spectrum information comes from the atscross ATS file. A value of 1 (and 0 for <emphasis>kbuflev</emphasis>) gives the same results as <link linkend="ATSadd"><citetitle>ATSadd</citetitle></link>.
</para>
<para><emphasis>kbuflev</emphasis> - scales the <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> component of the frequency spectrum applied to the partials from the ATS file indicated by the <emphasis>ATScross</emphasis> opcode. The frequency spectrum information comes from the <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> ATS file. A value of 1 (and 0 for <emphasis>kmylev</emphasis>) results in partials that have frequency information from the ATS file given by the <emphasis>ATScross</emphasis>, but amplitudes imposed by data from the ATS file given by <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>.
</para>
<para><emphasis>ATScross</emphasis> uses data from an ATS analysis file (indicated by <emphasis>iatsfile</emphasis>) and data from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> to perform cross synthesis. <emphasis>ATScross</emphasis> uses <emphasis>ktimepnt</emphasis>, <emphasis>kfmod</emphasis>, <emphasis>ipartials</emphasis>, <emphasis>ipartialoffset</emphasis> and <emphasis>ipartialincr</emphasis> just like <link linkend="ATSadd"><citetitle>ATSadd</citetitle></link>. <emphasis>ATScross</emphasis> synthesizes a sine-wave for each partial selected by the user and uses the frequency of that partial (after scaling in frequency by <emphasis>kfmod</emphasis>) to index the table created by <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>. Interpolation is used to get in-between values. <emphasis>ATScross</emphasis> uses the sum of the amplitude data from its ATS file (scaled by <emphasis>kmylev</emphasis>) and the amplitude data gained from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> (scaled by <emphasis>kbuflev</emphasis>) to scale the amplitude of each partial it synthesizes. Setting <emphasis>kmylev</emphasis> to one and <emphasis>kbuflev</emphasis> to zero will make <emphasis>ATScross</emphasis> act exactly like <link linkend="ATSadd"><citetitle>ATSadd</citetitle></link>. Setting <emphasis>kmylev</emphasis> to zero and <emphasis>kbuflev</emphasis> to one will produce a sound that has all the partials selected by the <emphasis>ATScross</emphasis> ugen, but with amplitudes taken from an <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link>. The time pointers of the <link linkend="ATSbufread"><citetitle>ATSbufread</citetitle></link> and <emphasis>ATScross</emphasis> do not need to be the same.
</para>
</refsect1>
<refsect1>
<title>Examples</title>
<programlisting> ktime line 0, p3, 2.4
ktime2 line 0, p3, .5
kline expseg 0.001, .9, 1, p3-.9, 1
kline2 expseg .001, p3, 1
atsbufread ktime2, 1, "crt.ats", 20
aout atscross ktime, 1, "cl.ats", 1, kline, .001* (1 - kline2), 42
</programlisting>
<para> This example performs cross synthesis using two ATS files, "crt.ats" and "cl.ats". The result of this will be a sound that starts out with the shape (in frequency) of crt.ats, and ends with the shape of cl.ats. All the sine-wave frequencies come from cl.ats. The <emphasis>kbuflev</emphasis> value is scaled because the energy produced by applying crt.ats's frequency spectrum to cl.ats's partials is very large. Notice also that the time pointers of the atsbufread (crt.ats) and atscross (cl.ats) need not have the same value, this way you can read through the two ATS files at different rates.
</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="ATSinterpread"><citetitle>ATSinterpread</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>
|
