WGETECHO(3W)

Series 300 and 500 Only

NAME

wgetecho − get echo

SYNOPSIS

int wgetecho(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 echo.

1 device’s best echo.

2 full screen cross hair.

3 small tracking cursor.

4 rubber band line, with anchor point at x2,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. (Default at window creation time where raster is defined to be a small arrow.) To get back to the default raster, set w and h to 0 (zero) for wsetrasterecho.

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. And 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

Get the window’s current echo. An additional routine, wgetrasterecho, is needed to get information about a raster echo.

DIAGNOSTICS

A return of -1 indicates failure; otherwise 0 is returned. See errno(2) for more information.

Hewlett-Packard Company — May 11, 2021

Museum