home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 13 / AACD13.ISO / AACD / Sound / LAME / src / INSTALL < prev    next >
Text File  |  2000-08-06  |  4KB  |  124 lines
  1. LAME 3.xx    7/00 Mark Taylor (http://www.sulaco.org/mp3)
  2.  
  3.  
  4. =======================================================================
  5. Compile time options
  6. =======================================================================
  7. There are serveral targets which can be built from this
  8. source code:
  9.  
  10. lame/lame.exe   The command line encoder
  11. lame_enc.dll    a Windows DLL used by many GUIs which support lame.
  12. libmp3lame.a    the *NIX style encoding library
  13.  
  14.  
  15. The following compile time options can be used.  For libmp3lame.a
  16. and lame_enc.dll, none are required.  See Makefile for details.
  17.  
  18.  
  19. #define HAVEMPGLIB   to compile in mpglib's mp3 *decoding* capibility
  20. #define HAVEVORBIS   to compile in Vorbis decoding and encoding capibility
  21.                      (you need libvorbis already built)
  22.  
  23. Exactly one of these is required for the command line encoder:
  24. #define LIBSNDFILE   to use Erik de Castro Lopo's libsndfile
  25. #define LAMESNDFILE  to use LAME's minimial internal sndfile I/O
  26.  
  27. Other options for the command line encoder:
  28. #define HAVEGTK      to compile in the LAME MP3 frame analyzer
  29. #define BRHIST       to allow the optional display of the VBR historgram
  30. #define NOTERMCAP    to try and emulate termcap/ncurses directly (ANSI)
  31.                      only needed if BRHIST is used.  Works under Amiga
  32.                      and Win32.  (but not dos)
  33.  
  34.  
  35.  
  36.  
  37. =======================================================================
  38. Building the software on Windows:
  39. =======================================================================
  40. There are MSVC project files, and a Makefile.MSVC included
  41. with the project.  For production use, be sure to compile
  42. a "release" version and compile with the "maximum speed" compile
  43. option, and #define NDEBUG.   
  44.  
  45. Note that MSVC "professional" claims to produce faster executables
  46. then MSVC "standard".  It is possible to compile the GTK frame
  47. analyzer under windows, see README.WINGTK
  48.  
  49. LAME can be compiled with various Windows MSDOS ports (all free)
  50. of GCC (DJGPP, Mingw32).  See README.DJGPP.  
  51.  
  52. For Mingw32, you should now be able to use the Unix Makefile that
  53. comes with LAME.  Try: "make NOUNIXCMD=YES UNAME=MSDOS"
  54. You may need to remove these lines from brhist.c:
  55.  
  56. #ifdef _WIN32
  57. COORD Pos;
  58. HANDLE CH;
  59. CONSOLE_SCREEN_BUFFER_INFO CSBI;
  60. #endif
  61.  
  62.  
  63. The Windows Borland C compiler is now free!  Borland will also
  64. compile LAME, although a new makefile is needed.  If you get
  65. this to work, please write a README.BORLAND which I can include
  66. with LAME.
  67.  
  68.  
  69.  
  70.  
  71.  
  72. =======================================================================
  73. Building the software on *NIX platforms:
  74. =======================================================================
  75. If you are reading this, you have already applied the patch to the
  76. dist10 ISO demonstration source (or downloaded a full source
  77. distrubtion).  If you do not have GTK 1.1.16 or higher, or do not want
  78. the graphical frame analyzer (it uses a lot of memory), edit the
  79. Makefile and dont define GTK and GTKLIBS.  If you have trouble with
  80. libncurses/libtermcap, you can also disable that in the Makefile.
  81.  
  82. Now just type:
  83.  
  84. % make
  85.  
  86. (for non-GNU systems: use gnumake or gmake instead of make)
  87.  
  88. If it doesn't work, figure out why and send me the fix!  
  89. If you are using a newer version of EGCS, check the Makefile.
  90. There are some flags which may improve performance.
  91.  
  92. LAME has built in support for 16bit raw pcm, aiff and wav
  93. formats.  If you want to encode from other sound formats, you can
  94. compile LAME to use Erik de Castro Lopo's libsndfile.  To use
  95. libsndfile in LAME:
  96.  
  97.   1. install libsndfile (see http://www.zip.com.au/~erikd/libsndfile/).  
  98.   2. set SNDLIB and LIBSNDFILE as shown in the LAME Makefile.  
  99.   3. make clean ; make
  100.  
  101. Thanks to Albert Faber for adding the libsndfile support!
  102.  
  103. LAME can also be compiled into a BladeEnc compatiable MS Windows .dll 
  104. file.  See the Dll/ directory for details. 
  105.  
  106.  
  107.  
  108. =======================================================================
  109. To encode:
  110. =======================================================================
  111. see the file "USAGE" for some usage guidlines.
  112.  
  113.  
  114.  
  115. =======================================================================
  116. Portability
  117. =======================================================================
  118. LAME 3.x has been run on every modern OS.  see the Makefile.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.