[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

INQUIRE DISPLAY UPDATE STATE (PHOP,WSOP,*,*)

Purpose

Use Inquire Display Update State to inquire the current deferral and update state values for the specified workstation.

Possible deferral modes include: ASAP, BNIG, BNIL, ASTI, and WAIT. Possible modification modes include: NIVE, UWOR, and UQUM. The display surface is either EMPTY or NOT EMPTY. Possible states of visual representation include: CORRECT, DEFERRED, and SIMULATED. If your application specifies both simulated and deferred actions, then the state of visual representation is DEFERRED (the pixel data returned is different from the graphical state of the workstation). For an explanation of the deferral states and modification modes see The graPHIGS Programming Interface: Understanding Concepts.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the information is unavailable, then the values returned in the output parameters are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
59
Specified Workstation Does Not Have Output Capability

Language Bindings

C

pinq_disp_upd_st (ws_id, err_ind, def_mode, mod_mode, disp_surf_empty, vis_st)

Input Parameters

Pint ws_id
Workstation identifier.

Output Parameters

Pint *err_ind
Error indicator.

Pdefer_mode *def_mode
Deferral mode (0=PDEFER_ASAP, 1=PDEFER_BNIG, 2=PDEFER_BNIL, 3=PDEFER_ASTI, 4=PDEFER_WAIT).

Pmod_mode *mod_mode
Modification mode (0=PMODE_NIVE, 1=PMODE_UWOR, 2=PMODE_UQUM).

Pdisp_surf_empty *disp_surf_empty
Display surface empty (0=PSURF_NOT_EMPTY, 1=PSURF_EMPTY).

Pvisual_st *vis_st
State of visual representation (0=PVISUAL_ST_CORRECT, 1=PVISUAL_ST_DEFER, 2=PVISUAL_ST_SIMULATED).

FORTRAN

PQDUS (wkid, errind, defmod, modmod, dempty, stofvr)

Input Parameters

integer wkid
Workstation identifier.

Output Parameters

integer errind
Error indicator.

integer defmod
Deferral mode (0=PASAP, 1=PBNIG, 2=PBNIL, 3=PASTI, 4=PWAITD).

integer modmod
Modification mode (0=PNIVE, 1=PUWOR, 2=PUQOM).

integer dempty
Display surface empty (0=PNEMPT, 1=PEMPTY).

integer stofvr
State of visual representation (0=PVROK, 1=PVRDRF, 2=PVRSIM).

Errors

None

Related Subroutines

  • Inquire Default Display Update State

  • Set Display Update State

    • [ Previous | Next | Contents | Glossary | Home | Search ]