home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / mikmod2k.zip / MikModPM.txt < prev    next >
Text File  |  1999-11-07  |  9KB  |  275 lines
  1.             MikModPM - An OS/2 GUI MOD Player
  2.  
  3.  
  4.    MikModPM is a Program Manager (GUI) program that uses the MikMod Library.
  5. This verion of MikModPM (0.97) is currently in Beta. This mean that I have
  6. tested it on my machine and I even have some beta testers that have had no
  7. problems, but until many of you have reported MikModPM has "Bug Free" it 
  8. will stay in beta.
  9.  
  10.   Since I don't have the desire to write gobbs of text i'll keep this short.
  11. Only a short over view and the more bescure function of this player will be
  12. documented here. I have tried to make the program as user friendly as 
  13. possible so I hope that detailed documentation would only be over kill.
  14.  
  15.   BTW... I am a crappy artist... I need a new MikModPM ICON so if you have
  16. some artistic skill and wan't to be my firend for ever then send a replacment
  17. ICON. Thanks!
  18.  
  19. 1. Instalation
  20. 2. Loading Files
  21. 3. Player controls
  22. 4. Popup-Menu
  23. 5. Setup
  24. 6. Known Problems
  25. 7. Version History
  26. 8. Credits & Contact Info!
  27.  
  28. -------------------------------------------------------------------------------
  29.  
  30. 1. Instalation
  31. ----------------
  32.  
  33.    Unzip the archine into the desired directory and type install.
  34.  
  35.    The install.cmd file will only create a MikModPM object on your desktop
  36. with assouations to all the Module formats that MikMod supports.
  37.  
  38.  
  39.  
  40. 2. Loading Files
  41. -----------------
  42.  
  43.    MikModPM has three methods for loading files.
  44.  
  45.     1. The Open Button on the MikModPM window.
  46.     2. Drag & Drop into the MikModPM window or the Queue View (SongList!)
  47.     3. Message Massing
  48.  
  49.   The message passing workes like so:
  50.     1. Asssouate all Modules types to the MikModPM window 
  51.            (install.cmd will do this for you)
  52.     2. Open MikModPM.
  53.     3. Double click on a Module file.
  54.  
  55.    At this point a second instance of MikModPM will load. The fisrt instance
  56. of MikModPM will be detected and a message will be sent to the first instance 
  57. with the file to be loaded. Then magicly the song you clicked on will be added
  58. to the song queue and will start playing (If there is no song already playing).
  59.  
  60.    I suggest that you creating a few links on the WarpCenter or 
  61. ControlCenter(Object Desktop) to the directories where you store your
  62. Modules. Then you are always no more then 2 clicks way from hearing
  63. your frvarite songs! :)
  64.  
  65.  
  66.  
  67. 3. Player Controls
  68. -------------------
  69.  
  70.    The Play button works as expected. When a Module is playing the Play
  71. button will be replaced with a Pause button which also works as expected!
  72.  
  73.    The Stop Button has TWO functions.
  74.     1. Stops a Playing Song.
  75.     2. ***** Clears the Play Queue when no song is playing! *****
  76.  
  77.    The FWD/RWD buttons are duel purpose as well.
  78.     1. A Click will skip to the next/previous song!
  79.     2. Pressing (and Holding) the FWD/RWD buttons will
  80.        fast forward / rewind the current song!
  81.  
  82.    The Keyboard button will open the Samples List window where you
  83. can see a list of samples in the mod file. This is commonly used
  84. by the author of Mod files as a place to put comments etc.
  85.  
  86.    The Notepad Button will bring you to the Queue View (SongList) window
  87. where you can edit and create song lists. All the Queue View control are
  88. accessed via a Popup menu!
  89.  
  90.    The Toolbox Button will bring you to the Setup window!! (See Section 4)
  91.  
  92.    The Open Button will display the standard File Open Dialog where you
  93. can select files to be added to the Queue.
  94.  
  95.    The X Button will Close MikModPM.. Why you need this is beyond me :)
  96.  
  97.  
  98. 4. Pop-up Menu
  99. -----------------
  100.  
  101. Open:
  102.       Opens the File selection Dialog so you can selet a song to add
  103.       to the play list
  104.  
  105. Minimize:
  106.       Minimizes the main window
  107.  
  108. Settings:
  109.       Opens the Settings Window
  110.  
  111. MiniView:
  112.       Changes the Main Window to use less of the screen
  113.  
  114. Delete:
  115.       The Delete Menu option will delete the file from your hard disk. 
  116.       PLEASE don't acidentaly delete your files. By default there is a
  117.       "Are you sure" message but you can turn this off in the Setup window.
  118.  
  119. Que View:
  120.       Opens the Queue View Window
  121.  
  122. Controls:
  123.       A menu with Play, Stop, Previous Song, and Next Song menu items. 
  124.  
  125. Close:
  126.       Closes the MikModPM program
  127.  
  128. 5. Setup
  129. ------------------
  130.  
  131.    The Setup window has three tabs:
  132.  
  133.     General - Sets up how MikModPM works!
  134.     Player  - Sets up how the features of the MikMod Library!
  135.     About   - Some info about MikModPM.
  136.  
  137.  
  138.    General Setup Tab:
  139.  
  140.     1. External Mixer:
  141.         This will allow you to select a mixer that you use to
  142.         control the audio features of your sond card. It also
  143.         allows you to select a Task that is your Mixer. When
  144.         both options are entered you will get a NEW BUTON which
  145.         will launch your mixer or bring it to the forground if
  146.         it is already running!
  147.  
  148.     2. Song Queuing Options:
  149.         Song Queuing is how MikModPM will treat new files that
  150.         are selected to be played. 
  151.         No Queuing:     
  152.             Only one song can be in the queue at a time.
  153.             When this option is selected a newly selected
  154.             song will stop and unload the current song
  155.             so the new song can play!
  156.         Append to Queue:
  157.             Any new songs loaded will be added to the end
  158.             of the Queue
  159.         Insert into Queue:
  160.             Any new song loaded will be instered so that this
  161.             song will be the next to be played.
  162.  
  163.     3. Look & Feel:
  164.         This allows you to setup how MikModPM will look!
  165.  
  166.     4. Behaviour:
  167.         This allows you to configure how some of the MikModPM 
  168.         option will work. Randomize Queue wil be enabled in a
  169.         furture version.. Sorry!
  170.  
  171.    Player Tab:
  172.  
  173.     1. Sound Quality:
  174.         The Sould Quality options allows you to control the
  175.         quaility of the audio playback.
  176.     2. Playback Options:
  177.         Allows you to configure the way MikMod plays Modules.
  178.     3. OS/2 & Driver Options:
  179.         Allows you to select what driver MikMod will use and
  180.         how large of a buffer size to use. The OS/2 options
  181.         allowes you to toggle MikModPM's Time-Critical priority
  182.         and select the OS/2 sound card driver to play back on.
  183.  
  184.     NOTE:    All options marked with a (*) will take effect even when a
  185.         song is playing. The changes you make to the options marked
  186.         with a (*) will take effect when you exit the Setup page!!
  187.         
  188.         Using the Time-Critical option with MikMod Library 3.1.8
  189.         will not improve the playback speed due to the why the new
  190.         DART driver utilizes the DART call back functions.
  191.  
  192.    About Tab:
  193.  
  194.     This just has some info about me and MikModPM.. Also there is
  195.     a section at the bottom where you can see what the version of
  196.     the MikMod2.dll you are using.
  197.  
  198.  
  199. 6. Known Problems
  200. ------------------
  201.  
  202. -- The GUS Driver sounds like crap.. There are 4 or more poeple helping
  203.    with this since I don't have a GUS to test with. Hopfully this will be 
  204.    fixed some day!!! Also in version 3.1.8 of the mikmod2.dll the GUS 
  205.    driver has been removed and you will get an error when you select this
  206.    driver.
  207.  
  208. -- If you change the Frequency setting in the Setup window the play back of
  209.    the current song will be all messed up! (If it hurts don't do it!)
  210.  
  211. -- If you add more then 99 songs to the queue (SongList) funky things happen!
  212.  
  213. -- The Randomize Option in the Setup window is not implemented yet!! May be in 
  214.    a future release... 
  215.  
  216.  
  217. 7. Version History
  218. ------------------
  219.  
  220. 0.91
  221.     - Orignal version of AudioCenter that I modified to be MikModPM.
  222.  
  223. 0.92    Beta Test Internal version 
  224.     - Double Click on Song in the Queue View (Song List) and it will play!
  225.     - Fixed some Drag&Drop bugs
  226.     - Added an option to Clear all songs from the Queue View Pop-up Menu!
  227.     - Fixed a bunch of little buggs!!
  228.  
  229. 0.93    Beta Test Released Version
  230.     - Fixed the Queue View (Song List) window to contain the correct data
  231.           and to be sized and positioned better relitive to the Main Window!
  232.     - Fixed a bug causing the Audio Device to be locked during the MikModPM
  233.           Session.
  234.     - Modified to use the new MikMod2.dll 3.1.7-c
  235.     - Many orther little things...
  236.  
  237. 0.94  Fix Release
  238.    - Fixed a bug causing the player to barf on the second song!
  239.  
  240. 0.95  Internal Beta
  241.    - Added Sample View
  242.    - Changed the Title to <NONAME> when the song title ins missing!
  243.  
  244. 0.96  Release (Included in MikMod2k-318.zip)
  245.    - Fixed a Bug with the Quit/Exit button code.
  246.    - Fixed a Bug that caused the Default directory to get lost!   
  247.    - Chanded the Buffer logic to used the 3.1.8 params
  248.    - A bunch of little fixes!
  249.    - More/Better error handling!
  250.  
  251. ---------------------------------------------------------------------
  252.  
  253. 8. Credits: ****** READ THIS *******
  254. -----------
  255.  
  256.     Thanks go out to all the great people that coded the MikMod
  257.     library over the years... ( http://mikmod.darkorb.net/ )
  258.  
  259.     Thanks to all the people that tested AudioCenter (the program
  260.     MikModPM is based on) Without there help I would never have
  261.     gotten AudioCenter released and therefor MikModPM would never
  262.     have been created!
  263.  
  264.     Specal Thanks goes to Antonio Manara Rossini for testing the
  265.     pre-release version of MikModPM and the GUS Driver!
  266.  
  267.  
  268.  
  269. So thats all fokes:
  270.  
  271. Contact me at:    langman@earthling.net
  272.  
  273. Please mail me!.. I do look forward to your comments!
  274.  
  275. Kevin Lamgman!