M91VIDEO.EXE
Use on:
Aptiva 2168-M91 systems ONLY.
Contents of diskette:
This diskette contains video drivers for Aptiva 2168-M91 system with the Matrox Millenium
video board installed.
MATROX GRAPHICS INC.
4-Jan-1996
The MGA Millennium OS/2 PM Display Driver
v 1.11 (build 019)
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.
Installation:
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.
Note: If you are using Selective Install in OS/2 Warp, the MGA Millennium
driver shows up as "Other."
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.
NOTE: The timing information in MGA.INF over-rides the timing info returned
by DDC compliant monitors. If you are using a DDC compliant monitor,
and you do not wish to over-ride the monitor's timing info, then
delete the MGA.INF file from your \MGA\OS2\ directory.
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>\VVGA.SYS --> <D>:\MGA\OS2 and <D>:\OS2\MDOS
<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)
VVGA.SYS Modified IBM VGA virtual driver.
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 problem with rectangle fill in Seamless Windows Paintbrush.
1.11 (build 018)
- Fixed Alt-Esc switching hang when switching between PM Desktop and
full-screen WinOS2.
- Fixed problems running TCPY and MEMTEST test applications.
- Fixed problem with Novell "SEND" command.
- Fixed problem running IBM PCM Acceptance test.
- Fixed problem openning DOS session on DELL systems.
- Fixed booting problem on PentiumPro systems.
- Added support for monitors capable of providing DDC Standand and Detailed
timing informations.
1.11 (build 019)
- Fixed GPF bug when launching WinOS2 Program Manager in Seamless mode.
- Fixed Alt-Esc problem when switching from Klondike (auto-play) to
full-screen DOS.
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 because the
DSPINSTL program included with OS/2 does not correctly identify the
MGA Millennium.
- 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.
- When switching quickly from PM desktop to full-screen WinOS2, the
WinOS2 desktop may get corrupted. To restore the WinOS2 desktop,
do a slow switch to PM Desktop and back to WinOS2.
- This diskette does not support CID. Contact our technical support to get
our CID upgrade kit.
__________________________________________________________________
IBM SYSTEM PROGRAMS LICENSE AGREEMENT
__________________________________________________________________
PLEASE READ THIS AGREEMENT CAREFULLY BEFORE DOWNLOADING AND
USING THESE PROGRAMS ON YOUR SYSTEM. DOWNLOADING THESE PROGRAMS
INDICATES YOUR ACCEPTANCE OF THESE TERMS.
This is a license agreement ("Agreement") for International Business
Machines Corporation or its subsidiaries ("IBM") system programs
("Programs") which are provided to support the IBM system ("System").
A System includes IBM machines, features, conversions, upgrades,
and options, either separately or in any combination. Programs
may be included with the System, or made available electronically
or via various media.
IBM may also offer other programs which may be licensed under different
terms and conditions. Please refer to the license agreement(s)
accompanying such other programs for the terms and conditions governing
their use.
LICENSE
Programs are owned by IBM or its suppliers, and copyrighted and licensed
not sold. If you are a rightful possessor of a System, or if you have
obtained Programs for the purpose of maintaining a System, IBM grants
you a nonexclusive license to use the Programs as part of or in
conjunction with the System, or to restore and maintain the Programs.
This Agreement also covers any future versions of Programs that IBM may
make available. You obtain no rights other than those granted to you
under this Agreement.
You may:
1) use the Programs as part of, or in conjunction with, a System as
specified in the documentation that IBM provides;
2) modify or adapt only the SETUP and ADAPTER DESCRIPTION FILES
(@XXXX.ADF), if applicable, to enable a System to operate in
accordance with IBM's Official Published Specifications;
3) copy the Programs for backup;
4) make copies of the Programs and distribute them to a rightful
possessor of a System and to install the Programs for a rightful
possessor (but only to the extent necessary to restore or maintain
the System), provided that you supply such party a copy of this
Agreement; and
5) transfer possession of these Programs and diskette(s) to another
party in conjunction with the transfer of a System, provided that
you supply a copy of this Agreement and all Program and System
documentation to such party. When you do so, your license is
terminated and you must destroy all your remaining copies of the
Program.
YOU MUST REPRODUCE THE COPYRIGHT NOTICE(S) AND ANY LEGENDS ON EACH
COPY OF A PROGRAM.
You may NOT:
1) use, modify, adapt, copy, merge, display, execute, distribute
or transfer the Programs, except as authorized by this license;
2) reverse assemble, reverse compile, decode, or otherwise
translate the Programs except as specifically permitted by
law without the possibility of contractual waiver; or
3) sublicense, rent, lease, or assign the Programs.
LIMITED WARRANTY
IBM warrants the Programs solely in accordance with the Statement
of Limited Warranty for Machines that accompanied your System,
which is hereby incorporated by reference.
GENERAL
You may terminate your license at any time. IBM may terminate your
license if you fail to comply with the terms of this Agreement.
In either event, you must destroy or disable all your copies of
the Programs.
You are responsible for the payment of any taxes, including personal
property taxes, resulting from this Agreement.
You agree to comply with all applicable export laws and regulations.
Neither party may bring an action under this Agreement more than two
years after the cause of action arose.
This license is governed by the laws of the country in which you
acquired the Programs except that:
1) if you acquired the Programs in the United States, this license is
governed by the laws of the State of New York; and
2) if you acquired the Programs in Canada, this license is governed by
the laws of the Province of Ontario.