        #
        | README file for
        |
        | ELSA OS/2 WARP Version 4 dual board driver (GRADD)
        | version 01.05
        |
        |       ELSA WINNER 3000-M
        |
        | Copyright (c) 1994-98 ELSA AG, Aachen (Germany)
        |
        | ELSA AG                    Internet   : http://www.elsa.de
        | Sonnenweg 11               LocalWeb   : +49-(0)241-938800
        | D-52070 Aachen             CompuServe : GO ELSA
        |
        | ELSA Inc.                  Internet   : http://www.elsa.com
        | 2231 Calle De Luna         CompuServe : GO ELSA
        | Santa Clara, CA 95054
        | USA
        |
        | ELSA Asia Inc.             Internet   : http://www.elsa.com
        | 7F-11, No. 188, Sec. 5     CompuServe : GO ELSA
        | Nanking East Road
        | Taipei 105
        | Taiwan, R. O. C.
        |
        | 27/02/98, USchwabe


        1.  Overview
        2.  Contents
        3.  Installation
        4.  Notes
        5.  Release Notes
        6.  Caveats / Known Problems
        7.  EnDIVE
        8.  Adjustments

-----------------------------------------------------------------------

1.      Overview

        This disk contains the ELSA graphics system software for
        OS/2 WARP Version 4.

        See section 2 for a list of files and their purpose.
        Information in this file may not appear in the manuals.
        Please read this file carefully to be aware of any changes to
        the documentation.  Information in files on this disk
        supercedes the printed documentation.

-----------------------------------------------------------------------

2.      Contents

        The installation directory contains the following files:

        README.TXT      this file
        LIESMICH.TXT    German version of this README file
        SETUP.EXE       installation program
        SETUP.DAT       -------- " --------- -configuration file
        ELSAE.DLL       -------- " --------- -language resource file
        ELSAD.HLP       -------- " --------- -help file (German)
        ELSAE.HLP       -------- " --------- -help file (English)
        WS3INIT.DLL     -------- " --------- -hardware support
        WINMAN.MON      WINman monitor file
        BASEGD.DSP      configuration file
        FILTER.EXE      ELSA EnDIVE Filter Set Utility
        ELSAIMGD.DSC    configuration file
        ELSAIMGD.DSP    configuration file
        GRADDMB         OS/2 device driver for the ELSA graphics board
        DESKMAN.EXE     ELSA DESKman Tool
        WINDOWS         WINOS2 device driver

-----------------------------------------------------------------------

3.      Installation

        These drivers can only be used under OS/2 WARP Version 4.

        Installation of Fixpak5 is recommended.

        To guarantee a successful installation, be sure to have the
        original VGA driver installed and active.

3.1     Restoring the original VGA driver

        Use the restore option at system boot time (Alt+F1) and reset
        the primary display to VGA. Consult your OS/2 manual
        for further information.

        You have to reboot the system for the change to take effect.

3.2     Installation of the ELSA drivers version 01.05:

        Insert your ELSA CD into your drive, open the CD-ROM
        drive object on your desktop, change to the OS/2
        directory appropriate for your graphics card
        (i.e., \WINNER\2000AVI\OS2) and start SETUP.EXE.
        The contents of this file should appear on the
        "Introduction" page.

3.3     Using the setup program

        On the "Adapter Info" page you may view information about your
        graphics adapter. Use the "Help" function for detailed
        explanations of the displayed items.

        You will have to specify your monitor and the desired graphics
        resolution on the "Resolution" page.
        For example: the settings 1280x1024 specify a desktop size of
        2560x1024 split between two monitors.
        Please be sure that the information concerning your monitor is
        correct and complete (particularly the scan rates) in order to
        avoid damaging your monitor.
        After you have selected resolution and monitor you have to
        set these parameters by pressing the "Set" button.
        Please use two identical monitors, the resolution can be tested
        on the first monitor only.

        If the standard resolutions are not sufficient for your
        purposes or if your monitor is not listed in the monitor
        database, press the "Add" button.
        You will then be able to define custom resolutions and
        monitor-parameters.

        Use the "Installation" page to select the files to transfer to
        your hard disk and to start the installation process. Use the
        "Help" button in order to get further information. After
        completion of the installation you have to shut down and reboot
        your system. OS/2 WARP will start with the selected resolution.
        If you have specified the "ELSA Resolution Manager" in the
        installation procedure, you can use it for changing the
        selected resolution.

        You might need the OS/2 WARP 4 operating system CD, because it
        might be necessary to install the OS/2 GRADD support from the
        CD.

