
       Welcome to the Advanced Gravis Document Viewer.        By John Smith
       
       Update rev #93-03-03
   
      NEW USERS !  Use only the DOWN ARROW key for now.
       Further instructions on using this viewer will follow.


0.0.0 ********************* TABLE OF CHAPTERS ****************************

      Chapter 1.  GETTING STARTED, a MUST read!!!
              2.  ULTRASOUND SOFTWARE
              3.  TECH NOTES
              4.  WINDOWS
              5.  TROUBLESHOOTING


1.0.0 ***************** CHAPTER 1. - GETTING STARTED *********************

      SECTIONS for CHAPTER 1

      Section  1.0 - About Chapter 1
               1.1 - The Gravis Document Viewer 
               1.2 - Before installing the UltraSound card
               1.3 - Before installing the UltraSound software


1.0.1 About Chapter 1

      This is the MOST IMPORTANT chapter!  Please take time to read it!

       This chapter contains information for ALL users, experienced or not
       and should be read first.  It will save a lot of wasted time later.
    
       Section 1.0  About Chapter 1
                     A basic description on the contents of this chapter.

               1.1  The Gravis Document Viewer
                     Instructions on using this Gravis Document Viewer.

               1.2  Before installing the UltraSound card
                     A time saving pre-installation check list and tips on
                    PREVENTING DAMAGE to UltraSound and/or your computer.
                                             
               1.3  Before installing the UltraSound software
                     Preparing to install the UltraSound software and
                     connecting speakers and amplifiers.


1.1.0 SECTION 1.1 - The Gravis Document Viewer
       ===========

       ITEMS for SECTION 1.1

      Item  1.1.1  How the Gravis Document Viewer works.
            1.1.2  The Viewer's Screen
            1.1.3  Using the Gravis Viewer
            1.1.4  Selecting a Chapter
            1.1.5  Selecting a Section
            1.1.6  Selecting an Item
            1.1.7  Searching by Words

       Many readme.txt files are not read by users due to the size and
       time required to find the information of interest.
       It is also impossible to provide ALL of the MOST CURRENT information
       on paper due to the time and cost to produce paper documents.
       A few trees will also be saved.
                                                               
       The Gravis Viewer (GV.EXE) is a program that provides an easy and
       fast method to view the readme text file.
    
1.1.1 How the Gravis Document Viewer works
       
      ONLY use the DOWN or UP ARROW keys for now.   

       The Gravis Document Viewer uses the numbers down the left side of
       this text file as index markers for performing searches.
       The numbers represent Chapters, Sections within Chapters and
       Items or articles within Sections.
    
       For example this Item is indexed by the number 1.1.1.
                                                      ^ ^ ^
                               The Chapter number ----^ ^ ^
                               The Section number ------^ ^                        ^
                               The Item number -----------^

       When the Gravis Viewer is run, it scans the readme file for
       these index numbers.  The number table is then stored in ram.
       This table is referenced by the viewer to display the chosen text.
       This method allows fast access to the particular text of most
       interest without having to look through the whole file.
       Since the Viewer does not load all the of text into memory, as with
       most text viewers or editors, it is not restricted by file size.
       Although slower, it works well from floppy drives.

1.1.2 The Viewer's Screen      
       
       Now take a look a the top and bottom of the viewers screen.
       On the top of this screen you will see . . .
       
Gravis Viewer V1.3    [C]hap: 00 [S]ect: 00 [I]tem: 00  [F1]Help [ESC]Quit
                                ^          ^          ^    ^        ^
       Selected Chapter number -^          ^          ^    ^        ^
       Selected Section number ------------^          ^    ^        ^
       Selected Item number --------------------------^    ^        ^
       [F1] for reminder of key functions -----------------^        ^
       [ESC] To quit viewer IMMEDIATELY ----------------------------^

      Press [F1] now to look at the key functions.  DON'T use them yet!
       
       On the bottom of this screen you will see . . .

   Command:                                                      M O R E
       ^                                                             ^
       ^--------- Look in the command box for hints.                 ^
                  The M O R E just indicates more below. ------------^

1.1.3 Using the Gravis Viewer

       Most of the key functions of the viewer are straight forward.
       Simply using the arrow keys will enable you to view the text.
       A faster and more convenient way to view is to use the
       C, S and I keys. The functions for them are... 
       [C] for Chapter selection, [S] for Section selection and
       [I] for Item selection.
       
      DON'T try this yet... continue reading.

