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

TRANSFORM POINT 3 (PHOP,*,*,*)

Purpose

Use Transform Point 3 to transform a point using a specified transformation matrix.

The graPHIGS API returns the result of multiplying the given point by the transformation. If the graPHIGS API cannot return the transformed point, then the values of the point are unpredictable and the graPHIGS API sets the error indicator to the following error:

2
Function Requires State (PHOP,*,*,*)

Language Bindings

C

ptran_point3 (point, tran, err_ind, result)

Input Parameters

const Ppoint3 *point
Point.

Pmatrix3 tran
Transformation matrix. (See Chapter 15. "ISO PHIGS Transformations" for a description of the storage of the transformation matrix).

Output Parameters

Pint *err_ind
Error indicator.

Ppoint3 *result
Transformed point.

FORTRAN

PTP3 (xi, yi, zi, xfrmt, errind, xo, yo, zo)

Input Parameters

real xi
x coordinate of the point.

real yi
y coordinate of the point.

real zi
z coordinate of the point.

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

Output Parameters

integer errind
Error indicator.

real xo
x coordinate of the transformed point.

real yo
y coordinate of the transformed point.

real zo
z coordinate of the transformed point.

Errors

None

Related Subroutines

  • None

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