home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1999 February / PCO_0299.ISO / filesbbs / linux / mikmod-3.000 / mikmod-3 / mikmod-3.1.2 / README.OS2 < prev    next >
Encoding:
Text File  |  1998-12-07  |  2.5 KB  |  68 lines
  1.  
  2.                               //============\\
  3.                               ||            ||
  4.                               ||  MikMod/2  ||
  5.                               ||            ||
  6.                               \\============//
  7.  
  8.                                 version 3.1.2
  9.  
  10.  
  11. This file only covers the OS/2 specific bits of MikMod.
  12. Be sure to read the 'README' file as well.
  13.  
  14.  
  15. Building MikMod under OS/2
  16. --------------------------
  17.  
  18. Currently, MikMod can be build under OS/2 only with the emx compiler
  19. or the Watcom compiler. You'll need the MMPM/2 toolkit (included all
  20. the Warp toolkits) to compile the MMPM/2 driver. The Warp 4 toolkit is
  21. required if you want to build the DART driver, too.
  22.  
  23. In this directory, run
  24.  
  25.   configure
  26.  
  27. You will then be asked some questions.
  28. First, you'll have to choose your compiler. 
  29.  
  30. Then, you will be asked if you want to build a debug version ; this
  31. option is mainly intended for the MikMod developers, so you should
  32. answer "N" here.
  33.  
  34. The next step is the driver selection. You'll be asked if you want the
  35. MMPM/2 and DART drivers. Since DART is not available on OS/2 older than
  36. Warp 4, the MMPM/2 driver is recommended for pre-Warp 4 systems.
  37. Otherwise, the DART driver is preferable, but you can include both to
  38. be sure your MikMod binary will work on every 32 bit version of OS/2.
  39.  
  40. After that, you will be prompted for various MikMod options, well, only
  41. one for now... the high-quality mixer. The high-quality mixer works
  42. hard to prevent clicks and other spurious noise in output. However,
  43. doing this needs a lot of CPU power. On my main development machine, a
  44. PC with a 200 MHz processor running a slow Unix flavour, the
  45. high-quality mixer isn't fast enough to mix at 44100 Hz, and can't mix
  46. more than 16 channels real-time at 22050 Hz. Your mileage may vary, but
  47. if you don't have a very fast machine or are using a output-to-disk
  48. driver, you won't like this option.  
  49.  
  50. After the configuration has finished and the Makefiles are created, just
  51. run
  52.  
  53.   make
  54.  
  55. and you'll get your customized MikMod binary in the mikmod directory.
  56. If the build fails, I'd like to hear from you to correct the problem.
  57.  
  58.  
  59. Using MikMod under OS/2
  60. -----------------------
  61.  
  62. Run MikMod without parameters to get the available options.
  63. Once you're in the player, if you haven't choosed terse mode (a la
  64. MikMod 2), pressing the H key will give you an help screen with the list
  65. of the keys you can use. I hope it's understandable.
  66. Note that if you're using the DART driver, there will be a small delay before
  67. commands are processed.
  68.