1.1.4 Selecting a Chapter

       ANY TIME the C key is pressed, the TABLE OF CHAPTERS will be
       displayed IMMEDIATELY.  In other words, you will viewing the
       beginning of this readme file.
       
       As you would in a book, you can find the chapter number of interest.
       The Command box will prompt you to select a chapter number.
       Simply type the number(s) and press enter.
       
       The beginning of the selected chapter will then be displayed,
       if it is available.  If not, the Command box will state this.
       
       There, you will be able the view the TABLE OF SECTIONS for the 
       selected chapter.

1.1.5 Selecting a Section 

       ANY TIME the S key is pressed, the TABLE OF SECTIONS for the
       currently selected CHAPTER (shown in top bar) will be displayed
       IMMEDIATELY.

       There you can choose the section number of interest.
       The Command box will prompt you to select a section number.
       Simply type the number(s) and press enter.

       The beginning of the selected SECTION will then be displayed, if
       it is available.  If not, the Command box will state this.
       
       There, you will be able the view the TABLE OF ITEMS for the 
       selected chapter and section.
       
1.1.6 Selecting an Item

       ANY TIME the I key is pressed, the TABLE OF ITEMS for the currently
       selected CHAPTER and SECTION (shown in top bar) will be displayed
       IMMEDIATELY.

       There you can choose the item number of interest.
       The Command box will prompt you to select a Item number.
       Simply type the number(s) and press enter.

       The Item of interest will be displayed. 

1.1.7 Searching by Words

       The Gravis Viewer can also search the text for key words.  This is
       useful for locating items that contain the words on a topic.
       Simply press an F to bring up the search feature.  Type into the
       box the text to be searched and press ENTER.  The viewer will
       search this text file from the beginning and will highlight in 
       yellow, the first line it finds that contains the searched text.
       To search for more, simply press F and then ENTER.
       TIP: You may want to take note of the item number if you need to
       find an Item that is of future interest.

      ....................................................................

1.2.0 SECTION 1.2 - Before installing the UltraSound card                                                                    
       ===========

       ITEMS for SECTION 1.2

      Item  1.2.1  Preparing to install the UltraSound card
            1.2.2  Preventing STATIC DAMAGE
            1.2.3  Unpacking the UltraSound card
            1.2.4  Handling the UltraSound card
               

