home *** CD-ROM | disk | FTP | other *** search
/ Sams Teach Yourself C in 21 Days (6th Edition) / STYC216E.ISO / mac / DJGPP / v2tk / grx23rme.1st < prev    next >
Text File  |  1998-06-03  |  4KB  |  121 lines
  1. GRX installation instructions
  2. =============================
  3.  
  4. Requirements:
  5. -------------
  6.  
  7.   The source files: grx23.zip
  8.   The fonts       : grx23fnt.zip
  9.   This document   : grx23rme.1st
  10.  
  11.   Currently GRX directly supports the following platforms:
  12.  
  13.      DOS     / DJGPP v1.12     (GCC 2.6.3)
  14.      DOS     / DJGPP v2.01     (GCC 2.6.3, 2.7.2 and 2.8.1)
  15.      DOS     / Borland C++     (v2.0, v3.1 and v4.52 checked)
  16.      DOS     / Turbo C         (v1.0)
  17.      DOS     / Watcom C++      (v11.0 checked, 32bit only)
  18.      Linux   / svgalib         (GCC 2.7.2, 2.8.1)
  19.      Linux   / X11R6           (GCC 2.7.2, 2.8.1)
  20.      Solaris / X11R5           (GCC 2.7.2, SUN cc v4.1)
  21.  
  22.   GRX should work on any X11R5 (or later) system after a few 
  23.   changes in makedefs.gnu and makedefs.x11
  24.  
  25.   Most makefiles (DJGPP and Unix systems) require GNU make
  26.  
  27.  
  28. A. Unzip the GRX archives
  29. -------------------------
  30.  
  31.   1) create a directory for the GRX file tree. Examples:
  32.        DJGPP: eg. DJGPP/contrib/grx23
  33.        Linux: /usr/src/grx-2.3
  34.   2) unzip the GRX source archive in the GRX dir:
  35.        DOS  : pkunzip -d grx23.zip
  36.        Unix : unzip grx23.zip 
  37.   3) unzip the GRX font archive in the same base dir:
  38.        DOS  : pkunzip -d grx2fnt.zip
  39.        Unix : unzip grx2fnt.zip
  40.  
  41.  
  42. B. Set the environment variables
  43. --------------------------------
  44.  
  45.   1) set the default driver and graphics mode info:
  46.        SET GRX20DRV=<driver> gw <width> gh <height> nc <colors>
  47.      (very useful but not required)
  48.      Available drivers are for
  49.        DOS  : stdvga, stdega, et4000, cl5426, mach64, ati28800, VESA,
  50.           memory
  51.        Linux: svgalib, memory
  52.        X11  : xwin, memory
  53.  
  54.   2) set the GRX font dir.
  55.        SET GRXFONT=<directory for the GRX fonts>
  56.      This is required for GRX graphics text output. Path: <GRX base>/fonts
  57.      NOTE: You can define a default font directory when compiling GRX.
  58.        E.g, if you installed the fonts in /usr/local/lib/grx/fonts add
  59.          CCOPT += -DGRX_DEFAULT_FONT_PATH="/usr/local/lib/grx/fonts"
  60.        to makedefs.gnu (Linux / GNU-make example)
  61.  
  62.  
  63. C. Compiling GRX
  64. ----------------
  65.  
  66.   This is only required if there's no pre-compiled GRX for your system
  67.   or you want to change GRX or the library configuration.
  68.  
  69.   1) Go to GRX base dir and check the makefile and makedefs file
  70.      for your system setup
  71.   2) Switch to src sub dir and check the makefile
  72.   3) run make -f <your makefile>
  73.      (some system may need additional arguments here !)
  74.   4) if every thing worked fine go to <GRX base>/test, check the makefile
  75.      and build all test files / examples:
  76.      make -f <your makefile>
  77.  
  78.  
  79. D. Testing GRX
  80. --------------
  81.  
  82.   1) go to <GRX base>/bin and run the modetest program. If you don't have
  83.      a modetest (or modtst16) binary, do step C4 first.
  84.   2) Build and run the other examples (see C4)
  85.  
  86.  
  87. E. Installing GRX for your compiler
  88. -----------------------------------
  89.  
  90.   You'll either need to 1: copy some GRX files to places where your compiler
  91.   will find them or 2: change your compiler setup so it will find the GRX
  92.   files in there default place.
  93.  
  94.   1) Copy the library from <GRX base>/lib/<your system> to the compiler
  95.      library directory.
  96.      Copy the header files from <GRX base>/include to your compiler include
  97.      directory
  98.   2) See compiler documentation. Either change the default compiler behaviour
  99.      (eg., change djgpp.env) or use command line switches to tell the
  100.      compiler where to find the GRX files.
  101.  
  102.  
  103. F. Problems
  104. -----------
  105.  
  106.   If you have problems installing or running GRX check
  107.  
  108.     http://www.techfak.uni-kiel.de/~hsc/GRX/
  109.  
  110.   for updates, pre-compiled libs, ...
  111.  
  112.   If this doesn't help, check your system/compiler FAQ (eg., the
  113.   DJGPP v2 FAQ is at http://www.delorie.com/djgpp/v2faq)
  114.  
  115.   Check out the DJGPP newsgroup comp.os.msdos.djgpp (archive at
  116.   http://www.delorie.com/djgpp/mail-archives)
  117.  
  118.   Send a problem report to comp.os.msdos.djgpp or me 
  119.   (hsc@techfak.uni-kiel.de)
  120.  
  121.