                     MetaWINDOW/286 4/32 Version 4.3D
                     --------------------------------

Contents:

1. GENERAL NOTES
2. MANUAL REVISIONS
3. FILE LIST
4. ACCELERATOR & HI-COLOR SUPPORT
5. SITE DEVELOPER KITS
6. MEWEL & ZAPP LIBS
 

1. GENERAL NOTES
----------------
Welcome to MetaWINDOW/286 4/32 Version 4.3D!  Please review this file for
last minute instructions that did not make the printed manuals.  If
you have any questions we're here to help.  You can contact
Metagraphics Technical Support by any of the the following means
(please be sure to note your MetaWINDOW/286 version and product serial
number with your inquiry):

Metagraphics Technical Support:

   1. FAX        -  408/438-5379
   2. BBS        -  408/438-5368
   3. Phone      -  408/438-6750 between 8:30am and 3:00pm Pacific Time
   4. CompuServe -  75300,3053 -or- GO METAGR
   5. Internet   -  75300.3053@CompuServe.COM

If you have any questions regarding update/upgrade pricing information, our
sales line is available 8:30am to 5:00pm - 800/332-1550 (408/438-1550).


2. MANUAL REVISIONS
-------------------
The following is a list of changes to be made to the manual, and
differences between the manual and the functionality of the software.

   1. No separate MetaWINDOW Reference Supplement:
      Chapter 2.1, "Software Installation", in the MetaWINDOW System and
      Library Reference manual makes reference to a separate MetaWINDOW
      Reference Supplement manual.  With the limited number of notes and
      changes in this release, a separate Reference Supplement manual
      was not needed.  All special notes and changes related to this
      release are documented in this README file.

   2. Section 5.3.1, Bitmap fonts:
      The default SYSTEM??.FNT bitmapped fonts are searched for in the
      current sub-directory, a directory listed in the current DOS path, or
      in a directory specified by the environment variable METAPATH.  Refer
      to the file list below for which font is loaded for a specific mode.

   3. StopGraphics:
      StopGraphics will call StopMouse and/or StopEvent if the program 
      neglected to.

   4. SetBitmap:
      This function missed being documented in the manual.  SetBitmap resets
      the passed grafMap's addressing to an alternate page.  The "page"
      argument may be either GrafPg0 or GrafPg1, and you may switch pages
      as often as you wish within your program.

              void SetBitmap( int PAGE, grafMap *BITMAP );

      Notice the difference between SetDisplay and SetBitmap. SetDisplay
      sets the graphics hardware to display the appropriate text or
      graphics page.  SetBitmap sets the software page selection for
      drawing operations.  This control allows you to display one graphics
      page while drawing into another.  An example of it's usage is
      "animation page flipping" between two pages in EGA (640x350 16 color)
      mode.  Program MW2PAGE.C provides a working sample showing how to use
      page flipping.

   5. ReadPalette/WritePalette:
      For speed, MetaWINDOW accesses the VGA analog palette directly. There
      may be some cases and or instances where this method is not
      compatible with certain video hardware.  For these circumstances, the
      alternative method is to access the palette through the BIOS, by
      specifying 1 (palette #) as the first argument in ReadPalette and/or
      WritePalette.  While this method is slower, it ensures hardware
      compatibility.

   6. METAPATH & MetaPath:
      The behavior of the METAPATH environment variable has been enhanced.

      In addition to its normal function of specifying where drivers and
      fonts are located, the first pathname in the METAPATH environment
      variable will also be used to control the location of disk based
      bitmap swap files. If it is not present, the files will be created in
      the current directory. The file names now have the format of
      METDSKxx.TMP where xx is a number from 00 to 99.

      The contents of the variable can be changed at run time with the new
      C function MetaPath( char * ), or Pascal procedure MetaPath( String ).
      This only changes MetaWINDOW's copy of the variable not the actual
      variable itself, since this is not really possible, even with
      putenv().


3. FILE LIST
------------
Here is the entire list of files that could be installed on to your
hard disk, depending on your choices during installation.  

Note - The installation program puts the installation report file
INSTALL.RPT on your hard disk. This file is only useful if there
were errors during installation.


Libraries:
      
 MET_XP2D LIB    Graphics Library for Phar Lap 286 
 MET_XR2D LIB    Graphics Library for Rational DOS/16M
 MET_XD1D LIB    Graphics Library for DOS Real Mode

Borland/Turbo Pascal Version 7:

 METAWIN1 TPP    MetaWINDOW Protected Mode Unit (1 of 2)
 METAWIN2 TPP    MetaWINDOW Protected Mode Unit (2 of 2)

Turbo Pascal Version 6 or 7:

 METAWIN1 TPU    MetaWINDOW Real Mode Unit (1 of 2)
 METAWIN2 TPU    MetaWINDOW Real Mode Unit (2 of 2)


The following are the associated device driver files used with the
MetaWINDOW/286 for either the DOS Real Mode, 286 Protected Mode
libraries, or the Turbo Pascal Units.  These driver files need to be
either in the current sub-directory, a directory listed in the
current DOS path, or in a directory specified by a METAPATH variable.

Protected Mode Drivers:

 METWND01 DRP    Monochrome device driver.
 METWND03 DRP    Multi-plane device driver.
 METWND04 DRP    EGA device driver.
 METWND05 DRP    VGA/SuperVGA device driver.
 METWND08 DRP    8 bit-per-pixel device driver.

Real Mode Drivers:

 METWND01 DRV    Monochrome device driver.
 METWND03 DRV    Multi-plane device driver.
 METWND04 DRV    EGA device driver.
 METWND05 DRV    VGA/SuperVGA device driver.
 METWND08 DRV    8 bit-per-pixel device driver.


Header files:

 METAWNDO H      The "master" MetaWINDOW include file that contains
                 the other MET*.H files and compiler defines.

 METPORTS H/INC  The defines and structure definitions for MetaWINDOW
 METFONTS H/INC  usage.  We suggest you print out these files for
 METEXTRN H/INC  reference. Be aware these defines change from
 METCONST H/INC  release to release.    

 HARDCOPY H/INC  Header file that contains printer records for Epson dot
                 matrix and HP Laserjet.

 METAVER3 H      Version 3 compatibility header file.


Fonts:

    Font Name     Display  Wdth x Ht        Adaptors
   ------------  --------  ---------  ----------------------------
   SYSTEM00.FNT   320x200    (5 x 8)    IBM EGA, Lo Res
   SYSTEM08.FNT   640x200    (8 x 8)    IBM CGA, Hi Res
   SYSTEM16.FNT   640x350   (8 x 13)    IBM EGA, std Res
   SYSTEM24.FNT   720x350   (9 x 13)    Hercules, AST, Tecmar monochrome
   SYSTEM32.FNT   640x400   (8 x 16)    AT&T, AT&T DEB, Sigma Color-400
   SYSTEM48.FNT  1280x400  (16 x 16)    Wyse WY-700
   SYSTEM56.FNT  1280x800  (16 x 32)    Wyse WY-700 
   SYSTEM64.FNT  1024x768  (12 x 30)    VGA "extended" and higher   
   SYSTEM72.FNT   640x480   (8 x 19)    IBM VGA, std Res
   SYSTEM96.FNT   800x600  (10 x 24)    VGA "extended" systems 

   EXTSYSxx.FNT  same as above, but contains the complete IBM extended
                 character set (Greek, foreign, etc.) with the exception
                 of the box/line drawing characters.

   SYSFNT??.FNT  System fonts for use the the GUI Source (Demo)
 
   Outline Fonts
   --------------------------------------------------------------------
   ROMANSIM.FNT  Roman Simplex
   ROMANTRI.FNT  Roman Triplex



Examples:

 GCL      BAT    Sample MetaWINDOW Graphics Compile and Link batch file

 MWAUTO   C      AutoTracking - Mouse-a-Sketch
 MWBAND   C      RasterOp - Rubber banding
 MWFONT   C/PAS  LoadFont/SetFont
 MWIMAGE  C/PAS  Read/Write Image
 MWPALETT C/PAS  ReadPalette/WritePalette
 MWPOLLED C      Polled Tracking - Mouse-a-Sketch
 MWPRINT  C/PAS  HardCopy
 MWREGION C/PAS  Regions
 MWSIMPLE C/PAS  MoveTo/LineTo
 MW2PAGE  C      SetBitmap/SetDisplay page flipping animation (EGA 640x350)

 METWORLD C/PAS  Chapter 2 - MetaWINDOW Hello World program.
 MWSTART1 C      Chapter 2 - Basic drawing functions example.
 MWSTART2 C      Chapter 2 - Basic query functions example.
 MWSTART3 C      Chapter 2 - Basic mouse functions example.
 MWSTART4 C      Chapter 2 - Basic event functions example.

 COLORPAL C      Illustrates the use of the functions ReadPalette and
                 WritePalette.

 DEMOPORT C      Illustrates the use of two ports simultaneously.

 HILBERT  C      A screenful of colorful lines and more.

 METQUERY C/PAS  MetaWINDOW dynamic hardware detection and automatic
                 configuration procedure.

 MULTIRES C      Illustrates how to switch between two display
                 adapters, or two modes on the same adapter.

 OFFMAP   C/PAS  Illustrates how to create local memory, EMS, XMS or
                 disk based offscreen bitmaps.

 PATTERN  C/PAS  Pretty patterns and colors.

 PRNTSCRN C      Illustrates how to "tie in" the Shift-Print-Screen
                 key into the MetaWINDOW event system to activate
                 the HardCopy function.

 TESTPRNT C      Illustrates the use of HardCopy.

 TESTTRAK C/PAS  Having problems?  This is a quick test program which
                 shows using EventQueue & auto-cursor tracking with
                 foreground/background processing.


Text Files:
 V3_TO_V4 DOC    Important information regarding upgrading from Version 3
                 to Version 4.

GUI Source Code:
 GUI*    *       C source code to our GUI.

ATI Graphics Ultra Pro:
 MW_ATIUP EXE    TSR that must be loaded if running in protected mode 
                 and using the ATI Graphics Ultra Pro graphics board.


4. ACCELERATOR AND HI-COLOR SUPPORT
-----------------------------------
MetaWINDOW 4.3 now uses dynamic load technology to link graphics device
drivers at runtime.  Dynamic load drivers help reduce code size by loading
only the display primitives for the graphics mode specified.  MetaWINDOW
dynamic link drivers can also add plug-and-play support for optional
display modes including accelerated graphics cards such as thes S3 based
Orchid Fahrenheit-1280, Diamond Stealth, Actix GraphicsEngine, IBM 8514 or
ATI Graphics Ultra.  Optional dynamic link drivers currently available
include:

     MetACCEL    supporting hardware accelerated 8514 and S3 based
                 graphics cards (boosts drawing speed 5-12 fold!), and

     MetHICOLOR  for 16-bit, 32K/64K-color SuperVGA imaging modes.

MetACCEL and MetHICOLOR may be purchased separately for a one time cost
(no royalties).  Please contact Metagraphics sales at 408/438-1550 or by
fax at 408/438-5379 for more information.


5.  SITE DEVELOPER KITS
-----------------------
As with most software products today (compilers, text editors,
spreadsheets, etc), a purchased copy of MetaWINDOW/286 is licensed for
use by an individual developer.  Commonly referred to as "just like a
book" copyright licensing, the software may be freely moved from one
computer to another and used by several people, so long as there is
NO POSSIBILITY of it being used by more than one person at a time.
("Just like a book" cannot be read by two different people in two
different places at the same time.)

Many of today's development projects require groups of programmers
working together in design teams.  To address the requirement for
design team or "site" use, we are now pleased to offer supplementary
MetaWINDOW/286 Site Developer Kits at specially reduced prices.

A Site Developer Kit provides an additional individual use license
for working with MetaWINDOW/286, along with a full set of MetaWINDOW/286
documentation and manuals and a supplementary developer registration
form.  The Site Kits do not contain the MetaWINDOW/286 program diskettes,
nor do they provide for Metagraphics technical support services (only
the original registered user of the MetaWINDOW/286 product is covered for
Metagraphics technical support). The original registered MetaWINDOW/286
user is responsible for acting as liaison for technical support to
Metagraphics, and is allowed to provide copies of the original
MetaWINDOW/286 software to other licensed Site Developers.

Additional Site Developer Kits are only available to registered
MetaWINDOW users, and only directly from Metagraphics.  Please
contact Metagraphics sales at 408/438-1550 or by fax at 408/438-5379
for ordering information.



6. MEWEL & ZAPP LIBS
--------------------
Magma Systems MEWEL and Inmark Development ZAPP tools use special
MetaWINDOW libraries to eliminate potential function name conflicts. 
(These libraries preface each MetaWINDOW function name with the characters
"mw".)  The MetaWINDOW files for use with Mewel and Zapp are included in
the file MW_MEWEL.FLD located on distribution disk 2.  Use UNFOLD to
extract the files, and then refer to the MW_MEWEL.DOC file.


*** END OF FILE ***