1.2.1 Preparing to install the Ultrasound Card

       Give yourself plenty of work space.  Be sure that all power is off
       to ALL your computer equipment, including your printer.
       Be patient and take your time.

       Get to know the other devices in your computer by reviewing the
       documents for them.  You may have other add-on cards in your system
       like...
       Scanners, SCSI hard drive, CD-ROM, another game port.  These can
       use the same addresses, IRQ's or DMA's (DRQ's) as the UltraSound.
       If they do, UltraSound and the other device may not work together.
       They won't damage each other or the computer.

       If you have another game port you are using you will have to turn
       the Game Port on the UltraSound off.

1.2.2 Preventing STATIC DAMAGE

       DO NOT UN-PLUG the MAIN power cord from the computer or the wall
       outlet.  Many computer manuals instruct the user to do this as a
       way to prevent electric shocks.
       We do not recommend this, as it does not provide the grounding
       required to drain static electricity away.  Static electricity can
       damage the sensitive electronic components in your computer and on
       the UltraSound card.
       You will not get a shock due to the fact that the high voltage is
       shielded inside the metal power supply case.  Switching the main 
       power switch to off will remove power to the rest of the computer
       so that a card can be installed.
       Touching the metal case of the power supply frequently will 
       discharge any static charge on yourself.
       Grounding yourself is VERY important and MUST be performed by anyone 
       working with the computer.

1.2.3 Unpacking the UltraSound Card

       Unpack the UltraSound card next to the computer so that you can
       discharge any static by touching the metal on the computer 
       BEFORE you remove the card from its static resistant bag.

1.2.4 Handling the UltraSound Card

       Handle the card with care, so that no components get accidently
       bent.  Do not remove any jumpers that are not described in the
       printed  documentation.  The purpose of these are described in the
       UltraSound Hardware chapter of this document.

       Refer to the printed instructions on setting the jumpers and 
       installing the card.

      ....................................................................

1.3.0 SECTION 1.3 - Before installing the UltraSound software
       ===========
       
       ITEMS for SECTION 1.3

      Item  1.3.1  Preparing to install the Ultrasound software
            1.3.2  Preventing floppy disk damage
            1.3.3  Connecting speakers or amplifiers


1.3.1 Preparing to install the Ultrasound Software

       Be sure to have all disks ready.  If you have previously installed
       UltraSound software, we recommend that it be deleted.  The new
       software is superior than previous and should not be mixed with
       older software.  They will not work together!
       Be sure to save any other files you may want to keep.

1.3.2 Preventing Floppy Disk Damage

       The data on floppy disks is sensitive to magnetic fields and
       can be damaged if there is a strong magnetic field nearby.
       Since this is a sound product, it stands to reason that there will
       be speakers nearby.
      SPEAKERS AND HEADPHONES CONTAIN STRONG MAGNETS.
       Keep computer disks away from them.  Distance is your friend.
       There are many other devices that generate magnetic fields such as
       printers, amplifiers, monitors and even telephone receivers.

1.3.3 Connecting speakers or amplifiers

       Amplified speakers that are commonly used with small portable
       CD players should be connected to the amplified output connector
       of UltraSound.  These type of speakers should have a volume control.
       Amplifier/speaker systems should use the line output connector of
       UltraSound.  Use the line in, tape in, CD in or aux in connections
       on the amplifier or receiver.  DO NOT connect to the phono in of the
       amplifier or receiver.

      BE SURE to use ONLY a STEREO mini (3.5mm) phono style plug.
       All STEREO mini phono plugs have 2 black bands.
       If a MONO mini phono plug (1 band) is used, the UltraSound built in
       amplifier could be damaged!

      ....................... END of Chapter 1 ...........................

2.0.0 **************** CHAPTER 2.  ULTRA SOUND SOFTWARE ******************

       SECTIONS for CHAPTER 2

      Section  2.0  About Chapter 2
               2.1  Joystick/GamePort Utilities
               2.2  ULTRAJOY
               2.3  ULTRINIT
               2.4  PATCHMGR
               2.5  UBAT
               2.6  AUDIO
               2.7  SETGUS
               2.8  SBOS
               2.9  ULTRAFLI
               2.10 PLAYMIDI
               2.11 PLAYFILE
               2.12 CONVERT
               2.13 GRVCOLOR
               2.14 USS8
               2.15 ULTRAMOD


2.0.1 About Chapter 2

        This chapter is used to document new information on any of
        the software distributed with your UltraSound card. Any 
        information here supersedes anything in the manual or
        addendum.


2.1.0 SECTION 2.1 - Joystick/GamePort Utilities
       ===========

       This utility is used in conjunction with GravUtil.exe to set
       your joystick up. It loads itself and then runs Advanced
       Gravis' GravUtil.exe program to determine the proper joystick
       values. When in GravUtil, use the up arrow to increase the
       compensation value and the down arrow to decrease this value.
       When GravUtil is complete, joycomp will display the current
       compensation value and instruct you to place an 'ultrajoy [#]'
       line in your autoexec.bat file AFTER your set ULTRASND=... line.
      
       For Example:

       ULTRASND=....
       ULTRAJOY 17


2.2.0 SECTION 2.2 - ULTRAJOY.EXE
       ===========
       
       This utility is used to program the joystick speed compensation
       value into your UltraSound's game port.
       To set up the joystick compensation enter 'ultrajoy [0-31]'.
       For example, entering 'ultrajoy 20' will set the speed
       compensation to 20. Faster machines require smaller numbers.
       It may also be necessary to use a different value to correct
       drifting & other control related problems in specific
       games. Try different values until you find that works best.


2.3.0 SECTION 2.3 - ULTRINIT.EXE
       ===========

       This utility is used to set up the software programable
       DMA channels and interrupts. It is HIGHLY recommended that
       you put the following line in your autoexec.bat file AFTER
       the set ULTRASND=.... line:

       For example:
       set ULTRASND=220,1,1,11,5
       c:\ultrasnd\ultrinit.exe

       It may be necessary to specify a full path to ultrinit.exe.

       This will make sure that the card is set up so the MIDI
       can be used with any existing software by making sure the
       software configurable IRQs are programmed. Without this, any
       applications that need MIDI IRQs would not work. The IRQ
       vector that the MIDI uses is the last parameter in the
       ULTRASND environment variable.

       It also resets the card so that any looping sounds will stop.

       Ultrinit.exe has 3 options that can be passed to it.

        1)    -o    Leave output enabled after it resets the card
        2)    -m    Leave microphone input enabled.
        3)    -l    Leave line level input enabled.

       For example:

           Ultrinit -o -m -l

       There is also a version of the initialization program that
       can be run from your config.sys file. Ultrinit.sys just
       initializes the card and then removes itself from RAM.

       This is needed to set up the UltraSound so that some other
       drivers will detect the UltraSound as a SoundBlaster. This
       is necessary because several of the drivers (CD-ROM etc) 
       need to detect the presence of a SoundBlaster or they will 
       not run with sound. Note that this does NOT load the 
       SoundBlaster driver, it only sets up enough so that these
       drivers are happy. Sbosdrv.exe or Sbosdrv.sys and loadsbos
       MUST be run later if you want to hear anything.

