home *** CD-ROM | disk | FTP | other *** search
/ Esprit de Apple Corps / EDAC-2.iso / Graphics / Apps / Programs / WaveLab / waveLAB.doc < prev    next >
Encoding:
Text File  |  1994-05-28  |  6.3 KB  |  134 lines
  1. ** waveLAB for the Apple IIGS (requires System Software 6.0.1) **
  2.  
  3. freeware by:
  4.           Dave Tribby, 1529 Fantail Ct., Sunnyvale, CA  94087
  5.           GEnie: D.TRIBBY          internet: tribby@cup.hp.com
  6.  
  7. ------ NOTE ---------------------------------------------------------
  8. This description of waveLAB assumes the reader already understand quite a
  9. bit about about the MIDI Synth toolset. If you do not understand terms such
  10. as "DOC" and "waveform" you may not be able to make use of this program.
  11. --------------------------------------------------------------------
  12.  
  13. waveLAB is an extension to Apple's synthLAB program. Its focus is the
  14. creation of waveforms and instruments for use with MIDI Synth.
  15.  
  16. Version 1.0 (May 1994) of waveLAB lets you
  17.    - create MIDI Synth waveforms by specifying the basic waveform type
  18.       (sine, square, triangle, sawtooth, normal) and the strength of harmonics
  19.    - load individual waveforms from existing MIDI Synth wave data (".wav")
  20.       files
  21.    - load an arbitrary binary file (up to 64 Kbytes) for use as a waveform
  22.    - create MIDI Synth instruments (similar to synthLAB)
  23.    - shuffle the order of instruments using the the Edit menu's Copy, Cut,
  24.       and Paste functions
  25.    - load individual instruments from  existing MIDI Synth instrument
  26.       (".bnk") files
  27.    - plot graphs of an instrument's waveforms or envelopes
  28.    - save the instruments and waveforms you have created
  29.    - load and play MIDI Synth sequence files
  30.    - remove unreferenced waveforms from DOC memory
  31.    - load up to two user-defined base waveforms
  32.  
  33.  
  34. * * * Notes on using waveLAB
  35.  
  36.    - When you "Load Instruments...", waveLAB opens both the instrument file
  37.       and the associated wave data file. Only the waveforms actually used by
  38.       the instruments you choose are loaded. If you load all instruments from
  39.       a file and then write new instrument and wave files, the contents of
  40.       the new files may be rearranged from the originals even if you have
  41.       made no changes;  waveLAB is likely to rearrange the ordering of wave
  42.       waves in DOC memory. All the instruments should sound exactly the.
  43.  
  44.    - The "Wood Block" waveform is used by MIDI Synth's built-in metronome.
  45.       It cannot be deleted or modified. It probably should not be used by any
  46.       other instrument. (New instruments point to this wave since they are
  47.       assured it will be there. The resulting sound is not very appealing.)
  48.  
  49.    - The Edit menu's "Copy" and "Paste" work on the Envelope and Wave 
  50.       windows if they are active. "Undo" restores the values stored before
  51.       the most recent "Paste" or "Undo". When the highlighted window is not
  52.       an NDA or the Envelope or Wave  window, "Cut," "Copy," and "Clear" work 
  53.       on  the currently selected instrument while "Paste" works on the next
  54.       available instrument. waveLAB updates the Edit menu to indicate the
  55.       object (instrument, wave, or envelope) of each command.
  56.  
  57.    - The base waveforms are designed to begin and end at the minimum volume
  58.       point in order to minimize the "pop" that can occur when the Ensoniq DOC
  59.       chip swaps oscillators. See IIGS Technical note #11 for details.
  60.  
  61.    - When creating a new waveform from the base waveforms, the calculations
  62.       may overflow if the total number of all the harmonics is too large (125 
  63.       (to 200, depending on the base waveform and the harmonics used). The 
  64.       result is a distorted wave that sounds quite odd. Each overflow value is
  65.       replaced by the value 255, so the graphs will have many points at the
  66.       top.
  67.  
  68.    - If the "sinewave" or "normalwave" file is not present in the directory
  69.       from which waveLAB is run, waveLAB will generate and write the missing
  70.       file. If the special1 or special2 file is not present, waveLAB
  71.       ignores them and doesn't highlight the corresponding selection in the 
  72.       waveform pop-up menu. (See genwave.c for information about special 
  73.       files.)
  74.  
  75.    - waveLAB is GNO-aware enough to shut down cleanly if it receives a
  76.       kill -2 or kill -15 signal.
  77.  
  78.    - In reading about sound, I have only seen "harmonics" refer to sine waves.
  79.       Applying them to square, triangle, sawtooth, and normal waves creates 
  80.       interesting waveforms.
  81.  
  82.    - As in Blackjack Tutor, I couldn't resist sticking in an "Easter Egg," but
  83.       it only appears for a few seconds.
  84.  
  85.  
  86. * * * Other comments
  87.  
  88.    - I'd like to have a better program icon for waveLAB. Any one want to
  89.       create one for me?
  90.  
  91.    - I don't plan on adding wave editing capabilities since there are
  92.       other fine programs for the GS that perform those functions.
  93.  
  94.    - Use my shell-based program synthfile (available on GEnie and FTP sites),
  95.       to print the contents of MIDI Synth sequence, instrument, and waveform
  96.       files. ORCA/C source code is included in the archive.
  97.  
  98.    - I wrote MIDI Surgeon for the Jan/Feb 1994 issue of GS+ Magazine. Get it if 
  99.       you want a program that translates "raw" MIDI format to MIDI Synth 
  100.       sequences, removes unwanted entries from sequence files, or moves
  101.       instruments from one track to another.
  102.  
  103.    - When you remove a waveform from DOC memory, you are not warned whether
  104.       any instruments reference it. Any such instruments will show a blank
  105.       value in the wave selection menu.
  106.  
  107.    - Features considered for future versions of waveLAB include
  108.            * allow the testing of instruments via a graphic "keyboard"
  109.            * additional pre-defined envelopes
  110.            * using waveform names to recognize duplicates in different files
  111.  
  112.    - I have tested this version reasonably well, but have not received many
  113.       reports from other users. If you find a problem or have comments, 
  114.       please contact me at one of the above addresses . The level of interest
  115.       will determine whether there will be a version 1.1.
  116.  
  117.  
  118. * * * The files included with waveLAB are:
  119.  
  120.     waveLAB: the program.
  121.  
  122.     waveLAB.doc: this documentation file.
  123.  
  124.     waveLAB.icon: an icon file; place it in the Icons folder on one of your
  125.             disks. 
  126.  
  127.     sinewave and normalwave: files containing pre-calculated sine and
  128.           normal waves, as described above.
  129.  
  130.     genwave.c and genwave: an ORCA/C program that creates example "special"
  131.            files. Run it to create the example files. Modify the code to create
  132.            your own unique "base" waveforms. If you need more information,
  133.            please write to me.
  134.