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

EVALUATE VIEW ORIENTATION MATRIX (PHOP,*,*,*)

Purpose

Use Evaluate View Orientation Matrix to calculate a two-dimensional viewing matrix based on the specified orientation.

The matrix returned performs a change from the World Coordinate (WC) system to a Viewing Coordinate (VC) system in which the origin is the view reference point with a z coordinate of zero, the n-axis is the view plane normal assumed to be [0,0,1], and the v-axis lies in the half plane designated by the view up vector with a z coordinate of zero.

If the graPHIGS API can compute the view orientation matrix, then the graPHIGS API sets the error indicator to zero and returns the view orientation matrix. If the graPHIGS API cannot compute the view orientation 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,*,*,*)
160
View UP Vector Has Length Zero

Language Bindings

C

peval_view_ori_matrix (view_ref_point, view_up_vec, err_ind, result_tran)

Input Parameters

const Ppoint *view_ref_point
View reference point in WC.

const Pvec *view_up_vec
View up vector in WC.

Output Parameters

Pint *err_ind
Error indicator.

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

FORTRAN

PEVOM (vwrx, vwry, vupx, vupy, errind, vwormt)

Input Parameters

real vwrx
x coordinate of the view reference point in WC.

real vwry
y coordinate of the view reference point in WC.

real vupx
x-axis directional component of the view up vector in WC.

real vupy
y-axis directional component of the view up vector in WC.

Output Parameters

integer errind
Error indicator.

real vwormt(3,3)
View orientation 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 ]