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>MTXRotAxisRad</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">MTXRotAxisRad</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_MTXRotAxisRad ( Mtx <EM>m</EM>, VecPtr <EM>axis</EM>, f32 <EM>rad</EM> );<BR> void PSMTXRotAxisRad ( Mtx <EM>m</EM>, VecPtr <EM>axis</EM>, f32 <EM>rad</EM> );<BR> <BR> #define MTXRotAxisRad C_MTXRotAxisRad // for debug build<BR> #define MTXRotAxisRad PSMTXRotAxisRad // 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>m</EM></STRONG></CODE></TD> 21<TD width="520">New rotation matrix. <code><em><strong>m</strong></em></code> may be 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>axis</EM></STRONG></CODE></TD> 25<TD width="520">Pointer to a <A href="../structures/Vec_VecPtr.html"><CODE>Vec</CODE></A> containing the components of the rotation axis. <code><em><strong>axis</strong></em></code> may also be a <A href="../structures/Point3d_Point3dPtr.html"><CODE>Point3dPtr</CODE></A>. (x,y,z) members of <em><strong><code>axis</code> </strong></em>correspond to (x,y,z) components of rotation axis (e.g., (<code>1,0,0</code>) specifies a rotation about the X axis). <em><strong><code>axis</code></strong></em> does not have to be a unit vector.</TD> 26 </TR> 27 <TR> 28<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>rad</EM></STRONG></CODE></TD> 29<TD width="520">Rotation angle in radians. Counter-clockwise rotations are positive.</TD> 30 </TR> 31 </TBODY> 32</TABLE> 33</DIV> 34<H2 align="left">Return Values</H2> 35<P align="left">None.</P> 36<H2 align="left">Description</H2> 37<P>Sets the matrix to perform the rotation about the axis with the <CODE>(x,y,z)</CODE> components specified by <CODE><EM><STRONG>axis</STRONG></EM></CODE>. Counter-clockwise rotations are positive.</P> 38<P>During a debug build, <code>MTXRotAxisRad</code> is interpreted as <code>C_MTXRotAxisRad</code>, which is a normal C language version. During a nondebug build for a Broadway processor, the paired-singles equivalent of this function, <code>PSMTXRotAxisRad</code>, will be automatically substituted. You can also call <code>C_MTXRotAxisRad</CODE> or <CODE>PSMTXRotAxisRad</code> explicitly.</P> 39 40 41<H2 align="left">See Also</H2> 42<P align="left"><A href="../structures/Mtx_MtxPtr.html"><CODE>Mtx, MtxPtr</CODE></A>, <A href="../structures/Vec_VecPtr.html"><CODE>Vec, VecPtr</CODE></A></P> 43<P align="left"><A href="MTXQuat.html"><CODE>MTXQuat</CODE></A>, <A href="MTXRotRad.html"><CODE>MTXRotRad</CODE></A>, <A href="MTXRotTrig.html"><CODE>MTXRotTrig</CODE></A></P> 44<H2>Revision History</H2> 45<P>2006/03/01 Initial version.</P> 46<hr> 47<P>CONFIDENTIAL</p> 48</BODY> 49</HTML>