GPHIGS C FUNCTIONS - BUILD TRANSFORMATION MATRIX 3

BUILD TRANSFORMATION MATRIX 3

PBUILD_TRAN_MATRIX3

CALL SEQUENCE

void pbuild_tran_matrix3(

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 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;

typedef Pfloat Pmatrix3[4][4];

PHIGS STATE

(PHOP, *, *, *).

EFFECT

Returns a homogeneous 4 x 4 matrix to be used for a 3D transformation which includes:

- scaling scale

- rotation in x x_angle

- rotation in y y_angle

- rotation in z z_angle

- translation shift

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