This file contains notes in the following languages:

- English

[English] 
README.NT                    MATROX GRAPHICS INC.             October 11, 1996
 
         MGA Millennium/Matrox Mystique Windows NT 4.0 Display Driver 
                            Rev. 2.31.008 (4.0.8)
 
Table of Contents 
~~~~~~~~~~~~~~~~~ 
- Release description 
- Product files 
- Installation 
- Changing resolution 
- MGA Panel and QuickAccess 
- Monitor selection 
- Registry settings 
- Hardware-accelerated 3D 
- Notes, Problems, and Limitations 
 
Note: This file may contain some last minute information not translated 
into your language. We apologize for the inconvenience. 
 
Release description 
~~~~~~~~~~~~~~~~~~~ 
This is the MGA Millennium/Mystique Windows NT Display Driver, version 2.30. 
It supports Microsoft Windows NT for x86 CPU's, version 4.0 (Build 1381).
 
This product includes: 
 
- Display Driver 
- MGA PowerDesk Panel 
 
The driver supports 2, 4, and 8Mbytes MGA Millennium boards, as well as 2 and
4MBytes Matrox Mystique boards.  Up to four boards are supported.
 
Product files 
~~~~~~~~~~~~~ 
   \MGA64.TAG           Tag file for version identification 
   \MGA64.INF           Driver installation file for Windows NT Setup 
   \MGA64.SYS           MGA Millennium/Matrox Mystique miniport driver 
   \MGA64.DLL           MGA Millennium/Matrox Mystique display driver 
   \README.NT           This file 
 
   \MGAHK.EXE           Service start-up application 
   \MGAQUICK.EXE        QuickAccess application 
   \MGAPANEL.CPL        MGA PowerDesk applet 
   \MGA_*.HLP         	Help for MGA PowerDesk applet 
   \MGA_*.DLL         	Language library 
   \MGA.MON             MGA monitor file 
   \MGA.BIN             Binary MGA monitor database 
   \SETUP.EXE           Installation program for drivers and MGA PowerDesk
   \SETUP.INI           Information file for SETUP 
   \UNINSTLL.EXE        Uninstall application 
   \CTL3D32.DLL         Library used by the MGA Panel applet 
 
Installation 
~~~~~~~~~~~~ 
Refer to your MGA Millennium/Matrox Mystique Owner's Manual to install your 
board in your system. 
 
If you are installing multiple MGA Millennium boards in your system, please  
note that only one should be VGA-enabled through the on-board switch.

Matrox Mystique boards are always VGA-enabled.  If you are installing 
multiple Matrox Mystique boards in your system, your system BIOS must disable 
all VGA-enabled boards it finds after the first one.  When Windows NT starts, 
the miniport driver will find all boards and enable them for use.  THIS IS 
GUARANTEED ONLY IF YOUR SYSTEM BIOS IS FULLY PCI-COMPLIANT.  IF YOUR SYSTEM 
BIOS IS NOT FULLY PCI-COMPLIANT, MULTIPLE MYSTIQUE BOARDS MAY NOT WORK.  

Multiple-board installations are similar to single-board installations. 
The system will automatically assign separate addresses to each PCI board, 
allowing the driver to issue commands to each board.  In a multiple-board 
configuration, all boards must be either Millennium or Mystique boards, and 
all boards must run with the same resolution and pixel depth (number of 
colors).  The VGA-enabled board will drive the top left monitor. 

To install the MGA Millennium/Matrox Mystique drivers, run the Setup 
utility supplied with the drivers:

      - Start the Windows NT Explorer, or open a Command Prompt window.

      - Go to the drive and directory holding the driver installation files.

      - Double-click on the Setup application, or type 'setup' and press 
        Enter.

The Setup utility will install the PowerDesk applets and the drivers 
automatically.  You must restart your computer before the changes take effect.

