
  Contents of this directory:
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Lame_388b1.zip      -  LAME for RISC OS.
                           StrongARM optimised binary.

  Lame_388b1_FE.zip   -  LAME for RISC OS.
                           ARM7500FE optimised binary.

  LameSrc.zip         -  Source code for RISC OS LAME.
                           The original source is available
                             from: <http://www.mp3dev.org>



  What LAME is:
  ~~~~~~~~~~~~~

  LAME is a command-line program which encodes digital audio into
  the lossy compression format known as "mp3".  See the
  documentation for more details.



  Installation:
  ~~~~~~~~~~~~~

  Just copy the LAME binary into your library directory.  This is
  usually: !Boot.library.
  Also Ensure your 'Next' slot in the task manager is above 1400K.



  Requirements:
  ~~~~~~~~~~~~~

  LAME needs at least 1.2MB of memory to run.
  The ARM7500FE version is intended for Riscstations and the
  StrongARM binary is for StrongARM RiscPCs.  The StrongARM
  version will not work on ARM 710 and older, but it would be
  pretty useless on such a slow machine anyway.



  Other recommended software:
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Useful software to use in conjunction with LAME:

  - MP3Enc - by Justin Fletcher -
        Desktop front-end for various mp3 encoders.
          Supports LAME.

  - AMPlayer - by Thomas Olsson, Robin Watts and Justin Fletcher -
        A very nice, fully featured mp3 player.

  - SoundCon - by Rick Hudson -
        Sound sample conversion utility which might help with audio
          formats commonly found on RISC OS.

  - SuperFPE by myself -
        Speeds up emulation of floating point instructions a bit.
          (does not speed up recent versions of LAME much).



  Known bugs/problems with RISC OS LAME:
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - When specifying an ID3v1 tag in VBR mode, the Xing VBR tag
    always seems to be omitted.

  - The resampling code gives wrong results when compiled with
    -msoft-float because it's evil... but the output sounds Ok...
    Solution: If you must use resampling and you're paranoid about
    the quality, resample with with a seperate utility eg: !SoundCon.
    (PS: This problem does not affect the ARM7500FE version of LAME)


  Report any additional bugs to <mech@toth.org.uk> if you like.



  Useful LAME CLI usage examples:
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  - To encode raw CD data as a low quality mp3 (no psy-model)
    at about 75% the speed of Shine (but slightly more accurately):
      "lame -b 128 -r -m s -q 9 <infile> <outfile>"

  - To encode raw CD data as a variable bitrate mp3 at
    maximum quality with joined stereo and error protection:
      "lame -v -V 0 -q 0 -r -m j -p <infile> <outfile>"
        (WARNING: Slooooow)

  - To decode an mp3 and convert to a WAV file:
      "lame --mp3input --decode <infile> <outfile>"

  - Ultra-fast, ultra-low-quality mono encoding:
      "lame -b 32 -r -m m -a -q 9 --resample 44100 --disptime 10 <infile> <outfile>"

  - For more information read the docs or type:
      "lame --longhelp" at the command line



  Contacting me:
  ~~~~~~~~~~~~~~

  My email address is:  mech@toth.org.uk  and I may even reply if I
  notice I have new mail.
