home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / mag_discs / volume_6 / issue_08 / perform / Perf_Info < prev   
Text File  |  1993-02-26  |  8KB  |  212 lines
  1. ###############################################################################
  2. # The Perform application is the copyright of JO Linton and Clares Micro      #
  3. # Supplies 1991. It may be supplied to other users for personal use provided  #
  4. # that this documentation is not deleted. It may not be sold or supplied      #
  5. # commercially without permission from Clares (0606 48511).                   #
  6. ###############################################################################
  7.  
  8.  
  9. !Perform
  10.  
  11. When you have built up a library of scores, you may wish to play a number of 
  12. them in sequence eg as movements of a sonata or tracks in an album. This can
  13. be  done using the application Perform which will play up to 12 Rhapsody or
  14. MIDI  files in sequence. Perform will also play samples such as those
  15. produced by  Armadeus. If you have a sampling board, you could announce each
  16. track before  it is played using this feature!
  17.  
  18. In addition, Perform can load voice modules. This solves the problem of
  19. having  to have the right voices loaded before Rhapsody will play correctly.
  20.  
  21. All this is achieved by setting up a 'Programme' (ie a concert programme,
  22. not a  computer program!) which can be saved as a special file and reloaded
  23. at any  time. Items on the programme can easily be added, deleted and moved
  24. around. The programme may then be played either once through or
  25. continuously, and  because Perform is a standard multi-tasking application,
  26. other RISC OS applications may be run at the same time.
  27.  
  28. Starting and quitting Perform
  29.  
  30. Perform is a standard RISC OS application and is loaded by double clicking
  31. on  its icon in the usual way.
  32.  
  33. Clicking with the Menu button on the iconbar icon leads to the iconbar
  34. menu...
  35.  
  36. Info 
  37. ==== 
  38.  
  39. The first item on the menu gives access to some information about the
  40. program.
  41.  
  42. Play
  43. ====
  44.  
  45. The second ('Play') is shaded because there is no current programme
  46. available. 
  47.  
  48. Panel
  49. =====
  50.  
  51. The third choice opens a small panel which provides you with 5
  52. 'tape-recorder'  style icons including play, pause, stop etc.
  53.      
  54. Quit
  55. ====
  56.  
  57. Choosing the 'Quit' option, by clicking on it with the Select button, stops
  58. any  playing that may be in progress and quits the program.
  59.  
  60. Setting up a programme
  61. ====================== 
  62.  
  63. To set up a completely new programme, click on the iconbar icon using the 
  64. Select button. This opens the main programme window. Alternatively, if you 
  65. have opened the panel, you can open the programme window by clicking on the 
  66. Perform icon in the far left of the Panel window.
  67.  
  68. Each piece on the programme has two (initially blank) boxes, the second of 
  69. which holds the filename of the piece to be played. To fill in this field,
  70. open one  or more directory displays which contain the scores you wish to
  71. play and 'drag'  the file icon into the appropriate box using the Select
  72. button. When you release  the mouse button the file name appears in the box
  73. and its small filetype icon  appears on the right.
  74.  
  75. (Note that although only the leaf name shows in the box, the full filename
  76. is held  by the programme. If the programme and its files are held on the
  77. same disc then  the names are stored relatively. In this case, if you copy
  78. the programme and files  to another disc and maintain the same relationship
  79. between the files then the  programme will run. If the files are not stored
  80. on the same disc as the  programme then the full pathnames, including filing
  81. system and disc names, are  stored. This means that you can construct
  82. programmes with pieces from any  combination of hard and floppy discs, with
  83. the proviso that the score must be  available when it is needed by the
  84. program. However, if you move any of the  files the programme will be unable
  85. to find them. Note that dragging a file icon  into the programme box does
  86. not load the selected file. This happens later, only  when it is needed.)
  87.  
  88. To rearrange the order of pieces, use the same technique - ie 'drag' the
  89. filename  from one box to another. If you use the Select button, the
  90. filename is moved  from one box to the other. If you use the Adjust button,
  91. the filename is copied,  leaving the original in place. Note that if you
  92. drag a filename onto a box which  already has a name, that name is
  93. overwritten.
  94.  
  95. To delete a piece, 'drag' the filename onto the 'bin' icon at the top of the
  96. window.
  97.  
  98. While you are constructing your program, you will notice that the first box 
  99. always contains a tick. This means that this piece is automatically flagged
  100. for  playing. If you want a performance to omit a certain piece (but not to
  101. delete it  from the programme entirely) toggle the tick on and off using the
  102. Select button.  The 'loudspeaker' icon is non functional, it is a reminder
  103. of what this tick means.
  104.  
  105. Perform recognizes four types of file object:
  106.  
  107. 1) Rhapsody files (filetype &C00) 
  108. 2) Midi files (filetype &FD4)
  109. 3) Sample files (filetype &D3C) - (signed linear format)
  110. 4) Programme files (filetype &CB9)
  111.  
  112. In the last case, Perform will load and perform a whole new programme. 
  113. Effectively this means that Perform can perform an unlimited sequence of
  114. pieces  with, if you like, announcements in between!
  115.  
  116. Perform also accepts any other file and when its turn comes round it is
  117. *RUN.  This means that it can load new voices and execute obey files etc.
  118. For example,  if you need to load a voice module called OrchLib before a
  119. piece, simply include  the file in the list at the appropriate place. You
  120. can also drag the !Voices application form Rhapsody II into Perform and it
  121. will load the voices in the directory.
  122.  
  123. If you need to load several voice  modules at once, a more efficient way
  124. would be to list them all in an obey file,  and then include the name of the
  125. obey file in the programme.
  126.  
  127. Since Rhapsody version 1.20 now recognises voices by name rather than by 
  128. number, it does not matter in what order the voices are loaded. On the other 
  129. hand, you cannot load more than 32 voices at once. It is for this reason
  130. that the  !Perform directory contains a short utility called 'NoVoices'
  131. which removes all  the voices from 10 to 32 (ie it leaves the default voices
  132. of WaveSynth, StringLib  and Percussion intact). It is a good idea to
  133. include this utility at the head of any  programme or obey file which loads
  134. any new voices.
  135.  
  136. Saving a programme 
  137. ==================
  138.  
  139. Click with the Menu button anywhere on the main programme window to open 
  140. the main menu.
  141.  
  142. Save
  143. ====
  144.  
  145. Moving over the save option leads to the Save window...
  146.  
  147.  
  148. You can save your programme in the usual way either by entering a full 
  149. pathname and clicking on the OK icon or by dragging the file icon into a 
  150. directory viewer.
  151.  
  152. Options
  153. ======= 
  154.  
  155. Before choosing the play option on the main menu, check the available
  156. options  by moving over the options item to the Options menu.
  157.  
  158.  
  159. Most of these are the same as in Rhapsody. The only one which is different
  160. is  'Continuous'. When this option is ticked, the programme repeats
  161. continuously.  Do not confuse this with the 'Repeats' option which enables
  162. repeated sections  within a piece to be played, or not as the case may be.
  163.  
  164. Options are saved along with the programme.
  165.  
  166. Play
  167. ====
  168.  
  169. When the options are set correctly, choose 'Play' from the main menu and
  170. away  you go. Note that MIDI files can only be played on a MIDI instrument.
  171. If the  MIDI option is not selected (or if a MIDI interface is not fitted)
  172. then the MIDI  files in the programme are ignored.
  173.  
  174. Skip
  175. ====
  176.  
  177. If, while a programme is being played, you wish to skip to the next item on
  178. the  programme, choose the 'Skip' option.
  179.  
  180. Stop play
  181. =========
  182.  
  183. To stop playing at any time, open the main menu and choose the third item 
  184. which will now say 'Stop play'.
  185.  
  186. When appropriate, the 'Play' and 'Stop play' options appear in the iconbar
  187. menu  as well.
  188.  
  189. The Panel window 
  190. ================
  191.  
  192. You can open the Panel window by choosing the appropriate option on  the
  193. iconbar menu.
  194.  
  195. As has been stated previously, clicking on the Perform icon at the far left
  196. opens  the main programme window. The other icons are, in order from left to
  197. right:
  198.  
  199. 1) Skip back to previous piece
  200. 2) Play from the start
  201. 3) Skip on to the next piece
  202. 4) Stop playing
  203. 5) Pause if playing (toggles on and off)
  204.  
  205. Playing Samples 
  206. ===============
  207.  
  208. Perform will also play sampled sounds. It expects the sample to be in linear 
  209. signed format with the first byte indicating the sample rate in
  210. micro-seconds.  This is the format produced by Armadeus. The expected
  211. filetype is &D3C.
  212.