1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META http-equiv="Content-Style-Type" content="text/css"> 6<META name="GENERATOR" content="Microsoft FrontPage 5.0"> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8<TITLE>MTXScaleApply</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">MTXScaleApply</H1> 12<H2 align="left">C Specification</H2> 13<BLOCKQUOTE><CODE><CODE>#include <revolution/mtx.h></CODE></CODE></BLOCKQUOTE> 14<BLOCKQUOTE><CODE><CODE>void C_MTXScaleApply ( const Mtx <EM>src</EM>, Mtx <EM>dst</EM>, f32 <EM>xS</EM>, f32 <EM>yS</EM>, f32 <EM>zS</EM> );<BR> void PSMTXScaleApply ( const Mtx <EM>src</EM>, Mtx <EM>dst</EM>, f32 <EM>xS</EM>, f32 <EM>yS</EM>, f32 <EM>zS</EM> );<BR> <BR> #define MTXScaleApply C_MTXScaleApply // for debug build<BR> #define MTXScaleApply PSMTXScaleApply // for nondebug build</CODE></CODE></BLOCKQUOTE> 15<H2 align="left">Arguments</H2> 16<DIV align="left"> 17<TABLE border="1" cellpadding="3" cellspacing="0.1"> 18 <TBODY> 19 <TR> 20<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>src</EM></STRONG></CODE></TD> 21<TD width="520">Source matrix. <code><em><strong>src</strong></em></code> may be either an <A href="../structures/Mtx_MtxPtr.html"><CODE>Mtx</CODE></A> or an <A href="../structures/Mtx_MtxPtr.html"><CODE>MtxPtr</CODE></A>.</TD> 22 </TR> 23 <TR> 24<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>dst</EM></STRONG></CODE></TD> 25<TD width="520">Resultant scaled source matrix. <code><em><strong>dst</strong></em></code> may be either an <A href="../structures/Mtx_MtxPtr.html"><CODE>Mtx</CODE></A> or an <A href="../structures/Mtx_MtxPtr.html"><CODE>MtxPtr</CODE></A>.</TD> 26 </TR> 27 <TR> 28<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>xS</EM></STRONG></CODE></TD> 29<TD width="520">X scale value.</TD> 30 </TR> 31 <TR> 32<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>yS</EM></STRONG></CODE></TD> 33<TD width="520">Y scale value.</TD> 34 </TR> 35 <TR> 36<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>zS</EM></STRONG></CODE></TD> 37<TD width="520">Z scale value.</TD> 38 </TR> 39 </TBODY> 40</TABLE> 41</DIV> 42<H2 align="left">Return Values</H2> 43<P>None.</P> 44<H2 align="left">Description</H2> 45<P>Applies the scaling transform specified by the three parameters ( <CODE><EM><STRONG>xS</STRONG></EM></CODE>, <CODE><EM><STRONG>yS</STRONG></EM></CODE>, <CODE><EM><STRONG>zS</STRONG></EM></CODE> ) to <strong><em>src</em></strong> and places the result in <strong><em>dst</em></strong>. This function performs the same operation as the following:</P> 46<P align="left"><CODE> Mtx sc;<BR> MTXScale(sc, xS, yS, zS);<BR> MTXConcat(sc, src, dst);</CODE></P> 47<P>Since the use of this function (<code>MTXScaleApply</code>) can reduce unnecessary calculations, it can get better performance than using the combination of the two functions <A href="MTXScale.html"><CODE>MTXScale</CODE></A> and <a href="../general/MTXConcat.html"><code>MTXConcat</code></a> shown above.</P> 48<P>During a debug build, <code>MTXScaleApply</code> is interpreted as <code>C_MTXScale</code>, which is the regular C language version. During a nondebug build for a Broadway processor, the paired-singles equivalent of this function, <code>PSMTXScaleApply</code>, will be automatically substituted. You can also call <code>C_MTXScaleApply</CODE> or <CODE>PSMTXScaleApply</code> explicitly.</P> 49 50 51<H2 align="left">See Also</H2> 52<P align="left"><A href="../structures/Mtx_MtxPtr.html"><CODE>Mtx, MtxPtr</CODE></A><A href="MTXScale.html"><CODE>MTXScale</CODE></A>, <CODE><A href="../general/MTXConcat.html">MTXConcat</A></CODE></P> 53<H2>Revision History</H2> 54<P>2006/03/01 Initial version.</P> 55<hr> 56<P>CONFIDENTIAL</p> 57</BODY> 58</HTML>