graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPVMP3 - Set View Mapping 3

GPVMP3 (wsid, view, window, viewpt, type, point, dist, near, far)

Purpose

Use GPVMP3 to set the requested viewing parameters to the given values for the specified view. The current values are set to the requested values when the workstation is updated.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

view -- specified by user, fullword integer

Index of view table entry to be modified (>=1)

window -- specified by user, 4 short floating-point numbers (VC)

Window limits (Umin, Umax, Vmin, Vmax)

viewpt -- specified by user, 6 short floating-point numbers (NPC)

Viewport limits (Xmin, Xmax, Ymin, Ymax, Zmin, Zmax)

type -- specified by user, fullword integer

Projection type (1=PARALLEL, 2=PERSPECTIVE )

point -- specified by user, 3 short floating-point numbers (VC)

Projection reference point (u, v, n)

dist -- specified by user, short floating-point number (VC)

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

near -- specified by user, short floating-point number (VC)

Distance of near plane from view reference point along the n-axis.

far -- specified by user, short floating-point number (VC)

Distance of far plane from view reference point along the n-axis.

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
44: INVALID WINDOW DEFINITION
55: PRP IS POSITIONED ON THE VIEW PLANE
59: VIEW INDEX VALUE < ZERO
323: VIEW INDEX EXCEEDS VIEW TABLE CAPACITY
330: INVALID VIEWPORT
331: PROJECTION TYPE IS INVALID
336: FAR CLIPPING PLANE IN FRONT OF NEAR CLIPPING PLANE
518: VIEW ZERO CANNOT BE MODIFIED

Related Subroutines

GPXVR: Set Extended View Representation

RCP code

201330177 (X'0C000E01')