home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / GRAV_MIS / GUSORG.ZIP / GUSORG.DOC < prev    next >
Encoding:
Text File  |  1993-05-05  |  5.7 KB  |  137 lines
  1. 4/15/93  Gusorgan documentation.  (c) Copyright 1993 Dale Eason  All
  2. rights reserved.
  3.  
  4. Gusorgan is a DOS program for midi keyboard and the Gravis Ultrasound
  5. adapter.  It mimics an organ console with one keyboard and 16 stop tabs.
  6. Stop tabs select what voices (patches) will play when midi keys are pressed.
  7. You use the computer keyboard to select the stop tabs.  A config file is used
  8. to select what patches are control by the stop tabs.  Up to 16 patches can be
  9. controlled and played simultaenously by Gusorgan.  If you do not have a midi
  10. keyboard or midi adapter you can still hear the patches demoed using the demo
  11. command.  Audition keys [ and ] can be used to play the chromatic scale.
  12.  
  13. Requirements:   Midi keyboard.  Gus midi adapter or MPU401 compatible adapter.
  14.                 Organ config file.
  15.  
  16. CONFIG FILE
  17. Here is a sample organ config file.  Each line specifies what patch is
  18. controled by each stop tab.  Parameters are:
  19.         stop tab number (must be in integer sequencal order),
  20.         patch file name,
  21.         note number offset to be added to the midi note on/off message,
  22.         tuning adjustment,
  23.         volume adjustment.
  24.         Pan setting   values are 0-15  0 - left, 15 - right,  7- middle.
  25.  
  26. # comment line start with a #
  27. # patch_file  note_offset Tuning_adj      Volume_adj      pan_adj
  28. 1 prince8.pat -12            1.01                1.         3
  29. 2 prince8.pat   0            1.01                1.         2
  30. 3 prince8.pat   0            1.019               1.        14
  31. 4 prince8.pat  24            1.01                1.         2
  32. 5 bourd4.pat  -12            1.                  1.         7
  33. 6 bourd4.pat    0            1.                  1.         7
  34. 7 bourd4.pat   12 1. 1.    7
  35. 8 tubebell.pat 12 1. .6  7
  36. 9 voices.pat    0 1. 1.  7
  37. 10 harp.pat     0 1. 1. 7
  38. 11 c:\ultrasnd\midi\unicorn.pat 0 1. 1. 7
  39. 12 polysyn.pat  0 1. 1.  7
  40. 13 clarinet.pat 0 1. 1. 7
  41. 14 trumpet.pat 0 1. 1.  7
  42. 15 synstr1.pat 0 1. 1.  13
  43. 16 synstr2.pat 0 1. 1.  3
  44.  
  45. The 3rd parameter (note number offset) is used to shift the patch up and down
  46. an octave.  Most organs have stops that play 1 and 2 octaves lower and higher
  47. than the normal pitch.
  48.  
  49. The 4th parameter is the tuning adjustment.  It changes the base tuning of the
  50. whole patch and is multiplied with the frequency of the note selected.
  51. A value of 1.059 will shift a note up a semitone.  Values
  52. between 1 and 1.059 can be used to adjust the patch tuneing.
  53.  
  54. The 5th parameter is the volume adjustment and is multiplied with the midi
  55. velocity.  It can be used to increase or decrease the volume of a patch as
  56. compared to the others.
  57.  
  58. The 6th parameter is the pan adjustment.  I specifies the volume of the
  59. patch for each left and right speaker.  The values range is 0-15.  0 is
  60. full left, 7 is middle, 15 is right.
  61. CONTROLS
  62.  
  63. Usage is:       gusorgan [config_file]
  64. Once it starts you can get help by typing h.
  65.  
  66. If no config_file is given then it will use organ.cfg as the config file.
  67. It will search for pathces in the following directories, default,
  68. ultrasnd/midi, ultrasnd/patch if you have the ultradir enviornment
  69. variable set in your dos enviornment.
  70.  
  71. Stops must be turned on to get any sound.  Use the number keys to turn
  72. on stops.  See the help screen.  A plus sign to the left of the patch
  73. name indicates the stop is on.  A blank indicates it is off.
  74.  
  75. Other keys allow you to adjust volume of output, shift the keyboard up and down
  76. by octaves, stop all notes that get stuck on. See the gusorgan help screen for
  77. info.
  78.  
  79.  
  80. PATCHES
  81. I have included 2 new GUS patches:
  82.         princ8.pat      8 foot principal pipe sound
  83.         bourd4.pat      4 foot bourden pipe sound
  84.  
  85. These sounds were sampled from my pipe organ and turned into 16 bit patches
  86. using my own resysnthasis program and the Gravis SDK patch editor.
  87. I hope to create other pipe organ patches
  88. in the future.
  89.  
  90. MIDI IMPLEMENTATION
  91. Gusorgan only understands midi note on and off messages for now.  You
  92. can overide the midi note velocity by using the v toggle.  It will
  93. toggle between using midi velocity and a constant velocity of 120.
  94.  
  95. INSTALLATION
  96.         The files are distributed in one self extracting zip file.
  97.         Copy files to your hard disk then type GUSORG to extract them.
  98.         You can then try it out by typing gusorg.
  99.  
  100. STARTUP OPTIONS
  101.         To get a list of start up options enter
  102.                 gusorgan -h
  103.  
  104.         Gusorgan can also receive midi input from MPU401 compatible devices.
  105.         To enable MPU401 input use the -m option on startup.  To set the
  106.         MPU401 irq to a value other 9 use the -i option.  To set the MPU401
  107.         IO address to a value other than 0x330 use the -a option.  Irq values
  108.         are input in decimal and IO address must be in hex notation.
  109.  
  110.     For example to enable MPU401 input using the default irq and IO address:
  111.         gusorgan -m
  112.  
  113.     To enable MPU401 input using irq 12 and IO address 0x340:
  114.         gusorgan -m -i12 -a0x340
  115.  
  116. PROBLEMS
  117.         Turning stops off while notes are held will cause the note to keep
  118.         playing after the key is let up.  Use the 'a' key to turn off
  119.         stuck notes.
  120.  
  121. Let me know what you think.  This program is free for personal use.
  122. I plan to make more advanced versions shareware. If you would like to distribute
  123. it or an improved version with some commercial packages please contact me.
  124.  
  125.  
  126. VERSION INFO
  127. Ver 1.0         First release
  128. Ver 2.0         Added pan position.  Added [] keys to play a scale.
  129.                 Added mpu401 uart mode support.  Added command line switches
  130.                 for mpu401 irq and io address settings.
  131.  
  132. Dale Eason
  133. 1382 West Eldridge Ave
  134. Roseville, MN. 55113
  135.  
  136. Dale.Eason@stpaul.ncr.com
  137.