2.4.0 SECTION 2.4 - PATCHMGR.EXE
       ===========

       Patch Manager makes loading and auditioning WaveTable samples,
       or 'Patches', easy and fun. You can use 'PatchMan' to load
       UltraSound's memory with the patches you select. These patches
       will then be available for use with your favorite Windows
       music composition or Sequencer software. Some new software already
       includes the Windows MCI commands to load patches from a MIDI file
       much the same way as PatchMan does. Soon, all new Windows MIDI
       music creation / editing software will have this feature built-in.
       Patch Manager will still be useful as a quick and easy way of
       comparing, auditioning, and managing your Patches.

       Program Requirements...

       - Correctly installed Gravis UltraSound card, Windows 3.1
       - The current Windows driver in this disk set.

       Installation Notes....

       * Note - PatchMgr may not work correctly with earlier versions
       of the Windows driver. Use only with the driver supplied on
       this disk set.

       - In Windows, Click on the group you would like Patch Mgr's to
       be installed into, then click on 'New' in the Program Manager's
       'Files' menu. Click on 'Program item'. Fill in the resulting
       dialog box's 'description' and 'Command Line' fields (use the
       'browse' button if you like) and click OK.

       - Run PatchMgr and select 'Quick Tour' in the Help Index menu
       for an overview of operation. Explore the various menu options.

       - The 88 key 'Patch Man' synth keyboard has an octave more keys than
       most synths for future patches that will use the extra range. Note
       that many patches can be played well beyond their intended range.


       - PatchMgr's 'Memory remaining' guage will operate correctly
       no matter what memory configuration your GUS has.

       - An upgrade to 512k or the full 1 meg of RAM on the card is
       recommended if you intend to use your UltraSound card for MIDI
       Music compositions using more complex orchestration.


2.5.0 SECTION 2.5 - UBAT.EXE
       ===========
      
      
       This utility will help you build batch files to run applications
       that require SBOS options.

       For Example:    

       If your application is called game.exe, UBAT will help create 
       a batch file called ugame.bat that will load SBOS with the options 
       needed each time the game is run.
      
       ugame.bat would contain these lines:    

       SBOS -O2
       game.exe


2.6.0 SECTION 2.6 - AUDIO.EXE
       ===========
    
       There are 2 parameters to audio.exe that may need to be adjusted
       to get acceptable playback or recording. The playback and recording
       buffer sizes can be set using the -kp# and -kr# options respectively.
       The parameter specifies the number of K of memory to reserve for
       the appropriate buffer. For example:

       audio -kp40 -kr50

       will reserve 40K for playback and 50k for recording. The defaults
       are 24K for playback and 10K for recording. The buffers are kept
       relatively small so they don't take up to much RAM. The playback
       size is probably OK for most situations. The record buffer is
       probably too small for most situations. You will probably need
       to increase this size if you want to do any substantial recording.
       A buffer size of at least 50K is usually necessary to do a stereo
       recording at 44.1 kHz.

       Note:
       While it is possible to do high speed recordings using
       audio.exe and playdigi.exe, it is not recommended. Since
       these run as TSRs, they do not get the attention from DOS
       that may be required to prevent loss of data. Playfile.exe
       is a dedicated program and should provide better results.

       Note:
       Playfile.exe can record stereo data at ONLY 22050 hertz and
       44100 hertz. playdigi.exe can only record stereo at 44100.


2.7.0 SECTION 2.7 - SETGUS.EXE
       ===========

                2.7.1 Configuration file changes


       Setgus is a utility to help set up the hardware configuration of
       your UtltraSound card. Its purpose is to make it as easy as 
       possible for you to get a dma/irq setting that works in your
       computer.  It also has some diagnostic features built into it
       to help you diagnose a problem before calling tech support.

       SETGUS can be run by typing 

       SETGUS or
       SETUP	

