MTXScaleApply

C Specification

#include <revolution/mtx.h>

void C_MTXScaleApply ( const Mtx src, Mtx dst, f32 xS, f32 yS, f32 zS ); void PSMTXScaleApply ( const Mtx src, Mtx dst, f32 xS, f32 yS, f32 zS ); #define MTXScaleApply C_MTXScaleApply // for debug build #define MTXScaleApply PSMTXScaleApply // for nondebug build

Arguments

`src`	Source matrix. `src` may be either an `Mtx` or an `MtxPtr`.
`dst`	Resultant scaled source matrix. `dst` may be either an `Mtx` or an `MtxPtr`.
`xS`	X scale value.
`yS`	Y scale value.
`zS`	Z scale value.

Return Values

None.

Description

Applies the scaling transform specified by the three parameters ( xS, yS, zS ) to src and places the result in dst. This function performs the same operation as the following:

Mtx sc; MTXScale(sc, xS, yS, zS); MTXConcat(sc, src, dst);

Since the use of this function (MTXScaleApply) can reduce unnecessary calculations, it can get better performance than using the combination of the two functions MTXScale and MTXConcat shown above.

During a debug build, MTXScaleApply is interpreted as C_MTXScale, which is the regular C language version. During a nondebug build for a Broadway processor, the paired-singles equivalent of this function, PSMTXScaleApply, will be automatically substituted. You can also call C_MTXScaleApply or PSMTXScaleApply explicitly.

Revision History