MTXScaleApply

Syntax

#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. The source type may be either Mtx or MtxPtr.
dst Resultant scaled source matrix. The type of dst may be either Mtx or MtxPtr.
xS X scale value.
yS Y scale value.
zS Z scale value.

Return Values

None.

Description

Applies the scaling transform specified by three parameters (xS, yS and 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 two functions MTXScale and MTXConcat shown above.

During a debug build, the MTXScaleApply function is parsed as C_MTXScaleApply, which is a normal C language version. During a non-debug build for a Broadway processor, the paired-singles equivalent of this function, PSMTXScaleApply, will be automatically substituted. You can also call C_MTXScaleApply and PSMTXScaleApply explicitly.

See Also

Mtx, MtxPtr, MTXScale, MTXConcat

Revision History

2006/03/01 Initial version.

CONFIDENTIAL