The general procedure for changing a display driver is the following: 
 
      - Right-click on the desktop, select 'Properties'.  This will open 
        Display Properties.

      - Select the 'Settings' tab.
 
      - Press the 'Display Type...' button. 
 
      - In the Display Type dialog box, press the 'Change...' button. 
 
      - In the Change Display dialog box, press the 'Have Disk...' button. 
 
      - In the Install From Disk dialog box, type the location of the 
        MGA Millennium/Matrox Mystique installation files (e.g. "A:\" or 
        "D:\WINNT"). 
 
      - From the displayed list, select the model of your display adapter, 
        and press 'OK'.

      - Answer 'Yes' to the Third-party Drivers dialog box. 
 
      - Press 'OK' in the Installing Driver message box. 

      - Press 'Close' in the Display Type dialog box.

      - Press 'Close' in the Display Properties applet.

      - In the System Settings Change dialog box, you should select 'Yes' 
        so that the new settings take effect. 
 
Changing resolution 
~~~~~~~~~~~~~~~~~~~ 
Whenever you want to change resolution, open Display Properties / Settings. 
The available modes are displayed through the 'List All Modes...' button. 
 
If you are using a multiple-screen configuration, the driver will spread the 
desktop over multiple  monitors.  Special multiple-screen resolutions will be 
listed, where the horizontal or vertical resolutions are multiple of their 
normal size.  Selecting one of these resolutions will permit testing of 
both monitors. 
 
MGA Panel and QuickAccess 
~~~~~~~~~~~~~~~~~~~~~~~~~ 
The MGA Panel applet and the QuickAccess application should have been 
copied to your hard disk by the Setup utility.  These applications work 
together to allow the user to access information about their board(s) and 
to enable and use driver features. 
 
MGA Panel can be started from Control Panel.  It can currently display 
five pages: 
 
About         displays information such as current version numbers and 
              current resolution. 
 
Configuration allows the user to set the 3D switches (described in the 
              'Hardware-accelerated 3D' section), and to select a preferred 
              language. 
 
Monitor       allows building of a video parameter file, as described in 
              the 'Monitor Selection' section. 
 
Information   displays hardware information about the board(s) installed 
              in the system. 
 
PowerDesk     allows the user to define and enable hot keys for zooming 
              (PixelTOUCH), for centering the top window (CenterWINDOW), 
              and to start the MGA Panel and the Display Properties applets. 
              The QuickACCESS check box can make QuickAccess visible on the 
              taskbar. 
 
QuickAccess is a floating toolbar that allows zoom in, zoom out, and window 
centering.  It can also invoke the MGA Panel.  It is started automatically 
immediately after log on. 
 
Monitor selection 
~~~~~~~~~~~~~~~~~ 
After installation, the display driver expects that refresh rate information 
will be set through a video parameter file called MGA.INF.  If this file is 
not found, the driver will check for Display Data Channel (DDC) capabilities 
from your monitor and use DDC timings if they are available.  If your monitor 
is not DDC-compliant, the driver will assume that your monitor is capable of 
handling all resolutions from 640x480 up to 1600x1200 at a 60 Hz refresh 
rate for Millennium boards, and up to 1280x1024 at 60 Hz for Mystique boards. 
 
In all cases, it is highly recommended that you select a monitor through the 
MGA Panel.  When a monitor is selected, the MGA.INF file is created in 
your SystemRoot\system32 directory.  Refer to the MGA Panel Help for more 
details on monitor selection. 
 
A change of monitor selection will take effect the next time Windows NT is 
booted. 
 
Advanced users who would rather select refresh rates through Display Settings 
can set the 'User.MgaInfoFile' value in the registry to 0 (see the 
'Registry settings' section for details).  The next time you reboot, 
refresh rates available for each mode will be returned to Display Properties. 
Please be aware that the number of modes available in this case can be very 
high, and even more so when multiple boards are installed.  Currently, 
Windows NT appears to handle approximately 290 modes.  Modes beyond this 
limit will not be displayed and will thus be unavailable.  It is possible 
that the system will reboot in the 640x480x8 mode and display a warning 
message, if it could not find the setting that was used previously.  You can 
now select refresh rates from the list displayed by Display Properties. 
If your monitor is DDC compliant, the list of modes will be built from an 
internal table of video parameters and according to the capabilities reported 
by your monitor;  otherwise, the internal table will be used.  In any case, 
you should test any new mode to make sure that your monitor actually supports 
the new resolution/refresh rate combination. 
 
