home *** CD-ROM | disk | FTP | other *** search
/ Falcon 030 Power 2 / F030_POWER2.iso / ST_STE / MAGS / ICTARI04.ARJ / ictari.04 / MISC / DTMT_STE / README.TXT < prev    next >
Text File  |  1993-05-23  |  14KB  |  352 lines
  1.  _______________________________________________      .__..
  2. |Program:       DeskTracker MultiTask           |    //_//|
  3. |Type:          Accessory                       |    || |||
  4. |Version:       s 1.03                          |    || ||/\_
  5. |Distribution:  Shareware                       |  _/ | | \_/|
  6. |System:        STe/TT/Falcon*;TOS/MultiTOS     | |__/|_|\__|/
  7. |               any screen rez*                 |
  8. |Last update:   18nd May 1993                   | /\¯T¯/\ |¯>|
  9. |Written by:    David Oakley, original tracker  |/¯¯\|/¯¯\| \|
  10. |               playing routine by WizCat       |
  11. |                                               |
  12. |Copyright ©1991 Wizzcat (Tracker player only), |
  13. |          ©1992,1993 ASTRAsoft                 |
  14. |                                               |
  15. |Purpose:       Play NoiseTracker modules in    |
  16. |               the background with animated    |
  17. |               graphic display of tune.        |
  18.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  19. Based on a NoiseTracker player routine written by Wizzcat in 1991, 
  20. DeskTracker and the current version (DeskTracker MT) are designed to play 
  21. MOD files on any machine with PCM sound chip.
  22.  
  23. NOTE: ON SOME MACHINES AND SETUPS THE COMPLICATED NATURE OF DESKTRACKER'S 
  24. MODULE PLAYER MAY CAUSE A CRASH IF EXPOSED TO TOO HEAVY WORKLOAD DURING 
  25. HIGH-SPEED PLAYBACK. EXPERIMENT FOR A WHILE BEFORE DOING IMPORTANT THINGS 
  26. WHILE RUNNING DTMT!!!!!
  27.  
  28.  __________________
  29. / Compatibility * /
  30. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  31. DeskTracker will only run on an ST compatible that supports Atari's PCM 
  32. sound which was first introduced on the STe. We have tested DtMt on an 
  33. 1040STe, Mega/STe 4 and a Falcon. On the Falcon we failed to get any 
  34. sound out, though DeskTracker reported that it was playing correctly. I 
  35. think it's something to do with setting up sound channels and you may be 
  36. able to do better(there is a patch available). DeskTracker has been 
  37. tested on a Mega/STe 4 running MultiTOS without memory protection, though 
  38. I cannot garrantee that it will run on an 030 version of MiNT.
  39.  
  40.  ____________
  41. / The files /
  42. ¯¯¯¯¯¯¯¯¯¯¯¯
  43. In this package (archive or folder) you should find the following files:
  44.  
  45.         DTMT.ACC        The GEM interface. Can also be run as a program.
  46.  
  47.         ATRAK.PRG       The Tracker module. Put in your AUTO folder or
  48.                         run before first accessing DTMT.ACC
  49.  
  50.         DTMT.INF        File to be put in the same directory as DTMT.ACC.
  51.                         Gives default path for file selector.
  52.  
  53.         DTMT.TXT        This file
  54.  
  55.         RUN_MOD.APP     For MultiTOS only! Install this with application 
  56.                         type .MOD and then double-clicking MOD files will 
  57.                         automatically add them to DTMT's memory list and 
  58.                         begin playing.
  59.  
  60.  __________________
  61. / Getting started /
  62. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  63. Just copy DTMTC.ACC into the root of your boot drive (e.g. A:\ or C:\),
  64. and ATRAK.PRG into your AUTO folder. Just in case you're wondering about 
  65. putting a new program in the AUTO folder of your hard drive, don't worry! 
  66. On first running, ATrak only sets itself up a Cookie and then stays 
  67. resident. It doesn't attempt to play any Tracker tunes!
  68.  
  69.  ____________
  70. / Operation /
  71. ¯¯¯¯¯¯¯¯¯¯¯¯
  72. DeskTracker is designed to work just like a real CD player. Well, it works
  73. like mine does. It has two main modes of operation: normal and memory.
  74. When in Memory mode, several of the buttons have different meanings, usually
  75. when no MOD is being played.
  76.  
  77. In the list below, shortcut keys are in square brackets (eg. [E] ).
  78.  
  79. Click on the menu item 'DeskTracker MT' in the File menu. The DeskTracker 
  80. window will appear:
  81.  
  82.  ________________________________________
  83. |X|         DeskTracker MT             |O|
  84. |----------------------------------------|
  85. |___________Version_1.00________|iii|~~~~|
  86. | ____ ____ ____  ____          ¯¯¯¯¯¯¯¯¯|
  87. || /\ | [] | |> || 00 |    ASTRAsoft  |06|
  88. ||====|====|====||----| ____ ____ ____|12|
  89. || << | || | >> ||<=> ||MEM |ADD |RAND|25|
  90. | ¯¯¯¯ ¯¯¯¯ ¯¯¯¯  ¯¯¯¯  ¯¯¯¯ ¯¯¯¯ ¯¯¯¯|50|
  91.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  92.  
  93. What the buttons do:
  94.  
  95. Button  Display  Description
  96.  
  97. Close            If in Accessory mode, closes the window but keep playing.
  98. [Undo]           If in Program mode, stops playing and quits the program.
  99.  
  100. Full             Iconises DeskTracker to a very small window. All keyboard
  101.                  shortcuts still work and operation continues as normal.
  102.                  Useful for MultiTOS.
  103.          ______
  104. Eject   |  /\  | Load and start a new NoiseTracker MODule. If you press
  105. [E]     |  ==  | Cancel on the fileselector then the current tune is
  106.          ¯¯¯¯¯¯  erased from memory and the memory is freed.
  107.          ______
  108. Stop    | |¯¯| | Stop the currently playing song, but don't erase it
  109. [S]     | |__| | from memory. Reset pointers to start of song.
  110.          ¯¯¯¯¯¯
  111.          ______
  112. Play    |  |\  | Play the current song from the current position. If any
  113. [Spc]   |  |/  | other program has stoped DeskTracker, this will restart
  114.          ¯¯¯¯¯¯  the tune from where it was stopped.
  115.         _______
  116. Pause  | |¯|¯| | Stop the currently playing song, but remember where
  117. [P]    | |_|_| | we were so play restarts from this point.
  118.         ¯¯¯¯¯¯¯
  119.          ______
  120. Rewind  | /|/| | Move the play position back by one section
  121. [->]    | \|\| |
  122.          ¯¯¯¯¯¯
  123.          ______
  124. Fast    | /|/| | Move the play position forward by one section
  125. Forward | \|\| |
  126. [<-]     ¯¯¯¯¯¯
  127.          ______
  128. Add to  | ADD  | Select a MOD file and add it to the end of the
  129. memory  |      | playlist
  130. [+]      ¯¯¯¯¯¯
  131.          ______
  132. Memory  | MEM  | Shown depressed when songs are in memory
  133. On      |      | Click to deselect and clear the memory 
  134. [M]      ¯¯¯¯¯¯
  135.          ______
  136. Repeat  | +->+ | Toggles whether the MOD file will repeat once it
  137. [R]     | +<-+ | has reached the end. DtMt will even trap those MOD
  138.          ¯¯¯¯¯¯  files which will normally always loop!
  139.          ______
  140. Oscillo |\/\/\/| Opens the oscilloscope window.
  141. [O]      ¯¯¯¯¯¯
  142.          ______
  143. Anim    |IIIIII| Opens the animation window and then toggles between
  144. [A]      ¯¯¯¯¯¯  the three representations.
  145.            __
  146. Frequency |06|   These buttons select what the output frequency
  147. Selectors |12|   of the player is through the STe's PCM sound
  148. [1..4]    |25|   generator. Higher frequency means better quality
  149.           |50|   but more processor time. 50 will lock an 8MHz
  150.            ¯¯    computer!!!
  151.  
  152.  _____________
  153. | Memory Mode |
  154.  ¯¯¯¯¯¯¯¯¯¯¯¯¯
  155. Once the ADD function has been used to move into Memory mode, several of 
  156. the buttons change:
  157.  
  158. Button  Display  Description
  159.          ______
  160. Eject   |  /\  | Stops and unloads the current song, and resets to
  161. [E]     |  ==  | the start of the playlist.
  162.          ¯¯¯¯¯¯  
  163.          ______
  164. Stop    | |¯¯| | Stops and unloads the currently playing song.
  165. [S]     | |__| | 
  166.          ¯¯¯¯¯¯
  167.          ______
  168. Play    |  |\  | Plays the current song from the current position.
  169. [Spc]   |  |/  | Loads the current song if it is not in memory.
  170.          ¯¯¯¯¯¯  
  171.         _______
  172. Pause  | |¯|¯| | Stop the currently playing song, but remember where
  173. [P]    | |_|_| | we were so play restarts from this point.
  174.         ¯¯¯¯¯¯¯
  175.          ______
  176. Rewind  | /|/| | Rewind through the current song if PLAYing
  177. [<-]    | \|\| | or move to the previous song in the playlist.
  178.          ¯¯¯¯¯¯
  179.          ______
  180. Fast    | /|/| | Speed forward through the current song if PLAYing
  181. Forward | \|\| | or move to the next song in the playlist.
  182. [<-]     ¯¯¯¯¯¯
  183.          ______
  184. Repeat  | +->+ | Toggles whether the playlist will repeat once all
  185. [R]     | +<-+ | songs have been played. Songs will never repeat when
  186.          ¯¯¯¯¯¯  in Memory mode.
  187.          ______
  188. Random  | RAND | Play items in the playlist in a random order. Currently
  189. play    |      | tracks may repeated before all tracks have played.
  190.          ¯¯¯¯¯¯  Effectively turns on Repeat mode.
  191.  
  192.  ______________________
  193. / DeskTracker History /
  194. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  195.  
  196. The core song player in DeskTracker is based on Replay STe, a Tracker
  197. player written by Wizzcat in May 1991. Work on the GEM interface 
  198. began in April '92 when I got my Mega/STE... a working version of it
  199. was completed in three weeks!
  200.  
  201. DeskTracker was written in GFABASIC 3.5 and provided a dialog box interface,
  202. but it did look quite like the version you see here. After a year of work
  203. I've added a lot and refined a lot. Don't be deceived by its relatively
  204. small size - I'd call it finely chizelled artwork!
  205.  
  206. This version is written in Lattice C 5.52 and DevPac 2. I really do recommend
  207. Lattice to anyone who is serious about Atari software production in the
  208. future... if Atari Corp use it I'd say that's a pretty good guarantee of
  209. its longevity.
  210.  
  211.  
  212. The major changes to the original program were:
  213.  
  214.   o  conversion of DeskTracker into a window
  215.      (when it became DeskTracker MT),
  216.      
  217.   o  moving the animation bars into a separate window,
  218.   
  219.   o  adding memory functions, 
  220.   
  221.   o  allowing the user to change play frequency at any time
  222.   
  223.   o  DtMt can read in ICE packed MOD files as created by using the DATA
  224.      pack in JAM Packer 4.0
  225.      
  226.   o  Load and decompress a new song while the previous one is playing
  227.   
  228.   o  Realtime oscilloscope in a GEM window
  229.   
  230.   o  Information bar
  231.   
  232.   o  Iconise DtMt by clicking on the Full-box
  233.   
  234.   o  Load old 15-sample type MOD files
  235.  
  236.  ___________________
  237. / Revision History /
  238. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  239. Date            Version Comments
  240. 26/04/93        1.00    First released version
  241. 28/04/93        1.01    ACC now installs correctly;
  242.                                 animation bars didn't run(fixed);
  243.                                 alert informing user that Trak wasn't 
  244.                                 running
  245. 05/05/93        1.02    Now runs under MultiTOS and is compatible with 
  246.                         RUN_MOD.APP (see separate file)
  247.  
  248. 18/05/93        1.03    If DT finds a DTMT.INF file (usually in the root 
  249.                         of A:\ or C:\ then the contents provides the 
  250.                         default directory. Lower memory usage
  251.  
  252.  _____________________________________
  253. / And the thanks and hellos go to... /
  254. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  255.  People who helped in the development of the DeskTracker project
  256.  (whether they knew it or not...!)
  257.  
  258.  Fozz, R.T.D., Had, Ian R., Wizzcat, 4-mat, U4ia
  259.  
  260.  And the hello list in alphabetical order...
  261.  
  262.  Ant, Andy-O., Eric Smith, Fez(and his amazing technicolour hair), Fozz,
  263. Had(we didn't start the Fire!), Ictari, Ian Rae, Jase, Kev, Mike Goodman, 
  264. Ian Skidmore, Paul Steptoe, RTD, Shaunie(someone's got to support Derby 
  265. County), Stephe, Stevie, U4ia, 4-mat(I'm an all-time fan of that song!)
  266.  
  267. several of whom own Amigas, though it's not really their fault.
  268.  
  269.  ______________________
  270. / Contact the author! /
  271. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  272. I'd like to hear from you whether you've found a bug, can suggest any
  273. improvements or just plain like the program. I'd especially apreciate
  274. it even if you just send me a postcard! I'll try to reply to any mail I
  275. get.
  276.  
  277. By email...
  278.  
  279. Send mail to me at             D.Oakley-SE1@cs.bham.ac.uk
  280. or after July 93 try           D.Oakley%uk.ac.icl.wins.kid0112@pipex.co.uk
  281.  
  282. or send your mail to Graham Harrision at:
  283.                                u2e32@uk.ac.kl.seq1
  284.  
  285. if you're sending mail from abroad you may need to go via a gateway.
  286. Ask your system administrator for info.
  287.  
  288.  
  289. By post...                      or
  290.  
  291. David Oakley                    Graham Harrison
  292. 6 Watlands Road                 353 Heathcote Road
  293. Bignall End                     Halmerend
  294. Stoke On Trent ST7 8QQ          Stoke On Trent ST7 8BH
  295. England                         England
  296.  
  297.   ___________________
  298.  / This program is  /
  299. /    SHAREWARE!    /
  300. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  301. DeskTracker has taken a lot of work by an overstressed university student!
  302. If you like this program, please do send a donation. If it is £5 UK sterling
  303. or more, I will send you the latest version of DeskTracker, plus some other
  304. ASTRAsoft things. Please don't expect an immediate reply though!
  305.  
  306. The registered version of DeskTracker will soon include support for Amiga 
  307. MED files and possibly soon OctaMED (8-channels!) files. Hopefully coming 
  308. in the summer will be a full GEM based MOD/MED editor - this will 
  309. probably offered to the public at £10 (sterling) but will be reduced for 
  310. existing DeskTracker registered users.
  311.  
  312. Also if you register, I'll send details of how to use the Trak player in 
  313. your own C (or possibly GFA if I get round to it) programs!
  314.  
  315. Please make all cheques payable to David Oakley and in sterling only. 
  316. For international registrations, travellers cheques are preferable. When
  317. registering please state which model of Atari you have and which monitor
  318. you use. ASTRAsoft do quite a few mono only things, so do mention it.
  319.  
  320.   ________________
  321.  / Warranty Free /
  322.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  323. Sorry, but this software comes with absolutely no warranty, other than 
  324. that enforced by law in your country. ASTRAsoft takes no responsability 
  325. as to the suitability of use of this software on your system or in your 
  326. particular circumstances.
  327.  
  328. The author is not responsible for any damages that may occur as a result 
  329. of use or missuse of this software, or inaccuracies in this manual.
  330.  
  331.   _________________________
  332.  / A Note to Distributors /
  333.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  334. Please do not include this disk on any Public Domain/Shareware library 
  335. disk without the explicit permission of ASTRAsoft. We like to ensure that 
  336. libraries have the most up-to-date versions of our products and so if you 
  337. let one of us know we'll send you the latest versions as they come out. 
  338. Send a letter by post or email explaining who you are, what your address 
  339. is and which products you have got at the moment. We will then send you a 
  340. reply by either of these means... once that has happened you can put it 
  341. on a disk!
  342.  
  343. Formally, DeskTracker or any other ASTRAsoft SHAREWARE product may not be 
  344. included on any PD/shareware library disk or magazine cover disk without 
  345. the permission of the ASTRAsoft partnership.
  346.  
  347.  
  348. See ya!
  349.  
  350. David.
  351.  
  352.