home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol056 / intro.doc < prev    next >
Text File  |  1984-04-29  |  16KB  |  404 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.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14. {c:The MUSICRAFT Development System
  15.  
  16.  
  17.  
  18.  
  19. {c:USER'S GUIDE AND OPERATING MANUAL
  20.  
  21.  
  22.  
  23. {c:by Paul J. Medlock
  24. {c:Computercraft
  25. {c:1031 Marlau Dr
  26. {c:Baltimore MD 21212
  27.  
  28.  
  29.  
  30. {c:authorized distributor:
  31. {c:NEWTECH COMPUTER SYSTEMS, Inc.
  32. {c:230 Clinton St
  33. {c:Brooklyn NY 11201
  34. {c:(212)625-6220
  35.  
  36.  
  37.  
  38. {a:p=1
  39. {c:Copyright (c) 1980 by Paul J Medlock
  40. {c:Computercraft
  41.  
  42.  
  43. {c:All rights reserved.
  44.  
  45. No part of this publication may be reproduced, transmitted, 
  46. transcribed, stored in a retrieval system, or translated into any 
  47. language or computer language, in any form or by any means, 
  48. electronic, mechanical, magnetic, optical, chemical, manual or 
  49. otherwise, without the prior written permission of Computercraft, 
  50. Baltimore, Maryland.
  51.  
  52.  
  53.  
  54. {c:Disclaimer
  55.  
  56. Computercraft makes no representations or warranties with respect to 
  57. the contents hereof and specifically disclaims any implied warranties 
  58. of merchantability or fitness for any particular purpose. Further, 
  59. Computercraft reserves the right to revise this publication and to 
  60. make changes from time to time in the content hereof without 
  61. obligation of Computercraft to notify any person of such revision or 
  62. changes.
  63.  
  64. This publication does not convey to the purchaser any rights to any 
  65. software not identified by this publication as part of the Musicraft 
  66. Development System.
  67.  
  68. CP/M is referred to in this manual. CP/M is a trademark of Digital 
  69. Research Corporation. No rights of use of CP/M are conveyed to the
  70. purchaser by any reference to CP/M in this publication.
  71. {a:p=1
  72. TABLE OF CONTENTS
  73.  
  74. {l:I.           INTRODUCTION^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^6
  75. {l:I.A.             The Music^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^6
  76. {l:I.B.             The System^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^7
  77. {l:I.B.1.               The Editor^^^^^^^^^^^^^^^^^^^^^^^^^^9
  78. {l:I.B.2.               The Compiler^^^^^^^^^^^^^^^^^^^^^^^^9
  79. {l:I.B.3.               The Waveform Generator^^^^^^^^^^^^^^9
  80. {l:I.B.4.               The Player^^^^^^^^^^^^^^^^^^^^^^^^^^9
  81. {l:I.B.5.               Setup^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^10
  82. {l:I.B.6.               Print^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^10
  83. {l:I.C.             The Requirements^^^^^^^^^^^^^^^^^^^^^^^10
  84.  
  85. {l:II.          INITIAL CHECKOUT^^^^^^^^^^^^^^^^^^^^^^^^^^^11
  86.  
  87. {l:III.         MUSIC NOTATION SYSTEM^^^^^^^^^^^^^^^^^^^^^^15
  88. {l:III.A.           Song File^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^15
  89. {l:III.B.           Song Line^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^15
  90. {l:III.B.1.             Line Number^^^^^^^^^^^^^^^^^^^^^^^^15
  91. {l:III.B.2.             Duration^^^^^^^^^^^^^^^^^^^^^^^^^^^15
  92. {l:III.B.3.             Voice^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^16
  93. {l:III.C.           Microtones^^^^^^^^^^^^^^^^^^^^^^^^^^^^^19
  94. {l:III.D.           Option Lines^^^^^^^^^^^^^^^^^^^^^^^^^^^19
  95.  
  96. {l:IV.          PROGRAM DESCRIPTION^^^^^^^^^^^^^^^^^^^^^^^^21
  97. {l:IV.A.            SETUP^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^21
  98. {l:IV.A.1.              Command Sequence^^^^^^^^^^^^^^^^^^^21
  99. {l:IV.A.2.              Discussion^^^^^^^^^^^^^^^^^^^^^^^^^21
  100. {l:IV.B.            EDIT^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^22
  101. {l:IV.B.1.              Command Sequence^^^^^^^^^^^^^^^^^^^22
  102. {l:IV.B.2.              Introduction^^^^^^^^^^^^^^^^^^^^^^^22
  103. {l:IV.B.3.              Tutorial^^^^^^^^^^^^^^^^^^^^^^^^^^^22
  104. {l:IV.B.3.a.               Navigation^^^^^^^^^^^^^^^^^^^^^^24
  105. {l:IV.B.3.a.i.                 The Home Function^^^^^^^^^^^24
  106. {l:IV.B.3.a.ii.                The Direction Function^^^^^^24
  107. {l:IV.B.3.a.iii.               The Page Function^^^^^^^^^^^25
  108. {l:IV.B.3.a.iv.                The Cursor Functions^^^^^^^^25
  109. {l:IV.B.3.a.v.                 The Space Function^^^^^^^^^^26
  110. {l:IV.B.3.a.vi.                The Modes of EDIT^^^^^^^^^^^26
  111. {l:IV.B.3.a.vi.1.                  Edit Mode^^^^^^^^^^^^^^^27
  112. {l:IV.B.3.a.vi.2.                  Insert Mode^^^^^^^^^^^^^28
  113. {l:IV.B.3.a.vi.3.                  Excise Mode^^^^^^^^^^^^^28
  114. {l:IV.B.4.              Reference^^^^^^^^^^^^^^^^^^^^^^^^^^30
  115. {l:IV.B.4.a.               Quit^^^^^^^^^^^^^^^^^^^^^^^^^^^^30
  116. {l:IV.B.4.b.               The Modes of EDIT^^^^^^^^^^^^^^^30
  117. {l:IV.B.4.b.i.                 Edit Mode^^^^^^^^^^^^^^^^^^^31
  118. {l:IV.B.4.b.i.1.                   Menu^^^^^^^^^^^^^^^^^^^^31
  119. {l:IV.B.4.b.i.2.                   d(irection^^^^^^^^^^^^^^31
  120. {l:IV.B.4.b.i.3.                   text^^^^^^^^^^^^^^^^^^^^31
  121. {l:IV.B.4.b.i.4.                   cursors^^^^^^^^^^^^^^^^^32
  122. {l:IV.B.4.b.i.5.                   I(nsert^^^^^^^^^^^^^^^^^32
  123. {l:IV.B.4.b.i.6.                   X(cise^^^^^^^^^^^^^^^^^^33
  124. {l:IV.B.4.b.i.7.                   O(ptions^^^^^^^^^^^^^^^^33
  125. {l:IV.B.4.b.i.8.                   M(easure^^^^^^^^^^^^^^^^33
  126. {l:IV.B.4.b.i.9.                   quit^^^^^^^^^^^^^^^^^^^^33
  127. {l:IV.B.4.b.ii.                Insert Mode^^^^^^^^^^^^^^^^^33
  128. {l:IV.B.4.b.ii.1.                  Menu^^^^^^^^^^^^^^^^^^^^33
  129. {l:IV.B.4.b.ii.2.                  d(irection^^^^^^^^^^^^^^33
  130. {l:IV.B.4.b.ii.3.                  text^^^^^^^^^^^^^^^^^^^^33
  131. {l:IV.B.4.b.ii.4.                  cursors^^^^^^^^^^^^^^^^^34
  132. {l:IV.B.4.b.ii.5.                  M(easure^^^^^^^^^^^^^^^^34
  133. {l:IV.B.4.b.ii.6.                  quit^^^^^^^^^^^^^^^^^^^^34
  134. {l:IV.B.4.b.ii.7.                  Discussion^^^^^^^^^^^^^^34
  135. {l:IV.B.4.b.iii.               Excise Mode^^^^^^^^^^^^^^^^^35
  136. {l:IV.B.4.b.iii.1.                 Menu^^^^^^^^^^^^^^^^^^^^35
  137. {l:IV.B.4.b.iii.2.                 d(irection^^^^^^^^^^^^^^35
  138. {l:IV.B.4.b.iii.3.                 cursors^^^^^^^^^^^^^^^^^35
  139. {l:IV.B.4.b.iii.4.                 quit^^^^^^^^^^^^^^^^^^^^35
  140. {l:IV.B.4.b.iv.                Options Mode^^^^^^^^^^^^^^^^36
  141. {l:IV.B.4.b.iv.1.                  Menu^^^^^^^^^^^^^^^^^^^^36
  142. {l:IV.B.4.b.iv.2.                  Chorus Call^^^^^^^^^^^^^36
  143. {l:IV.B.4.b.iv.3.                  Find^^^^^^^^^^^^^^^^^^^^36
  144. {l:IV.B.4.b.iv.4.                  Label^^^^^^^^^^^^^^^^^^^37
  145. {l:IV.B.4.b.iv.5.                  Microtones^^^^^^^^^^^^^^38
  146. {l:IV.B.4.b.iv.6.                  Repeat^^^^^^^^^^^^^^^^^^38
  147. {l:IV.B.4.b.iv.7.                  Tempo^^^^^^^^^^^^^^^^^^^38
  148. {l:IV.B.4.b.iv.8.                  Verify^^^^^^^^^^^^^^^^^^38
  149. {l:IV.B.4.b.iv.9.                  Waveforms^^^^^^^^^^^^^^^38
  150. {l:IV.B.4.b.iv.10.                 Chorus End^^^^^^^^^^^^^^39
  151. {l:IV.B.4.b.iv.11.                 Flat Signature^^^^^^^^^^39
  152. {l:IV.B.4.b.iv.12.                 Sharp Signature^^^^^^^^^39
  153. {l:IV.C.            COMP^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^40
  154. {l:IV.C.1.              Command Sequence^^^^^^^^^^^^^^^^^^^40
  155. {l:IV.C.2.              Discussion^^^^^^^^^^^^^^^^^^^^^^^^^40
  156. {l:IV.D.            WAVE^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^40
  157. {l:IV.D.1.              Command Sequence^^^^^^^^^^^^^^^^^^^40
  158. {l:IV.D.2.              Introduction^^^^^^^^^^^^^^^^^^^^^^^40
  159. {l:IV.D.3.              The Fundamental^^^^^^^^^^^^^^^^^^^^41
  160. {l:IV.D.4.              The Second Harmonic^^^^^^^^^^^^^^^^42
  161. {l:IV.D.5.              The Square Wave^^^^^^^^^^^^^^^^^^^^43
  162. {l:IV.D.6.              Additional Waveforms^^^^^^^^^^^^^^^44
  163. {l:IV.E.            PLAY^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^45
  164. {l:IV.E.1.              Command Sequence^^^^^^^^^^^^^^^^^^^45
  165. {l:IV.E.2.              Song Load^^^^^^^^^^^^^^^^^^^^^^^^^^45
  166. {l:IV.E.3.              Waveform Table Load^^^^^^^^^^^^^^^^45
  167. {l:IV.E.4.              Continuation^^^^^^^^^^^^^^^^^^^^^^^47
  168. {l:IV.E.5.              Interaction^^^^^^^^^^^^^^^^^^^^^^^^48
  169. {l:IV.E.5.a.                Rehearsal Mode^^^^^^^^^^^^^^^^^48
  170. {l:IV.E.5.b.                Modified Performance Mode^^^^^^48
  171.  
  172. {a:p=1
  173. {l:V.           OPTION LINE DESCRIPTIONS^^^^^^^^^^^^^^^^^^^51
  174. {l:V.A.             Chorus Function^^^^^^^^^^^^^^^^^^^^^^^^51
  175. {l:V.B.             Repeat Function^^^^^^^^^^^^^^^^^^^^^^^^52
  176. {l:V.C.             Chorus Call Option Line^^^^^^^^^^^^^^^^54
  177. {l:V.D.             Label Option Line^^^^^^^^^^^^^^^^^^^^^^55
  178. {l:V.E.             Measure Option Line^^^^^^^^^^^^^^^^^^^^56
  179. {l:V.F.             Microtone Option Line^^^^^^^^^^^^^^^^^^56
  180. {l:V.G.             Repeat Option Line^^^^^^^^^^^^^^^^^^^^^57
  181. {l:V.H.             Tempo Option Line^^^^^^^^^^^^^^^^^^^^^^57
  182. {l:V.I.             Waveform Option Line^^^^^^^^^^^^^^^^^^^58
  183. {l:V.J.             Chorus Exit Option Line^^^^^^^^^^^^^^^^58
  184.  
  185. {l:             APPENDICES
  186. {l:                 A. SETUP WORKSHEET^^^^^^^^^^^^^^^^^^^^^60
  187. {l:                 B. ERROR MESSAGES^^^^^^^^^^^^^^^^^^^^^^62
  188. {l:                 C. FILE TYPES^^^^^^^^^^^^^^^^^^^^^^^^^^67
  189. {l:                 D. SONG FILE FORMAT^^^^^^^^^^^^^^^^^^^^69
  190.  
  191.  
  192. {a:p=1
  193. I. INTRODUCTION
  194.  
  195. The Musicraft Development System is a sophisticated facility for
  196. the composition and performance of music operating under CP/M
  197. (trademark of Digital Research.) It uses a language easily
  198. understood and used by any person with even a rudimentary ability
  199. to read music, yet it is capable of a wide spectrum of musical
  200. techniques and sound effects. Classical, popular and contemporary
  201. styles can be realized effectively with Musicraft, and its
  202. interactive nature makes Musicraft attractive to the performing
  203. musician as well as the composer and listener.
  204.  
  205.  
  206. I.A. The Music
  207.  
  208. Songs may contain from one to four voices. Each voice has a full
  209. seven octave range beginning at 27.5 Hertz. A song may be performed
  210. using up to 14 different waveforms; each voice can be assigned
  211. to any waveform. Additionally, as the performance progresses,
  212. voice-waveform relationships can be varied. The waveforms can
  213. be drawn from as large a pool of waveform files as you have developed,
  214. and you can choose different waveforms from performance to performance
  215. of the same song.
  216.  
  217. Music can contain measures, repeats, refrains and even microtones.
  218. Microtones are useful for contemporary sounds, eastern music, and
  219. especially for slides and glissandi. The octave can be divided into
  220. as many as 99 intervals. Using, for example, 96 intervals can permit
  221. a very smooth glissando.
  222.  
  223. Refrains, or choruses, are a very powerful structural tool in
  224. Musicraft: your music can call a chorus which, in turn, can call
  225. a chorus which, in turn, can call a chorus... until you are dizzy
  226. with structural developments. Chorus nests can be up to 16 deep.
  227.  
  228. Any song segment can be repeated up to as many as 256 times with a
  229. single repeat.
  230.  
  231. Measures serve two important functions. While you are editing your
  232. song, you can easily locate music using the measure. More interestingly,
  233. however, measures can be used by the performing musician for practice
  234. by the "Music Minus One" method. Play your song leaving out a waveform
  235. table for one voice and play your own instrument. As you
  236. practice, if you need to restart at a measure, press return, enter
  237. the measure number, and after a short pause (to allow you to prepare)
  238. the music will begin at that measure.
  239.  
  240. All songs and waveform tables, along with backup files where
  241. appropriate, are maintained on floppy disk, and access by the system
  242. components is completely automatic. Multiple drive storage is also
  243. supported by all programs.
  244.  
  245.  
  246. I.B. The System
  247.  
  248. Six interrelated machine language programs perform specific tasks
  249. required in making music.
  250. {m:3
  251.  
  252. {i:-8
  253. Name
  254. Function
  255.         
  256. {i:-8
  257. EDIT
  258. Enter music by transcription or composition into the computer
  259. storage and change music already stored.
  260.  
  261. {i:-8
  262. COMP
  263. Convert (or compile) music from the musical notation into a
  264. numerical form suitable for performance by PLAY.
  265.  
  266. {i:-8
  267. WAVE
  268. Create and save new sound colors (also called waveforms or
  269. instruments) to be used by PLAY in the performance of music.
  270.  
  271. {i:-8
  272. PLAY
  273. Bring the music together with the instruments and perform the
  274. combination.
  275.  
  276. {m:1
  277. {l:Two additional programs are provided to support the system.
  278. {m:3
  279.  
  280. {i:-8
  281. SETUP
  282. Tailor the programs to your system.
  283.         
  284. {i:-8
  285. PRINT
  286. Obtain a printed "score" of the music once the music has been
  287. entered into the computer storage.
  288.  
  289. {m:1
  290. Study the diagram on the next page. It shows the relationships
  291. among the six programs and the way in which files are passed from one
  292. to the other.
  293. {a:p=2
  294. I.B.1. The Editor
  295.  
  296. EDIT is a screen editor knowledgeable in the musical notation used. It
  297. checks your entries to insure validity and provides complete error
  298. reporting. Navigation within a song is easy with EDIT, with full cursor
  299. control as well as page and home functions. You can find
  300. locations within your song using measures, song lines or labels.
  301. EDIT supports a powerful form of key signature and remembers
  302. accidentals within the measure.
  303.  
  304. You use EDIT in four different modes. Edit, Insert, Excise and
  305. Option. EDIT always begins in the edit mode while the other
  306. modes are accessible with a single keystroke. The Edit mode is
  307. intended for making corrections in already existing music. The
  308. Insert mode permits you to add new song lines and to enter voice
  309. and duration data conveniently. Excise mode allows the removal of
  310. song lines, and the Option mode supports the wide variety of secondary
  311. musical functions as well as additional edit facilities.
  312.  
  313.  
  314. I.B.2. The Compiler
  315.  
  316. After you have entered your song, running the compiler will give you
  317. a playable song file. To insure adequate precision, floating point
  318. arithmetic is used for all calculations. As COMP compiles your song,
  319. you are kept informed of progress by the CRT display.
  320.  
  321.  
  322. I.B.3. The Waveform Generator
  323.  
  324. With WAVE, you create different sounds for later use in performance.
  325. Four techniques are provided. You can use the Fourier series method
  326. to build waveforms using the sine wave...your waveform may contain
  327. up to 16 partials, each with its own amplitude and phase. Additionally,
  328. you can easily construct sawtooth, triangle and square waves.
  329.  
  330.  
  331. I.B.4. The Player
  332.  
  333. PLAY allows you to load one or more songs into memory for performance.
  334. As it loads the songs, it remembers the waveforms requested by
  335. the different voices and then allows you to fill waveform tables
  336. with whatever waveforms you would like. The music is then performed.
  337.  
  338. PLAY offers three methods of performance. You may simply let the
  339. music play just as you entered it with EDIT. Or if you need a partner
  340. with whom to practice your own instrument, it can operate in
  341. a "rehearsal" 
  342. mode.  Finally, you may interact with
  343. the performance by using the keyboard of your terminal as a
  344. programmable interface. Using the Label option of EDIT, you can
  345. easily associate any musical idea (a single note, chord, or even
  346. a whole melody line) with any key on your keyboard (excluding
  347. control keys). As the music is performed, press a key that you
  348. have related to a song segment. No matter where in the song that
  349. segment was coded, PLAY will play it. Press another key. Again,
  350. whatever song segment you related to that key will play.
  351.  
  352.  
  353. I.B.5. Setup
  354.  
  355. SETUP is provided because no two computer systems are alike.
  356. The 8080A, 8085 and Z80 microprocessors are all different in
  357. subtle ways. Many different terminals are attached to those
  358. systems, each with different control codes and functions
  359. that they can support. The clock speed can vary considerably
  360. from one system to another. SETUP asks questions about your
  361. system and saves your answers for use by the other components
  362. of Musicraft.  Musicraft will run on a wide variety of equipment
  363. because of the flexibility of SETUP.
  364.  
  365.  
  366. I.B.6. Print
  367.  
  368. PRINT prints your song so you can file it for later use in the
  369. event your diskette file is lost.
  370.  
  371.  
  372. I.C. The Requirements
  373.  
  374. Musicraft will operate on your microcomputer if you can satisfy
  375. the following requirements.
  376.  
  377. {m:2
  378. {i:-8
  379. 1.
  380. An 8080A, 8085 or Z80 based microcomputer
  381. {i:-8
  382. 2.
  383. 24k or more bytes of memory (32k or more bytes for North Star)
  384. {i:-8
  385. 3.
  386. A CP/M, CDOS or other compatible operating system
  387. {i:-8
  388. 4.
  389. A user's understanding of the operating system
  390. {i:-8
  391. 5.
  392. One or more floppy disk drives
  393. {i:-8
  394. 6.
  395. A CRT terminal with absolute cursor addressing and at least 64
  396. characters per line
  397. {i:-8
  398. 7.
  399. A digital-to-analog convertor connected to the computer through
  400. an addressable 6- or 8-bit parallel output port. (A good example
  401. of this is the Newtech model-6 Music Board)
  402. {a:p=1
  403.  
  404.