Registry settings (for advanced users only) 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
Information held in the Windows NT registry can have a direct effect on the 
whole system.  Introducing incorrect values can cause serious problems and 
may make it necessary to reinstall Windows NT.  The changes outlined below 
should have effects limited to the MGA Millennium and Matrox Mystique 
drivers.  However, if you accidentally modify values that make your system 
unusable, please note that it is often possible to undo the damage by using 
the 'Last Known Good Configuration' option at boot time.  It is also possible 
to save a copy of your registry settings prior to any modification.
 
The configuration of the MGA Windows NT driver and of MGA Panel is saved in 
the registry.  The most important parameters can be modified through the 
MGA Panel, but others can be accessed only through the Registry Editor. 
Most users will find that the default values are best for their system. 
However, specific problems will be solved through these switches.  The 
values are: 
 
User.AlternateLines when set to 1, allows lines defined by integer coordinates 
                    to be drawn using the faster AUTOLINE opcode of the 
                    drawing engine.  The convention used to determine which 
                    pixels contribute to a given line is slightly different 
                    in AUTOLINE and in Windows NT.  Setting AlternateLines 
                    to 1 trades off compliance with the Windows NT conventions 
                    for performance.  A value of 0 will enforce compliance. 
                    Lines defined by non-integer endpoint coordinates are not 
                    affected by this setting. 
 
                    The default value of User.AlternateLines is 0. 
 
User.CenterDialogs  when set to 1, allows centering of dialog boxes and 
                    pop-up windows on the top left display of a multiple- 
                    screen setup.  The centered windows can still be moved 
                    over the whole desktop.  A value of 0 will have no effect 
                    on the position of these windows. 
 
                    There are serious side-effects to this feature.  For 
                    instance, testing a multiple-screen mode from the 
                    ControlPanel/Display applet will actually test only the 
                    corresponding single-screen mode.  Other side-effects 
                    include toolbars that will not use the whole desktop, and 
                    screen savers that will work only on the top left screen. 
 
                    The default value of User.CenterDialogs is 0. 
 
User.ComplexBlt     when set to 1, allows the hardware to accelerate some 
                    complex raster operations (ROPs) by executing a sequence 
                    of simple ROPs (ORing, ANDing, etc...).  A value of 0 
                    will result in complex ROPs being performed in software. 
 
                    The complex ROPs are performed directly on the display 
                    through a succession of simple ROPs.  Artifacts (flashing) 
                    in the target display area may become visible when an 
                    intermediate result in video RAM is displayed on a given 
                    refresh cycle, to be replaced by the final image on the 
                    next cycle. 
 
                    The default value of User.ComplexBlt is 1. 
 
User.DeviceBitmaps  when set to 1, allows use of off-screen memory for 
                    caching bitmaps.  This will allow the hardware to 
                    accelerate drawing to bitmaps.  A value of 0 disables 
                    bitmap caching, allowing the CPU to draw onto all 
                    bitmaps.  Bitmap caching is internally disabled when 
                    a desktop requiring more than one board is in use, 
                    regardless of the registry setting. 
 
                    The default value of User.DeviceBitmaps is 1. 
 
User.MgaInfoFile    when set to 1, allows use of the MGA Panel applet to 
                    control refresh rates.  A value of 0 will allow the 
                    Display applet to list available refresh rates.  See 
                    the 'Monitor selection' section for more details. 
 
                    The default value of User.MgaInfoFile is 1. 
 
User.SynchronizeDac when set to 1, will require the driver to wait for a 
                    vertical sync before programming the ramdac with a new 
                    pointer shape or a new palette.  If you notice stray 
                    pixels flashing around the pointer, setting this flag 
                    to 1 might fix the problem.  Setting it to 0 will result 
                    in slightly better performance. 
 
                    The default value of User.SynchronizeDac is 0. 
 
