			MikModPM - An OS/2 GUI MOD Player


   MikModPM is a Program Manager (GUI) program that uses the MikMod Library
to play many different types of Module music files.

  Since I don't have the desire to write globs of text I'll keep this short.
Only a short over view and the more obscure function of this player will be
documented here. I have tried to make the program as user friendly as 
possible so I hope that detailed documentation would only be over kill.

  BTW... I am a crappy artist... I need a new MikModPM ICON so if you have
some artistic skill and wan't to be my friend for ever, then send a
replacement ICON. Thanks!

1. Installation
2. Loading Files
3. Player controls
4. Popup-Menu
5. Setup
6. Known Problems
7. Version History
8. Credits & Contact Info!

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

1. Installation
----------------

   Unzip the archive into the desired directory and type install.

   The install.cmd file will only create a MikModPM object on your desktop
with associations to all the Module formats that MikMod supports.



2. Loading Files
-----------------

   MikModPM has three methods for loading files.

	1. The Open Button on the MikModPM window.
	2. Drag & Drop into the MikModPM window or the Queue View (SongList!)
	3. Message Passing:

  The message passing option work's like so:
	1. Associate all Modules types to the MikModPM window 
           (install.cmd will do this for you)
	2. Open MikModPM.
	3. Double click on a Module file.

   At this point a second instance of MikModPM will load. The first instance
of MikModPM will be detected and a message will be sent to the first instance 
with the file to be loaded. Then magical the song you clicked on will be added
to the song queue and will start playing (If there is no song already playing).

   I suggest that you creating a few links on the WarpCenter or 
ControlCenter(Object Desktop) to the directories where you store your
Modules. Then you are always no more then 2 clicks way from hearing
your favorite songs! :)



3. Player Controls
-------------------

   The Play button works as expected. When a Module is playing the Play
button will be replaced with a Pause button which also works as expected!

   The Stop Button has TWO functions.
	1. Stops a Playing Song.
	2. ***** Clears the Play Queue when no song is playing! *****

   The FWD/RWD buttons are duel purpose as well.
	1. A Click will skip to the next/previous song!
	2. Pressing (and Holding) the FWD/RWD buttons will
	   fast forward / rewind the current song!

   The Keyboard button will open the Samples List window where you
can see a list of samples, instruments and a message that is stored
in the MOD file. This is commonly used by the author of MOD files as
a place to put comments etc.

   The Notepad Button will bring you to the Queue View (SongList) window
where you can edit and create song lists. All the Queue View control are
accessed via a Popup menu!

   The Toolbox Button will bring you to the Setup window!! (See Section 5)

   The Open Button will display the standard File Open Dialog where you
can select files to be added to the Queue.

   The X Button will Close MikModPM.. Why you need this is beyond me :)


4. Pop-up Menu
-----------------

Open:
      Opens the File selection Dialog so you can select a song to add
      to the play list

Minimize:
      Minimizes the main window

Settings:
      Opens the Settings Window

MiniView:
      Changes the Main Window to use less of the screen

Delete:
      The Delete Menu option will delete the file from your hard disk. 
      PLEASE don't accidentally delete your files. By default there is a
      "Are you sure" message but you can turn this off in the Setup window.

Queue View:
      Opens the Queue View Window

Controls:
      A menu with Play, Stop, Previous Song, and Next Song menu items. 

Close:
      Closes the MikModPM program

