WSETECHO(3W)

NAME

wsetecho − set echo

SYNOPSIS

int wsetecho(fd,echo_value,x2,y2,optimized);
int fd;
int echo_value,x2,y2,optimized;

DESCRIPTION

fd is an integer file descriptor for an opened window type device interface.

echo_value
is the type of echo to be used. Predefined types are listed below:

0 invisible window

1 device’s best echo

2 full screen cross hair

3 small tracking cursor

4 rubber band line, with anchor point atx2,y2

5 rubber band rectangle, with anchor point at x2,y2

6 alpha digital representation (for displaying characters on external devices such as button boxes)

7 user defined raster cursor

8 box of width x2, height y2; where the upper left corner is the current cursor position

>8 device dependent representation

x2,y2
are the echo anchor position or box width and height.

optimized
is a boolean with two possible values:

0 means echo is exactly as defined. Movement via wsetlocator will do exactly as specified.

1 means echo representation may be modified as per the device to make it track in the best way possible. Movement via wsetlocator may snap to device dependent boundaries to take advantage of specialized hardware (such as a 4 X 4 pixel tile mover).

DISCUSSION

Set the window’s echo to the specified Starbase compatible echo type. An additional routine, wsetrasterecho, is needed to set up a raster echo.

DIAGNOSTICS

A -1 indicates failure; otherwise, 0 is returned. See errno(2) for further information.

Hewlett-Packard Company — May 11, 2021

Museum