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.SGI < prev    next >
Encoding:
Text File  |  1998-12-07  |  2.7 KB  |  76 lines
  1. NOTE: This document only describes the SGI specific
  2. information you need to know. Read README as well.
  3.  
  4. Documentation for the SGI audio driver of MikMod
  5. ------------------------------------------------
  6. Copyright 1996/97/98 by Stephan Kanthak
  7.  
  8.  
  9. Current version: 0.4, 01/04/1998
  10.  
  11.  
  12. 1. Copyright
  13.  
  14. The SGI audio driver is written by Stephan Kanthak in 1996 and the author
  15. grants to distribute it with the MikMod package under the same restrictions
  16. as the library.
  17.  
  18. 2. Options
  19.  
  20. The SGI audio driver supports two environment variables:
  21.  
  22.     MM_SGI_FRAGSIZE    - sets size of audio buffer of the MikMod library
  23.     MM_SGI_BUFSIZE    - sets size of audio buffer in audio library
  24.  
  25. If you encounter any problems concerning crackles or short stops while
  26. playing, feel free to experiment with the values of these variables. The
  27. default values are 20000 for MM_SGI_FRAGSIZE and 40000 for MM_SGI_BUFSIZE.
  28. Increasing MM_SGI_BUFSIZE might result in nonstop sound on slow machines,
  29. but increases latency of interactive applications. MM_SGI_FRAGSIZE should
  30. be set to about half of MM_SGI_BUFSIZE in most cases and needs to be
  31. increased if you own a very slow SGI.
  32.  
  33. Note that you need to set the variables by setenv (tcsh) or export (bash)!
  34.  
  35.  
  36. 3. Problems
  37.  
  38. - MikMod does not compile on my SGI?
  39.   First check out whether you have the SGI audio library (libaudio) or not.
  40.   If the audio library is missing you should upgrade to IRIX 5.3 or newer
  41.   and you will obtain the media development package automatically with it.
  42.   If you own the audio library check out if it is in the linker path.
  43.   Note that only X-Windows frontends can be compiled on SGI's if you
  44.   do not own the ncurses library (which should be the case for many
  45.   installations).
  46.  
  47. - No sound at all?
  48.   Look at the messages that MikMod prints during startup. Messages from the
  49.   SGI audio driver start with "SGI audio driver:" followed by a statement
  50.   what is going wrong. Send an error report to the author with an almost
  51.   complete machine description and a detailed error description.
  52.  
  53. - Sound is _very_ noisy?
  54.   Change sample size to 16 bits.
  55.  
  56. - Sound crackles or stops temporarily?
  57.   Try to increase the value of the environment variable MM_SGI_FRAGSIZE.
  58.   Default is 20000. Switch to mono mode if necessary.
  59.  
  60. - MikMod applications only react very slowly?
  61.   This is a typical effect on SGI machines because the audio library sets
  62.   up an internal buffer that seems to be quiet large on many installations.
  63.   Try to decrease MM_SGI_BUFSIZE. Default is 40000.
  64.  
  65.  
  66. 4. Known bugs
  67.  
  68. - MIKMOD player crashes heavily (and maybe your winterm, too) when changing
  69.   mixing parameters on-the-fly, i.e. while playing.
  70.  
  71.  
  72. 5. How to contact the author
  73.  
  74. Stephan Kanthak
  75. e-mail: kanthak@i6.informatik.rwth-aachen.de
  76.