home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 9 / 09.iso / l / l001 / 1.ddi / README < prev    next >
Encoding:
Text File  |  1989-05-31  |  9.2 KB  |  254 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 bythe
  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
  91. any questions, Borland or its users may be able to assist you via
  92. 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.     Yyou 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.BGI',@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.   README    COM -- Program to display README file
  183.  
  184.  
  185.   UNPACK    COM -- Utility used to unpack/de-archive .ARC files
  186.  
  187.  
  188.   BGIDRV    ARC -- Packed file that contains files to build custom
  189.            BGI drivers:
  190.  
  191.     BGI     DOC -- Documentation on how to create a BGI driver
  192.     BH        C    -- Source to program that writes the header
  193.            portion of the BGI device driver
  194.     BH        EXE -- Program that writes the header portion of
  195.            the BGI device driver
  196.     BUILD   BAT -- Batch file for building DEBUG.BGI
  197.     DEBDEMO C    -- Source for demo program using DEBUG.BGI
  198.     DEBDEMO EXE -- Program for testing DEBUG.BGI
  199.     DEBUG   BGI -- Sample BGI driver
  200.     DEBUG   C    -- Source to sample device driver (DEBUG.BGI)
  201.     DEBVECT ASM -- Defines the vector table for DEBUG.BGI
  202.     DEVICE  INC -- Defines important structures/macros for the
  203.            BGI driver interface
  204.     EXETOBIN EXE-- Borland's version of EXE2BIN.EXE
  205.     F_DEBUG OBJ -- Far Model Object code for DEBUG.BGI
  206.     MAKEFILE    -- Sample makefile for building DEBUG.BGI
  207.     N_DEBUG OBJ -- Near Model Object code for DEBUG.BGI
  208.  
  209.  
  210.   BGIFONT   ARC -- Packed file that contains the font editing
  211.            package:
  212.  
  213.     DFONT   C    -- Source to program that displays font
  214.            information
  215.     DFONT   EXE -- Program to display font information
  216.     FE        DOC -- Font Editor documentation
  217.     FE        EXE -- Font Editor
  218.     FONT    H    -- Header file for DFONT.C
  219.  
  220.  
  221.   FONTS     ARC -- Package file that contains a collection of
  222.            fonts:
  223.  
  224.     EURO    CHR -- EuroStyle font character set
  225.     GOTH    CHR -- Gothic font character set
  226.     LCOM    CHR -- Complex font character set
  227.     LITT    CHR -- Small font character set
  228.     SANS    CHR -- Sans serif font character set
  229.     SCRI    CHR -- Script font character set
  230.     SIMP    CHR -- Simple font character set
  231.     TRIP    CHR -- Triplex font character set
  232.     TSCR    CHR -- Triplex Script font character set
  233.  
  234.  
  235.   VGA256    ARC -- VGA256 driver and sample program
  236.  
  237.     HSI     PAS -- Source for sample Pascal program using
  238.            VGA256.BGI
  239.     VGADEMO PAS -- Modified version of BGIDEMO which uses the
  240.            VGA256.BGI driver
  241.     VGA256  BGI -- Sample driver for a VGA video card
  242.  
  243.  
  244.   HERC        ARC -- Hercules Monochrome and Incolor driver
  245.  
  246.     HERC    BGI -- Driver from Hercules Computer Technology for
  247.            the Monochrome and InColor graphic cards.
  248.     HERCBGI DOC -- Documentation file for Hercules driver
  249.     BGIDEMO C    -- C BGI demo program modified for Hercules
  250.     BGIDEMO PAS -- Pascal BGI demo program modified for Hercules
  251.  
  252.  
  253.   README    -- This file!
  254.