INQUIRE WORKSTATION TRANSFORMATION 3(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE WORKSTATION TRANSFORMATION 3 − inquire a 3D workstation transformation

SYNOPSIS

C Syntax

void
pinqwstran3 ( ws, error_ind, ws_xform )
Pintws;workstation identifier
Pint∗error_ind;OUT error indicator
Pwstran3∗ws_xform;OUT workstation transformation

FORTRAN Syntax

SUBROUTINE pqwkt3 ( WKID, ERRIND, TUS, RWINDO, CWINDO, RVIEWP, CVIEWP )
INTEGERWKIDworkstation identifier
INTEGERERRINDOUT error indicator
INTEGERTUSOUT workstation transformation update state
REALRWINDO(6)OUT requested workstation window in NPC
REALCWINDO(6)OUT current workstation window in NPC
REALRVIEWP(6)OUT requested workstation viewport in DC
REALCVIEWP(6)OUT current workstation viewport in DC

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.

ws_xform
A pointer to a structure in which the system returns the current and requested workstation 3D transformation. Pwstran3 is defined in phigs.h as follows:

typedef struct {
Pupdateststate;/∗ update state ∗/
Plimit3req_window;/∗ requested workstation window ∗/
Plimit3cur_window;/∗ current workstation window ∗/
Plimit3req_viewport;/∗ requested workstation viewport ∗/
Plimit3cur_viewport;/∗ current workstation viewport ∗/
} Pwstran3;

Pupdatest is one of the values PNOTPENDING (“Not Pending”) or PPENDING (“Pending”). Plimit3 is defined as follows:

typedef struct {
Pfloatxmin;/∗ x minimum ∗/
Pfloatxmax;/∗ x maximum ∗/
Pfloatymin;/∗ y minimum ∗/
Pfloatymax;/∗ y maximum ∗/
Pfloatzmin;/∗ z minimum ∗/
Pfloatzmax;/∗ z maximum ∗/
} Plimit3;

FORTRAN Input Parameter

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

FORTRAN Output Parameters

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

TUSThe workstation transformation update state, one of the values: PNPEND (“Not Pending”) or PPEND (“Pending”).

RWINDO
An array where the 6 bounds of the requested workstation window are returned; the first two elements of this array give the minimum and maximum bounds in NPC for x, the next two for y, and the last two for z.

CWINDO
An array where the 6 bounds of the current workstation window are returned; the first two elements of this array give the minimum and maximum bounds in NPC for x, the next two for y, and the last two for z.

RVIEWP
An array where the 6 bounds of the requested workstation viewport are returned; the first two elements of this array give the minimum and maximum bounds in DC for x, the next two for y, and the last two for z.

CVIEWP
An array where the 6 bounds of the current workstation viewport are returned; the first two elements of this array give the minimum and maximum bounds in DC for x, the next two for y, and the last two for z.

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

Museum