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 name="GENERATOR" content="Microsoft FrontPage 5.0"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8<TITLE>MTXTrans</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">MTXTrans</H1> 12<H2 align="left">C Specification</H2> 13<BLOCKQUOTE><CODE><CODE> #include <revolution/mtx.h></CODE></CODE></BLOCKQUOTE> 14<BLOCKQUOTE><CODE>void C_MTXTrans ( Mtx <em>m</em>, f32 <em>xT</em>, f32 <em>yT</em>, f32 <em>zT</em> );<br> void PSMTXTrans ( Mtx <em>m</em>, f32 <em>xT</em>, f32 <em>yT</em>, f32 <em>zT</em> );<br> <br> #define MTXTrans C_MTXTrans // for debug build<br> #define MTXTrans PSMTXTrans // for nondebug build</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><em><strong><code>m</code></strong></em> </EM></STRONG></CODE></TD> 21<TD width="520">New translation matrix. <code><em><strong>m</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>xT</EM></STRONG></CODE></TD> 25<TD width="520">X translation value.</TD> 26 </TR> 27 <TR> 28<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>yT</EM></STRONG></CODE></TD> 29<TD width="520">Y translation value.</TD> 30 </TR> 31 <TR> 32<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>zT</EM></STRONG></CODE></TD> 33<TD width="520">Z translation value.</TD> 34 </TR> 35 </TBODY> 36</TABLE> 37</DIV> 38<H2 align="left">Return Values</H2> 39<P align="left">None.</P> 40<H2 align="left">Description</H2> 41<P>Sets a translation matrix from three ( <CODE><STRONG><EM>xT</EM></STRONG></CODE>, <CODE><STRONG><EM>yT</EM></STRONG></CODE>, <CODE><STRONG><EM>zT</EM></STRONG></CODE> ) translation parameters.</P> 42<P>During a debug build, <code>MTXTrans</code> is interpreted as <code>C_MTXTrans</code>, which is a normal C language version. During a nondebug build for a Broadway processor, the paired-singles equivalent of this function, <code>PSMTXTrans</code>, will be automatically substituted. You can also call each of <code>C_MTXTrans/PSMTXTrans</code> explicitly.</P> 43 44 45<H2 align="left">See Also</H2> 46<P align="left"><A href="../structures/Mtx_MtxPtr.html"><CODE>Mtx, MtxPtr</CODE></A></P> 47<P align="left"><A href="MTXTransApply.html"><CODE>MTXTransApply</CODE></A><BR> <A href="MTXScale.html"><CODE>MTXScale</CODE></A></P> 48<H2>Revision History</H2> 49</code></code></code></code></code></code> 50<P>2006/03/01 Initial version.</p> 51</BODY> 52</HTML>