SndUtil

Author:		?
Platforms:      NeXT, Intel
Prerequisites:  NEXTSTEP 3.2 Dev and greater
Price:          free
Demo:           
To acquire:     ftp://ccrma-ftp.stanford.edu/pub/NeXT/sndutil.1.3.tar.Z
Information:
Entry updated:  14 Jan 1997
Description:	Utilities for .snd files

Note: These utilities are provided as C source code. You need to compile them yourself.

sndutil project subdirectories

sndproc		- Program shells for soundfile processing
sndtools	- Simple soundfile utilities such as stereo-to-mono converter
dspsound	- Examples for using the 56K DSP chip
sndgen		- Program shells for soundfile creation

The resample subdirectory is no longer included since the sampling-rate converter is now distributed separately.

These utilities are now portable across architectures (at least, they have been
tested on Motorola and Intel by Leigh Smith, leigh@psychokiller.dialix.oz.au).

Most utilities do not have man pages yet, but they typically explain their usage when invoked with no command-line arguments.

Please email any enhancements, bugfixes, etc. to musickit@ccrma.stanford.edu
so we can update the release version.  Thanks!




sndtools
The sndtools directory contains simple UNIX command-line tools for soundfiles.

asciitosnd      converts 16-bit ascii to a soundfile
atcenv          computes the amplitude envelope of an ATC-compressed sound
dsptosnd        converts a DSP commands file to a soundfile
sndblockdc      removes the (possibly drifting) DC component of a soundfile
snddiff         subtracts one sound from another, producing a difference sound
sndedh          edits the contents and/or size of a soundfile header
sndinfo         prints the contents size of a soundfile header
sndrealloc      test sndRealloc() function (for changing size of a sound in mem)
sndrms          compute root-mean-square and other stats for a sound file
sndscale        scales a sound by a gain factor
sndsub          subtracts one soundfile from another
sndsum          adds one soundfile to another
sndtoascii      converts a soundfile to 16-bit ascii
sndtoasm        converts a soundfile to ASCII suitable for DSP assembly
sndtodec        prints soundfile in decimal
sndtohex        prints soundfile in hex
sndtomono       converts stereo to mono by extracting or averaging channels
sndtostereo     converts mono to stereo
sndtrim         trims away zeros at the beginning and end of a sound


dspsound
The dspsound directory contains examples of sound processing and data transfer through the 56k DSP chip.

booter.asm - 
convertlod.c - Converts a .lod 56k assembler file into soundfile format.
decodemulawsquelch.asm - Decodes run-length encoded silences in 8 kHz codec muLaw data.
derecord22m.asm - Same as dsprecord, but only sends every 4th sample.
dsprecord.asm - DSP code to listen to serial port and send data in DMA mode.
dspsound.asm - Include file for complex DMA data transfers.
dspsounddi.asm - DSP-initiated dma in both directions.
dspsoundssi.asm - Include file for ssi data transfers.
encodemulawsquelch.asm - run-length encodes silences in 8 kHz codec muLaw data.
mono.asm - Converts mono to stereo using DMA transfers.
portdefs.asm - Include file for port and register definitions.
ssiplay.asm - Reads samples from host and sends them to ssi port.



sndgen
The sndgen directory contains simple examples of sound synthesis in a main C program on NeXT Computers.

sndnoise	Generates white (gaussian distributed) noise for a given amplitude and time.
sndpluck	Smith-Jaffe extended Karplus-Strong plucked string synthesis.