[0m


XNOISE(1)	    UNIX Programmer's Manual		XNOISE(1)



[1mNAME
     [0mxnoise - Acorn-Noise demonstration client

[1mSYNOPSIS
     xnoise

DESCRIPTION
     [0m_X_n_o_i_s_e 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 [1mDISPLAY [0mand
     accepts a simple command language which is mapped into
     Acorn-Noise requests to the server.

     If _x_n_o_i_s_e 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.

[1mSAMPLE NUMBERS
     [0m_X_n_o_i_s_e 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 _x_n_o_i_s_e.  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 sam-
     ples do not need to be created, but otherwise may be passed
     to commands in place of a sample you have created yourself.

[1mCOMMANDS
     [0m_h_e_l_p, ?   Display a brief summary of commands.

     _c_r_e_a_t_e [1mrate
	       [0mCreates a sample.  The parameter specifies the
	       rate of the sample in Hertz.  The internal sample
	       number assigned to it is displayed.

     _a_p_p_e_n_d [1mnumber filename samplesize
	       [0mAppend sample data to the given sample.	The
	       [1mnumber [0mis the sample number as printed by the
	       _c_r_e_a_t_e command.	The [1mfilename [0mis the name of a
	       file containing valid sample data.  The [1msamplesize
	       [0mexpresses the size of the sample units in bits: 8,
	       16 or 32.

     _p_l_a_y [1mnumber volume
	       [0mPlay the specified sample.  [1mNumber [0mis the sample
	       number printed by the _c_r_e_a_t_e command.  [1mVolume [0mis
	       the volume to use, expressed as a percentage.

     _r_e_s_e_t [1mnumber rate



[0mPrinted 4/11/91     Revision 1.1 of 08/08/90			1






XNOISE(1)	    UNIX Programmer's Manual		XNOISE(1)



	       Reset the specified sample to the rate given by
	       the [1mrate [0mparameter.  This deletes any sample data
	       currently attached to the sample.

     _d_e_s_t_r_o_y [1mnumber
	       [0mDestroy the specified sample.

     _i_n_f_o      Display information about the state of the sound
	       system.

     _s_a_m_p_l_e_r_a_t_e [1mrate
	       [0mDisplay the optimum sample rate closest to the
	       given rate.

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

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

     _b_e_l_l      Put Acorn-Noise into `bell' mode, which requests
	       the best sound capabilities that the server can
	       provide without claiming exclusive use of the
	       sound device.

     _q_u_i_t      Exit _x_n_o_i_s_e.  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, _d_e_s_t_r_o_y them.

     All unique command abbreviations are accepted.

[1mSEE ALSO
     [0mXNoise(3Xext)

[1mAUTHOR
     [0mSteve Hunt, Acorn Computers Ltd.

[1mCOPYRIGHT
     [0mCopyright 1990, Acorn Computers Ltd.















Printed 4/11/91     Revision 1.1 of 08/08/90			2



[0m