NAME

wsetrasterecho − set raster echo

SYNOPSIS

int wsetrasterecho(fd,dx,dy,w,h,rule,mask_rule,mask,image);
int fd;
int fd,dx,dy,w,h,rule,mask_rule;
char *mask,*image;

DESCRIPTION

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

dx,dy
are the offset of the echo hot spot to the upper left corner of the echo, usually negative.

w,h are the echo’s size. Setting both to 0 (zero) caused the default echo to be used (small arrow). 

rule,mask_rule
are the echo’s replacement rules used when displaying a raster cursor. These rules are defined in the HP Starbase documentation.

mask is a pointer to a bit-per-pixel array of 128 characters.  This array is used to make the mask for the raster echo.  The mask is placed on the screen before the image.  Each bit represents two possible values for each pixel: zero or all ones. 

image
is a pointer to a byte-per-pixel array of 1024 characters.  This array is used to make the image for the raster echo.

DISCUSSION

Set the window’s raster echo to the specified STARBASE compatible echo type.  An additional routine, wsetecho, is needed to set up more basic echo attributes first. 

SEE ALSO

wgetrasterecho(3W), wset_hw_sprite_color(3W), wsetecho(3W). 

DIAGNOSTICS

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

Hewlett-Packard Company  —  May 11, 2021