guScale [Function]

Function

guScale

Creates a scale modeling matrix (fixed point)

Syntax

#include <ultra64.h>        /* gu.h */
void guScale(Mtx *m, float x, float y, float z);

Arguments

m

Pointer to the matrix resulting from the calculations

x

x-axis scale value

y

y-axis scale value

z

z-axis scale value

Returned Value

None.

Description

Returns a modeling matrix scaled with (x, y, z) to the structure indicated by m. When this function is called, the result is the creation of the following kind of modeling matrix:

For details about the fixed-point format, see gSPMatrix. Floating point is handled with the guScaleF function.

Comment

The Mtx structure looks like this:

typedef long  Mtx_t[4][4];
typedef union {
     Mtx_t          m;
     long long int  force_structure_alignment;
} Mtx;

See Also

gSPMatrix, guAlign, guAlignF, guPosition, guPositionF, guRotate, guRotateF, guScaleF, guTranslate, and guTranslateF

Revision History

03/01/9 Completely rewritten.