README.OS2 MATROX GRAPHICS INC. 19-Sep-1995
The MGA Millennium OS/2 PM Display Driver
v 1.10 (build 011)
Product Description
-------------------
The MGA Millennium OS/2 PM driver supports 8-bit (256 colors), 16-bit (64K
colors), and 32-bit (16M colors) display modes under OS/2 2.1 and 3.0 (Warp),
in resolutions ranging from 640 x 480 to 1600 x 1280.
Driver Installation
-------------------
To install the software, follow the procedure below:
1. If you are installing this driver for the first time, have the MGA
board installed and boot OS/2. Select VGA as the display driver.
2. If you downloaded the driver from the Matrox BBS, use the DOS LABEL
command to label your floppy as OS2.
3. Using the Command Prompts folder of OS/2, open an OS/2 Window or
Full Screen session.
4. Insert the driver disk in a floppy drive (if you are installing from
the floppy disk) or insert the CD-ROM in its drive bay.
5. Make the CD-ROM or floppy disk the active drive and type:
"SRCPATH\INSTALL",
where SRCPATH is the path which contains the MGA PM drivers.
Examples:
A:\INSTALL (if installing from a diskette with OS/2 only)
A:\OS2\INSTALL (if installing from diskette with OS/2 and NT)
D:\OS2\INSTALL (if installing from a CD-ROM)
Note: if you install this driver to a Warp System, you may run
\INSTALL /u
and every thing will be installed without any further input from the
user (primary, secondary selection, driver selection, and source
disk/path selection).
6. You will see a dialog box in which you can select the Primary Display.
Choose "Matrox MGA Millennium Series". You may have to change the source
drive if you are not installing from drive A.
7. The installation program will then proceed with the installation.
When it is complete, you will have to shut down your system in
order for the MGA driver to take effect.
If you are installing this driver for the first time, OS/2 will restart in
Matrox default MGA resolution (640 x 480 x 256). It is therefore advisable
to select the desired resolution just BEFORE rebooting, by means of the OS/2
System Setup folder, as explained in the next section.
Driver Configuration
--------------------
To change the driver mode (resolution or pixel depth), use the
following procedure:
1. Click the right button on the PM desktop background.
2. Select SYSTEM SETUP to open the system setup folder.
3. Double-click on the SYSTEM icon.
4. Select the SCREEN tab and choose the resolution/pixel depth.
You will need to reboot the system to see the change take effect.
Uninstalling the Driver
-----------------------
The Matrox UNINSTAL command file makes use of the OS/2 DSPINSTL.EXE program
to switch the display driver from MGA mode back to VGA mode, as shown in the
following procedure:
1. Open an OS/2 Text Window (or Full Screen) session.
2. Enter: CD \MGA\OS2
UNINSTAL
or
UNINSTAL CLEAN (to also delete the Matrox files from your hard disk)
3. Select Primary Display, then choose the driver you require (for
example, VGA).
You will need to reboot the system to see the change take effect.
Note: With Warp, there are two additional ways to switch the driver from
MGA mode to VGA mode:
1. You can access a menu by pressing Alt+F1 when the OS/2 logo appears
in the upper left corner of the screen during the bootup process.
This menu will allow you to change the driver to VGA by selecting
the appropriate option.
2. You can also change the driver to VGA by running the following file
in an OS/2 window or full screen session:
\OS2\INSTALL\RSPDSPI.EXE
Monitor Customization
---------------------
The OS/2 Millennium driver supports VESA DDC-1 and DDC-2B compliant monitors.
If your monitor is not detected as DDC compliant, the driver will take the
"Unknown Monitor" hardcoded timings, which assume that you have a monitor
supporting all resolutions available on your board, at a 60Hz refresh rate
(non-interlaced).
If you have a monitor that is capable of refresh rates higher than 60Hz, you
can perform monitor file customization with the help of the MGAMON program.
This program creates a file called MGA.INF, which contains the appropriate
video parameters for your monitor. The MGA.INF file is read by the MGA display
driver when OS/2 boots.
The MGAMON program is located in the \MGA\OS2\ directory. It is a DOS program,
so it must be run in a DOS session (either windowed or full screen).
To run MGAMON, open a DOS session:
1. Enter: CD \MGA\OS2
MGAMON
2. Select a monitor and exit the program.
You must shut down OS/2 and reboot your computer for the changes to take
effect.
Driver configuration
--------------------
Advanced configuration of the MGA driver can be performed through the
MGACONF.CMD command file, located in the \mga\os2 directory.
MGACONF performs the following:
1. Font settings
MGACONF has a switch to change the font settings:
mgaconf f
You will be prompted for the resolution to affect and the parameter to
change: System Font (desktop menu font), Font Resolution (desktop icon
font) or Avio Font (font inDOS and OS/2 windows).
Command line input is also possible, the syntax being:
mgaconf f "resolution" "which_parameter" "parameter_value", where
0-640X480 0-SystemFont 0-Small(100)
1-800X600 1-Medium(101)
2-1024X768 2-Large(102)
3-1152X882
4-1280X1024 1-FontResolution 0-96dpi
5-1600X1200 1-120dpi
6-1600x1280
2-AvioFont 0-8x8
1-10x6
2-10x8
3-12x8
4-14x6
5-14x8
: ...
9-18x8
a-18x10
: ...
e-30x12
Example:
To change the 1280X1024 resolution to use the small system font, 96 dpi
and 8x14 Avio font, the following three lines must be entered:
mgaconf f 4 0 0
mgaconf f 4 1 0
mgaconf f 4 2 5
Note that the default values for the fonts are:
Sytem Font Font res Avio Font
640x480 100 96 8x14
800x600 100 96 8x14
1024x768 101 120 12x22
1152x882 102 120 12x22
1280x1024 102 120 12x22
1600x1200 102 120 12x22
1600x1280 102 120 12x22
2. Color cursor
mgaconf c [0/1/2],
where 0 will disable the software cursor (you will have 2 or less colors
in the cursor)
1 will enable the software cursor (multicolor cursor)
2 will enable the software cursor if the cursor has 4 or more colors
Default is 1.
3. Cursor Vsync
The cursor may exhibit some "noise" when an application changes the color
palette. This switch forces to wait for a Vsync before changing the palette.
The drawback is a loss of speed when changing the palette. Some animated
application requires fast changing palette. This switch applies only to
8 bpp.
mgaconf v 0 (off)
mgaconf v 1 (on)
Default is 1.
4. DIVE switch
Due to an OS/2 problem in 24 bpp, the Warp AVIO player video image will
be shifted to the left.
MGACONF has a switch to enable DIVE in 24 bpp:
mgaconf d 1 (ON)
mgaconf d 0 (OFF)
Default is OFF for 24bpp and ON for 8 and 16 bpp.
5. Grayscale driver switch
Owners of the Millennium PowerDoc Edition may enable the grayscale driver
switch, which defines whether 8 bits per pixel should be in 256 colors or
256 gray shades.
mgaconf g 1 (Grayscale)
mgaconf g 0 (Color)
For all options of MGACONF, you must reboot your computer to see the change
take effect.
Board Testing
-------------
If you encounter any problems running OS/2 with your board, you should
first determine whether it is a system or hardware problem. The best way
to check for a potential hardware problem is to use the MGA SETUP program.
SETUP is a DOS program that is included on the MGA CAD Driver disk,
It cannot be run from an OS/2 Command Prompt session.
If you have a DOS (FAT) partition on your hard disk, simply install the
Setup and Utilities product using the provided installation program. Then
go to the \MGA\SETUP directory and type SETUP.
If you do not have a DOS partition, you will have to create a bootable
disk that has SETUP on it. Here is the procedure:
1. Insert the proper installation disk in your diskette drive.
2. Copy A:\SETUP\FILES1.ZIP and A:\PKUNZIP.EXE to a location on your
hard disk.
3. Make that hard disk location current and type "PKUNZIP FILES1"
to unarchive the files.
4. Remove the installation disk and format a new bootable DOS disk.
5. Copy the following files from your hard disk to your new floppy disk:
SETUP.EXE, DOS4GW.EXE, MGA.MON
6. Reboot your computer with the the new disk.
7. Type SETUP.
In SETUP, select "Graphic Mode Test" to test the various modes that
are available for your board. The program will not attempt to test a
mode which is not supported by your board. The default test will be
done at a 60Hz refresh rate for all resolutions.
If you have a customized monitor file (MGA.INF) in your \MGA\OS2
subdirectory, SETUP can read it and act upon it if you set the MGA
environment variable as shown below:
SET MGA=C:\MGA\OS2
File description
----------------
Assume: <S> -> Source path
<D> -> Destination drive (OS/2 system drive).
<W> -> WinOS/2 or Windows path (\os2\mdos\winos2 or \windows)
<S>\INSTALL.CMD --> stay where it is.
<S>\FIXAUTO.CMD --> <D>:\MGA\OS2
<S>\UNINSTAL.CMD --> <D>:\MGA\OS2
<S>\MGAX64.OS2 --> <D>:\MGA\OS2\SYSLEVEL.MIL
(pack file) <D>:\MGA\OS2\MGACONF.CMD
<D>:\MGA\OS2\MGAX64S.DSP
<D>:\OS2\DLL\PMGAX64.DLL
<D>:\OS2\DLL\BMGAX64.DLL
<D>:\MGA\OS2\KMGAX64.SYS
<D>:\OS2\MDOS\VMGAX64.SYS
<S>\MGAX64W.OS2 --> <W>:\SMGAX64.DRV
(pack file) <W>:\MGAX64.DLL
<S>\MGAX64.DSP --> stay where it is.
<S>\MGAX64.DSC --> <D>:\OS2\INSTALL
<S>\MGA.MON --> <D>:\MGA\OS2
<S>\MGAMON.EXE --> <D>:\MGA\OS2
<S>\README.OS2 --> <D>:\MGA\OS2
MGAX64.DSP installation support file for "dspinst" (for first install)
MGAX64S.DSP installation support file for "dspinst" (for re-install)
MGAX64.DSC installation support file
MGAX64.DLL initialization library for WinOS2 fullscreen
BMGAX64.DLL Base Video Handle (sets VGA for OS/2 fullscreen)
PMGAX64.DLL 32bit PM driver (8, 16 and 32bpp)
KMGAX64.SYS low-level initialization for 32bit PM driver
SMGAX64.DRV WinOS2 Fullscreen and Seamless driver
VMGAX64.SYS Virtual MGA Millennium driver (for DOS sessions)
README.OS2 Readme file
INSTALL.CMD first time installation
MGACONF.CMD Configuration utility for MGA Millennium PM driver
FIXAUTO.CMD inserts "SET MGA=C:\MGA\OS2" in autoexec.bat (WinOS2)
UNINSTAL.CMD uninstalls driver (and removes all Millennium files from
hard drive)
MGA.MON MGA Monitor data file for MGAMON.EXE
MGAMON.EXE Monitor program to create MGA.INF out of MGA.MON
SYSLEVEL.MIL driver Version info
(use OS/2 command syslevel.exe to obtain the driver Version)
Driver History
--------------
1.00 (build 007) 9 June 95
- first release
1.01 (build 008)
- Fixed STM0003 dtt.exe -> GreBitMaps -> GreImagedataExh, missing left part of the
triangle.
- Fixed STM0015, STM0016, STM0018: Selective Install window did not refresh
when move out and in the display. @800x600x8 (also with 16 and 32bpp)
- Fixed STM0019 clear the display after setmode.
- Fixed STM0005, STM0020: the outline of the hilight change color (or disapear)
when part of it is refresh. (cover it and uncover it).
- Fixed STM0006 dtt.exe -> GreAttr -> GreDeviceSetGetAttrExh, reverse pattern.
- Fixed STM0021 small black dot at top left corner of any window.
- Fixed STM0017 color cursor in scheme palette.
- Fixed STM0007 last marker position.
- Fixed STM0031 WinOS2 fullscreen switching problem.
- Fixed STM0034 OS/2 Chess.
- Fixed STM0033 Software cursor with Seamless Windows.
- Add Grayscale & 1600x1280 supported (DIP board only).
- Fixed #2719 problem with non-DDC Qvision 172 monitor.
1.01 (build 009)
- Maintenance version based on build 007.
1.10 (build 010)
- New version number, based on build 008.
1.10 (build 011)
- Fixed #2840 problem with rectangle fill in Seamless Windows Paintbrush.
KNOWN BUGS AND LIMITATIONS
--------------------------
The following bugs and limitations are present in this release of the
driver:
- When using the DSPINSTL program to reconfigure your MGA driver, the
program states that VGA is the current driver. This is a bug in the
DSPINSTL program that is included by IBM.
- The MGA PowerDesk Windows drivers should NOT be used in a Win-OS/2 full
screen session. The results will be highly unpredictable.
If the MGA windows driver features are absolutely needed, then a dual-boot
configuration must be used. When booting from DOS, the PowerDesk Windows
driver features are fully supported.
- The driver does not work with Mayo Clinic Family Heath Book (Windows app.)
in seamless Windows at 16bpp (64K colors). If you need to run this
application, please run it in WinOS2 fullscreen instead or you may have
to change the pixel depth to 8bpp or 24bpp.
- The detailed DDC timings are not read by this OS/2 driver. Hence on some
monitors you may not be able to support particular resolutions (such as
1280 X 1024 @60Hz or 1600 X 1200). If resolutions are missing, use the
MGA monitor program to create a custom monitor file.