3.4     If there is only one, or two different graphics boards
        installed, the driver will reset to single-mode.

-----------------------------------------------------------------------

4.      Notes

4.1     This driver supports the following graphics boards:

        You will find a list in the header of this file.

4.2     De-Installation:

        1. Reset to VGA

        Use the restore option at system boot time (Alt+F1) and reset
        the primary display to VGA. Consult your OS/2 handbook
        for further information.

        Also remove the following line in your config.sys
        SET GREEXT=GRE2ELSA

        You have to reboot the system for the change to take effect.

        2. delete the files

            - WMBGRADD.DLL       (bootdrive:\os2\dll)
            - ELSAPMI.DLL        (bootdrive:\os2\dll)
            - WMBFILT.DLL        (bootdrive:\os2\dll)
            - GRE2ELSA.DLL       (bootdrive:\os2\dll)
            - HWENDIVE.DLL       (bootdrive:\os2\dll)
            - ELSAMODE.DAT       (bootdrive:\os2)
            - SVGADATA.PMI       (bootdrive:\os2)

              example: DEL C:\OS2\DLL\WMBGRADD.DLL

        3. delete the Windows drivers and WINman

           - WINNER??.DRV       (..\WINOS2\SYSTEM  or  ..WINDOWS\SYSTEM)
           - WINIC31.DLL

           - WINman.exe         (..\WINOS2\SYSTEM  or  ..WINDOWS\SYSTEM)
                               (older version in WINDOWS directory)
           - WINMAENG.HLP
           - WINMAENG.DLL
           - WINMAN.INI
           - WINMAN.MON

4.3     WIN-OS/2 Configuration:

        To change the standard configuration, use the Windows program
        WINman which is automatically started after first calling
        WINOS2.  An online help is available.

        By default, the ELSA Windows Driver WINNER08.DRV is installed
        with a resolution of 640x480x256.

        The WINNERxx.drv files (in WINDOWS) are copied to the WINOS/2
        directory during the installation. You don't have to copy and
        expand this driver from the GUI-disk.

4.4     ELSA DESKman Tool

        Use this program to adjust the display of message boxes,
        maximized windows and full screen sessions. Choose between left,
        right or that board the mouse pointer is currently displayed on.
        These settings take effect immediately.

        If the APM-Bios announces itself as active, you could use the
        ELSA DESKman Tool to switch on or off the driver support for the
        Advanced Power Management System (see also 6.3).
        This takes effect after the next reboot.

4.5     Full screen sessions

        OS/2, DOS and WIN-OS/2 full screen sessions will only be
        displayed on the actually active board and not be shown on
        both monitors.

4.6     If two different monitors are used, the better one should be
        the second monitor. On most motherboards the second board is
        the graphics board with the lower PCI number.

-----------------------------------------------------------------------

5.      Release Notes

        VERSION 1.01

          - hardware cursor defect at 800x600x16 fixed.
          - line error fixed.
          - wrong Mode info data in conjunction with unusual resolutions
             fixed.
          - EnDIVE support.
          - APM-Support
          - show message boxes on first monitor

        VERSION 1.02

          - EnDIVE Set is now included, too.
          - ELSA DESKman Tool

        VERSION 1.04

          - driver doesn't boot on FixPak3 (M003) fixed
          - preserve user endive settings
          - fixed system hangs when multimedia subsystem is
            not installed
          - fixed system hangs with EnDive at 8 bpp

        VERSION 1.05

          - support for the following settings:
               - ELSA_RESET (see 8.1)
               - the TIM line This is done by adding the
                 following line into the config.sys:
                 SET TIM=.....
                 like it is produced by WINMAN (see 8.2)
               - USE_SMALL_FONTS (see 8.2)
          - solved problems with netscape and Greek URLs
          - initialize OS/2 fullscreen sessions from the BIOS
          - small fonts for small resolutions

-----------------------------------------------------------------------

6.      Caveats / Known Problems

6.1     Wrong colors in a true color mode (not with FixPak3):

        fix: replace the system file SOFTDRAW.DLL by the corresponding
             file of fixpack 1
             (unpack softdraw.dl_ )

6.2     FixPaks

6.2.1   FixPak1

        There is a known problem with the FixPak and any GRADD-Driver.
        After the installation of the FixPak the VIO-windows contain
        irregular characters (they look very cryptic).

        Work-around: replace the pmmerge.dll with the previous version.
                     We didn't get any disadvantage with this solution.
