home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 10 / mycd10.iso / share / os2 / graficos / matrox / readme.os2 < prev    next >
Encoding:
Text File  |  1995-06-12  |  13.0 KB  |  360 lines
  1. README.OS2                MATROX GRAPHICS INC.                   09-Jun-1995
  2.  
  3.                   The MGA Millennium OS/2 PM Display Driver
  4.                            v 1.00 (build 007)
  5.  
  6. Product Description
  7. -------------------
  8.  
  9. The MGA Millennium OS/2 PM driver supports 8-bit (256 colors), 16-bit (64K 
  10. colors), and 32-bit (16M colors) display modes under OS/2 2.1 and 3.0 (Warp),
  11. in resolutions ranging from 640 x 480 to 1600 x 1200.
  12.  
  13. Driver Installation
  14. -------------------
  15.  
  16. To install the software, follow the procedure below:
  17.  
  18.    1. If you are installing this driver for the first time, have the MGA 
  19.       board installed and boot OS/2. Select VGA as the display driver. 
  20.  
  21.    2. If you downloaded the driver from the Matrox BBS, use the DOS LABEL  
  22.       command to label your floppy as OS2.
  23.  
  24.    3. Using the Command Prompts folder of OS/2, open an OS/2 Window or 
  25.       Full Screen session.
  26.  
  27.    4. Insert the driver disk in a floppy drive (if you are installing from 
  28.       the floppy disk) or insert the CD-ROM in its drive bay.
  29.  
  30.    5. Make the CD-ROM or floppy disk the active drive and type:
  31.  
  32.       "SRCPATH\INSTALL", 
  33.       
  34.       where SRCPATH is the path which contains the MGA PM drivers.
  35.  
  36.       Examples:
  37.  
  38.       A:\INSTALL     (if installing from a diskette with OS/2 only)
  39.       A:\OS2\INSTALL (if installing from diskette with OS/2 and NT)
  40.       D:\OS2\INSTALL (if installing from a CD-ROM)
  41.  
  42.       Note: if you install this driver to a Warp System, you may run
  43.  
  44.       \INSTALL /u
  45.  
  46.       and every thing will be installed without any further input from the
  47.       user (primary, secondary selection, driver selection, and source 
  48.       disk/path selection). 
  49.  
  50.    6. You will see a dialog box in which you can select the Primary Display. 
  51.       Choose "Matrox MGA Millennium Series". You may have to change the source 
  52.       drive if you are not installing from drive A.
  53.  
  54.    7. The installation program will then proceed with the installation.
  55.       When it is complete, you will have to shut down your system in
  56.       order for the MGA driver to take effect.
  57.  
  58. If you are installing this driver for the first time, OS/2 will restart in 
  59. Matrox default MGA resolution (640 x 480 x 256). It is therefore advisable 
  60. to select the desired resolution just BEFORE rebooting, by means of the OS/2
  61. System Setup folder, as explained in the next section.
  62.  
  63. Driver Configuration
  64. --------------------
  65.  
  66. To change the driver mode (resolution or pixel depth), use the
  67. following procedure:
  68.  
  69.    1. Click the right button on the PM desktop background.
  70.  
  71.    2. Select SYSTEM SETUP to open the system setup folder.
  72.  
  73.    3. Double-click on the SYSTEM icon.
  74.    
  75.    4. Select the SCREEN tab and choose the resolution/pixel depth.
  76.  
  77. You will need to reboot the system to see the change take effect.
  78.  
  79. Uninstalling the Driver
  80. -----------------------
  81.  
  82. The Matrox UNINSTAL command file makes use of the OS/2 DSPINSTL.EXE program
  83. to switch the display driver from MGA mode back to VGA mode, as shown in the 
  84. following procedure: 
  85.  
  86.    1. Open an OS/2 Text Window (or Full Screen) session.
  87.  
  88.    2. Enter:  CD \MGA\OS2
  89.  
  90.       UNINSTAL
  91.       or 
  92.       UNINSTAL CLEAN (to also delete the Matrox files from your hard disk)
  93.  
  94.    3. Select Primary Display, then choose the driver you require (for
  95.       example, VGA).
  96.  
  97. You will need to reboot the system to see the change take effect.
  98.  
  99. Note: With Warp, there are two additional ways to switch the driver from
  100. MGA mode to VGA mode:
  101.    
  102.   1. You can access a menu by pressing Alt+F1 when the OS/2 logo appears
  103.      in the upper left corner of the screen during the bootup process.
  104.      This menu will allow you to change the driver to VGA by selecting
  105.      the appropriate option.
  106.    
  107.   2. You can also change the driver to VGA by running the following file
  108.      in an OS/2 window or full screen session:
  109.  
  110.               \OS2\INSTALL\RSPDSPI.EXE
  111.  
  112. Monitor Customization
  113. ---------------------
  114.  
  115. The OS/2 Millennium driver supports VESA DDC-1 and DDC-2B compliant monitors. 
  116.  
  117. If your monitor is not detected as DDC compliant, the driver will take the 
  118. "Unknown Monitor" hardcoded timings, which assume that you have a monitor 
  119. supporting all resolutions available on your board, at a 60Hz refresh rate 
  120. (non-interlaced). 
  121.  
  122. If you have a monitor that is capable of refresh rates higher than 60Hz, you 
  123. can perform monitor file customization with the help of the MGAMON program. 
  124. This program creates a file called MGA.INF, which contains the appropriate 
  125. video parameters for your monitor. The MGA.INF file is read by the MGA display 
  126. driver when OS/2 boots.
  127.  
  128. The MGAMON program is located in the \MGA\OS2\ directory. It is a DOS program, 
  129. so it must be run in a DOS session (either windowed or full screen).
  130.  
  131. To run MGAMON, open a DOS session:
  132.  
  133.    1. Enter: CD \MGA\OS2
  134.  
  135.       MGAMON
  136.  
  137.    2. Select a monitor and exit the program.
  138.  
  139. You must shut down OS/2 and reboot your computer for the changes to take
  140. effect.
  141.  
  142. Driver configuration 
  143. --------------------
  144.  
  145. Advanced configuration of the MGA driver can be performed through the
  146. MGACONF.CMD command file, located in the \mga\os2 directory.
  147.  
  148. MGACONF performs the following:
  149.  
  150. 1. Font settings
  151.  
  152.    MGACONF has a switch to change the font settings:
  153.    
  154.    mgaconf f
  155.  
  156.    You will be prompted for the resolution to affect and the parameter to
  157.    change: System Font (desktop menu font), Font Resolution (desktop icon
  158.    font) or Avio Font (font inDOS and OS/2 windows). 
  159.  
  160.    Command line input is also possible, the syntax being:
  161.  
  162.    mgaconf f "resolution" "which_parameter" "parameter_value", where
  163.  
  164.               0-640X480    0-SystemFont      0-Small(100)
  165.               1-800X600                      1-Medium(101)
  166.               2-1024X768                     2-Large(102)
  167.               3-1152X882                     
  168.               4-1280X1024  1-FontResolution  0-96dpi
  169.               5-1600X1200                    1-120dpi
  170.  
  171.                            2-AvioFont        0-8x8
  172.                                              1-10x6
  173.                                              2-10x8
  174.                                              3-12x8
  175.                                              4-14x6
  176.                                              5-14x8
  177.                                              6-...
  178.    Example:
  179.  
  180.    To change the 1280X1024 resolution to use the small system font, 96 dpi
  181.    and 8x14 Avio font, the following three lines must be entered:
  182.  
  183.    mgaconf f 4 0 0   
  184.    mgaconf f 4 1 0
  185.    mgaconf f 4 2 5
  186.  
  187.    Note that the default values for the fonts are:
  188.  
  189.                        Sytem Font  Font res  Avio Font
  190.    640x480             100         96        8x14
  191.    800x600             100         96        8x14
  192.    1024x768            101         120       12x22
  193.    1152x882            102         120       12x22
  194.    1280x1024           102         120       12x22
  195.    1600x1200           102         120       12x22
  196.  
  197. 2. Color cursor
  198.  
  199.    mgaconf c [0/1/2],
  200.  
  201.    where 0 will disable the software cursor (you will have 2 or less colors
  202.            in the cursor)
  203.          1 will enable the software cursor (multicolor cursor)
  204.          2 will enable the software cursor if the cursor has 4 or more colors
  205.  
  206.    Default is 1.
  207.  
  208. 3. Cursor Vsync
  209.  
  210.    The cursor may exhibit some "noise" when an application changes the color 
  211.    palette. This switch forces to wait for a Vsync before changing the palette.
  212.    The drawback is a loss of speed when changing the palette. Some animated 
  213.    application requires fast changing palette. This switch applies only to 
  214.    8 bpp.
  215.  
  216.    mgaconf v 0      (off)
  217.    mgaconf v 1      (on)
  218.  
  219.    Default is 1. 
  220.  
  221. 4. DIVE switch
  222.  
  223.    Due to an OS/2 problem in 24 bpp, the Warp AVIO player video image will
  224.    be shifted to the left.
  225.  
  226.    MGACONF has a switch to enable DIVE in 24 bpp:
  227.  
  228.    mgaconf d 1 (ON)
  229.    mgaconf d 0 (OFF)
  230.  
  231.    Default is OFF for 24bpp and ON for 8 and 16 bpp.
  232.  
  233. For all options of MGACONF, you must reboot your computer to see the change 
  234. take effect.
  235.  
  236. Board Testing
  237. -------------
  238.  
  239. If you encounter any problems running OS/2 with your board, you should
  240. first determine whether it is a system or hardware problem. The best way
  241. to check for a potential hardware problem is to use the MGA SETUP program.
  242.  
  243. SETUP is a DOS program that is included on the MGA CAD Driver disk,
  244. It cannot be run from an OS/2 Command Prompt session.
  245.  
  246. If you have a DOS (FAT) partition on your hard disk, simply install the
  247. Setup and Utilities product using the provided installation program. Then 
  248. go to the \MGA\SETUP directory and type SETUP.
  249.  
  250. If you do not have a DOS partition, you will have to create a bootable
  251. disk that has SETUP on it. Here is the procedure:
  252.  
  253.    1. Insert the proper installation disk in your diskette drive.
  254.  
  255.    2. Copy A:\SETUP\FILES1.ZIP and A:\PKUNZIP.EXE to a location on your 
  256.       hard disk.
  257.  
  258.    3. Make that hard disk location current and type "PKUNZIP FILES1" 
  259.       to unarchive the files.
  260.  
  261.    4. Remove the installation disk and format a new bootable DOS disk.
  262.  
  263.    5. Copy the following files from your hard disk to your new floppy disk:
  264.             
  265.               SETUP.EXE, DOS4GW.EXE, MGA.MON
  266.  
  267.    6. Reboot your computer with the the new disk.
  268.  
  269.    7. Type SETUP.
  270.  
  271. In SETUP, select "Graphic Mode Test" to test the various modes that
  272. are available for your board. The program will not attempt to test a
  273. mode which is not supported by your board. The default test will be
  274. done at a 60Hz refresh rate for all resolutions.
  275.  
  276. If you have a customized monitor file (MGA.INF) in your \MGA\OS2
  277. subdirectory, SETUP can read it and act upon it if you set the MGA
  278. environment variable as shown below:
  279.  
  280.            SET MGA=C:\MGA\OS2
  281.  
  282. File description
  283. ----------------
  284.  
  285. Assume: <S> -> Source path
  286.         <D> -> Destination drive (OS/2 system drive).
  287.         <W> -> WinOS/2 or Windows path (\os2\mdos\winos2 or \windows)
  288.  
  289. <S>\INSTALL.CMD     --> stay where it is.
  290. <S>\FIXAUTO.CMD     --> <D>:\MGA\OS2
  291. <S>\UNINSTAL.CMD    --> <D>:\MGA\OS2
  292. <S>\MGAX64.OS2      --> <D>:\MGA\OS2\SYSLEVEL.MIL
  293.    (pack file)          <D>:\MGA\OS2\MGACONF.CMD
  294.                         <D>:\MGA\OS2\MGAX64S.DSP
  295.                         <D>:\OS2\DLL\PMGAX64.DLL
  296.                         <D>:\OS2\DLL\BMGAX64.DLL
  297.                         <D>:\MGA\OS2\KMGAX64.SYS
  298.                         <D>:\OS2\MDOS\VMGAX64.SYS
  299. <S>\MGAX64W.OS2     --> <W>:\SMGAX64.DRV
  300.    (pack file)          <W>:\MGAX64.DLL
  301. <S>\MGAX64.DSP      --> stay where it is.
  302. <S>\MGAX64.DSC      --> <D>:\OS2\INSTALL
  303. <S>\MGA.MON         --> <D>:\MGA\OS2
  304. <S>\MGAMON.EXE      --> <D>:\MGA\OS2
  305. <S>\README.OS2      --> <D>:\MGA\OS2
  306.  
  307.  MGAX64.DSP     installation support file for "dspinst" (for first install)
  308.  MGAX64S.DSP    installation support file for "dspinst" (for re-install)
  309.  MGAX64.DSC     installation support file
  310.  MGAX64.DLL     initialization library for WinOS2 fullscreen
  311. BMGAX64.DLL     Base Video Handle (sets VGA for OS/2 fullscreen)
  312. PMGAX64.DLL     32bit PM driver (8, 16 and 32bpp)
  313. KMGAX64.SYS     low-level initialization for 32bit PM driver
  314. SMGAX64.DRV     WinOS2 Fullscreen and Seamless driver
  315. VMGAX64.SYS     Virtual MGA Millennium driver (for DOS sessions)
  316. README.OS2      Readme file
  317. INSTALL.CMD     first time installation
  318. MGACONF.CMD     Configuration utility for MGA Millennium PM driver
  319. FIXAUTO.CMD     inserts "SET MGA=C:\MGA\OS2" in autoexec.bat (WinOS2)
  320. UNINSTAL.CMD    uninstalls driver (and removes all Millennium files from
  321.                 hard drive)
  322. MGA.MON         MGA Monitor data file for MGAMON.EXE 
  323. MGAMON.EXE      Monitor program to create MGA.INF out of MGA.MON
  324. SYSLEVEL.MIL    driver Version info
  325.                 (use OS/2 command syslevel.exe to obtain the driver Version)
  326.  
  327. Driver History
  328. --------------
  329.  
  330. 1.00 (build 009) 9 June 95
  331.  
  332. - first release
  333.  
  334.  
  335. KNOWN BUGS AND LIMITATIONS
  336. --------------------------
  337.  
  338. The following bugs and limitations are present in this release of the
  339. driver:
  340.  
  341. - When using the DSPINSTL program to reconfigure your MGA driver, the 
  342.   program states that VGA is the current driver. This is a bug in the 
  343.   DSPINSTL program that is included by IBM.
  344.  
  345. - The MGA PowerDesk Windows drivers should NOT be used in a Win-OS/2 full 
  346.   screen session. The results will be highly unpredictable.
  347.   If the MGA windows driver features are absolutely needed, then a dual-boot 
  348.   configuration must be used. When booting from DOS, the PowerDesk Windows 
  349.   driver features are fully supported.
  350.  
  351. - The driver does not work with Mayo Clinic Family Heath Book (Windows app.)
  352.   in seamless Windows at 16bpp (64K colors).  If you need to run this
  353.   application, please run it in WinOS2 fullscreen instead or you may have
  354.   to change the pixel depth to 8bpp or 24bpp.
  355.  
  356. - The detailed DDC timings are not read by this OS/2 driver. Hence on some
  357.   monitors you may not be able to support particular resolutions (such as
  358.   1280 X 1024 @60Hz or 1600 X 1200). If resolutions are missing, use the
  359.   MGA monitor program to create a custom monitor file. 
  360.