scoregens/gen23.xml


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

<refentry id="GEN23">
      <indexterm id="IndexGEN23"><primary>GEN23</primary></indexterm>
  <refmeta>
    <refentrytitle>GEN23</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>GEN23</refname>
    <refpurpose>
      Reads numeric values from a text file.
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      This subroutine reads numeric values from an external ASCII file.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>f</command> # time size -23 &quot;filename.txt&quot;</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      <emphasis>&quot;filename.txt&quot;</emphasis> -- numeric values contained in &quot;filename.txt&quot; (which indicates the complete pathname of the character file to be read), can be separated by spaces, tabs, newline characters or commas.  Also, words that contains non-numeric characters can be used as comments since they are ignored.
    </para>

    <para>
      <emphasis>size</emphasis> -- number of points in the table. Must be a power of 2 , power of 2 + 1, or zero.  If <emphasis>size</emphasis> = 0, table size is determined by the number of numeric values in <emphasis>filename.txt</emphasis>. (New in Csound version 3.57)
    </para>

    <note>
      <title>Note</title>
      <para>
        All characters following ';' or '#' (comment) are ignored until next line (numbers too).
      </para>
    </note>
  </refsect1>
 
  <refsect1>
    <title>Credits</title>
    <para>
      <simplelist>
        <member>Author: &namegabriel;</member>
        <member>Italy</member>
        <member>February, 1998</member>
      </simplelist>
    </para>

    <para>New in Csound version 3.47. Comments starting with '#' are
    ignored from Csound version 5.12.</para>
  </refsect1>
</refentry>