home *** CD-ROM | disk | FTP | other *** search
/ hobbes.nmsu.edu / 2008-06-02_hobbes.nmsu.edu.zip / dos / vgasve11.zip / README.DOC next >
Text File  |  1993-07-06  |  5KB  |  127 lines
  1. VGASAVE - a video mode helper by Scott A. Krotz version 1.00
  2.  
  3. What is VGASAVE?
  4. ----------------
  5. Do you have game programs that dont redraw correctly after switching
  6. away from them?  Do you have game programs that leave the soundblaster
  7. blaring at you after you switch away from them?
  8.  
  9. Then VGASAVE is for you.
  10.  
  11. VGASAVE.EXE is a TSR that takes over the video mode switching for
  12. os/2 on dos sessions that it is installed in.  It does the saving and
  13. restoring of dos session VGA screens, and is especially taylored for
  14. DOS games.  Tricky games like wolf-3d and ultima underworld I and II
  15. should redraw correctly using VGASAVE.EXE.  Under normal os/2 they
  16. often would have corrupted screens, wrong video modes, and sometimes
  17. would even crash upon switching back.
  18.  
  19. Also, VGASAVE has an adlib mode, and a soundblaster pro mode that will
  20. silence the output of an adlib, soundblaster, or soundblaster pro card
  21. upon switching away from a game program.  This stops the annoying "hum"
  22. caused by game programs using sound cards that are switched into the
  23. background.
  24.  
  25. How to use VGASAVE
  26. ------------------
  27.  
  28. To use VGASAVE in a dos session, first you must set "Video_switch_notification"
  29. to ON in the session you will be using VGASAVE.
  30.  
  31. second, set "Video_ondemand_memory" to ON.  OS/2 no longer needs to allocate
  32. a VGA save buffer -- VGASAVE will be doing the VGA saving and restoring for
  33. OS/2.
  34.  
  35. Third, make sure to give the dos session at least 256k of XMS memory. VGASAVE
  36. uses XMS memory to save the VGA screen memory while you are switched away from
  37. the session.  If the program you will be running in the dos session needs 
  38. XMS memory, be sure to give additional XMS memory.
  39.  
  40. Fourth, simply run VGASAVE in the dos session by typing "VGASAVE" in the
  41. dos session, or add it to your OS/2-DOS autoexec.bat file.  Also, you
  42. could create a special autoexec.bat file for games, perhaps called
  43. autogames.bat, by copying your autoexec.bat file to "autogames.bat" and
  44. adding a line in the autogames.bat file to start VGASAVE.  Then change
  45. the "Dos_autoexec" setting to "autogames.bat" in the dos session you want
  46. to use VGASAVE.
  47.  
  48. VGASAVE can be loaded into high memory.
  49.  
  50. Also, "Dos_background_execution" should be set to off.
  51.  
  52. If you have an adlib or soundblaster (or compatible) card, and you want
  53. VGASAVE to turn off the sound from that session when you switch away, start
  54. up VGASAVE with the parameter "adlib".  Ie. VGASAVE adlib
  55.  
  56. If you have a soundblaster pro card, and you want VGASAVE to turn off
  57. sound from that session when you switch away, start up VGASAVE with the
  58. parameter "sbpro".  Ie.  VGASAVE sbpro
  59.  
  60. The sound will be switched back on when you return to the dos session
  61. automatically.
  62.  
  63. Notes on running VGASAVE
  64. ------------------------
  65. VGASAVE will only save the first 256k of VGA memory, so superVGA games will
  66. probably not be saved and restored correctly.  VGASAVE should, however, work
  67. on any program that uses non-superVGA video modes.
  68.  
  69. Make sure that VGASAVE is running and installed correctly before you switch
  70. away from a dos session with "Video_switch_notification" set to ON, or strange
  71. things could happen with the video mode of your display adaptor.
  72.  
  73. VGASAVE requires your session to have at least 256k of XMS memory or it will
  74. not be able to install.  VGASAVE uses 256k of XMS memory to buffer the VGA
  75. screen when switching away from the dos session.
  76.  
  77. VGASAVE should work on OS/2 2.0 or OS/2 2.1.  I have only tested it on
  78. OS/2 2.1 but I see no reason why it shouldnt run on 2.0.  In fact, it
  79. may be very useful on OS/2 2.0 because it doesnt handle video mode
  80. switching as well as OS/2 2.1.
  81.  
  82. VGASAVE can be loaded into high memory, just like any other TSR or dos
  83. device driver.  In fact, this is recommended to preserve conventional memory.
  84.  
  85. How VGASAVE works
  86. -----------------
  87. VGASAVE works by handling the interrupts raised by OS/2 when you turn
  88. "Video_switch_notification" to ON.  When this setting is on, OS/2 calls
  89. an interrupt every time the dos session is switched to the foreground or
  90. background.  VGASAVE catches this interrupt, and does the saving and
  91. restoring of the VGA screen memory in place of OS/2. 
  92.  
  93. VGASAVE disables adlib or soundblaster/soundblaster pro sound by simply
  94. turning the voices off when switching away.  They are re-enabled when
  95. you switch back to the dos session.
  96.  
  97.  
  98. Comments, problems, and etc.
  99. ----------------------------
  100. If you have problems, comments or suggestions for VGASAVE, feel free to
  101. send e-mail to me at krotz@rtsg.mot.com 
  102.  
  103. VGASAVE is basically untested on any other system than mine.  I bear no
  104. responsibility for any problems caused by this program.  It works for me,
  105. and thats about all I can say.  If it doesnt work for you, please send
  106. me e-mail detailing your system setup and Ill try and figure out whats
  107. wrong.  If it works great for you, and you like it, I'd also be happy to
  108. hear that too.
  109.  
  110. VGASAVE is a freely-distributable program.  However, the program must
  111. be distributed along with this documentation file.
  112. VGASAVE is copyright (C) 1993 of Scott A. Krotz
  113.  
  114. Scott A. Krotz
  115. krotz@rtsg.mot.com
  116.  
  117.  
  118.  
  119.  
  120. CHANGELOG
  121. ---------
  122.  
  123. Version 1.10 - Fixed XMS bug and improved adlib/sbpro silencing.
  124.  
  125. Version 1.00 - Initial version released to the net.
  126.  
  127.