Debian Codegraph @

dos/README

raw
1 Hello folks !
2
3
4 This is libmikmod, version 3.3.13, a portable sound library for DOS.
5 Comments & feedback are welcome.
6
7
8 >> BUILDING LIBMIKMOD
9 ---------------------
10
11 - If you're not building libmikmod for DOS, then you're lost in the sources.
12 Go up one directory, and read the main README file.
13
14 This port has been designed to work only with DJGPP compiler. However, it
15 should not be too complex to make it compile with any other compiler. If you
16 manage to make libmikmod compile and work with another compiler, we'd like to
17 hear from you. You'll likely have to write an appropiate makefile, or build
18 things manually ...
19
20 If you have all proper tools installed, just type
21
22 make -f Makefile.dj
23
24 To make your library ready to use, copy the files 'libmikmod.a' and
25 'include/mikmod.h' to your '%DJGPP%/lib' and '%DJGPP%/include' directories
26 respectively.
27
28 HTML documentation of the library, for programmers, is located in the doc
29 directory.
30
31
32 >> SUPPORTED SOUNDCARDS
33 -----------------------
34
35 Currently three brands of sound cards are supported under DOS:
36
37 - Gravis Ultrasound and compatibles. Not tested with Interwave cards. If
38 somebody has one and can debug the code under Interwave, please drop us a note
39 (see email at bottom).
40
41 - SoundBlaster and compatibles. There is only one driver that supports all
42 flavours of SoundBlasters:
43
44 + SB original (8-bit mono, 22KHz)
45 + SB 2.0 (DMA autoinit mode -> less clicks, 44KHz 8-bit mono).
46 + SB Pro (8-bit 22KHz stereo, 8-bit 44KHz mono)
47 + SB 16+ (8- and 16-bit stereo, up to 44Khz both)
48
49 Note that SB16 should cover AWE32/64 as well...
50
51 - Windows Sound System and compatibles. Most today SoundBlaster clones
52 (including the CS4236B card used for testing) emulates (in hardware) WSS.
53 That's because Creative Labs copyrighted the SB16 interface and thus
54 clonemakers cannot do similar hardware without violating their rights, so
55 most of them only emulate SB Pro (see above).
56
57 WSS supports up to 44KHz 16-bit stereo. The following playback rates (in both
58 8- and 16-bit) are supported: 5510, 6620, 8000, 9600, 11025, 16000, 18900,
59 22050, 27420, 32000, 33075, 37800, 44100 and 48000 Hz.
60
61
62 >> THANKS
63 ---------
64
65 We would like to thank everyone who contributed to libmikmod. Their names
66 are in the AUTHORS file for the significative contributions, but some other
67 names can be found in the NEWS file. Thanks a lot ! Keeping libmikmod alive
68 wouldn't be much fun without you.
69
70
71 >> LICENSE
72 ----------
73
74 The libmikmod sound library is covered by the GNU Library General Public
75 License as published by the Free Software Fundation (you'll find it in the
76 file COPYING.LIB) ; either version 2 of the licence, or (at your option)
77 any later version.
78
79 The GNU Lesser General Public License, version 2.1, in file COPYING.LESSER, can
80 be considered as a later version of the LGPL, and is strongly recommended for
81 people who will embed libmikmod in their application as a shared library.
82
83
84 >> CONTACT AND DOWNLOAD INFO
85 ----------------------------
86
87 libmikmod home page is located at SourceForge:
88
89 http://mikmod.sourceforge.net/
90 http://sourceforge.net/projects/mikmod/
91
92 There's a mailing list (mikmod-public) for discussing the development
93 of MikMod (new features, bugs, ideas...) Look for more information on
94 the web site.
95
96 Things related to the DOS port should also be forwarded to the DOS
97 ``portmaster'', Andrew Zabolotny, at: [email protected]
98
99
100 >> LAST NOTES
101 -------------
102
103 We hope you'll enjoy using this version of libmikmod as well as we enjoyed
104 debugging and improving it.
105
106 -- Miodrag ("Miod") Vallat, 10/19/1999
107 [email protected]
108
109 Andrew Zabolotny
110 [email protected]