=========================================================================== Advanced Gravis Computer Technology Ltd. GIPC (GUS Interwave patch Converter) Version 1.0 (Gipc1.zip) Copyright (C) 1996 by Advanced Gravis Computer Technology Ltd. All Rights Reserved =========================================================================== GIPC(GUS InterWave Patch Converter), Version 1.0 Written by Curtis Patzer, Advanced Gravis Computer Technology, 1995 1.0.0 Introduction GIPC is a DOS utility for converting groups of UltraSound patch files (.PAT) to an InterWave patch file (.FFF) and data file (.DAT). ULTRASND.INI or a user-specified .INI file contains the names of the UltraSound patches to convert. Patch numbers are specified for each patch, and patches can be arranged into Melodic and Drum banks during conversion. Also, patches can be put into exclusion groups to control polyphony. 2.0.0 GIPC Operation GIPC should be run from the directory containing ULTRASND.INI or the .INI file you want to use. 2.1.0 GIPC Command Line Options The command options are as follows: GIPC d:path i:name.ini n:name.fff d specifies the drive and directory where the InterWave patch files will be built. The UltraSound patch directory is specified in the .INI file (see Section 1.2.0). i specifies the name of the .INI file to use for conversion. The file name must end in .INI. If this option is not specified, GIPC tries to use ULTRASND.INI. If ULTRASND.INI or the specified .INI file does not exist in the current directory, GIPC exits. n specifies the name of the InterWave patch bank file. The file name must end in .FFF. If this option is not specified, GIPC will create DEFAULT.FFF (and the associated data file DEFAULT.DAT). Any other command line option will cause GIPC to display a usage line listing the above options. 3.0.0 INI File Information Look at a copy of ULTRASND.INI. This is a good place to start before creating your own custom conversion file. 3.1.0 Melodic Bands The number inside the square brackets indicates the bank number. You may specify as many melodic banks as you wish, as long as each bank has a different bank number. Make sure each bank has its own PatchDir line to tell GIPC where to look for UltraSound patch files. The PatchDir line must be before the first patch line in the bank. The number preceding the patch name will become the program number for that patch in the InterWave patch bank. 3.2.0 Drum Bands The number inside the square brackets indicates the patch number (each collection of drum sounds or 'kit' is accessed by patch number) for the kit. You may specify as many drum kits as you wish, as long as each kit has a different patch number. Make sure each bank has its own PatchDir line to tell GIPC where to look for UltraSound patch files. The PatchDir line must be before the first patch line in the bank. The number preceding the patch name indicates the MIDI note number for that patch in the particular InterWave drum kit. 3.3.0 Exclusion Groups Sometimes it is desirable to stop one drum sound when another starts. For example, if a closed hi-hat sound follows an open hi-hat sound, the open hi-hat sound should stop when the closed hi-hat sound starts. Assigning both the closed and open hi-hat patches to the same exclusion group will do this. To assign an instrument to an exclusion group, add the following line before the instrument: #exclude:n where n is a number greater than zero. Note that each instrument in the group must have this line before it. 3.4.0 Other Issues Older versions of ULTRASND.INI have sections called [Melodic Patches] and [Drum Patches]. These must be after all patches to be converted, because conversion will stop if one of these sections is encountered. These sections are not used by the conversion process, and are not necessary. You may add comments on lines starting with #, as long as the first word of the comment is not "exclude". 4.0.0 Things You Need to Know About IW.INI You will need to change IW.INI to hear your new patches (until Bank Manager software is available). Say you have created a patch file called "mine.fff". To hear sound from this bank, do the following: Find the [vendors] section and add a new line with your patch file name and a configuration name (say you chose "mypats"). For example: [vendors] rom_amd_1m=ROM_AMD_1_1_ << default patch name. Leave it alone. mypats=mine.fff << add this line with your patch file & config names default=mypats << change this line to equal your configuration name Alternatively, you can mix the default patch set with your patches. If you put your patch file name after the default name, your patches will replace only default patches which have the same patch number as one of your patches. Put your patch file name at the end of the line, separated by a comma like this: [vendors] rom_amd_1m=ROM_AMD_1_1_ << default patch name. Leave it alone. mypats=ROM_AMD_1_1_, mine.fff << add this line with your patch file name at the end default=mypats << change this line to equal your config name Next, you must add a vendor section to indicate where your patch file is located. For the above example, add: [vendor mypats] << replace mypats with your defined name mine.fff=c:\iw\patches\new << use your patch file name and the path to your patch file You will need to reboot (or run iwinit.exe) before you can hear your patches. [End of File]