Periodically reads four orchestra control-signal values from an external file.
13
</refpurpose>
13
</refpurpose>
14
14
</refnamediv>
15
15
16
16
<refsect1>
28
28
<refsect1>
29
29
<title>Initialization</title>
30
30
<para>
31
<emphasis>ifilname</emphasis> -- an integer N denoting a file named "readk.N" or a character string (in double quotes, spaces permitted) denoting the external file name. For a string, it may either be a full path name with directory specified or a simple filename. In the later case, the file is sought first in the current directory, then in SSDIR, and finally in SFDIR.
31
<emphasis>ifilname</emphasis> -- an integer N denoting a file named "readk.N" or a character string (in double quotes, spaces permitted) denoting the external file name. For a string, it may either be a full path name with directory specified or a simple filename. In the later case, the file is sought first in the current directory, then in <link linkend="CommandEnvironment"><citetitle>SSDIR</citetitle></link>, and finally in <link linkend="CommandEnvironment"><citetitle>SFDIR</citetitle></link>.
32
32
</para>
33
33
34
34
<para>
65
65
</para>
66
66
67
67
<para>
68
<emphasis>iprd</emphasis> -- the rate (period) in seconds, rounded to the nearest orchestra control period, at which the signals are read from the input file. A value of 0 implies one control period (the enforced minimum), which will read new values at the orchestra control rate. Longer periods will cause the same values to repeat for more than one control period unless interpolation is used.
68
<emphasis>iprd</emphasis> -- the rate (period) in seconds, rounded to the nearest orchestra control period, at which the signals are read from the input file. A value of 0 implies one control period (the enforced minimum), which will read new values at the orchestra control rate. Longer periods will cause the same values to repeat for more than one control period.
69
<!--unless interpolation is used.-->
69
70
</para>
70
71
71
72
81
82
<refsect1>
82
83
<title>Performance</title>
83
84
<para>
84
<emphasis>kr1, kr2, kr3, kr4</emphasis> -- output of the signals read from ifilname.
85
<emphasis>kr1, kr2, kr3, kr4</emphasis> -- output of the signals read from <emphasis>ifilname</emphasis>.