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.SUN < prev    next >
Encoding:
Text File  |  1998-12-07  |  3.3 KB  |  84 lines

  1. NOTE: This document only describes the Sun/Solaris specific
  2. information you need to know. Read README as well.
  3.  
  4. Using MikMod with under SunOS, Solaris, NetBSD or OpenBSD
  5. ---------------------------------------------------------
  6.  
  7. 0. Description
  8.  
  9.   The above mentioned Unices use the same interface to the audio device. The
  10.   MikMod driver for this interface is the Sun driver. It was coded by Valtteri
  11.   Vuorikoski <vuori@sci.fi> and updated to MikMod 3 by Tor Norbye
  12.   <tor@cs.stanford.edu>, and has been modified to work under NetBSD and OpenBSD
  13.   by the current maintainer.
  14.  
  15. 1. General notes
  16.  
  17.   This driver works with old sound hardware using 8 KHz mono ulaw, and with
  18.   modern hardware using pcm mono or stereo at any frequency. If your settings
  19.   aren't supported by the audio device, sound initialization will fail. Refer
  20.   to the audio(7) man page for more details on your audio hardware and its
  21.   capabilities.
  22.  
  23.   To force 8KHz mono ulaw sound, use the following options :
  24.     mikmod -8 -m -f8000
  25.  
  26. 2. Sun specific notes
  27.  
  28.   On Sun workstations, you might be interested in using the --enable-headphone
  29.   switch to configure to force output on the headphones, since plugging the
  30.   headphones is not enough.
  31.  
  32.   If you can't get MikMod to work with your hardware, you can use the raw disk
  33.   writer first : 
  34.     mikmod -d2 -f8000 -m -8
  35.   (assuming the raw driver is driver number 2, get its number from 'mikmod -l'
  36.   output) and send the music.raw file to /dev/audio with sox, with the following
  37.   command line :
  38.     sox -t raw -c 1 -r 8000 -u -b music.raw -t raw -U -r 8000 -c 1 -b /dev/audio
  39.  
  40.   Or if you played in 16 bit stereo, you can convert the file to a .au file :
  41.     audioconvert -o music.au -f sun \
  42.                -i rate=44.1k,channels=stereo,encoding=linear16 music.raw
  43.   and play the file :
  44.     audioplay -p headphone -v 10 music.au
  45.  
  46. 3. NetBSD specific notes
  47.  
  48.   Although the code should work fine under NetBSD, I don't know of any MikMod
  49.   user running NetBSD. If you're running NetBSD, please tell me if MikMod works
  50.   correctly or not !
  51.  
  52. 4. OpenBSD specific notes
  53.  
  54.   The pause does not work correctly under OpenBSD, and perhaps NetBSD as well.
  55.   Fixing this requires in-depth changes in MikMod, but hopefully this will be
  56.   fixed in the next release. I'm also waiting for OpenBSD 2.4...
  57.  
  58. 5. Legal notes
  59.  
  60.   Parts of the Sun driver have their roots in the SOX package by Lance Norskog
  61.   and Jef Poskanzer, which include the following license :
  62.  
  63.   Sound Tools may be used for any purpose.  Source distributions must include
  64.   the copyright notices.  Binary distributions must include acknowledgements
  65.   to the creators.
  66.   The files I wrote are copyright Lance Norskog.
  67.   The contributed files are copyright by their respective authors.
  68.  
  69.   ** Copyright (C) 1989 by Jef Poskanzer.
  70.   **
  71.   ** Permission to use, copy, modify, and distribute this software and its
  72.   ** documentation for any purpose and without fee is hereby granted, provided
  73.   ** that the above copyright notice appear in all copies and that both that
  74.   ** copyright notice and this permission notice appear in supporting
  75.   ** documentation.  This software is provided "as is" without express or
  76.   ** implied warranty.
  77.  
  78.   Fix to load_xm.c to play correctly on big-endian machines by
  79.   Sebastiaan A. Megens <samegens@xs4all.nl>.
  80.  
  81.   Tighter integration with the rest of the Unix mikmod package by
  82.   Steve McIntyre <stevem@chiark.greenend.org.uk>.
  83.  
  84.