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>QUATDivide</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">QUATDivide</H1>
12<H2 align="left">C Specification</H2>
13<BLOCKQUOTE><CODE><CODE>#include &lt;revolution/mtx.h&gt;</CODE></CODE></BLOCKQUOTE>
14<BLOCKQUOTE><CODE><CODE>void C_QUATDivide ( const Quaternion* <EM>p</EM>, const Quaternion* <EM>q</EM>, Quaternion* <EM>r</EM> );<BR> void PSQUATDivide ( const Quaternion* <EM>p</EM>, const Quaternion* <EM>q</EM>, Quaternion* <EM>r</EM> );<BR> <BR> #define QUATDivide&nbsp; C_QUATDivide // for debug build<BR> #define QUATDivide&nbsp; PSQUATDivide // 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" bgcolor="#ffffe8"><CODE><STRONG><EM>p</EM></STRONG></CODE></TD>
21<TD width="520">Pointer to first <A href="../structures/Quaternion_QuaternionPtr.html"><code>Quaternion</code></a> for division.</TD>
22    </TR>
23    <TR>
24<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>q</EM></STRONG></CODE></TD>
25<TD width="520">Pointer to second <A href="../structures/Quaternion_QuaternionPtr.html"><code>Quaternion</code></a> for division.</TD>
26    </TR>
27    <TR>
28<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM>r</EM></STRONG></CODE></TD>
29<TD width="520">Pointer to resultant <A href="../structures/Quaternion_QuaternionPtr.html"><CODE>Quaternion</CODE></A>.&nbsp;Contains the result of ( <code><em><strong>p</strong></em> / <em><strong>q</strong></em></code> ).&nbsp;Acceptable if <CODE><EM><STRONG>r</STRONG></EM> = <EM><STRONG>p</strong></STRONG></EM></CODE> or <CODE><EM><STRONG>r</STRONG></EM> = <EM><STRONG>q</STRONG></EM></CODE>.</TD>
30    </TR>
31  </TBODY>
32</TABLE>
33</DIV>
34<H2 align="left">Return Values</H2>
35<P>None.</P>
36<H2 align="left">Description</H2>
37<P>Divides quaternion <EM><STRONG><CODE>p</CODE></STRONG></EM> by quaternion <CODE><EM><STRONG>q</STRONG></EM></CODE> and stores the result in <CODE><EM><STRONG>r</STRONG></EM></CODE>. The result, <CODE><EM><STRONG>r</STRONG></EM></CODE>, satisfies the equation ( <EM><STRONG><CODE>q</CODE></STRONG></EM> x <STRONG><EM><CODE>r</CODE></EM></STRONG> ) = <EM><STRONG><CODE>p</CODE></STRONG></EM>. </P>
38<P>During a debug build, <code>QUATDivide</code> is interpreted as <code>C_QUATDivide</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>PSQUATDivide</code>, will be automatically substituted. You can also call <code>C_QUATDivide</code> or <code>PSQUATDivide</code> explicitly.</P>
39
40<P></P>
41<H2 align="left">See Also</H2>
42<P align="left"><A href="../structures/Quaternion_QuaternionPtr.html"><CODE>Quaternion, QuaternionPtr, </CODE></A><CODE><A href="QUATMultiply.html">QUATMultiply</A></CODE></P>
43<H2>Revision History</H2>
44<P>2006/03/01 Initial version.</P>
45<hr>
46<P>CONFIDENTIAL</p>
47</BODY>
48</HTML>