2.7.1 Configuration file changes
 ================================

       Several things are added/changed on your autoexec.bat and
       config.sys files.

       config.sys
       ==========

       device=ultrinit.sys ultrasnd=220,1,1,11,7

       Autoexec.bat
       ============

       set ULTRASND=220,1,1,11,7

       Set the environment variable that all applications should
       look at to get the configuration of the card.

       C:\ULTRASND\ultrinit.exe

       Perform a hardware reset of the card. See above.

       call C:\ULTRASND\sbos.bat

       Load the SoundBlaster Emulator. This is done by
       default. You may remove it if you choose. If so, you
       must re-load it when you want to run a Sound Blaster
       application.

       set ULTRADIR=c:\ULTRASND

       Tells applications where UltraSound root directory is.
       An application can use this to determine where the 
       patches are (C:\ULTRASND\MIDI).

       set BLASTER=A220 I7 D1 T1

       Some applications look at this environment variable to
       determine the Sound Blaster parameters to use. These 
       should reflect the same values as ULTRASND.

       The factory defaults have been set to:
       Base port address ---- 220
       DMA channels --------- 1
       UltraSound IRQ ------- 11
       MIDI IRQ ------------- 7 (*NOTE* this is an update from the manual)



2.8.0 Sound Board Operating System Notes.
 =========================================

                      2.8.1 About SBOS
                      2.8.2 SBOS V2.00
                      2.8.3 SBOS options for specific games
                      2.8.4 SBOS command line options


2.8.1 About SBOS
 --------------

    ================================================================
    UltraSound and SBOS do a very good job of emulating the
    Sound Blaster audio card. However, since it is a software
    solution to a hardware problem, the emulation is not perfect.
    The UltraSound WILL NOT sound EXACTLY like an Ad Lib or a
    Sound Blaster. Very rarely will the results be
    unacceptable. Most commercially available applications,
    including those directly from Creative Labs, will run OK.
    Most 'shareware' type applications will also be OK, but it
    is much more difficult to test them, so there might be a
    higher percentage that do not operate properly. If possible,
    we will attempt to fix any of these problems in future releases
    of the SBOS software. 
    ================================================================

    A few applications do not use Direct Memory Access (DMA) to do their
    digital audio. They may either use polled I/O or the PC's timer
    to do their output timing. Both are VERY taxing on
    the PC and can severely degrade the performance of SBOS. A
    16 MHz 386 or better PC is recommended to get decent performance.
    Applications that were ported from the AMIGA and use the 'modplay'
    method of playing digital audio MIGHT have performance problems.

    Removing any expanded/extended memory drivers (if possible) may
    also improve performance.


2.8.2 SBOS V2.00
 ----------------

                        2.8.2.1 About this new SBOS version...
                        2.8.2.2 A Note on SBOSDRV.SYS...


2.8.2.1 About this new SBOS version...

    This new SBOS V2.00 maintenance update replaces all
    previous version SBOS. Testing on various software confirms 
    improvements in digital sound and fewer configuration 
    difficulties, plus the benefits of a .SYS driver for use 
    with some CD ROM software or memory configurations.

    The new SBOS no longer needs to be executed between each application.

    Example:

	If you run windows and then exit to run a game, SBOS will still
        be loaded and ready to run.
  
    The only acception to this is if a game requires an option.  In 
    this case you must rerun SBOS with the appropriate option.

2.8.2.2 A Note on SBOSDRV.SYS...

    The new sbosdrv.sys driver (V2.00) is loaded from the config.sys file
    and uses the entire ULTRASND environment string as its parameter.

    eg:

    device=sbosdrv.sys ultrasnd=220,7,7,11,7

    where 220 is the base port.
            7 and 7 are the DMA channel (in/out)
            7 is the P.C.M. (MIDI) IRQ
           11 is the GF1 IRQ

    The user should remember to type SBOS at the DOS prompt to re-load the
    driver for any audio to be heard. Make sure this is updated if the 
    settings are changed in setgus.


2.8.3 SBOS options for specific games
 -------------------------------------

                        2.8.3.1 List of games with options
                        2.8.3.2 Vectdemo
                        2.8.3.4 Lemmings
                        2.8.3.5 GX2 (Galactix)
                        2.8.3.6 CD ROM Applications
                        2.8.3.7 Unsupported applications
                        2.8.3.8 New parameters

2.8.3.1 Some games and their options
 ====================================

    There are several applications that require SBOS (Sound Board
    Operating System) to run in a non-default mode to correctly
    emulate other sound boards. This is because these particular
    applications implemented the audio in slightly different ways.
    The vast majority of applications run in the default mode
    perfectly. Here is a list of the known applications that
    require a different option to run correctly.

    NOTE: We have compiled the following list of applications that
          require SBOS options to run.  This list has come from internal 
          testing, Beta sites, and UltraSound users alike.  There is a 
          chance that it is not 100% accurate however, it will give you a 
          good starting point in the event you are having a problem with 
          a Sound Blaster application.

          This list was compiled prior to the release of version 2.00. Your
          results may differ. This is only meant as a possible
          guideline.

