home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / PROGRAM / CBGRX100.ZIP / CONTRIB / LIBGRX / 1ST_READ.DOC next >
Text File  |  1992-04-10  |  6KB  |  143 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.           Overview:
  9.  
  10.                This package contains a replacement graphics library for
  11.           DJGPP, named "LIBGRX". It supports EGA and VGA PC graphics
  12.           adapters in both 16 and 256 color modes. Support for mono
  13.           EGA/VGA, Hercules (the "original" monochrome) and 32768 color VGA
  14.           modes should be coming soon. The library supports (among other
  15.           things):
  16.  
  17.              - an unlimited number of graphics drawing areas (called
  18.                contexts) both in video and system RAM.
  19.              - adjustable clipping regions for contexts.
  20.              - a rich set of graphics primitives.
  21.              - a library of loadable bit-mapped fonts.
  22.              - user to screen coordinate transformations.
  23.  
  24.                The library is upward compatible with the original 256 color
  25.           DJGPP VGA graphics library. However, only the C functions are
  26.           supported, the 'GrRegion' C++ class is not included in LIBGRX.
  27.  
  28.                The LIBGRX graphics library is copyright: (c) 1992 Csaba
  29.           Biegl, 820 Stirrup Dr, Nashville, TN 37221. Additionally, some
  30.           modules were derived from DJGPP code copyright: (c) DJ Delorie,
  31.           24 Kirsten Ave, Rochester NH. 03867-2954. Consult the appropriate
  32.           copyright text (in the files "copying.cb" and "copying.dj",
  33.           respectively) for further information.
  34.  
  35.  
  36.           Installation:
  37.  
  38.                The library is distributed in the form of a 'ZIP' archive,
  39.           it should be unarchived (use the '-d' option) in the directory
  40.           where DJGPP was installed. This will place the files of the
  41.           archive into a directory tree created under 'CONTRIB/LIBGRX'.
  42.  
  43.                The 'makefile' in the base directory can be used to install
  44.           the header and library files in the standard DJGPP include and
  45.           library directories by issuing the "make install" command. NOTE:
  46.           this will work only if you unarchived the package in the
  47.           directory where DJGPP is installed. Alternatively, you can use
  48.           the header and library files in their original location, but then
  49.           you have to supply 'gcc' with the proper include and library
  50.           paths.
  51.  
  52.                The same graphics driver you have been using for 256 color
  53.           VGA modes can be used with LIBGRX. This means that (at least for
  54.           now) you don't have to change your GO32 environment variable. The
  55.           documentation describes how to use (or create -- if you have an
  56.           unsupported card) the 16 color EGA/VGA drivers or the new,
  57.           programmable drivers. 
  58.  
  59.                There is one more environment variable which has to be set:
  60.           the directory where the fonts belonging to LIBGRX were installed.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.           For example: if you installed DJGPP in "c:\djgpp" and unarchived
  67.           the package in that directory, you would have to issue the
  68.           command:
  69.  
  70.           SET GRXFONT=c:\djgpp\contrib\libgrx\fonts
  71.  
  72.                This completes the installation procedure. You can now
  73.           rebuild your application(s) with the LIBGRX library. The changes
  74.           to accomplish this are minimal:
  75.  
  76.            (1) Change the "#include <graphics.h>" and "#include <mouse.h>"
  77.                lines in your program to "#include <grx.h>" and "#include
  78.                <mousex.h>", respectively.
  79.  
  80.            (2) Link with "-lgrx" instead of "-lgr".
  81.  
  82.                Your program should work exactly the same as before. Consult
  83.           the documentation for the new features in the LIBGRX graphics
  84.           library.
  85.  
  86.  
  87.           Directories:
  88.  
  89.                Successful unarchiving of the package should create the
  90.           following directories under the base directory where LIBGRX was
  91.           installed:
  92.  
  93.             DOCS:             documentation files. These are provided both
  94.                               in WordPerfect (tm) 5.1 and plain DOS text
  95.                               format.
  96.  
  97.             DRIVERS:          additional graphics drivers for DJGPP.
  98.  
  99.             EVENTS:           an interrupt-driven mouse and keyboard event
  100.                               queue library for both Turbo C and DJGPP.
  101.  
  102.             FONTS:            loadable bit-mapped fonts for LIBGRX.
  103.  
  104.             INCLUDE:          public (externally used functions, variables,
  105.                               etc..) include files.
  106.  
  107.             LIB:              pre-built libraries for DJGPP.
  108.  
  109.             SRC:              LIBGRX sources
  110.  
  111.             TEST:             test programs 
  112.  
  113.             UTILS:            utilities for converting fonts, etc...
  114.  
  115.  
  116.           Documentation:
  117.  
  118.                This is a brief overview of the contents of the
  119.           documentation files included in the 'DOCS' sub-directory:
  120.  
  121.  
  122.  
  123.  
  124.  
  125.             1ST_READ.WP5:     this file in WordPerfect (tm) format.
  126.  
  127.             DRIVERS.DOC
  128.             DRIVERS.WP5:      guide to writing graphics drivers for
  129.                               unsupported adapters.
  130.  
  131.             EVENTS.DOC
  132.             EVENTS.WP5:       manual for the event queue library
  133.  
  134.             INTERNAL.DOC
  135.             INTERNAL.WP5:     internal details of the library and
  136.                               rebuilding instructions
  137.  
  138.             LIBGRX.DOC
  139.             LIBGRX.WP5:       user's manual for the graphics library
  140.  
  141.             MISSING.DOC
  142.             MISSING.WP5:      listing of features and functions not
  143.                               implemented in this first beta release