NAME

ESCAPE -6 − redraw a list of a PHIGS workstation window regions

SYNOPSIS

C Syntax

void
pescape ( func_id, in, store, out )
Pintfunc_id;escape function identifier
Pescape_in_data∗in; input data for the function
Pstorestore;not used
Pescape_out_data∗∗out; OUT not used

Required PHIGS Operating States

(PHOP, ∗, WSOP ∗)

DESCRIPTION

Purpose

ESCAPE -6 redraws the specified list of regions of a PHIGS workstation window without updating the workstation state list.  This escape function is intended to provide a means for applications to redraw the workstation window in response to X exposure events, without updating the state of the workstation state list.  When this function is called the workstation redraws the specified regions. 

C Input Parameters

func_id
The function identifier for this escape is PUESC_REDRAW_REGIONS, which is defined in phigs.h to be -6. 

inA pointer to a Pescape_in_data union, which contains the escape_in_u6 member used by this escape function.  This member is defined in phigs.h as:

struct {
Pintws_id;/∗ workstation id ∗/
Pintnum_regions; /∗ number of regions ∗/
XRectangle∗regions; /∗ the regions to redraw ∗/
} escape_in_u6;/∗ redraw regions ∗/

ws_idIndicates the workstation to redraw. 

num_regions
The number of regions specified.

regions
The regions of the workstation window to redraw.

storeThis parameter is not used in this escape function. 

C Output Parameters

outThis parameter is not used by this escape. 

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

SEE ALSO

ESCAPE (3P)

September 02, 1992