SBOS Soundblaster support     Version   Parameters
-------------------------------------------------------------------------------
AV8B Harrier Attack             1.20    -o2
Blaster Master                  1.20    -x3
Comanche: Maximum Overkill      1.20    None (Get Update from Novalogic)
Commander Keen (part 4)         1.22    -x2
Escape from Alcatraz            1.20    -o3
F-117A Stealth Fighter          1.23    -o1
F-15 Strike Eagle II            1.20    -o3
F-15 Strike Eagle III           1.23    -x2
Formula One Grand Prix          1.20    -o2
Front Page Sports Football      1.20    None (voice may echo)
Humans                          1.20    -o3
King's Quest VI                 1.20    -o3 (no speech)
King's Quest VI                 1.22    -o2 -x3
King's Quest VI                 1.23    -x3
Leisure Suit Larry V            1.22    -o2 -x3
Links 386 1.05 or later         1.20    -o1 -x2 (turn off background sounds)
Links 386 1.05 or later         1.22    -x2 (load with golf /s )
PGA Golf                        1.20    -o2
Prince of Persia                1.20    -o1
Quest for Glory III             1.23    -o2 -x2
Rex Nebular                     1.22    -x3
Siege                           1.20    -x3
Strange Deadfellows             1.20    GF1 int = MIDI int
Terminator 2029                 1.23    None (MIDI IRQ must be 7)
Thunder Hawk                    1.20    -x3  
Where in the World is Carmen... 1.20    -o1
Where in the World... DELUXE    1.23    -o1
Wing Commander                  1.20    -o2 -x2  (slow)
Wing Commander                  1.22    -o2 -x2

2.8.3.2 Vectdemo

         Requires that IRQ #2 is used. Make sure that the last parameter
         in ULTRASND is 2. Make sure that BLASTER uses IRQ 2 also.
         This must be done BEFORE sbos is loaded. If
         SBOS is already loaded with an incorrect IRQ, unloadit & re-load
         it with IRQ2. 

         To change to IRQ 2, use SETGUS or directly edit the AUTOEXEC.BAT

         After loading the demo, you MUST go thru the VECTDEMO 
         install. There is an uninitialized pointer that blows SBOS out
         of the water if you do not go thru the install. All you need to do
         is select a type of computer and the go run the demo.


2.8.3.4 Lemmings

        Lemmings - use Lemmings' -x mode when choosing the PC type.


2.8.3.5 GX2 (Galactix)

        Use option -o3. This will only work for the FM stuff. No
        digital audio will work.


2.8.3.6 CD ROM Applications

         - Strange Deadfellows requires the GF1 and MIDI interrupts
           to be the same.  To do this rerun the SETGUS program.


2.8.3.7 Unsupported applications

         This overwrites the SBOS driver and thus will not work with 
         SBOS:

         - JetFighter II

	 These applications have a patch available on the Gravis BBS to 
         fix their problems: 

	 - HUMANS
         - Hare Raising Havoc (Roger Rabbit)


2.8.3.8 New parameters

         -P Turns OFF the "SBOS installed" audio message when loadsbos is
            run.

         -L Leave line level input enabled when SBOS runs. This can be
            useful if you want to hear another input source thru your
            UltraSound.

         -Cxx This allows your to specify a different control vector
            to be specified. Some applications require 7E which is the
            default for sbosdrv & loadsbos. The range is from 7A to 7F.
            The option MUST be used if you use netroom.

        The 'SBOS installed' message can be customized by specifying a
        file to play followed by the playback rate, in the sbos.cfg file.

  

        No drivers from Creative Labs (such as ct-voice.drv) or Ad Lib
        (such as sound.exe) are supplied with the UltraSound card. If
        an application requires any and you do not already have them,
        the application will NOT run. You must obtain them from some
        other source.

        IF an application runs that uses the UltraSound, SBOS will re-load
        its patches as the application exits. This means that you should
        be able to run SoundBlaster compatible programs and real 
        UltraSound applications without having to re-load SBOS.

2.9.0 ULTRAFLI
 ==============

     Documentation clarification on option #8 (two's complement data)
     This parameter tells Ultrafli what type of audio data
     is being used. A '2' in this position says the data is in
     twos complement form. Anything else specifies raw binary.
     The default is set to raw binary.


