---------------------------
 MikWin 3.1.10 R2.1
  by Bojan Urosevic
  bojan.urosevic@bj.tel.hr
---------------------------

MikWin is a sound library. With it you can quickly add sound and music
made in various module trackers to your application.

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free
    Foundation, Inc., 59 Temple Place, Suite 330, Boston,
    MA  02111-1307  USA


MikWin R2.1 is based on MikWin R2 by Ozzy.

Main difference from R2 is that MikWin can now be used as a DLL.
Also, few more functions are exported and some small changes are
made to make it easier to add MikWin's music player capabilities to
applications with already existing DSound objects.
Some small bugs were corrected too.

You can download source for MikWin R2.1 here:
    http://www.space-ewe.com/download/MikWin3.1.10-R2.1.zip

In it you will find some examples.

MikWin R2 (by Ozzy) homepage:
    http://www.orkysquad.org/articles/Mikwin.html
    ozzy@orkysquad.org

MikWin itself is based on "libmikmod" - portable sound library,
which is currently maintained by Miodrag Vallat.


----------------------------------------------------
Here is some short info regarding the interaction of
Bud Redhead and MikWin R2.1.

Bud Redhead uses MikWin only for playing music (XM modules).
It uses these functions from MikWin.dll:

add_ds_mikwin
get_ds_dsbstream
remove_ds_mikwin

Player_Load
Player_Start
Player_TogglePause
Player_Stop
Player_Free

MikMod_Update


Of course, MikWin must be compiled with at least XM loader.

Bud Redhead adds MikWin to an existing DSound object.
MikWin is initiated with sound delay of 42 = 0.42 seconds.
However, music volume is not changed through MikWin but
directly with dsbstream->SetVolume. Therefore latency for
changing volume is actually DSound latency.
Pausing and resuming music are done similarly.

Well, that's it.
If you need more assistance with building MikWin.DLL and making
Bud Redhead work with it, contact me.


Bojan Urosevic
Space Ewe Software
http://www.space-ewe.com
bojan.urosevic@bj.tel.hr
support@space-ewe.com
------------------------
2002/12/01
