graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQCVX - Inquire Current Viewing Transformation

GPQCVX (wsid, view, errind, matrix, window, viewpt, viewt, refpt, dist, near, far, wincp, nearcp, farcp, shield, shldci, border, brdrci, viewact)

Purpose

Use GPQCVX to inquire the current view information for the specified view on the specified workstation.

If your application uses direct color to set the shielding or border color of the specified view, then you must use the Inquire Current View Representation (GPQCVR) subroutine to inquire the view information.

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.

view -- specified by user, fullword integer

View index (>=0)

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
59: VIEW INDEX VALUE < ZERO
323: VIEW INDEX EXCEEDS VIEW TABLE CAPACITY
526: REQUESTED DATA NOT AVAILABLE FOR THIS FUNCTION

matrix -- returned by the graPHIGS API, 16 short floating-point numbers

Current viewing transformation matrix. For the transformation matrix, the elements are returned in the following order:

                 
    |m11 m12 m13 m14|
    |m21 m22 m23 m24|---> (m11,m12,m13,m14,m21...m44)
    |m31 m32 m33 m34|
    |m41 m42 m43 m44|

window -- returned by the graPHIGS API, 4 short floating-point numbers (VC)

Current window (Umin, Umax, Vmin, Vmax)

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

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

viewt -- returned by the graPHIGS API, fullword integer

Current view type (1=PARALLEL, 2=PERSPECTIVE )

refpt -- returned by the graPHIGS API, 3 short floating-point numbers (VC)

Current projection reference point (u, v, n)

dist -- returned by the graPHIGS API, short floating-point number (VC)

Current distance of view plane from the view reference point along the n-axis.

near -- returned by the graPHIGS API, short floating-point number (VC)

Current distance of near clipping plane from the view reference point along the n-axis.

far -- returned by the graPHIGS API, short floating-point number (VC)

Current distance of far clipping plane from the view reference point along the n-axis.

wincp -- returned by the graPHIGS API, fullword integer

Current window clipping indicator (1=NOCLIP, 2=CLIP )

nearcp -- returned by the graPHIGS API, fullword integer

Current near clipping indicator (1=NOCLIP, 2=CLIP )

farcp -- returned by the graPHIGS API, fullword integer

Current far clipping indicator (1=NOCLIP, 2=CLIP )

shield -- returned by the graPHIGS API, fullword integer

Current shielding indicator (1=OFF, 2=ON )

shldci -- returned by the graPHIGS API, fullword integer

Current shielding color index.

Note:

Direct shielding color returns error indicator 526

border -- returned by the graPHIGS API, fullword integer

Current view border indicator (1=OFF, 2=ON )

brdrci -- returned by the graPHIGS API, fullword integer

Current view border color index.

Note:

Direct border color returns error indicator 526

viewact -- returned by the graPHIGS API, fullword integer

Current view active indicator for output (1=INACTIVE, 2=ACTIVE )

Error Codes

None

Related Subroutines

GPQCVR: Inquire Current View Representation

RCP code

201336835 (X'0C002803')