        #
        | README file for
        |
        | ELSA OS/2 WARP Version 3 and 4 driver version 01.20
        |
        |       ELSA DIPLomat
        |
        | Copyright (c) 1994-97 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
        | Taipeo 105
        | Taiwan, R. O. C.
        |
        | 12/03/97, IHensche


        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 3 and 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
        ELSADIP.DSC     configuration files
        ELSADIP.DSP     --------- " --------
        SVGADATA.PMI    --------- " --------

        WINDOWS         WINOS2 device driver
        VIDEOMM         OS/2 device driver for the ELSA graphics board
        SCREEN01.SYS    physical device driver (PDD)
        DIP.DLL         ELSA DIPLomat driver library
        DIPMAN.EXE      ELSA DIPLomat Tool
        DIPMAN_D.HLP    ELSA DIPLomat Tool help file (German)
        DIPMAN_E.HLP    ELSA DIPLomat Tool help file (English)
        FILTER.EXE      ELSA EnDIVE Filter Set utility
        WINNER          WINNER configuration file
        WINMAN.MON      WINman monitor file

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

3.      Installation

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

        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.20:

        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.
        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.

        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.

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

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.

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

        2. delete the files

            - WINNERMM.DLL       (bootdrive:\os2\dll)
            - WS3ACCEL.DLL       (bootdrive:\os2\dll)
            - WS3INIT.DLL        (bootdrive:\os2\dll)
            - BVHSVGA.DLL        (bootdrive:\os2\dll)
            - DIP.DLL            (bootdrive:\os2\dll)
            - WINNER.PMI         (bootdrive:\os2)

              example: DEL C:\OS2\DLL\WINNERMM.DLL
                       DEL C:\OS2\DLL\BVHSVGA.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.

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

5.      Release Notes

        VERSION 1.06.11

          - ELSA VICTORY 3D

        VERSION 1.10

          - truecolor and EnDIVE support

        VERSION 1.11

          - ELSA WINNER 3000 boards
          - bug fix for ColorWorks (24bpp mode)

        VERSION 1.12

          - Treatment of Codepages in conjunction with Bitmap fonts fixed
          - ELSA VICTORY 3D: treatment of the GREYFLAG corrected

        VERSION 1.13

          - Support for VL-Bus boards
          - ELSA WINNER 1000PRO Trap D fixed
          - ELSA WINNER 1000AVI/VL testscreen fixed
          - Y filter (EnDIVE) for ELSA WINNER 3000 boards

        VERSION 1.14

          - clipping in an AVI window fixed
          - Y filter (EnDIVE) for ELSA WINNER 3000 boards fixed
          - ELSA WINNER 3000, ELSA WINNER 2000AVI/3D, ELSA VICTORY 3D:
             sys3175 in progman.exe or system hangs while using a
             software cursor fixed.
             system hangs after opening or closing an AVI file fixed

        VERSION 1.15

          - ELSA WINNER 1000/T2D
          - ELSA VICTORY 3DX
          - adjustments for ELSAmotion MPEG Playback
          - adjustments for Videoplayback and FixPak 26
          - limited the EnDIVE support (ELSA WINNER 3000 and
             ELSA VICTORY) to screen resolutions with a MClock
             less then 135MHz to match the S3 specs for the stream
             processor

        VERSION 1.16

          - "EnDIVESet" (filter.exe) comes up with an error message box
              if the EnDIVE support is disabled by the hardware
          - adjustments for the ELSA WINNER 3000-M/-L in conjunction
             with the ELSAmotion MPEG-Playback
          - ELSA WINNER 2000AVI/3D:
             sys3175 when using a host application which uses extended
             attributes fixed.
          - ELSA WINNER 1000TRIO/V:
             bug fix for background of left window border
             improved stability of the testscreen
          - bug fix for bitmaps in JAVA applets
          - systems hangs by PentiumPro and MMX fixed
          - improved EnDIVE by low offscreen memory

        VERSION 1.17

          - ELSA VICTORY 3DX: Full screen switches and Testscreen fixed
          - controller hangs with some 1bpp bitblits fixed
          - palette-mapping adjusted to match the system gray to get
             a better performance while running in 8bpp mode

        VERSION 1.18

          - corrected line drawing (ViRGE based boards)
          - improved EnDIVE support for the ViRGE based graphics boards
          - the TIM line is now supported. This is done by adding the
             following line into the config.sys:
              SET TIM=..... (like it is produced by WINMAN (see 8.5))
          - ELSA VICTORY 3D: defect icons after removing the overlaying
              window fixed
              fixed video flickers at 1024X768X24
          - fixed enabling Y-filter. (see 7.1.1)
          - support XREFRESH in config.sys (see 8.6)
          - fixed system hangs in 32bpp mode
          - ELSA WINNER 1000TRIO: fixed wrong colors in a true color
             mode while playing videos

        VERSION 1.19

          - fixed selection tool by IMPOS.
          - prevent videos from painting in WIN-OS/2 full screen
            sessions.
          - ELSA WINNER 1000TRIO: corrected videos painting in other
              windows
          - ELSA WINNER 1000TRIO/V: fixed reduced video flickers

        VERSION 1.20

         -  fixed problems with EnDive and WARP 4 with fixpack 3
         -  corrected usage of TIM line
         -  fixed system hangs with texts at negative destinations

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