2.10.0 PLAYMIDI
 ===============

                        2.10.1 PlayMIDI Options
                        2.10.2 PlayMIDI Configuration File
                        2.10.3 PlayMIDI GUI


     The music files and instrument files are copyright of:
     EYE & I Productions and Advanced Gravis Computer Technology Ltd.

     A utility to play MIDI sequences thru UltraSound is also
     provided on the installation disks. Its usage is:


2.10.1 PlayMIDI Options
        --------

     playmidi [options] filename.mid
     options are:
     -c#     Remove midi channel #
     +c#     Add midi channel #
     -t#     Remove track #
     +t#     Add track #
     -h      Display this help message to screen
     -p      Play whatever can fit into memory - ignore errors
     +d#     Increase the delay between midi events
     -d#     Decrease the delay between midi events
     +gs     channel 10 will play from the rhythm-set
     -gs     channel 10 will play from the tone-set
     -ichannel       Ignore channel info and play everything on channel 0
     -iprogram       Ignore program (instrument) changes
     -icontrol       Ignore control changes
     -ipitchbend     Ignore pitch bend information
     -iaftertouch    Ignore after touch information
     -udebug Turn UltraSound debug on
     -v      Display version number
     -v#     Set master volume (0 - 4096)
     -verbose        Verbose: Display text info#
     -debug  Display debugging and text information


