Name

pset_ws_win − Resets the workstation transformation according to 2D workstation window limits. 

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

Syntax

void pset_ws_win (
  Pint            wsid,       /∗ (I) Workstation identifier ∗/
  const Plimit   ∗window      /∗ (I) Workstation window limits, in
                                     normalized projection
                                     coordinates ∗/
)

Data Structures

typedef struct {
    Pfloat      xmin;     /∗ x minimum ∗/
    Pfloat      xmax;     /∗ x maximum ∗/
    Pfloat      ymin;     /∗ y minimum ∗/
    Pfloat      ymax;     /∗ y maximum ∗/
} Plimit;

Description

pset_ws_win resets the workstation transformation on the specified workstation.  (See Getting Started with DEC PHIGS for information about workstation transformations and the normalized projection coordinate system.) 

You specify two-dimensional workstation window limits within normalized projection coordinate space in the order XMIN, XMAX, YMIN, YMAX.  The XMIN and YMIN values must be less than the XMAX and YMAX values, respectively.  Digital PHIGS sets the ZMIN and ZMAX values to --1 and 0, respectively. 

The pset_ws_win function sets the x and y components of the requested workstation window entry in the workstation state list to the specified values.  Initially, Digital PHIGS sets only the requested entry, because workstation transformation may be deferred.  (See the pupd_ws function.) 

When the workstation is updated, Digital PHIGS resets the current workstation window entry in the workstation state list, as influenced by the values of these entries:

•The dynamic modification accepted (DMA) for workstation transformation entry in the workstation description table (where IMM indicates that all picture changes of the specified category can be performed immediately)

•The display space empty (DSE) entry in the workstation state list

•The workstation transformation update state entry in the workstation state list

The effects are defined in the following table:

DMA    DSE    Result
------------------------------------------------------------------------
IMM    N/A    The current workstation window entry is set to the
              specified value, and the workstation transformation
              update state entry is set to NOTPENDING.
N/A    EMPTY  The current workstation window entry is set to the
              specified value, and the workstation transformation
              update state entry is set to NOTPENDING.
Not    Not    The current workstation window entry is unchanged,
IMM    EMPTY  and the workstation transformation update state entry
              is set to PENDING.
------------------------------------------------------------------------

The z-components of the requested and current workstation window entries are unchanged. 

The workstation transformation is an isotropic transformation.  Therefore, if the workstation window and the workstation viewport do not share the same aspect ratio, the workstation viewport is not fully utilized. 

The default workstation window values are (0, 1, 0, 1, 0, 1), in normalized projection coordinates. 

See Also

pinq_ws_tran
pset_ws_vp
pset_ws_win3
pupd_ws