6.2.2   FixPak3

        The problems listed under 6.1 and 6.2.1 are fixed.

        DIVE doesn't perform a color conversion in TrueColor mode. Hence
        it follows that in most cases the Software Motion Video will
        be used.

        fix : replace the system file DIVE.DLL by the corresponding file
              of your backup (unpack dive.dl_).

6.3     Restoration of the original OS/2-VGAGRADD driver

        Open the folder "Install/Remove" and start "Selective Install".
        Choose "Video Graphics Array (VGA) GRADD" as Primary Display
        and follow the further instructions of the install program.

        OS2.INI:      The key DEFAULTSYSTEMRESULUTION in the
                      application PM_DISPLAYDRIVERS must be deleted.
                      Please delete it if exists.

        SVGADATA.PMI: Delete this file when you find it in your
                      bootdrve's OS2 directory.

        You have to reboot the system for the change to take effect.

6.4     APM

        To confirm a proper functionality of the APM-System you have to
        adjust the Power Management Setup settings in your system BIOS
        to DPMS, the monitor should be turned off in the suspend mode.
        The OS/2 APM support must be installed (consult your OS/2
        handbook for further information). Otherwise the system can not
        handle both monitors properly.

        Example:   Video Off Option: Suspend -> Off
                   Video Off Method: DPMS

-----------------------------------------------------------------------

7.      EnDIVE

        You can use the "ELSA EnDIVE Filter" tool for setting and
        viewing various parameters of EnDIVE.


        The tool disables automatically the controls which are not
        applicable in the actual video mode. So, if a control is
        grayed or resetted the driver refuse the settings.

        The "Video Memory" display informs you about your usage of the
        free offscreen memory.

        For testing purposes or when using programs with faulty EnDIVE
        support you can switch off EnDIVE entirely (this has to be
        done before starting such programs) and control the use of X
        and Y filters.

        The settings will be stored so that they are activ atfer program
        termination even after a system reboot.

7.1     X and Y filtering

        These filters improve image quality for scaled AVI movies.
        The X filter interpolates the pixels in the horizontal
        dimension and the Y filter does so in the vertical dimension.

        Y filtering works only if sufficient off screen memory is
        available. Otherwise it is ignored.

        The settings for the filters are done via the "ELSA EnDIVE
        Set" tool. X filtering is set by default.

7.1.1  Prerequisites for Y filtering

        The video vertical size must be stretched by 2.8 or more

7.1.2   X filter

        There are 3 possible treatments to interpolate in horizontal
        direction. If "default" is selected the driver choose the
        best type for the actual video size.

7.2     Common restrictions of the EnDIVE support

        Supported on first board only

        Hardware video acceleration is only possible for one video
        at a time.
        Additional videos will be replayed using software motion video.

        fix: for best performance, finish one video before starting
             the next.

        In addition, the selected screen resolution should leave
        enough free video memory for storing a frame of the required
        resolution. Again, if the driver cannot use the hardware
        acceleration, it will revert to software motion video.

        fix: choose a graphics resolution smaller than the available
             maximum.

        When using these boards, hardware video shrinking will
        not function properly in all cases. Therefor software motion
        video will be used.

        The hardware video can be driven with max. 135MHz pixel
        frequency. If the chosen video mode uses a higher pixel
        frequency
        software motion video will be used.
        We recommend video playback at a resolution of 1024x768. With
        this resolution the hardware video acceleration can be used in
        any colormode with high refresh rates.

        In some cases/graphic-modes (ELSA WINNER 3000-S/-M/-L and
        ELSA VICTORY 3D) the hardware needs a minimum stretch factor
        (size of source image / size of video window) to work. In case
        of the actual stretch factor being less than the minimum factor
        software motion video will be used.

-----------------------------------------------------------------------

8.      Adjustments (CONFIG.SYS)

        By use of the SET command in the CONFIG.SYS you can adjust
        some behaviour of the driver.

8.1     SET ELSA_RESET=[H|L]

        Use this to reset the selected resolution to one of these:

        H = 1024x768x8@75Hz
        L =  640x480x8@60Hz

        This setting is valid as long as it appears in the CONFIG.SYS.

8.2     SET TIM=........
        This makes the video timing produced by WINMAN applicable to the
        WPS. The driver takes the TIM line prior to the mode setting done
        by the "ELSA Resolution Manager". However, it is lower in priority
        than the ELSA_RESET line.


8.3     SET USE_SMALL_FONTS=[0|1]

        To use the small icons in a high resolution mode.

        1 = small icons should be used in a high res mode
        0 = default icon size should be used.

        Hint: The usage of this flag may cause an incorrect display of
              the maximize window botton.

