Name

pset_disp_upd_st − Sets the values specified for the deferral mode and modification mode entries in the workstation state list. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

void pset_disp_upd_st (
   Pint           wsid,       /∗ (I) Workstation identifier ∗/
   Pdefer_mode    def_mode,   /∗ (I) Deferral mode ∗/
   Pmod_mode      mod_mode    /∗ (I) Modification mode ∗/
)

Data Structures

typedef enum {
    PDEFER_ASAP,     /∗ Generate images as soon as possible. ∗/
    PDEFER_BNIG,     /∗ Generate images before the next interaction
                        globally, or before a sample or event input
                        occurs. ∗/
    PDEFER_BNIL,     /∗ Generate images before the next interaction
                        locally, or before a sample or event input
                        occurs. ∗/
    PDEFER_ASTI,     /∗ Generate images at some time.  The
                        workstation determines the exact time. ∗/
    PDEFER_WAIT      /∗ The workstation waits to generate images. ∗/
} Pdefer_mode;
typedef enum {
    PMODE_NIVE,    /∗ No immediate visual effect. ∗/
    PMODE_UWOR,    /∗ Update without regeneration. ∗/
    PMODE_UQUM     /∗ Use quick update methods. ∗/
} Pmod_mode;

Description

pset_disp_upd_st sets the values specified for the deferral mode and modification mode entries in the workstation state list for the specified workstation.  It may delay deferred output, depending on the specified deferral mode value. 

The deferral mode governs when visual effects take place.  It can be set to one of the following values:

Mode Value    Description
---------------------------------------------------------------------------
ASAP          As soon as possible. Unless delayed by some outside
              influence, Digital PHIGS ensures actions required to achieve
              this visual effect are started before it returns control
              to the application.
BNIG          Before the next interaction globally.  Digital PHIGS ensures
              that the display on the specified workstation is visually
              correct before the next interaction with a logical input
              device starts on any workstation.  If an interaction has
              already started on another workstation, this value
              defaults to ASAP.
BNIL          Before the next interaction locally.  Digital PHIGS ensures
              that the display on the specified workstation is visually
              correct before the next interaction with a logical input
              device starts on this workstation.  If an interaction has
              already started on another workstation, this value
              defaults to ASAP.
ASTI          At some time.  Digital PHIGS ensures that the display on the
              specified workstation becomes visually correct at some
              point in time.
WAIT          When the application requests it.  Digital PHIGS ensures that
              the display on the specified workstation becomes visually
              correct when the application changes the deferral mode.
              The only visual effects that occur in WAIT deferral mode
              are those effects required by the modification mode.
---------------------------------------------------------------------------

Deferral mode always applies to visual effects and never to effects on the CSS or on the workstation state list, which are always immediate. 

While the application can control what kinds of modifications will be made to the display immediately, modifications do not necessarily make the display correspond exactly to the CSS and the workstation tables.  Workstation capabilities affect the ability of the application to specify immediate changes to displays.  For example, if new paper is required for a plotter device, an implicit regeneration (equivalent to a call to predraw_all_structs) is required. 

The dynamic modification accepted entries in the workstation description table that have the value IMM cause the action in UQUM modification mode to be the same as that in UWOR mode. 

A workstation that does not provide a quick update method for a function does not perform simulation.  Unless a function can be performed immediately or can be simulated, the effect is the same as if the modification mode were set to NIVE. 

Changes to the modification mode are not retroactive.  For example, visual effects that are pending as a result of previous modification (and deferral) mode settings may continue to be deferred, even if the modification mode is changed so that subsequent visual effects take place immediately. 

See Also

pinq_def_disp_upd_st
pinq_disp_upd_st
predraw_all_structs
pupd_ws
pe_upd_ws_synch