----------------------------------------
DirectMusic.dll Plugin for 3D GameStudio
(c) 2003 Sean Patrick Hannifin
----------------------------------------
Updated 04-09-2003
----------------------------------------

The DirectMusic.dll is a simple plugin that
allows programmers to make their MIDIs sound
better by playing using Microsoft's DirectMusic.

DirectMusic.dll should work on all computers
that are updated with the latest version of
DirectX.

--------------------
HOW TO USE
--------------------

All you have to do is paste the WDL and the DLL
file in your 3DGS work folder.  In your main WDL
file, insert the following line near the rest of
the include statements:

include <dmusic.wdl>;

This WDL file simply initializes the DLL functions
and opens the DLL file (DirectMusic.dll).

Somewhere in your main function, open the DLL
like this:

dll_open("DirectMusic.dll");

Be sure you open the DLL before you use any
functions that have to do with it!

----------------------------------------

The DLL gives you three new functions to use:

PlayDMusic("MidiFile.mid");

Plays a midi file of your choice if it can be found
in the directory you have pasted the DLL file.
Currently, you may only play one MIDI file at a time.
If another midi file is playing, it will be stopped.

StopDMusic();

Stops the midi.

DMusicState();

Simply returns 1 if a MIDI file is open and/or
being played, and returns 0 if no MIDI file is
open and/or being played.

The WDL also declares several functions you may want
to use instead, especially if you'd like to have your
MIDI looped.

DMusicLoop(file,length);
ex. DMusicPlay("MidiFile.mid",120);

Plays MidiFile.mid for 120 seconds, and then starts
the MIDI over.

DMusicPlay(file);
ex. DMusicPlay("MidiFile.mid");

Plays MidiFile.mid and stops the music loop, if any.

DMusicStop();
ex. DMusicStop();

Stops all MIDI files playing and stops the music loop, if any.

------------------------------------------------------------

You are free to use DirectMusic.dll for any purpose,
including Commercial purposes, free of charge, though
it would be nice if you credited my name.

Hope you enjoy!

------------------------------------------------------------

Sean Patrick Hannifin
"wizard1218" on the 3DGS forum
cyberstuffx@excite.com