home *** CD-ROM | disk | FTP | other *** search
/ DOS Wares / doswares.zip / doswares / LANGUAGE / LEADTOOL / README.TXT < prev    next >
Encoding:
Text File  |  1994-09-22  |  9.5 KB  |  208 lines
  1. LEADTOOLS 4.0 for DOS 
  2. README File ver. 4.0a
  3.  
  4. by LEAD Technologies, Inc.
  5.  
  6. Last Update: 9/16/94
  7.  
  8. ===========================================================================
  9. INSTALLING LEADTOOLS 4.0 for DOS:
  10.  
  11. 1. Insert the LEADTOOLS disk into your floppy drive.
  12. 2. Type '(DRIVE):\INSTALL', without the quotes, where (DRIVE) is the letter
  13.    of the floppy drive.
  14. 3. Follow the directions during installation.
  15.  
  16. ===========================================================================
  17. Clarifications/Notices:
  18. Date: 9/20/94
  19.  
  20. 1. A TARGAP example has NOT been included in the examples subdirectory.
  21.    Code using TARGA+ cards can be found in DEMO.C in the main installation
  22.    directory.
  23.  
  24. 2. Due to BORLAND memory allocation methods, the function L_DecompressBuffer
  25.    has been disabled in the BORLAND library.  You can achieve similar
  26.    results as L_DecompressBuffer by using L_RedirectIO.  See the REDIRECT
  27.    example provided with this toolkit.
  28.  
  29. 3. The supplied DEMO.EXE was created using an overlay manager.  It should 
  30.    require less memory than a conventional executable.  The supplied demo
  31.    .MAK files will only generate a non-overlaid executable.  If your
  32.    application needs more memory, create an overlaid executable.  LEADTOOLS
  33.    is compiled to support overlaid executables.
  34. ===========================================================================
  35. FILES:
  36. Date: 9/11/94
  37.  
  38. Library Files
  39. (Names and descriptions of libraries included for various compilers)
  40. All LEAD toolkit libraries to be used with your applications can be found
  41. in the LIB subdirectory of the main installation directory.  All libraries
  42. are large memory model.
  43.  
  44.    (Professional Toolkit)
  45.    1. BCLSTP.LIB is the name of the BORLAND library.  It was created with the
  46.       Borland 3.1 command-line compiler and the MicroSoft MASM 6.0 Assembler.
  47.  
  48.    2. MSCLSTP.LIB is the name of the MicroSoft library.  It was created with
  49.       the MicroSoft 8.0 command-line compiler and the MicroSoft MASM 6.0
  50.       Assembler.
  51.  
  52.    (Express Toolkit - not yet released)
  53.    3. WCLSTP.LIB is the name of the WATCOM library.  It was created with
  54.       the WATCOM 10.0 command-line compiler and the MicroSoft MASM 6.0
  55.       Assembler.
  56.  
  57. Header Files
  58. (Names and descriptions of header files included with the toolkit)
  59. Two .H files are installed in the INCLUDE subdirectory of the main
  60. installation directory.  They are as follows:
  61.    1. L_BITMAP.H.  This file contains all of the LEAD Technologies defined
  62.       structures, all function prototypes, and most #define constants used
  63.       by LEADTOOLS.  This file MUST be included into any application
  64.       you are creating using LEADTOOLS functions and structures.
  65.  
  66.    2. L_ERROR.H.  This file contains additional #define constants used 
  67.       by LEADTOOLS as return values.  It will help you debug your code by
  68.       giving more descriptive information about the return codes.  It only
  69.       needs to be included in your application if you want to test return
  70.       values from LEADTOOLS functions using the 'ERROR_...' #defines. 
  71.  
  72. Demo Files
  73. (Names and descriptions of DEMO related files included with the toolkit)
  74. Several files make up the demo program provided with the LEAD Toolkit.
  75.  
  76.    1. DEMO.C, located in the main installation directory, is the source code
  77.       for the demo program.
  78.  
  79.    2. DEMO.H, located in the main installation directory, is the header file
  80.       with most prototypes, structures, variables, etc. used by the demo
  81.       program.
  82.  
  83.    3. L_BITMAP.H, located in the INCLUDE subdirectory of the main
  84.       installation directory, contains LEADTOOLS specific declarations.
  85.  
  86.    4. L_ERROR.H, located in the INCLUDE subdirectory of the main
  87.       installation directory, contains LEADTOOLS specific #defines.
  88.  
  89.    5. BCDEMO.MAK, located in the main installation directory, is a make
  90.       file to be used with the Borland COMMAND-LINE compiler.  All paths
  91.       are set to the default installation directories in this file to compile 
  92.       the provided demo program, DEMO.C (with the header file DEMO.H), and to 
  93.       link the created BCDEMO.OBJ with the Borland library to generate an 
  94.       executable BCDEMO.EXE.  If you move any of the above mentioned files,
  95.       this .MAK file will not likely work.  Make note of the -DEFINES used!  
  96.       (Type: 'Make BCDEMO.MAK' from the main installation directory)
  97.  
  98.      For the BORLAND 3.1 IDE, do the following:
  99.       A. Create a project IN THE MAIN INSTALLATION DIRECTORY.
  100.       B. Add the following files to the project:
  101.             DEMO.C - from the main installation directory.
  102.             BCLSTP.LIB - from the LIB subdirectory of the main installation
  103.                          directory.
  104.       C. Click on 'OPTIONS', 'APPLICATION...', and select either
  105.          DOS option.  Click on 'OK'.
  106.       D. Click on 'OPTIONS', 'COMPILER', 'CODE GENERATION'.  Select 'LARGE
  107.          MODEL', and type in the defines editing block,
  108.  
  109.                       'FOR_DOS;TP;FOR_BORLANDC;'
  110.  
  111.          WITHOUT THE QUOTES.  Click on 'OK'.  (LEADTOOLS will now work with
  112.          both WORD alignment and BYTE alignment.)
  113.       E. Click on 'OPTIONS', 'COMPILER', 'ENTRY/EXIT CODE', select either
  114.          DOS option, and 'C CALLING CONVENTION'.  Click on 'OK'.
  115.       F. Click on 'COMPILE', 'BUILD ALL'.
  116.       G. The executable will be generated in the main installation directory.
  117.       H. Exit to DOS and run the executable.
  118.  
  119.          ( If your compilation has difficulty finding files, make sure
  120.            the Borland INCLUDE and LIBRARY paths are set correctly. )
  121.  
  122.  
  123.      For the BORLAND 4.0 IDE, do the following:
  124.       A. Create a project IN THE MAIN INSTALLATION DIRECTORY.
  125.       B. During the create project, click on 'ADVANCED OPTIONS'.
  126.       C. Select '.c node', then click on 'OK'.
  127.       D. Click on 'PLATFORM', and select 'DOS STANDARD'.
  128.       E. Ensure that MODEL LARGE is selected, then click on 'OK'.
  129.       F. Add the following files to the main root of the project:
  130.             DEMO.C - from the main installation directory.
  131.             BCLSTP.LIB - from the LIB subdirectory of the main installation
  132.                          directory.
  133.       G. Click on 'OPTIONS', 'PROJECT', 'COMPILER', 'DEFINES'.
  134.       H. Type, in the defines editing block,
  135.  
  136.                       'FOR_DOS;TP;FOR_BORLANDC;'
  137.  
  138.          WITHOUT THE QUOTES.
  139.       I. Click on 'PROJECT', 'BUILD ALL'.
  140.       J. The executable will be generated in the main installation directory.
  141.       K. Exit to DOS and run the executable.
  142.  
  143.          ( If your compilation has difficulty finding files, make sure
  144.            the BORLAND include and library paths are set correctly. )
  145.  
  146.    6. MSDEMO.MAK, located in the main installation directory, is a make
  147.       file to be used with the MicroSoft COMMAND-LINE compiler.  All paths
  148.       are set to the default installation directories in this file to compile 
  149.       the provided demo program, DEMO.C (with the header file DEMO.H), and to 
  150.       link the created MSDEMO.OBJ with the MicroSoft library to generate an 
  151.       executable MSDEMO.EXE.  If you move any of the above mentioned files,
  152.       this .MAK file will not likely work.  Make note of the /DEFINES used!  
  153.       (Type: 'Nmake MSDEMO.MAK' from the main installation directory)
  154.       
  155. Example Files
  156. (Names and descriptions of example files included with the toolkit)
  157. Several files make up example programs provided with the LEAD Toolkit.
  158. There is an EXAMPLES subdirectory of the main installation directory.
  159. This directory contains specific example subdirectories and one .C file.
  160.  
  161.    1. XMPLMAIN.C, located in the EXAMPLES subdirectory of the main
  162.       installation directory, is the main source file used by all of
  163.       the examples.  It contains code that 'captures' the DOS text window,
  164.       calls the example registration function, calls the example function,
  165.       and 'restores' the DOS text window.  It should not be moved from this
  166.       directory if you want to be able to generate the example executables
  167.       without modifying any files.
  168.  
  169.    2. EXAMPLE SUBDIRECTORIES
  170.       Each subdirectory contains a .C file of the same name as the
  171.       subdirectory, and two .MAK files.  The .MAK files are named by using
  172.       up to the first 6 letters of the subdirectory name and then 'MS' or 
  173.       'BC', followed by the '.MAK'.  The ??????MS.MAK file can be used with
  174.       the MicroSoft command-line compiler to compile and link each example
  175.       FROM THAT SUBDIRECTORY.  The ??????BC.MAK file can be used with
  176.       the BORLAND command-line compiler to compile and link each example
  177.       FROM THAT SUBDIRECTORY.  All paths (for .LIB's, XMPLMAIN.C, and .H's)
  178.       are hard coded to the default installation directory in these .MAK 
  179.       files.  If you move the libraries, XMPLMAIN.C, or .H files, the .MAK 
  180.       files will not run correctly unless you edit them.
  181. ===========================================================================
  182. Hardware:
  183. (New graphics cards directly supported, not in the manual)
  184. Date:
  185.  
  186. 1. None.
  187. ===========================================================================
  188. Modified Structures:
  189. Date:
  190.  
  191. 1. None.
  192. ===========================================================================
  193. Modified Functions:
  194. Date:
  195.  
  196. 1. None.
  197. ===========================================================================
  198. New Structures:
  199. Date:
  200.  
  201. 1. None.
  202. ===========================================================================
  203. New Functions:
  204. Date:
  205.  
  206. 1. None.
  207. ===========================================================================
  208.