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>MTXRotAxisDeg</TITLE> 9</HEAD> 10<BODY> 11<H1>MTXRotAxisDeg</H1> 12 13<H2>Syntax</H2> 14<dl><dd><pre class="construction"> 15#include <revolution/mtx.h> 16 17#define MTXRotAxisDeg( m, axis, deg ) \ 18 19 MTXRotAxisRad( m, axis, MTXDegToRad(deg) ) 20</pre></dd></dl> 21 22<H2>Arguments</H2> 23<TABLE class="arguments" border="1" > 24 <TBODY> 25 <TR> 26<TH><em><strong><code>m</code></strong></em> </TH> 27<TD>New rotation matrix. The type of <SPAN class="argument">m</SPAN> is either <A href="../structures/Mtx_MtxPtr.html"><CODE>Mtx</CODE></A> or <A href="../structures/Mtx_MtxPtr.html"><CODE>MtxPtr</CODE></A>.</TD> 28 </TR> 29 <TR> 30<TH>axis</TH> 31<TD>Pointer to a <A href="../structures/Vec_VecPtr.html"><CODE>Vec</CODE></A> containing the components of the rotation axis. <SPAN class="argument">axis</SPAN> may also be a <A href="../structures/Point3d_Point3dPtr.html"><CODE>Point3dPtr</CODE></A>. The <CODE>(x,y,z)</CODE> members of <SPAN class="argument">axis</SPAN> correspond to the <CODE>(x,y,z)</CODE> components of the rotation axis. (For example, <CODE>(1,0,0)</CODE> specifies a rotation about the X axis.) <SPAN class="argument">axis</SPAN> does not have to be a unit vector.</TD> 32 </TR> 33 <TR> 34<TH>deg</TH> 35<TD>Rotation value in degrees. Counter-clockwise rotations are positive.</TD> 36 </TR> 37 </TBODY> 38</TABLE> 39 40<H2>Return Values</H2> 41<P>None.</P> 42 43<H2>Description</H2> 44<P>Sets the matrix to be rotated around the axis having the <CODE>(x,y,z)</CODE> component specified by <SPAN class="argument">axis</SPAN>. Counter-clockwise rotations are positive.</P> 45<P>This function is actually defined as a macro that calls the <A href="MTXRotAxisRad.html"><CODE>MTXRotAxisRad</CODE></A> function.</P> 46 47<H2>See Also</H2> 48<P class="reference"> 49<A href="../structures/Mtx_MtxPtr.html">Mtx, MtxPtr</A>, 50<A href="../structures/Vec_VecPtr.html">Vec, VecPtr</A>, 51<A href="MTXRotAxisRad.html">MTXRotAxisRad</A>, 52<A href="MTXQuat.html">MTXQuat</A>, 53<A href="MTXRotRad.html">MTXRotRad</A>, 54<A href="MTXRotDeg.html">MTXRotDeg</A>, 55<A href="MTXRotTrig.html">MTXRotTrig</A> 56</P> 57 58<H2>Revision History</H2> 59<P> 602006/03/01 Initial version.<br> 61</p> 62 63<hr><p>CONFIDENTIAL</p></body> 64</HTML>