NAME

INQUIRE WORKSTATION TRANSFORMATION 3 − inquire a 3D workstation transformation

SYNOPSIS

C Syntax

void
pinq_ws_tran3 ( ws, error_ind, upd_st, req_win_lim, cur_win_lim, req_vp_lim,
cur_vp_lim)
Pintws;workstation identifier
Pint∗error_ind;OUT error indicator
Pupd_st∗upd_st;OUT update state
Plimit3∗req_win_lim;OUT requested workstation window
Plimit3∗cur_win_lim;OUT current workstation window
Plimit3∗req_vp_lim;OUT requested workstation viewport
Plimit3∗cur_vp_lim;OUT current workstation viewport

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE WORKSTATION TRANSFORMATION 3 to determine the current and requested 3D transformation from a specified workstation’s state list. 

C Input Parameter

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

C Output Parameters

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

upd_st
The current update state.  Pupd_st is defined in phigs.h as follows:

typedef enum {
PUPD_NOT_PEND
PUPD_PEND
} Pupd_st;

req_win_lim
The requested workstation window.  Plimit3 is defined in phigs.h as follows:

typedef struct {
Pfloatx_min;
Pfloatx_max;
Pfloaty_min;
Pfloaty_max;
Pfloat z_min;
Pfloatz_max;
} Plimit3;

cur_win_lim
The current workstation window.  Plimit3 is defined above.

req_vp_lim
The requested workstation viewport. Plimit3 is defined above.

cur_vp_lim
The current workstation viewport.  Plimit3 is defined above.

Execution

The requested and current entries may differ if a workstation transformation change has been requested, but has not yet been provided.  The update state will be Pending in this case, and Not Pending otherwise. 

ERRORS

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

054Ignoring function, the specified workstation is not open

057Ignoring function, specified workstation is of category MI

SEE ALSO

SET WORKSTATION VIEWPORT 3 (3P)
SET WORKSTATION WINDOW 3 (3P)
INQUIRE WORKSTATION TRANSFORMATION (3P)

September 02, 1992