[xiph-cvs] cvs commit: vorbis-tools/ogg123 ogg123.1 ogg123.c
Stan Seibert
volsung at xiph.org
Fri Jul 6 15:11:38 PDT 2001
volsung 01/07/06 15:11:38
Modified: ogg123 ogg123.1 ogg123.c
Log:
Patch from Christian Weisgerber <naddy at mips.inka.de> to update the
ogg123 -h output and the man page to match the currently available
devices in libao.
Revision Changes Path
1.7 +271 -248 vorbis-tools/ogg123/ogg123.1
Index: ogg123.1
===================================================================
RCS file: /usr/local/cvsroot/vorbis-tools/ogg123/ogg123.1,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- ogg123.1 2001/06/19 17:26:52 1.6
+++ ogg123.1 2001/07/06 22:11:37 1.7
@@ -1,248 +1,271 @@
-.\" Process this file with
-.\" groff -man -Tascii ogg123.1
-.\"
-.TH ogg123 1 "June 19, 2001" "" "Vorbis Tools"
-
-.SH NAME
-ogg123 \- plays Ogg Vorbis files
-
-.SH SYNOPSIS
-.B ogg123
-[
-.B -vqzVh
-] [
-.B -k seconds
-] [
-.B -d
-.I driver
-[
-.B -o
-.I option:value
-] ]
-.I file
-.B ...
-|
-.I URL
-.B ...
-
-.SH DESCRIPTION
-.B ogg123
-reads Ogg Vorbis audio files and decodes them to the devices specified
-on the command line. By default,
-.B ogg123
-writes to the standard sound device, but output can be sent to any
-number of devices. Files can be read from the file system, or URLs
-can be streamed via HTTP.
-
-.SH OPTIONS
-.IP "-b n, --buffer n"
-Use a buffer of 'n' chunks (4096 bytes)
-.IP "-d device, --device device"
-Specify output device. See
-.B DEVICES
-section for a list of devices. Any number of devices may be specified.
-.IP "-h, --help"
-Show command help.
-.IP "-k n, --skip n"
-Skip the first 'n' seconds
-.IP "-o option:value, --device-option option:value"
-Assigns the option
-.I option
-to
-.I value
-for the preceding device. See
-.B DEVICES
-for a list of valid options for each device.
-.IP "-q, --quiet"
-Quiet mode. No messages are displayed.
-.IP "-V, --version"
-Display version information.
-.IP "-v, --verbose"
-Increase verbosity.
-.IP "-z, --shuffle"
-Play files in pseudo-random order.
-
-.SH DEVICES
-
-.B ogg123
-supports a variety of audio output devices through libao. Only those
-devices supported by the target platform will be compiled in.
-
-.IP null
-Null driver. All audio data is discarded. (Note: Audio data is not
-written to
-.B /dev/null
-!) You could use this driver to test raw decoding speed without
-output overhead.
-
-.IP oss
-Open Sound System driver for Linux and {Net,Free,Open}BSD.
-.RS
-Options:
-.RS
-.IP dsp
-DSP device for soundcard. Defaults to
-.B /dev/dsp.
-.RE
-.RE
-
-.IP alsa
-Advanced Linux Sound Architecture.
-.RS
-Options:
-.RS
-.IP card
-Sound card number. (Default = 0)
-.IP dev
-Device number on the sound card. (Default = 0)
-.IP buf_size
-Override the default buffer size (in bytes).
-.RE
-.RE
-
-.IP esd
-Enlightened Sound Daemon.
-.RS
-Options:
-.RS
-.IP host
-The hostname where esd is running. This can include a port number
-after a colon, as in "whizbang.com:555". (Default = localhost)
-.RE
-.RE
-
-.IP solaris
-Solaris audio driver. Note that this driver has
-.B not
-been tested!
-
-.IP irix
-IRIX audio driver. Note that this driver has
-.B not
-been tested!
-
-.IP wav
-WAV file output. Writes the sound data to disk in uncompressed form.
-If multiple files are played, all of them will be concatenated into
-the same WAV file.
-.RS
-Options:
-.RS
-.IP file
-Sets the output WAV file. (Default = "output.wav")
-.RE
-.RE
-
-.SH EXAMPLES
-
-The
-.B ogg123
-command line is fairly flexible, perhaps confusingly so. Here are
-some sample command lines and an explanation of what they do.
-.PP
-
-Play on the default soundcard:
-.RS
-.B ogg123 test.ogg
-.RE
-.PP
-
-Play using the OSS driver:
-.RS
-.B ogg123 -d oss test.ogg
-.RE
-.PP
-
-Pass the "dsp" option to the OSS driver:
-.RS
-.B ogg123 -d oss -o dsp:/dev/mydsp
-.RE
-.PP
-
-Use the ESD driver
-.RS
-.B ogg123 -d esd test.ogg
-.RE
-.PP
-
-Use the WAV driver with the default output file, "output.wav":
-.RS
-.B ogg123 -d wav test.ogg
-.RE
-.PP
-
-Listen to a file while you write it to a WAV file:
-.RS
-.B ogg123 -d oss -d wav -o file:test.wav test.ogg
-.RE
-.PP
-
-Note that options apply to the device declared to the left:
-.RS
-.B ogg123 -d oss -o dsp:/dev/mydsp -d wav -o file:test2.wav test.ogg
-.RE
-.PP
-
-Stress test your harddrive:
-.RS
-.B ogg123 -d oss -d wav -o file:1.wav -d wav -o file:2.wav -d wav -o file:3.wav -d wav -o file:4.wav -d wav -o file:5.wav test.ogg
-.RE
-.PP
-
-Create an echo effect with esd and a slow computer:
-.RS
-.B ogg123 -d esd -d esd test.ogg
-.RE
-.PP
-
-.SH INTERRUPT
-You can abort
-.B ogg123
-at any time by pressing Ctrl-C. If you are playing multiple
-files, this will stop the current file and begin playing the
-next one. If you want to abort playing immediately instead
-of skipping to the next file, press Ctrl-C within the first
-second of the playback of a new file.
-.P
-Note that the result of pressing Ctrl-C might not be audible
-immediately, due to audio data buffering in the audio device.
-This delay is system dependent, but it is usually not more
-than one or two seconds.
-
-
-.SH FILES
-
-.TP
-/etc/ogg123rc
-Can be used to set the default output device for
-.B ogg123.
-See the included file
-.B ogg123rc-example
-for an example.
-
-.TP
-~/.ogg123rc
-Per-user config file to override the system wide output device settings.
-.PP
-
-.SH BUGS
-
-The WAV driver does not interpret the file "-" as stdout. Note that
-there are issues with streaming WAV-format audio, so there is no way
-to fix this properly. Use the raw output driver if you need to use
-ogg123 in a pipe.
-
-.SH AUTHORS
-
-.TP
-Program Authors:
-.br
-Kenneth Arnold <kcarnold at yahoo.com>
-.br
-Stan Seibert <indigo at aztec.asu.edu>
-.br
-
-.TP
-Manpage Author:
-.br
-Stan Seibert <indigo at aztec.asu.edu>
+.\" Process this file with
+.\" groff -man -Tascii ogg123.1
+.\"
+.TH ogg123 1 "June 19, 2001" "" "Vorbis Tools"
+
+.SH NAME
+ogg123 \- plays Ogg Vorbis files
+
+.SH SYNOPSIS
+.B ogg123
+[
+.B -vqzVh
+] [
+.B -k seconds
+] [
+.B -d
+.I driver
+[
+.B -o
+.I option:value
+] ]
+.I file
+.B ...
+|
+.I URL
+.B ...
+
+.SH DESCRIPTION
+.B ogg123
+reads Ogg Vorbis audio files and decodes them to the devices specified
+on the command line. By default,
+.B ogg123
+writes to the standard sound device, but output can be sent to any
+number of devices. Files can be read from the file system, or URLs
+can be streamed via HTTP.
+
+.SH OPTIONS
+.IP "-b n, --buffer n"
+Use a buffer of 'n' chunks (4096 bytes)
+.IP "-d device, --device device"
+Specify output device. See
+.B DEVICES
+section for a list of devices. Any number of devices may be specified.
+.IP "-h, --help"
+Show command help.
+.IP "-k n, --skip n"
+Skip the first 'n' seconds
+.IP "-o option:value, --device-option option:value"
+Assigns the option
+.I option
+to
+.I value
+for the preceding device. See
+.B DEVICES
+for a list of valid options for each device.
+.IP "-q, --quiet"
+Quiet mode. No messages are displayed.
+.IP "-V, --version"
+Display version information.
+.IP "-v, --verbose"
+Increase verbosity.
+.IP "-z, --shuffle"
+Play files in pseudo-random order.
+
+.SH DEVICES
+
+.B ogg123
+supports a variety of audio output devices through libao. Only those
+devices supported by the target platform will be compiled in.
+
+.IP null
+Null driver. All audio data is discarded. (Note: Audio data is not
+written to
+.B /dev/null
+!) You could use this driver to test raw decoding speed without
+output overhead.
+
+.IP oss
+Open Sound System driver for Linux and FreeBSD.
+.RS
+Options:
+.RS
+.IP dsp
+DSP device for soundcard. Defaults to
+.B /dev/dsp.
+.RE
+.RE
+
+.IP sun
+Sun Audio driver for NetBSD, OpenBSD, and Solaris.
+.RS
+Options:
+.RS
+.IP dev
+Audio device for soundcard. Defaults to
+.B /dev/audio.
+.RE
+.RE
+
+.IP alsa
+Advanced Linux Sound Architecture.
+.RS
+Options:
+.RS
+.IP card
+Sound card number. (Default = 0)
+.IP dev
+Device number on the sound card. (Default = 0)
+.IP buf_size
+Override the default buffer size (in bytes).
+.RE
+.RE
+
+.IP irix
+IRIX audio driver. Note that this driver has
+.B not
+been tested!
+
+.IP arts
+aRts Sound Daemon.
+
+.IP esd
+Enlightened Sound Daemon.
+.RS
+Options:
+.RS
+.IP host
+The hostname where esd is running. This can include a port number
+after a colon, as in "whizbang.com:555". (Default = localhost)
+.RE
+.RE
+
+.IP raw
+Raw sample output. Writes raw audio samples to a file.
+.RS
+Options:
+.RS
+.IP file
+Sets the output file. (Default = "output.raw")
+.RE
+.RS
+.IP byteorder
+Choose big endian, little endian, or native byte order. (Default = "native")
+.RE
+.RE
+
+.IP wav
+WAV file output. Writes the sound data to disk in uncompressed form.
+If multiple files are played, all of them will be concatenated into
+the same WAV file.
+.RS
+Options:
+.RS
+.IP file
+Sets the output WAV file. (Default = "output.wav")
+.RE
+.RE
+
+.SH EXAMPLES
+
+The
+.B ogg123
+command line is fairly flexible, perhaps confusingly so. Here are
+some sample command lines and an explanation of what they do.
+.PP
+
+Play on the default soundcard:
+.RS
+.B ogg123 test.ogg
+.RE
+.PP
+
+Play using the OSS driver:
+.RS
+.B ogg123 -d oss test.ogg
+.RE
+.PP
+
+Pass the "dsp" option to the OSS driver:
+.RS
+.B ogg123 -d oss -o dsp:/dev/mydsp
+.RE
+.PP
+
+Use the ESD driver
+.RS
+.B ogg123 -d esd test.ogg
+.RE
+.PP
+
+Use the WAV driver with the default output file, "output.wav":
+.RS
+.B ogg123 -d wav test.ogg
+.RE
+.PP
+
+Listen to a file while you write it to a WAV file:
+.RS
+.B ogg123 -d oss -d wav -o file:test.wav test.ogg
+.RE
+.PP
+
+Note that options apply to the device declared to the left:
+.RS
+.B ogg123 -d oss -o dsp:/dev/mydsp -d wav -o file:test2.wav test.ogg
+.RE
+.PP
+
+Stress test your harddrive:
+.RS
+.B ogg123 -d oss -d wav -o file:1.wav -d wav -o file:2.wav -d wav -o file:3.wav -d wav -o file:4.wav -d wav -o file:5.wav test.ogg
+.RE
+.PP
+
+Create an echo effect with esd and a slow computer:
+.RS
+.B ogg123 -d esd -d esd test.ogg
+.RE
+.PP
+
+.SH INTERRUPT
+You can abort
+.B ogg123
+at any time by pressing Ctrl-C. If you are playing multiple
+files, this will stop the current file and begin playing the
+next one. If you want to abort playing immediately instead
+of skipping to the next file, press Ctrl-C within the first
+second of the playback of a new file.
+.P
+Note that the result of pressing Ctrl-C might not be audible
+immediately, due to audio data buffering in the audio device.
+This delay is system dependent, but it is usually not more
+than one or two seconds.
+
+
+.SH FILES
+
+.TP
+/etc/ogg123rc
+Can be used to set the default output device for
+.B ogg123.
+See the included file
+.B ogg123rc-example
+for an example.
+
+.TP
+~/.ogg123rc
+Per-user config file to override the system wide output device settings.
+.PP
+
+.SH BUGS
+
+The WAV driver does not interpret the file "-" as stdout. Note that
+there are issues with streaming WAV-format audio, so there is no way
+to fix this properly. Use the raw output driver if you need to use
+ogg123 in a pipe.
+
+.SH AUTHORS
+
+.TP
+Program Authors:
+.br
+Kenneth Arnold <kcarnold at yahoo.com>
+.br
+Stan Seibert <indigo at aztec.asu.edu>
+.br
+
+.TP
+Manpage Author:
+.br
+Stan Seibert <indigo at aztec.asu.edu>
1.40 +5 -3 vorbis-tools/ogg123/ogg123.c
Index: ogg123.c
===================================================================
RCS file: /usr/local/cvsroot/vorbis-tools/ogg123/ogg123.c,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -r1.39 -r1.40
--- ogg123.c 2001/06/19 19:42:35 1.39
+++ ogg123.c 2001/07/06 22:11:37 1.40
@@ -14,7 +14,7 @@
* *
********************************************************************
- last mod: $Id: ogg123.c,v 1.39 2001/06/19 19:42:35 kcarnold Exp $
+ last mod: $Id: ogg123.c,v 1.40 2001/07/06 22:11:37 volsung Exp $
********************************************************************/
@@ -86,8 +86,10 @@
" -V, --version display Ogg123 version\n"
" -d, --device=d uses 'd' as an output device\n"
" Possible devices are (some may not be compiled):\n"
- " null (output nothing), oss (for Linux and *BSD),\n"
- " irix, solaris, wav (write to a .WAV file)\n"
+ " null (output nothing), oss (for Linux and FreeBSD),\n"
+ " alsa (for Linux), sun (for NetBSD, OpenBSD, Solaris),\n"
+ " irix, arts (aRts sound daemon), esd (ESounD daemon),\n"
+ " raw (write to a file), wav (write to a .WAV file)\n"
" -k n, --skip n Skip the first 'n' seconds\n"
" -o, --device-option=k:v passes special option k with value\n"
" v to previously specified device (with -d). See\n"
--- >8 ----
List archives: http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'cvs-request at xiph.org'
containing only the word 'unsubscribe' in the body. No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.
More information about the commits
mailing list