home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 067.lha / Drw / drw.doc < prev    next >
Encoding:
Text File  |  1986-11-20  |  8.1 KB  |  161 lines
  1.      Some spotty documentation for the DRW program
  2.  
  3.  
  4. Introduction:
  5.    DRW is a sonic spectrum editor. It allows you to paint a sonogram
  6. using specialized 'brushes' and then synthesize the corresponding 
  7. audio waveform. The program presents you with a grey area where
  8. time is on the x-axis, frequency (actually phase increment) is on the
  9. y-axis and color represents the amplitude of the sinewave at that point
  10. in time and phase. Sonograms may be loaded and stored, sound files
  11. may be analyzed into sonograms and resulting sounds may be saved as 
  12. IFF 8SVX files. It allows you to play the sound (both channels) with the
  13. mouse controlling frequency.
  14.  
  15. Caution:
  16.    This is an extremely quick and dirty program which reads the color
  17.  values directly off the screen. There is no 'UNDO'. Because it is
  18. written in CSI Multi-forth, certain operations are slower than they
  19. need to be.  Filename handling may be unfriendly should you make a
  20. typo or two. There are several other annoying things  that I won't
  21. mention.
  22.  
  23.   The Screen:
  24. The screen presents a 128 by 256 pixel drawing area, surmounted by
  25. a color palette of 30 colors, ranging from grey(0) through blue, black,
  26. red, orange and yellow(255). Beneath the palette is the control comb,
  27. which selects various brushes and drawing options. On the right is a
  28. pathetic pseudo-prop gadget which controls certain drawing characteristics.
  29.   
  30.   The MODES:
  31. There are several states into which the program may be put: all of them are
  32. accessed via the keyboard buttons. They are:
  33.  T)op D)oodle S)ynth P)lay R)eset  W)rite B)andpass I)input O)utput Q)uit
  34.  
  35.  T)op mode: clears the screen to grey ( amplitude 0), then goes directly to    
  36. D)oodle mode.
  37.  
  38.  D)oodle mode is the main drawing mode. It works with the comb to allow
  39. the sonogram to be drawn. To use the comb, you click on one of the tines.
  40. A user-unfriendly 4 letter  mnemonic appears on the right of the screen, 
  41. along with its corresponding number .
  42.  
  43.  Here are the various options which this enables:
  44. 1) Dot  A dot of the selected color is continuously dropped on
  45.         the screen  while the left mouse button is depressed.
  46. 2) Line A continuous line is drawn while the button is down. Note that
  47.         the line cannot be drawn from right to left.. to encourage
  48.         'proper temporal flow'.
  49. 3) Ramp A line at this frequency is 'ramped' up to the selected color,
  50.         and then ramped down. The rate of ramping is controlled by the
  51.         phony prop gadget. The ramp is summed into the color on the
  52.         screen.
  53. 4) Thin A thin Rectangle is deposited, much as a dot is.
  54. 5) Blob A rather fat rectangle is deposited.
  55. 6) Harm A ramp in the suitable color and rate is summed into the screen
  56.         at harmonics determined by the current Frequency space settings.
  57.         The Pointer represents the eighth harmonic. Only writes forward, 
  58.         and connects points continuously. This is is admittedly slower than 
  59.         it could be. Harm can be used to create a harmonic framework for
  60.         subsequent   alterations.
  61. 7) Avg  Averages a few pixels before and after the pointer for this
  62.         frequency.
  63. 8) R-Dn Ramps down from the color under the pointer, using the rate from
  64.         the prop gadget.
  65. 9) R-Up Ramps up (backwards) from the pointer position, like ramp down.
  66. 10) Fill Fills this frequency with this color, until it hits a color
  67.          differing from that under the pointer.
  68. 11) Fil2 Tries to do a ramp-fill up to the selected color to the colors
  69.          at the edges. Doesn't work.
  70. 12) Inc Adds one to the spot under the pointer. GOes forward.
  71. 13) Dec Decrements this spot by one.
  72. 14) Xcld Excludes all but harmonics at this time period. The pointer
  73.          represents the eighth harmonic.
  74. 15) -Cut removes all colors quieter than the current one from the 
  75.          sonogram. Nice for cleaning BPFs. 
  76. 16) Inc0 Increments if there is a non-grey color under the pointer. For
  77.          making soft areas louder.
  78. 17) Dec0 Decrement, but not down to grey - just to green.
  79. 18) From sets the 'from' point for a Copy. You must click the left button.
  80. 19) To   sets the 'to' spot for a copy.
  81. 20) Copy Copies 'pantograph'-style for those of you who remember Images,
  82.          based on the 'from area' going to the 'to' area.
  83. 21) .21. nothing
  84. 22) AMmd Puts some AM sin-waves on the screen as raw material.
  85. 23) CpFr Copies a frequency line to new Mouse's freq. Uses From.
  86. 24) CpTm Copies a time slot to new Mouse's slot. ditto.
  87. 25) Lck1 Puts a  lock on every frequency. A harmonic lock crudely constrains
  88.          certain brushes from being positioned anywhere but on the nth line.
  89.          Allows stable  harmonic timbres to be easily created for use
  90.          as loops.
  91. 26) Lck2 Locks even lines.
  92. 27) Lck4 Locks every 4th line.
  93. 28) Lck8 Locks every 8th line.
  94. 29) Vl00 restores original amplitude boost.
  95. 30) Vl01 doubles amplitude when Synthing the sample.
  96.  
  97. S)ynth zero's the sound area and then creates the waveform by additive
  98. synthesis. You may cut the sound short by typing 'P' to go directly to
  99. play mode. This may be slow at times, but it depends on the current 
  100. time and frequency settings. Technicians will note that I am using
  101. fixed point arithmetic and a custom sin-lookup table to make this
  102. calculation.
  103.   
  104. P) Play plays the sound area. Moving the mouse vertically changes the
  105. Amiga 'period' (i.e. frequency.)
  106.  
  107. The following modes require some names and numbers from the keyboard.
  108.  
  109. R)eset resets the frequency and time spaces. It flips to the workbench 
  110. input console window. The first number is the
  111. number of samples each pixel on the x-axis represents (1-256). The second
  112. is the phase harmonic spacing of the frequency lines. In this system,
  113. 2pi=1024*256. Since there are 128 lines, aliasing begins at about
  114. 2048 so restrict yourself below this. An equivalent  Hz value is
  115. displayed (assuming a period which corresponds to a sample frequency of
  116. 15040 KHz). The last number is the frequency offset, which allows you to
  117. position the screen away from frequncy zero and use closely spaced
  118. frequencies which are nevertheless audible. The screen will flip back
  119. after a second allowed for you to digest this info.
  120.  
  121. W)rite writes the sound area to an IFF sample file, for use by such programs
  122. as may use IFF samples. A filename is prompted for, and a number of octaves
  123. (which merely decimates the sample).Note this doesn't work too well,
  124. since a) my octave chopper is very crude (it skips samples instead of
  125. filtering) and b) I am confused by the 8Svx spec. If you stick with 
  126. 1 Octave and use other software to fix the sample, it's OK.
  127.  
  128. B)andpass is the heterodyne filter. A name of a sound file is prompted for,
  129. then a starting offset within the file (so you may skip to an interesting
  130. section) and then the record 'k' is asked for, which is the record size
  131. log to base 2 (i.e. 5=32, 10=1024 ...) under 7 is pretty speedy, but decent
  132. usable work appears at about 9 or 10. This picks up information from
  133. reset about frequency spacing. You may abort by hitting the close gadget.
  134. This is not an FFT because it is more geared to the parametric nature of
  135. the program. Again, it uses fixed point arithmetic.
  136.  
  137. I)nput  and O)utput  write the sonogram (or read) to a disk file. The Reset
  138. parameters are also saved.
  139.  
  140. Q)uit gives you a chance to play Marble Madness.
  141.  
  142. Remember: Software kills! Use this tool wisely!
  143. Actually, In lieu of money, which I hate, consider calling you local
  144. educational institutes and show their music department this program. 
  145. I am after activism as a shareware concept. Money I don't need. And,
  146. it won't buy you a single thing.. there are no guarantees implied in this
  147. or any software. Neither can I say when or if the improved versions will
  148. appear. I have left a few slots in the "comb" open for forth persons
  149. to include their own functions. Someone, please put in a "BltBitMap" copy
  150. function!
  151. Those who wish to propogate this set of files are cautioned to make them
  152. complete,(I.E. try to include the source.. there isn't very much
  153. in the way of Forth examples out there also I like my Icons and Doc files)
  154.  and to add comments to the UploadDocs file so you can form
  155. your own user group. You can get to me here:
  156.  
  157.           J H H Lowengard
  158.           43 W 16th st. apt 2D
  159.           NYC 10011-6320
  160.           also via MIDI-NET and CIS:76625,2425
  161.