                     Welcome to Graphic Vision 
                     -------------------------

Copyright (c) 1995,1996 Jason Burgon
All rights reserved
All rights not expressly licensed to the user are reserved to the developer.

Shareware version 1.01 (25:02:96)
Internet: gvision@jayman.demon.uk

TABLE OF CONTENTS
-----------------
  1. Overview
  2. Minimum system requirements
  3  Warranty
  4. Copyright
  5. Installation
  6. Graphic Vision, Borland and Borland Pascal
  7. Run-time library source code installation
  8. What you do and don't get it this shareware version
  9. Recompiling the Graphic Vision run-time-library
 10. Compiling the demo programs
 11. How to get help
 12. When the Demo program won't run
 13. Questionnaire
 14. Registration


1. OVERVIEW
===========

Graphic Vision is a graphical application framework modeled on Borland 
International's pascal version of Turbo Vision 2.0.  It has almost exactly 
the same functionality, user and programmer interface as Turbo Vision, but 
uses a 256 VGA or SVGA graphics screen for its visual output instead of TV's 
text-only screen.  

Graphic Vision (GV) is not "Turbo Vision on a graphics screen".  There would 
be little point in making Graphic Vision *look* like TV.  GV just *works* 
like TV.  GV's visual appearance is similar to that of OWL, though it's 
appearance can easily be altered for specialist applications, such as games, 
by simply re-writing or overriding some of the draw methods.

All existing Turbo Vision applications should convert to Graphic Vision,
most of them quite easily.  You can also use GV applications that you would
never have considered using TV for, such as games "front ends".  Like TV, 
Graphic Vision fully supports real and 16-bit DOS protected mode programs.  
Later versions will also support 32-bit DPMI if Borland ever get round to 
releasing a 32-bit DPMI Pascal compiler.

Graphic Vision uses its own (very fast) graphics engine (including mouse
cursor animation) which is VESA VBE compliant.  This allows Graphic Vision 
applications to use any screen resolution from 320x200 to 1600x1200 with 
almost every SVGA graphics card ever made. The mouse is fully supported in 
all GV compatible video modes, which can be up to 32 x 32 pixels in size 
when the target CPU is a 386 or better (16 x 32 on a 286).


2. MINIMUM SYSTEM REQUIREMENTS
==============================

DOS 3.0
286 processor
640K RAM (2MB for the DPMI version)
SVGA Graphics card capable of 640 x 480 x 256 colours
VESA BIOS or TSR conforming version 1.0 or higher (UniVESA driver supplied)
Hard Drive with at least 2MB free
Turbo Pascal for DOS (version 7.0)

Recomended System Requirements

DOS 6.2
Fast 386 processor or better
Microsoft compatible mouse (Version 8.0 or better)
SVGA video card with capable of 800 x 600 x 256 colours
VESA BIOS or TSR conforming version 1.0 or higher
Hard Drive with at least 10M free
Borland Pascal (version 7.0)

Graphic Vision only supports 256 colour VGA/SVGA video modes. I did think
about supporting other modes, but this is looking unlikely at the moment.


3. WARRANTY
===========

This product is provided "as is" without warranty of any kind.  The
entire risk as to the results and performance of the program is assumed by
you. Further more, I the author do not warrant, guarantee, or make any
representations regarding the use of, or the results of the use of the
program, and you rely on the program and results solely at your own risk.
I the author cannot accept responsibility for system damage, loss of profit,
or any other special, incidental, or consequential damages resulting from
the use or inability to use this product.  The author will however endevour
to remedy any bugs, omissions and other errors in this product.  Bug-fixed
updates will be made available to all registered users for media and
shipping costs only for a period of one year after registration.


4 COPYRIGHT
===========

In the following, SOFTWARE means the files provided on the data media or
in an electronic archive as a whole.

----------------
COPYRIGHT NOTICE
----------------

The SOFTWARE is neither public domain software, nor is it free software.
The software is the copyright of Jason G Burgon and is protected by United
Kingdom copyright law and international copyright treaty provisions. The software
that is the copyright of Jason G Burgon is subject to the terms and conditions as
set out below.

Copies of this shareware version of Graphic Vision and its documentation may
be freely distributed so long as no modifications are made, all files and
this notice are included and no charge is made.  Distribution with
commercial programs is strictly prohibited without specific written
permission. 

           THIS SOFTWARE IS PROVIDED FOR EVALUATION USE ONLY.

You may only use this shareware product for the sole purpose of
evaluating its suitability for your requirements.  The evaluation period
lasts for 30 (thirty) days, after which time you must either register or
licence Graphic Vision or stop using it and any programs containing any part
of this product.

