        #
        | README file for
        |
        | PCAD MD 6..8 SPEEDDraw (TM) driver, ver 2.05
        |
        |       WINNER 2000PRO/X
        |
        | Copyright (c) 1993-97 ELSA GmbH, Aachen (Germany)
        |
        |                                     Subsidary:
        | ELSA GmbH                           ELSA Inc.
        | Sonnenweg 11                        2150 Trade Zone Blvd.
        | D-52070 Aachen                      Suite 101
        | Germany                             San Jose, CA 95131
        |                                     USA
        |
        | Phone      : +49-241-606-0         Phone: +1-408-935-0350
        | Support Fax: +49-241-606-6399      Phone:  1-800-272-ELSA
        | BBS (modem): +49-241-606-9800      Fax  : +1-408-935-0370
        | BBS (ISDN) : +49-241-606-9820      BBS  : +1-408-935-0380
        | CompuServe : GO ELSA               CIS  : GO ELSA
        | WWW        : http://www.elsa.de    WWW  : http://www.elsa.com
        |
        | 04/08/97, ihensche


        Table of Contents:

        1.      Overview
        2.      Disk Contents
        3.      Installation
        4.      Notes
        5.      Release Notes
        6.      Caveats / Known Problems


**********************************************************************

1.      Overview

        Within file names we use the shortcut "brd" which will have
        the following meaning, depending on the ELSA graphic system:

          XHR - XHR Alpha/Spectra boards (Hitachi ACRTC)
          GMI - XHR Gemini boards        (TMS 340x0)
          WNR - WINNER 1024/1280 boards  (C&T)
          WIN - WINNER 1000/2000 boards  (S3)

        The disk contains the ELSA CAD Edition SPEEDdraw (TM) driver
	software for the P-CAD Master Designer Release 6.x/7.x for
	MS-DOS. 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 disk supersedes the
        printed documentation. Also information in file DELSAbrd.DOC
        supersedes the printed documentation.

1.1     More readme files

        The WINNER disks contain more readme files on various topics.
        Please locate these files in the ROOT directory of any disk as
        well as in the respective subdirectories.  The readme files in
        the disk's root will refer you to additional files on the disk.

        Following is a list of these readme files on the P-CAD
        SPEEDdraw driver disk:

                README            file you currently look at
                DELSAbrd.DOC      P-CAD driver documentation
                PTCARDS7.DOC      Readme file for PCCARDS V7.0
                                  patch program PTCARDS7.EXE


**********************************************************************

2.      Disk Contents

        The disk contains the following files:

        DATE.DOC        file identifying the disk, production date,
                        etc.

        README          the file you currently look at
        LIESMICH        German version of this README file

        DELSAbrd.DOC    English driver documentation
        DELSAbrd.DOK    German driver documentation

        DELSAbrd.REX    P-CAD SPEEDdraw driver for releases 6.x/7.x
        DELSAGMI.OUT    loadable P-CAD driver module for the TMS 340x0
                        processor on the Gemini (Gemini boards only)
        DELSAbrd.BAT    help program shows driver options on the DOS
                        text screen

        PCADELSA.BAT    sample batch file for setting the drivers
                        options, calling PCAD_EXE application shell
                        etc.
        PCADNET.BAT     sample batch file for setting the drivers
                        options and calling PCAD_EXE application shell
                        within network environment

        PCADbrd.SYS     Some information which should be inserted into
                        P-CAD's configuration file PCADDRV.SYS for
                        proper working of the ELSA driver with P-CAD

        PTCARDS7.DOC    Documentation of PCCARDS V7.0 patch program
        PTCARDS7.EXE    Patch program for P-CAD MD V7.0 PCCARDS.EXE
                        (10/11/93, 17:59:00, 1.489.332 bytes), which
                        decreases execution time of ELSA driver
                        features (solves "menu blinking" problem).
        UNPATCH.EXE     Revokes the patch of PTCARDS7.EXE


**********************************************************************

3.      Installation

        Please refer to the P-CAD driver manual for driver installation
        instructions. Please also check the DELSAbrd.DOC file on the
        disk for additional hints on installation.

**********************************************************************

4.      Notes

4.1.    The ELSA CAD Edition SPEEDdraw (TM) driver for P-CAD runs
        with releases >6.01. Release 6.00 does not support the
        display list and layer parts of the driver interface well
        and therefore does not run with the ELSA SPEEDdraw driver.

