MidiUtility 2.0 2/16/87 Djj Version 2.0 is an improved (I hope) version of MidiUtility 1.0. I've added an Intuition interface, a file requester and default directories for patch data, sequence data and bank data. This version is now compiled with Manx C. When started, a movable window will open indicating the commands available. You may either press a letter on the keyboard or click on the command letter to activate a command. Commands which require disk files, will bring up a file requester (thanks to C. Heath) showing the files contained in the default directory. All initial default directories will point to the RAM: device. (Instructions for patching the file for the directory of your choice will follow.) You may click on the category gadgets (PAT1, PAT2, SEQ, BANK) to change to a different directory, or you may enter a directory name in the DRAWER gadget at the top of the requester. The category gadgets default to the current logged in drive until changed by the user. (See below) There is a maximum of 5000 midi events which can be recorded. This can only be changed by recompilation. Also included in this ARC file are 4 banks of my favorite instruments, a bank containing the standard internal instruments and a bank of modified internal instruments required for Music Studio. ------------ Directory usage: PAT1 -- can hold data patches PAT2 -- can hold more data patches SEQ -- can hold recorded sequences BANK -- can hold banks of 16 data patches ----------- To change a default directory, you will need a binary file editor such as NEWZAP to patch the program. You will enter the name of the directories directly into the program data area. In NEWZAP, GOTO sector 32. At the offsets listed below you will find the areas for each default directory. You have 40 characters per directory name. You may use less than 40 characters, but NO MORE. dir offset (hex) PAT1 185 PAT2 1AD SEQ 1D5 BANK 1FD For example, if you entered DH1:MIDI/PATCH at offset 185, then when you select the PAT1 gadget, the above directory contents will be listed. Also, at offset 184 (sector 32) is a byte that determines if the filename gadget 'remembers' filenames. If set to 01, the gadget will come up empty each time the requester opens. If set to 00, the last filename entered will be 'remembered' and will appear in the name gadget. Your choice. D.J.James *** MIDI Utility Program - Documentation *** The MIDI utility program currently has the following functions: - Record a sequence from a MIDI keyboard - Playback a previously recorded sequence - Save/Load a sequence to/from disk - Download a sound data patch from disk to a CZ-101 synthesizer - Upload a sound data patch from a CZ-101 and save it to disk - Load all of the CZ-101 internal voices from a single file - Save all of the CZ-101 internal voices to a single file Starting the program -------------------- You can invoke the MIDI utility program from either Workbench or from the Command Line Interface (CLI). To start the program from Workbench, click the MIDI disk icon that appears on the workbench. When the new window opens, click the MIDI Utility icon that appears there. To start the program from CLI, type "MidiUtility" After the program is loaded, a menu will appear listing the functions of the program. Each function is selected with a one letter code. Recording a sequence -------------------- To record a sequence from a MIDI keyboard, type "R" at the command prompt. You can then record a musical sequence by pressing keys on the synthesizer keyboard. The recording process can be stopped by rolling the pitch wheel on the synthesizer. NOTE: The record routine does not work with certain synthesizers that send "unusual" MIDI data such as after-touch messages. Playback a sequence ------------------- To playback a previously recorded sequence, type "P" at the command prompt. This will play the sequence back through the synthesizer. Save/Load a sequence to/from disk --------------------------------- To save a recorded sequence to disk, type "S" at the command prompt. You will then be prompted to enter the name of a file to store the sequence in. To cancel the save, hit instead of entering a filename. To load a previously saved sequence, type "L" at the command prompt. You will then be prompted to enter the name of the file that contains the sequence to be loaded. If the file does not exist you will be reprompted until you enter a valid filename. To cancel the load, hit instead of entering a filename. Once the file has loaded you can then use the playback option to play the sequence through the synthesizer. Downloading a sound data patch to a CZ-101 ------------------------------------------ To download a sound data patch to a CZ-101 synthesizer, type "D" at the command prompt. You will then be prompted to enter the name of the file that contains the patch you wish to download. If the file does not exist you will be reprompted until you enter a valid filename. To cancel the download, hit instead of entering a filename. All of the sound data patches for the CZ-101 are contained in the subdirectory called CZ101. Example filename is "CZ101/harpsichord" NOTE: To download a patch to the CZ-101, the PROTECT switch on the back of the unit must be switched to OFF. Uploading a sound data patch from the CZ-101 -------------------------------------------- To upload a sound data patch from a CZ-101 synthesizer, type "U" at the command prompt. You will then be prompted to enter the name of a file to store the sound data patch in. To cancel the save, hit instead of entering a filename. The sound data patch that is saved is the current one selected in the CZ-101. Loading all the internal voices of the CZ-101 --------------------------------------------- This is a special command that allows you to load all of a CZ-101's internal voices (the ones that can be modified) from a single file. There are two files supplied in the CZ101 subdirectory named "Standard_Internals" and "MusicStudio_Internals". The first file contains the internals that are supplied in the CZ-101 from the factory. The second file contains another bank of internals that must be loaded in order to properly hear the .INT songs supplied with the Music Studio software. To load one of these files, type "I" at the command prompt. You will then be prompted for the name of a file to be loaded. If the file does not exist, you will be reprompted until you enter a valid filename. To cancel the load, hit instead of entering a filename. NOTE: To load the internals of the CZ-101, the PROTECT switch on the back of the unit must be switched to OFF. Saving all the internal voices of the CZ-101 -------------------------------------------- This command allows you save the state of a CZ-101's internal voices to a single file. To to this, type "A" at the command prompt. You will then be prompted for the name of a file to store the internals in. To cancel the save, hit instead of entering a filename.