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.