Yamaha DX100 Editor/Librarian Features: - Full featured Editor/Librarian for the Yamaha DX100 - The Librarian makes it easy to organize and store a bank of voices on disk. Send your customized banks to the DX100 or receive banks from this instrument. Easy audition of voices, simply click the mouse on a voice name and "play" the Amiga keyboard. - The Editor has the power to edit all parameters for DX100 voices. It provides graphical display of voice envelopes, an Undo button to correct mistakes, and convenient saving of changes made during the editing process. The voice audition feature makes it easy to compare the "original" and "modified" voice. For interesting effects use the Randomize feature to create random voice envelopes. - Print hardcopy of voice banks. Print out all DX100 voice parameters. - Fully compatible with the Yamaha DX27 and the DX21 - AmigaDOS 2.0 compatible This is a ShareWare program. If you like it and find it useful, please send me $30. If you can't afford this, I'll gladly accept any contributions you would like to make. A hi-res version of this program that uses a 640 by 400 pixel screen is available upon request with the $30 contribution. This version looks great on an Amiga 3000. James M. Smith P.O. Box 6836 Los Osos, CA 93402 Instructions Getting Started With the power off on the Amiga and the DX100, connect the DX100 (DX27 or DX21) to a standard MIDI conversion box that uses the Amiga serial port. Since the DX100, DX27 and DX21 are software compatible this instruction booklet will only mention the DX100. The MIDI-out on the conversion box connects to the MIDI-in on the back of the DX100. The MIDI-in on the conversion box connects to the MIDI-out on the DX100. Connect the audio output on the DX100 to a sound system. After turning on the power to the DX100 and the Amiga, set the DX100 MIDI On/Off switch to On using the front panel buttons. Set the DX100 transmit and receive MIDI channel to one and turn On the MIDI System Exclusive Information. The DX100 is now ready to communicate with the Editor/Librarian, which by default is set for MIDI channel one for basic MIDI events and system exclusive messages. The MIDI channel used by the Editor/Librarian and the DX100 does not have to be channel one. From the "Play Voice" menu section one of four possible MIDI channels can be selected. But it is essential that the DX100 and the Editor/Librarian are set to the same MIDI channel. When the Editor/Librarian is first started a listing of the files on the volume where this program resides will be given. Change ":" to "df1:"to list the files on drive df1: if required. The following instructions will lead you by your hand through the operation of this program. If you don't like following instructions, go ahead and play with this program on your own. You will probably be able to figure out how to use this program by yourself. Opening a Voice Bank The directory of the DX100 Program Disk will show the subdirectory, Voice_DX100, displayed in red. A listing of this Voice directory is obtained by single clicking on the word Voice_DX100. This directory contains the eight factory voice banks that come with the DX100 and a Demo bank. Open the FactoryN1 bank by clicking on it to obtain a listing of its voices. Try playing with the slider gadget on the right of the listing in order to move the display through all 32 voices. Note that only the first 24 voices contain meaningful data for the DX100. The DX21 will utilize all 32 voice positions in the bank. Voice listings can be moved to the right side of the Librarian Window by clicking on the "Move > Bank" button. Try this now. Deleting Voices Click on the "Parent Dir" button to get back to the listing of the factory voice banks. This button is used to move up the directory tree, to obtain a parent directory listing. This time click on the Demo bank to display its voices. The Voice Librarian Window will now show the Demo bank on the left and FactoryN1 on the right. Click on a couple of the voices in the Demo bank, and note that their names change to red. Click on the "Delete Voice" button to delete these voices. All voices shown in red will be deleted after this button is activated. Be very CAREFUL using the "Delete Voice" button. Once a voice has been deleted, it cannot be recovered. Do not delete any voices in the Factory banks. These banks are the backbone of a DX100 voice library. The "Delete Voice" button can also be used to totally erase a voice bank. If this button is selected for a bank in which all voices have been previously deleted, then the voice bank file itself will be erased and will no longer show up in a directory listing. Copying Voices Now try copying a voice from FactoryN1 over to the Demo bank. First select a voice in FactoryN1 by clicking on a voice name. Then click on the "Copy Voice" button and select with the mouse an empty voice location in the Demo bank. The voice will be copied to the empty location selected in the Demo bank. Try clicking on several voices in FactoryN1 before activating the "Copy Voice" button. Then click on an empty voice location in the Demo bank and note that all the voices selected will be copied to the Demo bank. The lowest numbered voice selected will be copied to the empty location chosen, and all other selected voices will be copied to empty locations below this point. So far copying voices from one voice bank to another has been discussed. To copy voices within a particular voice bank, place the bank of interest on both the left and right side of the Librarian Window and copy exactly as previously described. As an example, select the "Move > Bank" button so that the Demo bank is displayed on both sides of the Librarian Window. Select a voice on the left display. Activate the "Copy Voice" button and select an empty voice location on the right display. The voice selected will be copied to the empty location within the Demo bank. The "Copy Voice" button will work even if the voice banks displayed on the left and right side of the Librarian window have not come from the same directory or even the same disk. As an example of how this might work, let's assume that the DX100 Program Disk resides on drive df1: and that some voice banks have been copied to a ram disk. After opening a voice bank from the DX100 Program Disk and having moved this bank to the right side of the Librarian window using the "Move > Bank" button, a directory of the ram disk is obtained by entering ram: into the Disk box. After opening a voice bank on the ram disk, it is then possible to copy voices back and forth between the two banks even though the voice banks come from two different disks. Auditioning Voices In order to audition voices the MIDI Port must be activated by selecting "MIDI Port Active" from the "Play Voice" Menu section. Do this now. The selection of "Auto Send Active" or "Auto Send Off" from the "Play Voice" Menu section will have an important effect on the way voices are auditioned. "Auto Send Active" is the default mode and probably will be used by most people nearly all the time. In this mode, individual voice data is sent to the DX100 immediately after the mouse clicks on a particular voice. With "Auto Send Off" selected, voice data is not sent to the DX100 until the ENTER key is pressed or "Send Voice" is selected from the "Play Voice" Menu section. The "Auto Send Active" mode is more convenient to use for auditioning voices. But when copying and deleting voices is the main focus of activity, sending voice data to the DX100 whenever a voice is selected can be a nuisance. On these occasions use the "Auto Send Off" mode. After selecting a DX100 voice with the mouse, use the Amiga keyboard or the DX100 keyboard to audition its sound. The Amiga keyboard will produce "white key" notes over a five octave range, with middle C produced by hitting the keyboard key, Q. The notes from the "black keys" on a piano keyboard are not produced. Eight notes may be played simultaneously. Using an External Keyboard When editing voices it is sometimes useful to use an external keyboard with touch sensitivity. To use an external MIDI keyboard with the Editor/Librarian, disconnect the end of the MIDI cable at the MIDI-out on the DX100 and reconnect to the MIDI-out on the external MIDI keyboard. The other MIDI cable remains unchanged. Turn off the power on the Amiga, the DX100, and the external keyboard before making this change. With this new hookup it will not be possible to receive voice banks from the DX100. After following the above instructions for auditioning voices, select "Status Connected" from the "Ext Keyboard" Menu section to inform the Editor/Librarian of this change. Activate the external keyboard by selecting Activate from the "Ext Keyboard" Menu section or by pressing the arrow up key on the Amiga keyboard. The external MIDI keyboard will now send MIDI data to the DX100. Turn off the external keyboard by hitting any key on the Amiga keyboard. Sending and Receiving Voice Banks Sending a Voice Bank to the DX100 is accomplished by selecting "Send Bank" from the Transfers Menu section. The active voice bank, which is the opened bank with its title displayed in red, is sent to the DX100. All data previously stored in the DX100 in the Internal Bank will be lost. Therefore be CAREFUL when sending voice banks to the DX100. Receiving the Internal Voice Bank is accomplished by selecting "Receive Bank" from the Transfers Menu section. At least one voice bank must be opened to establish which voice bank directory is being used so that the received data will be filed in the proper directory. The user is free to create as many directories as needed for storing voice banks. If the right side of the Voice Librarian is displaying a voice bank, the Librarian will use the directory from this bank. Otherwise the directory that holds the left bank of voices will be used. The received voice bank is displayed on the right side of the Voice Librarian Window with the bank name given by the string entered in the Bank box. If no string was entered into the Bank box, the name of the received bank file becomes NoName. Be very CAREFUL about naming the received bank so that another bank with the same name in the same directory will not be lost. If a number of other programs are running concurrently with the DX100 Editor/Librarian, the Amiga may not be able to keep up with the high speed data sent out from the DX100 during a Voice Receive Transfer. An error message will indicate if a problem has occurred. Remember also that receiving voice banks is not possible when an external MIDI keyboard is connected. Select All and Create Bank buttons The "Select All" button selects all voices in a bank, and displays the names of these voices in red. To delete all voices in a bank, select the "Select All" button before activating the "Delete Voice" button. The "Create Bank" button creates an empty bank file with the name given by the string entered in the Bank box. At least one voice bank must be opened so that the created bank will be filed in the proper directory. If no name has been entered into the Bank box, a bank called NoName is created. The empty bank will be displayed on the right side of the Librarian Window. Be very CAREFUL about choosing a name for a created bank, because any other existing bank with the same name in the same directory will be lost. Editing Voices Before editing a voice make sure that the "MIDI Port Active" menu has been selected so that voice changes can be auditioned. The Voice Editor Window is opened by first clicking on a voice and then selecting the "Edit Voice" button. All the parameters that define the characteristics of the selected voice are shown in the Voice Editor Window. These parameters are changed by clicking on the displayed values. Some values will change immediately. Others will require the user to enter the new numeric value into a string gadget. Since all the string gadgets are empty except for the Name gadget, simply enter the new value using the number pad on the keyboard and hit the ENTER or RETURN key. Use the DEL and "BACK SPACE" keys as needed to correct a mistake before the ENTER key has been pressed. A good description of the function of all the DX100 voice parameters is given in the DX100 instruction manual. For additional information consult the Yamaha publication, "AfterTouch". Write to AFTERTOUCH, P.O. Box 7938, Northridge, CA 91327-7938. The layout of the Voice Editor Window will now be discussed. The Voice Editor Window is divided into four main sections and the three color coded blocks on the far left define the parameters used by the four operators in the DX100. The red block lists the following operator parameters: on/off, output level, frequency, frequency ratio and detuning. The numbers in the red block represent the maximum values that particular parameters are allowed to take. The green block lists the five segments of the operator envelope which are the attack rate, the first decay rate, the decay level, the second decay rate, and the release rate. The blue block lists the scaling and sensitivity parameters which are the rate scaling, level scaling, AMS on/off, EG bias sensitivity, and velocity sensitivity. The values for all these parameters are changed by clicking on the numbers in the four operator columns next to these blocks. If the CTRL key is held down while the mouse clicks on an operator value, any changes made to a particular operator will apply to all four operators. For the string gadgets, release the CTRL key before entering a new number. This is a fast way to change all operators to the same value. On the upper right side of the Voice Editor Window is an orange block that contains the name of the voice, the algorithm used by the four operators, and the feedback employed in the fourth operator. The LFO settings are given in the blue block. They are the LFO delay, the LFO sync on/off, the waveform select (sawtooth, square, triangle and sample/hold), the LFO speed, the amplitude modulation sensitivity and depth, and the pitch modulation sensitivity and depth. The yellow block lists a number of functional parameters. They are the playing mode (poly or mono), the portamento mode, the portamento time, the foot switch setting, the modulation wheel controller amplitude and pitch, the amount of transpose, the pitch bender range, and the breath controller amplitude, pitch, EG bias and pitch bias. Displaying Voice Envelopes To graphically display the envelope for each operator for a note at middle C, select Display from the Envelopes Menu section. The envelopes are displayed such that the Off Point, when the key is released, represents approximately three seconds after the key was initially activated to play the note. To close the envelope display window, click on any part of this window. Auditioning Edited Voices In the orange block click on the number after the word "Algor" to change algorithms. If "Auto Send Active" was selected before entering the Voice Editor Window, the modified voice data is automatically sent to the DX100. Simply "play" the DX100 keyboard or the Amiga keyboard to audition the new voice. If "Auto Send Off" had been chosen, send the modified voice data to the DX100 by selecting "Send Voice" from the "Play Voice" Menu section or by pressing the ENTER key on the keyboard. To audition the original unmodified voice again, select "Select Original" from the "Play Voice" Menu section or press the left pointing arrow key on the keyboard. The keyboard will now play the unmodified voice. To audition the modified voice select the "Select Modified" Menu or press the right pointing arrow key. Toggling back and forth between the modified and original voice is especially easy using the arrow keys as described. Undo Mistakes Select Undo from the Project Menu section to cancel the last change made to the voice parameters. Pressing the HELP key will accomplish the same result. Randomize Envelopes Select Randomize from the Envelopes Menu section to randomize the five parameter envelope for the four operators. The rate scaling parameter is also randomized. This is sometimes an interesting way to create new voices. The new voice parameters are automatically sent to the DX100 if "Auto Send Active" had been selected before entering the Voice Editor. Just "play" the keyboard to audition the randomized voice. If "Auto Send Off" had been activated, the menu "Send Voice" must be selected or the ENTER key pressed before the randomized voice data is sent to the DX100. Another way to select the Randomize feature is to press the ALT key on the right side of the keyboard. Saving Voice Data Select Save from the Project Menu to save the changes made to the selected voice that is currently being edited. The new parameters will replace all the old values for this voice. The new voice will now become the "original" voice that will be sent to the DX100 when the "Select Original" Menu is selected. The "Save Fwd" Menu selection, which stands for Save Forward, works quite differently than Save. This selection will copy the new voice parameters to the first empty place in the voice bank immediately following the selected voice. The original selected voice will not be modified in any way. If there are no empty locations after the selected voice, the "Save Fwd" feature will not work and the user will be notified of this. The "Save Fwd" selection provides a convenient means of saving various changes made to the original voice without changing the selected voice itself. Printing Voice Data Selecting Print from the Project Menu will print all of the voice parameters that have been saved with the Save menu selection. The printer will follow the settings in Preferences which must be present on the user's Workbench Disk. Special Keyboard Key, the CTRL key Use the CTRL key to change all four operator parameters simultaneously. See the section "Editing Voices" for more information. Alternate Keyboard Keys There are six keys that can be used in place of menu selections. These keys have already been discussed but will be summarized here. Keyboard Key Menu Selection ALT (on right side) Randomize Left Pointing Arrow Select Original Right Pointing Arrow Select Modified Up Pointing Arrow Activate Ext Keyboard ENTER Send Voice HELP Undo Exiting the Voice Editor Window Select Exit from the Project Menu. The Voice Librarian Window will again open. Printing from the Voice Librarian Selecting Print from the Project Menu will print all of the names of the voices in the active voice bank, which is the opened bank with its title displayed in red. Quitting the Voice Librarian Select Quit from the Project Menu section to quit the DX100 Editor/Librarian. JAMES M. SMITH MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS MANUAL OR WITH RESPECT TO THE SOFTWARE DESCRIBED IN THIS MANUAL, ITS QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.