2.10.2 PlayMIDI Configuration File
        --------

      Playmidi will look for a configuration file for the sequence called
      filename.cfg. It first looks in your current directory, then in the
      MIDI subdirectory under the place specified in the environment variable
      called ULTRADIR, then thru your specified path.  Playmidi will also
      look for a default configuration file called default.cfg.  If it does
      not find both the .mid AND .cfg files, it will quit.  After it finds them,
      then it will look for the instrument patch files. It uses the same
      search method as above.  Once it finds all the necessary files, it
      parses the config file, downloads the appropriate patches and starts
      the sequence. The .cfg file has different types of lines to aid the midi
      player in playing a file.  A line starting with a '#' is ignored.  A line
      that looks like this:

      channel 10 rythm_set
      or
      channel 10 tone_set

      tells a midi channel to pick instruments from either the tone-set
      or rhythm-set.  The configuration file also has lines of the form:

      [instrument #] [patch name] [% of max volume] [de-tune param]
       :              :              :               :
       :              :              :               :
       :              :              :               :
       :              :              :               :

      There should be one line per instrument. The instrument number is
      defined inside the specific MIDI sequence file (filename.mid).
      Instrument #0 is the default instrument for tone-set that will be used
      if a patch isn't found.  If the correct patch is not found,
      Instrument #129 is the default instrument that will be used for the
      rhythm-set.  Instruments #1-#128 are the tone instruments for
      programs #1-#128.  Instruments #129-256 are the rhythm instruments (drums)
      for program #1-#128.

      The patch name is the file that contains the patch info for that
      particular information. It is recommended that the instrument # be
      mapped to the patch using the general midi set ID numbers. If a
      patch does not exist for that instrument, try & pick one that is
      as close as possible. However, many sequences were not written
      following the general midi set. You must then pick the appropriate
      patch file by trying to figure out what instrument the MIDI file
      was using.  This feature makes it easy to change a piece that was
      written for one instrument to be played on a different one.

      The next parameter is to raise or lower the volume of that
      instrument relative to the others. This is used to quiet down a
      particularly loud instrument (like a percussion) or raise a
      softer instrument. The number is used as a percentage of the
      maximum volume. Therefore a 100 is 'normal' volume. A 50 would
      be half volume, etc. The default setting for this volume parameter
      is 100.  This parameter is optional.

      The next parameter is to 'de-tune' an instrument. This is the # of
      semitones that will be added to each note played. Therefore,
      putting a 12 here would raise the instrument a full octave.
      This parameter is optional.

      Here is an example .cfg file that could be used for the latin dance
      sequence demo.

        1 miracle.pat
        129-256 percs.pat 60
        13 marimba.pat 80
        32 acoustic.pat
        74 woodflut.pat
        66 tenorsax.pat 80
        62 hitbrass.pat 80

2.10.3 PlayMIDI GUI
        --------

    Playmidi now has a graphical interface to it. Just type playmidi<CR>
    to use it.

2.11.0 Playfile
 ===============

    Playfile now has a graphical interface to it. Just type playfile<CR>
    to use it.

    It now can play .wav files. The GUI has a selector. The command line
    has two new switches. -SND for .SND files and -WAV for .WAV files.
    type playfile -? for a complete listing of the option switches.

2.12.0 Convert
 ==============

    Convert will convert .snd files to .wav files.

2.13.0 Grvcolor
 ===============

    This is a utility to set up the colors used in setgus, playfile
    and playmidi. It creates a file called grvcolor.ini.

2.14.0 USS8
 ===========

    This is a digital sound editor.

2.15.0 Ultramod
 ===============

     Ultramod is a mod player that works specifically for the UltraSound.
     It does not use SBOS. Two mods from Accolade's Star Control II are
     also supplied. Check them out to see how good the UltraSound can
     sound for applications written for it. To run it, type:

     ultramod midi\comandr.mod

     Stop the mod playback by hitting any key. The modplayer should
     also playback most other mods you might have.

3.0.0 TECH NOTES
 ================

3.1.0 ULTRASOUND MEMORY MAP
 ===========================

    UltraSound's port locations are spread out through the PC's
    I/O map. Here is a brief map of where they can be found so
    you can find a base port location that will not interfere with
    any other hardware you may have installed.

    200 Joystick   (can be disabled on card)

    The rest of the ports are based off the base port that is set by the
    jumpers on the UltraSound card. The 'X' represents 0-F hexadecimal.

    2X8 - 2XC    - Ad Lib/Sound Blaster
    388,389      - Ad Lib
    3X0 - 3X1    - MIDI interface
    3X2 - 3X7    - GF1
    2X0, 2XD, 2XE  - GF1

    Look for a table like this one in your other peripheral's manual.
    If the figures are the same, you have a conflict you must resolve.


4.0.0 WINDOWS
 =============

                        5.1 ATTENTION Windows Users
                        5.2 Troubleshooting Information


4.1.0 ATTENTION Windows Users

    The Ultrasound driver has been designed to work with Windows 3.1
    in 386 enhanced mode ONLY!

    The install is now done by the install program. If no errors occur
    you should be able to run windows after re-booting after the install.

5.0.0 Troubleshooting Information
 =================================

                        5.1.1 Wrong Port Setup
                        5.1.2 ULTRASND Driver
                        5.1.3 GRVSULTR.386 Missing
                        5.1.4 16 BIT DMA Channels
                        5.1.5 NMI Problems


5.1.1 Wrong Port Setup

    If you select the wrong port during configuration and restart
    Windows, a message, warning you to reconfigure the driver
    appears.  Simply choose Setup from the Drivers Applet in
    the Control Panel, enter the correct base port, and restart
    Windows.

5.1.2 ULTRASND Driver

    If the Ultrasnd.drv file is deleted from the \windows\system
    directory, any application using the driver will issue its
    own error message directing you to install a driver.  Go
    back to the Drivers Applet, and choose Add to reinstall the
    driver, or exit Windows and copy the file from the floppy
    to \windows\system manually.

5.1.3 GRVSULTR.386 Missing

    If the Grvsultr.386 file is deleted from \windows\system,
    a message will appear when you start Windows indicating the
    file is missing. Then, a message box appears stating that
    the Ultrasound card cannot be enabled. The easy way to
    remedy this situation is to exit Windows and copy the
    Grvsultr.386 file from the floppy back into \windows\system.
    Restart Windows and the driver will become active again.

    Using the Control Panel at this point requires a few extra steps:
    Go to the Drivers Applet in the Control Panel, and Remove
    the Ultrasound driver.  A message appears, telling you that
    Windows must be restarted to remove the driver.
    When you restart Windows, the message regarding the missing
    Grvsultr.386 file will still appear.
    Ignore this message, go back to the Drivers Applet, and
    reinstall the Ultrasnd driver, selecting "New" when a message
    indicates that the driver is already on the system.
    A message during the installation, indicating the driver can't
    be enabled, will appear. Continue with the installation, restart
    Windows, and the driver will become active again.

5.1.4 16 BIT DMA Channels

    The default DMA channel has been changed to an 8-bit channel
    because a few (not all) motherboards do not have 16-bit DMA
    channels that operate properly. They may work fine on yours.
    We suggest that you try to run it on a 16-bit channel because
    performance is better. We can transfer data twice as fast.

    The 8-bit channels are 0-3. The 16-bit channels are 4-7.
    If 'flakey' things happen with the 16-bit channel switch back
    to a free 8-bit channel.

    Stereo recording WILL be better on 16 bit channels. If you get
    gaps or popping, try using one of the 16 bit channels.
		       
5.1.5 NMI Problems

    Some computers have their DRAM parity disabled. SBOS will not
    work properly with this. Re-enable the parity check in your
    BIOS setup.


                              THE END


