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

TRANSLATE 3 (PHOP,*,*,*)

Purpose

Use Translate 3 to calculate a three-dimensional transformation matrix to perform the specified 3D-axis translation.

If the graPHIGS API cannot compute the transformation matrix, then the values of the matrix are unpredictable and the graPHIGS API sets the error indicator to the following error:

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

Language Bindings

C

ptranslate3 (trans_vec, err_ind, result_tran)

Input Parameters

const Pvec3 *trans_vec
Translation vector.

Output Parameters

Pint *err_ind
Error indicator.

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

FORTRAN

PTR3 (dx, dy, dz, errind, xfrmt)

Input Parameters

real dx
x-axis translation vector.

real dy
y-axis translation vector.

real dz
z-axis translation vector.

Output Parameters

integer errind
Error indicator.

real xfrmt(4,4)
Transformation 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 ]