README
上传用户:wstnjxml
上传日期:2014-04-03
资源大小:7248k
文件大小:5k
源码类别:

Windows CE

开发平台:

C/C++

  1.   Hello folks !
  2. This is libmikmod, version 3.2.0-beta1, a portable sound library for DOS.
  3. DOS support is new in this version, your comments and critics are welcome.
  4. >> BETA WARNING
  5. ---------------
  6. This is a *beta* version of libmikmod. Although it should work fine on
  7. almost all systems, there are likely a few last-minute errors or typos
  8. in the source, and some parts have not received enough hours of testing yet.
  9. Also, please note that all features planned for the final 3.2.0 release are not
  10. available yet. Some structures or functions may change. This release is mainly
  11. intended to the libmikmod developers to share a common base for adding new
  12. features...
  13. The library programming documentation (in docs/) is mostly up-to-date... It
  14. lacks the Player_QueryVoices documentation, though.
  15. If you're not scared, then you can proceed and enjoy fewer bugs than in the
  16. previous version (-;
  17. >> BUILDING LIBMIKMOD
  18. ---------------------
  19. - If you're not building libmikmod for DOS, then you're lost in the sources.
  20.   Go up one directory, and read the main README file.
  21. This port has been designed to work only with DJGPP compiler. However, it
  22. should not be too complex to make it compile with any other compiler. If you
  23. manage to make libmikmod compile and work with another compiler, we'd like to
  24. hear from you. You'll likely have to write an appropiate makefile, or build
  25. things manually ...
  26. If you have all proper tools installed, just type
  27. make -fMakefile.dj
  28. There is a catch if you have some PC-like GREP (i.e. Borland GREP) somewhere on
  29. your path before actual GNU grep... you can check this by just typing "grep".
  30. GNU grep should output:
  31. Usage: grep [OPTION]... PATTERN [FILE]...
  32. Try `grep --help' for more information.
  33. If you see something other, place your djgpp/bin path earlier in PATH list.
  34. After this the build process should complete painlessly.
  35. To make your library ready to use, copy the files 'libmikmod.a' and
  36. 'include/mikmod.h' to your '%DJGPP%/lib' and '%DJGPP%/include' directories
  37. respectively.
  38. HTML documentation of the library, for programmers, is located in the doc
  39. directory.
  40. >> SUPPORTED SOUNDCARDS
  41. -----------------------
  42. Currently three brands of sound cards are supported under DOS:
  43. - Gravis Ultrasound and compatibles. Not tested with Interwave cards. If
  44.   somebody has one and can debug the code under Interwave, please drop us a note
  45.   (see email at bottom).
  46. - SoundBlaster and compatibles. There is only one driver that supports all
  47.   flavours of SoundBlasters:
  48. + SB original (8-bit mono, 22KHz)
  49. + SB 2.0 (DMA autoinit mode -> less clicks, 44KHz 8-bit mono).
  50. + SB Pro (8-bit 22KHz stereo, 8-bit 44KHz mono)
  51. + SB 16+ (8- and 16-bit stereo, up to 44Khz both)
  52.   Note that SB16 should cover AWE32/64 as well... however, the code for SB16
  53.   has not been tested (although there is little SB16-specific code, but
  54.   anyway...). If someone can test/debug it, please notify us (or at least
  55.   report what doesn't work).
  56. - Windows Sound System and compatibles. Most today SoundBlaster clones
  57.   (including the CS4236B card used for testing) emulates (in hardware) WSS.
  58.   That's because Creative Labs copyrighted the SB16 interface and thus
  59.   clonemakers cannot do similar hardware without violating their rights, so
  60.   most of them only emulate SB Pro (see above).
  61.   WSS supports up to 44KHz 16-bit stereo. The following playback rates (in both
  62.   8- and 16-bit) are supported: 5510, 6620, 8000, 9600, 11025, 16000, 18900,
  63.   22050, 27420, 32000, 33075, 37800, 44100 and 48000 Hz.
  64. >> THANKS
  65. ---------
  66. We would like to thank everyone who contributed to libmikmod. Their names
  67. are in the AUTHORS file for the significative contributions, but some other
  68. names can be found in the NEWS file. Thanks a lot ! Keeping libmikmod alive
  69. wouldn't be much fun without you.
  70. >> LICENSE
  71. ----------
  72. The libmikmod sound library is covered by the GNU Library General Public
  73. License as published by the Free Software Fundation (you'll find it in the
  74. file COPYING.LIB) ; either version 2 of the licence, or (at your option)
  75. any later version.
  76. The GNU Lesser General Public License, version 2.1, in file COPYING.LESSER, can
  77. be considered as a later version of the LGPL, and is strongly recommended for
  78. people who will embed libmikmod in their application as a shared library.
  79. >> CONTACT AND DOWNLOAD INFO
  80. ----------------------------
  81. * email:
  82.   Please send all your libmikmod related e-mail to the maintainer, Raphael
  83.   Assenat, at:
  84.   mikmod@raphnet.net
  85.   Things related to the DOS port should also be forwarded to the DOS
  86.   ``portmaster'', Andrew Zabolotny, at:
  87.   bit@eltech.ru
  88.   There's a mailing list for discussing the development of libmikmod (new
  89.   features, bugs, ideas...). Look for more information on the web site.
  90. * web:
  91.   libmikmod home page is located at:
  92.     http://mikmod.raphnet.net
  93. >> LAST NOTES
  94. -------------
  95. We hope you'll enjoy using this version of libmikmod as well as we enjoyed
  96. debugging and improving it.
  97. -- Miodrag ("Miod") Vallat, 10/19/1999
  98.    miodrag@mikmod.darkorb.net
  99.    Andrew Zabolotny
  100.    bit@eltech.ru