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 align="left">MTXRotAxisDeg</H1>
12<H2 align="left">C Specification</H2>
13<BLOCKQUOTE>
14<PRE align="left"><CODE>#include &lt;revolution/mtx.h&gt;
15
16#define MTXRotAxisDeg( <em>m</em>, <em>axis</em>, <em>deg</em> ) \
17
18MTXRotAxisRad( m, axis, MTXDegToRad(deg) )</CODE></PRE>
19</BLOCKQUOTE>
20<H2 align="left">Arguments</H2>
21<DIV align="left">
22<TABLE border="1" cellpadding="3" cellspacing="0.1">
23  <TBODY>
24    <TR>
25<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>m</EM></STRONG></CODE></TD>
26<TD width="520">New rotation matrix.&nbsp; <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>
27    </TR>
28    <TR>
29<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>axis</EM></STRONG></CODE></TD>
30<TD width="520">Pointer to a <A href="../structures/Vec_VecPtr.html"><CODE>Vec</CODE></A> containing the components of the rotation axis.&nbsp; <code><em><strong>axis</strong></em></code> may also be a <A href="../structures/Point3d_Point3dPtr.html"><CODE>Point3dPtr</CODE></A>.&nbsp;(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).&nbsp;<em><strong><code>axis</code></strong></em> does not have to be a unit vector.</TD>
31    </TR>
32    <TR>
33<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>deg</EM></STRONG></CODE></TD>
34<TD width="520">Rotation value in degrees.&nbsp;Counter-clockwise rotations are positive.</TD>
35    </TR>
36  </TBODY>
37</TABLE>
38</DIV>
39<H2 align="left">Return Values</H2>
40<P align="left">None.</P>
41<H2 align="left">Description</H2>
42<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>
43<P>This function is actually defined as a macro that calls <A href="MTXRotAxisRad.html"><CODE>MTXRotAxisRad</CODE></A>. </P>
44
45
46<H2 align="left">See Also</H2>
47<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>, <A href="MTXRotAxisRad.html"><CODE>MTXRotAxisRad, </CODE></A><A href="MTXQuat.html"><CODE>MTXQuat</CODE></A>, <A href="MTXRotRad.html"><CODE>MTXRotRad</CODE></A>, <A href="MTXRotDeg.html"><CODE>MTXRotDeg</CODE></A>, <CODE><A href="MTXRotTrig.html">MTXRotTrig</A></CODE></P>
48<H2>Revision History</H2>
49<P>2006/03/01 Initial version.</p>
50<hr>
51<P>CONFIDENTIAL</p>
52</BODY>
53</HTML>