5. Setup
------------------

   The Setup window has three tabs:

	General - Sets up how MikModPM works!
	Player  - Sets up the features of the MikMod Library!
	About   - Some Info about MikModPM.


   General Setup Tab:

	1. External Mixer:
		This will allow you to select a mixer that you use to
		control the audio features of your sound card. It also
		allows you to select a Task that is your Mixer. When
		both options are entered you will get a NEW BUTTON which
		will launch your mixer or bring it to the foreground if
		it is already running!

	2. Song Queuing Options:
		Song Queuing is how MikModPM will treat new files that
		are selected to be played. Your options are:

		No Queuing: 	
			Only one song can be in the queue at a time.
			When this option is selected a newly selected
			song will stop and unload the current song
			so the new song can play!
		Append to Queue:
			Any new songs loaded will be added to the end
			of the Queue
		Insert into Queue:
			Any new song loaded will be inserted so that this
			song will be the next song to be played.

	3. Look & Feel:
		This allows you to setup how MikModPM will look!

	4. Behavior:
		This allows you to configure how some of the MikModPM 
		option will work. Randomize Queue will be enabled in a
		furture version.. Sorry!

   Player Tab:

	1. Sound Quality:
		The Sound Quality options allows you to control the
		quaility of the audio playback.
	2. Playback Options:
		Allows you to configure the way MikMod plays Modules.
	3. OS/2 & Driver Options:
		Allows you to select what driver MikMod will use and
		how large of a buffer size to use. The OS/2 options
		allowes you to toggle MikModPM's Time-Critical priority
		and select the OS/2 sound card driver to play back on.

	NOTE:	All options marked with a (*) will take effect even when a
		song is playing. The changes you make to the options marked
		with a (*) will take effect when you exit the Setup page!!
		
		Using the Time-Critical option with MikMod Library 3.1.9
		will not improve the playback speed due to the why the new
		DART driver utilizes the DART call back functions.

   About Tab:

	This just has some Info about me and MikModPM.. Also there is
	a section at the bottom where you can see what version of
	the MikMod2.dll you are using.


6. Known Problems
------------------

-- The GUS Driver sounds like crap.. There are 4 or more people helping
   with this since I don't have a GUS to test with. Hopefully this will be 
   fixed some day!!! Also in version 3.1.8 of the mikmod2.dll the GUS 
   driver has been removed and you will get an error when you select this
   driver.
   *** This drive has been removed since 3.1.8 ***

-- If you change the Frequency setting in the Setup window the play back of
   the current song will be all messed up! (If it hurts don't do it!)

-- If you add more then 99 songs to the queue (SongList) funky things happen!



7. Version History
------------------

0.91
	- Original version of AudioCenter that I modified to be MikModPM.

0.92	Beta Test Internal version 
	- Double Click on Song in the Queue View (Song List) and it will play!
	- Fixed some Drag&Drop bugs
	- Added an option to Clear all songs from the Queue View Pop-up Menu!
	- Fixed a bunch of little bug's!!

0.93	Beta Test Released Version
	- Fixed the Queue View (Song List) window to contain the correct data
          and to be sized and positioned better relative to the Main Window!
	- Fixed a bug causing the Audio Device to be locked during the MikModPM
          Session.
	- Modified to use the new MikMod2.dll 3.1.7-c
	- Many other little things...

0.94  Fix Release
   - Fixed a bug causing the player to barf on the second song!

0.95  Internal Beta
   - Added Sample View
   - Changed the Title to <NONAME> when the song title ins missing!

0.96  Release (Included in MikMod2k-318.zip)
   - Fixed a Bug with the Quit/Exit button code.
   - Fixed a Bug that caused the Default directory to get lost!   
   - Changed the Buffer logic to used the 3.1.8 params
   - A bunch of little fixes!
   - More/Better error handling!

0.97  Internal
   - Changed default buffer size to 8kb
   - Changed default of Time Critical to OFF

0.98  Limited release
   - Added code to better handle corrupt files
   - Fixed a bug that would cause a crash on a double click of FWD or RWD

0.99  Release (Included in MikMod2k-319)
   - ADDED a random play option (Finally!)
   - ADDED bubble help to all the buttons
   - Fixed a bug with the Mixer button being hidden on startup
   - Optimized some internals of the GUI.. Should be a  bit faster :)
   - Fixed the Play pop-up menu item so that it changes to "Pause" correctly!
   - ADDED Instruments and 'Authors message' to the Samples dialog.
   - Fixed samples to show only positive numbers. This is still problems here :(
   - Fixed a bug where a looping error message box occurred.

1.0  Final Release (Included in MikMod2k-319-a)
   - Fixed a few bugs

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

8. Credits: ****** READ THIS *******
-----------

	Thanks go out to all the great people that coded the MikMod
	library over the years... ( http://mikmod.darkorb.net/ )

	Thanks to all the people that tested AudioCenter (the program
	MikModPM is based on) Without there help I would never have
	gotten AudioCenter released and therefor MikModPM would never
	have been created!

	Specal Thanks goes to all the people that send in bug reports
   and suggestions.. I know I have not been to responsive to your
   requests but I sill really appreciate your input.
 


So that's all folks:

Contact me at:	langman@earthling.net

Please mail me!.. I do look forward to your comments!

WWW: http://go.to/langman

Kevin Lamgman!
