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

COMPOSE MATRIX 3 (PHOP,*,*,*)

Purpose

Use Compose Matrix 3 to perform a 44 matrix multiplication and return the results.

The graPHIGS API computes:
Transformation Matrix A Transformation Matrix B
and returns the result as the composed transformation matrix.

If the graPHIGS API can compute the transformation matrix, then the graPHIGS API sets the error indicator to zero and returns the composed transformation matrix. 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

pcompose_matrix3 (tran_a, tran_b, err_ind, result_tran)

Input Parameters

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

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

Output Parameters

Pint *err_ind
Error indicator.

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

FORTRAN

PCOM3 (xfrmta, xfrmtb, errind, xfrmto)

Input Parameters

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

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

Output Parameters

integer errind
Error indicator.

real xfrmto(4,4)
Composed 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 ]