home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / miscprog / trkmt18 / trakmast.doc < prev    next >
Text File  |  1991-08-07  |  18KB  |  386 lines
  1. *----------------------------------------------------------------------------*
  2.  
  3. Quick Reference for TRAKMaster
  4.  
  5.  
  6. This program will look in ZIP or LZH files (depending on your config
  7. file) for MOD (or other extension) files, and play them from the
  8. archive.  It also allows the tagging of MOD (or other extension) files
  9. for longer playing...
  10.  
  11. F10, ESC, Ctrl-Q - Quits
  12. [SPACE BAR] - Tags selection
  13. [Return] - Plays selection or all selections
  14. Arrow Keys - Move cursor
  15. PgUp / PgDn - goes up or down a page respectively.
  16. Home / End - goes to the first file or last file respectively
  17.  
  18. F1 - Utilities / Help
  19. F2 - Change Directory
  20. F3 - New Extension
  21. F4 - Delete file (from LZH or uncompressed)
  22. F5 - Sort file listing
  23.  
  24. Mouse Users :
  25.  
  26. Use the mouse pointer to move, and press the left button to play, and
  27. right button to tag.  Press both buttons to quit.  If you have a three
  28. button mouse, press the middle button to enter the utilities menu.  You can
  29. also move the pointer down to the words "Utilities / Help" or "Quit" to
  30. enter the utilities menu or quit, respectively.
  31.  
  32. *----------------------------------------------------------------------------*
  33.  
  34. Quick starting for TRAKMaster
  35.  
  36. Change the CFG file to reflect the directory where you store PKZIP, PKUNZIP,
  37. LHArc, and ARJ.  Type TRAKMAST to run...
  38.  
  39. *----------------------------------------------------------------------------*
  40.  
  41.  
  42.  
  43.                TRAKMaster - Front End for TRAKBlaster v1.8
  44.                              by Joy Mukherjee
  45.  
  46.     This front end for TRAKBlaster has been tested with version 1.4 and
  47. version 2.0 of TRAK.EXE.  I don't guarantee this program to work, but it
  48. does on my system...
  49.  
  50. ---> Update info :
  51.  
  52. v1.8 - Added support for ARJ, a increasingly popular compressor.  First
  53.         SHAREWARE release.
  54.  
  55. v1.7 - Added support for swapping to disk or EMS.  Also fixed a few bugs 
  56.         when you had a list that was evenly divisible by 5.  PgDn was 
  57.         updated so when you hit PgDn onto an empty slot, it will take 
  58.         you to the last entry.
  59.  
  60. v1.6 - Added support for deleting from ZIP files.  Consolidated the CFG
  61.         files into one big TRAKMAST.CFG.
  62.  
  63. v1.5 - Added support for over 2000 files!  Takes up alot of memory.
  64.         Added "delete" file, and "sort" the listing options.
  65.  
  66. v1.4 - Fixed a couple bugs, not really released.  Added utilities menu.
  67.  
  68. v1.3 - Made support for all formats, not just MODS.  Has been tested
  69.         with VOC and MOD and FLI.  Added "Switch CFG file command"
  70.  
  71. v1.2 - Added support for LZH files for those who prefer that format.
  72.         Also updated the mouse to change directories and/or quit.
  73.         Renamed program.
  74.  
  75. v1.1 - Aggh!  Included the wrong EXE file with the previous version.
  76.         This one should work a lot better.  Apparently, it was having
  77.         problems redirecting the output to a file.  Also fixed the mouse
  78.         problem when using both the keyboard and the mouse.
  79.  
  80. v1.0 - Initial release.  Really messed up...
  81.  
  82.  
  83. --->  What is it???
  84.  
  85.     TRAKMaster is made for use with a Sound Blaster by Creative Labs, and
  86. the program TRAKBlaster (TRAK.EXE).  TRAKBlaster allows you to play the
  87. AMIGA MOD files on your PC-AT equipped with a Sound Blaster card.
  88. TRAK.EXE is not included with this package but is available worldwide
  89. including the boards at the bottom of this list.  TRAKBlaster, although
  90. great, leaves a great deal to be desired when it comes to user
  91. friendliness.  If you type in TRAK.EXE without any parameters, your
  92. computer will freeze.  If you spell the MOD file wrong, it lets you know
  93. in German that it can't find the file.  This program will avoid any of
  94. these headaches, and add a few new features as well...  With this
  95. program, playing a MOD file is a click of a mouse button away, or the
  96. click of a few arrow keys and the almighty [RETURN] key.
  97.  
  98. ---> What it does...
  99.  
  100.     This program is meant to be put in the directory with the majority
  101. of your MOD files.  From there it will allow you to select a MOD file to
  102. play by the use of a menu.  The highlighted name shows what file the
  103. cursor is on.  Move the cursor around with the arrow keys (Up Arrow,
  104. Left Arrow, Right Arrow, Down Arrow, Home, End, Ctrl-Left-Arrow, and
  105. Ctrl-Right-Arrow), or use the Mouse to move the small cursor over to a
  106. name.  When you are on the MOD file you wish to play, press [RETURN] or
  107. click the Left Mouse Button to play the file.  When you are done playing
  108. the files you wish to play, simply press ESC (or F10, or CTRL-Q) to
  109. quit.  Mouse users can press both buttons if they wish to quit.  If you
  110. wish to switch directories, press F1 and it will let you type in the
  111. directory to which you wish to change.  If you have three buttons on
  112. your mouse, such as Logitech's, you can use the middle button to enter
  113. the utilities menu.
  114.  
  115. ---> The beauty of the program...
  116.  
  117.     MOD files include their own instruments, as well as a great musical
  118. piece; however, these files are very large.  PKZIP'ing these files
  119. usually cuts down the size of the files by 30%.  LZH'ing them reduces
  120. them even further.  ARJ might even be able to beat that!  TRAKMaster 
  121. will search all the ZIP (ARJ or LZH) files in the current directory, and
  122. allow you to play a file directly from the archive. No longer will you 
  123. have to leave all your MOD (or other extension) files unarchived in the 
  124. directory to play them.  Just compress each one seperately, or put them 
  125. all in one big archvive to make them work. My MOD collection is one big 
  126. two meg ZIP, and it works perfectly.  You can tell if a file is 
  127. compressed if the filename is in green. If it is, the file is 
  128. compressed, otherwise, it isn't... Furthermore, you no longer have to 
  129. play the files one at a time, you can tag each selection you wish to 
  130. play by pressing the SPACE BAR.  A red star will appear by the name.  
  131. All the selections will be played by their order on the screen.  
  132. Pressing the SPACE BAR again will untag a file.  For mouse users, the 
  133. right mouse button will also enable you to tag/untag a file.
  134.  
  135. ---> How it does it...
  136.  
  137.     The program uses PKUNZIP (ARJ or LHA) to extract the files, and then 
  138. plays them with the use of TRAK.EXE.  When you are finished, it deletes 
  139. them.  On a fast computer, extracting doesn't take a great deal of time, 
  140. and is done before you know it.  It is your responsibility to zip them 
  141. up however...
  142.  
  143. ---> Using TRAKMaster
  144.  
  145.     You MUST create a TRAKMAST.CFG with your own text editor.  A sample
  146. TRAKMAST.CFG is included.  Making one is simple, though!  Just create a
  147. small text file which has the place where TRAKMAST can find PKZIP.EXE,
  148. PKUNZIP.EXE, LHA.EXE and ARJ.EXE.   You must also supply the path and 
  149. the name of the program! Even if you don't use one of these program, 
  150. supply something (a VALID filename, however).  The first line is the 
  151. location of PKZIP, and the second line is for PKUNZIP, and the next line 
  152. has any parameters which you may wish to use for PKUNZIP. The fourth 
  153. line is the location of LHA.EXE, and the fifth line has the parameters 
  154. for LHA. Next, put the location of ARJ.EXE on the sixth line, and on the 
  155. seventh, place any parameters (such as e) you might need.  Normally, 
  156. PKUNZIP does not require any, but LHA.EXE does (an 'e' or an 'x').  The 
  157. next line has the file extension you wish to look for in the ZIP or LZH 
  158. files.  You can use anything depending on what kind of file you wish to 
  159. use.  If you are using this program for MOD files only, type MOD on this 
  160. line.  If you are unsure, type MOD anyway.  For further uses of this 
  161. line, see the end of this document. The next line is the default 
  162. directory where those files are kept.  In other words, you might keep 
  163. all your MODS in a directory called \TRAK, and all your VOCS in a 
  164. directory called \VOCS. Put the directory in which most of your MODS (or 
  165. whatever extension) are kept.
  166.  
  167. You can create a .CFG file with DOS using the "copy con" command.  Do
  168. this as follows :
  169.  
  170.         copy con TRAKMAST.CFG   [return]
  171.         \DOS\PKZIP.EXE          [return]
  172.         \DOS\PKUNZIP.EXE        [return]
  173.         <blank line>            [return]
  174.         \DOS\LHA.EXE            [return]
  175.         e                       [return]
  176.         \DOS\ARJ.EXE            [return]
  177.         e                       [return]
  178.         MOD                     [return]
  179.         C:\TRAK
  180.         ^Z (or F6 or Ctrl-Z)    [return]
  181.  
  182. Replace the "\DOS" with your own directory where you keep the files
  183. PKUNZIP.EXE, and LHA.EXE.  When you have done this, it should say "1 file
  184. copied."  That's relatively painless, eh?  Next, you must edit the
  185. MODPLAY.BAT file. MODPLAY.BAT has simply the following : where it can find
  186. TRAK.EXE and a %1.  An example one is included.  Just put the path of
  187. the file in front of the name and then put a space, and a "%1" after it,
  188. and the MODPLAY.BAT is finished.  When you have done that, make sure the
  189. following files are in the same directory :
  190.  
  191.         TRAKMAST.EXE
  192.         TRAKMAST.CFG
  193.         MODPLAY.BAT
  194.  
  195. All those will enable the smooth operation of this program.  When you
  196. have completed all these steps, just type TRAKMAST to run the program, and
  197. start playing away...
  198.  
  199. --->  New cool features
  200.  
  201.     If you hit F1, you will get into the utilities menu.  From there,
  202. you have six options.  Pressing F1 (or moving the cursor there) will
  203. give you the help screen if you get confused.  F2 (from the utilities
  204. menu, or the main screen) will enable you to change directories.  When
  205. you change directories, it will switch to that directory and clear all
  206. the current files.  F3 will load a new config file.  Two are provided
  207. with this program.  Be sure they are correct, i.e. the file names and
  208. path names are correct or else this program will never work.  F4 must be
  209. used with care.  It will delete the file the cursor is currently on.  Be
  210. careful, if the file is in an LZH or a ZIP, it is completely
  211. unrecoverable.  It will prompt you before deleting however.  This
  212. feature is useful when you get a bogus file or you have a duplicate.  F5
  213. sorts the listing. The sort is in alphabetical order, and this feature
  214. can be very useful when trying to eliminate duplicates or when trying to
  215. find a particular file.
  216.  
  217. --->  Contacting me...
  218.  
  219.     Hopefully, you found this program of use and bug free, but if not,
  220. or you have a suggestion, please contact me on one of the following
  221. BBS's, or write to me at the address given at the end of this document :
  222.  
  223.  
  224. Nul BBS - 512-692-0730 - 500 megs running RBBS.  Excellent board, with a
  225.     large file base, and a quarter of a million echos.  Absolutely free!
  226.     File Requests allowed - 387/255.
  227.     Sysop - Jan Maaskant
  228.  
  229. Picture Express - 512-666-4842 - PC-BOARD 14.3 beta - Specializes in
  230.     Graphics and anything having to do with them.  He also has an Adlib
  231.     conference which is the best place to get ahold of me.  Join
  232.     conference #2 to get in, and you can also check out his hundreds of
  233.     ROL files.  All sound cards are supported here as well.
  234.     Sysop - David Steward
  235.  
  236.  The Bard's Lair - 718-381-3651 - 1.8 gigabytes running ProDoor 3.42 -
  237.     Specializes in Graphics, SoundBlaster, and Programming files.  This
  238.     is the United States' largest SoundBlaster support BBS.  You can reach
  239.     me through the SoundCard conference in conference #1.
  240.     Sysop - David Navarro
  241.  
  242. ---> Tech Notes
  243.  
  244.     This program was written on a 386/25 with a Sound Blaster Card, and
  245. a fairly fast hard drive.  The program didn't seem too slow on my
  246. computer, but then again, 25 mhz isn't too bad.  I programmed this in
  247. Turbo Pascal 5.5 and utilized quite extensively the Turbo Technojocks
  248. Toolbox v5.0.  Its really a great package, I recommend it highly.  All
  249. the windowing, inputting, screen writing was written using it.  I also 
  250. used something by Turbo Power Software which allowed me to swap to EMS 
  251. or disk inside a window.  The reason for the .BAT file is TRAKBlaster is
  252. somewhat unorthodox on what it does to the memory, so DOS is needed to 
  253. run the program.
  254.  
  255. ---> Kudos, Legal BS...
  256.  
  257.     I wish to thank all the people who helped with this program, namely
  258. Fred Hewit, Chris Tio, Greg Collins and all the people who release
  259. source code into the public domain, including many of the people in the
  260. Pascal Echo whose names escape me...  I also wish to thank the sysops of
  261. the their above boards for their very lenient ratios.  :-)  They are
  262. really good boards, call them now.  All are in San Antonio, TX.
  263.  
  264. Lawyers, take note :
  265.  
  266.     Sound Blaster is a registered trademark of Creative Labs, Inc.
  267.     Turbo Techonojocks Toolkit is copyright by Technojock Software.
  268.     Turbo Pascal is copyright by Borland Intl.
  269.  
  270.     This program here is essentially public domain, and is offered as
  271. is, without warranties of any kind.  By using this program, you agree
  272. that the author is in no way responsible for any damage done by this
  273. program.  Simple.  Anything that happens isn't my fault.
  274.  
  275.                                                 Enjoy!
  276.  
  277. ---> Notes on why the ZIP and MOD are now configurable
  278.  
  279.     More people now prefer the LHA205 or the ARJ210 format as the 
  280. compression is indeed tighter.  Furthermore, the extraction is just as 
  281. fast (or maybe a little slower) as PKUNZIP.  The MOD is configurable in 
  282. case you wish to use this program with VOC's, ROL's, CMF's, STM's, or 
  283. anything else you can think of.  Although this program was made for 
  284. MOD's, it should work with anything.  You may continue adding extensions 
  285. until you run out of room.  No guarantees though...
  286.  
  287. Example :  (to make the program use VOC files)
  288.  
  289.     Edit your TRAKMAST.CFG file and at the end of the document add the
  290. EXTENSION you wish to use.  In this case, "VOC".  Next, add the
  291. directory where all the VOC files are kept.  For example, 'C:\VOCS'.
  292.  
  293.     Your VOCPLAY.BAT file will look like this :
  294.  
  295.         VPLAY %1
  296.  
  297.  
  298. That's it!!  Everything else should work as planned...
  299.  
  300. --->  Naming conventions
  301.  
  302.     To make a new extension work with this program, you must make a
  303. batch file with the name ???PLAY.BAT.  Needless to say, replace the ???
  304. with your own extension.  Consult your DOS manual on the making of batch
  305. files.  If you do not understand this feature, feel free to contact me
  306. or not use it.
  307.  
  308.  
  309. --->  Added helpful feature
  310.  
  311.     If you wish TRAKMaster to look in a specific directory for the CFG
  312. files, and BAT files, you can make TRAKMaster do it by specifying the
  313. directory on the command line.  For example :
  314.  
  315.         TRAKMAST \UTIL
  316.  
  317.     This will instruct TRAKMaster to look into the \UTIL directory for
  318. any CFG files and it will give me a list to choose from that directory.
  319. I made a batch file called TM.BAT and put it in my path along with all
  320. my CFG file, BAT files and TRAKMAST.EXE, so I can just type TM from
  321. anywhere and play all the stuff I want.  Give it a shot, it seems to
  322. work...
  323.  
  324. --->  Tested extensions
  325.  
  326.     These are but a few of the many extensions possible with this
  327. program.  The Command Line Player is given for those who might be
  328. interested, including the latest version that I have.  Feel free to tell
  329. me any other you can get or make work with this program.
  330.  
  331.  
  332.     MOD - Duh!  Amiga Modules for Sound Blaster
  333.             Command line player => TRAK.EXE  (v2.0)
  334.     VOC - Sound Blaster Voice Files
  335.             Command line player => VPLAY.EXE (v1.5)
  336.     STM - Scream Tracker Module player
  337.             Command line player => STM.EXE (v2.2)
  338.     FLI - Autodesk Animator animation files
  339.             Command line player => AAPLAY.EXE
  340.     ROL - AdLib music files
  341.             Command line player => PLAYROL.EXE (v1.2)
  342.     CMS - Game Blaster music files
  343.             Command line player => PLAYCMF.EXE (v1.01)
  344.     CMF - Sound Blaster music files
  345.             Command line player => PLAYCMF.EXE (v1.01)
  346.     GL  - GRASP movies
  347.             Command line player => GRASPRT.EXE
  348.  
  349.  
  350. --->  CONVERT.EXE usage
  351.  
  352.     CONVERT.EXE is a simple little utility that I wrote to convert all
  353. the other small TM*.CFG files into the one TRAKMAST.CFG file.  Just copy
  354. it into the directory with all the other TM*.CFG and type CONVERT.  It
  355. will ask you for the NAME and PATH of PKZIP.EXE.  You must specify an
  356. actual filename.  For example : C:\UTIL\ZIP.EXE is a valid name.  After
  357. that, it should go O.K.  Good luck...  This is only good if you are 
  358. moving from versions 1.6 or lower to one of the newer versions.
  359.  
  360.  
  361. --->  Shareware!
  362.  
  363.     SHAREWARE means you try the program before you buy it.  If you like 
  364. and use the program, you are asked to pay for it.  No one is forcing 
  365. your hand at paying for it, but your conscious will bother you for the 
  366. rest of your life if you choose not to....  I am not a rich person, and 
  367. enjoy programming, but in order to pay the bills, a monetary 
  368. contribution of $20.00 or more would be most appreciated.  $20 is not a 
  369. great deal of money to pay for a program, and if you use it as often as 
  370. I do, it should be well worth the money.  Send your contribution to :
  371.  
  372.                 Mr. Joy Mukherjee
  373.                 202 Vanderheck
  374.                 San Antonio, TX, 78209
  375.  
  376.     Any correspondance as well can be forwarded to this address, and 
  377. would appreciate any bug reports or innovative uses of this program.  
  378. Thank you for your support...  Incidently, in no way is your copy of 
  379. this program crippled in any way.  Your version of the program is 
  380. exactly the same as mine, and all the versions before this were 
  381. completely free, but I have spent a great deal of time on this program, 
  382. so I felt compelled to see if I could get some return back on it.
  383.  
  384. --END--
  385.  
  386.