home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol056 / prog2.doc < prev    next >
Encoding:
Text File  |  1984-04-29  |  16.5 KB  |  579 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. IV.B.4. Reference
  8.  
  9. The following section describes the characteristics of EDIT
  10. by simple enumeration.
  11.  
  12.  
  13. IV.B.4.a. Quit
  14.  
  15. EDIT is terminated and the song is stored back to the floppy
  16. disk when you press the quit-key (normally set as control-Q) while
  17. in Edit_mode. As the song is written to floppy disk, all
  18. M_option lines are renumbered sequentially. The song file created
  19. by EDIT has a type of .SNG and the type of the song file that was
  20. used as
  21. input is changed from .SNG to .SBK for use as a backup if needed.
  22. Any prior backup is deleted.
  23.  
  24. EDIT is terminated and control is returned to the operating system
  25. without updating the song on the diskette when you press the 
  26. cancel_key (normally set as control_C) while in Edit_mode.
  27.  
  28. The quit_key is used to quit Insert_mode and Excise_mode to
  29. return control to Edit_mode.
  30.  
  31. Both the quit_key and the cancel_key can be reprogrammed through the 
  32. use of SETUP. See Appendix A.
  33.  
  34.  
  35. IV.B.4.b. Modes of Edit
  36.  
  37. EDIT operates in four modes. Each mode is distinguished by
  38. a menu line at the top of the CRT screen whenever EDIT is in that
  39. mode.
  40.  
  41. {m:2
  42. {i:-8
  43. 1.
  44. Edit_mode permits changing existing musical information
  45. and is the mode in which the program begins when invoked.
  46. You can get to the other three modes of operation only
  47. when in Edit_mode.
  48. {i:-8
  49. 2.
  50. Insert_mode allows entry of new musical information.
  51. {i:-8
  52. 3.
  53. Excise_mode allows deletion of song and option lines.
  54. {i:-8
  55. 4.
  56. Option_mode presents a menu of musical functions and
  57. edit services.
  58.  
  59. {m:1
  60. Navigation from one mode to another is according to the graph shown 
  61. on the next page. Note that Edit_mode is the pivotal point in the
  62. structure. To 
  63. get from one mode to another, you must return to 
  64. Edit_mode. In the cases of Insert_mode and Excise_mode, you must use 
  65. the quit_key. In the case of Options_mode, it is automatic at the 
  66. completion of the specific function used.
  67. {a:p=1
  68.  
  69. {c:Edit_mode
  70.  
  71.  
  72. {c:^^^^^^^^^^I^^^^^^^^^^^^^^^^^^^^^^^^^^^^^O^^^^^^^^^^
  73.  
  74. {c:^^^^^^^^^^(quit)^^^^^^^^X^^^^^^^^^^^^^^^^^^^^^^^^^^
  75.  
  76. {c:Insert_mode^^^^^^^^^^^^^^^^^^^^^^^^^^^^Options_mode
  77. {c:^^^^^^^^^^^^^^^^^^^^^^^^^^(quit)^^^^^^^^^^^^^^^^^^^
  78.  
  79. {c:Excise_mode
  80.  
  81.  
  82.  
  83.  
  84. IV.B.4.b.i. Edit_mode
  85.  
  86.  
  87. IV.B.4.b.i.1. Menu(appears at the top of screen)
  88.  
  89. dEDIT: text, cursors, I(nsert, X(cise, O(ptions, M(easure, quit
  90.  
  91.  
  92. IV.B.4.b.i.2. d(irection
  93.  
  94. The first character on the menu line is the direction indicator.
  95. It may have two values. The down direction is indicated by the
  96. character ">" while the up direction is indicated by the character
  97. "<". The direction indicator affects two navigational aids, the
  98. home function and the page function. You can change the direction
  99. indicator at any time while in Edit_mode by pressing the <_key
  100. or >_key.
  101.  
  102.  
  103. IV.B.4.b.i.3. text
  104.  
  105. Edit_mode permits you to enter duration and note information
  106. into existing song lines when the cursor is in the appropriate
  107. columns. In other words, EDIT will accept duration data when the cursor
  108. is in the duration column and it will accept note data when
  109. the cursor is in the voice columns. EDIT will interpret the
  110. characters according to the column under the cursor. For example,
  111. your entering the letter "E" means different things depending on
  112. which column is under the cursor. In the duration column, "E" means
  113. "eighth note", while in a voice column it means the note "E". If the
  114. cursor is not in the first position of a column, "E" is an error since
  115. EDIT does not expect an "E" in that case. In that event, EDIT
  116. will ring the CRT bell (if present) and display an error message.
  117. A complete list of possible entries are described above in the 
  118. section MUSIC NOTATION SYSTEM.
  119.  
  120.  
  121. IV.B.4.b.i.4. cursors
  122.  
  123. The principal method of navigation available to you while editing is
  124. through the use of the cursor control functions. The cursor can be
  125. moved up, down, left
  126. and right by using the cursor control functions. Further, you can page
  127. through the
  128. song as well as go directly to either the top or bottom of the song
  129. with a single key stroke. Additional navigational aids are available
  130. under the Option_mode.
  131.  
  132. {m:3
  133. {i:-14
  134. Cursor^up:
  135. control_K, often labeled on keyboards as an up_arrow.
  136. {i:-14
  137. Cursor^down:
  138. control_J, often labeled as a down_arrow.
  139. {i:-14
  140. Cursor^left:
  141. control_H, often labeled as a left_arrow.
  142. {i:-14
  143. Cursor^right:
  144. control_L, often labeled as a right_arrow.
  145. {i:-14
  146. Home^cursor:
  147. control_Y, often labeled as HOME.
  148. {i:-14
  149. Page^cursor:
  150. the letter "P".
  151. {i:-14
  152. Space:
  153. the space bar.
  154.  
  155. {m:1
  156. CRT terminals are not standard in their treatment of these characters.
  157. Yours may not even have the symbols engraved on any of your keytops.
  158. Since you may have to depress the control key every time a cursor movement
  159. is desired (which is very frequently) you may wish to reassign the
  160. keys which perform these functions.
  161. Any of the functions except the Page function and the Space function can 
  162. be reassigned using SETUP. See Appendix A.
  163.  
  164. Two auxiliary cursor controls are the direction control characters.
  165.  
  166. {m:3
  167. {i:-14
  168. up^direction: the character "<" (hexidecimal 3C).
  169. {i:-14
  170. down^direction: the character ">" (hexidecimal 3E).
  171.  
  172. {m:1
  173. Using one of these two characters will determine the direction taken 
  174. by the home and
  175. page functions when they, in turn, are used.
  176.  
  177.  
  178. IV.B.4.b.i.5. I(nsert
  179.  
  180. Pressing the letter "I" places EDIT in Insert_mode. See the section
  181. Insert_Mode below for a complete description.
  182.  
  183.  
  184. IV.B.4.b.i.6. X(cise
  185.  
  186. Pressing the letter "X" places EDIT in Excise_mode. See the section
  187. Excise_mode below for a complete description.
  188.  
  189.  
  190. IV.B.4.b.i.7. O(ptions
  191.  
  192. Pressing the letter "O" places EDIT in Option mode. See the section
  193. Options_mode below for a complete description.
  194.  
  195.  
  196. IV.B.4.b.i.8. M(easure
  197.  
  198. Pressing the letter "M" inserts a numbered measure option line into
  199. the song
  200. immediately preceding the line marked by the cursor; unless the
  201. cursor is on the "da capo" line in which case the measure option
  202. line is inserted immediately following. Measures may be numbered in any
  203. order since EDIT always renumbers measures when the song is written
  204. to the floppy disk. See the discussion of the measure option line in 
  205. the section OPTION LINE DESCRIPTIONS.
  206.  
  207.  
  208. IV.B.4.b.i.9. quit
  209.  
  210. See paragraph IV.B.4.a. above.
  211.  
  212.  
  213. IV.B.4.b.ii. Insert_mode
  214.  
  215.  
  216. IV.B.4.b.ii.1. Menu (appears at the top of the screen)
  217.  
  218. dINSERT: text, cursors, M(easure, quit
  219.  
  220.  
  221. IV.B.4.b.ii.2. d(irection
  222.  
  223. See paragraph IV.B.4.b.i.2. above.
  224.  
  225.  
  226. IV.B.4.b.ii.3. text
  227.  
  228. Insert_mode permits you to enter duration and note information into 
  229. new song lines or existing song lines when the column at the cursor 
  230. is empty. EDIT applies the same rules as are described in paragraph 
  231. IV.B.4.b.i.3. above.
  232.  
  233.  
  234. IV.B.4.b.ii.4. cursors
  235.  
  236. Insert_mode permits a subset of the cursor functions supported by 
  237. Edit_mode:
  238.  
  239. {m:2
  240. {i:-8
  241. 1.
  242. Cursor down
  243. {i:-8
  244. 2.
  245. Cursor left
  246. {i:-8
  247. 3.
  248. Cursor right
  249. {i:-8
  250. 4.
  251. Space bar
  252.  
  253.  
  254. {m:1
  255. IV.B.4.b.ii.5. M(easure
  256.  
  257. See paragraph IV.B.4.b.i.8. above.
  258.  
  259.  
  260. IV.B.4.b.ii.6. quit
  261.  
  262. See paragraph IV.B.4.a. above.
  263.  
  264.  
  265. IV.B.4.b.ii.7. Discussion
  266.  
  267. Insert_mode operates in one of two ways depending upon the
  268. location of the cursor at the time of entry into the mode.
  269.  
  270. If the cursor is on an option line or a voice (or duration)
  271. column which contains data, then Insert_mode
  272. will insert song lines in front of the line.
  273.  
  274. If the
  275. cursor is on an empty voice or duration column, then
  276. Insert_mode will not insert song lines but will allow you
  277. to fill in the empty column until a non_empty entry is
  278. encountered or the "da end" terminal line is encountered,
  279. whichever occurs first.
  280.  
  281. The most efficient way to use EDIT to enter a new
  282. song is described in the following steps:
  283.  
  284. {m:2
  285. {i:-8
  286. 1.
  287. Type EDIT songname followed by a return.
  288. {i:-8
  289. 2.
  290. Enter the number of voices.
  291. {i:-8
  292. 3.
  293. Press the letter "O" to enter Option mode.
  294. {i:-8
  295. 4.
  296. Press "!" or "#" to set the key signature
  297. and enter the notes to be sharped or flatted.
  298. See paragraphs IV.B.4.b.iv.10 and IV.B.4.b.iv.11.
  299. {i:-8
  300. 5.
  301. Place the cursor at the point in the song above
  302. which you would like to insert new song lines. If
  303. it is a new song, this point would be the "da end"
  304. line.
  305. {i:-8
  306. 6.
  307. Press the letter "I" to enter Insert mode.
  308. {i:-8
  309. 7.
  310. Enter the note information for one field in one
  311. voice or duration
  312. column. (Start with the first voice column which is
  313. the second column on the screen.)
  314. {i:-8
  315. 8.
  316. press the down_key.
  317. {i:-8
  318. 9.
  319. Repeat steps 7 and 8 until the entire column
  320. has been entered. Use the "M" key as needed to 
  321. insert measures into the song.
  322. {i:-8
  323. 10.
  324. Press the control_Q key to return control to the
  325. Edit mode.
  326. {i:-8
  327. 11.
  328. Press the letter "O" to enter Option mode.
  329. {i:-8
  330. 12.
  331. Press the letter "V" to locate the first empty portion
  332. of the song. See paragraph IV.B.4.b.iv.7.
  333. {i:-8
  334. 13.
  335. Repeat steps 6 through 12 until all voice and the
  336. duration columns have been completed.
  337. {i:-8
  338. 14.
  339. Press the control_Q key to quit EDIT and store the
  340. song on the diskette.
  341.  
  342. {m:1
  343. This procedure uses both facilities of Insert_mode, the first
  344. when you insert the first voice, the second when you insert the
  345. other voices and the duration.
  346.  
  347.  
  348. IV.B.4.b.iii. Excise_mode
  349.  
  350.  
  351. IV.B.4.b.iii.1. Menu (appears at the top of the screen)
  352.  
  353. dEXCISE: up, down or quit
  354.  
  355.  
  356. IV.B.4.b.iii.2. d(irection
  357.  
  358. See paragraph IV.B.4.b.i.2. above.
  359.  
  360.  
  361. IV.B.4.b.iii.3. up, down
  362.  
  363. Excise_mode permits you to remove unwanted lines using the up_key
  364. and/or the down_key. Lines removed with the use of one of the
  365. two keys can be returned to the song with the use of the other key.
  366.  
  367.  
  368. IV.B.4.b.iii.4. quit
  369.  
  370. You accept the excision by pressing the quit key to return to
  371. Edit_mode.
  372.  
  373.  
  374. IV.B.4.b.iv. Option_mode
  375.  
  376.  
  377. IV.B.4.b.iv.1. Menu
  378.  
  379. Options_mode is operated completely by menu selection. Upon entering 
  380. Options_mode, EDIT clears the screen and displays the menu. You may 
  381. select any function by pressing the key corresponding to the function 
  382. in the menu. The menu appears as follows:
  383.  
  384. {m:2
  385. {i:-2
  386. type a...
  387. {l:C   to call a chorus (or refrain)
  388. {l:F   to find a label, line or measure
  389. {l:L   to label the current song line
  390. {l:M   to set the number of intervals per octave
  391. {l:R   to mark a repeat
  392. {l:T   to change the tempo
  393. {l:V   to verify completeness
  394. {l:W   to change waveforms
  395. {l:X   to end a chorus
  396. {l:!   to change the flatted notes
  397. {l:#   to change the sharped notes
  398. {l:...>
  399.  
  400. {m:1
  401. Pressing any key not in the list will return control to
  402. Edit_mode.  After the processing associated with the selected 
  403. function is complete, control is returned automatically to Edit_mode.
  404.  
  405.  
  406. IV.B.4.b.iv.2. To Call a Chorus
  407.  
  408. Type the letter "C". EDIT then requests the name of the
  409. chorus label. Enter the label name identifying the beginning of the
  410. desired chorus. Follow with a carriage return. The label name
  411. must be exactly as it appears in the label. See paragraphs 
  412. IV.B.4.b.iv.4., V.A. and V.C. for additional information.
  413. This function places a Chorus Call option line in the song.
  414.  
  415.  
  416. IV.B.4.b.iv.3. Find a Label, Line or Measure
  417.  
  418. Type the letter "F" to invoke the function. A new menu appears.
  419.  
  420. {m:2
  421. {i:-2
  422. Type a...
  423. {l:L  to find a label
  424. {l:M  to find a measure
  425. {l:S  to find a song line
  426. {l:...>
  427.           
  428. {m:1
  429. To find a label, type the letter "L". Then enter the label name matching
  430. the label to be found. Follow with carriage return. EDIT will
  431. attempt to locate the label, and, if found, will place the
  432. cursor on the label line. If the label is not found, EDIT will
  433. leave the cursor where it was before the function was requested.
  434.  
  435. To find a measure, type the letter "M". Then enter the measure number
  436. matching the measure to be found. Follow with carriage
  437. return. EDIT will attempt to locate the measure, and, if
  438. found, will place the cursor on the measure line. If the
  439. measure is not found, EDIT will leave the cursor where it
  440. was before the function was requested.
  441.  
  442. To find a song line, type the letter "S". Then enter the line number
  443. matching the song line to be found. Follow with carriage
  444. return. EDIT will attempt to locate the measure, and, if
  445. found, will place the cursor on the song line. If the
  446. song line is not found, EDIT will leave the cursor where it
  447. was before the function was requested.
  448.  
  449.  
  450. IV.B.4.b.iv.4. To Label the Current Song Line
  451.  
  452. Type the letter "L" . Then enter from one to
  453. eight characters as the label name. You may use any characters
  454. from the set of possibilities below. Follow the label name
  455. with a carriage return. This function places a Label option line in 
  456. the song.
  457.  
  458. {m:2
  459. {i:-8
  460. 1.
  461. The numbers
  462. {i:-8
  463. 2.
  464. The upper case alphabet
  465. {i:-8
  466. 3.
  467. The special characters
  468.  
  469. {m:1
  470. EDIT will ask for a label key. This is to allow you to identify
  471. the label for use in the interactive performance mode of PLAY.
  472. Read the section describing PLAY for more information about
  473. this function. If you wish to use this feature, type any unique
  474. key from the following set of possibilities.
  475.  
  476. {m:2
  477. {i:-8
  478. 1.
  479. The numbers
  480. {i:-8
  481. 2.
  482. The upper case alphabet
  483. {i:-8
  484. 3.
  485. The lower case alphabet
  486. {i:-8
  487. 4.
  488. The special characters
  489. {a:p=1
  490. {m:1
  491. IV.B.4.b.iv.5. To Set or Change the Number of Intervals per Octave
  492.  
  493. Type the letter "M".
  494. Then enter the number of intervals
  495. in the octave. Follow with carriage return. Musicraft
  496. supports from one to 99 intervals per octave while at the same
  497. time supporting the chromatic octave. You may use either of
  498. the two notations to represent note information at any time. Note
  499. that EDIT does not check to see that the numbers you give for note
  500. information are less than or equal to the number of intervals you
  501. established to be in the octave; COMP does, however, and will
  502. report errors. This function places a Microtone option line in the 
  503. song.
  504.  
  505.  
  506. IV.B.4.b.iv.6. To mark a Repeat
  507.  
  508. Type the letter "R".
  509. Then enter the label name of the
  510. label marking the beginning of the repeat segment. This label
  511. name is not checked for correctness by EDIT, but it is checked
  512. by COMP. This function places a Repeat option line in the song.
  513.  
  514.  
  515. IV.B.4.b.iv.7. To set or change the Tempo
  516.  
  517. Type the letter "T".  Then enter the number of quarter
  518. notes per minute at which to perform the song segment to follow.
  519. Type a return. The tempo may range from 1 to 999 quarter notes per
  520. minute. This function places a Tempo option line in the song.
  521.  
  522.  
  523. IV.B.4.b.iv.8. To Verify Completeness
  524.  
  525. Type the letter "V". EDIT will scan the song in memory
  526. and verify that all entries are filled. If an empty spot is found
  527. (except for duration adjust), that portion of the song will be
  528. displayed and the cursor placed at the incomplete point. If the
  529. song is complete, the top of the song will be displayed and the
  530. cursor placed at the first line. A song should be checked using
  531. this function before compiling it the song.
  532.  
  533.  
  534. IV.B.4.b.iv.9. To Change Waveforms
  535.  
  536. Type the letter "W". Then enter the waveform table
  537. number to be related to the voice identified by the prompt. 
  538. Follow the number with a return. The
  539. number must be in the range 1 to 14 inclusive. EDIT will repeat its
  540. request for each voice in the song. You must enter an acceptable
  541. table number for each request. This function places a Waveform option 
  542. line in the song.
  543.  
  544.  
  545. IV.B.4.b.iv.10. To End a chorus
  546.  
  547. Type the letter "X". EDIT will insert a Chorus Exit option
  548. line immediately above the line under the cursor when the
  549. option mode was entered.
  550.  
  551.  
  552. IV.B.4.b.iv.11. To Change the Flatted Notes
  553.  
  554. Type a "!" or a 1. EDIT clears any flat
  555. signature and requests entry of the notes to be flatted. Enter
  556. the note names in any order and terminate the sequence with
  557. carriage return. If you enter an unintended note name, press
  558. return immediately and re-do the function. All note names
  559. from A to G are accepted. The flat signature is remembered by EDIT 
  560. only for the duration of the edit session. When you want to edit a 
  561. song which has a key signature, you must reset the signature.
  562.  
  563.  
  564. IV.B.4.b.iv.12. To Change the Sharped Notes
  565.  
  566. Type a "#" or a 2. EDIT clears any sharp signature and requests entry 
  567. of the notes to be sharped. Enter the note names in any order and 
  568. terminate the sequence with a carriage reture. If you enter an 
  569. unintended note name, press return immediately and re-do the 
  570. function. All note names from A to G are accepted. The sharp 
  571. signature is remembered by EDIT only for the duration of the edit 
  572. session. When you want to edit a song which has a key signature, you 
  573. must reset the signature.
  574.  
  575. EDIT will carry both a flat key signature and a sharp key signature 
  576. simultaneously. This can be helpful, especially for the minor keys.
  577. {a:p=1
  578.  
  579.