NAME

INQUIRE WORKSTATION TRANSFORMATION− inquire a 2D workstation transformation

SYNOPSIS

C Syntax

void
pinq_ws_tran ( 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
Plimit∗req_win_lim;OUT requested workstation window
Plimit∗cur_win_lim;OUT current workstation window
Plimit∗req_vp_lim;OUT requested workstation viewport
Plimit∗cur_vp_lim;OUT current workstation viewport

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE WORKSTATION TRANSFORMATION to determine the current and requested 2D workstation 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.  Plimit is defined in phigs.h as follows:

typedef struct {
Pfloatx_min;
Pfloatx_max;
Pfloaty_min;
Pfloaty_max;
} Plimit;

cur_win_lim
The current workstation window. Plimit is defined above.

req_vp_lim
The requested workstation viewport. Plimit is defined above.

cur_vp_lim
The current workstation viewport. Plimit 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 (3P)
SET WORKSTATION WINDOW (3P)
INQUIRE WORKSTATION TRANSFORMATION 3 (3P)

September 02, 1992