4/15/93 Gusorgan documentation. (c) Copyright 1993 Dale Eason All
Gusorgan is a DOS program for midi keyboard and the Gravis Ultrasound
adapter. It mimics an organ console with one keyboard and 16 stop tabs.
Stop tabs select what voices (patches) will play when midi keys are pressed.
You use the computer keyboard to select the stop tabs. A config file is used
to select what patches are control by the stop tabs. Up to 16 patches can be
controlled and played simultaenously by Gusorgan. If you do not have a midi
keyboard or midi adapter you can still hear the patches demoed using the demo
command. Audition keys [ and ] can be used to play the chromatic scale.
Requirements: Midi keyboard. Gus midi adapter or MPU401 compatible adapter.
Organ config file.
Here is a sample organ config file. Each line specifies what patch is
controled by each stop tab. Parameters are:
stop tab number (must be in integer sequencal order),
patch file name,
note number offset to be added to the midi note on/off message,
Pan setting values are 0-15 0 - left, 15 - right, 7- middle.
# comment line start with a #
# patch_file note_offset Tuning_adj Volume_adj pan_adj
1 prince8.pat -12 1.01 1. 3
2 prince8.pat 0 1.01 1. 2
3 prince8.pat 0 1.019 1. 14
4 prince8.pat 24 1.01 1. 2
5 bourd4.pat -12 1. 1. 7
6 bourd4.pat 0 1. 1. 7
7 bourd4.pat 12 1. 1. 7
8 tubebell.pat 12 1. .6 7
9 voices.pat 0 1. 1. 7
10 harp.pat 0 1. 1. 7
11 c:\ultrasnd\midi\unicorn.pat 0 1. 1. 7
12 polysyn.pat 0 1. 1. 7
13 clarinet.pat 0 1. 1. 7
14 trumpet.pat 0 1. 1. 7
15 synstr1.pat 0 1. 1. 13
16 synstr2.pat 0 1. 1. 3
The 3rd parameter (note number offset) is used to shift the patch up and down
an octave. Most organs have stops that play 1 and 2 octaves lower and higher
than the normal pitch.
The 4th parameter is the tuning adjustment. It changes the base tuning of the
whole patch and is multiplied with the frequency of the note selected.
A value of 1.059 will shift a note up a semitone. Values
between 1 and 1.059 can be used to adjust the patch tuneing.
The 5th parameter is the volume adjustment and is multiplied with the midi
velocity. It can be used to increase or decrease the volume of a patch as
compared to the others.
The 6th parameter is the pan adjustment. I specifies the volume of the
patch for each left and right speaker. The values range is 0-15. 0 is
full left, 7 is middle, 15 is right.
Usage is: gusorgan [config_file]
Once it starts you can get help by typing h.
If no config_file is given then it will use organ.cfg as the config file.
It will search for pathces in the following directories, default,
ultrasnd/midi, ultrasnd/patch if you have the ultradir enviornment
variable set in your dos enviornment.
Stops must be turned on to get any sound. Use the number keys to turn
on stops. See the help screen. A plus sign to the left of the patch
name indicates the stop is on. A blank indicates it is off.
Other keys allow you to adjust volume of output, shift the keyboard up and down
by octaves, stop all notes that get stuck on. See the gusorgan help screen for
I have included 2 new GUS patches:
princ8.pat 8 foot principal pipe sound
bourd4.pat 4 foot bourden pipe sound
These sounds were sampled from my pipe organ and turned into 16 bit patches
using my own resysnthasis program and the Gravis SDK patch editor.
I hope to create other pipe organ patches
in the future.
Gusorgan only understands midi note on and off messages for now. You
can overide the midi note velocity by using the v toggle. It will
toggle between using midi velocity and a constant velocity of 120.
The files are distributed in one self extracting zip file.
Copy files to your hard disk then type GUSORG to extract them.
You can then try it out by typing gusorg.
To get a list of start up options enter
Gusorgan can also receive midi input from MPU401 compatible devices.
To enable MPU401 input use the -m option on startup. To set the
MPU401 irq to a value other 9 use the -i option. To set the MPU401
IO address to a value other than 0x330 use the -a option. Irq values
are input in decimal and IO address must be in hex notation.
For example to enable MPU401 input using the default irq and IO address:
To enable MPU401 input using irq 12 and IO address 0x340:
gusorgan -m -i12 -a0x340
Turning stops off while notes are held will cause the note to keep
playing after the key is let up. Use the 'a' key to turn off
Let me know what you think. This program is free for personal use.
I plan to make more advanced versions shareware. If you would like to distribute
it or an improved version with some commercial packages please contact me.
Ver 1.0 First release
Ver 2.0 Added pan position. Added  keys to play a scale.
Added mpu401 uart mode support. Added command line switches
for mpu401 irq and io address settings.
1382 West Eldridge Ave
Roseville, MN. 55113[email protected]