16/adplug/adplug/README

   1 AdPlug - A free AdLib sound player library
   2 Copyright (C) 1999 - 2010 Simon Peter, et al.
   3
   4 Website: http://adplug.sourceforge.net/
   5
   6 Description:
   7 ------------
   8 AdPlug is a free, multi-platform, hardware independent AdLib sound
   9 player library, mainly written in C++. AdPlug plays sound data,
  10 originally created for the AdLib (OPL2/3) audio board, on top of an
  11 OPL2/3 emulator or by using the real hardware. No OPL2/3 chips are
  12 required for playback.
  13
  14 Supported platforms:
  15 --------------------
  16 AdPlug currently is tested to compile and run well on the following
  17 platforms and compilers:
  18
  19 Platform                Operating System        Compiler
  20 --------                ----------------        --------
  21 IA32 - x86              Windows XP              MinGW 3.4
  22                         MS-DOS 6.22             DJGPP 4.0
  23                         Linux 2.6               GCC 4.1
  24 x86_64                  Linux 2.6               GCC 4.4.2
  25
  26 This list only incorporates platforms on which this release of AdPlug has
  27 been tested successfully. This and/or earlier versions of AdPlug may and did
  28 run on a variety of other platforms as well. It just means they haven't been
  29 explicitly tested for this release.
  30
  31 The library builds as dynamic and/or static link library, depending on
  32 the facilities provided by the host OS. These are autodetected.
  33
  34 Prerequisites:
  35 --------------
  36 AdPlug depends upon the following libraries:
  37
  38 Library:        Version:
  39 --------        --------
  40 libbinio        >= 1.4
  41
  42 libbinio can be obtained from http://libbinio.sourceforge.net/.
  43
  44 Installation:
  45 -------------
  46 Please refer to the INSTALL file for installation instructions.
  47
  48 CVS:
  49 ----
  50 If you checked out from CVS, please first run:
  51
  52 autoreconf --install
  53
  54 to generate the build cruft and get the configure script. Oh, and did i
  55 mention you need recent versions of autoconf, automake and libtool?
  56
  57 When building a CVS version, always supply the --enable-maintainer-mode
  58 option to the configure script!
  59
  60 Debugging AdPlug:
  61 -----------------
  62 If you feel you have to debug AdPlug, you can compile it with debug logging
  63 support. This is disabled by default. To enable it, you have to define the
  64 DEBUG preprocessor macro. This is done by passing the '--enable-debug'
  65 commandline option to the 'configure' script to enable debugging.
  66
  67 AdPlug logs to stderr by default. The output can be redirected anytime to a
  68 user specified logfile. This is done by using the 'CAdPlug::debug_output'
  69 method of the 'CAdPlug' class.
  70
  71 The emulator license issue:
  72 ---------------------------
  73 AdPlug uses MAME's fmopl OPL2 emulator. While this official distribution
  74 includes an old LGPL'd version of the emulator, which was developed by
  75 Tatsuyuki Satoh alone, who relicensed this version under the LGPL, there is
  76 a patch available at:
  77
  78 http://www.informatik.uni-oldenburg.de/~dyna/adplug/
  79
  80 that replaces the old version by the latest version from the MAME source
  81 distribution. The new version features improved emulation quality, but is
  82 licensed under the MAME license, which restricts commercial redistribution.
  83
  84 The same goes for the OPL3 emulator, which requires the new version of
  85 the OPL2 emulator to build.
  86
  87         - Simon Peter <dn.tlp@gmx.net>