COMPOSE MATRIX 3(3P) — SUNPHIGS LIBRARY

NAME

COMPOSE MATRIX 3 − generate the composition of two homogeneous 3D matrices

SYNOPSIS

C Syntax

void
pcomposematrix3 ( a, b, error_ind, result )
Pmatrix3a;matrix a
Pmatrix3b;matrix b
Pint∗error_ind;OUT error indicator
Pmatrix3result;OUT result matrix

FORTRAN Syntax

SUBROUTINE pcom3 ( XFRMTA, XFRMTB, ERRIND, XFRMTO )
REALXFRMTA(4, 4)transformation matrix A
REALXFRMTB(4, 4)transformation matrix B
INTEGERERRINDOUT error indicator
REALXFRMTO(4, 4)OUT composed transformation matrix

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use COMPOSE MATRIX 3 to produce a 3D (4 x 4) homogeneous matrix that is the composition (matrix multiplication product) of two specified 4 x 4 matrices.

The returned matrix may be passed to the SET LOCAL TRANSFORMATION 3 and SET GLOBAL TRANSFORMATION 3 functions, or to any PHIGS function accepting a parameter of type Pmatrix3.

C Input Parameters

a, bThe 3D (4 x 4) matrices to use to calculate the composition matrix. Matrices are specified as a Pmatrix3 array defined in phigs.h as follows:

typedef Pfloat Pmatrix3[4][4]

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

resultThe resulting composition matrix.

FORTRAN Input Parameters

XFRMTA, XFRMTB
The 3D (4 x 4) matrices to use to calulate the composition matrix.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

XFRMTO
The resulting composition matrix.

Execution

COMPOSE MATRIX 3 returns a 4 x 4 matrix that is the result of multiplying the two specified matrices a and b:

result = a x b

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

Museum