home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c011 / 1.ddi / READ.ME2 < prev   
Encoding:
Text File  |  1989-06-01  |  5.3 KB  |  137 lines
  1.  
  2.                                                      Genus Microprogramming
  3.                                                      May 1, 1989
  4.  
  5.  
  6.                             ╒═════════════════╕
  7.                             │ PCX Effects 1.0 │
  8.                             ╘═════════════════╛
  9.  
  10.  
  11.     Thank you for purchasing the source code PCX Effects, version 1.0.
  12.     As always, it is well commented, and if you are familiar with Assembly
  13.     Language, it is very structured.
  14.  
  15.     This file contains current information concerning software changes or
  16.     additions to the toolkit source.  Please read through them carefully,
  17.     since many of them are important.
  18.  
  19.     We appreciate your support, and hope that the source code will be of 
  20.     great use to you.  It represents many hours of work, and contains 
  21.     over 10,000 lines of programming. If it saves you two hours worth of
  22.     work, the purchase of the source code will have paid for itself.
  23.  
  24.     Welcome to the growing number of Genus Microprogrammer's!
  25.  
  26.       The Genus Staff
  27.  
  28.  
  29. ▒▒▒ 05/01/89 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  30.  
  31. ─────────────────────
  32. Assembling the Source
  33. ─────────────────────
  34.  
  35. (1) Assembling
  36.  
  37.     This disk contains all of the source for the PCX Effects
  38.     library interfaces.  Almost all of the source is in assembler, so 
  39.     Microsoft Macro Assembler 5.0 (or higher) is suggested for assembly (or
  40.     a 100% compatible assembler).
  41.  
  42.     A batch file and make file is also included, that will define the 
  43.     necessary parameters for each interface.  The directory structure is
  44.     outlined in the batch file, so be sure to look it over.  The files of 
  45.     interest are:
  46.  
  47.                   fxMake .BAT     <-- Batch file for assembly
  48.                   fxLib           <-- Actual make file
  49.  
  50.     Note that Turbo Pascal 4.x/5.x is also required, for generating the 
  51.     Turbo Pascal unit pcx_TP.TPU.
  52.  
  53.     We feel the source code is very well documented, so if you know assembly
  54.     language you should not have a problem.  Also understand that once you
  55.     start modifying the routines, support from us will be limited.  We
  56.     suggest that you try to regenerate the library you are interested in
  57.     FIRST, BEFORE MAKING ANY CHANGES.  When you are successful, then start
  58.     modifying the library.
  59.  
  60. (2) Paths and Directories
  61.  
  62.     Of course, make files will have to be modified to fit your particular
  63.     environment.  Changes are kept to a minimum, since all compilers and
  64.     assemblers use macro definitions.  'Include file' paths may need to be
  65.     changed also.  The development directory structure looks like this:
  66.  
  67.           c:\fx10\inc      <-- assembler includes
  68.           c:\fx10\asm      <-- assembler source, make and link files
  69.           c:\fx10\asm\cs   <-- target directory for fx*.obj and fx_cs.lib
  70.           c:\fx10\asm\cm   <-- target directory for fx*.obj and fx_cm.lib
  71.           etc ...
  72.  
  73. (3) IMPORTANT:  Software License
  74.  
  75.     Remember, you have licensed these routines for your own personal use, and
  76.     no part of this package may be distributed in it's present or modified 
  77.     form. You may modify the software and merge it into another program for
  78.     your use on a single computer.  Read the License Agreement provided with
  79.     your manual, or call us if you have questions about your particular 
  80.     application.
  81.  
  82.     This also means that you CANNOT incorporate the toolkit functions into
  83.     another toolkit or function library. You may integrate the effects 
  84.     into your standalone application program.
  85.  
  86.     These routines represent many, many hours of work -- by purchasing them
  87.     we know you have saved alot of your time.  Please do not waste our effort
  88.     by making illegal copies.  This software is not copy protected for YOUR
  89.     convenience.
  90.  
  91. ─────────
  92. Debugging
  93. ─────────
  94.  
  95. (1) Use the fxShow and the fxPlay utilities for verifying whether your 
  96.     functions or your program is working as expected. If your program does
  97.     not display correctly, inspect the header.  After that, display with 
  98.     'fxShow' to get an idea of how the image should be interpreted.
  99.  
  100. (2) If using a debugger like CodeView, be sure to enable the /ZI flag in
  101.     the 'fxLib' make file. This will allow you to step through the 
  102.     library code.
  103.  
  104. (3) For resident debuggers like IBM's RDT, use the @Debug macro to generate
  105.     and INT 3 from within the toolkit code.
  106.  
  107. ─────────────
  108. Miscellaneous
  109. ─────────────
  110.  
  111. (1) Note that the source (at this time) is distributed on a SINGLE floppy
  112.     disk. The manual may mention a SOURCE 2 disk, but this was done to 
  113.     allow for expansion.
  114.  
  115.  
  116. ▒▒▒ 06/01/89 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  117.  
  118. ────────────
  119. Version 1.01
  120. ────────────
  121.  
  122. (1) fxVirtualEffect     
  123.  
  124.     Removed an @Debug macro that was inadvertently left in the code. This
  125.     would only cause a problem on systems with resident debuggers, or
  126.     systems with no IRET for INT 3.
  127.  
  128. (2) fxLibImage
  129.  
  130.     The stack variables for the library name were incorrectly defined, 
  131.     causing the user's program to end with a 'division by 0' error. Also,
  132.     it was referencing fxFileImage's VPTR variable instead of its own.
  133.  
  134.  
  135. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  136.  
  137.