home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / MULTIMED / XGDSP103 / xgdsp.doc < prev    next >
Text File  |  1997-06-12  |  10KB  |  235 lines
  1.  XG DSP                                      Copyright (C)1997 Cornel Huth
  2.  release 1.0                                                   12-May-1997
  3.  
  4.  
  5. XG DSP is an OS/2 PM DSP editor/controller for Yamaha XG (SW60XG and MU80)
  6. devices.  More than 100 controls are available to modify the three effect
  7. processors in real-time, and can be saved to any of 32 fully-programmable
  8. presets.  XG DSP is for modifying external input sources (CD, line-in, and
  9. mic).  The processed output can be routed to a sampler for saving in digital
  10. format, or back to the stereo system (with excellent results).
  11.  
  12. XG DSP is an OS/2 PM application (MMPM/2 is not required).  Files included:
  13.  
  14.         1. paradise.sys
  15.         2. xgdsp.exe
  16.  
  17. A few additional files also come with the package.  Optionally, if you are
  18. running Warp 3 or earlier:
  19.  
  20.         3. clock01.sys  (clock02.sys available by request, for MCA)
  21.  
  22. No other drivers are needed.  MMPM/2 is not required (but is okay), nor
  23. are any soundcard drivers.  This package includes everything you need
  24. to control the A/D section of your Yamaha.  The DB50XG does not apply,
  25. since it does not have an A/D section.
  26.  
  27. For related files go to http://www.40th.com/ and look around the Paradise
  28. section.  If you are using an older version of the Paradise driver, be
  29. sure to replace it with the driver in this package (version 1.70).
  30.  
  31. Screen shots are also at the 40th Floor web site.
  32.  
  33.  
  34. Installation
  35. ------------
  36.  
  37. Install the (two) SYS driver(s) in your boot drive's root directory and
  38. include a reference for the paradise driver in your config.sys:
  39.  
  40.         DEVICE=G:\PARADISE.SYS     (optional -q for quiet install)
  41.  
  42. Paradise version 1.7 or later is required.
  43.  
  44. CLOCK01.SYS, installed automatically by the boot process and so has no
  45. reference in the config.sys file, is based on the Warp 4.0 driver.  It
  46. can be used in previous OS/2 versions, too.  If you are using Warp 4.0,
  47. your CLOCK driver already has the IDC hook, so you can use the one you
  48. already have.  The included CLOCK01.SYS driver is only for those running
  49. Warp 3 or earlier.
  50.  
  51. Note:  XG DSP does not need to use the clock driver, but since Paradise
  52. does, and since the newer clock version is better than the old, it needs
  53. to be installed.
  54.  
  55. Once you have the driver(s) installed, reboot.
  56.  
  57. Note:  There is no need to remove any driver from config.sys.  All you
  58. need to do is add an entry for PARADISE.SYS, and possibly copy the
  59. clock01.sys included in this package to boot:\.  That's all there is
  60. to it.
  61.  
  62.  
  63. Using XG DSP
  64. ------------
  65.  
  66. The XGDSP.INI File
  67.  
  68. When you first use XG DSP a configuration menu is shown.  Select your
  69. base port, then OK.  This only needs to be once, when you first use XG DSP.
  70. You can later change these settings by starting XG DSP with the -config switch,
  71. or by selecting CONFIG from the main control panel.  XG DSP stores this
  72. information in the xgdsp.ini file, which is located in the same directory
  73. as the directory from which xgdsp.exe is executed.  If this directory is
  74. not writable you cannot save any settings.  If you delete the ini file
  75. you will be presented with the configuration menu again,
  76.  
  77. If you ever have a problem with XG DSP you may want to delete the xgdsp.ini
  78. file and go again, but do so only as a last resort since it has more than
  79. 10KB of information in there (all your preset data).
  80.  
  81. At each start, XG DSP asks if you want to reset the MPU to UART mode.  If
  82. the MPU device has not been used since powered-up you should select YES.
  83.  
  84. If a xgdsp.ini file already exists it is loaded into memory, otherwise,
  85. one is created with default data for all 32 presets.  The last preset used
  86. (or the first one, if a new ini file) is used to initialize the XG.  You
  87. will notice no sound for about 1 second when XG DSP first starts up.  This
  88. is the result of A/D reset, and usually only happens at start up.
  89.  
  90.  
  91.  
  92. Main Control Panel
  93.  
  94. The main control panel of XG DSP consists of four selectors, 32 preset buttons,
  95. and a display.  The four selectors bring up other windows.  You've already seen
  96. CONFIG.  ABOUT is an information window, and tells you a little bit about
  97. XG DSP.  The power of XG DSP comes from the ADJUST and PROGRAM windows,
  98. described below.
  99.  
  100. The display window in this panel shows the current preset (name, and
  101. description), and the current levels as set in ADJUST (volume out, line
  102. out, mic input, MIDI out, reverb send, chorus send, variation send,
  103. effects volume, reverb return, chorus return, variation return, dry level,
  104. voice cancel (1=on), left/right channel (1=active), karoke lock (1=locked),
  105. line-in bypass (1=bypass), reset A/D on new preset (1=true), and the
  106. write-protect status (1=current preset will not be written to disk)).
  107.  
  108.  
  109. Adjust Levels Panel
  110.  
  111. This panel controls the levels for the current preset.  Each preset has its
  112. own levels (as well as everything else) stored in the INI file.  For further
  113. explanation, refer to the XG Guidebook, or your hardware manual.
  114.  
  115. The send and return levels typically should not all be maxed out.  The
  116. defaults are usually fine, though you may want to max them out in some
  117. cases.
  118.  
  119. The EQ section shown in this panel is active when the VARIATION effect is
  120. set to 3-band Equalizer.
  121.  
  122.  
  123. Program Panel
  124.  
  125. The program panel sets up the effects' parameters, and lets you add your own
  126. preset button name as well as a description (shown in the main control panel's
  127. display window).
  128.  
  129. It also lets you copy from one preset to another, so you can quickly clone and
  130. modify.  All preset data is copied, except for the write-protect state, which
  131. is stripped to not protected.  This WP state only applies when the preset data
  132. is saved to the INI file (at program exit, or from CONFIG, see xgdsp.faq for
  133. more).  Be sure to not set the WP state to true until -after- you have already
  134. saved the preset.  The WP state is not checked until the actual ini file is
  135. written to disk.
  136.  
  137. The Reset A/D button normally should be left off, though you may want to set it
  138. for one preset (perhaps a "my default setup" preset).  When it is active, each
  139. time a new preset is selected (with the Reset A/D on), the A/D section is
  140. initialized.  This will cause a 1 second disruption is sound (sound is muted).
  141.  
  142. | If you use the MPU for both MIDI playback and XG DSP, you will may want to
  143. | use the Reset A/D mode since MIDI playback will almost always turn off the
  144. | A/D section.
  145.  
  146. Each of the three effects can be active:  either one, two, or all at the same
  147. time.  Select the drop down list and pick an effect from there.  As soon as
  148. you select one, the default data for that effect type is sent to the hardware.
  149.  
  150. This happens each time you select an effect type (Hall 1, Hall 2, etc.), for
  151. any of the effects (Reverb, Chorus, Variation).  You can make changes to the
  152. default values assigned by XG DSP to each effect type, and you can save these
  153. changes to the xgdsp.ini file for later retrieval (by selecting this preset).
  154.  
  155. Once you select a new effect type (from the drop down list), any change you
  156. made for that effect is lost (perhaps only until the next program start if
  157. you have write-protect selected prior to the next save).
  158.  
  159. To change the XG DSP default assigned value for a parameter (delay time in ms,
  160. for example), use the mouse to 'rotate' the knob, or, select the knob and
  161. use the keyboard cursor arrows to 'rotate' the knob.  To return a knob to
  162. the XG DSP default value, hold down the left control key and click the KNOB
  163. itself.  Its color will return to yellow.  You can also use either shift key
  164. instead of the left control key.
  165.  
  166. The Prev/Next buttons take you to the previous/next preset setup.  You can
  167. also exit the Effect Parameter Setup window, push the preset button you want
  168. to change, and then select PROGRAM again.  When you go to a new preset its
  169. data is automatically sent to the XG as soon as you move to it.
  170.  
  171. Consult your hardware manual for more information on what each knob does,
  172. or if you have registered contact support@40th.com.
  173.  
  174.  
  175. Support
  176. -------
  177.  
  178. Technical support is available to those that have licensed/registered
  179. XG DSP.  Contact support@40th.com with the problem/request, and include
  180. the approximate -date- that you registered XG DSP.
  181.  
  182. If you are evaluating XG DSP, and have not yet purchased a license, you may
  183. still ask for help if the problem concerns the basic installation of the
  184. XG DSP program.  No other support is available until you have registered.
  185.  
  186.  
  187.  
  188. Limitations
  189. -----------
  190.  
  191. | The ADJUST and PROGRAM buttons are loosely tied togther, and, while you
  192. | can have both panels operating at the same time, you need to close then
  193. | in LIFO order.  You can just close them both just as easily and then
  194. | open them again.
  195.  
  196. One instance per path\xgdsp.exe is allowed.  If you ever have a need to
  197. run more than one XG DSP, use another path to locate the additional EXE(s).
  198. It is not recommended to have two XG DSPs running against the same XG device,
  199. at the same base port.
  200.  
  201. See the FAQ for more.
  202.  
  203.  
  204. Tips
  205. ----
  206.  
  207. The following optional switches may be used on the command line when starting:
  208.  
  209.  [G:\]XGDSP -config -beep -noreset -min -nolp -nosp -nosave -w:
  210.  
  211.  -config        Brings up the configuration menu to select base port, WP map,
  212.                 and SAVE NOW option
  213.  
  214.  -beep          Beeps now and then, for audible feedback.
  215.  
  216.  -noreset       When used, does not prompt for MPU UART reset (and won't)
  217.  
  218.  -min           Start minimized.  Can also [G:\]start /min xgdsp.exe
  219.  
  220.  -nolp          Do not load window positions from ini file at startup
  221.  
  222.  -nosp          Do not save new window positions during ini write
  223.  
  224.  -nosave        Do not save new INI data at program exit
  225.                 (but will still save from CONFIG SAVE button)
  226.  
  227.  -w:65000       If MPU time-out errors occcur, use -w:65000 (then lower values)
  228.  
  229.  
  230. Order -before- November 1997 and get a $30 discount.  See the order form for
  231. details.
  232.  
  233. See the README file for more, especially changes made or other special
  234. notices.
  235.