File: gen17.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 (64 lines) | stat: -rw-r--r-- 2,418 bytes parent folder | download | duplicates (6)
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
<HTML>
<TITLE>GEN17</TITLE>
<CENTER><P><A NAME="GEN17"></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="./GENS.html">Top of this section</A></B> - <A HREF="./gen15.html">Previous</A>
- <A HREF="../CONTENTS.html">Contents</A> - <A HREF="../INDEX.html">Index</A>
- <A HREF="./gen20.html">Next</A> 
<HR></P></CENTER>

<H2>GEN17</H2>

<PRE><TT>     <B>f</B>    #    time    size    17    x1  a  x2  b  x3  c  .  .  . </TT>
</PRE>

<P>
<HR></P>

<H4><U>DESCRIPTION</U></H4>

<P>This subroutine creates a step function from given x-y pairs. </P>

<H4><U>INITIALIZATION</U></H4>

<P><I>size</I> - number of points in the table. Must be a power of 2 or
a power-of-2 plus 1 ( <A HREF="./../NumScore/f-stat.html">see f statement</A>).
The normal value is power-of-2 plus 1. </P>

<P><I>x1, x2, x3,</I> etc. - x-ordinate values, in ascending order, 0 first.
</P>

<P><I>a, b, c,</I> etc. - y-values at those x-ordinates, held until the
next x-ordinate. </P>

<P>This subroutine creates a step function of x-y pairs whose y-values
are held to the right. The right-most y-value is then held to the end of
the table. The function is useful for mapping one set of data values onto
another, such as MIDI note numbers onto sampled sound ftable numbers (
<A HREF="./../Generate/loscil.html">see loscil</A>). </P>

<H4><B><U>EXAMPLE:</U></B></H4>

<PRE><TT>     f  1  0  128  -17   0  1   12  2   24  3   36  4   48  5  60  6   72  7   84  8 </TT>
</PRE>

<P>This describes a step function with 8 successively increasing levels,
each 12 locations wide except the last which extends its value to the end
of the table. Rescaling is inhibited. Indexing into this table with a MIDI
note-number would retrieve a different value every octave up to the eighth,
above which the value returned would remain the same. </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="./GENS.html">Top of this section</A></B> - <A HREF="./gen15.html">Previous</A>
- <A HREF="../CONTENTS.html">Contents</A> - <A HREF="../INDEX.html">Index</A>
- <A HREF="./gen20.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>