GPHIGS C FUNCTIONS - COMPOSE TRANSFORMATION MATRIX 3

COMPOSE TRANSFORMATION MATRIX 3

PCOMPOSE_TRAN_MATRIX3

CALL SEQUENCE

void pcompose_tran_matrix3(

Pmatrix3	matrix	/* transformation matrix	*/
const Ppoint3	*pt	/* fixed point	*/
const Pvec3	*shift	/* shift vector	*/
Pfloat	x_angle	/* rotation angle X	*/
Pfloat	y_angle	/* rotation angle Y	*/
Pfloat	z_angle	/* rotation angle Z	*/
const Pvec3	*scale	/* scale vector	*/
Pint	*error_ind	/* (out) error indicator	*/
Pmatrix3	result	/* (out) transformation matrix	*/

TYPES

typedef Pfloat Pmatrix3[4][4];

typedef struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
	Pfloat 	z;	/* z coordinate	*/
} Ppoint3;

typedef struct {
	Pfloat 	delta_x;	/* delta x	*/
	Pfloat 	delta_y;	/* delta y	*/
	Pfloat 	delta_z;	/* delta z	*/
} Pvec3;

PHIGS STATE

(PHOP, *, *, *).

EFFECT

Returns a homogeneous 4 x 4 matrix built from a homogeneous 4 x 4 matrix and by scaling, x rotation, y rotation, z rotation and translation.

The returned matrix can be used as the transformation matrix for the SET LOCAL TRANSFORMATION MATRIX 3, SET GLOBAL TRANSFORMATION MATRIX 3 and similar functions.

ERRORS

2: Ignoring function, function requires state (PHOP, *,*,*)