home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / tools / bgi_tool / readme < prev    next >
Text File  |  1989-05-30  |  10KB  |  248 lines
  1.  
  2.  
  3.              WELCOME TO THE BGI TOOLKIT VERSION 1.0
  4.              --------------------------------------
  5.  
  6.  
  7. TABLE OF CONTENTS
  8. -----------------
  9.   1. Introduction
  10.   2. Borland No-Nonsense License Statement!
  11.   3. Important Tips
  12.   4. File Listing
  13.  
  14.  
  15. 1. INTRODUCTION
  16. ---------------
  17.   The BGI Toolkit includes the following major features:
  18.     o a BGI Font Editor (FE.EXE) to use to develop your own fonts
  19.     o a set of fonts which include the full IBM character set
  20.     o a package for developing your own BGI device drivers
  21.     o a BGI driver for VGA 320x200 256 color mode
  22.     o a BGI driver for Hercules Monographics and InColor card
  23.  
  24.  
  25. 2. BORLAND NO-NONSENSE LICENSE STATEMENT!
  26. -----------------------------------------
  27. This software is protected by both United States copyright law
  28. and international treaty provisions. You must treat this software
  29. just like a book, except that you may copy it onto a computer to
  30. be used and you may make archival copies of the software for the
  31. sole purpose of backing up our software and protecting your
  32. investment from loss.
  33.  
  34. By saying "just like a book," Borland means, for example, that
  35. this software may be used by any number of people, and may be
  36. freely moved from one computer location to another, so long as
  37. there is no possibility of it being used at one location or on
  38. one computer while it is being used at another. Just like a book
  39. cannot be read by two different people in two different places at
  40. the same time, neither can the software be used by two different
  41. people in two different places at the same time (unless, of
  42. course, Borland's copyright is being violated).
  43.  
  44. The BGI Toolbox includes various support files that contain code
  45. routines, device drivers, and other encoded hardware and font
  46. information used by the runtime library of a Turbo Language
  47. compiler. You may use these proprietary Borland files with the
  48. programs you create with Turbo Language compilers for your own
  49. personal use. In addition, if the programs you write and compile
  50. using a Turbo Language compiler make use of these support files,
  51. you may distribute these support files in combination with these
  52. programs, provided you do not use, give away, or sell the support
  53. files separately, and all copies of your programs bear a valid
  54. copyright notice. By copyright notice, we mean either your own
  55. copyright notice or the statement "Created Using" followed by the
  56. name of the applicable Turbo Language compiler or the BGI Toolbox
  57. and Borland's copyright notice for the compiler or the BGI
  58. Toolbox.
  59.  
  60. This statement shall be construed, interpreted and governed by the
  61. laws of the State of California, and any action hereunder shall
  62. be brought only in California. Use, duplication or disclosure by
  63. the U.S. Government of the software and documentation shall be
  64. subject to restricted rights (under DFARS 52.227-7013) applicable
  65. to commercial computer software. All rights not specifically
  66. granted in this statement are reserved by Borland.
  67.  
  68. "AS IS" DISCLAIMER OF WARRANTIES
  69. --------------------------------
  70. Use of the software is at the user's risk and Borland is
  71. providing the Toolbox "AS IS." Borland specifically disclaims all
  72. warranties, express or implied, including but not limited to, any
  73. implied warranty of merchantability or fitness for particular
  74. purpose. Borland shall not be liable for any damages, including
  75. but not limited to, the loss of profit, data, or use of the
  76. software, or special, incidental or consequential damages or
  77. other similar claims, even if Borland has been specifically
  78. advised of the possibility of such damages. In no event will
  79. Borland's liability for any damages to you or any other person
  80. ever exceed the price you paid for this copy of the software,
  81. regardless of any form of the claim. Some states do not allow the
  82. exclusion of incidental or consequential damages, so some of the
  83. above may not apply to you.
  84.  
  85. Borland specifically disclaims all warranties and is unable to
  86. provide a limited warranty for this product.
  87.  
  88. NO TELEPHONE TECHNICAL SUPPORT AVAILABLE
  89. ----------------------------------------
  90. This software is not supported by Borland. Nevertheless, if you have
  91. any questions, Borland or its users may be able to assist you via
  92. an electronic bulletin board, such as Borland's special interest
  93. group on Compuserve (Borland SIG) or on the Borland Roundtable on
  94. GEnie (Borland RT).
  95.  
  96. The Hercules BGI driver and documentation was provided by
  97. Hercules Computer Technology.  Please confer with Hercules for
  98. more information about these files.
  99.  
  100.  
  101. 3. IMPORTANT TIPS
  102. -----------------
  103.   o Read FE.DOC for documentation on the font editor.
  104.   o If you plan to start a font from scratch, be sure to read
  105.     section 7 of FE.DOC.
  106.   o Read BGI.DOC for documentation on how to build a device driver.
  107.   o Font Editor (FE.EXE) requires:
  108.     - EGA (or VGA) with at least 128K video memory
  109.     - Microsoft-compatible Mouse
  110.   o Device Driver Builder's Kit (BGIDRV.ARC)
  111.     - Requirements:
  112.         Turbo C Version 2.0
  113.         TASM
  114.     - How to build demo driver DEBUG.BGI:
  115.       (1) Set paths to the directories in which TASM and Turbo C
  116.           reside, e.g.,
  117.  
  118.                PATH=C:\TC;C:\TASM;
  119.  
  120.       (2) Set up configuration file TURBOC.CFG.
  121.             Specify your INCLUDE and LIB directories in your
  122.             configuration file like this:
  123.  
  124.               -IC:\TC\INCLUDE
  125.               -LC:\TC\LIB
  126.  
  127.       (3) Modify TLINK statement in either MAKEFILE or BUILD.BAT.
  128.             If your TURBO C library is in directory C:\TC\LIB,
  129.             make sure the tlink statement is
  130.  
  131.                "tlink debvect+debug,debug,debug, C:\TC\LIB\cs /m/s;"
  132.  
  133.       (4) Type "BUILD" or "MAKE" to generate DEBUG.BGI.
  134.             BUILD.BAT is a batch file that builds DEBUG.BGI.
  135.             MAKE.EXE, a utility program on the Turbo C and
  136.             Turbo Pascal utility disks, reads the MAKEFILE
  137.             and makes DEBUG.BGI.
  138.  
  139.     - How to use the customized driver:
  140.         You cannot use RegisterBGIDriver to install your
  141.         customized driver; use InstallUserDriver instead.
  142.  
  143.         An autodetection function is passed to InstallUserDriver,
  144.         which returns the desired graphics mode.  Now if you use
  145.         autodetection with InitGraph, it will detect your custom
  146.         driver and the mode specified in the autodetection
  147.         function passed to InstallUserDriver.
  148.  
  149.         For example,
  150.  
  151.           {$F+}
  152.           function MyMode : integer;
  153.           {$F-}
  154.           begin
  155.             MyMode := 3;
  156.           end;
  157.  
  158.           begin
  159.  
  160.             ...
  161.  
  162.             GraphDriver := InstallUserDriver ('DEBUG',@MyMode);
  163.             GraphDriver := Detect;
  164.             InitGraph(GraphDriver,GraphMode,'');
  165.  
  166.             ...
  167.  
  168.           end.
  169.  
  170.         (For an example in C refer to DEBDEMO.C.)
  171.  
  172.  
  173.   o To run the demo programs in VGA256.ARC you need:
  174.     - VGA graphics card
  175.     - Turbo Pascal 5.0 (to run demo program)
  176.  
  177.  
  178.  
  179. 4. FILE LISTING
  180. ---------------
  181.  
  182.   BGIDRV    ARC -- Packed file that contains files to build custom
  183.                    BGI drivers:
  184.  
  185.     BGI     DOC -- Documentation on how to create a BGI driver
  186.     BH      C   -- Source to program that writes the header
  187.                    portion of the BGI device driver
  188.     BH      EXE -- Program that writes the header portion of
  189.                    the BGI device driver
  190.     BUILD   BAT -- Batch file for building DEBUG.BGI
  191.     DEBDEMO C   -- Source for demo program using DEBUG.BGI
  192.     DEBDEMO EXE -- Program for testing DEBUG.BGI
  193.     DEBUG   BGI -- Sample BGI driver
  194.     DEBUG   C   -- Source to sample device driver (DEBUG.BGI)
  195.     DEBVECT ASM -- Defines the vector table for DEBUG.BGI
  196.     DEVICE  INC -- Defines important structures/macros for the
  197.                    BGI driver interface
  198.     EXETOBIN EXE-- Borland's version of EXE2BIN.EXE
  199.     F_DEBUG OBJ -- Far Model Object code for DEBUG.BGI
  200.     MAKEFILE    -- Sample makefile for building DEBUG.BGI
  201.     N_DEBUG OBJ -- Near Model Object code for DEBUG.BGI
  202.  
  203.  
  204.   BGIFNT    ARC -- Packed file that contains the font editing
  205.                    package:
  206.  
  207.     DFONT   C   -- Source to program that displays font
  208.                    information
  209.     DFONT   EXE -- Program to display font information
  210.     FE      DOC -- Font Editor documentation
  211.     FE      EXE -- Font Editor
  212.     FONT    H   -- Header file for DFONT.C
  213.  
  214.  
  215.   FONTS     ARC -- Package file that contains a collection of
  216.                    fonts:
  217.  
  218.     EURO    CHR -- EuroStyle font character set
  219.     GOTH    CHR -- Gothic font character set
  220.     LCOM    CHR -- Complex font character set
  221.     LITT    CHR -- Small font character set
  222.     SANS    CHR -- Sans serif font character set
  223.     SCRI    CHR -- Script font character set
  224.     SIMP    CHR -- Simple font character set
  225.     TRIP    CHR -- Triplex font character set
  226.     TSCR    CHR -- Triplex Script font character set
  227.  
  228.  
  229.   VGA256    ARC -- VGA256 driver and sample program
  230.  
  231.     HSI     PAS -- Source for sample Pascal program using
  232.                    VGA256.BGI
  233.     VGADEMO PAS -- Modified version of BGIDEMO which uses the
  234.                    VGA256.BGI driver
  235.     VGA256  BGI -- Sample driver for a VGA video card
  236.  
  237.  
  238.   HERC      ARC -- Hercules Monochrome and Incolor driver
  239.  
  240.     HERC    BGI -- Driver from Hercules Computer Technology for
  241.                    the Monochrome and InColor graphic cards.
  242.     HERCBGI DOC -- Documentation file for Hercules driver
  243.     BGIDEMO C   -- C BGI demo program modified for Hercules
  244.     BGIDEMO PAS -- Pascal BGI demo program modified for Hercules
  245.  
  246.  
  247.   README        -- This file!
  248.