Name

pe_inq_ext_view_rep3 − Returns view representation information. 

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

Syntax

void pe_inq_ext_view_rep3 (
  Pint              wsid,         /∗ (I) Workstation identifier ∗/
  Pint              view_index,   /∗ (I) View index requested ∗/
  Pint             ∗error_ind,    /∗ (O) Error indicator ∗/
  Pupd_st          ∗update_state, /∗ (O) Viewing transformation update
                                         state ∗/
  Pview_rep3_plus  ∗cur_rep,      /∗ (O) Current view representation ∗/
  Pview_rep3_plus  ∗req_rep       /∗ (O) Requested view representation ∗/
)

Data Structures

typedef enum {
    PUPD_NOT_PEND,    /∗ no update pending ∗/
    PUPD_PEND         /∗ update pending ∗/
} Pupd_st;
typedef struct {
    Pmatrix3        orientation_matrix;   /∗ orientation matrix ∗/
    Pmatrix3        mapping_matrix;       /∗ mapping matrix ∗/
    Plimit3         clip_limit;           /∗ clipping limits ∗/
    Pclip_ind       clip_xy;              /∗ xy-clipping indicator ∗/
    Pclip_ind       clip_back;            /∗ back clipping indicator ∗/
    Pclip_ind       clip_front;           /∗ front clipping indicator ∗/
    Pind            shield_indicator;     /∗ shield flag ∗/
    Pint            shield_color;         /∗ shield color ∗/
    Pind            border_indicator;     /∗ border flag ∗/
    Pint            border_color;         /∗ border color ∗/
    Pactive_status  active_status;        /∗ view active flag ∗/
} Pview_rep3_plus;
    typedef Pfloat Pmatrix3[4][4];
    typedef struct {
        Pfloat   x_min;    /∗ x minimum ∗/
        Pfloat   x_max;    /∗ x maximum ∗/
        Pfloat   y_min;    /∗ y minimum ∗/
        Pfloat   y_max;    /∗ y maximum ∗/
        Pfloat   z_min;    /∗ z maximum ∗/
        Pfloat   z_max;    /∗ z maximum ∗/
    } Plimit3;
    typedef enum {
        PIND_NO_CLIP,    /∗ clipping disabled ∗/
        PIND_CLIP        /∗ clipping enabled ∗/
    } Pclip_ind;
    typedef enum {
        POFF,   /∗ flag off ∗/
        PON     /∗ flag on ∗/
    } Pind;
    typedef enum {
        PINACTIVE,     /∗ inactive view ∗/
        PACTIVE        /∗ active view ∗/
    } Pactive_status;

Description

pe_inq_ext_view_rep3 queries the workstation state list and returns values for the following:

•Viewing transformation update state

•Requested and current view orientation matrices

•Requested and current view mapping matrices

•Requested and current view clipping limits in normalized projection coordinate points

•Requested and current xy-clipping indicators

•Requested and current back-clipping indicators

•Requested and current front-clipping indicators

If the application requests a viewing transformation change but Digital PHIGS does not provide it by the time the application calls this function, the viewing transformation update state is PUPD_PEND. 

See Also

pinq_pred_view_rep
pinq_view_facs
pset_view_rep
pset_view_rep3