4.2.    The ELSA CAD Edition SPEEDdraw (TM) driver is a display list
        driver, which holds the whole drawing information in memory
        and therefore guarantees fast redraws on the screen. You can
        change screen viewports very fast and comfortable. With
        additional driver features like up to 20 layer sets and simple
        switching between them, additional driver menus for handling
        layer sets and changing viewports will increase productivity
        while working with P-CAD and the ELSA SPEEDdraw driver.
        Also additional hotkeys for that driver functions will make
        the P-CAD working much faster and more easy.

4.3.    P-CAD 7.0 user, who want to decrease execution time of the
        ELSA driver features may use the program PTCARDS7.EXE to
        patch PCCARDS.EXE. Reading of PTCARDS.DOC is strongly
        recommended to such users.


**********************************************************************

5.      Release Notes

5.1.    Release 1.12

        Bug with Gemini 644 / 118 and popup menus solved.

        Layerset handling changed (see DELSAbrd.DOC section d) 4.)
        Birds eye and layerset menu now will be aborted with only
        single click of middle mouse button or single hit of Esc key.

        Dynamic pan and zoom and the birds eye menu are now callable
        by a mouse button combination (see DELSAbrd.DOC section d) 3.)

5.2.    Release 1.13

        _ALT bug with line width is fixed

        _Pxy panning commands implemented now. Setting pan range with
        _PRG

        _ZI/_ZO zoom in/out commands implemented. Setting zoom scale
        with _ZSC

        the name of a layerset now will be changed only by calling the
        change layerset name icon. The active layer name will be set
        as default

        driver command line options are implemented now. They have to
        be set in PCADDRV.SYS following driver path and name (see
        DELSAbrd.DOC section c))

5.3.    Release 1.16

        _PLT ELSA plot command added. This call is the same as P-CAD's
        PLOT command but doesn't restore P-CAD's layerset before
        plotting. So it is possible to plot the drivers active
        layerset.

        while moving objects the new object will not be drawn with all
        layers (available in DL) but the visible ones. All layers are
        put into display list, so if you change the active layerset
        all drawing data will be correct.

5.4.    Release 1.17

        Bug in transparency mode fixed. Objects in older versions
        couldn't be deleted from screen if transparence mode was on.

5.5.    Release 1.21

        Hotkeys for pan and zoom functions (_p.. and _z..) disabled.
        P-CAD makes no differences between numeric keypad and the
        other numeric keys (1..0 left of backspace key). Other
        combinations with <Alt> or <Ctrl> key are used by DOS keyboard
        driver and P-CAD.

5.6.    Release 1.22

        Bug with incompatible BIOS versions in several 486 computers
        fixed. Hot keys will now work on that kind of computers.

5.7.    Release 1.23

        Bug in report generator (black background) fixed.

        Bug with color palette in PCADDRV.SYS fixed.

5.8.    Release 1.24

        The driver error output messages are redirected from stdout to
        the P-CAD prompt line on the graphics screen. The user has to
        acknowledge a driver error message by pressing left mouse
        button in canvas area or OK icon resp. by hitting the Enter
        key on the keyboard.

        The driver commands /_msz, /_prg and /_zsc now set the default
        or previous inserted values and show them on screen. By typing
        Return key only they will be unchanged. Typing a number
        removes the default value; with arrow keys and backspace key
        the default value may be edited.

5.9.    Release 1.25

        Bug with library manager (symbol editor, part editor) fixed.
        The symbol and part editors don't use the display list
        functions but P-CAD sets DL mode "drawing to screen and
        display list".
        Older ELSA drivers didn't draw such kind of drawing elements
        because the driver assumes a program error (which in fact is
        already existing). V1.25 draws the elements now, which works
        around the program error.

        Bug in layerset handling is fixed. Layers which are not
        visible in the active ELSA-Layerset, will not be drawn while
        editing objects.
        With older driver versions they won't be inserted in the
        display list too, so if you switch such a layer on and do a
        redraw parts of the drawing are missed. After doing a regen,
        they would be visible again.

        There's a new command line parameter for changing the I/O base
        address of the Gemini (see DELSAbrd.DOC section d - driver
        command line options).

5.10.   Release 1.26

        The driver options must no longer be inserted into the
        PCADDRV.SYS file. Now the driver will be configured by
        appending the driver options to the ELSADRV environment
        variable. This allows more flexibility when calling different
        P-CAD applications by batch files, setting ELSADRV to
        different values.

