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>QUATSubtract</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">QUATSubtract</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_QUATSubtract ( const Quaternion* <EM>p</EM>, const Quaternion* <EM>q</EM>, Quaternion* <EM>r</EM> );<BR> void PSQUATSubtract ( const Quaternion* <EM>p</EM>, const Quaternion* <EM>q</EM>, Quaternion* <EM>r</EM> );<BR> <BR> #define QUATSubtract&nbsp; C_QUATSubtract // for debug build<BR> #define QUATSubtract&nbsp; PSQUATSubtract // 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>p</EM></STRONG></CODE></TD>
21<TD width="520">Pointer to first <A href="../structures/Quaternion_QuaternionPtr.html"><CODE>Quaternion</CODE></A> to subtract.</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> to subtract.</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>Subtracts two quaternions ( <code><em><strong>p</strong></em> - <em><strong>q</strong></em></code> ) and places the result in <code><em><strong>r</strong></em></code>.</P>
38<P>During a debug build, <code>QUATSubtract</code> is interpreted as <code>C_QUATSubtract</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>PSQUATSubtract</code>, will be automatically substituted. You can also call <code>C_QUATSubtract</CODE> or <CODE>PSQUATSubtract</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></P>
43<P><CODE><A href="QUATAdd.html">QUATAdd</A></CODE></P>
44<H2>Revision History</H2>
45<P>2006/03/01 Initial version.</P>
46<hr>
47<P>CONFIDENTIAL</p>
48</BODY>
49</HTML>