home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / MOD.ZIP / DMPLAYER.DOC next >
Text File  |  1994-01-11  |  12KB  |  255 lines
  1.  
  2.                              Digital Music Player
  3.                                  version 0.9
  4.  
  5.                               an Aria production
  6.  
  7.  
  8. 0. Documentation
  9. ----------------
  10.    This documentation is a temporary solution.  As of version 0.9, there is no
  11. online help available.  Version 1.0 will include a full help system.  The 
  12. reason for the lack of help in this version is the fact that I want to satisfy 
  13. the demand for a quality .MOD music module player.  
  14.  
  15. 1. Introduction
  16. ---------------
  17.    Digital Music Player is a multi-threaded .MOD format music module player for
  18. OS/2 2.x with the MMPM/2 multimedia extensions installed.  A digital capable 
  19. audio adapter is required.  DMPlayer has been designed to work well with you.  
  20. It is capable of playing songs in the background while you get real work done 
  21. with a minimum of interruption.  Aside from the wonderful music of course.  You 
  22. will be able to listen to your favorite modules and still have a responsive 
  23. system at your fingertips.  DMPlayer even cooperates with the system sounds 
  24. provided by MMPM/2.
  25.  
  26.    Digital Music Player is currently capable of playing the following formats:
  27.  
  28.       4 track, 31 and 15 instrument Protracker/Noisetracker modules
  29.       4 and 8 track Startrekker modules
  30.       6 and 8 track Fasttracker modules
  31.  
  32.    More formats will be supported in the future.
  33.  
  34. 1.2. Ariaware
  35. -------------
  36.    This software product is provided to you for the sole purpose of evaluation
  37. to purchase.  DMPlayer is not free.  You are granted license to a trial 
  38. evaluation period of 30 days in which to determine if you wish to continue 
  39. using the program.  If you decide to use DMPlayer after the 30 day trial 
  40. period, you must pay the registration fee of $20 (US).  Any use beyond the 30 
  41. day trial period is prohibited by law.  Please see the file REGISTER.TXT for 
  42. more information on how to register.  
  43.  
  44. 1.2.1. Limitations
  45. ------------------
  46.    If you have not registered DMPlayer, then you will have to face up to a few
  47. limitations.  These limitations are critical, however, they do not interfere 
  48. with the evaluation of the program.  
  49.  
  50.    The current limitations are as follows:
  51.  
  52.    1.    Inability to save settings between sessions.  Normally, DMPlayer would
  53.          remember window positions, audio settings, playback settings and 
  54.          directories accessed.
  55.  
  56.    2.    Inability to load or save SongLists.  All other aspects of the 
  57.          SongList window are fully functional.
  58.  
  59.    I hope that you do not find that these limitations are too restrictive.  You
  60. should still be able to determine whether or not you wish to use the program 
  61. even with these restrictions.  
  62.  
  63.    Due to these limitations, many people may quickly dub this software as
  64. 'Crippleware' or the like.  Be that as it may, I have made a serious investment 
  65. in the development of DMPlayer and I must protect that investment.  I have 
  66. tried to do so in the most benign manner possible.  
  67.  
  68. 1.2.2. Registration
  69. -------------------
  70.    When you register DMPlayer, you will receive a keyfile unlocking the full 
  71. functionality of the program.  The one time registration fee will provide you 
  72. with *free upgrades for the life of this program*.  Both minor and major 
  73. upgrades will be made available via your favorite OS/2 shareware distribution 
  74. site.  All future versions of this program will automatically be unlocked by 
  75. the keyfile you will receive.  Please see the file REGISTER.TXT for more 
  76. information on how to register.  
  77.  
  78. 1.2.3. Support
  79. --------------
  80.    DMPlayer is an evolving product.  Support for other module formats will
  81. become available in the future.  More functionality may be added at some later 
  82. date.  All of which is free to registered users.  Support is made available via 
  83. the internet.  Mail questions and/or comments to:  
  84.  
  85.          dodger@kira.csos.orst.edu
  86. or       murrayk@instruction.cs.orst.edu
  87.  
  88. 1.3. Distribution
  89. -----------------
  90.    Digital Music Player may be freely distributed provided that the entire 
  91. archive remains intact.  Shareware distributors may not charge more than $5 
  92. (including shipping) for this software package.
  93.  
  94. 1.4. Warranty
  95. -------------
  96.    No warranty of any kind is implicitly or explicitly granted through use of
  97. this program.  Aria will not be held liable for any damages resulting form the 
  98. use of this product.  
  99.  
  100. 1.5. Installation
  101. -----------------
  102.    Digital Music Player needs no special setup.  Simply copy the program file
  103. into a directory and create a program object if you desire.  
  104.  
  105. 2. Explanation
  106. --------------
  107.    The heart of Digital Music Player is the main control panel.  This dialog 
  108. box presents the most amount of information in the least amount of space 
  109. possible.  It will not hog your entire desktop.  It has been designed to 
  110. somewhat resemble an CD player so the funcitonality should be readily apparent.  
  111.  
  112. 2.1. Main Dialog
  113. ----------------
  114.    This is the basic layout of the main dialog.
  115.  
  116.    +-------------------------------------------------------------------------+
  117.    |[ ] Digital Music Player                                              [o]|
  118.    +---------------------------------------------------+---------------------+
  119.    | SongList name                       track x of y  | SongList |   Audio  |
  120.    |                                                   |  dialog  |  Control |
  121.    | Current module name                        time   +----------+----------+
  122.    +---------------------------------------------------+  Module  | Playback |
  123.    | Play | Pause | Stop | Rew | FF |    | Prev | Next |   Info   | Settings |
  124.    +---------------------------------------------------+---------------------+
  125.  
  126.    The display is easy to understand.  The current SongList is displayed in the
  127. upper left corner.  This is also where you will be notified of problems 
  128. relating to the SongList.  The current module is displayed in the lower left 
  129. corner of the display.  Status messages related to the current module are 
  130. displayed here.  The current and total tracks display is located in the upper 
  131. right corner of the display.  The elapsed time is displayed in the lower right 
  132. corner.  The time display does not take into account skipping about in the 
  133. song.  It simply displays a running elapsed time that the song has been 
  134. playing.  
  135.  
  136.    If you have ever used a CD player, then you should be able to control the
  137. playback of your music modules with DMPlayer.  All the buttons act as they 
  138. would on any CD player.  The 'Prev' and 'Next' buttons select the previous or 
  139. next song in the SongList.  
  140.  
  141.    The four buttons on the far right of the main dialog control the appearance
  142. of the four auxiliary dialogs.  They act as toggles, showing the relative 
  143. dialog if it is hidden, and hiding it if visible.  
  144.  
  145.    There are also two menu items added to the system menu. The 'About...' 
  146. option displays the copyright, version information, and who the program is 
  147. registered to. The 'Help' menu item will open the help system in the future.
  148.  
  149. 2.2. Playback Settings
  150. ----------------------
  151.    This is the dialog where you determine the output quality.  DMPlayer 
  152. supports either 8 or 16 bits per sample in both mono and stereo modes.  If your 
  153. audio adapter does not support stereo or 16 bit, then those options will be 
  154. disabled.  You also set the frequency for playback here.  The frequency slider 
  155. allows you to make a precise tradeoff between processor time and quality.  The 
  156. lower the setting, the less time DMPlayer will steal from the system.  The 
  157. higher the frequency, the better the output quality.  The differences, in terms 
  158. of processor time, between 8 and 16 bit or stereo and mono are negligible in 
  159. most situations.  These settings do not take effect while a song is playing.  
  160. It must be stopped and then restarted for them to become apparent.  
  161.  
  162. 2.3. Audio Control
  163. ------------------
  164.    This is where you can adjust the volume, balance, bass and treble.  Not all
  165. audio adapters support these settings.  However, due to a limitation in the 
  166. MMPM/2 interface, there is no way to determine certain hardware capabilities so 
  167. all of these controls are enabled whether or not your particular audio adapter 
  168. supports the action.  
  169.  
  170. 2.4. Module Information
  171. -----------------------
  172.    This dialog displays some detaild information about the current module. 
  173. This includes the name, number of channels, format, full path name and a list 
  174. of the samples in the module.  The list of samples shows the sample name, 
  175. length, repeat offset and the repeat length.  
  176.  
  177. 2.5. SongList
  178. -------------
  179.    A SongList is a collection of music modules that can be loaded, edited and 
  180. saved.  Clicking on the SongList window with the context mouse button (by 
  181. default the right mouse button) brings up the context menu for the SongList.  
  182. The SongList supports 6 different views of its contents:  Icon, Name, Name 
  183. Flowed, Text, Text Flowed, and Details.  These views are the same as their 
  184. respective views in the WPS folder system.  This should be a very familiar 
  185. system to work with.  That was the whole purpose in designing the SongList in 
  186. this manner.  Drag and drop operations are also supported.  You can drag songs 
  187. within the SongList to reorder.  You can also drag music modules from the file 
  188. system and drop them in the SongList!  Experimentation is the direct way to 
  189. understanding.  To play a song, simply double-click on it and listen and enjoy!
  190.  
  191. 2.5.1. SongList Menus
  192. ---------------------
  193.    The SongList menu has the following options:
  194.  
  195.    New:        Start a new SongList from scratch.
  196.    Open:       Open a SongList that was previously saved.
  197.    Save:       Save the current SongList.
  198.    Save as:    Save the current SongList with a different name.
  199.  
  200.    Add songs:  Select songs to insert into the SongList.
  201.  
  202.    View:
  203.       Icon:    Select the Icon view.
  204.       Name:    Select the Name view.
  205.       Text:    Select the Text view.
  206.       Details: Select the Details view.
  207.       Flowed:  Select whether or not to flow the Name or Text view.
  208.  
  209.    Select:
  210.       Select all:    Select all items in the SongList.
  211.       Deselect all:  Deselect all items in the SongList.
  212.  
  213.    The context menu for one entry has the following options:
  214.  
  215.    Play:       Start playing this song.
  216.    Remove:     Remove this song from the SongList.
  217.  
  218.    The context menu for several selected entries has the following options:
  219.  
  220.    Remove:     Remove these selected songs from the SongList.
  221.  
  222. 2.5.2. Reordering the SongList
  223. ------------------------------
  224.    Reordering of the SongList is easy.  Simply drag the item to be repositioned
  225. to it's destination and release the button.  In the Icon view, there is no real 
  226. concept of 'between' items, so attempting to drop an item between two others 
  227. will result in that item moving to the end of the list.  In all other views, 
  228. items may be placed between (or before or after) others.  Items may also be 
  229. placed 'before' another item by dropping onto the destination.  Experiment and 
  230. you will understand.  
  231.  
  232. 3. Thanks
  233. ---------
  234.    Thanks go out to the following people for doing some *serious* late night 
  235. bug hunting:
  236.  
  237.    Adrian Idzik
  238.    Linden deCarmo
  239.    Dave Killian
  240.    Chance Geurin
  241.  
  242.    Special thanks to Linden deCarmo for all his support and answered questions 
  243. about the innermost workings of MMPM/2.  You guys did a great job with MMPM/2 
  244. Linden!  Thanks for all the help and answered questions and bug reports and 
  245. moral support and etc...  8^) 
  246.  
  247.    Thanks also to my other early beta testers. You all helped out!
  248.  
  249. -1/10/94-
  250.  
  251. +----------------------------------------------------------------------------+
  252. |    Digital Music Player was coded by Keith Murray (the Dodger) of Aria.    |
  253. |             Copyright (c) 1993-1994 Aria, all rights reserved.             |
  254. +----------------------------------------------------------------------------+
  255.