Distribution of the source code is strictly prohibited.  You may not
distribute any of the source code in this product, either in whole or part
except as part of the unaltered and complete shareware package as detailed 
above.

This SOFTWARE is a software development tool and programs made under
usage of the SOFTWARE may not be distributed, whether for commercial or
non-commercial purpose, until you have registered or licensed the SOFTWARE.


By installing the SOFTWARE you are agreeing to the terms and conditions 
contained within this copyright notice. The shareware versions of the 
SOFTWARE are freely distributable providing the rules and conditions of 
distribution as documented in SHARWAR.DOC are not violated.


5. INSTALLATION
===============

This product comes with its own interactive installer/demo program which 
allows you to specify which parts of the product you want to install and the 
directories you want to put them into.  Not only that, the installation 
program is itself a Graphic Vision application, so you can have a look at
GV in action before deciding to install it!

INSTALL.EXE will make a temporary directory (\GV$) on your hard drive then 
copy all the files needed to run the demo/installer into it.  These files 
and the temporary directory it makes will be deleted when you exit the 
installer.

Installing from a download
--------------------------

Unzip all the files contained in GV4SVGA1.ZIP into a (empty) directory on 
your hard drive or onto a floppy disk. You can now follow the steps in the 
following section.

Installing from floppy disk
---------------------------

Run INSTALL.EXE that is on the distribution disk (eg A:INSTALL).  This 
program will check your machine is GV compatible, then copy and run the 
GV demonstation/installation program on your hard drive.  Choosing 
Options|Install will then display the install screen where you can choose 
the parts of this product you want to install and the directories you want 
to install them into.

See the WHEN THE DEMO WON'T RUN section if it won't.


6. GRAPHIC VISION, BORLAND AND BORLAND PASCAL.
==============================================

Graphic Vision was written for Pascal applications programmers using Borland 
or Turbo Pascal 7.0. It was written with Borland Pascal 7.0 and TASM 3.2.
Graphic Vision is not a Borland product, so please don't go ringing their 
hotline about it! See the HOW TO GET HELP section if you have problems.

I started writing GV about two years ago with just the Turbo Vision source
code that came with Turbo Vision 6.0 for guidance.  Since then I have
upgraded to Borland Pascal 7.0 which comes with their source code for all
the Turbo Vision units. I have, as a consequence, replaced much of my
original code with modified Turbo Vision source code.

The above has had two consequences:-

  1. Graphic Vision is more Turbo Vision compatible than it otherwise would
     have been.

  2. I cannot truly call Graphic Vision all my own work.

The second point means that I cannot ship complete copies of the source code
because Borland's lawyers would be on me like a ton-of-lawyers.  The
solution was simple:

What I provide you with in the registered and licenced versions are all the 
DIFFERENCES between the Turbo Vision source code and its Graphic Vision 
equivalent.  The GV installation program makes copies of your Borland run-
time-library source files and "patches" my code into them.  Hey presto, you 
have the Graphic Vision source code and I still have a shirt on my back.

This does mean you need the Borland RTL disk (supplied with Borland Pascal
with Objects 7.0) if you want the Graphic Vision source.  You can still
program in Graphic Vision using the supplied TPU's if you do not have
Borland's RTL disk. Note that some of the Turbo Vision RTL files are also
supplied with TP7.  The install program can also use these to recreate the
GV RTL source files.

Sorry, You don't get the source code for the graphics engine, but you do get
detailed information on how to write supplemental graphics functions when
you register.


7. RUN-TIME LIBRARY SOURCE CODE INSTALLATION (registered version only).
=======================================================================

You will need the Borland Pascal with Objects 7.0 run-time-library files
(exactly as extracted from the Borland RTL floppy disk) on your hard drive
if you want the Graphic Vision RTL source.  If you have made modifications 
to any file in the TV directory or to VALIDATE.PAS in the COMMON directory 
you will have to install the Borland RTL again.  You should specify a 
different base directory (eg C:\TEMP) if you do not want your modified 
Borland RTL files overwritten.  These files can then be deleted after GV has 
been installed. 

Note that the installation program assumes you have the same RTL directory 
structure as created by the BP7 RTL disk.  This means your Turbo Vision 
RTL source code files must be in the \TV sub-directory. ie, by default, the
installer is looking for the TV RTL source files in the C:\BP\RTL\TV 
directory and VALIDATE.PAS in C:\BP\RTL\COMMON.

Special Note
------------

