home *** CD-ROM | disk | FTP | other *** search
/ Microsoft Programmer's Library 1.3 / Microsoft-Programers-Library-v1.3.iso / sampcode / alde_c / lattice / dispio / read.me < prev   
Encoding:
Text File  |  1988-07-27  |  3.6 KB  |  60 lines
  1.           Files in DISPIO.LBR, a Lattice C interface to IBM_PC BIOS video
  2.           routines:
  3.                DISPIO   AQM     BIOS video IO
  4.                DISPIO   HQ      Constants and macros for DISPIO.ASM
  5.                DISPIOF  CQ      Functions which use DISPIO.ASM
  6.                DISP_PAR HQ      extern declarations for window parameters
  7.                D_PRINTF CQ      Fast printf which uses DISPIO.ASM
  8.                PRINTF   CQ      Fast printf which uses DOS calls
  9.                FRAME    CQ      Single and double line boxes which uses
  10.                                 DISPIOF
  11.                DISPIO   DQC     Documentation for all functions except
  12.                                 printf
  13.                READ     ME      This file
  14.  
  15.                This library is based on the file DISPIO.ASM, which Brian
  16.           H. Burger published in the article, "C to Assembly Interface", on
  17.           pages 49-59 of the February, 1985 issue of "Computer Language". 
  18.                DISPIO.ASM is the original program, with a few corrections
  19.           and some modifications.  It contains Lattice C calls for all the
  20.           BIOS video procedures, plus procedures to switch monitors.  Some
  21.           of the procedures have two calls, one near assembly language and
  22.           the other with more arguments but clearer.  I added calls only
  23.           when the Greenleaf Functions did not have the second form.  The
  24.           documentation for DISPIO also gives the Greenleaf Functions
  25.           references.
  26.                DISPIO.ASM is designed to work with Lattice C, which has its
  27.           own method of interfacing to functions.  You may need to change
  28.           or even rewrite it for a different compiler.
  29.                The include file DISPIO.H contains constants which may help
  30.           you use DISPIO.ASM and two macros which use it.
  31.                DISPIOF.C contains many small functions which use
  32.           DISPIO.ASM.  As I wrote them, I realized that they were also low
  33.           level window functions, so I added some global variables to give
  34.           window specifications.  DISP_PAR.H is an include file which will
  35.           declare these variables extern in other modules.  Several of the
  36.           functions in DISPIOF.C call major BIOS functions like change
  37.           monitors and then reset these global variables.  Incidentally,
  38.           the default window is the whole screen.  If you want others, you
  39.           must write your own functions to save and restore the parameters
  40.           and set the new ones.
  41.                Since these are BIOS functions, they are quite fast.  Since
  42.           they are not DOS functions, they do not support redirection.  I
  43.           would expect you to use them only in those cases where you know
  44.           that you are dealing with the screen.
  45.                Two of the three remaining program files are addaptations of
  46.           existing public domain functions to DISPIO.  I added a choice
  47.           between a single and double line box to L. Cutherberson's
  48.           FRAME.C.  I merely changed the name and call to the anonymous
  49.           author's PRINTF.C.  In this case, use the original file for
  50.           redirectible speed and the new D_PRINTF.C if you don't want to
  51.           allow redirection.
  52.                Finally, DISPIO.DOC contains documentation sheets for the
  53.           functions.
  54.                * * * * * * * * * * * * * * * * * * * *
  55.                These functions are free for your use, as is, with no
  56.           warantees of any kind.
  57.  
  58.           Lew Paper
  59.  
  60.