INQUIRE VIEW REPRESENTATION(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE VIEW REPRESENTATION − inquire a view representation on a workstation

SYNOPSIS

C Syntax

void
pinqviewrep ( ws, view_index, error_ind, update_state, cur_rep, req_rep )
Pintws;workstation identifier
Pintview_index;view index
Pint∗error_ind;OUT error indicator
Pupdatest∗update_state;OUT transformation update state
Pviewrep3∗cur_rep;OUT current view representation
Pviewrep3∗req_rep;OUT requested view representation

FORTRAN Syntax

SUBROUTINE pqvwr ( WKID, VIEWI, CURQ, ERRIND, VWUPD, VWORMT, VWMPMT, VWCPLM,
XYCLPI, BCLIPI, FCLIPI )
INTEGERWKIDworkstation identifier
INTEGERVIEWIview index requested
INTEGERCURQwhether current or requested values are
to be returned (PCURVL, PRQSVL)
INTEGERERRINDOUT error indicator
INTEGERVWUPDOUT viewing transformation update state
REALVWORMT(4, 4)OUT view orientation matrix
REALVWMPMT(4, 4)OUT view mapping matrix
REALVWCPLM(6)OUT view clipping limits (NPC)
INTEGERXYCLPIOUT x-y clipping indicator (PNCLIP, PCLIP)
INTEGERBCLIPIOUT back clipping indicator (PNCLIP, PCLIP)
INTEGERFCLIPIOUT front clipping indicator (PNCLIP, PCLIP)

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE VIEW REPRESENTATION to obtain the current and requested view representation in an entry of the specified workstation’s view table.

C Input Parameters

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

view_index
The view index whose representation is desired from the workstation’s table of defined view representations.

C Output Parameters

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

update_state
A pointer to a location in which the system returns the view transformation update state. Pupdatest is one of the values PNOTPENDING (“Not Pending”) or PPENDING (“Pending”).

cur_rep
A pointer to a Pviewrep3 structure in which the system returns the definition of the current view representation.

req_rep
A pointer to a Pviewrep3 structure in which the system returns the definition of the requested view representation.

Pviewrep3 is defined in phigs.h as follows:

typedef struct {
        Pmatrix3orientation_matrix;/∗ view orientation matrix ∗/
        Pmatrix3mapping_matrix;/∗ mapping matrix ∗/
        Plimit3clip_limit;/∗ clipping limits ∗/
        Pclipclip_xy;/∗ X-Y clipping indicator ∗/
        Pclipclip_back;/∗ back clipping indicator ∗/
        Pclipclip_front;/∗ front clipping indicator ∗/
} Pviewrep3;

Pclip is either PCLIP (“Clipping”) or PNOCLIP (“Not Clipping”). See SET VIEW REPRESENTATION(3P) for more information on the meaning of these attribute values.

FORTRAN Input Parameters

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

VIEWI
The view index of the entry whose representation is desired.

CURQAn enumerated variable specifying whether the current or requested representation is desired:

PCURVLReturn the current value of the representation
PRQSVLReturn the requested value of the representation

The requested values can differ from the current values if the update state is “Pending”.

FORTRAN Output Parameters

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

VWUPD
The view transformation update state. Possible values are: PNPEND (“Not Pending”) or PPEND (“Pending”).

VWORMT
A 4 × 4 array in which the view orientation matrix is returned.

VWMPMT
A 4 × 4 array in which the view mapping matrix is returned.

VWCPLM
An array in which the view clipping limits are returned; the first two elements of this array give the minimum and maximum clipping values in NPC for x, the next two for y, and the last two for z.

XYCLPI
The X-Y clipping indicator, one of: PNCLIP (“Not Clipping”) or PCLIP (“Clipping”).

BCLIPI
The back clipping indicator.

FCLIPI
The front clipping indicator.

ERRORS

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

054Ignoring function, the specified workstation is not open

057Ignoring function, specified workstation is of category MI

114Ignoring function, the view index value is less than zero

101Ignoring function, the specified representation has not been defined

Museum