User.SynchronizeEngine when set to 1, will require the driver to wait for 
                    the Millennium hardware to be ready to accept new data 
                    before programming the next operation.  Setting it to 0 
                    will result in better performance. 
 
                    On most x86-based systems, the PCI logic should ensure 
                    that such a check is redundant.  If you're experiencing 
                    problems that might be related to timing (with 
                    communication programs, for instance), setting this value 
                    to 1 may be of help. 
 
                    The default value of User.SynchronizeEngine is 0. 
 
Modifying keys and values in the registry is done through the Registry 
Editor.  The Registry Editor can be invoked in the following way: 
 
      - Use Start/Run..., or open a Command Prompt window, and type 
        'regedt32'.  Alternately, from the Windows NT Explorer, go to
        SystemRoot\system32 and double-click on Regedt32.  The Registry 
        Editor will come up. 
 
To examine or to modify the values that govern the behavior of the MGA 
Millennium driver: 
 
      - Select the HKEY_LOCAL_MACHINE window. 
 
      - Travel down to the key named: 
        HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\mga64\Device0. 
 
You will find the values in the right window pane.  To modify any of them: 
 
      - Double-click on the selected value. 
 
      - In the DWORD Editor, change the value to '0' or '1'.  The new value 
        will take effect the next time you reboot. 
 
Hardware-accelerated 3D 
~~~~~~~~~~~~~~~~~~~~~~~ 
The Mini-Client Driver (MCD), which is part of the Millennium/Mystique 
display driver, allows for hardware-accelerated 3D, with a few restrictions: 

      - Currently no acceleration is available on 2MBytes boards.

      - Currently no acceleration is available when multiple boards are
        in use.

      - The MCD does not support 8bpp (256 colors) and 24bpp (16777216 
        colors) modes.  The 15bpp (32K colors), 16bpp (64K colors), and 
        32bpp (True Color) modes are the ones that can be hardware- 
        accelerated. 
 
      - Limitations to the available resolutions are to be expected.  All 
        3D modes require extra memory to handle double buffering and/or Z 
        buffering, and this memory is no longer available for display. 
 
The 3D driver can be configured through two registry switches: 
 
User3D.DoubleBuffer when set to 1, allows a back buffer to be allocated 
                    from the MGA Millennium memory.  It should be set to 
                    0 if no back buffer is required. 
 
                    This value should be set to 1 if 3D animation is to 
                    be fully accelerated. 
 
User3D.ZBuffer      when set to 1, allows a Z buffer to be allocated from 
                    the MGA Millennium memory.  It should be set to 0 if 
                    no Z buffer is required. 
 
                    This value should be set to 1 if 3D rendering is to 
                    be fully accelerated. 
 
The default values for the User3D switches is 1.  Setting both values to 0 
effectively disables the hardware-accelerated 3D.  The recommended way of 
modifying them is through the MGA Panel 'Configuration' page rather than 
through the Registry Editor. 
 
The back- and Z-buffers can be allocated on a per-window basis.  This makes 
the availability of 3D-acceleration difficult to ascertain, since it would
be possible to get 3D-acceleration for a small window even when offscreen 
memory is scarce, while a request for full-screen buffers would fail even 
when relatively large areas of offscreen memory are available.
 
Notes, Problems, and Limitations 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
         
Systems using more than one PCI bus 
        It is possible that a switch to a full-screen Command Prompt, or any 
        change of mode, will result in a blue-screen crash if a board is
        installed on a PCI bus other than bus 0.  The problem is under 
        investigation.  Moving it to a different PCI slot is a possible 
        workaround.

        There are systems where Windows NT reports conflicts between adapters 
        installed beyond the PCI bridge.  In this case, the MGA Millennium 
        miniport driver cannot access its own board.  If your system appears 
        unable to find the Millennium board, try moving it to a different PCI 
        slot. 

