home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol056 / optns.doc < prev    next >
Text File  |  1984-04-29  |  16KB  |  546 lines
  1. {j:a
  2. {m:1=10,75
  3. {m:2=18,75
  4. {m:3=24,75
  5. {m:4=50,75
  6. {m:1
  7. V. OPTION LINE DESCRIPTION
  8.  
  9. Option lines are used in Musicraft to support musical functions
  10. not handled by song lines. These functions are:
  11.  
  12. {m:2
  13. {i:-8
  14. 1.
  15. Call a chorus
  16. {i:-8
  17. 2.
  18. Label a song line
  19. {i:-8
  20. 3.
  21. Mark a measure
  22. {i:-8
  23. 4.
  24. Set or change the number
  25. of intervals per octave
  26. {i:-8
  27. 5.
  28. Mark the end of a repeat
  29. {i:-8
  30. 6.
  31. Set or change the tempo
  32. {i:-8
  33. 7.
  34. Set or change the waveforms
  35. {i:-8
  36. 8.
  37. End a chorus
  38.  
  39. {m:1
  40. Two musical functions use more than one option line,
  41. specifically, the chorus function and the repeat function.
  42. These two functions are discussed first and then each option
  43. line is discussed in detail.
  44.  
  45.  
  46. V.A. Chorus Function
  47.  
  48. A chorus (also called a refrain) is a segment of music which
  49. must be performed several times in the course of a song.
  50. Having to input the chorus each time would become tedious.
  51. You can save yourself the work by entering the chorus once
  52. and using the C_option, L_option and X_option lines to create
  53. the effect.
  54.  
  55. A chorus must be indicated to Musicraft by placing an
  56. L_option line in front of the chorus and an X_option line
  57. at the end of the chorus (each of these option lines will
  58. be discussed further below) as in the following example:
  59.  
  60. {l:Song part:
  61. {m:2
  62. {l:(song body segment 1)
  63. {l:*C ABCXYZ
  64. {l:(song body segment 2)
  65. {l:*C ABCXYZ
  66. {l:(song body segment 3)
  67. {l:*X
  68.  
  69. {i:-8
  70. Chorus part:
  71. {l:*L ABCXYZ
  72. {l:(chorus segment)
  73. {l:*X
  74.         
  75. {m:1
  76. {l:The effect of this structure will be the following:
  77.  
  78. {m:2
  79. {i:-8
  80. 1.
  81. Song body segment 1 is performed.
  82. {i:-8
  83. 2.
  84. Chorus segment is performed.
  85. {i:-8
  86. 3.
  87. Song body segment 2 is performed.
  88. {i:-8
  89. 4.
  90. Chorus segment is performed.
  91. {i:-8
  92. 5.
  93. Song body segment 3 is performed.
  94. {i:-8
  95. 6.
  96. The song ends.
  97.  
  98. {m:1
  99. You cause the chorus to be performed at a point in the
  100. song by placing the C_option line into the song at that
  101. point. PLAY will, in effect, insert the entire chorus
  102. into the song at that point and perform it before moving
  103. on to the next song line after the C_option line.
  104.  
  105. The chorus must be placed at the end of the song. You can
  106. have as many choruses as you like (up to 128) but
  107. you must place them at the end of the song. (If you are
  108. familiar with computer programs then you probably recognize
  109. the similarity between the chorus and the subroutine.)
  110.  
  111. It is possible for a chorus call to appear in any segment
  112. of a song. This includes placing a chorus call within a
  113. chorus.  What if a chorus calls another chorus?  A chorus
  114. may call another
  115. chorus which can, in turn, call another chorus, and so on
  116. for a "depth" of 16 choruses. But there is one
  117. rule you must ABSOLUTELY follow: don't permit a chorus to
  118. call itself, or to call another which, in turn, calls the first.
  119. This situation will result in what computer programmers
  120. sometimes call an "unbounded recursion". In other words,
  121. it will
  122. not stop until PLAY calls a halt to the introversion by
  123. canceling the song when the "eight_deep" rule is violated.
  124. But you can use the "nested call" capability for some
  125. very powerful structural developments if it doesn't
  126. confuse you.
  127.  
  128. Incidentally, the chorus function is useful for song segments
  129. which must be repeated but which have different endings after
  130. each repetition. A possible structure might be the following.
  131.  
  132. {m:2
  133. {l:*C X1234
  134. {l:(ending of first repetition)
  135. {l:*C X1234
  136. {l:(ending of second repetition)
  137. {l:(rest of song)
  138. {l:*X
  139.         
  140. {l:*L X1234
  141. {l:(body of repeated section not including endings)
  142. {l:*X
  143.  
  144. {m:1
  145. V.B. Repeat Function
  146.  
  147. A song segment can be performed up to 256 times using the
  148. L_option and R_option lines. The song segment to be repeated
  149. must be indicated to Musicraft by placing an L_option
  150. line in front of the segment, and placing an R_option
  151. line at the end of the segment. Repeated segments may
  152. occur at any time in a song and can occur in choruses.
  153.  
  154. The normal form of a repeated segment is
  155.  
  156. {m:2
  157. {l:*L XYXYXY
  158. {l:(song segment 1)
  159. {l:*R XYXYXY   01
  160. {l:(song segment 2)
  161.  
  162. {m:1
  163. In this instance, song segment 1 will be performed two
  164. times (once without the repeat and once for the repeat.)
  165. Song segment 2 will be performed following the completion
  166. of the repeat.
  167.  
  168. Repeated song segments can be part of other repeated song
  169. segments and this condition is called a "nested repeat".
  170. Should you wish to repeat a song segment more than the
  171. 256 times permitted with one repeat option line,
  172. follow it with a second repeat option line. This extends
  173. the number of possible repeats to 256 times 256, or 65,536
  174. times.
  175.  
  176. An example of a nested repeat might appear as follows.
  177.  
  178. {m:2
  179. {l:*L PIPES
  180. {l:(song segment 1)
  181. {l:*L SATYR
  182. {l:(song segment 2)
  183. {l:*R SATYR   01
  184. {l:(song segment 3)
  185. {l:*R PIPES   01
  186. {l:(song segment 4)
  187.  
  188. {m:1
  189. Here, the following events will occur.
  190.  
  191. {m:2
  192. {i:-8
  193. 1.
  194. Song segment 1 is performed once.
  195. {i:-8
  196. 2.
  197. Song segment 2 is performed once.
  198. {i:-8
  199. 3.
  200. Song segment 2 is repeated once.
  201. {i:-8
  202. 4.
  203. Song segment 3 is performed once.
  204. {i:-8
  205. 5.
  206. 1, 2, 3, and 4 are repeated once.
  207. {i:-8
  208. 6.
  209. Song segment 4 is performed once.
  210.  
  211. {m:1
  212. There is a situation that must be avoided in the use of
  213. more than one repeated song segment. When the last part
  214. of one repeated song segment overlaps with the first
  215. part of a second repeated song segment, the combination
  216. will never terminate. This situation also has a name
  217. among programmers (these things happen to them but
  218. shouldn't) and it causes an "infinite loop". If you
  219. want to hear the rest of your song, avoid this situation.
  220.  
  221. {m:2
  222. {l:*L 123.5
  223. {l:(song segment 1)
  224. {l:*L INFINITY
  225. {l:(song segment 2)
  226. {l:*R 123.5    01
  227. {l:*R INFINITY 01
  228.  
  229. {m:1
  230. Incidentally, when the repeated segment is completed, the
  231. R_option line is reset so that the next time the repeat
  232. is invoked by your song, the proper number of repeats will
  233. again take place. 
  234.  
  235. The R_option can be used to bypass a segment of music when
  236. you want to skip a segment the first time but intend to
  237. play it later as in the following example.
  238.  
  239. {m:2
  240. {l:(song segment 1)
  241. {l:*R JSBACH   01
  242. {l:*L VIVALDI
  243. {l:(song segment 2)
  244. {l:*L JSBACH
  245. {l:(song segment 3)
  246. {l:*R VIVALDI  01
  247. {l:(rest of song)
  248.         
  249. {m:1
  250. In this example, song segment 2 will not be played until
  251. after the first playing of song segment 3. Note that, if
  252. you use a repeat to bypass a segment of music and that
  253. repeat is "nested" within a true repeat, you should 
  254. indicate a large repeat count for the bypass repeat. This
  255. is necessary because PLAY will decrement the repetition
  256. counter each time the repeat is encountered and when it
  257. reaches zero the repeat will be ignored.
  258.  
  259.  
  260. V.C. Chorus Call Option Line
  261.  
  262. The C_option line is used to cause a chorus segment to be
  263. performed in place of the C_option itself. The C_option
  264. line is compiled by COMP and passed as part of the song
  265. to PLAY.
  266.  
  267. A song may have as many C_option lines as are desired up to
  268. the limit of your computer to hold song/option lines in memory.
  269.  
  270. The C_option has one part following the "C" identifying
  271. the option. This is the name of an L_option line marking
  272. the beginning of a chorus. The name must match some label.
  273. Otherwise, COMP will report an error and not complete the
  274. compilation of your song.
  275.  
  276. Examples:
  277.  
  278. {m:2
  279. {l:*C CHORUS1
  280. {l:*C REFRAIN
  281. {l:*C 5
  282. {a:p=1
  283. {m:1
  284. V.D. Label Option Line
  285.  
  286. The L_option line is used to mark the beginning of a song
  287. segment. It is compiled by COMP and use to resolve label
  288. references made by R_option and C_option lines, and it
  289. is passed as part of the song to PLAY. You might use the
  290. L_option line for several reasons:
  291.  
  292. {m:2
  293. {i:-8
  294. 1.
  295. to indicate the beginning of a chorus segment;
  296. {i:-8
  297. 2.
  298. to indicate the beginning of a repeat segment;
  299. {i:-8
  300. 3.
  301. to indicate the beginning of a randomly selectable
  302. song segment in the modified performance mode;
  303. {i:-8
  304. 4.
  305. to mark a convenient point in the song for use
  306. in the FIND function of EDIT. (You can read
  307. about this function in the EDIT section below.)
  308.  
  309. {m:1
  310. A song may contain up to 128 labels. Any more than this and
  311. COMP will declare an error in your song.
  312.  
  313. The L_option line has the following two parts beyond the
  314. L_option
  315. indicator. You provide these when you place the L_option
  316. line in the song.
  317.  
  318. {m:2
  319. {i:-8
  320. 1.
  321. A name which uniquely identifies the segment;
  322. {i:-8
  323. 2.
  324. The segment select key for PLAY. 
  325.  
  326. {m:1
  327. The label name is used by the C_option line and the R_option
  328. line to make reference to the L_option line. It may be
  329. any sequence of from one to 8 characters in
  330. length. The label name does not have any meaning in itself,
  331. incidentally, only in its reference by other option lines.
  332. Examples are
  333.  
  334. {m:2
  335. {l:PART_A
  336. {l:REPRISE
  337. {l:DEVELOP
  338. {l:CODA
  339. {l:REPEAT
  340. {l:RPM.78
  341. {l:etc...
  342.  
  343. {m:1
  344. The select key (also referred to as the label key) is used by PLAY
  345. to permit modification of
  346. the normal performance process into any sequence you might
  347. desire.  This feature is discussed at length in the PLAY
  348. section of the manual. Any key on your keyboard (excluding
  349. control keys) may be
  350. assigned to the label. If you wish to use the feature,
  351. it is your responsibility to insure
  352. that the keys assigned
  353. to the different L_option lines are unique.
  354.  
  355. For additional information, see the discussion about the Modified 
  356. Performance Mode in paragraph IV.E.6.b. above.
  357. {a:p=1
  358. V.E. Measure Option Line
  359.  
  360. The M_option line is used to mark measures within a song.
  361. It is passed as part of the song to PLAY for use in the
  362. rehearsal mode of PLAY. The M_option line is the only option
  363. which can be generated without the use of the
  364. OPTION menu of the EDIT program. You can insert an M_option
  365. line at any time when you are in the Edit and Insert modes
  366. of EDIT.
  367.  
  368. A song may have as many M_option lines as are desired up to
  369. the limit of your computer to hold song/option lines in memory.
  370.  
  371. The M_option line has one part following the "M" identifier.
  372. A four-digit measure number is placed into the M_option line
  373. by EDIT. This number is in order of use and is not necessarily
  374. in order from beginning to end of the song. When you strike the
  375. "M" key, the number is incremented and then used. Should
  376. you place a measure into a song at some point, then back up
  377. and place another M_option line before the first, the numbers
  378. will be backwards.
  379.  
  380. Example:
  381.  
  382. {m:2
  383. {l:*M 0001
  384. {l:(measure segment 1)
  385. {l:*M 0002
  386. {l:(measure segment 2)
  387. {l:*M 0003
  388. {l:(measure segment 3)
  389. {l:...etc.
  390.  
  391. {m:1
  392. EDIT renumbers all M_option lines when it saves the
  393. song on floppy disk.
  394.  
  395.  
  396. V.F. Microtone Option Line
  397.  
  398. The #_option line is used to set or change the number of intervals 
  399. within an octave. It is used by COMP in compiling song lines which 
  400. use the microtone notation and is not passed as part of the song to 
  401. PLAY.
  402.  
  403. The song may have as many #_option lines as desired up to the limit 
  404. of your computer to hold song/option lines in memory.
  405.  
  406. The #_option has one part following the "#" identifying the option. 
  407. You must enter a number between 1 and 99 which specifies the number 
  408. of intervals per octave that is to apply to note information which 
  409. follows the #_option line.
  410.  
  411. If you do not use #_option line anywhere within the body of a song, 
  412. COMP will declare microtonal information as errors.
  413. {a:p=1
  414. V.G. Repeat Option Line
  415.  
  416. The R_option line is used to mark the end of a repeated song
  417. segment. It is compiled by COMP and passed as part of the
  418. song to PLAY to control performance. 
  419.  
  420. A song may have as many R_option lines as desired up to the
  421. limit of your computer to hold song/option lines in memory.
  422.  
  423. The R_option has two parts following the "R" identifying
  424. the option.
  425.  
  426. {m:2
  427. {i:-8
  428. 1.
  429. The segment name in the beginning L_option line.
  430. {i:-8
  431. 2.
  432. The number of repetitions of the segment.
  433.  
  434. {m:1
  435. The name must match some label preceding the R_option line;
  436. otherwise, COMP will report an error and not complete the
  437. compilation of your song.
  438.  
  439.  
  440. V.H. Tempo Option Line
  441.  
  442. The T_option line is used to set or change the tempo of
  443. the music which follows the point at which the option is
  444. used. It is used by COMP in the computation of duration
  445. and pitch information to be passed to PLAY. The T_option
  446. line is not passed to PLAY.
  447.  
  448. A song may have as many T_option lines as desired up to the
  449. limit of your computer to hold song/option lines in memory.
  450.  
  451. The T_option has one part following the "T" identifying
  452. the option. You must enter a number between 1 and 999 which
  453. specifies the number of quarter notes to be played per
  454. minute. This notation is like the standard Maetzel notation
  455. used in most published music today.
  456.  
  457. If you do not use a T_option line anywhere within the body
  458. of a song, Musicraft will play about 80 quarter notes per
  459. minute.
  460.  
  461. Example:
  462.  
  463. We would like to play a song at 120 quarter notes per minute
  464. for the first 20 measures, but, beginning at measure 21,
  465. we would like to change the speed to 144. The following
  466. example shows this.
  467.  
  468. {m:2
  469. {l:*T 120
  470. {l:(song segment 1)
  471. {l:*T 144
  472. {l:*M 0021
  473. {l:(song segment 2)
  474.  
  475.  
  476. {m:1
  477. V.I. Waveform Option Line
  478.  
  479. The W_option line is used to permit the setting or changing
  480. of the sound color of the music which follows the point at
  481. which the W_option line is placed in the song. The W_option
  482. line is compiled and passed as part of the song to PLAY.
  483.  
  484. PLAY permits
  485. up to 14 different waveform tables to be available for use
  486. in performance of a song. These tables are numbered from 1
  487. to 14. You relate these tables to the voices of your song
  488. by using the W_option line. By placing a waveform into a table
  489. referenced by a W_option line, you will have caused PLAY to
  490. use that particular sound color in the performance of a voice.
  491.  
  492. If you do not use a W_option line anywhere within the body of
  493. a song, PLAY will use table 1 for all voices in the song.
  494.  
  495. A song may have as many W_option lines as desired up to the
  496. limit of your computer to hold song/option lines in memory.
  497.  
  498. A W_option line has as many parts following the "W" identifier
  499. as the number of voices you have declared for the song. If
  500. you declare three (3) voices, the W_option line has three
  501. (3) additional parts. Each part corresponds to a voice. The
  502. first part corresponds to the first voice, the second part
  503. to the second voice, and so forth. You may
  504. place any number from 1 to 14 in each part and thereby
  505. associate that numbered waveform table in PLAY with the voice
  506. corresponding to that part of the W_option line. This
  507. association will hold from that point until the occurrence
  508. of another W_option line.
  509.  
  510. Example:
  511.  
  512. In a 3_voice song, we would like to use table 3 with voice
  513. 1, table 10 with voice 2, and table 2 with voice 3. The
  514. following W_option line will produce these results:
  515.  
  516. {m:2
  517. {l:(song segment 1)
  518. {l:*W 03 10 02
  519. {l:(song segment 2)
  520.  
  521. {m:1
  522. Song segment 1 will be performed by PLAY using table 1 for
  523. all three voices while song segment 2 will be performed
  524. in the manner described above.
  525.  
  526.  
  527. V.J. Chorus Exit Option Line
  528.  
  529. The X_option line is used to mark the end of a chorus or the
  530. end of a song when a chorus is used. It is compiled by COMP
  531. and passed as part of the song to PLAY.
  532.  
  533. If the X_option line is preceded by
  534. a corresponding L_option line, then it causes PLAY to return
  535. to the main body of the song following the C_option line
  536. which caused the chorus to be performed. If it is not preceded
  537. by a corresponding L_option line, then the song is terminated.
  538. You should use this feature to end songs which have choruses.
  539. If you omit the use of the X_option line in a song which has
  540. a chorus, then the chorus will be played one last time and the
  541. song will then terminate. See the discussion about the Chorus
  542. Feature above for more information.
  543. {a:p=1
  544.  
  545.  
  546.