NAME

SYNOPSIS

#include <stdio.h>

int InitTermCap(fp);

FILE *fp;

int MvCursor(x, y);

int x, y;

int HmCursor(void);

int ClrEOL(void);

int ClrText(void);

int ClrStandout(void);

int SetStandout(void);

int SetScrlReg(top, bottom);

int top, bottom;

int ResetScrlReg(void);

int ScrollUp(void);

int ScrollDn(void);

int DeleteLn(void);

int PutChr(c);

int c;
extern char termName[];

extern int LI; /* number of lines on screen (or layer) */

extern int CO; /* number of columns on screen (or layer) */

DESCRIPTION

InitTermCap must be passed the output stream pointer and invoked before any other functions in this library. This function reads the termcap(4) capability data base to extract terminal-specific parameters and control strings, then initializes the terminal, returning 1 for success and 0 for failure. After InitTermCap is used, the global buffer termName will contain the name of the terminal device, or UNKNOWN in the event of failure (e.g., the environment variable $TERM was not set or exported (see sh(1))); the global variables LI and CO will contain the number of lines and columns, respectively, of the terminal screen or window layer attached to the specified output stream; and the terminal control string pointers will be set, or NULL if their respective capabilities are not found. The terminal control strings are not generally suitable for direct use as they require the tputs or tgoto macros from the termlib(3) library, but they may be checked for being NULL to test in advance for a capability, rather than testing the respective function for success or failure. The function PutChr will place the specified character on the terminal's output stream. It is not intended for use by the application (although such use is permissible), but is defined for the termlib(3) library.

All the following functions will return 1 for success and 0 if the capability is not described in the termcap(4) entry. MvCursor will move the cursor to the specified column and row (x and y) screen location specified. HmCursor will move the cursor to the origin (top left) of the screen and is equivalent to MvCursor(1,1). To erase from the cursor position to the end of the line, use ClrEOL, and to erase the entire screen call ClrText (typically has the side effect of homing the cursor). To initiate the output of reverse video or emboldened text (depending upon the terminal's capabilities), use SetStandout; ClrStandout will restore the normal mode. For terminals such as the DEC VT100 which have scrolling region capability, the functions SetScrlReg and ResetScrlReg can be used. SetScrlReg must be invoked with the top and bottom line numbers of the region of the screen to be scrolled. The functions ScrollUp and ScrollDn will scroll the text on the screen up and down (forward and backward) respectively, by one line per invocation. The function DeleteLn will delete the line containing the cursor, causing the text below to scroll up to fill the void.

EXAMPLE

$ cc program.c -lcursor -ltermlib

FILES

SEE ALSO

AUTHOR

COPYRIGHT

BUG REPORTS