XNOISE(1)

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 rate
    Creates 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.

info
    Display information about the state of the sound system.

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

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

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

bell
    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.

quit
    Exit 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.