home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d3xx / d345 / vced.lha / VcEd / VcEd.doc < prev    next >
Text File  |  1990-04-16  |  9KB  |  175 lines
  1.                          VcEd Yamaha 4 OP Voice Editor
  2.                             By: Charles A. Brand
  3.                              Copyright (c) 1990
  4.  
  5. INSTRUCTIONS:
  6. -------------
  7.  
  8.                                    Intro
  9.  
  10.    The VcEd Voice Editor is written for the Yamaha DS55 4 Operator FM
  11. Synthesis Keyboard/Synthesizer.  The Editor allows you to build and Edit
  12. your own Voices or Tones, and then lets you transmit them to the keyboard or
  13. save them to a file.  Using the Editor is quite easy, and it allows you to
  14. start from scratch or start with a Pre-Set voice by selecting a voice on the
  15. keyboard and then use the Menu Selection in the Editor to Send the voice
  16. from the keyboard to the Amiga and start Editing from there.
  17.    You Edit a voice, by using the mouse to click on the parameter value that
  18. you want to change.  You work on one Operator at a time, and you click on
  19. the Operator number to increment to the next Operator.
  20.  
  21.                                   Start-Up
  22.  
  23.    Upon starting VcEd you will see Initialized Voice data on the screen. At
  24. this point you can start Editing from Scratch.  To change a parameter,
  25. simply Click the pointer over top of the parameter and it will be
  26. highlighted.  At this time you can use the Gadgets, at the Lower Right hand
  27. corner of the screen, to change the parameter value.
  28.  
  29.  
  30.                                  The Gadgets
  31.  
  32.    The Gadgets consist of a Slider Gadget, Left and Right Arrow Gadgets, and
  33. a TEST Gadget.  The Gadgets function pretty much like you would expect them
  34. to.
  35.  
  36.    The Slider Gadget is clicked on and then Slid Left and Right, and while
  37. doing so, it will show a value in the box below it.
  38.  
  39.    The Left and Right Arrow Gadgets, when clicked on, will increment or
  40. decrement the value in the box below the Slider Gadget.
  41.  
  42.    The TEST gadget will transmit the voice, as it sits plus the changes you
  43. are making to the voice, to the Keyboard, then sends a 'Note On' command
  44. (Middle C) to let you hear the voice. After the tone has played, VcEd then
  45. Sends the Voice back to the Keyboard the way it was before the changes. After
  46. you set the parameter to the value that you want you have to click on the OK
  47. Gadget to exit from Edit mode.
  48.  
  49.    The TEST Gadget is also active while IN or OUT of Edit mode, however once
  50. you leave Edit mode, the Voice you will hear is the voice as it sounded
  51. before you changed a parameter, UNLESS you have the AUTO UPDATE MODE on, and
  52. in this case, everytime you exit Edit Mode the new voice will automatically
  53. be re-transmitted to the Keyboard. Otherwise, after you leave Edit Mode, you
  54. will have to Send the voice to the Keyboard yourself with the Menu selection
  55. shown below.
  56.  
  57.  
  58.                                   The Menus
  59.  
  60.    The Main Menu has two selections, they are 'Init Voice' and 'Quit'. 'Init
  61. Voice' initializes the voice to a standard 4 Operator INIT VOICE as defined
  62. by Yamaha in the DX11 Owners Manual. I assumed that this was a Yamaha
  63. Standard. 'Quit' does exactly that, it returns you to the CLI or Workbench.
  64.  
  65.    The Load Menu allows you to Load a Voice from the Keyboard or from a
  66. file.  You can load a voice from the keyboard, and start editing it from
  67. that point. This is handy if there is a voice, in the Keyboard, that you
  68. would like to make changes to.  You can Load a voice, that you were editing
  69. or Saved earlier, from a disk file.  This is handy if you had a voice you
  70. were Editing and just did not have time to finish, you can come back to it
  71. later.
  72.  
  73.    The Save Menu allows you to Save the voice to a disk file, or Send the
  74. voice to the Keyboard.  You can Save a voice to a disk file to edit later or
  75. just to keep around as your own INIT VOICE. After Editing a Voice to the way
  76. you want it, you can Send it to the Keyboard and place it into the USER Voice
  77. number you want by:
  78.  
  79.    1. Transmit the voice to the keyboard with the Send Voice Menu selection.
  80.    2. On the keyboard Press the 'Store' button then the '-1' button to turn
  81.       off the memory protect.
  82.    3. Press the 'Store' button again and enter the USER MEMORY Voice number
  83.       that you wish to send the voice to. (TWO Digits. ex. 09)
  84.    4. At this time, the Keyboard will be asking you if it is OK, and showing
  85.       the name of the voice that is already at that location.
  86.    5. Press the '+1' button if you wish to store the voice, or the '-1'
  87.       button to cancel the operation.
  88.    6. At this time it would be a good idea to write protect the memory again
  89.       by Pressing the 'Store' button again and then the '+1' button.
  90.    7. The Voice is now in User Memory permanently until you change it
  91.       yourself.
  92.  
  93.    Note that anytime during editing, you can transmit your voice to the
  94. Keyboard without wiping out any of your USER Voices, because the voice goes
  95. into an Edit Buffer and allows you to hear that voice until you put it into
  96. USER MEMORY or select another voice with the '+1' or '-1' buttons or use the
  97. NUMBER buttons to select another voice.
  98.  
  99.    The last Menu is the 'Misc' Menu and is used to toggle the AUTO UPDATE
  100. Mode ON or OFF. The current setting is shown to the Right hand side of the
  101. Voice Name Parameter and is shown as either 'AUTO OFF' or 'AUTO ON'. It is
  102. set to OFF at Start-Up. When this Mode is selected, the Voice you are
  103. Editing will automatically be Sent to the Keyboard whenever you Exit Edit
  104. Mode by Clicking on the OK Gadget. When this Mode is OFF, you must Send the
  105. Voice to the Keyboard yourself with the 'Send Voice' Menu selection. 
  106.  
  107.    Finally, each Menu selection has a key Sequence assigned to it also, so
  108. that you can use the keyboard instead of the pull-down Menus. They are :
  109.  
  110.    Main:
  111.       Init Voice            -  Right Amiga  I  (Initialize)
  112.       Quit                  -  Right Amiga  Q  (Quit)
  113.  
  114.    Load:
  115.       Load Voice from File  -  Right Amiga  L  (Load)
  116.     * Load Voice from DS55  -  Right Amiga  R  (Recieve)
  117.  
  118.    Save:
  119.     * Send Voice to File    -  Right Amiga  S  (Save)
  120.       Send Voice to DS55    -  Right Amiga  T  (Transmit)
  121.  
  122.    Misc:
  123.       Automatic Update      -  Right Amiga  A  (AUTO ON/OFF)
  124.  
  125.  
  126.       * Note that the Menu Items marked with an asterisk are not
  127.         available in the DEMO Version of VcEd.
  128.            (Hey, its only $10.00. I need a hard drive bad!!)
  129.  
  130.                                  Notes
  131.  
  132.    Some of the parameters, when clicked on, will Toggle, and will not need
  133. the Edit Gadgets. This is because they only have two states or possible
  134. values. These are : AME (0 or 1), Osc. Mode (Ratio or Fixed), Delay (On or
  135. Off), Delay Short/Long (Short or Long), Port Mode (FULL T or Fingered),
  136. Poly/Mono (Poly or Mono) (Gee, I bet you could-a guessed that last one), and
  137. finally LFO Sync (On or Off). If the AUTO Update Mode is on, then toggled
  138. parameters will still automatically update the voice to the Keyboard.
  139.  
  140.    Make sure your Keyboard is on before trying to Recieve a voice from it,
  141. or the program will send the Voice Edit Buffer Dump Request to Nothing and
  142. sit and wait for ever!!!!!  If this happens, turn your keyboard on and
  143. manually transmit a bulk dump to VcEd.  Your screen will appear to be a mass
  144. of crap at this point but it won't be locked up anymore. Now select the INIT
  145. VOICE Menu selection from the Main Menu. Now your set to do some editing
  146. again.  Don't forget you have 4 Operators to program!!!!!
  147.  
  148.                     How to Order the Fully Functional VcEd
  149.  
  150.    You can Order the fully functional Version of VcEd from me at :
  151.  
  152.                          Charles A. Brand
  153.                          95 Parana Dr.
  154.                          Newark, Ohio 43055
  155.                          Phone : 614-745-5361
  156.  
  157.    The Cost is $10.00 and you get the Source code written in fully commented
  158. 'C' language, a file that expalains the program line by line, and  a layout
  159. of the buffer data and explanation of how it is implemented. I promise that
  160. I have worked my butt off on this project and that it is worth every penny
  161. of what I am asking. (Just ask me I'll tell you!)
  162.    Any donation of $15.00 or more, will also get a SysEx program and a Voice
  163. Printout program, also with the 'C' Source Code for both.
  164.    The SysEx will save standard 32 Voice and 100 Voice Bulk Dumps to disk
  165. and back to the Keyboard (DX and DS55).  This program will also do System
  166. Set-up Dumps as well.
  167.    The PrintDump program will print out the Voice parameter data from bulk
  168. dump files. You have the choice of a single voice or all 32 Voices of a
  169. standard 32 voice Yamaha 4 Op bulk dump.
  170.    The Source for both of the extra programs is also fully commented.
  171.    Feel free to contact me with any questions, comments, or complaints and I
  172. will try my best to change, enhance, or help anybody do the same to this
  173. program. (Please do not call collect!)
  174.  
  175.