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>QUATNormalize</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">QUATNormalize</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_QUATNormalize ( const Quaternion* <EM>src</EM>, Quaternion* <EM>unit</EM> );<BR> void PSQUATNormalize ( const Quaternion* <EM>src</EM>, Quaternion* <EM>unit</EM> );<BR> <BR> #define QUATNormalize C_QUATNormalize // for debug build<BR> #define QUATNormalize PSQUATNormalize // for nondebug build<BR></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" valign="top" align="left" bgcolor="#ffffe8"><CODE><STRONG><EM>src</EM></STRONG></CODE></TD> 21<TD width="520">Pointer to <A href="../structures/Quaternion_QuaternionPtr.html"><CODE>Quaternion</CODE></A> to be normalized.</TD> 22 </TR> 23 <TR> 24<TD width="120" valign="top" align="left" bgcolor="#ffffe8"><CODE><STRONG><EM>unit</EM></STRONG></CODE></TD> 25<TD width="520">Pointer to resultant <A href="../structures/Quaternion_QuaternionPtr.html"><CODE>Quaternion</CODE></A>. Acceptable if <code><em><strong>src</strong></em> = <em><strong>unit</strong></em></code>.</TD> 26 </TR> 27 </TBODY> 28</TABLE> 29</DIV> 30<H2 align="left">Return Values</H2> 31<P>None.</P> 32<H2 align="left">Description</H2> 33<P>Normalizes a quaternion <code><em><strong>src</strong></em></code> and places the resulting unit quaternion in <strong><em><code>unit</code></em></strong>.</P> 34<P>During a debug build, <code>QUATNormalize</code> is interpreted as <code>C_QUATNormalize</code>, which is a normal C language version. During a non-debug build for a Broadway processor, the paired-singles equivalent of this function, <code>PSQUATNormalize</code>, will be automatically substituted. You can also call <code>C_QUATNormalize</CODE> or <CODE>PSQUATNormalize</code> explicitly.</P> 35 36<P></P> 37<H2 align="left">See Also</H2> 38<P align="left"><A href="../structures/Quaternion_QuaternionPtr.html"><CODE>Quaternion, QuaternionPtr</CODE></A></P> 39<H2>Revision History</H2> 40<P>2006/03/01 Initial version.</P> 41<hr> 42<P>CONFIDENTIAL</p> 43</BODY> 44</HTML>