INQUIRE WORKSTATION TRANSFORMATION(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE WORKSTATION TRANSFORMATION− inquire a 2D workstation transformation

SYNOPSIS

C Syntax

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

FORTRAN Syntax

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

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.

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

typedef struct {
Pupdateststate;/∗ update state ∗/
Plimitreq_window;/∗ requested workstation window ∗/
Plimitcur_window;/∗ current workstation window ∗/
Plimitreq_viewport;/∗ requested workstation viewport ∗/
Plimitcur_viewport;/∗ current workstation viewport ∗/
} Pwstran;

Pupdatest is one of the values PNOTPENDING (“Not Pending”) or PPENDING (“Pending”).

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 4 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, and the next two for y.

CWINDO
An array where the 4 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, and the next two for y.

RVIEWP
An array where the 4 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, and the next two for y.

CVIEWP
An array where the 4 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, and the next two for y.

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