NAME

wset_hw_sprite_color − set hardware sprite colors

SYNOPSIS

int wset_hw_sprite_color(fd,fgcolor,bgcolor);
int fd;
int fgcolor,bgcolor;

DESCRIPTION

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

fgcolor,bgcolor
the foreground sprite color, and background sprite color. Colors are taken from the system (Starbase) color map.

DISCUSSION

Defaults for fgcolor and bgcolor are 1 and 0 respectively for the default at window creation time, except for border sprites that are set to the window’s border fgcolor and bgcolor. 

The sprite is displayed as follows.  All bgcolor index values in the sprite data will be displayed as bgcolor, and all non-bgcolor index values will be displayed as fgcolor. 

If a color is out of range for the device an error is generated.  Normally the valid range is from 0 to (2^N − 1), where N is the number of planes. 

This call can be made on all devices, but will only have an effect on the HP98730 when using the hardware support for sprites.  The use of the hardware for sprites can be disabled with the WMCONFIG environment variable. 

SEE ALSO

wget_hw_sprite_color(3W), wmstart(1). 

DIAGNOSTICS

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

Hewlett-Packard Company  —  May 11, 2021