mirror of
https://github.com/ZDoom/gzdoom.git
synced 2024-12-13 14:11:19 +00:00
01f59fa85f
heavily customized version of DUMB (Dynamic Universal Music Bibliotheque). It has been slightly modified by me: * Added support for Ogg Vorbis-compressed samples in XM files ala FMOD. * Removed excessive mallocs from the replay core. * Rerolled the loops in resample.c. Unrolling them made the object file ~250k large while providing little benefit. Even at ~100k, I think it's still larger than it ought to be, but I'll live with it for now. Other than that, it's essentially the same thing you'd hear in foobar2000, minus some subsong detection features. Release builds of the library look like they might even be slightly faster than FMOD, which is a plus. - Fixed: Timidity::font_add() did not release the file reader it created. - Fixed: The SF2 loader did not free the sample headers in its destructor. SVN r995 (trunk)
94 lines
3.7 KiB
Text
94 lines
3.7 KiB
Text
/* _______ ____ __ ___ ___
|
|
* \ _ \ \ / \ / \ \ / / ' ' '
|
|
* | | \ \ | | || | \/ | . .
|
|
* | | | | | | || ||\ /| |
|
|
* | | | | | | || || \/ | | ' ' '
|
|
* | | | | | | || || | | . .
|
|
* | |_/ / \ \__// || | |
|
|
* /_______/ynamic \____/niversal /__\ /____\usic /| . . ibliotheque
|
|
* / \
|
|
* / . \
|
|
* tutorial.txt - DUMB Programmers' Tutorial. / / \ \
|
|
* | < / \_
|
|
* See readme.txt for general information on | \/ /\ /
|
|
* DUMB and how to set it up. \_ / > /
|
|
* | \ / /
|
|
* | ' /
|
|
* \__/
|
|
*/
|
|
|
|
|
|
********************
|
|
*** Introduction ***
|
|
********************
|
|
|
|
|
|
Welcome to the DUMB Programmers' Tutorial!
|
|
|
|
In order to follow this tutorial, you should already have set Allegro and
|
|
DUMB up on your system, including DUMB's support for Allegro and the example
|
|
programs. If you have not done so, see readme.txt for details.
|
|
|
|
You will also need some IT files. If you would like to compose your own, then
|
|
first I must offer a word of warning: not everyone is capable of composing
|
|
music. Do not assume you will be able to learn the art. By all means have a
|
|
go; if you can learn to play tunes on the computer keyboard, you're well on
|
|
the way to being a composer!
|
|
|
|
The best program for the job is Impulse Tracker itself, available from:
|
|
|
|
http://www.noisemusic.org/it/
|
|
|
|
This is a DOS program. Users of DOS-incapable operating systems may like to
|
|
try ModPlug Tracker, but should be aware that it does not support all
|
|
combinations of effects correctly, and some IT files will sound wrong. If you
|
|
use a different operating system, or if you know of a better IT editor for
|
|
Windows, please give me some links so I can put them here!
|
|
|
|
ModPlug Tracker is available from: http://www.modplug.com/
|
|
|
|
If you would like to download IT files composed by other people, check the
|
|
following sites:
|
|
|
|
http://www.modplug.com/
|
|
http://www.traxinspace.com/
|
|
|
|
Once again, if you know of more sites where IT files are available for
|
|
download, please let me know.
|
|
|
|
Once you've got some IT files, we're ready to begin!
|
|
|
|
Note that support for S3M files has very recently been added to DUMB, but it
|
|
is bound to be faulty. I recommend you use IT files in preference until later
|
|
releases of DUMB.
|
|
|
|
|
|
******************
|
|
*** Try It Out ***
|
|
******************
|
|
|
|
|
|
We'll start simply by running one of the example programs.
|
|
|
|
Find playit.exe, in the dumb/examples folder. Choose an IT file, and pass it
|
|
to playit.exe. In DOS, you can do this by typing 'playit' followed by the
|
|
name of the IT file. In Windows, you can drag the IT file and drop it on
|
|
playit.exe.
|
|
|
|
You should now hear the music play back. If not, make sure your speakers are
|
|
on and volume is not turned down. Try one of Allegro's example programs. If
|
|
you are using DJGPP under Windows, consider using a Windows compiler instead.
|
|
If you cannot get it working, see readme.txt for details on seeking help with
|
|
DUMB.
|
|
|
|
When you are satisfied, press any key to stop the music and return to the
|
|
operating system.
|
|
|
|
|
|
*************************
|
|
*** How Does It Work? ***
|
|
*************************
|
|
|
|
|
|
Now load playit.c into your favourite editor. Here is an explanation of what
|
|
it does:
|