INQUIRE DISPLAY UPDATE STATE(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE DISPLAY UPDATE STATE − inquire the current display update state

SYNOPSIS

C Syntax

void
pinqdisplayupdatest ( ws, error_ind, def_mode, mod_mode, display_surf, state )
Pintws;workstation identifier
Pint∗error_ind;OUT error indicator
Pdefmode∗def_mode;OUT deferral mode
Pmod∗mod_mode;OUT modification mode
Pdspsurf∗display_surf;OUT display surface empty
Pvisualrep∗state;OUT state of visual representation

FORTRAN Syntax

SUBROUTINE pqdus ( WKID, ERRIND, DEFMOD, MODMOD, DEMPTY, STOFVR )
INTEGERWKIDworkstation identifier
INTEGERERRINDOUT error indicator
INTEGERDEFMODOUT deferral mode
INTEGERMODMODOUT modification mode
INTEGERDEMPTYOUT display surface empty
INTEGERSTOFVROUT state of visual representation

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE DISPLAY UPDATE STATE to determine the current display update state from a specified workstation’s state list.

The deferral mode and modification mode were set by the application. The display surface empty and state of visual representation state list values are maintained by PHIGS.

C Input Parameters

wsThe workstation identifier of the workstation whose state list is queried.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

def_mode
A pointer to a location in which the system returns the current deferral mode. Possible values for Pdefmode are defined in phigs.h as follows: PASAPMake the display visually correct As Soon As Possible. PBNIGMake the display visually correct Before the Next Interaction Globally. PBNILMake the display visually correct Before the Next Interaction Locally. PASTIMake the display visually correct At Some Time. PWAITMake the display visually correct When the Application Requests It.

mod_mode
A pointer to a location in which the system returns the current modification mode. Possible values for Pmod are defined in phigs.h as follows: PNIVENo Immediate Visual Effects. PUWORUpdate Without Regeneration. PUQUMUse Quick Update Methods.

display_surf
A pointer to a location in which the system returns the current display surface empty status. Possible values for Pdspsurf are:

PDS_EMPTY“Empty”
PDS_NOTEMPTY“Not Empty”

stateA pointer to a location in which the system returns the current state of visual representation. Possible values for Pvisualrep are:

PCORRECT“Correct”
PDEFERRED“Deferred”
PSIMULATED“Simulated”

FORTRAN Input Parameters

WKIDThe workstation identifier of the workstation whose state list is queried.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

DEFMOD
The current deferral mode. Possible values are: PASAPMake the display visually correct As Soon As Possible. PBNIGMake the display visually correct Before the Next Interaction Globally. PBNILMake the display visually correct Before the Next Interaction Locally. PASTIMake the display visually correct At Some Time. PWAITDMake the display visually correct When the Application Requests It.

MODMOD
The current modification mode. Possible values are: PNIVENo Immediate Visual Effects. PUWORUpdate Without Regeneration. PUQUMUse Quick Update Methods.

DEMPTY
The current display surface empty status. Possible values are:

PNEMPTY“Not Empty”
PEMPTY“Empty”

STOFVR
The current state of visual representation. Possible values are:

PVROK“Correct”
PVRDFR“Deferred”
PVRSIM“Simulated”

ERRORS

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

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

Museum