GPHIGS C FUNCTIONS - BUILD TRANSFORMATION MATRIX

BUILD TRANSFORMATION MATRIX

PBUILD_TRAN_MATRIX

CALL SEQUENCE

void pbuild_tran_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 struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
} Ppoint;

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

typedef Pfloat Pmatrix[3][3];

PHIGS STATE

(PHOP, *, *, *).

EFFECT

Returns a homogeneous 4 x 4 matrix to be used for a 3D transformation which includes: - scaling scale - rotation angle

- translation shift

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, *,*,*)