home *** CD-ROM | disk | FTP | other *** search
/ Amiga Computing 59 / ac059.adf / Utilities / PowerTracker.doc / PowerTracker.doc
Text File  |  1993-02-05  |  14KB  |  361 lines
  1.  
  2.              |
  3.             -+-              |                 |
  4.       |         |             -+-                   -+-
  5.      -+-                  _________   |   _____________      |     |
  6.   /\  |              /  ___   /\     /            /\                -+-
  7.  /  \                   /  _\_/  /  \   /            /  \         |
  8. / /\ \    /\      /\__ /   _____/   /\ /____     ___/   /\___       /\
  9. _/  \ \/\/  \    / __ /   /\    \  /\\ \   /    /\  \  /\\__ \    _/  \
  10.      \    /\ \  / /  /___/  \____\/  .\ \_/____/  \__\/  .\ \ \  / _/\ \    /
  11.       \/\/  \ \/ /   \   \  /\\  \\     .\\    \  /\. \\     \ \/ /   \ \  /
  12.     |         \  /     \___\/  .\   .      .\____\/  \   .     \  /  |  \ \/ /
  13.    -+-          \/       \   \\    .         \\      \\  .        \/  -+-  \  /
  14.     |            \\  .              .\   .                |    \/
  15.  
  16.                              PowerTracker v1.00
  17.  
  18.                      Copyright © 1992,1993 Wai Hung Liu
  19.                             All rights reserved.
  20.  
  21.  
  22.  
  23. Amiga Computing has distribution rights to this version for their coverdisk.
  24. Neither Amiga Computing or the author take any responsiblity for any loss of
  25. data in any form whatsoever through use of this program.  The program is all
  26. written by and copyright Wai Hung Liu except for Reqtools.library which is a
  27. freely distributable library written and copyrighted by Nico Francois.
  28. Reqtools.library is included in the PowerTracker package by the author.
  29.  
  30.  
  31.  
  32.  
  33.                              About PowerTracker
  34.                              ==================
  35. There have been numerous Tracker players since the phenomenen called
  36. SoundTracker changed Amiga music.  So why should you choose PowerTracker?
  37.  
  38.     o Small, compact 100% pure assembly code
  39.         o 2.0 style interface even on 1.2/1.3 machines
  40.     o Fully O/S legal
  41.     o Works on (tested) 1.3 upto 3.0+,  (not tested) 1.2.
  42.     o Stand alone program, no extra "players"
  43.     o Uses Reqtools.library (if available) for file requesters
  44.     o Can load PowerPacked modules
  45.     o Can save modules to disk
  46.     o Can be iconified
  47.     o Fully multitasking
  48.     o Loadable from WorkBench
  49.     o Uses a CIA interrupt
  50.     o Properly allocates the audio hardware
  51.     o Preferences
  52.     o CLI parameters
  53.     o and much more
  54.  
  55. PowerTracker is a versatile player with many different options.  Most
  56. importantly the program conforms to legal programming.  eg. There are no
  57. "hacks" to speed up the program, etc.  If you want to be able to use file
  58. requesters you must have "Reqtools.library" in your system LIBS: drawer.
  59. Reqtools.library also has a palette editor and this is used by PowerTracker.
  60. I did not use Arp.library as it is very old now, and Asl.library only works
  61. on Kickstart 2+ machines.  With Reqtools you can use it on all Amigas.
  62. I think that you will agree that this compromise will suit all users.
  63. Note that there are two versions of Reqtools.library.  One is ONLY for 2.0+
  64. machines, another for both 1.3 and 2.0+ machines.  Make sure you don't
  65. install the 2.0 library if you have a 1.3 machine!!  Vice versa has no
  66. problems.  Reqtools.library is a freely distributable library ©1991-1993
  67. by Nico Francois.  Nice one Nico - keep it up!
  68.  
  69. If you want to get in touch with the author of this program, Wai Hung Liu,
  70. write to the following address.  Any ideas, comments, bug reports (no!)
  71. would be appreciated.
  72.  
  73.         WH Liu (Simon),
  74.         (PowerTracker),
  75.         90 Terenure Road East,
  76.         Dublin 6,
  77.         Ireland.
  78.  
  79. If you need a personal reply please enclose a stamped addressed envelope.
  80.  
  81. I decided to write PowerTracker because no other player suited my own taste.
  82. Either they crashed when run from WorkBench, or would refuse to work when
  83. a library like ReqTools was absent.  PowerTracker avoids these problems
  84. and tries to be as user friendly as possible.  However caution must be taken
  85. when using PowerTracker and/or other music players.  Avoid trying to run both
  86. at the same time or loading the player twice (thereby launching two programs)
  87. because the results are wierd and unpredictable.  Just stick with one player
  88. at any one time and your system will run smoothly!  (Try PowerTracker  ;-)
  89.  
  90.  
  91.  
  92.  
  93.                              General information
  94.                              ===================
  95. PowerTracker uses the intuition library for full multitasking and opens
  96. it's own window.
  97.  
  98. Upon loading you will be met with gadgets and menus.  The main bar is
  99. for you to enter the name of a module to load or save.  The gadgets along
  100. the bottom operate different functions.  The menu has the same options as
  101. the gadgets with some extras.  If you look at the menu you can see that you
  102. can operate the program by special key combinations.  Do this by holding
  103. down "Right Amiga" and the corresponding key.
  104.  
  105. Currently PowerTracker will play tracker compatible modules.  This
  106. encompasses the following types:
  107.  
  108.     SoundTracker x.x
  109.     NoiseTracker x.x
  110.     ProTracker   1.0-2.1b
  111.     StarTrekker  (4 channels only)
  112.  
  113. Even if your tracker is not on this list the chances are that the music
  114. program is compatible so save some music and try loading it up.  Remember
  115. that this program will not play songs, but modules.  These are the songs
  116. saved as a single compact file.
  117.  
  118.  
  119.  
  120.  
  121.                              Basic Requirements
  122.                              ==================
  123.     The program is only limited by the amount of chip mem you have since
  124. modules are loaded into this memory.  If you do experience any memory
  125. problems then you should turn off external drives, or better still, buy a
  126. ram upgrade.  PowerTracker has been tested and found to work on machines
  127. with KickStart 1.3 upto 3.x and no memory problems were found.
  128.  
  129.  
  130.  
  131.  
  132.                               Loading from CLI
  133.                               ================
  134. PowerTracker can be run from the CLI and can handle one parameter.  This
  135. parameter is either a specified path or module name and is used as such:
  136.  
  137.     1> PowerTracker    [path/module]
  138.  
  139. In the prefs menu there is an option called Autoload.  This simply means
  140. that if a module is specified it will be automatically loaded and played.
  141. Even if the prefs file is not found, Autoload is a default function so the
  142. program will try and play the module.  Specifying a path is only useful
  143. if you have Reqtools.libary present.  If Autoload is on a requester will
  144. appear showing the contents of the specified device or directory.  For
  145. example if your modules are in the "Modules" directory of "MyDisk:" you
  146. would type:
  147.  
  148.     1> PowerTracker MyDisk:Modules/
  149.  
  150. and the directory would be listed.  You must end the path with either a
  151. ":" to denote a disk/device or "/" for a directory!  This is so that the
  152. program could still load a module called "Modules" and not confuse it
  153. with the directory.
  154.  
  155. If PowerTracker is not on your boot or system disk a requester may pop up
  156. asking for that disk.  This is because PowerTracker is looking for the
  157. prefs file.  You can click cancel if you want.  A second requester will
  158. appear, again asking for the boot disk.  This is because PowerTracker is
  159. looking for the Reqtools.library in the LIBS: drawer.  You can click cancel
  160. if you want, but if Reqtools is available it would be better to load it
  161. as then you can use the nice file requesters.
  162.  
  163.  
  164.  
  165.  
  166.                            Loading from WorkBench
  167.                            ======================
  168. This is even easier than loading from the CLI.  Simply double-click on the
  169. PowerTracker icon and the program will load.  If requesters pop up then it
  170. is for the same reason as shown above in the CLI loading section.
  171.  
  172. If you have a module on disk you can play it by adding PowerTracker as it's
  173. default tool.  Simply select the modules "Info" from the WorkBench menu,
  174. click in the default tool box, and type in exactly where PowerTracker is to
  175. be found.  For example if you have copied PowerTracker to your Utilities
  176. drawer on the WorkBench disk you would type in:
  177.  
  178.     WorkBench:Utilities/PowerTracker
  179.  
  180. Now if you click on the module's icon it will load PowerTracker and then be
  181. played.
  182.  
  183.  
  184.  
  185.  
  186.                               Program functions
  187.                               =================
  188.  
  189.                                    Gadgets
  190.                                    -------
  191. Below is an explanation of all of the gadgets.
  192.  
  193. STRING - You can enter the name of a module here if you find that
  194. Reqtools.library is unavailable.  Works the same way as if you had used the
  195. file requester.  Anything typed here will also be used in the file req.
  196.  
  197. PLAY - Plays the loaded module from the start.
  198.  
  199. CONT - Continue playing the module from the location it was stopped at.
  200.  
  201. STOP - Stop playing the module.
  202.  
  203. LOAD - Loads the specified module into memory.  If Reqtools is available
  204. then a requester pops up and you can choose the module to load from there.
  205. The requester is extremely easy to use.  To cancel loading just click on the
  206. Cancel button.  Modules can be crunched with PowerPacker.
  207.  
  208. SAVE - As "LOAD" gadget but the file specified will be saved.  (Decrunched)
  209.  
  210.  
  211.  
  212.                                 Menu Options
  213.                                 ------------
  214. Below is an explanation of the menu options.  You can use the keyboard
  215. combinations as shown by holding down the Right Amiga Key and the specified
  216. key.  For example, to get some info about the program press the Right Amiga
  217. key with "a".
  218.  
  219. PROJECT
  220. -------
  221. [a]    ABOUT   - A small window to display info about PowerTracker.
  222.  
  223. [t]    CLEAR    - If a module is in memory you have the option of wiping it.
  224.  
  225. [l]    LOAD... - Same as "LOAD" gadget.
  226.  
  227. [w]    SAVE... - Same as "SAVE" gadget.
  228.  
  229. [q]    QUIT    - Exit program
  230.  
  231. FUNCTION
  232. --------
  233. [p]    PLAY    - Play module
  234.  
  235. [c]    CONT    - Continue module
  236.  
  237. [s]    STOP    - Stop module
  238.  
  239. EXTRAS
  240. ------
  241. [u]    AUTOLOAD - When a filename is passed as a CLI parameter or from
  242.            WorkBench then the module will be immediately loaded and
  243.            played.  If a directory is passed a file requester will
  244.            open displaying the contents of it.
  245.  
  246. [f]    FILTER    - Toggle filter on or off
  247.  
  248. [i]    ICONIFY    - Toggle iconify on or off.  If on the program will shrink
  249.           into a small title bar, else it will revert to normal.
  250.  
  251. [m]    MOD.* ONLY - Toggle pattern on or off for file requesters.  If on
  252.              only files with a prefix of "mod.", the standard prefix
  253.              for music modules is shown.
  254.  
  255. [e]    EDIT PALETTE - Simple.  Lets you change the current screen colours.
  256.  
  257. [x]    SAVE PREFS - Saves your current preferences to disk.
  258.  
  259.  
  260.  
  261.  
  262.                                  Preferences
  263.                                  ===========
  264. The idea of having this option is to allow you to customise PowerTracker to
  265. your liking.  This way you can set it up to the right colours and module to
  266. start playing, etc.  When saving prefs, options that will be activated next
  267. time you run PowerTracker are the options in the Prefs menu that have a tick
  268. next to them.
  269.  
  270. AUTOLOAD   - As explained above.
  271. FILTER     - Sets the filter on/off when program run.
  272. ICONIFY    - If set on, the program will start in Iconified mode.
  273. MOD.* ONLY - If set on, all file requesters have the pattern on.
  274.  
  275. Current system colours are also saved so that next time PowerTracker is run
  276. your edited colours will be restored.
  277.  
  278. The prefs is saved to your SYS: directory (or boot disk/partition) as a
  279. small file called "Prefs.PT".  If PowerTracker can't find the file, that
  280. doesn't matter as the program will just default to it's original settings.
  281. The actual Prefs file is tiny at 12 bytes so you should have plenty of room
  282. for it either on disk or hard drive.
  283.  
  284.  
  285.  
  286.  
  287.                                Error messages
  288.                                ==============
  289. PowerTracker will inform you of any decisions you have to make or of any
  290. errors that might have occured.
  291.  
  292. "Cannot allocate audio hardware"
  293. --------------------------------
  294. This means that PowerTracker cannot take over the audio.device because
  295. another program is using it.  Make sure that no other music program is
  296. running as they may also want to use the audio.device.  Try pressing "Play"
  297. again and if it is free now the music will be played.  When you press
  298. "Stop" the audio.device will be freed by PowerTracker.  Because the program
  299. does not hog the aduio hardware it means you don't have to quit PowerTracker
  300. if you do want to load a music editor, etc.
  301.  
  302. "Error loading module"
  303. ----------------------
  304. An error occurred while trying to load your specified module.  Either it
  305. does not exist or the module itself has errors on it.
  306.  
  307. "Error saving module"
  308. ---------------------
  309. There was an error trying to save the current module in memory.  This can
  310. happen for many reasons eg. disk full, disk corrupt, or specified disk or
  311. path does not exist.
  312.  
  313. "Not enough chip memory"
  314. ------------------------
  315. This means that you do have enough memory to load your module into chip mem.
  316. Chip memory is the memory that the custom chips need so modules must be
  317. loaded into this memory.  Try freeing some other programs or resetting
  318. before trying again.  Memory can become fragmented and this is a common
  319. cause.
  320.  
  321. "Unrecognised module format"
  322. ----------------------------
  323. Your module was loaded correctly but are you sure the file is a tracker
  324. compatible module?  If it is it is most likely that the module is corrupt or
  325. you have used a new version of a music editor which is not supported.
  326.  
  327. "Error saving prefs"
  328. --------------------
  329. This disk will save the prefs onto your "SYS:" disk, or boot disk.  If it
  330. can't then this message pops up probably because you did not insert the
  331. correct disk or there is no space left on the disk.
  332.  
  333.  
  334.  
  335.  
  336.                               Acknowledgements
  337.                               ================
  338. Thanks must go to the following people:
  339.  
  340. Commodore     - For producing the best computer ever!
  341. Nico Francois     - Where would we be without you?!
  342. Gary Edmunds    - For fastest testing ever!
  343. Tony McNamee     - For bug-testing and ideas(?)
  344. Mike Cross     - Thanks for telling me I needed to create decent intuition
  345. interfaces.  By the way, ASM-One was used to assemble this...
  346.  
  347.  
  348.  
  349.  
  350.                                  Final Note
  351.                                  ==========
  352. Forthcoming products from the same programmer...
  353.  
  354. X-Play 0.2 will soon be updated with a few more replayers to enhance it.
  355. AMOS Cracker 0.5, to rip more banks depends on the availability of the new
  356. pro compiler.
  357. Magnum 1.4 will soon handle MED and tracker modules and will not require
  358. converting of modules.
  359. PowerMore, a new text viewer that can handle PP files and have many options.
  360.  
  361.