home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / dos / strings / tclib13 / display.doc < prev    next >
Encoding:
Text File  |  1987-08-20  |  2.4 KB  |  54 lines
  1.  
  2.  
  3.         NAME
  4.                 dvid_cls -- clear the display and home cursor
  5.                 dvid_say -- display a string at specified position
  6.                 dvid_sayr -- dvid_say, returns cursor to starting point
  7.                 dvid_char_at -- display character at specified position
  8.                 dvid_char_atr -- dvid_char_at, returns cursor to start
  9.  
  10.         SYNOPSIS
  11.                 void dvid_cls();
  12.                 void dvid_say(row, col, string);
  13.                 void dvid_sayr(row, col, string);
  14.                 void dvid_char_at(row, col, ch);
  15.                 void dvid_char_atr(row, col, char);
  16.                 int row, col;     position to display
  17.                 char *string;     string to display
  18.                 char ch;          character to display
  19.  
  20.  
  21.         DESCRIPTION
  22.         These functions use the direct video access functions.
  23.         dvid_init() must be called prior to using these functions,
  24.         and the functions may fail of the target system is not a
  25.         very close compatible since direct memory writing is being
  26.         used.  dvid_char_at() passes only a carriage return, linefeed,
  27.         backspace, tab, and bell control code.  All other control codes
  28.         are ignored.  dvid_sayr() and dvid_char_atr() read the current
  29.         real cursor position and perform a dvid_move() after writing
  30.         the specified data.  Before using these calls, be sure the
  31.         internal cursor position and the screen position are
  32.         equal by doing a dvid_flush() call.  dvid_say(), dvid_cls(),
  33.         and dvid_char_at() all perform the dvid_flush() call before
  34.         returning, thereby insuring cursor updating.
  35.  
  36.  
  37.         EXAMPLE
  38.  
  39.               int i;
  40.               dvid_init();    /* initialize the package */
  41.               dvid_cls();     /* clear the screen */
  42.               dvid_say(0, 0, "Hello");  /* write to upper left corner */
  43.               for(i = 0; i < 10; i++) {
  44.                  dvid_char_at(i, i+1, i | '0');  /* write a sequence */
  45.                  }
  46.               dvid_move(12, 40);   /* move to center of screen */
  47.               dvid_flush();        /* physically update screen cursor */
  48.               dvid_sayr(20, 70, "Goodby");  /* write into lower corner */
  49.               dvid_putc('!');   /* this char should be at 12, 40 */
  50.  
  51.  
  52.  
  53.         This function is found in SMTCx.LIB for the Turbo-C Compiler
  54.