5.11.   Release 1.28

        Keyboard hotkeys for the drivers pan and zoom commands
        reimplemented.

        The name of the layerset no longer changes while changing the
        active layer.

        The default answer for confirming REGN command after adding
        new layer to the display list is "Y" (execute /REGN) now. So
        if you click the left mouse button, the regen will be done. To
        cancel it you have to type "N".

5.12.   Release 1.31

        New driver option "/LSM"  which assigns the layerset menu to
        the left mouse button instead of the birdeye menu. Users may
        spare time if they heavily make use of changing layersets
        because they won't have the birdseye redraw with every call.

        Highlight error when transparency is on is fixed (e.g.
        QRY/NET).

        The driver now works around a P-CAD bug where the editors want
        insert layers into display list while DL mode is "draw to
        screen only" during some EDIT commands. That bug caused the
        new edited wires visible in all layers, even the non visible
        ones.

5.13.   Release 1.32

        Transparency mode modified: if transparency is set on it will
        be active only in /REGN and /REDR commands and such commands
        which will cause a regen or redraw. With all other drawing,
        editing, moving or copying commands transparency is set off.
        There were some problems with highlighting so this change has
        to be done.

        With this driver moving the mouse to activate keyboard-mouse
        hotkeys is no longer needed. Also it's possible now to call
        birds eye or dynamic pan/zoom function with the keyboard mouse
        button combination if the drawing cursor is outside the canvas
        area (but this is furthermore not valid for pure keyboard
        hotkeys).

5.14.   Release 2.00

        The number of possible layerset is extended from 10 to 21 now.
        So it will be more easy to handle big data bases with a great
        number of layers. A single layerset now must not contain as
        much layers as with 1.xx drivers, which will enhance the
        clearness of the layout. For more information about the
        additional layersets and on what has changed refer
        DELSAbrd.DOC sections d)4 and 5.

        The outfit of the ELSA menus is modified: less colors in
        some areas, more information in birdseye menu, text is drawn
        more clear. The more information is the filling level of the
        display list memory in the birdseye menu, which will be shown
        not only as text but also as a bar.

5.15.   Release 2.02

        Display list has been optimized. Needs about 15% less memory.

        Bug with /NCR option fixed.

        Bug with ELSA menus (in some cases a horizontal bar was drawn
        over the whole screen) fixed.

5.16.   Release 2.03

        This release supports P-CAD MD V7. Former driver releases
        don't restore P-CADs layer set correct when the user calls
        the P-CAD VLYR screen (because of a program change in the
        new P-CAD 7.00 release).

        Layer On Top P-CAD bug workaround within driver.

        Bug with layerset handling and Level Push/Pop from PCARDS/PCCAPS
        fixed. Original P-CAD layerset will be restored after Level Pop.

        Bug with hotkey Alt-W (VWIN) fixed: switched off driver hotkeys
	if command would be aborted with ESC key.

        WINNER 1024/1280 and WINNER 1000/2000 only:
        New driver option /2NDBRD (second board). If the WINNER board
        is installed as second graphic board, which means the DIP switch
        on the board is set to "Second Board". Please refer the hints
        in the WINNER user manual about the usage of the WINNER as
        second graphic board, especially possible board combinations!

