Series 300 Only

NAME

wscrn_sprite_mode − set full-screen sprite control mode

SYNOPSIS

#include <window.h>
int wscrn_sprite_mode(fd,value);
int fd;
int value;

DESCRIPTION

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

value is the set/interrogation parameter for which the following values are valid:

-1 return the window’s current screen sprite control mode. 

0 disable full-screen sprite control mode.  This is the default mode. 

1 enable full-screen sprite control mode.  See discussion below. 

DISCUSSION

This routine inquires or sets the window’s screen sprite control mode.  If the window is in full-screen sprite control mode, the window manager will set the locator echo for the full-screen to that of the window specified by fd.  When the locator is moved over other windows, the desktop, or window borders, the echo will not change.  In addition, a locator button press or SELECT key press while in full-screen sprite control mode will not cause the default actions; rather, the button press will be transmitted to the specified window as a button-press event. 

If the user presses any key other than the SELECT key or buttons while in full-screen sprite control mode, full-screen sprite control mode is aborted.  The SIGWINDOW signal is then sent to all processes that have used wsetsigmask(3W) to enable SIGWINDOW on EVENT_ABORT for this window.

Note that all button press events are sent to the application when full-screen sprite mode is in effect, regardless of whether the locator is over a window or the background (desk top).  Therefore, if the application is to be consistent with the semantics of the window manager (e.g., give a system pop-up menu if the SELECT button is pressed over the desk top pattern), it will take extra work to do so.  This extra work probably involves using wminquire(3W) to get the value of WMIUICONFIG and to act appropriately to button presses, based on the value of WMIUICONFIG.

HARDWARE DEPENDENCIES

Series 500:
Full-screen sprite control mode is not supported on Series 500; it only works on Series 300.

SEE ALSO

wsetecho(3W),wsetrasterecho(3W),wsetsigmask(3W),weventpoll(3W),wmstart(1). 

DIAGNOSTICS

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

Full-screen sprite control mode aborts if the interactive operation times-out, just like other interactive operations (controlled by the WMIATIMEOUT variable; see wmstart(1)).

Hewlett-Packard Company  —  May 11, 2021