home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / sound / tapedeck_1 / !TapeDeck / !Help < prev    next >
Text File  |  1996-09-02  |  11KB  |  270 lines
  1. TapeDeck v1.50
  2. ==============
  3.  
  4. by JJF
  5.  
  6.  
  7.  
  8. THIS IS A SHAREWARE PROGRAM!
  9.  
  10. Well, that says it all.  This is the unregistered demo version of TapeDeck,
  11. and exhibits all the features of the full version except that you are not
  12. permitted to load and save index files.  To obtain the full version and
  13. become a registered user of TapeDeck, simply send three UK pounds (in
  14. cheque or postal order payable to "J.Farmer", or postage stamps) and a
  15. blank, formatted floppy to the following address :
  16.  
  17.   James J. Farmer,
  18.   49, Hollyberry Close,
  19.   Winyates Green,
  20.   Redditch,
  21.   Worcestershire,
  22.   B98 OQT,
  23.   United Kingdom.
  24.  
  25. Registered users are entitled to free updates of TapeDeck, should any new
  26. versions become available.  If you have an Email address, please tell me
  27. about it so that I can tell you when any future versions appear.
  28.  
  29.  
  30. CONTACTING THE AUTHOR
  31.  
  32. I will be happy to hear any suggestions anyone has, any ideas, or has found
  33. any new bugs in TapeDeck, then I can be contacted by the following means :
  34.  
  35. Email: jjf@zetnet.co.uk
  36.        jjf@cs.bham.ac.uk  (until June 1997)
  37.  
  38. Snailmail: James J. Farmer,
  39.            49, Hollyberry Close,
  40.            Winyates Green,
  41.            Redditch,
  42.            Worcestershire,
  43.            B98 OQT,
  44.            United Kingdom.
  45.  
  46.  
  47.  
  48. INTRODUCTION
  49.  
  50. Trackers, Soundtrackers, Protrackers, Coconizers, Digital Symphonies - all
  51. are extremely music files on the Acorn platform, and there are many (neigh,
  52. many many) different applications that can be used to play them.  TapeDeck
  53. is another such program.  So what makes it different from all the others?
  54.  
  55. TapeDeck is, unlike most music players, a complete music indexing system
  56. (say, I like the sound of that!), designed to help you not only to play
  57. Trackers, Soundtrackers, Coconizers, etc., but to keep track of all of these
  58. tunes, which are no doubt spread over myriad floppy discs and hidden in the
  59. deepest, darkest, dustiest recesses of your hard disc.
  60.  
  61. Or, to put it another way, TapeDeck indexes your trackers and plays them.  It's
  62. as simple as that.
  63.  
  64.  
  65. HOW TO USE IT
  66.  
  67. To run TapeDeck just double-click on it's icon and it will install on the
  68. iconbar in the standard way.  Click SELECT on the iconbar icon and two windows
  69. will pop up; the "TapeDeck Control" window and the "Current List" window.
  70.  
  71. I will explain...
  72.  
  73. TapeDeck works by maintaining a number of "tune lists", each of which can
  74. contain up to 999 tunes.  When you drag a tunefile (ie a Tracker, Digital
  75. Symphony, Coconizer, etc) to TapeDeck's iconbar icon, that tune will be added
  76. to the current tune list, ie the one current being displayed in the "Current
  77. List" window.  To change the current tune list, click MENU over the "Current
  78. List" window, bring up the "Change List" submenu, and just choose your new
  79. list!  It's as simple as that.
  80.  
  81.  
  82. PLAYING A TUNE
  83.  
  84. To play a tune, just click on it's entry in the "Current List" window.  The
  85. tune will load and, assuming there's enough memory, will start to play.
  86.  
  87. The left-handed panel on the "TapeDeck Control" window deals with the
  88. currently playing tune; displaying it's name, length, etc., and allowing you
  89. to stop it, pause it, play it, rewind it, fast forward it, change the volume
  90. you're hearing it at - all the things your normal hi-fi system can do and
  91. more.
  92.  
  93. If you're a fan of VU-bars, then selecting "Monitor" from the iconbar menu
  94. (or clicking ADJUST on the iconbar icon) will take you to the monitor screen,
  95. where you can be amazed by the quite pedestrian (not so) special effects.
  96.  
  97. When you get fed up listening to just the one tune, you can click on another
  98. tune in the "Current List" window to change it.  If this seems too much like
  99. hard work, then you may want to start...
  100.  
  101.  
  102. CYCLING
  103.  
  104. TapeDeck can replay all of the tunes in any tune list(s) automatically; this
  105. feature is called "Cycling", and is controlled by the right-hand panel of
  106. the "TapeDeck Control" window.  To activate it is simple; just select which
  107. lists you want to hear from the window pane (the box with the scroll bar),
  108. choose the cycle type (see below), and click on "Start Cycle".  Whoo-ee!
  109.  
  110. The "cycle type" is either "Ordered", "Random" or "Shuffle".  I will now take
  111. a moment to explain what each of these means :
  112.  
  113. Ordered : the tunes in the selected tune list(s) are played in the order
  114.           in which they appear in the tune lists.
  115.  
  116. Shuffle : the tunes in the selected tune list(s) are played in a totally
  117.           random order, but each tune is played once and once only.
  118.  
  119. Random : randomly-chosen tunes from the selected tune list(s) are played
  120.          infinitely.
  121.  
  122. Should you decide that you don't like the tune the cycle is currently playing,
  123. or that you'd like to hear the last tune again, then the "next track" and
  124. "previous track" buttons on th left-hand panel of the "TapeDeck Control"
  125. window can be used to move to the next track or to return to the previous one.
  126.  
  127. For obvious reasons, you won't be able to change the cycle type or the lists
  128. selected whilst a cycle is actually taking place.  Sorry.
  129.  
  130. To nobody's great surprise, clicking on the "Stop Cycle" button stop the
  131. cycle.
  132.  
  133.  
  134. TUNE LIST HANDLING
  135.  
  136. Initially, you have only three tune lists with the rather uninspiring names
  137. "List no. 1", "List no. 2" and "List no. 3".  Boring, eh?  Luckily, you
  138. can change this using the "Current List" menu.  By using the relevent options,
  139. you can change the name of the current list ("Rename list"), create a new
  140. list ("Make new list"), or even delete the current list completely ("Delete
  141. list")!  Take care with this last one; once deleted a list is gone forever.
  142.  
  143. You can also sort the tunes in the current list, by either name, author or
  144. pathname (useful if your tunes are all on floppy discs).  For long tune lists,
  145. sorting may take a short while.
  146.  
  147. Bring up the "This tune" submenu and you will find all kinds of weird and
  148. wonderful operations you can perform on the individual tunes.  You can
  149. rename them (useful if they have a default name like "Maestro Conversion"),
  150. edit their authors (since often the program won't be able to work out the
  151. tune's author), open their parents (ie the filer window that contains them),
  152. or even move the tunes to other lists!  All this at the click of a mouse -
  153. aren't you lucky people!  ;-)  (Don't answer that question.)
  154.  
  155. You can also remove a tune from this list, and duplicate a tune in other
  156. lists.  You might at first wonder why this last option is necessary; well,
  157. if you have lists named, say, "Dance" and "Christmas", it isn't at first
  158. clear where to put your funky dance version of "Rudolph the Red Nosed
  159. Reigndeer".  Using the "duplicate" function you can put it in both.
  160.  
  161. The duplicate function can also be used if you decide you want to cycle some
  162. tunes but these tunes are spread over several tune lists and there are other
  163. tunes in these lists you don't want to hear.  You can create a new, temporary
  164. list, duplicate all the tunes you want to hear into it, and cycle away!  To
  165. aid people doing this, clicking on the "Duplicate tune" menu item will
  166. duplicate the tune to the last list created.
  167.  
  168.  
  169. SAVING
  170.  
  171. Okay, so you've indexed all your tunes neatly and listened to them for as
  172. long as you want to for now - what do you do next?  Well, you can save
  173. the index to disc so that you don't have to go through all that indexing
  174. bit next time!  Just bring up the "Save" dialogue box from the "Current list"
  175. menu, and drag the icon to a directory viewer in the standard RISC OS way.
  176.  
  177. (In the unregistered version of TapeDeck, this is not possible and the "Save"
  178. option is greyed out.)
  179.  
  180.  
  181. CONFIGURATION
  182.  
  183. The "Configuration" window is brought up by selecting "Config" from the iconbar
  184. menu.  There are only three options, and one of them is deactivated.  Of the
  185. other two, one allows you to make the tune player modules die when you quit
  186. TapeDeck (which saves a nice bit of module area), and the other gives you the
  187. ability to change the VU bar gravity (ie how quickly the bars in the monitor
  188. go down).  Click on "SAVE" to register any changes, or "Cancel" to forget
  189. about them.
  190.  
  191.  
  192. NOTE ABOUT MEMORY
  193.  
  194. TapeDeck works using four common tune playing modules; QTM, Digital Symphony
  195. Player, Coconizer Player, and the Sountracker module.  However, this
  196. approach can lead to module area fragmentation (ie you run out of memory);
  197. as a cure, the author suggests using an RMA manager.  There is at least one
  198. out there in the PD world...
  199.  
  200.  
  201. KNOWN UNDOCUMENTED FEATURES/BUGS
  202.  
  203. (1) The "next tune" and "previous tune" buttons don't quite work right for
  204.     random cycles; they just select another tune to play randomly.
  205.  
  206. (2) Occaisionally, when changed from a tune played by one module to one played
  207.     by another, an annoying continuous note sounds in the background.  I've
  208.     tried to fix this, but I think it's something in one of the modules...
  209.  
  210. (3) When cycling, the program does not go onto the next tune if either the
  211.     current tune is very short (less than 2 sequences!), or has a midsection
  212.     that repeats unendingly (ie loops).  I don't think there's a way around
  213.     this...
  214.  
  215.  
  216. RELEASE HISTORY
  217.  
  218. Version   Details
  219. 1.00      The first version released.
  220.  
  221. 1.01      Minor bug fix
  222.  
  223. 1.02      Slight modification to make it easier to update the program. Also
  224.           now supports interactive help.
  225.  
  226. 1.03      Minor modification in attempt to get the monitor bit to exit
  227.           properly on a Risc PC.  Whether it works is unknown...
  228.  
  229. 1.04      Fixed a bug in the deletion routine - it previously crashed if
  230.           you tried to remove the fiftieth tune from a list...
  231.  
  232. 1.50      A complete re-write, with too many changes to list them all.  But
  233.           the major ones include - dynamic list management (ie you can create
  234.           and delete lists!), maximum size of lists increased from 50 tunes
  235.           to 999, new and bouncier monitor, more advanced cycling facilities,
  236.           new file format, new... practically everything!
  237.  
  238.  
  239. CREDITS
  240.  
  241. The author would, for various reasons, like to thank the following people :
  242.  
  243. Toby Haynes - for being the first ever registered user, and supplying a
  244.               lot of very good ideas.
  245.  
  246. Colin Davies - for sending me some useful modules.
  247.  
  248. Jon Ribbens & Doggysoft - for writing WimpExtension, which is essential for
  249.                           all programmers (IMHO).
  250.  
  251.  
  252. BORING COPYRIGHT NOTICE THINGY
  253.  
  254. This program, with the exception of the items in the !TapeDeck.Resources
  255. directory, remains at all times the copyright of JJF.  However, this
  256. demo version is Freeware, and you can copy it at will.
  257.  
  258. The WimpExtension module is copyright Jon Ribbens and Doggysoft.
  259.  
  260. The QTM module is copyright Pheonix and Quantum.
  261.  
  262. The DSymphonyPlayer module is copyright BASS.
  263.  
  264. The CoconizerPlayer module is copyright Eduard Pfarr and Armaxess.
  265.  
  266. The Tracker module is copyright Hugo Fiennes, Fabrice Mercier, Matt Farrow
  267.  and the Serial Port (I think).
  268.  
  269.  
  270.