home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / turbo_c / tc130.arc / DISPBOX.DOC < prev    next >
Text File  |  1987-08-20  |  2KB  |  44 lines
  1.  
  2.  
  3.         NAME
  4.                 dvid_box -- display a box on the screen
  5.  
  6.         SYNOPSIS
  7.                 void dvid_box(row, col, width, height, style);
  8.                 int row, col;       position to display upper left corner
  9.                 int height, width;  size of box
  10.                 int style;          0 = single line, 1 = double line,
  11.                                     2 = single line reverse video,
  12.                                     3 = double line reverse video
  13.  
  14.  
  15.         DESCRIPTION
  16.         This function uses the direct video access functions.
  17.         dvid_init() must be called prior to using this function,
  18.         and the functions may fail of the target system is not a
  19.         very close compatible since direct memory writing is being
  20.         used.  dvid_box() places a single line or double line box on the
  21.         screen with the upper left corner anchored at "row" and "column",
  22.         with the size denoted by the "height" and "width" values.
  23.         No error checking is done on any value.  Invalid values may have
  24.         unpredictable results.
  25.  
  26.  
  27.         EXAMPLE
  28.  
  29.               int i;
  30.               dvid_init();    /* initialize the package */
  31.               dvid_cls();     /* clear the screen */
  32.               dvid_box(0, 0, 80, 24, 1); /* border the entire screen */
  33.                                          /* with double graphics line */
  34.  
  35.  
  36.  
  37.         CAVEAT:
  38.               if a color attribute has been set before this call,
  39.               it will revert to black & white if the "reverse video"
  40.               outlines are selected.  The attribute is not changed
  41.               for the normal video border selections.
  42.  
  43.         This function is found in SMTCx.LIB for the Turbo-C Compiler
  44.