home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / mmpm2 / tracker / readme.os2 < prev    next >
Encoding:
Text File  |  1992-12-11  |  6.1 KB  |  144 lines
  1. Tracker/PM version 0.61 alpha
  2.  
  3. This program requires SBOS2.SYS- a soundblaster/soundblaster pro driver for
  4. OS/2 2.0.  It does NOT work with MMPM/2 (yet).
  5.  
  6. Installation:
  7.     all you need to run the program is the executable and the font
  8. (lcd.fon).  Just put them in the same directory and you're all set.
  9.  
  10. Make sure the font file LCD.FON is in the same directory as TRACKER.EXE, or
  11. the program will look crappy!
  12.   
  13. You may want to associate tracker.exe with file of type *.mod.  To do this
  14. you must create a program object for tracker.exe.  Then open the settings
  15. menu and go to the association notebook setting and add *.mod as a new name.
  16. Then whenever you double-click on a file in the workplace shell with a
  17. file-name extension of MOD, it will call up tracker.exe and play the song.
  18.  
  19. This MOD player has a long history, starting on Unix Machines and finally
  20. moving to OS/2.  It has been ported to work with Michael Fulbright's SBOS2.SYS,
  21. a soundblaster, soundblaster pro driver for OS/2 2.0.  In fact, he was the
  22. one who ported the code from Unix to OS/2.  (read the other readme files for
  23. more info on the original authors).
  24.  
  25. Anyway I have rewritten the player to run under OS/2 2.0 PM.  The command-
  26. line options are as follows:
  27.  
  28. tracker [-switches] [@cdfilename] [filename] [filename] ...
  29.  
  30.      -i: Iconic; start as an icon (currently not implemented)
  31.      -m: Mono; select single audio channel output
  32.      -s: Stereo; select dual audio channel output
  33.      -n: New; select new MOD type for mod playing
  34.      -o: Old; select old MOD type for mod playing
  35.      -b: Both; select both MOD types to try (default is -both)
  36.      -T: Terminate; terminate after playing all mods
  37.      -L: Low priority; sets tracker to normal low priority (default)
  38.      -M: Middle priority; sets tracker to "foregroundserver" priority
  39.      -H: Highest priority; sets tracker to "timecritical" priority
  40.   -dnum: DMA buffer size; set DMA buffer size in K.
  41.   -fnum: Frequency; sets playback frequency to <num> Hz.
  42.   -tnum: Transpose all notes up <num> half-steps
  43.   -rnum: Repeat; repeats <num> number of repeats (0 is forever) (default 1)
  44.   -Bnum: Blend; sets percent of channel mixing to <num>. (0=spatial, 100=mono)
  45.   -Onum: Oversample; set oversampling to <num> times.
  46.   -Snum: Speed; set song speed to <speed>.  Some songs want 60 (default 50)
  47.  
  48. Filenames which are preceded by an '@' sign are taken to be text files which
  49. contain a list of files to play.  For example you could put your favorite 
  50. mods in a list in a text file called "my.cd" and queue them all by typing
  51. "tracker @my.cd".  Actually you don't need the "@" sign if your cd file ends
  52. with the extension ".cd".  The ".MOD" extension is optional both on the
  53. command-line and in the cd files.  (the ".cd" extension is not optional, but
  54. if you want to specify a filename that does not end in ".cd" and contains the
  55. list of mod filenames to play, use the "@" prefix character).
  56.  
  57. The most important options are the priority options -M and -H.  I have a
  58. soundblaster pro and I usually don't use any other option other than -M or
  59. -H.  It will autodetect an SBpro and set stereo mode+etc.
  60.  
  61. You may want to set -T in a WPS program object in the command-line options
  62. so you can doubleclick on a mod file, have it play, and then terminate the
  63. mod player.
  64.  
  65. The controls are kind-of like a CD player, you can create a "virtual CD" by
  66. queueing a bunch of songs either on the command-line or using the "queue"
  67. button.  Then you can use the forward and backward buttons to skip around
  68. between songs.
  69.  
  70. Sometimes you have to wait for the current song to quit playing (just like a
  71. CD), because the program has to wait for the DMA buffers to be flushed.  If 
  72. you don't like the delay you can set the DMA buffers to a smaller value, but
  73. then it might not multitask as well (the music might get jumpy).
  74.  
  75. Also keys:
  76.      F1 - About Box (no equivalent button)
  77.      F3 - Queue song
  78.      F4 - Exit
  79.      F5 - Play
  80.      F6 - Pause
  81.      F7 - Stop
  82.      F8 - Restart current song (no equivalent button)
  83.      F9 - Next song
  84.     F10 - Previous song
  85.  
  86. This is a very early alpha-test version!  Please report all bugs to 
  87. David Nichols: you can contact me at the addresses at the bottom of the
  88. screen.
  89.  
  90.  
  91. New in 0.61 from 0.6
  92.     added icons on command buttons
  93.  
  94. New in 0.6 from 0.5:
  95.     dropped obsolete buttons and waveform windows
  96.     enhanced font, added play, pause, stop, etc. graphics
  97.     made it look a bit more like an audio component
  98.  
  99. New in 0.5 from 0.1:
  100.     ability to specify file list files (@cdfile, or filename.cd) on the
  101.         command-line
  102.     program remembers last drive and directory when loading MODs from
  103.         another disk
  104.     cleaned up some parts of MOD playing code
  105.     new windows/dialog boxes
  106.     added custom digital font
  107.  
  108. stuff to look for in next release (to do):
  109.     cleaner code
  110.     proper refreshing
  111.     faster response to certain actions
  112.     true asynchronous operation (no hogging input queue)
  113.     cool artsyfartsy bitmap for about box (need help on that one)
  114.  
  115. Known bugs: 
  116.     some windows do not refresh properly always
  117.     program terminates unexpectedly due to unknown bug.  This is very
  118.         rare (on my machine).  I think the GNU libc functions are
  119.         giving me problems in the multi-threading enviroment I have
  120.         implemented.  I have replaced many with OS/2 api calls,
  121.         most notably malloc with DosAllocMem, so the program uses a
  122.         LOT more memory than it needs right now (DosAllocMem
  123.         allocates a page at a time, 4096 bytes).
  124.     you can load multiple copies of the about box
  125.     time doesn't refresh correctly
  126.     time is inaccurate (may not fix this one- it's close enough for me)
  127.     can't queue .cd files from queue window
  128.     queue position indicator sometimes reports wrong number of files in
  129.         the queue
  130.  
  131. If you have any problems, look in the current directory for a file called
  132. "debug" and report the contents to me.  Thanks.
  133.  
  134. internet: davidn@cs.tamu.edu
  135. FidoNet: David Nichols 1:117/357 Net-One OS/2 BBS
  136.  
  137. note: my BBS Net One OS/2 BBS will go down Dec 16, 1992 and go back up
  138. in mid Jan, 1993.
  139.  
  140. The author of the SBOS2.SYS OS/2 sound driver and other sound utilities
  141. (Michael Fulbright) can be reached on the Internet as msf@as.arizona.edu
  142.  
  143. enjoy!
  144.