blob: 1e9b2c0c54d4a80b64a860496db4d8cbfc98b99f (
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
|
<refentry id="a">
<indexterm id="IndexAStatement"><primary>a statement</primary></indexterm>
<indexterm id="IndexAdvanceStatement"><primary>advance statement</primary></indexterm>
<refmeta>
<refentrytitle>a Statement (or Advance Statement)</refentrytitle>
</refmeta>
<refnamediv>
<refname>a</refname>
<refpurpose>
Advance score time by a specified amount.
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<para>
This causes score time to be advanced by a specified amount without producing sound samples.
</para>
</refsect1>
<refsect1>
<title>Syntax</title>
<synopsis><command>a</command> p1 p2 p3</synopsis>
</refsect1>
<refsect1>
<title>Performance</title>
<para>
<literallayout>
p1 Carries no meaning. Usually zero.
p2 Action time, in beats, at which advance is to begin.
p3 Number of beats to advance without producing sound.
p4 |
p5 | These carry no meaning.
p6 |
.
.
</literallayout>
</para>
<refsect2>
<title>Special Considerations</title>
<para>
This statement allows the beat count within a score section to be advanced without generating intervening sound samples. This can be of use when a score section is incomplete (the beginning or middle is missing) and the user does not wish to generate and listen to a lot of silence.
</para>
<para>
p2, action time, and p3, number of beats, are treated as in <link linkend="i"><citetitle>i statements</citetitle></link>, with respect to sorting and modification by <link linkend="t"><citetitle>t statements</citetitle></link>.
</para>
<para>
An <emphasis>a statement</emphasis> will be temporarily inserted in the score by the Score Extract feature when the extracted segment begins later than the start of a Section. The purpose of this is to preserve the beat count and time count of the original score for the benefit of the peak amplitude messages which are reported on the user console.
</para>
<para>
Whenever an <emphasis>a statement</emphasis> is encountered by a performing orchestra, its presence and effect will be reported on the user's console.
</para>
</refsect2>
</refsect1>
<refsect1>
<title>Examples</title>
<para>
Here is an example of the a statement. It uses the file <ulink url="examples/a.csd"><citetitle>a.csd</citetitle></ulink>.
<example>
<title>Example of the a statement.</title>
<xi:include href="examples-xml/a.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
</example>
</para>
</refsect1>
</refentry>
|
