diff options
author | agc <agc> | 1998-05-18 10:02:52 +0000 |
---|---|---|
committer | agc <agc> | 1998-05-18 10:02:52 +0000 |
commit | 0694747ad2c66a2f31191b22b32cd5ab863fd503 (patch) | |
tree | 0e8a79805f3e0f10a57560d30d8a78d23c91143f /audio | |
parent | aa910815405c69eeccddd146966b4ae8cc972165 (diff) | |
download | pkgsrc-0694747ad2c66a2f31191b22b32cd5ab863fd503.tar.gz |
Be a bit more descriptive - add the README file from the distribution
Diffstat (limited to 'audio')
-rw-r--r-- | audio/nas/pkg/DESCR | 298 |
1 files changed, 293 insertions, 5 deletions
diff --git a/audio/nas/pkg/DESCR b/audio/nas/pkg/DESCR index b07f298ba12..a356ad6a342 100644 --- a/audio/nas/pkg/DESCR +++ b/audio/nas/pkg/DESCR @@ -1,5 +1,293 @@ - The Network Audio System is designed for playing, - recording, and manipulating audio data over a network. - Like the X Window System, it uses the client/server model to - separate applications from the specific drivers that control - audio input and output devices. +The Network Audio System is designed for playing, recording, and +manipulating audio data over a network. Like the X Window System, it +uses the client/server model to separate applications from the +specific drivers that control audio input and output devices. + +The README file from the distribution follows: + + *********************************************************************** + * * + * The Network Audio System (NAS) * + * * + * An Audio Protocol For Networks * + * * + * Release 1.2 - June 3, 1994 * + * * + *********************************************************************** + + or + + open ("/dev/audio")? Just Say No! + + +This directory tree contains sources for the Network Audio System, a +network-transparent, client/server audio system, including: + + o sample server implementations + + - Sun Sparc 1 AM79C30A Digital Subscriber Controller and + Sparc 10 Dual Basic Rate ISDN Interface + (SunOS 4.1.[23], Solaris 2.x) + + - SGI Indigo (IRIX 5.x) + + - VOXware (FreeBSD, Linux, SVR4.[02]) + + - HPUX + + o an application programming interface library + o a variety of sample applications + +The client software can also be used with several models of NCD X +terminals as well as NCD's PCXware (an X server for PCs running +Microsoft Windows). + +Key features of the Network Audio System include: + + o Device-independent audio over the network + o Lots of audio file and data formats + o Can store sounds in server for rapid replay + o Extensive mixing, separating, and manipulation of audio data + o Simultaneous use of audio devices by multiple applications + o Use by a growing number of ISVs + o Small size + o Free! No obnoxious licensing terms + +Please note that the Network Audio System has no relationship to the NetAudio +products from Townshend Computer Tools. + +Look at the file doc/xcon94paper.ps for a paper on the Network Audio +System. + + * * * * * + +I. Roadmap + +Here is a quick guide to where things are in this distribution (relative to +the directory nas/): + + README this file + HISTORY log of changes + BUGS known landmines + BUILDNOTES notes on building under various OSs, X releases + TODO things we'd like to get around to doing + RELEASE release identification + doc/ not enough documentation; overview, slides, lib + config/ a little bit of imake stuff + lib/audio/ API used by sample programs + clients/audio/ sample programs + server/ server code + dia/ device-independent bits + dda/sun/ device-dependent audio driver for Sun + dda/sgi/ device-dependent audio driver for SGI Indigo + dda/voxware/ device-dependent audio driver for VOXware + dda/hpux/ device-dependent audio driver for Hpux + +When built, the server will be in server/[ausun,ausgi,auvoxware,auhpux], the +library in lib/audio/libaudio.a, and the sample applications in +clients/audio/aufoo/aufoo. + +In addition, the separate distribution sounds.tar.Z contains a directory of +example sounds: + + examples/sounds/ various sounds that can be played + +If you don't have your own sound bites to nibble, grab these. + + * * * * * + +II. Building the Release + +To build the software: + + 1. Make sure you have imake. + (See the BUILDNOTES file if you want to try building with X11R4). + + 2. Look at config/NetAudio.tmpl and add a BINDIR definition if you want. + By default, the programs are put into /usr/bin/X11. + + 3. Do "xmkmf" to create the initial Makefile. + + 4. Do "make World" (note the uppercase World) to build the distribution. + (Attention Linux Users: instead of "make World" you should do + make WORLDOPTS="-k CDEBUGFLAGS='-O2 -D__USE_BSD_SIGNAL'" World) + + If you'd like to enable the option of having the audio library + automatically start up an NAS server on the local host when + necessary, use the following command to build the + distribution: + + make WORLDOPTS='-k CDEBUGFLAGS="$(CDEBUGFLAGS) -DSTARTSERVER"' World + + 5. If everything built successfully, you can install it using + "make install"; to temporarily stage it under some directory, use + "make install DESTDIR=/usr/tmp/nas" or some such. + + 6. To install the manual pages, use "make install.man" or + "make install.man DESTDIR=/usr/tmp/nas" as above. + +A complete installation should include the following files: + + /usr/include/audio/Afuncproto.h Header files + /usr/include/audio/Afuncs.h + /usr/include/audio/Amd.h + /usr/include/audio/Aos.h + /usr/include/audio/Aosdefs.h + /usr/include/audio/Aproto.h + /usr/include/audio/audio.h + /usr/include/audio/Alibint.h + /usr/include/audio/Alibnet.h + /usr/include/audio/Xtutil.h + /usr/include/audio/audiolib.h + /usr/include/audio/audioutil.h + /usr/include/audio/snd.h + /usr/include/audio/wave.h + /usr/include/audio/voc.h + /usr/include/audio/aiff.h + /usr/include/audio/sound.h + /usr/include/audio/soundlib.h + /usr/include/audio/fileutil.h + /usr/include/audio/8svx.h + /usr/include/audio/Astreams.h + + /usr/bin/X11/auconvert Sample programs + /usr/bin/X11/auctl + /usr/bin/X11/audemo + /usr/bin/X11/audial + /usr/bin/X11/auedit + /usr/bin/X11/auinfo + /usr/bin/X11/aupanel + /usr/bin/X11/auplay + /usr/bin/X11/aurecord + /usr/bin/X11/autool + /usr/bin/X11/auwave + /usr/bin/X11/auphone + /usr/bin/X11/auscope + /usr/bin/X11/soundtoh + /usr/bin/X11/issndfile + /usr/bin/X11/playbucket + /usr/bin/X11/checkmail + + /usr/man/mann/*.n Client, server, and misc + man pages + + /usr/man/man3/*.3 API man pages + + /usr/lib/libaudio.a API library + /usr/lib/X11/AuErrorDB Error database + + /usr/bin/X11/ausun Sun server or + /usr/bin/X11/ausgi SGI server or + /usr/bin/X11/auvoxware VOXware server + /usr/bin/X11/auhpux Hpux server + /usr/bin/X11/au symlink to one of the above + + * * * * * + +III. Using the Network Audio System + +Now that you have things built, you can use the Network Audio System +as follows: + + % ausun -aa & # -aa allows any host access + % setenv AUDIOSERVER `hostname`:0 + % auinfo + % audemo examples/sounds + % ... + +If you are using it over the network, the shorthand syntax for specifying an +audio server is hostname:0. Access control is still a bit primitive.... + + * * * * * + +IV. Using the Network Audio System with Sun Deskset + +The "autool" program can be used as a replacement for audiotool. This +allows Sun Deskset applications (e.g. mailtool, etc.) to be used with +the Network Audio System. See the autool man page +(clients/audio/autool/autool.man) for details on how to configure +Deskset. + + * * * * * + +V. Games + +Well, now that you have networked audio, it's time to actually use it +for something. XBoing and xpilot are both distributed with Network +Audio System support. Check ftp.x.org:/contrib/audio/nas/contrib for +other applications that support the Network Audio System. + + * * * * * + +VI. Finding Sounds to Play With + +Users with some versions of SunOS can find a number of audio files to +listen to in /usr/demo/SOUND/sounds/. Once the Network Audio System +is running, they can be examined using: + + % audemo /usr/demo/SOUND/sounds + +A separate tar archive called sounds.tar.Z is available from ftp.x.org. + +For the true audio packrat, there are a number of anonymous ftp sites that +contain archives of thousands of sound bites. The "Sound Site Newsletter" +published periodically on comp.sys.ibm.pc.soundcard, comp.sys.ibm.pc.misc, and +rec.games.misc contains a detailed list of machines, bulletin boards, etc. + + * * * * * + +VII. For More Information + +We've set up a mailing list for folks who are working with the Network +Audio System: + + nas@ncd.com General discussion of the Network + Audio System; anyone who who will + actively participate is welcome to + join. + + nas-request@ncd.com Where to send requests to get on or off the + mailing list. + + +The Network Audio System has benefited greatly from the testing and +contributions of many people on the mailing list. We'd like to thank +them for their help and encourage everyone to participate in the +on-going development process. + +We hope you enjoy the Network Audio System. There're still a few +pieces to be added, but already a significant number of hardware and +software vendors are finding that it solves their problems. Besides, +you can't beat the price! :-) + + + Jim Fulton, Greg Renda, Dave Lemke + Network Computing Devices, Inc. + + +-------------------------------------------------------------------------------- + + Copyright 1995 Network Computing Devices, Inc. + + Permission to use, copy, modify, distribute, and sell this software and + its documentation for any purpose is hereby granted without fee, provided + that the above copyright notice appear in all copies and that both that + copyright notice and this permission notice appear in supporting + documentation, and that the name Network Computing Devices, Inc. not be + used in advertising or publicity pertaining to distribution of this + software without specific, written prior permission. + + THIS SOFTWARE IS PROVIDED `AS-IS'. NETWORK COMPUTING DEVICES, INC., + DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT + LIMITATION ALL IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A + PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT SHALL NETWORK + COMPUTING DEVICES, INC., BE LIABLE FOR ANY DAMAGES WHATSOEVER, INCLUDING + SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING LOSS OF USE, DATA, + OR PROFITS, EVEN IF ADVISED OF THE POSSIBILITY THEREOF, AND REGARDLESS OF + WHETHER IN AN ACTION IN CONTRACT, TORT OR NEGLIGENCE, ARISING OUT OF OR IN + CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + +Translation: You can do whatever you want with this software! + + + $NCDId: @(#)README,v 1.30 1995/11/28 23:24:54 greg Exp $ |