NAME

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

SYNOPSIS

C Syntax

void
pcompose_matrix3 ( a, b, error_ind, m )
Pmatrix3a;matrix a
Pmatrix3b;matrix b
Pint∗error_ind;OUT error indicator
Pmatrix3m;OUT result matrix

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use COMPOSE MATRIX 3 to produce a 3D (4 × 4) homogeneous matrix that is the composition (matrix multiplication product) of two specified 4 × 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 × 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.

mThe 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, ∗, ∗, ∗)

SEE ALSO

COMPOSE MATRIX (3P)
COMPOSE TRANSFORMATION MATRIX 3 (3P)
BUILD TRANSFORMATION MATRIX 3 (3P)
SET LOCAL TRANSFORMATION 3 (3P)
SET GLOBAL TRANSFORMATION 3 (3P)

September 02, 1992