6.      Caveats / Known Problems

6.1     WINOS2

        With some monitors, you can't use a refresh rate different
        from that of the WPS. In this case you will see a black screen
        (or something else) in the WINOS2 Session.

        ELSA graphics WINOS2 and Seamless Driver:
        Use only the WINNERxx.DRV OS/2-Driver Disk. These files are
        copied by the installation utility.

6.2     Lotus 1-2-3 f. OS/2 Vers. 2.0
        Lotus 1-2-3 only runs in 8 BPP modes.

6.3     Software and Color Cursor

        For the following configuration no software cursor is
        available:

        2 MB Video RAM:
           1600 x 1280 x 8 BPP
        Work around:
           Use the resolution 1600 x 1200 x 8 BPP

        4 MB Video RAM:
           1600 x 1280 x 16 BPP
        Work around:
           Use the resolution 1600 x 1200 x 16 BPP

        8 MB Video RAM:
           1600 x 1280 x 32 BPP
        Work around:
           Use the resolution 1600 x 1200 x 32 BPP

6.4     DIPLomat

        The gray-scaling acceleration and filter functionality
        are only supported under the following color depths:
          - 8 BPP
          - 16 BPP

        When switching to any other color depth, a warning message
        is displayed telling you that these functions are not
        supported.
        Other aspects of the driver functionality are not affected.

        IBM VisualInfo Viewer for OS/2:
        The viewer uses its own drawing routines if none of the above
        color depths are active. In this case however, you cannot use
        the benefits of the DIPLomat software.

        The DIPLomat software's filter and acceleration functionality
        is only used when displaying monochrome images (1 bit/pixel),
        also called bilevel images. Color and grayscale images are
        displayed by the viewer itself.
        The bilevel file formats supported by the viewer are e.g.:
           - TIFF G4                (.TIF)
           - TIFF G3                   "
           - TIFF uncompressed         "
           - PCX bilevel            (.PCX)
           - OS/2 bitmap bilevel    (.BMP)

        Functionality and operation of the DIPman program are
        explained in the online help.

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

7.      EnDIVE

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


        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.2     Common restrictions of the EnDIVE support

        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.

7.3     To use the hardware support of the DIVE interface, you must
        have 64MB of address space available in your system. This is
        determined and configured by the driver.  A failure will occur
        if any of the following conditions holds:

           a) PCI BUS computer:
                - more than 4031MB of address space used already
                  unlikely.
                  fix: none available
                - older system BIOS (non PCI-conforming)
                  fix: place the following line into your CONFIG.SYS:
                       SET VIDEO_APERTURE=A00
                  This allocates the 64MB Video aperture at 2,5GB in
                  your address space. Be sure this does not conflict
                  with address space requirements of other cards you
                  use.
           b) V L Bus computer:
                - more than 64MB of main memory
                  fix: none available
                - BIOS assigned an invalid address
                  fix: add the following line to your CONFIG.SYS:
                        SET VIDEO_APERTURE=40
                  This assigns addresses following the first 64MB to
                  your video board.

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

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 VIDEO_APERTURE=xxx

        see 7.3

8.2     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.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 causes an incorrect display of
        the maximize window botton.


8.4     SET USE_FIXPAK17=[0|1] (only to use in conjunction with Warp 3.x)

        Use this setting to avoid defective icons on a system with a
        fixpak 17 and in a true colour mode.

        1 = fixpak 17 installed
        0 = no fixpak 17

8.5     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.6     SET XREFRESH=H
        This forces OS/2 and DOS Full Screen Sessions into VGA high-refresh
        text mode. It has the same effect as the DOS-Tool XFREFRESH.EXE.

        This setting is only valid with the following graphics boards:
         - ELSA WINNER 2000AVI/3D
         - ELSA WINNER 3000-M/-L
