home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / os2 / mw62.zip / VESA.TXT < prev   
Text File  |  1992-11-18  |  9KB  |  213 lines
  1.  
  2. Logitech Mouse Driver and VESA Super VGA Support
  3.  
  4. Background :
  5. ------------
  6. The VGA Standard which was established by IBM, defines a video architecture 
  7. and video modes.  Many video manufacturers follow this standard and add 
  8. enhancements to it.  As manufacturers refine their video boards, a new set 
  9. of 'above VGA' video resolutions and architecture's have been created. To 
  10. bring these many different video schemes together VESA (Video Electronics 
  11. Standard Association) was formed to give direction to the future of video 
  12. standards for the IBM personal computer.
  13.  
  14. Super VGA is loosely defined as anything above the VGA standard.  This 
  15. includes higher resolutions (e.g. 800 x 600 for VESA mode 100h) and greater 
  16. or equal number of colors (e.g. 256 colors for VESA mode 103h).
  17.  
  18. DOS Mouse Driver:
  19. -----------------
  20. Under DOS, many applications require that the mouse driver draw the mouse 
  21. cursor.  To do this the mouse driver must have knowledge of the underlying 
  22. video architecture and the video mode that is being displayed.  This presents 
  23. problems as video boards surpass the VGA limit.  As video boards become more 
  24. complex the mouse driver must be expanded to handle all situations.
  25. To remedy this both VESA and Logitech have established the Video Cursor 
  26. Interface (VCI) Standard.  This standard outlines the interface between 
  27. an input device, such as a mouse, and a small overlay program that 
  28. contains hardware dependent cursor drawing code.  The interface contains 
  29. initialization, cursor movement and cursor function calls.  The host (or 
  30. mouse in this case) calls the VCI module to perform all cursor functions.  
  31. The host need not have any knowledge of the cursor drawing software/hardware.
  32. The VCI module program can be implemented in one of three forms: 
  33.  
  34. A] overlay program that the host program loads 
  35. B] TSR/device driver program that redirects INT 10h to itself  
  36. C] as a ROM resident code
  37.  
  38. For Logitech Mouse Software the overlay program (LVESA.OVL) is the only 
  39. method used.
  40.  
  41. Other Operating Environments/Systems:
  42. -------------------------------------
  43. Under other operating environments (Windows, GEM) and operating systems 
  44. (OS/2, UNIX) the mouse driver is not required to display the cursor on the 
  45. video screen.  The mouse driver simply acquires button and movement 
  46. information and passes this information to the operating environment/system 
  47. which does the rest of the work.  The VCI does not apply to such operating 
  48. systems/environments.
  49.  
  50. Logitech VCI Compatible Mouse Driver:
  51. -------------------------------------
  52. As outlined above the LVESA.OVL module allows for a separation of the cursor 
  53. drawing code from the input device code.  Additional video modes or hardware 
  54. configurations can be added to the overlay without rewriting a complete mouse 
  55. driver.  Any driver that supports the VCI interface will support the overlay 
  56. module.
  57.  
  58. Starting from the 6.10 release, the Logitech DOS driver is made up of the
  59. three following files:
  60.  
  61.    1) MOUSE.COM           : mouse driver
  62.    2) LMOUSE.INI          : mouse driver configuration file
  63.    3) LVESA.OVL           : video module for the DOS driver
  64.  
  65. MOUSE.COM:
  66. ----------
  67. During initialization MOUSE.COM searches for the LMOUSE.INI initialization 
  68. file.  This text file contains information used for mouse driver 
  69. initialization such as the drive and path of a LVESA.OVL overlay program.  
  70. The mouse driver searches for a LVESA.OVL overlay module, if specified, 
  71. and loads it into memory.  The driver calls the LVESA.OVL initialization 
  72. routine.  If initialization is successful the overlay code is copied into 
  73. the mouse driver.  If initialization fails the mouse driver uses it's default 
  74. video cursor code.
  75.  
  76. The Logitech DOS mouse driver contains cursor enhancements which enhance 
  77. cursor viewing in DOS programs that use the mouse driver's cursor.  
  78. Cursor enhancements are not available when the LVESA.OVL is being 
  79. used.
  80.  
  81. LMOUSE.INI:
  82. -----------
  83. This text file contains initialization information that is used on the 
  84. initial loading of the mouse driver.  The initialization file contains 
  85. information such as the operating mode of the mouse (for left handed 
  86. users) and the drive and path of the LVESA.OVL file.  If no drive or 
  87. path are used, the mouse driver launching drive:directory is assumed.  If 
  88. LMOUSE.INI is not present the mouse driver assumes a right handed mouse 
  89. and uses it's internal video cursor drawing code.  LMOUSE.INI is created 
  90. by the mouse installation program at installation time.
  91.  
  92. The search order for the LMOUSE.INI is as follows:
  93. --------------------------------------------------
  94. 1) A SET statement in the AUTOEXEC.BAT file contains the drive and path 
  95. to the mouse directory (implemented but not currently used by Logitech).
  96.     e.g. SET MOUSE=C:\TEST\MOUSE;
  97. 2) Search the same directory as the mouse driver (DOS Version 3.0 and 
  98. above).
  99. 3) Search the root of the C: disk drive (DOS 2.X and lower).
  100. 4) Search the root of the A: disk drive for floppy drive systems.
  101.  
  102. LMOUSE.INI is used by the DOS mouse driver only.  Later expansions may 
  103. include usage by other mouse drivers (Windows mouse driver). 
  104.  
  105. Currently LMOUSE.INI contain 2 main sections, MOUSE and DISPLAY.  The 
  106. MOUSE section tells the mouse driver if a left handed mouse is attached 
  107. to the driver.  This is used for Logitech software only, it does not 
  108. swap the mouse buttons.
  109.  
  110. [MOUSE]
  111. mode = right (or left)
  112.  
  113. The DISPLAY section gives the drive, path and name of the video overlay 
  114. (drive and path are optional if the overlay is located in the same 
  115. directory as the mouse driver).  If the user wishes to change video 
  116. overlays they must edit this entry to a new drive, path and overlay 
  117. name.  This entry may also contain the reserved word RESIDENT.  RESIDENT 
  118. is used for a TSR or ROM version of the VCI module.
  119.  
  120. [DISPLAY]
  121. VideoModule = DRIVE:\PATH\OVERLAY_NAME.OVL      ;use a separate .OVL 
  122. program
  123.   or
  124. VideoModule = RESIDENT          ;use the resident VCI module
  125.   or
  126. VideoModule =                   ;nothing, use the drivers default cursor
  127.  
  128. LVESA.OVL:
  129. ----------
  130. The Logitech VCI overlay program that contains video cursor support for 
  131. CGA, EGA, VGA and VESA Super VGA video modes.  This program is copied 
  132. into the mouse driver at initialization and becomes part of the resident 
  133. mouse driver.
  134.  
  135. MOUSE.SYS:
  136. ----------
  137. Because of DOS system constraints the device driver version of the mouse 
  138. driver (MOUSE.SYS) does not have the ability to read the LMOUSE.INI file 
  139. or load the LVESA.OVL file.  This may change in future releases.
  140.  
  141. DOS Driver Cursor Enhancements:
  142. -------------------------------
  143. As mentioned above the Logitech DOS mouse driver cursor enhancements are 
  144. not available with the LVESA.OVL.  Using the cursor enhancements will 
  145. disable loading the LVESA overlay.
  146. To load the cursor enhancements, use the following command line 
  147. parameters on the first call to the mouse driver:
  148.     CENHANCE
  149.     COFF, CSLOW, CFAST
  150.     LCURSOR, DCURSOR
  151.     TOFF, TON
  152.  
  153.     Example:  MOUSE CENHANCE
  154.  
  155. If the cursor enhancements are not loaded these parameters will not work 
  156. on following calls to the mouse driver.
  157.  
  158. Loading Other VCI Overlays Modules:
  159. -----------------------------------
  160. The VCI standard is very new and currently not used by any other mouse 
  161. makers or video manufactures.  Other video manufactures may adopt it and 
  162. their end users will need to install these new overlay files.  To change 
  163. the overlay file being used the LMOUSE.INI file will need to be edited 
  164. as follows:
  165.  
  166.     [DISPLAY]
  167.     VideoModule = DRIVE:PATH\NEW_OVL.OVL
  168.  
  169. where NEW_OVL is the name of the new users overlay program.  The 
  170. DRIVE:PATH are needed if the overlay is not located in the mouse drivers 
  171. directory.
  172.  
  173. ROM Resident Overlay or TSR's:
  174. ------------------------------
  175. Some video manufactures may  put their video overlay code in ROM BIOS or 
  176. in a TSR (Terminate and Stay Resident) program.  The video manufacturer 
  177. should provide information to the user about this.  To enable the mouse 
  178. driver to search for a BIOS VCI implementation or TSR the LMOUSE.INI 
  179. should be edited as follows:
  180.   
  181.     [DISPLAY]
  182.     VideoModule = RESIDENT
  183.  
  184. This line tells the mouse driver to search for the video overlay that is 
  185. already present in memory.
  186.  
  187. Disabling LVESA.OVL Loading:
  188. ----------------------------
  189. Two methods are used to disable the usage of the LVESA.OVL overlay:
  190. 1) Alter the 'VideoModule' string in the LMOUSE.INI file.  This is done 
  191. by:
  192. a) removing the overlay file name from the string:
  193.  
  194.         VideoModule = LVESA.OVL         ;current setting
  195.  
  196. change to
  197.  
  198.         VideoModule =                   ;nothing
  199.  
  200. b) commenting out the entire VideoModule line:
  201.  
  202. ; VideoModule = LVESA.OVL
  203.  
  204. Note:  This will cause an error to be displayed during the mouse driver 
  205. initialization.  This error will have no effect on the mouse drivers 
  206. loading.
  207.  
  208. 2) Use the 'NOVCI' parameter on the first call to the DOS mouse driver:
  209.  
  210.     MOUSE NOVCI
  211.  
  212. This forces the mouse driver to use it's internal video code.
  213.