home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / dmppm075.zip / DMPPM.DOC < prev    next >
Text File  |  1996-07-11  |  8KB  |  194 lines
  1.                     Dual Module Player for Presentation Manager 0.75
  2.                     ------------------------------------------------
  3.  
  4. This is a Presentation Manager player using Julien Pierre's OS/2 port of
  5. Otto Chrons' Digital Sound & Music Interface.
  6.  
  7. Dual Module Player is a program for playing music modules on different
  8. sound systems on IBM PC compatible machines. It uses DSMI sound
  9. programming interface (Digital Sound & Music Interface) to achieve
  10. high quality sound and wide sound card support.
  11.  
  12. Currently DMP supports following module formats:
  13.  
  14.     MOD,NST     The original Amiga module format (SoundTracker,
  15.                 NoiseTracker). Also supported by many PC trackers.
  16.                 Original format supported only 4 channels but many
  17.                 variants can support up to 32 channels.
  18.  
  19.     STM,S3M     Scream Tracker format. S3M can support up to 16
  20.                 channels while STM is limited to 4.
  21.  
  22.     669         Composer669 module format using 8 channels.
  23.  
  24.     FAR         Farandole tracker format capable of using 16 channels.
  25.  
  26.     MTM         MultiTracker format. It's a MOD variant with up to 32
  27.                 channels.
  28.  
  29.     AMF         DSMI's internal module format. You can convert all the
  30.                 previous formats to AMF with M2AMF but not vice versa.
  31.                 Using AMF format saves you disk space because AMFs are
  32.                 usually smaller than other module formats. DMP can
  33.                 also load AMFs faster than other formats. But remember
  34.                 that you cannot play AMFs on any other player, nor can
  35.                 you convert AMFs back to any other format.
  36.  
  37.                                     USAGE
  38.                                     -----
  39.  
  40. Just run DMPPM.EXE from command-line or WPS.
  41.  
  42. I hope the GUI is simple enough :-)
  43. For an explanation of the parameters, consult the documentation for the
  44. text version of DMP.
  45.  
  46. Note that to work, this version needs the DSMI and DRIVER DLLs from.
  47.  
  48. Both can be found on my homepage on the Internet.
  49. See "Contacting the Author" below for URL.
  50.  
  51.                             CONTACTING THE AUTHOR
  52.                             ---------------------
  53.  
  54. I can be contacted on the internet as madbrain@netsrq.com.
  55.  
  56. Address :
  57. 1664, Cherry Lane Appartment 3
  58. Sarasota, FL 34236
  59. Phone : 1-941-366-5355
  60.  
  61. You can also find me as "madbrain" on Internet Relay Chat (check that it is
  62. my address with my URL listed when you do /whois madbrain).
  63.  
  64. You can usually find the latest release version of DMP on hobbes.nmsu.edu.
  65. Betas will be available from my homepage at
  66. http://www.polsci.wvu.edu/Henry/Madbrain
  67.  
  68.  
  69.                               REVISION HISTORY
  70.                               ----------------
  71.  
  72. 23/12/95 :
  73. 1st alpha.
  74. English language support.
  75. Most options won't work.
  76. This version only uses DART.
  77.  
  78. 24/12/95 :
  79. 2nd alpha.
  80. Buttons added.
  81. Not all buttons work yet.
  82.  
  83. 28/12/95 :
  84. 3rd alpha.
  85. Finnish language support.
  86.  
  87. 10/2/96 :
  88. 4th alpha.
  89. New presentation. Displays pattern number.
  90. INI code written.
  91. New dialog for settings, but not enabled at this time.
  92. New photo :) (but still buggy when PM is less than 65536 colors).
  93.  
  94. 9/3/96 :
  95. Version 0.5 beta.
  96. Settings dialog & INI code should work.
  97. Warning : when you change driver or settings, you need to reload the file.
  98.  
  99. 10/3/96 :
  100. Version 0.51 beta.
  101. On-the-fly drivers/parameters change fixed. Will even continue playing the
  102. module with new driver at the point it was (MMPM/2 users : because of
  103. buffering it will restart later in the song).
  104.  
  105. 28/3/96 :
  106. Version 0.55 beta.
  107. Added window to mute/unmute channels while playing (warning : not realtime
  108. with MMPM/2, only DART).
  109. Finnish support updated.
  110.  
  111. 13/4/96 :
  112. Version 0.60 beta.
  113. - Reduced main window size.
  114. - New buttons thanks to Hrieke !
  115. - pattern buttons modified to mute song while pressed - CD-player like.
  116. - corrected a bug in the break pattern code that would leave some channels
  117. playing after breaking (bugfix to add to DMP text-mode also).
  118. - bugfix : when not in looping mode, DMP would fail to update the status line/buttons
  119. - bugfix : loop mode can now be changed while playing *and* works
  120. - bugfix : MMPM/2 detected correctly on non-DART systems
  121. - bugfix : INI code can now save MMPM/2 or NOSOUND as a setting
  122.  
  123. 22/6/96 :
  124. Version 0.70 beta.
  125. - Added drag & drop support.
  126. - Changed the way looping mode operates.
  127. - Many internal bugs corrected that I don't even remember.
  128. - Photograph should look in 256 colors too.
  129.  
  130. 10/7/96 :
  131. Version 0.75 beta.
  132. - built with VAC++ (new runtime)
  133. - Problem when looping mode was disabled now corrected.
  134. - Added a list box to select the language.
  135. - Saves the PATH of the last module that was loaded.
  136. - Vastly improved language support.
  137. - Now shows version number in "About" box.
  138.  
  139.                             NATIONAL LANGUAGE SUPPORT
  140.                             -------------------------
  141.  
  142. - You can now build your own language DLLs for DMP/PM.
  143. All you have to do is copy the included english version, DMPUS.RC, to another
  144. file, let's say DMPSP.RC for Spanish. Then change the corresponding country code
  145. in the file (you can include several by separating them via spaces) and translate
  146. all the strings. Note that string identifiers must NOT be changed, only the text
  147. between code must be changed.
  148. Also, you must NOT translate this string :
  149. LANGUAGE_MARK, "Dual Module Player Language DLL".
  150.  
  151. When you are done, run the DMPLANG.CMD batch file with the "SP" argument. This
  152. will build DMPSP.DLL from DMPSP.RC, using the Resource compiler and Linker that
  153. come with OS/2.
  154.  
  155. Here is the logic DMP/PM uses to determine the language the first time it is run :
  156. - it loads DMP*.DLL and checks if the LANGUAGE_MARK string is present to identify a
  157. DMP language DLL
  158. - it then queries the country of the machine and sees if any DLLs have a matching
  159. country code. If so, it selects the first DLL that lists the country
  160. - if there is no matching DLL, the country code will assumed to be 1 for US english
  161. - if there is still no match (if you delete DMPUS.DLL for example), then DMP/PM will
  162. use the first language DLL that it finds. If there is none, then DMP/PM will show an
  163. error.
  164.  
  165. When you close DMP/PM, it stores the selected language in the DMP.INI to match it the
  166. next time you run it. To change the language, you can either delete the DMP.INI file
  167. or use the List box with all languages in the "Parameters" list box.
  168.  
  169.                                 KNOWN BUGS
  170.                                 ----------
  171.  
  172. - DMP/PM will crash if you drag multiple objects to it at the same time. Do NOT
  173. try this.
  174. - When you select a new language, only newly created windows will use the new language,
  175. but existing windows still have the one used when the program started. This can result
  176. in having separate windows each in different languages. You should close and restart the
  177. program after you change the language.
  178.  
  179.                                   LICENSE
  180.                                   -------
  181.  
  182. Dual Module Player for OS/2 Presentation Manager is a freeware program.
  183.  
  184. Dual Module Player is copyrighted by me and Otto Chrons.
  185. You are only allowed to distribute it in its original form.
  186.  
  187. Programmers interested in using modules in their OS/2 programs should look at
  188. the DSMI.DSC file. DSMI is a commercial library, not freeware.
  189.  
  190. Authors :
  191. - Code : Julien Pierre (madbrain)
  192. - Icons : Hrieke
  193. - Finnish Support : Os2wizard
  194.