home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / ultmod14.zip / README.TXT < prev    next >
Text File  |  1996-02-07  |  10KB  |  218 lines
  1.                 UltiMOD v1.4ß
  2.  
  3. UltiMOD is a freeware DART modplayer for OS/2 2.x or OS/2 Warp with MMPM/2 
  4. installed.(+ the dart dlls)
  5.  
  6. ================================================================================
  7.    0  Contents
  8. ================================================================================
  9.        1  Features
  10.        2  Installation
  11.        3  UltiMOD
  12.        4  Ultitext (textmode version of UltiMOD)
  13.        5  A few tips to make life easier
  14.        6  General Information
  15.        7  Questions & Answers
  16.        8  Bug Reports
  17.        9  How to help improve UltiMOD
  18.       10  Standard disclaimer
  19.  
  20. ================================================================================
  21.    1  Features
  22. ================================================================================
  23. - support for:
  24.     - 4 channel, 31 and 15 instrument Protracker/Noisetracker modules
  25.         - 4 and 8 channel Startracker modules
  26.         - 1 - 32 channel Fasttracker 1 modules
  27.         - MTM
  28.     - S3M
  29.     - XM 
  30. - ability to play samples inside a modfile at any note.
  31. - support for songlists. (up to 512 files in one songlist)
  32. - Graphical user interface. (graphical push & volume buttons, slidebar etc)
  33. - Textmode version included with new user interface (and realtime display of
  34.   channel data)
  35. - Multithreaded. One thread for playing modfiles and 1 for the user interface.
  36.   This means that you can create your own songlist and save it while UltiMOD is
  37.   playing one of your modfiles.
  38.  
  39. ================================================================================
  40.    2  Installation
  41. ================================================================================
  42. Unzip ultimod.zip and run 'install.cmd' to put UltiMOD on your desktop.
  43. If you like to run ultimod from any directory on your hard disk(s) add
  44. the directory, in which you copied ultimod, to the 'SET HELP =' and 
  45. 'SET PATH = ' lines in your config.sys. 
  46. Load your favourite modfile and fully exploit OS/2's multitasking capabilities
  47. by running it alongside other applications.
  48.  
  49.  
  50. ================================================================================
  51.    3  UltiMOD
  52. ================================================================================
  53. This document won't explain how UltiMOD works. It's interface is self 
  54. explaining by providing you with graphical pushbuttons and simple menu's.
  55. If something isn't clear just press F1 for online help.
  56.  
  57. UltiMOD accepts one songlist or one or more modfiles as a parameter on 
  58. the command line. They can contain wildcards.
  59.  
  60. ================================================================================
  61.    4  Ultitext (textmode version of UltiMOD)
  62. ================================================================================
  63. The textmode verison of UltiMOD also accepts one songlist or one or more 
  64. modfiles as a parameter on the command line. They can also contain wildcards.
  65.  
  66. Keys:    Esc            - Quit
  67.     -/+             - decrease/increase song speed 
  68.     PgUp/PgDn        - scroll 9 channels up/down
  69.     cursor up/down      - scroll one channel up/down
  70.                   (red arrow points to the channel position)
  71.     Enter            - disable or enable channel
  72.     cursor left/right    - one position back/forward
  73.     n            - skip to next song in the songlist    
  74.  
  75. Usage: ULTITEXT /vXXX /pYY /noj /16 /b:xxxxx filename
  76.      /vXXX       - volume (0-100)
  77.         /pXX        - panning (right = XX, left = 15 - XX)
  78.     /noj        - disable backward position jumps in songlist
  79.         /16        - 16 bits playback (default is 8 bits)
  80.     /b:xxxxxx   - buffer size (default 8192; 16kb for 16 bits playback)
  81.     filename    - songlist or modfile
  82.  
  83. WARNING: If you run ultitext in an OS/2 window, CPU usage will go way up.
  84.      OS/2 textmode API is still 16 bits, which is probably responsible
  85.      for a great part of the extra overhead. (way to go IBM)
  86.      It's best to use PM UltiMOD when playing modules in the background.
  87. ********************************************************************************
  88. ********************************************************************************
  89. From now on UltiMOD stands for both the PM and textmode version. Only
  90. when the two version don't behave identically, a distinction is made between
  91. them.
  92. ********************************************************************************
  93. ********************************************************************************
  94.  
  95. ================================================================================
  96.    5  A few tips to make life easier
  97. ================================================================================
  98.  
  99. - To quickly construct songlists you can run UltiMOD as follows:
  100.     ultimod d:\mods\*.s3m d:\mods\*.mtm d:\mods\*.mod
  101.   By default ultimod saves all these filenames in '########.lst' in the
  102.   directory where ultimod is located.
  103.   To save this songlist, select file->save songlist. (PM UltiMOD)
  104.   Ultitext offers no help, so you must copy the songlist manually.
  105.  
  106. - When UltiMOD is running, you can launch a second copy of ultimod to
  107.   pass (a) new modfile(s) or a songlist to the first one.
  108.  
  109. - Next.exe is for command line freaks (like me) who don't like switching to
  110.   the desktop every time a boring modfile is playing, just to press the next 
  111.   button.
  112.   When executed, next.exe orders UltiMOD so skip to the next song in the
  113.   songlist.
  114.  
  115. ================================================================================
  116.    6  General Information
  117. ================================================================================
  118. Unlike UltiMOD for the GUS, UltiMOD for MMPM/2 is freeware. This means that
  119. the previously registered feature (settings saved in .ini file) works in this
  120. version.
  121. Although the GUS version has a higher priority for me, the shared codebase  
  122. (over 80% of the code) allows me to fix bugs in most parts at the same time 
  123. for both players.
  124.  
  125. Known problems:
  126.     - clicks 
  127.     - problems with some modules (i.e. inside.s3m)
  128.     - Messed up user interface (PM UltiMOD) when you run at 1024x768 
  129.       using S3 video cards (other cards too?). (driver or MMPM/2 bug) 
  130.     - uses too much CPU time
  131.  
  132. Future plans for UltiMOD:
  133.     - finishing support XM music files
  134.     - adding usefull suggestions from users to the program
  135.     - more WPS integration
  136.     - probably lots more. 
  137.  
  138. Finally I want to thank the beta testers for their extensive testing:
  139.     Anssi Saari        Olli Mannisto        Mark Ruys
  140.     John Rohland        Samuel Audet        Vince Rathbun
  141.     Juha Kauppinen        Kari Sorsimo        Harry Pulley
  142.  
  143.  
  144. Only when there's enough interest in the MMPM/2 version, I'll continue to
  145. enhance it. If you like UltiMOD, send me a postcard or something.
  146. (if you insist on sending me money, don't let me stop you)
  147.  
  148. One word of advice: if you think DART modplayers don't sound too good and
  149. suck up too much CPU time, buy a GUS and download the GUS version of UltiMOD.
  150. It sounds much better and is up to 10 times more efficient.
  151.         
  152. I hope you will enjoy UltiMOD,
  153.  
  154.             Sander van Leeuwen
  155.             Meikoninginlaan 4
  156.             2645 NT Delfgauw
  157.             the Netherlands
  158.             email: s509475@dutiwy.twi.tudelft.nl
  159.  
  160. For the latest updates of UltiMOD visit my webpage:
  161.     http://www.polsci.wvu.edu/Henry/Sander
  162.  
  163. Greets go to:
  164.     -  Culus of Ethos (thanks for your help with UltiMOD for MMPM/2)
  165.         -  Robert J. Manley for his Gravis UltraSound MMPM/2 driver
  166.     -  Timo Maier for the Pascal version of the GUS toolkit
  167.     -  Henry Rieke for providing me with a web page 
  168.     -  Osdorp Posse, Beastie Boys & Jimi Hendrix for making the 
  169.        countless hours behind my computer more bearable
  170.     -  Ajax, the one and only
  171.  
  172.  
  173. ================================================================================
  174.    7  Questions & Answers
  175. ================================================================================
  176. Q: When I start UltiMOD an error dialog pops up saying it couldn't load the
  177.    help manager. What's up?
  178. A: Be sure to have ultimod.exe and ultimod.hlp in one directory.
  179.    If you want to run ultimod from other directories, add the directory,
  180.    in which ultimod.hlp is located, to the line 'SET HELP =' in your config.sys.
  181. Q: What's wrong when UltiMOD reports it can't open the MMPM/2 driver?
  182. A: You shouldn't have Dos/WinOS2 sessions running that use your soundcard or
  183.    Close them and try again.
  184.  
  185. ================================================================================
  186.    8  Bug Reports
  187. ================================================================================
  188. If you experience crashes or bugs when you use UltiMOD, please send me mail
  189. (email or snail mail) explaining the problem along with the following filled
  190. in form and your config.sys. 
  191.  
  192. OS/2 version            : ______
  193.  
  194. Soundcard brand & model : ___
  195.  
  196. ================================================================================
  197.    9 How to help improving UltiMOD
  198. ================================================================================
  199. I and the beta testers try to locate any effect problems with UltiMOD.
  200. Unfortunately we don't have unlimited amounts of time, so it's possible 
  201. you have a modfile that UltiMOD doesn't play completely right.
  202. I'd appreciate it when you report these problems to me. Please provide
  203. as much information as possible:
  204.     - file (send uuencoded by email or an address of an ftp site)
  205.     - pattern and song position where the problem occurs
  206.     - if possible position inside pattern, channel and effect
  207.     - description of problem
  208.  
  209. Thanks in advance.
  210.  
  211. ================================================================================
  212.   10 Standard disclaimer
  213. ================================================================================
  214. This software is provided AS IS.  No warranty of any kind, expressed or
  215. implied, is granted including any warranties of quality or fitness for
  216. a particular purpose.  Under no circumstances will Sander van Leeuwen be held
  217. responsible for any damage that results directly or indirectly from the use of
  218. this product.