GPHIGS C FUNCTIONS - COMPOSE TRANSFORMATION MATRIX

COMPOSE TRANSFORMATION MATRIX

PCOMPOSE_TRAN_MATRIX

CALL SEQUENCE

void pcompose_tran_matrix(

Pmatrix	matrix	/* transformation matrix	*/
const Ppoint	*pt	/* fixed point	*/
const Pvec	*shift	/* shift vector	*/
Pfloat	angle	/* rotation angle	*/
const Pvec	*scale	/* scale vector	*/
Pint	*error_ind	/* (out) error indicator	*/
Pmatrix	result	/* (out) transformation matrix	*/

TYPES

typedef Pfloat Pmatrix[3][3];

typedef struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
} Ppoint;

typedef struct {
	Pfloat 	delta_x;	/* delta x	*/
	Pfloat 	delta_y;	/* delta y	*/
} Pvec;

PHIGS STATE

(PHOP, *, *, *).

EFFECT

Returns a homogeneous 3 x 3 matrix built from a homogeneous 3 x 3 matrix and by scaling, rotation and translation.

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

ERRORS

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