NAME

facursor − control the displayed cursor

SYNOPSIS

#include <fa.h>
int facursor(gfd,column,line,cflag);
int gfd;
int column,line;
int cflag;

DESCRIPTION

gfd is an integer file descriptor for an gopened device interface. 

column indicates the alpha column at which to do the operation. 

line indicates the alpha line at which to do the operation. 

cflag if cflag is TRUE, the cursor is made visible.  If FALSE, the cursor is made invisible (if possible).  If column and line  are valid coordinates, the cursor (visible or invisible) is positioned accordingly.  If either is invalid (i.e. −1), the cursor position is not affected.  FACURSORNOMOVE is defined as −1 in /usr/include/fa.h to provide a mnemonic for specifying invalid values.  This is useful for updating the cursor position without actually moving it. 

DISCUSSION

This routine allows the user to position and turn on and off the cursor.  It also allows the user to "store" or change a cursor position without moving its physical position until a later operation. 

The cursor size is the character cell size of a 1-byte character even if a HP-15 (2-byte) font is used.  The 2-byte characters are twice as wide as the 1-byte characters.  Thus they take up two columns. 

By default, fast alpha “writes” update the screen immediately.  It is possible to get better performance by buffering writes and updating the screen after the writes are buffered.  See fasetinfo(3w) and the fa.h header file for information on how to buffer-up writes, as opposed to having them occur when this routine is called. 

SEE ALSO

fawrite(3w). 

DIAGNOSTICS

A value of −1 is returned if gfd is invalid or a call to fainit was never executed on this gfd. See errno(2) for further information. 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994