home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol056 / apnd1.doc < prev    next >
Text File  |  1984-04-29  |  17KB  |  655 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. {c:APPENDIX A
  8.  
  9.  
  10.  
  11. SETUP WORKSHEET
  12.  
  13.  
  14. A. CRT Data
  15.  
  16. The information required in this section can be obtained from the
  17. operator's guide supplied with your terminal. If you are using a 
  18. memory mapped terminal controller, this information is likely 
  19. imbedded in your terminal driver routines.
  20.  
  21. {l:^^^1. Number of lines displayed on CRT (24)^^^^^^^^^^^_____
  22. {l:^^^2. Number of characters per line displayed (80)^^^^_____
  23. {l:^^^3. Cursor Address Data
  24. {l:^^^^^^a. Command Prefix (if any)^^^^^^^^^^^^^^^^^^^^^^_____
  25. {l:^^^^^^b. Command Code^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^_____
  26. {l:^^^^^^c. Address order (check one)
  27. {l:^^^^^^^^^i.  column-row order^^^^^^^^^^^^^^^^^^^^^^^^^_____
  28. {l:^^^^^^^^^ii. row-column order^^^^^^^^^^^^^^^^^^^^^^^^^_____
  29. {l:^^^^^^d. column address description
  30. {l:^^^^^^^^^i.   first range bound (column following)^^^^_____
  31. {l:^^^^^^^^^ii.  first range offset^^^^^^^^^^^^^^^^^^^^^^_____
  32. {l:^^^^^^^^^iii. second range bound (column following)^^^_____
  33. {l:^^^^^^^^^iv.  second range offset^^^^^^^^^^^^^^^^^^^^^_____
  34. {l:^^^^^^e. line address description
  35. {l:^^^^^^^^^i.   first range bound (row following)^^^^^^^_____
  36. {l:^^^^^^^^^ii.  first range offset^^^^^^^^^^^^^^^^^^^^^^_____
  37. {l:^^^^^^^^^iii. second range bound (row following)^^^^^^_____
  38. {l:^^^^^^^^^iv.  second range offset^^^^^^^^^^^^^^^^^^^^^_____
  39. {l:^^^4. Clear to End of Screen Command^^^^^^^^^^^^^^^^^^_____
  40. {l:^^^5. Clear to End of Line Command^^^^^^^^^^^^^^^^^^^^_____
  41.  
  42. {l:B. Microprocessor (check one)
  43. {l:^^^1. 8080A^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^_____
  44. {l:^^^2. 8085^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^_____
  45. {l:^^^3. Z80^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^_____
  46.  
  47. C. Computer Clock Speed^^^^^^^^^^^^^^^^^^^^^^^^^^__________
  48.  
  49. D. Music Board I/O Address (38)^^^^^^^^^^^^^^^^^^^^^^^_____
  50.  
  51. This information is used by PLAY. You can find the required value in
  52. in your Newtech Music Board documentation. If 
  53. you are using some other music generation DAC board, such as the 
  54. Micro Technology Unlimited K-1002 board, then you will have to 
  55. specify the address of your 8-bit output port feeding the board.
  56.  
  57. E. Cursor Control Keys
  58.  
  59. This section allows you to choose keys on the keyboard to 
  60. implement the EDIT cursor functions named. Make sure that you
  61. assign keys which are not otherwise required for the operation
  62. of EDIT.
  63.  
  64. Warning: If you do not get proper results after assigning these 
  65. functions, you should know that the BIOS portion of your operating 
  66. system may contain input "filters" for some characters. This may 
  67. cause EDIT not to receive your input. You have at least two options:
  68. change the function assignment with SETUP, or modify your BIOS.
  69.  
  70. {l:^^^1. Home Function (control_Y)^^^^^^^^^^^^^^^^^^^^^^^_____
  71. {l:^^^2. Up Cursor Function (control_K)^^^^^^^^^^^^^^^^^^_____
  72. {l:^^^3. Left Cursor Function (control_H)^^^^^^^^^^^^^^^^_____
  73. {l:^^^4. Down Cursor Function (control_J)^^^^^^^^^^^^^^^^_____
  74. {l:^^^5. Right Cursor Function (control_L)^^^^^^^^^^^^^^^_____
  75. {l:^^^6. Quit Function (control_Q)^^^^^^^^^^^^^^^^^^^^^^^_____
  76. {l:^^^7. Cancel Function (control_C)^^^^^^^^^^^^^^^^^^^^^_____
  77.  
  78. F. Printer Data
  79.    
  80. If your printer requires more than one character to invoke a page 
  81. advance, then select some number of spaces instead.
  82.    
  83. {l:^^^1. Number of lines to the page (50)^^^^^^^^^^^^^^^^_____
  84. {l:^^^2. Page advance control character (control_L)^^^^^^_____
  85. {l:^^^3. Number of spaces between pages (if no 2 above)^^_____
  86. {a:p=1
  87. {c:APPENDIX B
  88.  
  89.  
  90.  
  91. ERRORS
  92.  
  93. Each program in Musicraft may encounter difficulties either with the
  94. hardware environment or with the data you input. Below is a list of
  95. the errors reported by each program and a description of its meaning
  96. and action to be taken if any.
  97.  
  98.  
  99. EDIT
  100.  
  101. {m:2
  102. {i:-8
  103. 1.
  104. Must quit insert mode. Type <space> to continue.
  105.         
  106. This is not really an error. It means that there are no
  107. additional empty notes in the current voice/duration
  108. column while in the insert mode. Typing a space returns
  109. control to Edit_mode.
  110.  
  111. {i:-8
  112. 2.
  113. Input not <up>, <down> or <quit>. Type <space> to continue.
  114.  
  115. Excise_mode only recognizes the up_key, the down_key (or
  116. return) and the quit_key. Typing space returns control to
  117. Excise_mode as things were before you typed the wrong
  118. key.
  119.  
  120. {i:-8
  121. 3.
  122. Cannot excise terminal lines. Type <space> to continue.
  123.         
  124. The terminal lines (viz., "da capo" and "da end") must remain
  125. with the song for internal control. Typing space
  126. returns control to Excise_mode as things were before
  127. you attempted to remove a terminal line.
  128.         
  129. {i:-8
  130. 4.
  131. Argument not found. Type <space> to continue.
  132.  
  133. If you had attempted to find a label, either you misspelled
  134. the label name or the label name is not present in the song.
  135. Typing space returns control to Edit_mode.
  136.  
  137. {i:-8
  138. 5.
  139. Cannot edit option line. Type <space> to continue.
  140.  
  141. The cursor was on an option line when an unexpected key was
  142. typed. This key may have been duration or voice information
  143. or an incorrect attempt to reach a different mode. Typing
  144. space returns control to the prevailing mode.
  145.  
  146. {i:-8
  147. 6.
  148. Input not note name (A..G, R). Type <space> to continue.
  149.         
  150. The cursor was in a voice column and an unexpected key was
  151. typed. Typing space returns control to the prevailing mode.
  152.  
  153. {i:-8
  154. 7.
  155. Input not microtone. Type <space> to continue.
  156.  
  157. Once a digit is struck when the cursor is in the first position
  158. of a voice column, EDIT presumes that a microtone is intended.
  159. Consequently, you must complete the microtone notation. EDIT
  160. will not accept cursor control input or any other input at this
  161. point, only a single digit. Type a space to return to the
  162. prevailing mode, type a digit, and, if this was not the intent,
  163. move the cursor back to the beginning of the voice column and
  164. make your correction.
  165.  
  166. {i:-8
  167. 8.
  168. Input not accidental (!, @, #). Type <space> to continue.
  169.         
  170. When the cursor is in the second position of a voice column,
  171. EDIT will accept only '!', '1', '@', '"', '2", '#' or '3' or
  172. cursor control, unless it is in Edit_mode, in which case it
  173. will also accept mode change input. Typing space will return
  174. control to the prevailing mode.
  175.  
  176. {i:-8
  177. 9.
  178. Input not octave (1..7). Type <space> to continue.
  179.         
  180. When the cursor is in the third position of a voice column,
  181. EDIT will accept only a digit '1' through '7' or cursor control,
  182. unless it is in Edit_mode, in which case it will also
  183. accept mode change input. Typing space will return control to the 
  184. prevailing mode.
  185.  
  186. {i:-8
  187. 10.
  188. Input not duration (A..K, Q, S, T, W, X). Type <space> to continue.
  189.  
  190. When the cursor is in the first position of the duration column,
  191. EDIT will accept only a valid duration or cursor control,
  192. unless it is in Edit_mode, in which case it will also
  193. accept mode change input. Typing space will return control to the
  194. prevailing mode.
  195.  
  196. {i:-8
  197. 11.
  198. Input not duration (. or :). Type <space> to continue.
  199.  
  200. When the cursor is in the second position of the duration column,
  201. EDIT will accept only a valid duration or cursor control,
  202. unless it is in Edit_mode, in which case it will also
  203. accept mode change input. Typing space will return control to the
  204. prevailing mode.
  205.  
  206. {i:-8
  207. 12.
  208. Number not in range. Reenter  >
  209.         
  210. The number entered is either smaller than the acceptable lower
  211. limit or greater than the acceptable upper limit. Enter a
  212. value which is within range. The range depends on the nature of the 
  213. number requested. It may happen that you are someplace
  214. where you had not intended. To get back to sanity, enter an
  215. acceptable value (usually '1' will work), then proceed. Check
  216. the resulting option line and excise it if necessary.
  217.  
  218.  
  219.  
  220. {m:1
  221. COMP
  222.  
  223. {m:2
  224. {i:-8
  225. 1.
  226. {l:Song not found on disk.
  227. {l:Compile cannot continue.
  228.  
  229. Probably you misspelled the song name. However, check the
  230. diskette...the song may be elsewhere.
  231.  
  232. {i:-8
  233. 2.
  234. {l:No space on disk for song.
  235. {l:Compile cannot continue.
  236.         
  237. The diskette is full. Buy some more.
  238.         
  239. {i:-8
  240. 3.
  241. {l:Number of voices not specified.
  242. {l:Compile cannot continue.
  243.         
  244. {m:1
  245. This error should never happen if the song was created using
  246. EDIT. If the song was created using other means, check that
  247. the first line of the song is a V_opt line and that it is
  248. in the correct format. See appendix D for further information.
  249.         
  250. The next five error messages include the line number of the incorrect
  251. line in the song represented by the 'LLLL'. This information is useful
  252. when using the Find option of EDIT. However, except for error 7, these
  253. errors should never happen if the song was created using EDIT. If the
  254. song was created using other means, check that program for errors.
  255.  
  256. {m:2
  257. {i:-8
  258. 4.
  259. LLLL: unrecognized duration.
  260.  
  261. {i:-8
  262. 5.
  263. LLLL: unrecognized note name (A..G, R).
  264.  
  265. {i:-8
  266. 6.
  267. LLLL: unrecognized accidental (!,@,#).
  268.  
  269. {i:-8
  270. 7.
  271. LLLL: A!1 below available range.
  272.  
  273. PLAY performs notes ranging from A@1 to G#7 inclusive.
  274. EDIT does not check for this note entry, but COMP does.
  275. Return to EDIT to make the necessary modifications.
  276.  
  277. {i:-8
  278. 8.
  279. LLLL: unrecognized octave (1..7).
  280.  
  281. {i:-8
  282. 9.
  283. Label not found.
  284.  
  285. {m:1
  286. Either a repeat option or chorus call option was encountered
  287. for which there is no corresponding label option. Either there
  288. is no label option present or the label name reference is
  289. misspelled. Return to EDIT to make the necessary corrections.
  290.  
  291. {m:2
  292. {i:-8
  293. 10.
  294. {l:Label table overflow.
  295. {l:Compile cannot continue.
  296.         
  297. {m:1
  298. Your song has too many labels for COMP to handle it. COMP
  299. allows 128 labels.
  300.         
  301.  
  302. WAVE
  303.  
  304. {m:2
  305. {i:-8
  306. 1.
  307. {l:No space on disk for song.
  308. {l:Wave cannot continue.
  309.         
  310. {i:-8
  311. 2.
  312. Input not in correct form.
  313.  
  314. {m:1
  315. WAVE requires one integer, or two integers separated by a comma,
  316. and terminated by a carriage return. The first integer must be 
  317. positive and less than 32,768, the second integer must be positive 
  318. and less than 360. Rephrase your entry to fit and continue.
  319.  
  320.  
  321. PLAY
  322.  
  323. {m:2
  324. {i:-8
  325. 1.
  326. {l:Named file not on disk.
  327. {l:Please try again.
  328.  
  329. {i:-8
  330. 2.
  331. {l:Cannot mix voice count.
  332.  
  333. PLAY cannot perform songs with differing numbers of voices.
  334.  
  335. {i:-8
  336. 3.
  337. {l:Unrecognized special function code.
  338. {l:Player cannout continue.
  339.  
  340. This error should never happen if the song was created
  341. using EDIT. If the song was created using other means, check the 
  342. source.
  343.  
  344. {i:-8
  345. 4.
  346. {l:Requested measure not in song.
  347. {l:Enter starting measure number  >
  348.  
  349. The number of the last measure (if any) is less than the number you 
  350. have requested.
  351.  
  352. {m:1
  353. There are several conditions which can lead to difficulties and
  354. can be considered errors but are not detected by the system.
  355.  
  356. {m:2
  357. {i:-8
  358. 1.
  359. Overlapped repeats. See the example in the Repeat Function
  360. section of the Option Line portion of the manual.
  361.  
  362. {i:-8
  363. 2.
  364. Self calling song segments. This is discussed in the Chorus
  365. Function section of the Option Line portion of the manual.
  366.  
  367. {i:-8
  368. 3.
  369. Two exits without intervening label. The song segment between
  370. the two exits is never performed as there is no way for PLAY
  371. to get to it without a label.
  372.         
  373. {i:-8
  374. 4.
  375. Wrong notes. Error in the edit person.
  376. {m:1
  377. {a:p=1
  378. {c:APPENDIX C
  379.  
  380.  
  381.  
  382. FILES:
  383.  
  384. Musicraft makes distinctions among the different kinds of files used
  385. to make music by using different file type identifiers along with
  386. the song_name given to a song.
  387.  
  388. {m:2
  389. {i:-8
  390. 1.
  391. Files with a .SNG type are songs which can be editted
  392. or compiled. This type of file can be printed using the
  393. PRINT program provided as part of the Musicraft system
  394. for later reference or for archival use.
  395.  
  396. {i:-8
  397. 2.
  398. Files with a .SBK type are backup copies of .SNG songs
  399. and are provided in the event your primary .SNG file
  400. is inadvertently destroyed. You would normally use the
  401. REN command to convert the .SBK type to the required
  402. .SNG type for EDIT should that become necessary.
  403.  
  404. {i:-8
  405. 3.
  406. Files with a .SCD type are the compiled versions of
  407. songs which are ready to be played. Files of this type
  408. cannot be printed because they are stored on floppy
  409. disk as binary data.
  410.  
  411. {i:-8
  412. 4.
  413. Files with a .WAV type are waveform tables which were
  414. created using the WAVE program and are ready for use
  415. to play music. Files of this type are also unprintable
  416. for the same reason as applies to the .SCD type.
  417.  
  418. {i:-8
  419. 5.
  420. Files with a .CNF type are configuration files which describe the 
  421. hardware configuration for various programs in the system. Actually, 
  422. one such file will exist on the system diskette and its full name is 
  423. always SONG.CNF.
  424.  
  425. {m:1
  426. Thus, if you had entered a song called SONATA into the computer
  427. storage, and had compiled it, you would find the following files
  428. on your diskette when you displayed the directory using XDIR.
  429.  
  430. {m:2
  431. {l:SONATA.SNG
  432. {l:SONATA.SBK
  433. {l:SONATA.SCD
  434.  
  435. {m:1
  436. If you had performed the same steps for FUGUE, then the directory
  437. would also contain the following files.
  438.  
  439. {m:2
  440. {l:FUGUE.SNG
  441. {l:FUGUE.SBK
  442. {l:FUGUE.SCD
  443.  
  444. {m:1
  445. If you had a waveform table called SINE, then the directory would
  446. show an entry of
  447.  
  448. {m:2
  449. {l:SINE.WAV
  450. {m:1
  451. {a:p=1
  452. {c:APPENDIX D
  453.  
  454.  
  455.  
  456. SONG FILE FORMAT
  457.  
  458. As you become more proficient in the use of Musicraft, you may wish
  459. to build songs using your own programs to be compiled and
  460. performed. This section describes the format of the .SNG type file.
  461.  
  462. The .SNG file is comprised of a set of 15-byte records, each being
  463. either a song line or an option line.
  464.  
  465. Song Line:
  466.  
  467. A song line contains six fields.
  468.  
  469. {m:2
  470. {i:-8
  471. 1.
  472. A period ('.') to indicate that the record is a song line.
  473. {i:-8
  474. 2.
  475. The duration field
  476. {i:-8
  477. 3.
  478. Voice 1 field
  479. {i:-8
  480. 4.
  481. Voice 2 field
  482. {i:-8
  483. 5.
  484. Voice 3 field
  485. {i:-8
  486. 6.
  487. Voice 4 field.
  488.  
  489. {m:1
  490. The duration field is two bytes long and can contain any of the valid
  491. duration values as described in the Song Line section of the manual
  492. (eg., H. for dotted half note).
  493.  
  494. The voice fields are all three bytes long and can contain any of the
  495. valid note values (viz., note name and accidental or microtone number
  496. followed by the octave number; eg., C@4 for middle C). Only the voices
  497. actually used in the song are filled in since the remaining voices will
  498. be ignored by COMP.
  499.  
  500. Option Line:
  501.  
  502. The format of an option line depends on the option line type. However,
  503. all option lines begin with an asterisk ('*') followed by a blank.
  504. The following table describes each option line format.
  505.  
  506. {m:5=25,53
  507. {m:5
  508. {i:-16
  509. Option^^Field^^^Meaning
  510.         
  511. {i:-16
  512. Call^a^chorus
  513. {i:-6
  514. 1
  515. 'C' to indicate the function
  516. {i:-6
  517. 2
  518. one blank
  519. {i:-6
  520. 3
  521. eight byte field containing the label
  522. name reference.
  523. {l:ex.     *C LABEL
  524.  
  525. {i:-16
  526. Label^a^song^line
  527. {i:-6
  528. 1
  529. 'L' to indicate the function
  530. {i:-6
  531. 2
  532. one blank
  533. {i:-6
  534. 3
  535. eight byte field containing the label name
  536. {i:-6
  537. 4
  538. one blank
  539. {i:-6
  540. 5
  541. one byte label key value.
  542. {l:ex.     *L LABEL
  543.  
  544. {i:-16
  545. Mark^a^measure
  546. {i:-6
  547. 1
  548. 'M' to indicate the function
  549. {i:-6
  550. 2
  551. one blank
  552. {i:-6
  553. 3
  554. four byte field containing the measure number
  555. right justified and zero filled.
  556. {l:ex.     *M 0034
  557.  
  558. {i:-16
  559. Set^or^change^the^number^of^intervals
  560. in the octave
  561. {i:-6
  562. 1
  563. '#' to indicate the function
  564. {i:-6
  565. 2
  566. one blank
  567. {i:-6
  568. 3
  569. two byte field containing the number of
  570. intervals in the octave right justified
  571. and zero filled.
  572. {l:ex.     *# 48
  573.  
  574. {i:-16
  575. Mark^a^repeat^(or^jump)
  576. {i:-6
  577. 1
  578. 'R' to indicate the function
  579. {i:-6
  580. 2
  581. one blank
  582. {i:-6
  583. 3
  584. eight byte field containing the label name
  585. reference
  586. {i:-6
  587. 4
  588. one blank
  589. {i:-6
  590. 5
  591. three byte field containing the number of
  592. repeats right justified and zero filled.
  593. {l:ex.     *R LABEL   005
  594.  
  595. {i:-16
  596. Set^or^change^the^tempo
  597. {i:-6
  598. 1
  599. 'T' to indicate the function
  600. {i:-6
  601. 2
  602. one blank
  603. {i:-6
  604. 3
  605. three byte field containing the tempo as
  606. a number right justified and zero filled.
  607. {l:ex.     *T 144
  608.  
  609. {i:-16
  610. Set^the^voice
  611. {i:-6
  612. 1
  613. 'V' to indicate the function (see note below)
  614. {i:-6
  615. 2
  616. one blank
  617. {i:-6
  618. 3
  619. one byte field containing the number of
  620. voices the value of which must be between
  621. one and four.
  622. {l:ex.     *V 3
  623.  
  624. {i:-16
  625. Mark^the^exit^of^a^chorus^or^song
  626. {i:-6
  627. 1
  628. 'X' to indicate the function.
  629. {l:ex.     *X
  630.  
  631. {m:1
  632. Note carefully: the first record in any .SNG file MUST be a V_opt line.
  633. Moreover, only one V_opt line may appear in the song.
  634.  
  635. Song lines and option lines must obey all rules given in the manual.
  636.  
  637. While EDIT does not generate carriage returns and line feeds between
  638. records, it will accept them and eliminate them from the song file.
  639. If a song file is created using BASIC, it will probably contain
  640. not only carriage returns and line feeds but also single or double
  641. quotation marks. Neither EDIT nor COMP will accept quote marks so
  642. you will need to remove them before you use either of the programs
  643. to work with the song. This can be done easily using the CP/M editor.
  644. Use the following dialog.
  645.  
  646. {l:A>^^ED^songname^(press^return)
  647. {l:*^^^#A^(press^return)
  648. {l:*^^^B#S'<control_Z><control_Z>^(press^return)
  649. {l:*^^^B#S"<control_Z><control_Z>^(press^return)
  650. {l:*^^^E^(press^return)
  651. {l:A>
  652. {a:p=1
  653.  
  654.  
  655.