esdsample(1)							   User Commands						      esdsample(1)

NAME

       esdsample - play a sample

SYNOPSIS

       esdsample [-s hostname:port] [-b] [-d] [-e] [-h] [-m] [-r freq] samplename

DESCRIPTION

       The esdsample utility plays a sample using the Enlighted Sound Daemon (esd).

OPTIONS

       The following options are supported:

       -s hostname:portContact the esd server on hostname at port.

       -b	       Specify that the output should be in 8-bit format. By default, the output is in 16-bit format.

       -d	       Play  the  sample from file as raw data. The default behavior is to read the data from a sound file (.wav, .au, and so on).
		       If this option is chosen, samplename is the name of a file.

       -e	       Play the sample from the esd cache. If this option is chosen, samplename  is the name of the sample in the cache.

       -h	       Display help text, and exit.

       -m	       Specify that the output should be in mono format. By default, the output is in stereo format.

       -r freq	       Specify that the output rate should be set to freq. By default, the output rate is set to 44.1 kHz.

OPERANDS

       The following operands are supported:

       samplename      The name of the sample to be played.  If the -e option is used, samplename is the esd  cache name. Otherwise, samplename is
		       a filename.

EXAMPLES

       Example 1: Playing a sample from a file

       example% esdsample generic.wav

       Example 2: Playing a sample from the esd cache

       example% esdsample -e esdctl:generic.wav
       (where esdctl:generic.wav is the cache name)

EXIT STATUS

       The following exit values are returned:

       0	Application exited successfully

       >0	Application exited with failure

FILES

       The following files are used by this application:

       /usr/bin/esdsample      Executable for Enlightened Sound Daemon sound sampler.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgnome-audio		   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       esdcat(1), esdmon(1), esdplay(1), esdrec(1), esdctl(1), esd-config(1), libesd(3)

NOTES

       Written by Brian Cameron, Sun Microsystems  Inc., 2003.

SunOS 5.10							    8 Jan 2003							      esdsample(1)