home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / MULTIMED / MPG123V3 / mpg123.txt < prev    next >
Text File  |  1997-05-05  |  4KB  |  72 lines
  1. After receiving a few comments that the commandline flags are confusing, and
  2. realizing that trying to describe them with half a line is difficult at best,
  3. I decided to type this up to expand upon them.
  4.  
  5. Flag
  6. ----
  7.     -v      Verbose output.  Using this flag will make sure that you
  8.             get to see every piece of output the program allows, including
  9.             header information and a running frame counter.
  10.     -q      Quiet.  Supresses almost all output.
  11.     -t      Testmode.  Used to test playing without the presence of an audio
  12.             device.
  13.     -s      Write to stdout.  stdout will default to the screen, but can be
  14.             redirected with the ">" parameter.
  15.     -k n    Skip the first "n" frames.  "n" defaults to 0.
  16.     -n n    Decode only the first "n" frames.  "n" defaults to all frames.
  17.     -c      Check range violations.
  18.     -y      Turn off resync attempts.  By default, mpg123 attempts to scan
  19.             ahead for valid header information when it reads an incorrect
  20.             header.  Turning this off will cause the program to stop instead.
  21.     -b n    Assign "n" 16k buffer blocks.  The minimum for "n" is 16 (or a
  22.             256k buffer).  The maximum is 4096 (or a 64M buffer).  The default
  23.             is 128 (or a 2048K buffer).
  24.     -f n    Change scalefactor to "n".  "n" defaults to 32768
  25.     -r n    Override samplerate to "n".  "n" must be a valid sampling rate for
  26.             your soundcard (check your documentation).
  27.     -g n    Set audio hardware output gain.     *** Currently unsupported ***
  28.     -os     Output to built-in speaker.         *** Currently unsupported ***
  29.     -oh     Output to headphones.               *** Currently unsupported ***
  30.     -ol     Output to line-out connector.       *** Currently unsupported ***
  31.     -a d    Set audio device.                   *** Currently unsupported ***
  32.     -2      Downsample 1:2 (22KHz).  Adjusts the playing of a song to output
  33.             at 22KHz, saving some CPU time.
  34.     -4      Downsample 1:4 (11KHz).  Adjusts the playing of a song to output
  35.             at 11KHz.  Saves more CPU time, but song quality is noticably
  36.             poorer.
  37.     -d n    Play every "n"th frame only.  Setting this to 2, for example, will
  38.             cause every 2nd frame to be played.
  39.     -h n    Play every frame "n" times.  Setting this to 2 will cause every
  40.             frame to be played twice.
  41.     -0      Decode channel 0 (left) only.  Will only decode the left channel,
  42.             although output will still be stereo.  Decreases CPU usage.
  43.     -1      Decode channel 1 (right) only.  Will only decode the right channel,
  44.             although output will still be stereo.  Decreases CPU usage.
  45.     -m      Mix both channels (mono).  Mixes the output of both channels
  46.             together, then outputs in stereo.  Significant CPU time is saved.
  47.     -8      Force 8 bit output.  Allows playing on soundcards that do not
  48.             support 16 bit playback.  No significant gains for 16 bit sound
  49.             card owners.
  50.     -e      Recurse subdirectories.  This is best used with wildcard support.
  51.             Will search the current directory and any subdirectories for
  52.             the filename provided.
  53.     -@ f    Read filenames from file "f".  File "f" should list the files
  54.             on separate lines.  Spaces in the filenames is acceptable.
  55.     <file>  Wildcards are supported, as are filenames with spaces.
  56.  
  57. Examples
  58. --------
  59.  
  60.     "mpg123 -m -2 -e *.mp3"
  61.         Mixes both channels together, and decreases output to 22KHz, greatly
  62.         decreasing the required CPU time.  Searches the current and any
  63.         subdirectories for any files matching *.mp3, and creates an in
  64.         memory playlist of them.
  65.     "mpg123 -v -8 -@ playlist"
  66.         Gathers the playlist from file "playlist".  Uses 8 bit playback,
  67.         and does verbose reporting on the individual songs.
  68.     "mpg123 -b 64 -q -y file.mp3"
  69.         Creates 64 x 16k buffers (1024k, or 1 meg), prevents output of any
  70.         information, plays file.mp3, and forces exit if an invalid header
  71.         is read.
  72.