[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

EVALUATE VIEW MAPPING MATRIX 3 (PHOP,*,*,*)

Purpose

Use Evaluate View Mapping Matrix 3 to create a view mapping matrix. Your application can use the matrix as input to the Set View Representation 3 subroutine.

If the graPHIGS API can compute the view mapping matrix, then the graPHIGS API sets the error indicator to zero and returns the view mapping matrix. If the graPHIGS API cannot compute the view mapping matrix, then the values of the matrix are unpredictable and the graPHIGS API sets the error indicator to one of the following errors:

2
Function Requires State (PHOP,*,*,*)
151
Invalid Window: Minimum Value >= To Corresponding Maximum Value
152
Invalid Viewport: XMIN >= XMAX, YMIN >= YMAX OR ZMIN > ZMAX
158
Front Plane Distance = Back Plane Distance When Z-Extent Non-Zero
162
Projection Reference Point Between Front And Back Planes
163
Projection Reference Point Cannot Be Positioned On View Plane
164
Back Plane Is In Front Of The Front Plane
155
Projection Viewport Limits Are Not Within NPC Range

Language Bindings

C

peval_view_map_matrix3 (mapping, err_ind, result_tran)

Input Parameters

const Pview_map3 *mapping
View mapping (window limits in VC, projection viewport limits in NPC, projection type and projection reference point in VC, and view, front and back plane distances in VC).

Output Parameters

Pint *err_ind
Error indicator.

Pmatrix3 result_tran
View mapping matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).

FORTRAN

PEVMM3 (vwwnlm, pjvplm, pjtype, pjrx, pjry, pjrz, vpld, bpld, fpld, errind, vwmpmt)

Input Parameters

real vwwnlm(4)
Window limits in VC (UMIN, UMAX, VMIN, VMAX).

real pjvplm(6)
Projection viewport limits in NPC (XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX).

integer pjtype
Projection type (PPARL, PPERS).

real pjrx
x-axis projection reference point in VC.

real pjry
y-axis projection reference point in VC.

real pjrz
z-axis projection reference point in VC.

real vpld
View plane distance in VC.

real bpld
Back plane distance in VC.

real fpld
Front plane distance in VC.

Output Parameters

integer errind
Error indicator.

real vwmpmt(4,4)
View mapping matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).

Errors

None

Related Subroutines

  • None

    • [ Previous | Next | Contents | Glossary | Home | Search ]