NAME

xnoise − Acorn-Noise demonstration client

SYNOPSIS

xnoise

DESCRIPTION

Xnoise is an X11 client which exists to test and demonstrate the Acorn-Noise server extension.  It opens a connection to the display given by the environment variable DISPLAY and accepts a simple command language which is mapped into Acorn-Noise requests to the server. 

If xnoise is started from a terminal, then it will prompt for commands.  If not, it assumes that it is being fed input from a file or pipe, and is silent. 

SAMPLE NUMBERS

Xnoise assigns an identification number to each sample created.  This is not the same as the noise ID allocated by the server; the mapping between the two is handled for you by xnoise. Sample numbers are allocated on a first-unused basis starting from 0; destroying a sample frees that number for re-use.

Two negative sample numbers are reserved for the bell noise (sample -1) and the keyclick noise (sample -2).  These samples do not need to be created, but otherwise may be passed to commands in place of a sample you have created yourself. 

COMMANDS

help, ?Display a brief summary of commands. 

create rateCreates a sample.  The parameter specifies the rate of the sample in Hertz.  The internal sample number assigned to it is displayed. 

append number filename samplesize
Append sample data to the given sample.  The number is the sample number as printed by the create command.  The filename is the name of a file containing valid sample data.  The samplesize expresses the size of the sample units in bits: 8, 16 or 32. 

play number volume
Play the specified sample.  Number is the sample number printed by the create command.  Volume is the volume to use, expressed as a percentage. 

reset number rate
Reset the specified sample to the rate given by the rate parameter.  This deletes any sample data currently attached to the sample. 

destroy number
Destroy the specified sample.

infoDisplay information about the state of the sound system. 

samplerate rate
Display the optimum sample rate closest to the given rate.

onTurn Acorn-Noise on.  Grab the sound device if it is an exclusive-use device. 

offTurn Acorn-Noise off.  Relinquish the sound device if it is an exclusive-use device. 

bellPut Acorn-Noise into ‘bell’ mode, which requests the best sound capabilities that the server can provide without claiming exclusive use of the sound device. 

quitExit xnoise. End-of-file has the same effect. If the keyclick or bell noises have been altered, they are left in their new states.  To return them to their original sounds, destroy them. 

All unique command abbreviations are accepted. 

SEE ALSO

XNoise(3Xext)

AUTHOR

Steve Hunt, Acorn Computers Ltd. 

COPYRIGHT

Copyright 1990, Acorn Computers Ltd. 

Acorn Computers Ltd  —  Revision 1.1 of 08/08/90