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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
|
<!--
$NCDId: @(#)audemo.man,v 1.14 1994/06/03 17:51:22 greg Exp $
-->
<!-- manual page source format generated by PolyglotMan v3.0.8+X.Org, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<html>
<head>
<title>AUDEMO(1) manual page</title>
</head>
<body bgcolor='#efefef' text='black' link='blue' vlink='#551A8B' alink='red'>
<a href='#toc'>Table of Contents</a><p>
<h2><a name='sect0' href='#toc0'>Name</a></h2>
audemo - Network Audio System record and play demo
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>audemo</b>
[<b>-audio</b> <i>servername</i>] [<b>-toolkitoption ...</b>] [<i>directory</i>]
<h2><a name='sect2' href='#toc2'>Description</a></h2>
<i>audemo</i> provides
an X-based window-oriented user interface to the Network Audio System service.
It allows the user to play pre-recorded sound files, record new sound files
and to manipulate Network Audio System buckets.
<h2><a name='sect3' href='#toc3'>Audemo and the Athena Widget
Set</a></h2>
<i>audemo</i> uses the X Toolkit Intrinsics and the Athena Widget Set. For more
information, see the Athena Widget Set documentation.
<h2><a name='sect4' href='#toc4'>Screen Layout</a></h2>
<i>audemo</i>
starts out with a single window divided into several areas:
<dl>
<dt><b>o</b></dt>
<dd>A collection
of command buttons. </dd>
<dt><b>o</b></dt>
<dd>A left and right level meter. </dd>
<dt><b>o</b></dt>
<dd>A volume indicator and
control slider. </dd>
<dt><b>o</b></dt>
<dd>An information window. </dd>
<dt><b>o</b></dt>
<dd>An editable field containing the
directory to be searched for sound files. </dd>
<dt><b>o</b></dt>
<dd>An editable field containing
a list of sound files to search for. </dd>
<dt><b>o</b></dt>
<dd>A window containing the list of sound
files that may be selected for playing or loading into buckets. </dd>
</dl>
<h2><a name='sect5' href='#toc5'>Playing
a Sound File</a></h2>
To play a sound file you must first select it from the list
of files in the file window. You can control which files are listed in
this window by editing the <i>Directory</i> and/or <i>Template</i> fields and clicking
on the <i>Rescan</i> button. To select a file, single-click on the filename. This
will highlight the filename and display information about the file in the
information window. The information displayed includes:
<dl>
<dt><b>Filename</b></dt>
<dd>The full
pathname of the file. </dd>
<dt><b>File Format</b></dt>
<dd>The file format of the audio file. </dd>
<dt><b>Data
Format</b></dt>
<dd>The encoding format of the audio data. </dd>
<dt><b>Tracks</b></dt>
<dd>The number of tracks
of audio data. </dd>
<dt><b>Frequency</b></dt>
<dd>The frequency at which the audio data was sampled.
</dd>
<dt><b>Duration</b></dt>
<dd>The duration of the audio data in seconds. </dd>
<dt><b>Text</b></dt>
<dd>Any text information
stored in the file. </dd>
</dl>
<p>
Once the file has been selected, you can start it playing
by clicking on the <i>Play</i> command button. A shortcut for playing a file is
to double-click on the file name. This will select the file and start it
playing. When a file is playing, the <i>Play</i> command button is highlighted.
To stop the playing of a file, click on the highlighted <i>Play</i> button. To
enable the left and right level meters, click on the <i>Meter</i> button before
starting to play the file. To disable the left and right level meters,
click again on the highlighted <i>Meter</i> button. To adjust the volume level,
use the volume slider.
<h2><a name='sect6' href='#toc6'>Recording to a File</a></h2>
<i>audemo</i> can record sound files
in any supported file and data format. To record a sound file you must first
bring up the record window by clicking on the <i>Record</i> command button. This
will bring up a window containing the following fields and controls:
<dl>
<dt><b>Filename</b></dt>
<dd>The
name of the file you wish to create. Unless a path is specified here, the
file will be created in the current directory. </dd>
<dt><b>File Format</b></dt>
<dd>A menu of file
formats. </dd>
<dt><b>Data Format</b></dt>
<dd>A menu of data formats. Note that each file format does
not necessarily support all of the data formats listed. </dd>
<dt><b>Max Duration</b></dt>
<dd>See
<b>RECORDING TO A BUCKET</b>. </dd>
<dt><b>Read Only</b></dt>
<dd>See <b>RECORDING TO A BUCKET</b>. </dd>
<dt><b>Frequency</b></dt>
<dd>The sampling
rate (in hertz) for the recording. Higher sampling rates yield better quality
sound but take up more disk and memory space. Common sampling rates are
8000 (good for voice annotations), 11000, 22000, and 44000. </dd>
<dt><b>Mic(rophone)</b></dt>
<dd>This
button tells the audio server if you've got a microphone attached to the
audio input jack. Clicking this button will highlight it and cause the
audio server to boost the input gain to a level suitable for recording
with a microphone. </dd>
<dt><b>Comment</b></dt>
<dd>Text (such as a description) you wish to put into
the audio file. </dd>
<dt><b>Gain</b></dt>
<dd>This slider is used to adjust the recording gain level.
</dd>
<dt><b>Record</b></dt>
<dd>This button starts or stops the recording. </dd>
<dt><b>Monitor</b></dt>
<dd>This button enables
or disables monitoring. </dd>
<dt><b>New Bucket</b></dt>
<dd>See <b>RECORDING TO A BUCKET</b>. </dd>
<dt><b>Dismiss</b></dt>
<dd>This
button stops recording and monitoring and closes the record window. </dd>
</dl>
<p>
Once
you have selected the filename, file and data formats, frequency, mic level,
comment and gain, you are ready to record. To listen in on the audio that
will be recorded you can click on the <i>Monitor</i> button. This will direct
all the audio received from the audio input jack to be played on the speaker.
When you're ready to record, click on the <i>Record</i> button. All the audio
received from the audio input jack will now be recorded into the file.
The recording will continue until you click on the <i>Record</i> button again
or click on the <i>Dismiss</i> button. <b>NOTE:</b> Audio data can accumulate very rapidly,
especially at high sampling rates, resulting in large files.
<h2><a name='sect7' href='#toc7'>Buckets</a></h2>
The
Network Audio System service provides the capability to create server resident
sound objects called <i>buckets</i>. <i>audemo</i> allows the user to create <i>buckets</i>,
record into them, play from them, load them with data from a file and dump
their contents into a file. Note that buckets created by <i>audemo</i> are destroyed
when <i>audemo</i> is terminated. These options are available when you bring up
the buckets window by clicking on the <i>Buckets</i> button in the main window.
The buckets windows is divided into two areas:
<dl>
<dt><b>o</b></dt>
<dd>A collection of command
buttons. </dd>
<dt><b>o</b></dt>
<dd>A table of buckets currently accessible. This table contains the
following columns: <blockquote></dd>
<dt><b>Description</b></dt>
<dd>The text description. </dd>
<dt><b>Duration</b></dt>
<dd>The duration
of the audio data in seconds. </dd>
<dt><b>Tracks</b></dt>
<dd>The number of tracks of audio data. </dd>
<dt><b>Frequency</b></dt>
<dd>The
frequency at which the audio data was sampled. </dd>
<dt><b>Format</b></dt>
<dd>A code letter indicating
the encoding format of the audio data. A key to the format code letters
can be displayed by clicking on the <i>Format Key</i> button. </dd>
<dt><b>Access</b></dt>
<dd>A combination
of code letters indicating the access mode of the bucket. A key to the
access code letters can be displayed by clicking on the <i>Access Key</i> button.
</dd>
</dl>
</blockquote>
<h2><a name='sect8' href='#toc8'>Creating a Bucket from a File</a></h2>
To create a bucket from from an audio data
file, select the filename from the list of files in the file window then
click the <i>Load</i> button in the buckets window. The first line of the buckets
table should now contain the information about the newly created bucket.
<h2><a name='sect9' href='#toc9'>Playing from a Bucket</a></h2>
To play a bucket, select the bucket you wish to play
by clicking on it's information in the buckets table. The entry you click
on should be highlighted. Then click on the <i>Play</i> button in the buckets
window. A shortcut for playing from a bucket is to double-click on the bucket
information. This will select the bucket and start playing from it. To
stop the playing of a bucket, click on the highlighted <i>Play</i> button in the
buckets window. The level meters and volume level can be controlled in
the same way as when playing from a file.
<h2><a name='sect10' href='#toc10'>Recording to a Bucket</a></h2>
To record
into a new bucket, click on the <i>Record</i> button in the buckets window. This
will bring up the record window. This record window is the same as the
one used for recording to files. Instead of specifying a filename, in the
<i>Max Duration</i> field, enter the maximum duration (in seconds) of data that
the bucket is to hold. Clicking on the <i>Read Only</i> button will prevent other
applications from writing into or destroying the bucket. The frequency,
mic level, format and comment are used in the same way as when recording
to files. Once all of the fields are set appropriately, click the <i>New Buckett</i>
button. This will create a new bucket according to the specifications given.
The first line of the buckets table should now contain the information
about the newly created bucket. To begin recording into the bucket, select
the bucket by clicking on it's information in the buckets table. Then click
the <i>Record</i> button in the record window. All the audio received from the
audio input jack will now be recorded into the bucket. The recording will
continue until you click on the <i>Record</i> button again, click on the <i>Dismiss</i>
or the bucket is filled. The <i>Gain</i> slider and the <i>Monitor</i> button operate
the same as when recording to a file.
<h2><a name='sect11' href='#toc11'>Saving a Bucket to a File</a></h2>
To save a
bucket to a file, first select the bucket by clicking on its information
in the buckets table. Then click on the <i>Save</i> button in the buckets window.
A dialog box will pop up prompting you for the name of the file in which
to save the bucket data, and the file format. The data format used will
be that of the bucket. Note that each file format may only support selected
data formats. If no path is given in the filename, the file will be created
in the current directory. Clicking on <i>Ok</i> or pressing the <b>RETURN</b> key will
cause the file to be created and the data from the bucket to be written
to the file.
<h2><a name='sect12' href='#toc12'>Deleting a Bucket</a></h2>
To delete a bucket, first select the bucket
by clicking on it's information in the buckets table. Then click on the
<i>Delete</i> button in the buckets window. If the <i>audemo</i> has the appropriate
access permissions for the bucket, the bucket will be deleted and it's information
will be removed from the bucket table.
<h2><a name='sect13' href='#toc13'>Exiting Audemo</a></h2>
Clicking on the <i>Quit</i>
button will cause <i>audemo</i> to exit, stopping any playing or recording operations
and destroying any buckets that were created.
<h2><a name='sect14' href='#toc14'>Command Line Options</a></h2>
<dl>
<dt><b>-audio</b>
<i>servername</i></dt>
<dd>This option specifies the Network Audio System server to which
<i>audemo</i> should connect. </dd>
<dt><i>directory</i></dt>
<dd>The directory name that <i>audemo</i> will use
to build the list of selectable file names. When <i>directory</i> is not specified
on the command line, the current working directory is used. </dd>
</dl>
<h2><a name='sect15' href='#toc15'>Examples</a></h2>
In
the following example, in a <i>TCP/IP</i> network, <i>mcxterm</i> is the name of the
desktop machine running the audio server. The default port is <i>8000</i> and
sound files are located in <i>~/snd</i>:
<dl>
<dt>audemo -audio tcp/mcxterm:8000 ~/snd
</dt>
<dd></dd>
</dl>
<p>
In the following example, the shortened form of the audio server name
is used and sound files from the current working directory will be used:
<dl>
<dt>audemo -audio mcxterm:0 </dt>
<dd></dd>
</dl>
<h2><a name='sect16' href='#toc16'>Environment</a></h2>
<p>
In addition to the standard toolkit
environment variables, the following environment variables are used by
<i>audemo</i>:
<dl>
<dt><b>AUDIOSERVER</b></dt>
<dd>This variable specifies the default audio server to
contact if <i>-audio</i> is not specified on the command line. If this variable
is not set and the <i>-audio</i> is not specified on the command line, <i>audemo</i> will
attempt to connect to the audio server running on the X Window System display.
</dd>
</dl>
<h2><a name='sect17' href='#toc17'>Bugs</a></h2>
Warning: audemo is the xterm of the Network Audio System. It was written
to test features as the Network Audio System was being developed. It was
also the author's first Xt program. Consequently, it's pretty ugly and should
be completely re-written from scratch.
<h2><a name='sect18' href='#toc18'>See Also</a></h2>
<a href='nas.1.html'>nas(1)</a>
, <a href='X.1.html'>X(1)</a>
<h2><a name='sect19' href='#toc19'>Copyright</a></h2>
Copyright
1993, 1994 Network Computing Devices, Inc.
<h2><a name='sect20' href='#toc20'>Author</a></h2>
Greg Renda, Network Computing
Devices, Inc. <p>
<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Audemo and the Athena Widget Set</a></li>
<li><a name='toc4' href='#sect4'>Screen Layout</a></li>
<li><a name='toc5' href='#sect5'>Playing a Sound File</a></li>
<li><a name='toc6' href='#sect6'>Recording to a File</a></li>
<li><a name='toc7' href='#sect7'>Buckets</a></li>
<li><a name='toc8' href='#sect8'>Creating a Bucket from a File</a></li>
<li><a name='toc9' href='#sect9'>Playing from a Bucket</a></li>
<li><a name='toc10' href='#sect10'>Recording to a Bucket</a></li>
<li><a name='toc11' href='#sect11'>Saving a Bucket to a File</a></li>
<li><a name='toc12' href='#sect12'>Deleting a Bucket</a></li>
<li><a name='toc13' href='#sect13'>Exiting Audemo</a></li>
<li><a name='toc14' href='#sect14'>Command Line Options</a></li>
<li><a name='toc15' href='#sect15'>Examples</a></li>
<li><a name='toc16' href='#sect16'>Environment</a></li>
<li><a name='toc17' href='#sect17'>Bugs</a></li>
<li><a name='toc18' href='#sect18'>See Also</a></li>
<li><a name='toc19' href='#sect19'>Copyright</a></li>
<li><a name='toc20' href='#sect20'>Author</a></li>
</ul>
</body>
</html>
|
