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