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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
<refentry id="dumpk4">
<indexterm id="IndexDumpk4"><primary>dumpk4</primary></indexterm>
<refentryinfo><title>Signal I/O:File I/O</title></refentryinfo>
<refmeta>
<refentrytitle>dumpk4</refentrytitle>
</refmeta>
<refnamediv>
<refname>dumpk4</refname>
<refpurpose>
Periodically writes four orchestra control-signal values to an external file.
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<para>
Periodically writes four orchestra control-signal values to a named external file in a specific format.
</para>
</refsect1>
<refsect1>
<title>Syntax</title>
<synopsis><command>dumpk4</command> ksig1, ksig2, ksig3, ksig4, ifilname, iformat, iprd</synopsis>
</refsect1>
<refsect1>
<title>Initialization</title>
<para>
<emphasis>ifilname</emphasis> -- character string (in double quotes, spaces permitted) denoting the external file name. May either be a full path name with target directory specified or a simple filename to be created within the current directory
</para>
<para>
<emphasis>iformat</emphasis> -- specifies the output data format:
<itemizedlist>
<listitem>
<para>1 = 8-bit signed char(high order 8 bits of a 16-bit integer</para>
</listitem>
<listitem>
<para>4 = 16-bit short integers</para>
</listitem>
<listitem>
<para>5 = 32-bit long integers</para>
</listitem>
<listitem>
<para>6 = 32-bit floats</para>
</listitem>
<listitem>
<para>7 = ASCII long integers</para>
</listitem>
<listitem>
<para>8 = ASCII floats (2 decimal places)</para>
</listitem>
</itemizedlist>
</para>
<para>
Note that A-law and U-law output are not available, and that all formats except the last two are binary. The output file contains no header information.
</para>
<para>
<emphasis>iprd</emphasis> -- the period of <emphasis>ksig</emphasis> output in seconds, rounded to the nearest orchestra control period. A value of 0 implies one control period (the enforced minimum), which will create an output file sampled at the orchestra control rate.
</para>
</refsect1>
<refsect1>
<title>Performance</title>
<para>
<emphasis>ksig1, ksig2, ksig3, ksig4</emphasis> -- control-rate signals
</para>
<para>
This opcode allows four generated control signal values to be saved in a named external file. The file contains no self-defining header information. But it contains a regularly sampled time series, suitable for later input or analysis. There may be any number of <emphasis>dumpk4</emphasis> opcodes in an instrument or orchestra but each must write to a different file.
</para>
</refsect1>
<refsect1>
<title>Examples</title>
<para>
See the example for <link linkend="dumpk"><citetitle>dumpk</citetitle></link>. The only difference between <link linkend="dumpk"><citetitle>dumpk</citetitle></link> and <emphasis>dumpk4</emphasis> is that <emphasis>dumpk4</emphasis> can write four values at a time from the file.
<!-- <informalexample>
<programlisting>
knum <emphasis>=</emphasis> knum+1 ; at each k-period
ktemp <emphasis>tempest</emphasis> krms, .02, .1, 3, 2, 800, .005, 0, 60, 4, .1, .995 ;estimate the tempo
koct <emphasis>specptrk</emphasis> wsig, 6, .9, 0 ;and the pitch
<emphasis>dumpk3</emphasis> knum, ktemp, cpsoct(koct), "what happened when", 8 0 ;& save them
</programlisting>
</informalexample>-->
</para>
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<link linkend="dumpk"><citetitle>dumpk</citetitle></link>,
<link linkend="dumpk2"><citetitle>dumpk2</citetitle></link>,
<link linkend="dumpk3"><citetitle>dumpk3</citetitle></link>,
<link linkend="readk"><citetitle>readk</citetitle></link>,
<link linkend="readk2"><citetitle>readk2</citetitle></link>,
<link linkend="readk3"><citetitle>readk3</citetitle></link>,
<link linkend="readk4"><citetitle>readk4</citetitle></link>
</para>
</refsect1>
<refsect1>
<title>Credits</title>
<para>By: John ffitch and Barry Vercoe</para>
<para>1999 or earlier</para>
</refsect1>
</refentry>
|