home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 15 / CDACTUAL15.iso / cdactual / program / pascal / FLASHPAC.ZIP / CH1_1.DOC < prev    next >
Encoding:
Text File  |  1991-03-15  |  6.1 KB  |  197 lines
  1. ..pgno01
  2. ..foot60A1-##
  3. ..head03A■ Introduction
  4.  
  5.   This is a reference manual for the FlashPac C library. This
  6.   implementation is for use with Microsoft or Turbo C in the PC-DOS
  7.   operating system.  A working knowledge of C and personal computers
  8.   is assumed.
  9.  
  10.   The routines that are included here were created to provide a
  11.   programmer with low level routines that access the video display,
  12.   keyboard, printer, disk, and mouse devices.  These routines are not
  13.   intended to replace the standard features of C.  They were created
  14.   to add to and extend to the C programming environment for MS-DOS and
  15.   PC-DOS operating systems.
  16.  
  17.   In order to lessen the confusion of using these routines the number
  18.   of global variables needed for use with this library has been kept
  19.   to a minimum.  All the functions in the library were written in
  20.   assembly language using the pascal parameter passing conventions.
  21.  
  22.   The library contains routines for the disk, keyboard, mouse, printer
  23.   and video display devices, as well as a couple of DOS functions.
  24.   The header file FPCLIB.H contains all of the function and variable
  25.   declarations needed for this library.
  26.  
  27.   DISK       Supports several DOS function calls that use byte streams
  28.              when accessing disk files.
  29.  
  30.   GETKEY     Required for EditSt.
  31.  
  32.   KBD        Supports BIOS and DOS keyboard function calls.
  33.  
  34.   MOUSE      Supports basic mouse functions, including a mouse event
  35.              handler.
  36.  
  37.   PRT        Support BIOS printer functions.
  38.  
  39.   VIDEO      Several video routines that provide direct access to the
  40.              video display.  Routines include saving and restoring the
  41.              screen, framing windows, setting the absolute position of
  42.          the cursor, etc.
  43.  
  44.   DOS         Several functions that access the DOS interrupts.
  45.  
  46.   BIOS         Several functions that uses the BIOS to access several of
  47.          the video functions available.
  48. ..page
  49. ..head03A■ Installation
  50.   The FlashPac C library consists of two files:
  51.  
  52.      ■ FPCLIB.H
  53.      ■ FPCLIB.LIB
  54.  
  55.   Place the header file "FPCLIB.H" in the same subdirectory that
  56.   contains your other header files and place "FPCLIB.LIB" into the
  57.   same subdirectory that your other library files are in.  You are now
  58.   ready to use the FlashPac C library.
  59.  
  60.  
  61. ■ Compiling and Linking a test program
  62.  
  63.   To compile and link "DEMO.C" and "GETKEY.C" modules use the
  64.   instructions for the appropriate compiler.
  65.  
  66. ■ Turbo C:
  67.  
  68.   Integrated environment:
  69.  
  70.       1. Select the large memory model under the Options, compiler
  71.          menu.
  72.       2. Create a project file with the following three lines:
  73.             demo    (demo.c)
  74.             getkey  (getkey.c)
  75.             fpclib.lib
  76.       3. Select the project file under the compile menu option select
  77.          build all to create an executable file called demo.exe
  78.  
  79.  
  80.   Command Line:
  81.  
  82.       C>tcc -IC:\INC -LC:\lib -ml demo.c getkey.c \lib\fpclib.lib
  83.  
  84.       -IC:\INC    C:\INC is the include subdirectory for header files
  85.       -LC:\LIB    C:\LIB is the library subdirctory for Turbo C
  86.                   libraries
  87.       -ml         selects large memory model
  88.       \lib        is the subdirectory where fpclib.lib is located
  89.  
  90.  
  91. ■ Microsoft C:
  92.  
  93.   C>cl /AL /F 4000 demo.c getkey.c \lib\fpclib.lib
  94.  
  95.       /AL         selects large memory model
  96.       /F 4000      create a 16K stack area
  97.       \lib        is the subdirectory where fpclib.lib is located
  98. ..page
  99. ..head02L----------------------------------------------------------------------
  100. ..head04L----------------------------------------------------------------------
  101. ..head03ASample
  102. ■ Description
  103.  
  104.   What the function does
  105.  
  106.  
  107. ■ Summary
  108.  
  109.   Function declaration with parameter list.
  110.   Parm1       Parm1 description.
  111.   Parm2       Parm2 description.
  112.  
  113.  
  114. ■ Remarks
  115.  
  116.   General comments.
  117.  
  118.  
  119. ■ See Also
  120.  
  121.   Related functions
  122.  
  123.  
  124. ■ Example
  125.  
  126.   Sample program or code fragment.
  127. ..page
  128. ..head04L──────────────────────────────────────────────────────────────────────
  129. ..head03AHistory of Revisions
  130.  
  131. V3.5
  132.    1. Added functions to access video bios interrupts.
  133.    2. Added functions to access several of the dos interrupts.
  134.    3. Revised all source code so it could be assembled with
  135.       either Borland's "TASM" or Microsoft's "MASM".
  136.    4. The pascal library now supports Turbo Pascal 6.0
  137.  
  138. ..page
  139. ..head04L──────────────────────────────────────────────────────────────────────
  140. ..head03AFuture Directions
  141.  
  142. If you have any enhancements you would like to see included please
  143. drop me a line describing the enhancement you would like to see.
  144.  
  145. Please send enhancement requests to:  Kevin Dahl
  146.                       1209 Poplar St
  147.                       La Crescent, MN  55947
  148.  
  149.  
  150. Hopeful
  151. completion
  152. date        Description of enhancement
  153. ----------  --------------------------------------------------------
  154. 06/30/91    define a menu system that is similar to windows and OS/2
  155.         PM structure.  Menu definition structure will probably
  156.         resemble that of OS/2 PM.
  157.  
  158. 09/30/91    write code to handle menu
  159.  
  160. 03/31/92    write menu resource compiler to generate code so a
  161.         programmer can define a menu exactly the same way a menu
  162.         is defined for OS/2 PM.
  163.  
  164. ??/??/??    Screen management system with paint program.
  165.         The following is a list of defined functions.
  166.  
  167.            WinChgFld
  168.            WinChgGlobal
  169.            WinChgMouseDef
  170.            WinClosep
  171.            WinDspAllFlds
  172.            WinDspHdrs
  173.            WinDspOneFld
  174.            WinDspNFlds
  175.            WinDsp
  176.            WinDspText
  177.            WinGetFldPtr
  178.            WinGetFldNumMouseIn
  179.            WinGetFnKeyWin
  180.            WinLoadColorTbl
  181.            WinLoad
  182.            WinLoadValidKeySets
  183.            WinInitMouse
  184.            WinMouseIn
  185.            WinOpen
  186.            WinRead
  187.            WinSetColorTable
  188.            WinSetDefltFlds
  189.  
  190.         The paint program is somewhat functional.  It will allow
  191.             you to define up to 99 screens in a library.
  192.  
  193.             Basically the paint system or forms generator will work
  194.             something like an editor.  Entering of text or field
  195.             prompts will be free form (like a text editor).
  196. ..page
  197.