home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / gusmix11.zip / GUSMixer.TXT < prev    next >
Text File  |  1994-04-06  |  8KB  |  191 lines
  1. ================================================================================
  2.                      Gravis Ultrasound Mixer (for OS/2 2.x)
  3.                              Freeware, Version 1.1
  4.  
  5.                             (c) 1994, Robert Turner
  6.                       rdturner@undergrad.math.uwaterloo.ca
  7. ================================================================================
  8.  
  9. DESCRIPTION:
  10.  
  11.       This is a simple line mixer for the Gravis Ultrasound.  It allows the
  12. user to enable and disable the input and output lines on their Ultrasound 
  13. card. It requires OS/2 2.x (with Presentation Manager installed) to run.
  14.  
  15. This product is intended to hold over until an MMPM mixer for the Ultrasound
  16. arrives.
  17.  
  18. This software is *FREE*.  The author can be contacted at the above Internet
  19. electronic mail address for at least the next year.  Comments, bug reports, 
  20. and suggestions are all welcome.
  21.  
  22. I hope this proves useful to someone other than myself.
  23.  
  24.  
  25. DISCLAIMER: (Just in case someone thinks about sueing me for something...)
  26.  
  27.       THE AUTHOR (ROBERT TURNER) PROVIDES NO GUARRENTEE THAT THIS SOFTWARE
  28. WILL PERFORM AS DESCRIBED, ALTHOUGH EVERY ATTEMPT HAS BEEN MADE TO ENSURE 
  29. THAT IS DOES.  THE AUTHOR ALSO WARNS THAT IMPROPER USE OF THIS SOFTWARE, 
  30. CAUSED BY SETTING UP THE OPTIONS INCORRECTLY, OR BY HAVING INCOMPATIBLE 
  31. HARDWARE, MAY CAUSE MALFUNCTIONS, AND POSSIBLY DAMAGE (ALTHOUGH HE HOPES 
  32. NOT) TO THE USER'S HARDWARE.  BY USING THIS SOFTWARE, IT IS UNDERSTOOD 
  33. THAT THE USER UNDERSTANDS THAT HE/SHE UNDERTAKES COMPLETE RESPONSABILITY 
  34. FOR WHATEVER HAPPENS THROUGH USE OF THIS SOFTWARE, BE IT BENEFICIAL OR 
  35. DETREMENTARY.
  36.  
  37.  
  38. INSTALLATION:
  39.  
  40.       Copy the GUSMixer.EXE file into a directory or your choice.  You may 
  41. want to put it in a directory on your path.  You can add it to your startup 
  42. folder or your CONFIG.SYS file so that is gets run every time you start 
  43. your system.
  44.  
  45.       Before playing with the line settings, select "Options..." from the 
  46. system menu of the GUSMixer window, and make sure that the "Port" setting 
  47. corresponds to the I/O port where your Ultrasound card is located.
  48.  
  49.  
  50. USAGE:
  51.  
  52.       The program is fairly self explanatory.  The main window contains 
  53. three check boxes which correspond to the outputs and inputs on the back of 
  54. the Ultrasound card.
  55.  
  56.      "Line Out"     When checked, enables output to the line out jack, and 
  57.                     the headphone out jack.
  58.      "Line In"      When checked, enables input to the Ultrasound from the
  59.                     line in input.
  60.      "Mic. In"      When checked, enables input to the Ultrasound from the 
  61.                     Microphone input.
  62.  
  63. The check boxes can be in three states.  Normally you will only see the two 
  64. determinate states, checked and unchecked.  These correspond to the lines 
  65. being enabled and disabled respectively.  The other state is the grayed sate 
  66. for the check box.  This indicates the GUSMixer does not know what state the 
  67. line is in.  (NOTE: The Ultrasound does not allow querying of the line states, 
  68. so until you set them to something, they will be indeterminate.)
  69.  
  70.       Two extra menu items are attached to the system menu, 'Options..." and
  71. "Product Information...".
  72.  
  73.  
  74. OPTIONS
  75.  
  76.       Restore Window Position on Startup
  77.  
  78.           If this option is set, when GUSMixer starts, it will restore the 
  79.           window to the last saved position.  If the window was minimized, 
  80.           this state will be preserved.  The window position is saved when 
  81.           you press "Save Now", or if "Save Options on Exit" is set, when 
  82.           GUSMixer terminates.
  83.  
  84.       Save Options on Exit
  85.  
  86.           If this option is set, the options displayed in this window will be 
  87.           saved.  Options are saved in the OS2.INI file.
  88.  
  89.       Port
  90.  
  91.           This specifies the I/O port where your Ultrasound is located.  
  92.           Currently GUSMixer does not attempt to locate the Ultrasound, and 
  93.           hence requires the user to set this variable.  The default is 0x220.
  94.           The user should ensure that this is set up correctly before trying 
  95.           to change the line settings.
  96.  
  97.       Set Lines on Startup
  98.  
  99.           If this option is set, when GUSMixer starts, it will set the 
  100.           Ultrasound input/output lines to reflect the "Initial Line 
  101.           Settings".
  102.  
  103.         Initial Line Settings            
  104.           Line Out      \
  105.           Line In        >  These are the same as in the main window.  Except
  106.           Mic. In       /   that you cannot leave the line in an indeterminate 
  107.                             state.
  108.  
  109.       Refresh Lines
  110.  
  111.           If this option is on, GUSMixer will refresh the Ultrasounds lines
  112.           periodically to the current state shown by the main window.  The
  113.           refresh interval is specified by the "Refresh Interval" field.
  114.  
  115.         Refresh Interval
  116.  
  117.           Specifies the refresh interval in tenths (1/10) of a second.
  118.  
  119.  
  120.       Save now
  121.  
  122.           Saves the current settings.  Useful if you don't want to save 
  123.           settings every time you close GUSMixer (or shut down you system 
  124.           with it running).
  125.  
  126.  
  127. COMMAND LINE OPTIONS
  128.  
  129.      The command line options always override the saved settings.  So if 
  130. you've got the port saved wrong, or you're having problems, you can use 
  131. these to force a known state.  All options must be specified separately 
  132. (sorry...), ie.
  133.     -l -o -i -s  
  134. instead of
  135.     -lois
  136. If any parameters are invalid, they are ignored and no error is reported.
  137. Parameters may be specified in any order.  Parameters are processed in the
  138. order they are specified, and the last occurance of the parameter is the one
  139. that takes effect.  The parameters all correspond (with the exception of 
  140. "-i") to options in the "Options" window.
  141.  
  142.      -pNNNNN     Port:      Replace NNNNN with the port number, valid 
  143.                             choices are: 
  144.                               0x210, 0x220, 0x230, 0x240, 0x250, 0x260.
  145.  
  146.      -fNNNNN     Refresh:   Replace NNNNN with the desired refresh interval
  147.                             (in tenths (1/10) of a second). If 0 is 
  148.                             specified, the refreshing of the lines is 
  149.                             disabled.
  150.  
  151.      -o[0|1]     Line Out:  Enables ("1") or disables ("0") the line out.  
  152.                             Defaults to enable if "0" or "1" not specified.  
  153.                             Note that for the line to actually be enabled 
  154.                             or disables, the "-s" option must also be 
  155.                             specified.
  156.  
  157.      -l[0|1]     Line In:   Enables ("1") or disables ("0") the line in.  
  158.                             Defaults to enable if "0" or "1" not specified.  
  159.                             Note that for the line to actually be enabled or 
  160.                             disables, the "-s" option must also be specified.
  161.  
  162.      -m[0|1]     Mic. In:   Enables ("1") or disables ("0") the microphone 
  163.                             in.  Defaults to enable if "0" or "1" not 
  164.                             specified.  Note that for the line to actually 
  165.                             be enabled or disables, the "-s" option must 
  166.                             also be specified.
  167.  
  168.      -i[0|1]     Iconic:    Minimizes ("1") or Restores ("0") the window.  
  169.                             Defaults to Minimize if "0" or "1" not 
  170.                             specified.  Note that the "-r" option must be 
  171.                             specified for this option to take effect.
  172.  
  173.      -r[0|1]     Restore:   Restores the window settings to the saved or 
  174.                             overridden ones.
  175.  
  176.      -s[0|1]     Set Lines: Sets the Ultrasound input and output lines to the
  177.                             saved or overidden settings.
  178.  
  179.  
  180. OTHER PEOPLES TRADEMARKS AND COPYRIGHTS
  181.  
  182. (These are not quite exact, but are intended to give an idea who owns what.)
  183.  
  184.      Gravis, and Gravis Ultrasound are either registered trademarks, or 
  185.      copyrighted names of Advanced Gravis or Forte.
  186.      All rights reserved.
  187.  
  188.      OS/2 and Presentation Manager are either registered trademarks, or
  189.      copyrighted names of International Buisiness Machines Corp.
  190.      All rights reserved.
  191.