home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / msdos / djgpp / contrib / libgrx / 1st_read.me next >
Encoding:
Text File  |  1992-08-12  |  8.8 KB  |  205 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.           Overview:
  10.  
  11.           This package contains a replacement graphics library for DJGPP,
  12.           named "LIBGRX". It supports EGA, VGA, 8514/A compatible, and S3
  13.           based PC graphics adapters in 16, 256, and 32768 color modes.
  14.           Support for mono EGA/VGA, Hercules (the "original" monochrome)
  15.           should be coming soon. The library supports (among other 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 library is distributed in the form of three archives:
  29.  
  30.              CBGRX102.ZIP   - the library files, sources, include files,
  31.                               drivers, documentation. For most users this
  32.                               archive should be sufficient.
  33.              CBGRD102.ZIP   - the WordPerfect (tm) documentation of the
  34.                               library formatted for HP LaserJet and
  35.                               PostScript printers. Download this file only
  36.                               if (1) you have one of the above printers,
  37.                               and (2) you have no other way of dealing with
  38.                               WP files.
  39.              CBGRF102.ZIP   - the full compliment of X11R4 fonts for
  40.                               LIBGRX. For most applications the subset
  41.                               included in CBGRX102.ZIP should be
  42.                               sufficient.
  43.  
  44.           The LIBGRX graphics library is copyright: (c) 1992 Csaba Biegl,
  45.           820 Stirrup Dr, Nashville, TN 37221. Additionally, some modules
  46.           were derived from DJGPP code copyright: (c) DJ Delorie, 24
  47.           Kirsten Ave, Rochester NH. 03867-2954. Most of the fonts included
  48.           with the library originate from the MIT X11R4 distribution.
  49.           Consult the appropriate copyright text (in the files
  50.           "copying.cb", "copying.dj", and "copying.mit", respectively) for
  51.           further information.
  52.  
  53.  
  54.           Installation:
  55.  
  56.           The library is distributed in the form of a 'ZIP' archive, it
  57.           should be unarchived (use the '-d' option) in the directory where
  58.           DJGPP was installed. This will place the files of the archive
  59.           into a directory tree created under 'CONTRIB/LIBGRX'.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.           The 'makefile' in the base directory can be used to install the
  68.           header and library files in the standard DJGPP include and
  69.           library directories by issuing the "make install" command. NOTE:
  70.           this will work only if you unarchived the package in the
  71.           directory where DJGPP is installed. Alternatively, you can use
  72.           the header and library files in their original location, but then
  73.           you have to supply 'gcc' with the proper include and library
  74.           paths.
  75.  
  76.           The same graphics driver you have been using for 256 color VGA
  77.           modes can be used with LIBGRX. This means that (at least for now)
  78.           you don't have to change your GO32 environment variable. The
  79.           documentation describes how to use (or create -- if you have an
  80.           unsupported card) the 16 color EGA/VGA drivers or the new,
  81.           programmable drivers. 
  82.  
  83.           There is one more environment variable which has to be set: the
  84.           directory where the fonts belonging to LIBGRX were installed. For
  85.           example: if you installed DJGPP in "c:\djgpp" and unarchived the
  86.           package in that directory, you would have to issue the command:
  87.  
  88.           SET GRXFONT=c:\djgpp\contrib\libgrx\fonts
  89.  
  90.           This completes the installation procedure. You can now rebuild
  91.           your application(s) with the LIBGRX library. The changes to
  92.           accomplish this are minimal:
  93.  
  94.            (1) Change the "#include <graphics.h>" and "#include <mouse.h>"
  95.                lines in your program to "#include <grx.h>" and "#include
  96.                <mousex.h>", respectively.
  97.  
  98.            (2) Link with "-lgrx" instead of "-lgr".
  99.  
  100.           Your program should work exactly the same as before. Consult the
  101.           documentation for the new features in the LIBGRX graphics
  102.           library.
  103.  
  104.           The LIBGRX graphics library can also be used in Turbo C programs.
  105.           The Turbo C library is not included in this distribution, but you
  106.           can build it by typing:
  107.  
  108.                make turboc
  109.  
  110.           in the directory where LIBGRX was installed. The Turbo C version
  111.           uses the environment variable ("GRXDRV") for specifying the
  112.           graphics driver, but the syntax is similar to the one used in
  113.           DJGPP. (NOTE: there is no need for the "driver" keyword!!)
  114.  
  115.               SET GRXDRV=<driver file> [gw <width>] [gh <height>] ...
  116.  
  117.           The Turbo C version supports only those resolutions which do not
  118.           require video RAM paging: 320x200 in 256 color mode, and up to
  119.           800x600 in 16 color modes.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.           Directories:
  128.  
  129.           Successful unarchiving of the package should create the following
  130.           directories under the base directory where LIBGRX was installed:
  131.  
  132.             DOCS:             documentation files. These are provided both
  133.                               in WordPerfect (tm) 5.1 and plain DOS text
  134.                               format.
  135.  
  136.             DRIVERS:          additional graphics drivers for DJGPP.
  137.  
  138.             EVENTS:           an interrupt-driven mouse and keyboard event
  139.                               queue library for both Turbo C and DJGPP.
  140.  
  141.             FONTS:            loadable bit-mapped fonts for LIBGRX.
  142.  
  143.             INCLUDE:          public (externally used functions, variables,
  144.                               etc..) include files.
  145.  
  146.             LIB:              pre-built libraries for DJGPP.
  147.  
  148.             SRC:              LIBGRX sources
  149.  
  150.             TEST:             test programs 
  151.  
  152.             UTILS:            utilities for displaying fonts, etc...
  153.  
  154.  
  155.           Documentation:
  156.  
  157.           Some of the documentation files (mostly the user's manuals) in
  158.           the DOCS directory were written using WordPerfect (tm) version
  159.           5.1. These files were formatted for HP Laserjet II (or better)
  160.           printers. The remaining files (mostly the ones describing the
  161.           internals of the library) are plain ASCII files.
  162.  
  163.              The original WP files have the extension ".WP5".
  164.              The ASCII document files have the extension ".DOC".
  165.  
  166.           The ".DOC" files for those documents where a ".WP5" file is also
  167.           present were generated by converting the WP file to DOS text file
  168.           format. No particular effort was made to try to align, break up
  169.           nicely, etc.. the resulting text. These files should give
  170.           acceptable printouts on 132 column printers, but they may have to
  171.           be formatted for 80 column printers.
  172.  
  173.           There is an additional archive named "cbgrd102.zip" which
  174.           contains the WP documents formatted for LaserJet (extension:
  175.           ".LJ2") or PostScript (extension: ".PS") printers. These files
  176.           have not been included in the basic distribution because of
  177.           archive size considerations. These files are suitable for
  178.           printing on any Laserjet II (or better) or PostScript printer
  179.           just by typing:
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.                COPY /B <file>.lj2 prn
  188.                       -- or --
  189.                COPY /B <file>.ps prn
  190.  
  191.           No font cartridges are needed for the LaserJet printers as the
  192.           ".LJ2" files already contain the necessary downloadable fonts.
  193.  
  194.           A brief overview of the contents of the documentation files
  195.           included in the 'DOCS' sub-directory:
  196.  
  197.               1ST_READ.WP5:   this file in WordPerfect (tm) format.
  198.  
  199.               DRIVERS.WP5:    guide to writing graphics drivers for
  200.                               unsupported adapters.
  201.  
  202.               EVENTS.WP5:     manual for the event queue library
  203.  
  204.               INTERNAL.DOC:   internal details of the library and
  205.                               recompiling instructions
  206.  
  207.               LIBGRX.WP5:     user's manual for the graphics library
  208.  
  209.               MISSING.DOC:    listing of features and functions not
  210.                               implemented in this beta release
  211.  
  212.               TESTS.DOC:      a brief description of the test programs
  213.