5.17.   Release 2.04

        Layerset handling with FILE/SAVE resp. autosave has changed:
        Til now you always have to switch back to the last used ELSA
        layer set after file save. Now the last used ELSA layer set
        will be restored automatically after file save.

        Little bug with roundlines is fixed now: in some circumstances
        some wires were drawn without roundlines. Now all are drawn
        with roundlines.

        Line width problem with XHR Alpha/Spectra, WINNER 1024/1280
        and WINNER 1000/2000 is fixed now: sometimes wires were drawn
        to thick. On screen wires seemed to be contacted, but when
        you'd plot the layout, they weren't.

        Problem with WINNER 1000/2000 as second board (WINNER 1000
        as VGA text console and WINNER 2000 as graphic device):
        DOS shell screen switching works correctly now.

        Several problems with display list or layer sets and
        P-CAD V7.0 are fixed now.

        Switching of layer set container after FILE/LOAD works
        correct now.

        Problems with layer sets in case of FILE/LEVEL PUSH or
        ../LEVEL POP command are fixed now.

        The ELSA Layer Set Menu now works in component and parts
        editors too. While using it, it overwrites the P-CAD layer
        set.

        Plotting from macros now also works when using the macro
        command "SET LTV <layername> <OFF|ON>" to switch layers
        on or off.

        There are two new driver command line options now:

        - /UDC (Use Driver Cursor)

          The original P-CAD cursor will be replaced by a driver
          cursor. Please notice the following issues:
          a) The driver cursor will be drawn in world coordinates,
             what makes it more exact than the P-CAD cursor. It's
             also faster, espescially the diagonal cursor.
          b) The cursor can be switched between three types with
             the 'X' key, which are:
             - small cross drawn with solid lines
             - large cross and snap box around cursor centre (size
               of visible grid) drawn with solid lines
             - 45 degrees diagonal large cross with snap box drawn
               with solid lines
          c) The driver cursor does not snap to the grid if SNAP GRID
             option is on, because the driver doesn't know anything
             about the grid state, except if grid is visible he gets
             the x/y grid distances.
          d) Special cursor types as shown in /ZIN or /ZOUT command
             are not available, because the driver gets no information
             about the cursor from the application.
          e) In case of OVERZOOM (world window smaller than screen
             window), which is possible with P-CAD editors, the driver
             cursor can't move to whole drawing area. But this should
             not make any trouble, because the visible drawing is not
             correct: every world coordinate represents more than one
             screen coordinate. With this 'feature' you can recognize
             overzoom state.
          f) Within P-CAD menu or status/command line area the original
             P-CAD cursor is drawn instead of the driver cursor.
          g) The driver cursor doesn't work with keyboard input
             (arrow keys). This case the application doesn't call
             the cursor position function of the driver interface.

        - /BG (Bold Grid)

          With this option the grid will be drawn bold

                         X
                       X X X        instead       X
                         X

          This makes the grid more visible at higher screen resolutions.
          It's not as fast as the normal grid.

        The driver now has some kind of "working ..." display, which
        will show the user invisible working of the editors. The
        characters "| /  - \" will be shown as a rotating bar.
        Only activities in conjunction with display driver commands are
        shown at bottom right edge of the graphics screen, such as
        regeneration or changing the display list.

        With this driver release you'll find the patch program
        PTCARDS7.EXE, which removes that function call from PCCARDS.EXE
        that shows the P-CAD menu inactive. Please read PTCARDS7.DOC
        file which includes information about PTCARDS7.EXE.

        Problems with driver semaphore file when running under
        network conditions is fixed:
         the driver now asks for "-SWAPDIR pathname" string in
        PCADDOSX environment variable. If this string is included,
        the driver uses "pathname" for semaphore directory now.
        If not ELSADRV variable will be used instead. So you no
        longer need the drivers on all local machines. The users
        must provide that every one is using another swap directory.

        Hotkey problem in symbol mode is fixed. Now the Alt-#
        hotkeys will work in Non-DL mode too to switch between
        ELSA layer sets (if the driver sees any layers).

5.18.   Release 2.05

        P-CAD MD V8.0 now is supported by the ELSA Display List
        Driver. Former driver releases have NOT been tested with
        P-CAD MD V8.0!

        Roundlines now will be drawn at arcs start and end position
        too.

        Fixed clipping bug with parts and components editor.

        Problem with WINNER 1000-ISA fixed: system no longer hangs
        during P-CAD startup.

        Workaround for overzoom problem (world window smaller than
        screen window or very deep zoom in) implemented. The drawing
        elements will be drawn correct now with this zoom scales.

        Revision 2.05.12: bug with PCI boards and '-2ndbrd' switch
        fixed. Better grid handling in case of 'overzoom'.


**********************************************************************

6.      Caveats / Known Problems

6.1.    General Problems

6.1.1.  Moving from P-CAD MD V4 or 5 to P-CAD MD V6..8:
        Some major changes within the P-CAD 6/7 display driver
        interface cause changes in the ELSA driver user interface:
        Now we have only two keyboard/mouse button hotkeys used
        by the driver.
        Also some keyboard hotkeys are moved to other keys. The driver
        now gets the key code without scan code value.
        Next big change is the ratsnest handling. P-CAD MD 6/7
        no longer includes any ratsnest driver commands. So the
        driver has no chance to do additional ratsnest handling.
        So we recommend P-CAD 4/5 users, moving to P-CAD 6/7,
        to study the drivers user manual very well to get knowledge
        about the changes between the MD V4/5 drivers and the MD V6/7
        ones.

