File: proc.html

package info (click to toggle)
csound-doc 3.47b2-2
  • links: PTS
  • area: non-free
  • in suites: woody
  • size: 1,492 kB
  • ctags: 272
  • sloc: makefile: 36
file content (96 lines) | stat: -rw-r--r-- 4,856 bytes parent folder | download | duplicates (3)
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
87
88
89
90
91
92
93
94
95
96
<HTML>
<TITLE>PREPROCESSING_OF_STANDARD_SCORES</TITLE>
<CENTER><P><A NAME="Preprocessing_of_Standard_Scores"></A>
<HR><B><A HREF="../REFER.html">QUICK-REF</A></B> - <B><A HREF="../TITLE.html"><FONT SIZE=+1>C</FONT>soundManual</A></B>
- <B><A HREF="././NUMSC.html">Top of this section</A></B> - <A HREF="./scsynt.html">Previous</A>
- <A HREF="../CONTENTS.html">Contents</A> - <A HREF="../INDEX.html">Index</A>
- <A HREF="./p-stat.html">Next</A> 
<HR></P></CENTER>

<H2>Preprocessing of Standard Scores</H2>

<P><BR>
<FONT SIZE=+0>A <B>Score </B>(a collection of score statements) is divided
into time-ordered sections by the <A HREF="./s-stat.html">s statement</A>.
Before being read by the orchestra, a score is preprocessed one section
at a time. Each section is normally processed by 3 routines: <B>Carry,
Tempo, and Sort</B>. </FONT></P>

<P><B>1. Carry</B> - within a group of consecutive <B><A HREF="./i-stat.html">i
statements</A></B> whose p1 whole numbers correspond, any pfield left empty
will take its value from the same pfield of the preceding statement. An
empty pfield can be denoted by a single point (.) delimited by spaces.
No point is required after the last nonempty pfield. The output of Carry
preprocessing will show the carried values explicitly. The Carry Feature
is not affected by intervening comments or blank lines; it is turned off
only by a <I>non-i</I> statement or by an i statement with unlike p1 whole
number. </P>

<P>An additional feature is available for p2 alone. The symbol + in p2
will be given the value of p2 + p3 from the preceding i statement. This
enables note action times to be automatically determined from the sum of
preceding durations. The + symbol can itself be carried. It is legal only
in p2. E.g.: the statements </P>

<PRE><TT>               i1   0    .5        100         
               i .  +                   
               i</TT>
</PRE>

<P>will result in </P>

<PRE><TT>               i1   0         .5        100
               i1   .5   .5   100
               i1   1         .5        100 </TT>
</PRE>

<P>The Carry feature should be used liberally. Its use, especially in large
scores, can greatly reduce input typing and will simplify later changes.
</P>

<P><B>2. Tempo</B> - this operation time warps a score section according
to the information in a <B><A HREF="./t-stat.html">t statement</A></B>.
The tempo operation converts p2 (and, for <B><A HREF="./i-stat.html">i statements</A></B>,
p3) from original beats into real seconds, since those are the units required
by the orchestra. After time warping, score files will be seen to have
orchestra-readable format demonstrated by the following: <B>i</B> p1 p2beats
p2seconds p3beats p3seconds p4 p5 .... </P>

<P><B>3. Sort</B> - this routine sorts all action-time statements into
chronological order by p2 value. It also sorts coincident events into precedence
order. Whenever an <B><A HREF="./f-stat.html">f statement</A></B> and an
<B><A HREF="./i-stat.html">i statement</A></B> have the same p2 value, the
<B>f</B> statement will precede. Whenever two or more <B>i</B> statements
have the same p2 value, they will be sorted into ascending p1 value order.
If they also have the same p1 value, they will be sorted into ascending
p3 value order. Score sorting is done section by section ( <A HREF="./s-stat.html">see
s statement</A>). Automatic sorting implies that score statements may appear
in any order within a section. </P>

<P><B>N.B</B>. The operations Carry, Tempo and Sort are combined in a 3-phase
single pass over a score file, to produce a new file in orchestra-readable
format ( <A HREF="./../Sensing/xyin.html">see the Tempo example</A>). Processing
can be invoked either explicitly by the <B><A HREF="./../Command/scsor.html">scsort</A></B>
command, or implicitly by csound which processes the score before calling
the orchestra. Source-format files and orchestra-readable files are both
in ascii character form, and may be either perused or further modified
by standard text editors. Userwritten routines can be used to modify score
files before or after the above processes, provided the final orchestra-readable
statement format is not violated. Sections of different formats can be
sequentially batched; and sections of like format can be merged for automatic
sorting. </P>

<CENTER><P>
<HR><B><A HREF="../REFER.html">QUICK-REF</A></B> - <B><A HREF="../TITLE.html"><FONT SIZE=+1>C</FONT>soundManual</A></B>
- <B><A HREF="././NUMSC.html">Top of this section</A></B> - <A HREF="./scsynt.html">Previous</A>
- <A HREF="../CONTENTS.html">Contents</A> - <A HREF="../INDEX.html">Index</A>
- <A HREF="./p-stat.html">Next</A> 
<HR></P></CENTER>


<P><CENTER>
<B><I><FONT COLOR="#006600">HTML Csound Manual - <FONT SIZE=-1>&copy;
Jean Pich&eacute; &amp; Peter J. Nix, 1994-97</FONT></FONT></I></B>&nbsp;
</CENTER>
</HTML>