There have been two versions of BP7 and TP7 released by Borland
International Inc.  There are 5 run-time-library files in BP7.00 (and
required by the Graphic Vision installation program) that were changed by
Borland in the 7.01 revision. The GV installer can automatically handle 
either version of 4 of these files, but you will need to manually patch the 
7.00 version of DIALOGS.PAS with the following patch, otherwise the GV installer 
will not be able to recreate GDIALOGS.PAS.  Please make sure you copy the 2 
patches exactly as they appear here, including the same white-space.


You can find out which version of Borland Pascal you have by looking at the 
time stamps of your RTL files. Version 7.00 files have a time stamp of 
07:00:00 while 7.01 files are stamped 07:01:00.

Just cut and paste the following 2 patches into DIALOGS.PAS if you are on 7.00. 
Be careful to keep the white-space the same.  This will bring DIALOGS.PAS upto 
7.01.


[-----------Change line 1058 of DIALOGS.PAS to this--------------]
      if AppendError(Validator) or not Validator^.Valid(Data^) then
[---------------------End of first patch-------------------------]



function TInputLine.Valid(Command: Word): Boolean;
[----Insert at 1039 including blank line at beginning and end----]

  function AppendError(Validator: PValidator): Boolean;
  begin
    AppendError := False;
    with Validator^ do
      if (Options and voOnAppend <> 0) and (CurPos <> Length(Data^))
          and not IsValidInput(Data^, True) then
      begin
        Error;
        AppendError := True;
      end;
  end;

[---------------------end of second patch------------------------]
begin

You can now run INSTALL.EXE and continue reading this file from there by
selecting File|Open from the menu bar.



8. WHAT YOU DO AND DON'T GET IN THE SHAREWARE VERSION.
======================================================

The shareware version of Graphic Vision is a full implementation with the 
following exceptions :-

   1. A message appears on the screen with annoying regularity when you run
      any Graphic Vision program.

   2. The very detailed documentation describing how to add additional 
      graphics primatives is not supplied. 

   3. Most of the run-time-library source code files are not included.  See
      SHAREWAR.DOC for a complete list.


9. RE-COMPILING THE GRAPHIC VISION RTL
======================================

The following two sections assume you have installed this package into the
default directories (as recommended by the installer program).

1  From the DOS prompt, change to the GV base directory (C:\BP\GV)
2  invoke BP.EXE by typing BP (BP.EXE must be in your DOS path).
3  The C:\BP\GV directory contains IDE startup files appropriate for
   re-compiling the Graphic Vision RTL files.
4  Use FILE:OPEN to open the BUILDGV.PAS file, and read what it says.
5  Set the Primaray file to BUILDGV.PAS
6  Select the appropriate platform (Real-mode or Protected-mode), then
   Re-build the RTL by selecting COMPILE|BUILD from the IDE menu bar.
7  All the GV run-time TPU's / TPP's have now been built and are residing
   in the C:\BP\GV\UNITS directory.  Make sure this directory is in your
   IDE's UNITS path when compiling a Graphic Vision unit or application.
   

10.  COMPILING THE DEMO PROGRAMS
================================

Copy BP.TP and/or TURBO.TP from \BP\GV into the DEMOS directory, but change 
the directories as appropriate.  Make sure that the GV units directory 
(which is C:\BP\GV\UNITS by default) is in the UNITS directory list.  

Change to the DEMOS directory and invoke BP.EXE.
Edit the OPTIONS|DIRECTORIES so that:

EXE and TPU directory is blank (ie put the EXE into the DEMOS directory)
UNIT Directories contains "..\UNITS;\BP\UNITS"

Set the primary file to GVDEMO.EXE and hit F9.  GVDEMO should then compile 
without error.  I'm sure you're capable of figuring out any problems you 
might have.  Let me know if you do get stuck or if the installer doesn't 
work properly.

I do not recommend using TPW when writing GV apps because it does not give
you access to the Graphic Vision IDE on-line help.

Please read the GV2TV.DOC (C:\BP\GV\DOCS) document. It gives helpful
tips on converting your Turbo Vision programs.


11. HOW TO GET HELP
===================

The GVISION.TPH file on the distribution disk is a Borland IDE compatible 
help file that documents all the differences between Turbo and Graphic 
Vision.  You should add this to the help file list in your Turbo or Borland
Pascal IDE (HELP|FILES).  You should also have TVISION.TPH in this list.
Any Graphic Vision method, procedure, variable, object, type or constant that 
is functionally the same as its Turbo Vision equivalent does not make an 
appearance in GVISION.TPH.  Having both the TV and GV help files in the help
files list allows you to determine if an identifier is the same as the TV 
equivalent, is new to GV or works differently to its TV equivalent:

