home *** CD-ROM | disk | FTP | other *** search
/ PC Gamer 9 / 1995-08_Disc_9.iso / l3d / sound / drivers / ultramid.txt < prev   
Text File  |  1993-11-18  |  30KB  |  660 lines
  1.  
  2.                                            A d v a n c e d
  3.                    ▄▄▄▄  ▄▄▄▄▄    ▄▄▄▄  ▄▄    ▄▄ ▄  ▄▄▄▄▄
  4.                   ▐  ▄▄  ▐    ▌  ▐█  █▌ ▐█    █▌ █ ▐▄▄▄▄▄
  5.                   ▐    ▌ ▐▀▀█▀  ▐█    █▌ ▐█  █▌  █       ▌
  6.                    ▀▀▀▀  ▀   ▀  ▀      ▀  ▀▀▀▀   ▀  ▀▀▀▀▀
  7.                   Advanced Gravis Computer Technology Ltd.
  8. 
  9.       Fax (604) 431-5155                   BBS  (604) 431-5927 V32bis
  10.       Compuserve: GO PCVENB (71333,350)    InterNET EMail: tech@gravis.com
  11.       FidoNET: 1:153/978                   SBCNET: 13:900/3
  12.  
  13.                    UltraMID TSR V1.04 (UMID104.ZIP)
  14.  
  15.                        1.0 About these Drivers
  16.                        2.0 Installation
  17.                        3.0 Who Supports
  18.                        4.0 Revision history and Packing List
  19.                        5.0 Troubleshooting
  20.                        6.0 Note for Developers
  21.  
  22.                  DEVELOPERS: read the developr.txt file
  23.  
  24. 1.0.0 *************** CHAPTER 1. - ABOUT THESE DRIVERS *******************
  25.  
  26. 1.1.0 What is UltraMID
  27.        ================
  28.  
  29.  The Advanced Gravis UltraSound card is a unique sound card in the
  30.  sound card industry.  It is the only audio product for the PC that can
  31.  produce realistic sounding instruments without requiring an expensive
  32.  digital signal processor.  Digital signal processors (DSPs) are
  33.  relatively expensive microprocessors that are designed specifically
  34.  for working with audio and visual data.  UltraMID is a software version
  35.  of a DSP.  It provides an extremely easy way for software developers to
  36.  write software for the UltraSound card.
  37.  
  38. 1.2.0 What does UltraMID do for me
  39.        ============================
  40.  
  41.  Most of the new games that are released that support the UltraSound
  42.  card will use UltraMID for midi music and digital synthesis.  There
  43.  are titles being released from almost 100% of the major game comapanies
  44.  that use UltraMID.  Each of these games will ship with its own version
  45.  of UltraMID.  However many games that are already out on the market
  46.  can be adapted to use UltraMID.  Any games that uses the "Audio Interface
  47.  Libraries" from Miles Design, Inc., (AIL), or DIGPAK from The Audio
  48.  Solution, can use UltraMID.  AIL and DIGPAK drivers have been included
  49.  with UltraMID so that you can get older software to work with the
  50.  UltraSound card.
  51.  
  52. 1.3.0 Audio Interface Libraries (AIL) - MIDPAK/DIGPAK
  53.        ===============================================
  54.  
  55.  The Audio Interface Libraries (AIL), (we know them as "Miles" Drivers)
  56.  and DIGPAK are a set of interface drivers which enable software
  57.  developers (mainly game developers) to integrate sound capabilities
  58.  into their programs.  Once a developer has integrated his program into
  59.  the AIL drivers the application will work with all sound cards on the
  60.  market who provide AIL drivers. The AIL's provide support for MIDI as
  61.  well as the Digital Sound interface of an audio card. These library
  62.  drivers allow the developers to use UltraSound's wavetable synthesizer
  63.  and allow them to utilize the UltraSound's digital interface to play 8
  64.  or 16 bit audio in either mono or stereo mode.
  65.  
  66.  Advanced Gravis & FORTE have recently designed and released to Miles
  67.  Design and The Audio Solution Inc. the AIL and DIGPAK routines for the
  68.  UltraSound card which provide the mechanism for developers to easily
  69.  integrate with, and use UltraSound's features.  Developers who have
  70.  the AIL's and/or DIGPAK can get the driver updates and integrate
  71.  their programs into the UltraSound.  The AIL/DIGPAK updates will also
  72.  be available through the Advanced Gravis BBS or any of our nodes.  
  73.  Please refer to GRAVNODE.TXT for a complete list. Developers who do
  74.  not have the AILs can get them from Miles Design and/or DIGPAK from
  75.  The Audio Solution Inc.
  76.  
  77.  Developers who want to take full advantage of UltraSound's advanced
  78.  features; and do not want to pay either Miles Design or The Audio
  79.  Solution Inc. license fees, Advanced Gravis and FORTE have a stand
  80.  alone driver as well.  These drivers use a Terminate and Stay
  81.  Resident (TSR) utility called UltraMID.  Developers utilizing this
  82.  TSR are able to do digital playback at 8 or 16 bits up to 44.1kHz
  83.  sample rate.  Also, this allows programmers to use all of the
  84.  UltraSound's 32 digital voices as well as the superior wavetable
  85.  synthesizer.
  86.  
  87.  These drivers are another level of support for the UltraSound card
  88.  developers.  Both the AIL and DIGPAK interfaces provide a means
  89.  for programmers to easily design software for many sound cards using
  90.  only one API while Advanced Gravis/FORTE's stand alone TSR allows
  91.  developers to take advantage of UltraSound's more advanced features.
  92.  
  93.       ....................... END of Chapter 1 ...........................
  94.  
  95. 2.0.0 ****************** CHAPTER 2. - INSTALLATION ***********************
  96.  
  97.  If you are reading this you have probably already unzipped
  98.  all the files into a directory.  Once this is done type "UMINSTALL".
  99.  This program will copy ULTRAMID.INI to your ULTRASND\MIDI directory,
  100.  and ULTRAMID.EXE to your ULTRASND directory.  It does this by
  101.  looking for your ULTRADIR environment variable.  It will also verify
  102.  all of your patches to make sure that they are compatible with UltraMID.
  103.  
  104.  Once the install is completed, you can start ultramid by simply
  105.  typing "ultramid" at the DOS prompt.
  106.  
  107. 2.0.1 installing the AIL, or DIGPAK drivers.
  108.  
  109.  If you have a game that uses the AIL or DIGPAK drivers and you
  110.  would like to get that game to use UltraMID, read this section.
  111.  
  112.  Now for the tough part. First, find a game that uses the AIL or
  113.  DIGPAK/MIDPAK drivers.  A partial list is provided at the end of
  114.  this README.  To determine if a game uses the AIL drivers look for
  115.  files that end with ".ADV".
  116.  
  117.  FIRST, you should make a backup of the games current .ADV drivers,
  118.  just in case something happens.  What we will now do is overwrite 
  119.  some of these files with the Gravis drivers.  
  120.  
  121.  A table is provided below with some guidelines on which files you
  122.  should overwrite:
  123.  
  124.          COPY FROM      COPY TO      CONFIGURE THE GAME AS
  125.          =================================================
  126.          GF1MIDI.ADV    MT32MPU.ADV  Roland
  127.          GF1DIGI.ADV    SBDIG.ADV    Sound Blaster
  128.              OR
  129.          GF1MIDI.ADV    SBFM.ADV     Sound Blaster
  130.          GF1DIGI.ADV    SBDIG.ADV
  131.              OR
  132.          GF1MIDI.ADV    MT32MPU.ADV  Roland
  133.          GF166.COM      SBLASTER.COM Sound Blaster (DIGPAK)
  134.  
  135.  By looking at the names and size of the .ADV drivers you should be able
  136.  to determine which cards they are for.  For example:
  137.  
  138.     ADLIB    ADV     14693 07-07-92   6:00a  = Adlib
  139.     ADLIBG   ADV     16175 07-07-92   6:00a  = Adlib Gold
  140.     ARIAXMID ADV     44836 03-26-93  10:26a  = Aria
  141.     MT32MPU  ADV     10590 03-16-92  12:00p  = Roland
  142.     MULTISND ADV      7042 03-09-93  12:51p  = Turtle Beach
  143.     PASFM    ADV     15160 07-07-92   6:00a  = Pro Audio Spectrum
  144.     PCSPKR   ADV      8306 03-16-92  12:00p  = PC Speaker
  145.     SBFM     ADV     14743 07-07-92   6:00a  = Sound Blaster
  146.     SBP1FM   ADV     15153 07-07-92   6:00a  = Sound Blaster Pro
  147.     GF1DIGI  ADV      5248 08-14-93   3:49p  = UltraSound Digital
  148.     GF1MIDI  ADV     10816 08-14-93   3:50p  = UltraSound MIDI
  149.  
  150.  In general if any .ADV file is > 10K it is the music driver and should
  151.  be copied over with GF1MIDI.ADV.  If any .ADV file is < 10K it is the
  152.  digital audio driver and should be replaced with GF1DIGI.ADV
  153.  
  154.  Once this is done simply run the games setup and select whatever
  155.  sound card that you just over wrote with the Gravis drivers.
  156.  For example, if you copied over top of the Sound Blaster and Roland
  157.  drivers then you would configure the game for sound blaster roland.
  158.  
  159.  That is it.  If everything is working correctly you should now be
  160.  getting UltraSound support in that game.  If not please refer
  161.  to the trouble shooting section in chapter 5.
  162.  
  163.  
  164. 2.1.0 Hints and Tricks
  165.        ================
  166.  
  167.  - In theory you could copy over top of ANY of the .ADV drivers as
  168.    long as you know which sound card to configure the game for.
  169.  
  170.  - Some programs do not use the regular naming convention for .ADV
  171.    drivers, for instance Ultima Underworld II by Origin.  The
  172.    convention for UW2 is DM*.ADV, and DD*.ADV.  The DM is for
  173.    MIDI and the DD is for digital audio.  Since we can't tell by
  174.    looking at the file name which sound card these drivers are for
  175.    you may just want to copy GF1DIGI.ADV overtop of ALL DD*.ADV
  176.    files and GF1MIDI.ADV overtop of all DM*.ADV drivers.
  177.  
  178.   REMEMBER TO BACKUP YOUR ORIGINAL .ADV DRIVERS
  179.  
  180.  - In theory, a game should be looking in its sound driver directory
  181.    for any files with a .ADV extention, then present the user with a
  182.    list of the sound card drivers found.  For instance, in Spell
  183.    Caster 2000 you simply have to copy the GF1*.ADV drivers into
  184.    its directory.  It will then detect these drivers and you may choose
  185.    ULTRASOUND from its setup menu. This is the only game so far that
  186.    I've been able to find which does this.
  187.  
  188.  - (06/22) Origin uses a slightly modified version of the AIL drivers.
  189.    As such their games may sound slightly off or not work at all with
  190.    our drivers. An example of this is Strike Commander, which will not
  191.    work at all with the standard AIL interface.
  192.  
  193.  - We have found some games that use both the AIL drivers and access the
  194.    sound hardware directly.  An example of this type of game is EYE OF
  195.    THE BEHOLDER.  Since these type of games do not rely soly on the AIL
  196.    drivers and try to access the hardeware directly they may not work
  197.    with these drivers.
  198.  
  199.  
  200. 2.2.0 Command Line Switchs
  201.        ====================
  202.  
  203.  ULTRAMID by default will try to preload patches for all MIDI songs.
  204.  This will give you the best quality sound but may not be compatible
  205.  with all games.  If you start ULTRAMID but can't get the game to
  206.  make any music, try reloading ULTRAMID with the -C parameter.
  207.  
  208.  e.g. lh ultramid -c -m100 -nultramid.ini -dc:\game\
  209.  
  210.  The above example will load UltraMID high, preload a patch library, sets
  211.  the master volume at 100, looks for an .INI file named Ultramid.ini and
  212.  tells UltraMID to look in the C:\game directory for the configuration
  213.  file.
  214.  
  215.  -C    - Preloads a 256K, 512K 768K or 1024K patch library, depending
  216.      on how much memory you have on your UltraSound card. UltraMID 
  217.      automatically detects how much memory is on your card.  This
  218.      option does not sound as good as patch cacheing but should
  219.      work with all games.
  220.  -F    - Unload ULTRAMID from memory
  221.  -Mxxx - [1-127] Sets the master volume for music.  In some games the
  222.      music may over power the speech.  If so you can use this
  223.      switch to adjust the master volume as required. The default
  224.      volume is 127.
  225.  -Nfilename
  226.        - Tell UltraMID not to use ultramid.ini, but look for an
  227.      initialization file named "filename"
  228.  -Dpath
  229.        - Use an alternate path for finding the ultramid configuration
  230.      file and for finding patches. The path should include a
  231.      trailing backslash (e.g.) -Dc:\game\
  232.  -q    - quiet.  Don't display any messages.
  233.  
  234.  
  235. 2.3.0 Limitations of AIL and DIGPAK
  236.        =======================
  237.  
  238.  The Audio Interface Libraries and DIGPAK each only give access to
  239.  ONE STEREO digital channel.  Since the UltraSound is capable of 32
  240.  independent digital channels this poses quite a limitation.  The
  241.  file UMDOC.ZIP on the Advanced Gravis BBS has detailed technical
  242.  documentation on how to write programs that use UltraMID.  UltraMID will
  243.  let you play multiple simultaneous digital audio tracks as well as
  244.  general midi music.
  245.  
  246.  
  247. 2.4.0 Support
  248.        =======
  249.  
  250.  These AIL, MIDPAK/DIGPAK drivers are intended for developers who
  251.  will be releasing future programs that use the AIL drivers.  We
  252.  are releasing these to the general public so that you may attempt
  253.  to patch older games to include direct UltraSound support.
  254.  
  255.  Since this is our first public release of these drivers we have
  256.  provided a file called FEEDBACK.TXT, which you may fill out and send
  257.  back to us with your comments.  For example, how did you get it to
  258.  work with game 'XYZ'.  Tips you may have for others, etc...
  259.  
  260.  
  261. 2.6.0 General Information
  262.        ===================
  263.  
  264.  - We currently support V3.2 of the DIGPAK standard.
  265.  
  266.  - We currently support V2.0 of the AIL standard.
  267.  
  268.  - You may have heard the names 'John Miles' and 'John Ratcliff' and
  269.    wondered who they are.  John Miles is Miles Design, the designer and
  270.    creator of the Audio Interface Libraries.  John Ratcliff is The
  271.    Audio Solution (MIDPAK/DIGPAK). They are two seperate companies who
  272.    work together towards the same goal.  A standard interface for
  273.    sound cards.
  274.  
  275.  - Documentation on how to program directly for ULTRAMID will be made
  276.    available in the future by Forte and Advanced Gravis.
  277.  
  278.  - If you are interested in AIL or MIDPAK/DIGPAK you may contact Audio
  279.    Solutions at any of the numbers provided later on in this README.
  280.  
  281.  - ULTRAMID will look for your ULTRADIR environment variable to locate
  282.    your MIDI directory.  ULTRAMID.INI must reside in your MIDI directory.
  283.  
  284.  - Tech NOTE: Developers: Please use a multiple of 32 bytes for sound
  285.    buffers.  The Gravis UltraSound card can only DMA to 32 byte
  286.    boundaries; so to reduce UltraMID overhead, a multiple of
  287.    32 bytes will mean no polled I/O.
  288.  
  289.  - (06/22) Sierra and Lucas do NOT use either the AIL drivers or DIGPAK.
  290.    Sierra has drivers available for their general midi games that use
  291.    UltraMID.
  292.  
  293.  - (06/22) If possible try copying overtop of the SCC1 or general midi
  294.    drivers.  As some games will load up a different (usually better)
  295.    music score.  An example of this is the 7th Guest.
  296.  
  297.  
  298.       ....................... END of Chapter 2 ...........................
  299.  
  300. 3.0.0 ****************** CHAPTER 3. - WHO SUPPORTS ***********************
  301.  
  302. 3.1.0 The Audio Solution
  303.        ==================
  304.  
  305.  The following is a list obtained from the Audio Solution BBS
  306.  (PRODUCTS.LST). It is a little out of date but does include some
  307.  information on which game publishers are licensed to use
  308.  these drivers.
  309.  
  310.              THE AUDIO SOLUTION
  311.              P.O. Box 11688
  312.              Clayton, MO 63104
  313.  
  314.      Order/Information: (314)-567-0267 9am-5pm Central Mon-Fri
  315.      Technical Support: (314)-926-0232 9am-5pm Central Mon-Fri
  316.      BBS:               (314)-939-0200 24 hours 7 days.
  317.  
  318.  
  319.              MILES DESIGN, INC.
  320.              6702 Cat Creek Trail
  321.              Austin, TX, 78731
  322.      (512) 345-2642 / FAX (512) 338-9630 / BBS (512) 454-9990
  323.  
  324.  
  325.          DIGPAK/MIDPAK COMPLETE PRODUCT LIST
  326.                (as of 1/3/93)
  327.  
  328.      This list does not reflect all products produced by product line
  329.      licensees; since we are not always informed of those products as
  330.      they are released.  It also does not reflect the products in
  331.      development (over 100) which use either DigPak and MidPak.
  332.  
  333. Product Name            Publisher                    Use
  334. ===========================================================================
  335. <unamed>                Epyx                         DigPak+MidPak
  336. ATC/Tracon              Wesson International         DigPak
  337. Animal Quest            Alive Software               DigPak+MidPak
  338. Battle Chess 4000       Interplay                    DigPak
  339. Battle Cruiser 3000AD   Three-Sixty Pacific          DigPak
  340. Beyond Shadowgate       ICOM Simulations             DigPak+MidPak
  341. Bilou                   Concepteva                   DigPak
  342. BodyLink                Stragem                      DigPak
  343. Chess Maniac 5,000,001  Spectrum Holobyte            DigPak+AIL
  344. Chessmaster 3000        The Software Toolworks       DigPak
  345. Contraption ZAck        Presage Software Co. Inc.    DigPak+MidPak
  346. Creepers                Destiny Software             DigPak+MidPak
  347. Cribbage Master         Ninga                        DigPak
  348. Cyberstrike             Simutronics                  DigPak
  349. DNA Parrot              T&t Research                 DigPak
  350. Dinosaur Adventure      Knowledge Adventure          DigPak
  351. Fun Univ Ntwk Intfc     Fun Univ Netwk               DigPak+MidPak
  352. Gateway to the Savage   Strategic Simulations Inc.   DigPak
  353. Gateworld Trilogy       Home Brew Software           MidPak
  354. GemStone III            Simutronics                  DigPak
  355. Grandmaster Chess       IntraCorp                    DigPak+MidPak
  356. Guardians of Eden       Access Software              MidPak
  357. Guzzle Puzzles          Redwood Games                DigPak
  358. Inspector Gadget:       Azeroth Publishing           DigPak+MidPak
  359. KidDesk                 Edmark Corporation           DigPak
  360. Layout for DOS          Objects, Inc                 DigPak+MidPak
  361. Le Ponctueur            C.R.A.P.O., Inc.             DigPak
  362. Magic Crayon            Alive Software               DigPak+MidPak
  363. Marvin The Moose        Milliken Publishing          DigPak
  364. Math Sequences          Milliken Publishing          DigPak
  365. Math Zone               Milliken Publishing          DigPak
  366. Mechwarrior II          Activision                   DigPak
  367. MicroLeague Baseball IV Microleague Sports Assoc.    DigPak+MidPak
  368. MicroLeague Football II Microleauge Sports Assoc.    DigPak+MidPak
  369. Microleage Cards        Microleage Sports Assoc.     DigPak
  370. Millie's Math House     Edmark Corpoartion           DigPak
  371. Milliken Storyteller    Milliken Publishing          DigPak
  372. Monopoly Deluxe         Virgin Games                 DigPak+MidPak
  373. Mutanoid Math Challenge Legacy Software              DigPak+MidPak
  374. Mutanoid Word Challenge Legacy Software              DigPak+MidPak
  375. My Paint                Saddleback Graphics          DigPak
  376. Oregon Trail Deluxe     MECC                         DigPak+MidPak
  377. Pickle Wars             Redwood Games                DigPak+MidPak
  378. Places to Play          Magnetic Images              DigPak
  379. Pools of Darkness       Strategic Simulations Inc.   DigPak
  380. Ragarok (Valhalla)      Norsehelm Productions        DigPak
  381. Realms of Avarton       Kram                         DigPak
  382. Return to Zork          Activision                   DigPak
  383. Shadow President        DC True                      DigPak
  384. Sights & Sounds         Macmillan/McGraw Hill        DigPak
  385. Solitaire's Journey     Quantum Quality Productions  DigPak+MidPak
  386. Space Adventure         Knowledge Adventure          DigPak
  387. Space Chase 1,2,3       Safari Software              MidPak
  388. Spaceward Ho PC         Presage Software Co. Inc.    DigPak+MidPak
  389. Stepping Stones Bonus   Compu-Teach, Inc.            DigPak+MidPak
  390. Stickybear Townbuilder  Optimum Resource             DigPak
  391. Switch Progressions     Cooper, R.J. & Assoc.        DigPak+MidPak
  392. Switch Quik             Cooper, R.J. & Assoc.        DigPak+MidPak
  393. T-Zero                  Dennis Cunningham            DigPak+MidPak
  394. Terminator 2029         Bethesda Softworks           DigPak
  395. The 7th Guest           Virgin/Trilobyte             DigPak+AIL
  396. Tom Landry Football     Merit Software               DigPak+MidPak
  397. VGA Jigsaw              Alive Software               DigPak+MidPak
  398. Waterford Mental Math   Waterford Institute          DigPak+MidPak
  399. Wheel of Fortune        Gametek                      DigPak+MidPak
  400. WorldAtlas              The Software Toolworks       DigPak+MidPak
  401.  
  402. Product line licensees of DigPak and/or MidPak.  Product line licensees
  403. have the rights to include DigPak and MidPak in any product produced by
  404. their company.
  405.  
  406.           Electronic Arts
  407.           Activision
  408.           Spectrum Holobyte
  409.           The Software Toolworks
  410.           SSI, Strategic Simulations Inc.
  411.           Milliken Publishing Company
  412.           Commodore Computer
  413.           Virgin Games
  414.           Compu-Teach
  415.           Knowledge Adventure
  416.           Gametek
  417.  
  418. Product line licensees to AIL (Mile Design's Audio Interface Library) which
  419. uses the same MIDI drivers as MIDPAK.
  420.  
  421.           Activision
  422.           Strategic Simulations
  423.           Electronic Arts
  424.           Origin Systems
  425.           Spectrum Holobyte
  426.           Virgin-Games
  427.           Knowledge Adventure
  428.           Bethesda Softworks
  429.           Interplay
  430.           Microprose
  431.           Gametek
  432.           Impressions
  433.           Mindscape UK
  434.  
  435.  
  436. 3.2.0 Other Products Found to use these Drivers
  437.        =========================================
  438.  
  439.   Great Naval Battles
  440.   Tony La Rusa Baseball II
  441.   War of Two Worlds
  442.   Spell Caster 2000
  443.   Trump Castle III
  444.   Buzz Aldrin's Race To Space
  445.   Clash of Steel - World War II Europe 1939-45
  446.   SimCity Classic
  447.   SimFarm
  448.   Dark Sun
  449.   Kids Zoo
  450.   SSN Sea Wolf
  451.  
  452.       ....................... END of Chapter 3 ...........................
  453.  
  454. 4.0.0 *************** CHAPTER 4. - ABOUT THIS UPDATE *******************
  455.  
  456. 4.1.0 Revision History
  457.        ================
  458.  
  459.  V1.03  - (09/15/93) MIDI in support for sequencers added
  460.  V1.02a  - (09/02/93) Digital Audio improved
  461.  V1.02  - (09/01/93) All notes off midi message fixed
  462.  V1.01  - (08/31/93) This UltraMID offers much faster patch loading than
  463.              the previous version, and is about 3K smaller.
  464.              It also can load almost twice as many patches as
  465.              it used to in the same amount of PC memory.  (You
  466.              are still bound by the size of your UltraSound card
  467.              however.)
  468.  
  469.              This release also fixes several small bugs.
  470.              1) DMA bug while loading patches.
  471.              2) ULTRAMID.INI problems.
  472.              3) Noises during patch loading.
  473.  
  474.              New Features:
  475.              1) Automatically removes SBOS.
  476.              2) Can split up its code and data so that if you
  477.                 have fragmented upper memory or not enough
  478.                 upper memory, UltraMID can still load a
  479.                 portion of itself high.
  480.  
  481.              PS: REMEMBER TO RUN the UMINSTAL.EXE program.
  482.  V1.0   - (06/25/93) Yes, a version 1.0 release
  483.  V0.97B - (06/22/93) Fifth Beta - Fixed DMA bug.
  484.               Fixed patch loading bug.
  485.               Fixed xmidi multi-sequence bug.
  486.               Fixed digital hang bug.
  487.               Fixed problem with 512K patch library
  488.  V0.96B - (06/17/93) Fourth Beta - Fix DIGPAK buffering
  489.  
  490. 4.2.0 Packing List
  491.        ============
  492.  
  493.  ULTRAMID.EXE     AIL TSR - Required for drivers
  494.  GF1MIDI.ADV      UltraSound MIDI AIL Driver
  495.  GF1DIGI.ADV      UltraSound Digital Audio AIL Driver
  496.  GF166.COM        UltraSound DIGPAK Driver
  497.  UM200.INI        Patch Map for 2.00 - 2.05 UltraSound software releases
  498.  UM206.INI        Patch Map for 2.06 UltraSound software releases
  499.  UM206a.INI       Patch Map for 2.06 UltraSound software releases
  500.  
  501.  README           This README file
  502.  GV.EXE           Gravis Document Viewer
  503.  INSTAL.EXE       Installs the correct .INI file and UltraMID.EXE in your
  504.           ULTRASND directory.
  505.  FEEDBACK.TXT     Beta Test Feedback Form
  506.  GRAVNODE.TXT     List of Gravis BBS Nodes
  507.  SDKORDER.TXT     Gravis SDK Order form
  508.  PUPDATE.EXE      Used to fix .PAT files if necessary. READ Troubleshooting
  509.  DEVELOPR.TXT     Note to Developers
  510.  
  511.       ....................... END of Chapter 4 ...........................
  512.  
  513. 5.0.0 *************** CHAPTER 5. - TROUBLESHOOTING ***********************
  514.  
  515.  I copied the drivers on top of other drivers, but now the game says that
  516.  it can't find the sound card:
  517.  
  518.      1) Most games require running a set-up program to tell it that you
  519.     have changed sound cards.  Try finding such a program and running
  520.     it.  It most likely will not show Gravis or Ultrasound in the list
  521.     of available drivers, so you will have to pick the sound cards which
  522.     you copied the AIL or DIGPAK drivers to.
  523.      2) Some games use modified AIL or DIGPAK drivers.  Most of the games
  524.     from Origin have been modified and therefore are not compatible with
  525.     these drivers.
  526.      3) Some games only use the AIL or DIGPAK drivers for certain
  527.     operations. For the rest of them operations it may try to access
  528.     the sound hardware directly.  These type of games will not work
  529.     with UltraMID and our AIL/DIGPAK drivers.
  530.  
  531.  I have sucuessfully installed the drivers for a game, but sometimes the
  532.  music seems strange, as if its missing notes, or completely quiet:
  533.  
  534.      1) Restart UltraMID with the -c option to preload instruments.  Most
  535.     music will take more than 256K of memory. 768K to 1Mb is the
  536.     optimal setup for the UltraSound card. (.e.g.)
  537.         C> ultramid -f
  538.         C> lh ultramid -c
  539.      2) If you have replaced any of your patches with non-Gravis patches,
  540.     the size may be different. The patch sets in ULTRAMID.INI are
  541.     configured so that your UltraSound card will be loaded with as
  542.     many patches as will fit into its available memory. Leaving 8K
  543.     for digital audio.  This means, if you try and load a patch
  544.     that is 4K bigger than the original, than there will only be a
  545.     4K buffer left instead of an 8K, and the drivers may not be
  546.     able to load correctly.
  547.      3) Your patches may be out of date.  A program called pupdate.exe is
  548.     available which will repair old or bad patches.  doo.pat is an
  549.     example.  run pudate like this:
  550.  
  551.        pupdate -check_patch -force_update *.pat
  552.  
  553.     in your ultrasnd\midi directory.  Pupdate will show you incorrect
  554.     patches and ask if it should update them.  Answer yes to all of
  555.     your patches EXCEPT BLANK.PAT.  BLANK.PAT is meant to be silent
  556.     and should not be corrected.  Pupdate will also create backups of
  557.     all of your patches as it modifies them.  acpiano.pat will become
  558.     acpiano.pa1.  acpiano.pa1 will become acpiano.pa2, etc.  The
  559.     install program uminstal.exe will check all of your patches during
  560.     the install.
  561.     
  562.  Playback of digital audio sounds choppy.
  563.      1) Your disk or CD may be too slow, and the sound card plays sound faster
  564.     then your disk can retrieve data.
  565.      2) The UltraSound cannot play interleaved stereo data, and must use
  566.     your pc to seperate the left and right channel data before playback.
  567.     Slower 286 or 386 machines may not be able to keep up with high
  568.     speed, high fidelity audio.
  569.      3) The game is using audio buffers which are too small for
  570.     the UltraSound to effectively "double buffer" the data.  The
  571.     technique called "double buffering" provides clear sound without
  572.     clicks or pauses in audio, and smooth animations in video.
  573.     Optimal data sizes for UltraMID are multiples of 2K for stereo
  574.     data and multiples of 4K for mono data.  Some audio cards that
  575.     uses the DMA hardware for playback may call this technique
  576.     backfill DMA.  The UltraSound only uses the DMA hardware for data
  577.     transfers; the GF1 actually produces the sound.
  578.  
  579.  When I run ULTRAMID I get a 'error loading patch' message.
  580.      1) You must be running the patches that came with the V2.x software.
  581.     This includes V2.0, and the latest V2.06 disk sets.
  582.      2) A patch may either be missing or corrupt. If you are unable to
  583.     determine which one simply reinstall the patches.
  584.  
  585.  The games says that it can't run because there is not enough memory.
  586.      1) If you are using an Expanded Memory Manager (emm386, qemm, bluemax,
  587.     386max, etc) you can load the driver into high memory to provide
  588.     more conventional memory for your game.  If you Expanded Memory
  589.     manager supports the dos LH command, make sure the following
  590.     line is in your config.sys:
  591.         DOS=HIGH,UMB
  592.     If you are using DOS 5 or DOS 6, you can use the LH command to
  593.     load UltraMID into high memory.  For example: LH ultramid -m100 -c
  594.     will load ultramid into high memory, set the master volume to
  595.     100 (out of 127), and preload as many patches as will fit into
  596.     your UltraSound card.  If you are using a memory manager that does
  597.     not support the LH command (386max), then make sure the following
  598.     line is in your config.sys:
  599.         DOS=HIGH
  600.     NOTE: 386MAX uses its own command to load programs into upper
  601.     memory instead of LH.  Try something like the following:
  602.         c:\386max\386load prog=c:\ultrasnd\ultramid.exe
  603.      2) If you cannot use an Expanded Memory Manager but can use an
  604.     extended memory manager (himem.sys), then also include the
  605.     DOS=HIGH line in your config.sys so that DOS will be loaded
  606.     into upper memory.
  607.      3) If you can't fit UltraMID into high memory, try loading other
  608.     drivers or TSR's into high memory using DEVICEHIGH= instead
  609.     of DEVICE= in your config.sys and LH in your autoexec.bat files.
  610.      4) DOS 6 comes with a utility called MEMMAKER that will help you
  611.     optimize the use of memory on your machine.  QEMM comes with
  612.     a utility called optimize to help you optimize your memory.
  613.     BLUEMAX and 386MAX also have programs to help you maximize
  614.     the use of expanded and extended memory.
  615.      5) If there are other drivers in your system that you don't need
  616.     to play the game, try making a floppy disk with just the programs
  617.     you need to get your machine running.  For example,
  618.          FORMAT /s a:
  619.     will format a disk in the "A" drive and copy MS-DOS to it.  Then
  620.     create a minimal config.sys and autoexec.bat such as:
  621.  
  622.     CONFIG.SYS:
  623.      DEVICE=C:\DOS\HIMEM.SYS
  624.      DEVICE=C:\DOS\EMM386.exe ram
  625.      DOS=HIGH,UMB
  626.      SHELL=C:\DOS\COMMAND.COM C:\DOS\ /E:768 /p
  627.      files=20
  628.      buffers=20
  629.      LASTDRIVE = D
  630.  
  631.     AUTOEXEC.BAT:
  632.      PATH C:\DOS;C:\ULTRASND;C:\UTILS
  633.      SET ULTRASND=220,1,1,11,7
  634.      SET ULTRADIR=C:\ULTRASND
  635.      SET BLASTER=A220 I7 D1 T1
  636.      LH C:\MOUSE\MOUSE
  637.      LH ULTRAMID -m100
  638.      rem if you have the memory available, and you are not using
  639.      rem the -c option, Smart Drive improves the performance
  640.      rem for loading patches tremendously.  I have  8Mb on my
  641.      rem machine, so I usually set up a 4Mb disk cache.
  642.      LH C:\DOS\smartdrv /Q 4096 0 c
  643.      rem If you have dos 6.2, use the following smartdrv instead:
  644.      LH C:\DOS\smartdrv /X /Q 4096 0
  645.  
  646.     These examples are for experienced DOS users, and probably won't
  647.     work with your machine without some modification.  Please consult
  648.     your DOS manual or a book that covers memory management to get more
  649.     hints on how to manage PC memory.
  650.  
  651.      6) If you can't get UltraMID to load into high memory and you
  652.     don't need an EMS memory, then load emm386 with the option noems.
  653.     This will give you 64K more room for UltraMID to load.
  654.  
  655.       ....................... END of Chapter 5 ...........................
  656.  
  657.  
  658.                                   THE END
  659.  
  660.