1
<!-- manual page source format generated by PolyglotMan v3.0.7, -->
2
<!-- available via anonymous ftp from ftp.cs.berkeley.edu:/ucb/people/phelps/tcltk/rman.tar.Z -->
6
<TITLE>man page(1)</TITLE>
9
<A HREF="#toc">Table of Contents</A><P>
11
<H2><A NAME="sect0" HREF="#toc0">Name</A></H2>
14
Network Audio System - a portable, network-transparent
17
<H2><A NAME="sect1" HREF="#toc1"><B>Synopsis</B></A></H2>
20
The Network Audio System service is a network-transparent
21
system developed at Network Computing Devices for playing,
22
recording, and manipulating audio data over a network. It
23
uses the client/server model to separate application code
24
from the software drivers needed to control specific audio
25
input and output devices.
27
<H2><A NAME="sect2" HREF="#toc2"><B>Description</B></A></H2>
30
The Network Audio System service provides applications
31
with the ability to send and receive audio data such as
32
voice, sound effects, and music in a network environment.
33
A audio server inside the desktop terminal or personal
34
computer controls the various input and output devices in
35
response to messages sent from client programs running on
38
A variety of utility programs are provided that can be
39
used to play or record audio using shell scripts or command-line
40
procedures. More ambitious applications can
41
communicate directly with the audio server using a C-language
44
The Network Audio System service supports a variety of the
45
common formats used to store sound data. Audio inputs and
46
outputs can run at a any of a range of sampling rates.
47
The audio server automatically converts all data to the
48
designed format or rate.
50
Streams of data from multiple inputs can be mixed together
51
and directed to any attached output device. Sounds that
52
are used many times can be stored in the server so that
53
they do not need to be transmitted over the network each
54
time they are played. Furthermore, inputs can be hooked
55
directly to outputs (for example, a CD player can be connected
56
to a set of speakers) so that data can be played
57
without requiring any client intervention or network traffic.
59
<H2><A NAME="sect3" HREF="#toc3"><B>Audio</B> <B>Server</B> <B>Names</B></A></H2>
62
Each audio server has a name that is used by applications
63
in establishing a connection. The format of the name
64
depends upon the type of network being used. In TCP/IP
65
environments, audio server names look like:
67
tcp/<I>hostname</I>:<I>portnum</I>
69
where <I>hostname</I> is the name or numeric IP address of the
70
desktop machine to be contacted and <I>portnum</I> is the port
71
number on which the server is listening. If the ``tcp/''
72
prefix is not given, 8000 is automatically added to <I>port</I><B>_</B>n<I>um</I>
73
so that the audio server name is compatible with the X
74
Window System display name.
76
In DECnet environments, audio server names look like:
78
decnet/<I>nodename</I>::<I>num</I>
80
where <I>nodename</I> is the name or numeric DECnet address of
81
the desktop machine to be contacted and <I>num</I> is the DECnet
82
task AUDIO$<I>num</I>. If the ``decnet/'' prefix is omitted, it
83
is automatically added so that the audio server name is
84
compatible with the X Window System display name.
86
Most audio utilities accept a command line argument <I>-audio</I>
87
<I>servername</I> for specifying the audio server to be contacted.
89
% auinfo -audio tcp/ncdunit:8000
91
If no server is specified on the command line, the
92
AUDIOSERVER environment variable is checked to see if a
93
name has been stored there. Otherwise, the DISPLAY environment
94
variable used by X Window System applications is
95
checked and the corresponding audio server is used.
97
<H2><A NAME="sect4" HREF="#toc4"><B>Sample</B> <B>Programs</B></A></H2>
100
Several sample programs that use the Network Audio System
101
service are provided by NCD:
103
<B>auplay</B> This program simply plays the files listed on its
104
command line. It is typically used from shell
105
scripts, command-line procedures, or other programs
106
that just need to ``dump'' sound data to the
109
<B>audemo</B> This program allows the user to select and play
110
pre-recorded sound files or to record new sound
111
files. It provides a simple control panel for
112
dynamically changing the volume while a sound is
113
being played and for aborting a sound.
115
<B>audial</B> This program generates North American telephone
116
touch tones correspond to a given string. <I>audial</I>
117
can also recognize touch tones and produce the
118
corresponding string.
120
<B>autool</B> This program is compatible with the Sun <I>audiotool</I>
121
program and is typically used to play prerecorded
122
sound files. Unlike <I>auplay</I> it provides a graphical
123
interface to allow the user to replay or cancel
126
<B>auinfo</B> This program lists information describing the
128
capabilities of an audio server.
130
<B>auctl</B> This program can be used to change various device
133
<B>auscope</B> This program is an audio protocol filter that can
134
be used to view the network packets being sent
135
between an application and an audio server.
137
<B>aupanel</B> This program provides an X-based window-oriented
138
interface allowing the user to adjust the
139
attributes of the devices provided by the Network
140
Audio System service.
142
<B>auedit</B> This program provides an X-based window-oriented
143
interface allowing the user to edit audio files.
147
This program allows the user to perform various
148
conversion operations on sound files.
150
<B>auphone</B> This program provides an X-based window-oriented
151
interface allowing two-way real time voice communication
152
between two audio servers.
156
This program is used to record audio data from an
157
audio server into a file.
159
<B>auwave</B> This program provides an X-based window-oriented
160
interface demonstrating the use of waveform elements.
162
<H2><A NAME="sect5" HREF="#toc5"><B>Audio</B> <B>Files</B></A></H2>
165
The audio programming library and utility programs can be
166
used to read and write files in any of the following file
171
These files typically have a `.au' or `.snd' extension.
172
They are usually produced by Sun or NeXT
175
<B>Creative</B> <B>Labs</B><BR>
177
These files typically have a `.voc' extension.
178
They are usually produced by by Soundblaster audio
179
cards on IBM PC compatible computers.
181
<B>Microsoft</B> <B>WAVE</B><BR>
183
These files typically have a `.wav' extension.
184
They are usually produced by IBM PC compatible computers.
188
<DT><B>AIFF</B></DT></DT>
193
These files typically have an `.aiff' or `.aif'
194
extension. They are usually produced by SGI workstations
197
<B>Amiga</B> <B>IFF/8SVX</B><BR>
199
These files typically have an `.iff' extension.
201
Due to the nature of the file formats, only the Sun/NeXT
202
file format can be piped through standard input and/or
203
standard output. The convention for specifying standard
204
input or standard output is to use a hyphen ("-") as the
207
<H2><A NAME="sect6" HREF="#toc6"><B>Programming</B></A></H2>
210
Application developers may create their own audio clients
211
using the Network Audio System programming library.
213
<H2><A NAME="sect7" HREF="#toc7"><B>Environment</B> <B>Variables</B></A></H2>
216
The following environment variables are used by Network
217
Audio System programs:
221
<DT><B>AUDIOSERVER</B></DT></DT>
223
This specifies the name of default audio server to
224
contact if no name is explicitly given on the command
229
<B>DISPLAY</B> This specifies the name of an X Window System display
230
that should be assumed to also have a corresponding
231
Network Audio System server.
233
<H2><A NAME="sect8" HREF="#toc8"><B>See</B> <B>Also</B></A></H2>
236
<A HREF="man:auplay(1)">auplay(1)</A>
237
, <A HREF="man:audemo(1)">audemo(1)</A>
238
, <A HREF="man:audial(1)">audial(1)</A>
239
, <A HREF="man:autool(1)">autool(1)</A>
240
, <A HREF="man:auinfo(1)">auinfo(1)</A>
242
<A HREF="man:auctl(1)">auctl(1)</A>
243
, <A HREF="man:auscope(1)">auscope(1)</A>
244
, <A HREF="man:aupanel(1)">aupanel(1)</A>
245
, <A HREF="man:auedit(1)">auedit(1)</A>
246
, <A HREF="man:auconvert(1)">auconvert(1)</A>
248
<A HREF="man:auphone(1)">auphone(1)</A>
249
, <A HREF="man:aurecord(1)">aurecord(1)</A>
250
, <A HREF="man:auwave(1)">auwave(1)</A>
253
<I>Network</I> <I>Audio</I> <I>System</I> <I>Overview</I> <I>and</I> <I>Programmers</I> <I>Guide</I>
255
<H2><A NAME="sect9" HREF="#toc9"><B>Copyright</B></A></H2>
258
The following copyright and permission notice applies to
259
all files in the Network Audio System application programming
260
libraries and example programs provided in source
261
form by Network Computing Devices:
263
Copyright 1993, 1994 Network Computing Devices, Inc.
265
Permission to use, copy, modify, distribute, and sell this
266
software and its documentation for any purpose is hereby
267
granted without fee, provided that the above copyright
268
notice appear in all copies and that both that copyright
269
notice and this permission notice appear in supporting
270
documentation, and that the name Network Computing
271
Devices, Inc. not be used in advertising or publicity pertaining
272
to distribution of this software without specific,
273
written prior permission.
277
<DT>THIS SOFTWARE </DT></DT>
278
<DD>IS PROVIDED `AS-IS'. NETWORK COMPUTING
279
DEVICES, INC., DISCLAIMS ALL WARRANTIES WITH REGARD TO
280
THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED
281
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
282
PURPOSE, OR NONINFRINGEMENT. IN NO EVENT SHALL NETWORK
283
COMPUTING DEVICES, INC., BE LIABLE FOR ANY DAMAGES WHATSOEVER,
284
INCLUDING SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
285
INCLUDING LOSS OF USE, DATA, OR PROFITS, EVEN IF
286
ADVISED OF THE POSSIBILITY THEREOF, AND REGARDLESS OF
287
WHETHER IN AN ACTION IN CONTRACT, TORT OR NEGLIGENCE,
288
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
293
<H2><A NAME="sect10" HREF="#toc10"><B>Trademarks</B></A></H2>
296
NCD, NCD Display Station, and NCDware are all trademarks
297
of Network Computing Devices, Inc.
299
X Window System is a trademark of the Massachusetts Institute
302
<H2><A NAME="sect11" HREF="#toc11"><B>Authors</B></A></H2>
305
Greg Renda, Jim Fulton, David Lemke
309
<A NAME="toc"><B>Table of Contents</B></A><P>
311
<LI><A NAME="toc0" HREF="#sect0">Name</A></LI>
312
<LI><A NAME="toc1" HREF="#sect1">Synopsis</A></LI>
313
<LI><A NAME="toc2" HREF="#sect2">Description</A></LI>
314
<LI><A NAME="toc3" HREF="#sect3">Audio Server Names</A></LI>
315
<LI><A NAME="toc4" HREF="#sect4">Sample Programs</A></LI>
316
<LI><A NAME="toc5" HREF="#sect5">Audio Files</A></LI>
317
<LI><A NAME="toc6" HREF="#sect6">Programming</A></LI>
318
<LI><A NAME="toc7" HREF="#sect7">Environment Variables</A></LI>
319
<LI><A NAME="toc8" HREF="#sect8">See Also</A></LI>
320
<LI><A NAME="toc9" HREF="#sect9">Copyright</A></LI>
321
<LI><A NAME="toc10" HREF="#sect10">Trademarks</A></LI>
322
<LI><A NAME="toc11" HREF="#sect11">Authors</A></LI>