(1)	If Ctrl-F1 takes you straight to a Turbo Vision help screen, the
	identifier has the same function in both GV and TV (eg TScroller).

(2)	If Ctrl-F1 takes you straight to a Graphic Vision help screen, the
	identifier is new to Graphic Vision (eg UnderLineXY).

(3)	If Ctrl-F1 takes you to the help index which is showing both a Turbo
	Vision and a Graphic Vision entry for the same topic then the 
	identifier has a different function, or works differently in GV than
	it does in TV (eg ScreenMode).  Note that some Graphic Vision 
	drawing functions have the same name as those in the Graph unit.

The Graphic Vision objects inheritance diagrams only provide hotlinks to 
the fields and methods that are new to GV, or work differently to their TV
equivalent.  This makes them easy to spot since they appear in a different
colour to the other fields and methods that are functionally equivalent to
the TV identifier of the same name.  You can get the help screen for these
by double-clicking on them.

If you have any problems with this product, please read this file, the 
documentation files, the online help file, the Turbo Vision 2.0 help file 
and the Borland Pascal manuals first. If you still have a question and need 
assistance you can contact me as follows:-

Jason Burgon
11 Thorsby Close
Brant Road
Lincoln
England. 
LN5 9DF

Internet: gvision@jayman.demon.uk

If you find a genuine bug (and document and isolate it enough for me to be 
able to reproduce it) I will send you a free copy of the registered version 
of Graphic Vision as soon as it becomes available.  When documenting bugs 
please tell me what machine you are using, the amount of memory it has, the 
video card in it and the contents of your AUTOEXEC.BAT and CONFIG.SYS files 
and whether you are running a DOS or DPMI application.   

I would prefer emails or a 3.5" floppy (straight ASCII or WRI format for 
documents please) to written documentation.  Please do not use <TAB> 
characters in your source files (Switch the "Use tab Characters" option off) 
because both BP and BPW are hopeless at printing a decent listing, and the 
way BP uses tab characters causes havoc with word processors.



12 WHEN THE DEMO WON'T RUN
==========================

INSTALL.EXE should run on any DOS machine ever built that has more memory
than the original ZX80.  You know it is running when you get the copyright
message.  

If INSTALL.EXE is OK it will produce a meaningfull error message if it is 
unable to run the demo/installation program.  Use this information to 
correct the problem and then try running INSTALL again.

Please note that the installation program proper is a Graphic Vision 
application, and as such it requires an SVGA video card and VESA Video Bios 
Extensions in order to run.  If you have an SVGA video card, but no VESA 
BIOS you can use the UNIVESA TSR on the distribution disk to provide them. 
Copy it into a sensible directory such as C:\DOS\DRIVERS and then add the 
following line in your AUTOEXEC.BAT file:

  C:\DOS\DRIVERS\UNIVESA.EXE

After you re-boot you can use VESAINFO.EXE (also on the distribution disk) 
to verify you now have VESA bios extensions.  Type "VESAINFO 101" to verify 
that your graphics card can support 640x480x256.  Just type "VESAINFO" for a
list of all VESA video modes your card supports.  Please note that I 
recommend using the VESA VBE (Version 1.2 or better) driver written for your 
specific video card in preference to the UniVesa driver if you can get it.  
Compuserve members might find a suitable driver in the VESA section of the 
PC Programming+ forum (GO VESA).  UniVesa is a FreeWare program written by
Kendall Bennett.  I do not recommend the UniVbe51 driver from SciTech 
software as it is not, in my opinion, a very good product.

Please contact me if you find problems with the installation program. I hate
shareware that doesn't install properly, and I should think you do as well,
so if there are bugs in the installer (and I am told about them) they will
be fixed.


13. QUESTIONNAIRE
=================

My aim is to provide a solid, modern application framework for the (largely
ignored) DOS and DPMI Pascal programmer. This is a shareware version of the 
product.  I need YOU to tell me what problems you found with it, what
you like and dislike about GV and what you think should be added/improved.  
I would be most grateful, therfore if, after evaluating this product you 
would fill in and return this questionnaire. This will allow me to produce 
the product you want.  Please note that I would prefer a half filled-in 
questionnaire to none at all.

