home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d598 / dx100.lha / DX100 / DX100.doc < prev    next >
Text File  |  1992-02-01  |  22KB  |  444 lines
  1.                           Yamaha DX100 Editor/Librarian
  2.  
  3.  
  4.  
  5.      Features:
  6.  
  7.      -  Full featured Editor/Librarian for the Yamaha DX100
  8.      -  The Librarian makes it easy to organize and store a bank
  9.         of voices on disk.  Send your customized banks to the DX100
  10.         or receive banks from this instrument.  Easy audition of voices,
  11.         simply click the mouse on a voice name and "play" the Amiga
  12.         keyboard.
  13.      -  The Editor has the power to edit all parameters for DX100 voices.
  14.         It provides graphical display of voice envelopes, an Undo button
  15.         to correct mistakes, and convenient saving of changes made
  16.         during the editing process.  The voice audition feature makes
  17.         it easy to compare the "original" and "modified" voice.  For
  18.         interesting effects use the Randomize feature to create random
  19.         voice envelopes.
  20.      -  Print hardcopy of voice banks.  Print out all DX100 voice
  21.         parameters.
  22.      -  Fully compatible with the Yamaha DX27 and the DX21
  23.      -  AmigaDOS 2.0 compatible
  24.  
  25.  
  26.         This is a ShareWare program.  If you like it and find it useful,
  27.      please send me $30.  If you can't afford this, I'll gladly accept
  28.      any contributions you would like to make.
  29.         A hi-res version of this program that uses a 640 by 400 pixel
  30.      screen is available upon request with the $30 contribution.  This
  31.      version looks great on an Amiga 3000.
  32.  
  33.  
  34.  
  35.      James M. Smith
  36.      P.O. Box 6836
  37.      Los Osos, CA
  38.      93402
  39.  
  40.  
  41.  
  42.                               Instructions
  43.  
  44.      Getting Started
  45.       
  46.          With the power off on the Amiga and the DX100, connect the
  47.      DX100 (DX27 or DX21) to a standard MIDI conversion box that uses
  48.      the Amiga serial port.  Since the DX100, DX27 and DX21 are software
  49.      compatible this instruction booklet will only mention the DX100. 
  50.      The MIDI-out on the conversion box connects to the MIDI-in on the
  51.      back of the DX100.  The MIDI-in on the conversion box connects to
  52.      the MIDI-out on the DX100.  Connect the audio output on the DX100
  53.      to a sound system.  After turning on the power to the DX100 and the
  54.      Amiga, set the DX100 MIDI On/Off switch to On using the front panel
  55.      buttons.  Set the DX100 transmit and receive MIDI channel to one
  56.      and turn On the MIDI System Exclusive Information.  The DX100 is
  57.      now ready to communicate with the Editor/Librarian, which by
  58.      default is set for MIDI channel one for basic MIDI events and
  59.      system exclusive messages.  The MIDI channel used by the
  60.      Editor/Librarian and the DX100 does not have to be channel one. 
  61.      From the "Play Voice" menu section one of four possible MIDI
  62.      channels can be selected.  But it is essential that the DX100 and
  63.      the Editor/Librarian are set to the same MIDI channel.
  64.  
  65.           When the Editor/Librarian is first started a listing of the files
  66.      on the volume where this program resides will be given.  Change ":"
  67.      to "df1:"to list the files on drive df1: if required.  The following 
  68.      instructions will lead you by your hand through the operation of this
  69.      program.  If you don't like following instructions, go ahead and play
  70.      with this program on your own.  You will probably be able to figure out
  71.      how to use this program by yourself. 
  72.  
  73.  
  74.      Opening a Voice Bank
  75.  
  76.          The directory of the DX100 Program Disk will show the
  77.      subdirectory, Voice_DX100, displayed in red.  A listing of this
  78.      Voice directory is obtained by single clicking on the word
  79.      Voice_DX100.  This directory contains the eight factory voice banks
  80.      that come with the DX100 and a Demo bank.  Open the FactoryN1 bank
  81.      by clicking on it to obtain a listing of its voices.  Try playing
  82.      with the slider gadget on the right of the listing in order to move
  83.      the display through all 32 voices.  Note that only the first 24
  84.      voices contain meaningful data for the DX100.  The DX21 will
  85.      utilize all 32 voice positions in the bank.  
  86.  
  87.          Voice listings can be moved to the right side of the Librarian
  88.      Window by clicking on the "Move > Bank" button.  Try this now.
  89.  
  90.  
  91.      Deleting Voices
  92.  
  93.          Click on the "Parent Dir" button to get back to the listing of
  94.      the factory voice banks.  This button is used to move up the directory
  95.      tree, to obtain a parent directory listing.  This time click on the
  96.      Demo bank to display its voices.  The Voice Librarian Window will
  97.      now show the Demo bank on the left and FactoryN1 on the right.  
  98.  
  99.          Click on a couple of the voices in the Demo bank, and note that
  100.      their names change to red.  Click on the "Delete Voice" button to
  101.      delete these voices.  All voices shown in red will be deleted after
  102.      this button is activated.  Be very CAREFUL using the "Delete Voice"
  103.      button.  Once a voice has been deleted, it cannot be recovered.  Do
  104.      not delete any voices in the Factory banks.  These banks are the
  105.      backbone of a DX100 voice library.  
  106.  
  107.          The "Delete Voice" button can also be used to totally erase a
  108.      voice bank.  If this button is selected for a bank in which all
  109.      voices have been previously deleted, then the voice bank file
  110.      itself will be erased and will no longer show up in a directory
  111.      listing.  
  112.      
  113.      
  114.      Copying Voices
  115.      
  116.          Now try copying a voice from FactoryN1 over to the Demo bank. 
  117.      First select a voice in FactoryN1 by clicking on a voice name.  Then
  118.      click on the "Copy Voice" button and select with the mouse an empty
  119.      voice location in the Demo bank.  The voice will be copied to the
  120.      empty location selected in the Demo bank.  
  121.  
  122.          Try clicking on several voices in FactoryN1 before activating
  123.      the "Copy Voice" button.  Then click on an empty voice location in
  124.      the Demo bank and note that all the voices selected will be copied
  125.      to the Demo bank.  The lowest numbered voice selected will be
  126.      copied to the empty location chosen, and all other selected
  127.      voices will be copied to empty locations below this point.
  128.  
  129.          So far copying voices from one voice bank to another has been
  130.      discussed.  To copy voices within a particular voice bank, place
  131.      the bank of interest on both the left and right side of the
  132.      Librarian Window and copy exactly as previously described.  As an
  133.      example, select the "Move > Bank" button so that the Demo bank is
  134.      displayed on both sides of the Librarian Window.  Select a voice on
  135.      the left display.  Activate the "Copy Voice" button and select an
  136.      empty voice location on the right display.  The voice selected
  137.      will be copied to the empty location within the Demo bank.
  138.  
  139.          The "Copy Voice" button will work even if the voice banks
  140.      displayed on the left and right side of the Librarian window have
  141.      not come from the same directory or even the same disk.  As an
  142.      example of how this might work, let's assume that the DX100 Program
  143.      Disk resides on drive df1: and that some voice banks have been
  144.      copied to a ram disk.  After opening a voice bank from the DX100
  145.      Program Disk and having moved this bank to the right side of the
  146.      Librarian window using the "Move > Bank" button, a directory of the
  147.      ram disk is obtained by entering ram: into the Disk box.  After
  148.      opening a voice bank on the ram disk, it is then possible to copy
  149.      voices back and forth between the two banks even though the voice
  150.      banks come from two different disks.
  151.  
  152.      
  153.      Auditioning Voices
  154.   
  155.          In order to audition voices the MIDI Port must be activated by
  156.      selecting "MIDI Port Active" from the "Play Voice" Menu section. 
  157.      Do this now.     
  158.  
  159.          The selection of "Auto Send Active" or "Auto Send Off" from the
  160.      "Play Voice" Menu section will have an important effect on the way
  161.      voices are auditioned.  "Auto Send Active" is the default mode and
  162.      probably will be used by most people nearly all the time.  In this
  163.      mode, individual voice data is sent to the DX100 immediately after
  164.      the mouse clicks on a particular voice.  With "Auto Send Off"
  165.      selected, voice data is not sent to the DX100 until the ENTER key
  166.      is pressed or "Send Voice" is selected from the "Play Voice" Menu
  167.      section.  The "Auto Send Active" mode is more convenient to use for
  168.      auditioning voices.  But when copying and deleting voices is the
  169.      main focus of activity, sending voice data to the DX100 whenever a
  170.      voice is selected can be a nuisance.  On these occasions use the
  171.      "Auto Send Off" mode.  
  172.  
  173.          After selecting a DX100 voice with the mouse, use the Amiga
  174.      keyboard or the DX100 keyboard to audition its sound.  The Amiga
  175.      keyboard will produce "white key" notes over a five octave range,
  176.      with middle C produced by hitting the keyboard key, Q.  The notes
  177.      from the "black keys" on a piano keyboard are not produced.  Eight
  178.      notes may be played simultaneously.  
  179.      
  180.  
  181.          Using an External Keyboard
  182.  
  183.              When editing voices it is sometimes useful to use an
  184.          external keyboard with touch sensitivity.  To use an external
  185.          MIDI keyboard with the Editor/Librarian, disconnect the end of
  186.          the MIDI cable at the MIDI-out on the DX100 and reconnect to
  187.          the MIDI-out on the external MIDI keyboard.  The other MIDI
  188.          cable remains unchanged.  Turn off the power on the Amiga, the
  189.          DX100, and the external keyboard before making this change. 
  190.          With this new hookup it will not be possible to receive voice
  191.          banks from the DX100.  After following the above instructions
  192.          for auditioning voices, select "Status Connected" from the "Ext
  193.          Keyboard" Menu section to inform the Editor/Librarian of this
  194.          change.  Activate the external keyboard by selecting Activate
  195.          from the "Ext Keyboard" Menu section or by pressing the arrow
  196.          up key on the Amiga keyboard.  The external MIDI keyboard will
  197.          now send MIDI data to the DX100.  Turn off the external
  198.          keyboard by hitting any key on the Amiga keyboard.  
  199.      
  200.      
  201.      Sending and Receiving Voice Banks
  202.  
  203.          Sending a Voice Bank to the DX100 is accomplished by selecting 
  204.      "Send Bank" from the Transfers Menu section.  The active voice
  205.      bank, which is the opened bank with its title displayed in red, is
  206.      sent to the DX100.  All data previously stored in the DX100 in the
  207.      Internal Bank will be lost.  Therefore be CAREFUL when sending
  208.      voice banks to the DX100.  
  209.  
  210.          Receiving the Internal Voice Bank is accomplished by selecting
  211.      "Receive Bank" from the Transfers Menu section.  At least one voice
  212.      bank must be opened to establish which voice bank directory is
  213.      being used so that the received data will be filed in the proper
  214.      directory.  The user is free to create as many directories as
  215.      needed for storing voice banks.  If the right side of the Voice
  216.      Librarian is displaying a voice bank, the Librarian will use the
  217.      directory from this bank.  Otherwise the directory that holds the
  218.      left bank of voices will be used.  The received voice bank is
  219.      displayed on the right side of the Voice Librarian Window with the
  220.      bank name given by the string entered in the Bank box.  If no
  221.      string was entered into the Bank box, the name of the received bank
  222.      file becomes NoName.  Be very CAREFUL about naming the received
  223.      bank so that another bank with the same name in the same directory
  224.      will not be lost.  
  225.  
  226.          If a number of other programs are running concurrently with the
  227.      DX100 Editor/Librarian, the Amiga may not be able to keep up with
  228.      the high speed data sent out from the DX100 during a Voice Receive
  229.      Transfer.  An error message will indicate if a problem has occurred.
  230.      Remember also that receiving voice banks is not possible when an
  231.      external MIDI keyboard is connected.  
  232.  
  233.  
  234.      Select All and Create Bank buttons
  235.  
  236.          The "Select All" button selects all voices in a bank, and
  237.      displays the names of these voices in red.  To delete all voices in
  238.      a bank, select the "Select All" button before activating the
  239.      "Delete Voice" button.  
  240.  
  241.          The "Create Bank" button creates an empty bank file with the
  242.      name given by the string entered in the Bank box.  At least one
  243.      voice bank must be opened so that the created bank will be filed in
  244.      the proper directory.  If no name has been entered into the Bank
  245.      box, a bank called NoName is created.  The empty bank will be
  246.      displayed on the right side of the Librarian Window.  Be very
  247.      CAREFUL about choosing a name for a created bank, because any other
  248.      existing bank with the same name in the same directory will be
  249.      lost.  
  250.  
  251.  
  252.      Editing Voices
  253.  
  254.          Before editing a voice make sure that the "MIDI Port Active"
  255.      menu has been selected so that voice changes can be auditioned. 
  256.      The Voice Editor Window is opened by first clicking on a voice and
  257.      then selecting the "Edit Voice" button.  All the parameters that
  258.      define the characteristics of the selected voice are shown in the
  259.      Voice Editor Window.  These parameters are changed by clicking on
  260.      the displayed values.  Some values will change immediately.  Others
  261.      will require the user to enter the new numeric value into a string
  262.      gadget.  Since all the string gadgets are empty except for the Name
  263.      gadget, simply enter the new value using the number pad on the
  264.      keyboard and hit the ENTER or RETURN key.  Use the DEL and "BACK
  265.      SPACE" keys as needed to correct a mistake before the ENTER key has
  266.      been pressed.  
  267.    
  268.          A good description of the function of all the DX100 voice
  269.      parameters is given in the DX100 instruction manual.  For additional
  270.      information consult the Yamaha publication, "AfterTouch".
  271.      Write to AFTERTOUCH, P.O. Box 7938, Northridge, CA 91327-7938.  
  272.      The layout of the Voice Editor Window will now be discussed.  
  273.  
  274.          The Voice Editor Window is divided into four main sections and
  275.      the three color coded blocks on the far left define the parameters
  276.      used by the four operators in the DX100.  The red block lists the
  277.      following operator parameters:  on/off, output level, frequency,
  278.      frequency ratio and detuning.  The numbers in the red block
  279.      represent the maximum values that particular parameters are allowed
  280.      to take.  The green block lists the five segments of the operator
  281.      envelope which are the attack rate, the first decay rate, the decay
  282.      level, the second decay rate, and the release rate.  The blue block
  283.      lists the scaling and sensitivity parameters which are the rate
  284.      scaling, level scaling, AMS on/off, EG bias sensitivity, and
  285.      velocity sensitivity.  The values for all these parameters are
  286.      changed by clicking on the numbers in the four operator columns
  287.      next to these blocks.  If the CTRL key is held down while the mouse
  288.      clicks on an operator value, any changes made to a particular
  289.      operator will apply to all four operators.  For the string gadgets,
  290.      release the CTRL key before entering a new number.  This is a fast
  291.      way to change all operators to the same value.  
  292.   
  293.          On the upper right side of the Voice Editor Window is an orange
  294.      block that contains the name of the voice, the algorithm used by
  295.      the four operators, and the feedback employed in the fourth
  296.      operator.  The LFO settings are given in the blue block.  They are
  297.      the LFO delay, the LFO sync on/off, the waveform select (sawtooth,
  298.      square, triangle and sample/hold), the LFO speed, the amplitude
  299.      modulation sensitivity and depth, and the pitch modulation
  300.      sensitivity and depth.  The yellow block lists a number of
  301.      functional parameters.  They are the playing mode (poly or mono),
  302.      the portamento mode, the portamento time, the foot switch setting,
  303.      the modulation wheel controller amplitude and pitch, the amount of
  304.      transpose, the pitch bender range, and the breath controller
  305.      amplitude, pitch, EG bias and pitch bias.  
  306.      
  307.      
  308.           Displaying Voice Envelopes
  309.      
  310.               To graphically display the envelope for each operator for
  311.           a note at middle C, select Display from the Envelopes Menu
  312.           section.  The envelopes are displayed such that the Off Point,
  313.           when the key is released, represents approximately three
  314.           seconds after the key was initially activated to play the
  315.           note.   
  316.                        
  317.               To close the envelope display window, click on any part of
  318.           this window.
  319.      
  320.      
  321.           Auditioning Edited Voices
  322.              
  323.               In the orange block click on the number after the word
  324.           "Algor" to change algorithms.  If "Auto Send Active" was
  325.           selected before entering the Voice Editor Window, the modified
  326.           voice data is automatically sent to the DX100.  Simply "play"
  327.           the DX100 keyboard or the Amiga keyboard to audition the new
  328.           voice.  If "Auto Send Off" had been chosen, send the modified
  329.           voice data to the DX100 by selecting "Send Voice" from the
  330.           "Play Voice" Menu section or by pressing the ENTER key on the
  331.           keyboard.  
  332.  
  333.               To audition the original unmodified voice again, select
  334.           "Select Original" from the "Play Voice" Menu section or press
  335.           the left pointing arrow key on the keyboard.  The keyboard
  336.           will now play the unmodified voice.  To audition the modified
  337.           voice select the "Select Modified" Menu or press the right
  338.           pointing arrow key.  Toggling back and forth between the
  339.           modified and original voice is especially easy using the arrow
  340.           keys as described. 
  341.          
  342.  
  343.           Undo Mistakes
  344.           
  345.               Select Undo from the Project Menu section to cancel the
  346.           last change made to the voice parameters.  Pressing the HELP
  347.           key will accomplish the same result.
  348.           
  349.  
  350.           Randomize Envelopes
  351.          
  352.               Select Randomize from the Envelopes Menu section to
  353.           randomize the five parameter envelope for the four operators. 
  354.           The rate scaling parameter is also randomized.  This is
  355.           sometimes an interesting way to create new voices.  The new
  356.           voice parameters are automatically sent to the DX100 if "Auto
  357.           Send Active" had been selected before entering the Voice
  358.           Editor.  Just "play" the keyboard to audition the randomized
  359.           voice.  If "Auto Send Off" had been activated, the menu "Send
  360.           Voice" must be selected or the ENTER key pressed before the
  361.           randomized voice data is sent to the DX100.  Another way to
  362.           select the Randomize feature is to press the ALT key on the
  363.           right side of the keyboard.  
  364.  
  365.  
  366.           Saving Voice Data
  367.    
  368.               Select Save from the Project Menu to save the changes
  369.           made to the selected voice that is currently being edited. 
  370.           The new parameters will replace all the old values for this
  371.           voice.  The new voice will now become the "original" voice
  372.           that will be sent to the DX100 when the "Select Original" Menu
  373.           is selected.  
  374.  
  375.               The "Save Fwd" Menu selection, which stands for Save
  376.           Forward, works quite differently than Save.  This selection
  377.           will copy the new voice parameters to the first empty place in
  378.           the voice bank immediately following the selected voice.  The
  379.           original selected voice will not be modified in any way.  If
  380.           there are no empty locations after the selected voice, the
  381.           "Save Fwd" feature will not work and the user will be notified
  382.           of this.  The "Save Fwd" selection provides a convenient means
  383.           of saving various changes made to the original voice without
  384.           changing the selected voice itself.  
  385.           
  386.           
  387.           Printing Voice Data
  388.           
  389.               Selecting Print from the Project Menu will print all of
  390.           the voice parameters that have been saved with the Save menu
  391.           selection.  The printer will follow the settings in
  392.           Preferences which must be present on the user's Workbench
  393.           Disk.  
  394.  
  395.  
  396.           Special Keyboard Key, the CTRL key
  397.      
  398.               Use the CTRL key to change all four operator parameters
  399.           simultaneously.  See the section "Editing Voices" for more
  400.           information.  
  401.  
  402.                
  403.           Alternate Keyboard Keys
  404.  
  405.              There are six keys that can be used in place of menu
  406.           selections.  These keys have already been discussed but will
  407.           be summarized here.  
  408.    
  409.                   Keyboard Key                 Menu Selection
  410.           
  411.                   ALT (on right side)          Randomize
  412.                   Left Pointing Arrow          Select Original
  413.                   Right Pointing Arrow         Select Modified
  414.                   Up Pointing Arrow            Activate Ext Keyboard
  415.                   ENTER                        Send Voice
  416.                   HELP                         Undo 
  417.                
  418.  
  419.           Exiting the Voice Editor Window
  420.    
  421.               Select Exit from the Project Menu.  The Voice Librarian
  422.           Window will again open.  
  423.    
  424.    
  425.      
  426.      Printing from the Voice Librarian
  427.      
  428.          Selecting Print from the Project Menu will print all of the
  429.      names of the voices in the active voice bank, which is the opened
  430.      bank with its title displayed in red.  
  431.          
  432.      
  433.      Quitting the Voice Librarian
  434.  
  435.          Select Quit from the Project Menu section to quit the DX100
  436.      Editor/Librarian.
  437.      
  438.      
  439.  
  440.      JAMES M. SMITH MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH
  441.      RESPECT TO THIS MANUAL OR WITH RESPECT TO THE SOFTWARE DESCRIBED IN
  442.      THIS MANUAL, ITS QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS
  443.      FOR ANY PARTICULAR PURPOSE.
  444.