6.1.2.  Unlike P-CAD MD V4/5 P-CAD 6/7 allows only two keyboard-
        mouse-button combinations used by the driver. They are
        <Alt><left mouse button> and <Alt><middle mouse button>.
        Also the use of these two hotkeys may cause problems in
        some circumstances: while editing or removing the drivers
        mouse hotkeys should be used very carefully, because P-CAD
        interpretes the hotkey as normal mouse commands and for
        example after leaving the birds eye menu it may be possible
        that P-CAD continues the work with selecting an object for
        drawing or removing. So we recommend not to use the drivers
        mouse hotkeys while editing or removing drawing objects.
        Use the keyboard hotkeys (<Alt><B>, <Alt><L> or <Alt><P>)
        instead.

6.2.    P-CAD MD V6.00 doesn't run with the ELSA SPEEDdraw driver

6.3.    With P-CAD MD V6.01 following problems are known:

6.3.1.  While deleting or moving objects some parts of the original
        object will not be deleted. This is fixed in P-CAD MD
        V6.02 release. After redraw the picture will be ok.

6.3.2.  While drawing objects like rectangles or circles they will be
        drawn bold or double when calling another command. This is
        also fixed P-CAD 6.02 release. Redraw will clean the picture.

6.4.    With P-CAD MD V6.02 following problems are known:

6.4.1.  While loading a drawing automatically via PCAD_EXE or command
        line option, the driver configuration will not be restored by
        the application. When loading it from the editors menu then
        everything's fine.

6.4.2.  The crosshair cursor is still drawn in screen coordinates,
        which causes a discrepancy between cursor and grid of about
        one or two pixels in some circumstances, because the grid is
        drawn in world coordinates. The driver is not able to work
        around this problem.

6.4.3.  There's a bug with histogramme function. If it was switched on
        one time and then switched off again, switch off the P-CAD
        side bar menu will not set the correct viewport to clip.
        The histogramme viewport is still used and that's why two menu
        bars remain on screen.

6.5.    With P-CAD MD V6.06 following problems are known:

6.5.1.  The cursor/grid problem described in section 6.3.2 is still
        active in release 6.06.

6.5.2.  The histogramme problem described in section 6.3.3 is still
        active in release 6.06.

6.5.3.  Release 6.06 software has a special feature showing the P-CAD
        menu beeing inactive which will be used in some circumstances
        especially for typing a P-CAD command via command line. This
        is exactly what the driver does while executing driver
        features, upto three times per command. This is why with
        P-CAD 6.06 the P-CAD menus are "blinking" when executing a
        driver feature. The blinking takes a lot of execution time,
        sometimes more than a redraw takes. Newer P-CAD 6.07 release
        does not have this "feature" any longer, so ELSA driver
        users should use this P-CAD release.

6.6.    With P-CAD MD V6.07 following problems are known:

6.6.1.  The cursor/grid problem described in section 6.3.2 is still
        active in release 6.07.

6.6.2.  The histogramme problem described in section 6.3.3 is still
        active in release 6.07.

6.6.3.  P-CAD 6.07 uses driver command gsp_layertop() to force
        active layer on top of drawing. With hardware display list
        drivers (Level 3 drivers) the gsp_draw() command will be
        called instead of gsp_layertop(). This causes unnessecary
        DL redraws. The driver catches theese and executes
	gsp_layertop() instead.

6.7.    With P-CAD MD V7.00 following problems are known:

6.7.1.  Release 7.00 software has a special feature showing the P-CAD
        menu beeing inactive which will be used in some circumstances
        especially for typing a P-CAD command via command line. This
        is exactly what the driver does while executing driver
        features, upto three times per command. This is why with
        P-CAD 6.06 the P-CAD menus are "blinking" when executing a
        driver feature. The blinking takes a lot of execution time,
        sometimes more than a redraw takes. We've had the same problem
        with the earlier P-CAD MD V6.06 release and it was fixed with
        MD V6.07.
        With this driver release you'll find the patch program
        PTCARDS7.EXE, which removes that function call from PCCARDS.EXE
        which shows the P-CAD menu inactive. Please read PTCARDS7.DOC
        file which includes information about PTCARDS7.EXE.
        P-CAD V7 has a bug with display list handling with drivers which
        have their own display list (level 3 drivers). In some circum-
        stances display list and P-CAD database become out of sync.
        F.e. when you call QRY/NET command and switch between ELSA
        layersets you'll get vias only in the visible layers of
        the current ELSA layer set when you select a net. A /REGN
        command will synchronize database and display list again.
        This problem will be fixed with P-CAD V8.