Please fill in your name and postal or e-mail address if you want to be 
informed when the finished product is released.  I will send you details of 
the updated product.  Please be assured that your name and address will not 
be passed to ANY third parties.

  Name...............................................................

  Address............................................................
         ............................................................
         ............................................................
         ............................................................
  E-Mail Address.....................................................

  Q. Do you write programs for a living? (Yes/No)....................
  
  Q. If YES to the above, do you work in a team (Yes/No).............
  
  Q. What is your overall opinion of this product (poor, average, 
     good, very good)................................................
  
  Q. Will you register and use Graphic Vision........................
     If your answer is no, please tell me why you do not want to use
     it. If you are/will be using GV, please tell what type of 
     application(s) you are developing with it.
  





  Q. What type of computer are you using to develop GV applications
     on (please state processor type and speed)......................
     
  Q. What is the minimum computer system your applications are being
     written for (please state processor type and speed).............
  
  Q. Should the GV minimum specification be raised to a 386 to make
     it faster? (Yes/No).............................................
  
  Q. Have you previously written programs using Turbo Vision?........

  Q. Are you using Graphic Vision to convert existing Turbo Vision
     applications (Yes/No)...........................................
     
  Q. Are you/will you use Graphic Vision to write new applications?..
  
  Q. Is Turbo Vision compatability important? (Yes/No)...............
  
  Q. Will you still use Turbo Vision for some applications...........
  
  Q. If the answer to the above is YES, please tell me why (use as
     much space as you need)  





  Q. Would you use GV (more) if the finished product supported
     standard and SVGA 16 colour modes? (Yes/No).....................
     
  Q. Would you use GV (more) if it supported Herculese monochrome
     graphics modes (Yes/No).........................................
     
  Q. How difficult did you find it to learn Graphic Vision?
     (Hard, Fairly Hard, Average, Easy, Very Easy)................... 
  
  Q. What is your opinion of the help file that comes with the 
     product (poor, average, good, very good)........................
     
  Q. What is your opinion of the installation program?
     (poor, average, good, very good)................................
     
  Q. Is the Graphic Vision DPMI capability important to you .........
  
  Q. Will you develop 16-bit DPMI Graphic Vision applications?.......
  
  Q. Please tell me of any problems, ommissions or errors you found 
     with Graphic Vision (use as much space as you need).



  Q. What do you think would improve Graphic Vision the most? (use as much 
     space as you need).
  	   
 
 Thank you very much.


14. REGISTRATION
================

Registration of this product brings you the following benefits:

   The "Unregisterd Version" pop-up message is removed.

   Source code for all the following Graphic Vision units is supplied (you
   must have Borland Pascal 7.0 to be able to re-create the Graphic Vision
   source code files)...

   BITMAPS.PAS   GAPP.PAS     GCOLORS.PAS   GDIALOGS.PAS  GEDITORS.PAS
   GHISLIST.PAS  GMENUS.PAS   GMSGBOX.PAS   GSTDDLG.PAS   GTXTVIEW.PAS
   GVALIDAT.PAS  GVIEWS.PAS   GWINDOWS.PAS

   I will also do my best to answer any questions you have regarding the use 
   of this product (via Internet email).

   I will email all upgrades or post upgrades for the cost of shipping to
   registered users for the period of one year after registration. I will
   continue posting minor upgrades after the first year, until I make a
   make a major revision, which can be purchased at reduced cost.

   Your concience will be clear.  Graphic Vision has taken me many hundreds
   of hours to write.  It won't make me rich, but I do think I should see
   some reward for my considerable efforts.

There are two registration schemes available to reflect the different uses
to which this product may be put:-

Personal User Registration
--------------------------

    You may write, compile and use programs using any of the libraries,
    DLL's and other units in this package provided they are only used for
    your own personal use.  You may not distribute any programs that contain
    software from this or other material from the product.

Single Commercial User Licence
------------------------------

    If you are the commercially registered owner of this package AND you are
    the licenced, registered owner of the Borland language product you are
    using to compile it, you may use or give away or sell any program you
    write with this package in EXECTUABLE form only. Note that Borland
    Pascal units (.TPU and .TPP) files are not executable and they therefore
    cannot be distributed.  Please contact me for multi-user licenses.

    Graphic Vision mail REGISTRATION FORM

      Name   ____________________________________________

      Address ___________________________________________

      Address ___________________________________________

      Postal code/country   _____________________________

      Network (CompuServe,Internet,etc.) ________________

      Email address _____________________________________


      Registration Fees

           ____    US $40 or UKP 25 Personal user


           ____    US $200 or UKP 125 Single user Commercial


           ____    US $175 or UKP 110 Upgrade Personal to Single user
                   Commercial


Mail Address

   Jason Burgon
   11 Thorsby Close
   Brant Road
   Lincoln
   England.
   LN5 9DF

Internet Address

   gvision@jayman.demon.co.uk

---end---
       