graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQWSX - Inquire Workstation Transformation

GPQWSX ( wsid, errind, state, rwindow, cwindow, rviewpt, cviewpt)

Note:

This subroutine is a Workstation State List (WSL) inquiry. For an overview, see "WSL Inquiries"

Purpose

Use GPQWSX to inquire the current and requested workstation transformation values of a specified workstation.

If your application has not updated the workstation, then the graPHIGS API returns a value of 2=PENDING In this case, the requested values reflect the settings established in the application with the Set Workstation Transformation 2 (GPWSX2) subroutine. The current values reflect the workstation's current transformation values. As soon as the workstation is updated, the requested and current values are the same and the state is 1=NOT_PENDING The values returned by the graPHIGS API are the window and viewport definitions.

If the inquired information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the inquired information is unavailable, then the error indicator (errind) contains an error number indicating the reason, and the values returned in the output parameters are unpredictable.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

errind -- returned by the graPHIGS API, fullword integer

Error indicator. If the error indicator is zero, the request has been completed. Otherwise, one of the following errors exists:

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES

state -- returned by the graPHIGS API, fullword integer

Workstation transformation update state ( 1=NOT_PENDING, 2=PENDING )

rwindow -- returned by the graPHIGS API, 6 short floating-point numbers (NPC)

Requested workstation window (Xmin, Xmax, Ymin, Ymax, Zmin, Zmax)

cwindow -- returned by the graPHIGS API, 6 short floating-point numbers (NPC)

Current workstation window (Xmin, Xmax, Ymin, Ymax, Zmin, Zmax)

rviewpt -- returned by the graPHIGS API, 6 short floating-point numbers (DC)

Requested workstation viewport (Xmin, Xmax, Ymin, Ymax, Zmin, Zmax)

cviewpt -- returned by the graPHIGS API, 6 short floating-point numbers (DC)

Current workstation viewport (Xmin, Xmax, Ymin, Ymax, Zmin, Zmax)

Error Codes

None

Related Subroutines

GPWSX2: Set Workstation Transformation 2
GPWSX3: Set Workstation Transformation 3

RCP code

201336842 ( X'0C00280A')