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="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 8<TITLE>VECDistance</TITLE> 9</HEAD> 10<BODY> 11<H1 align="left">VECDistance</H1> 12<H2 align="left">C Specification</H2> 13<BLOCKQUOTE><CODE><CODE>#include <revolution/mtx.h></CODE></CODE></BLOCKQUOTE> 14<BLOCKQUOTE><CODE>f32 C_VECDistance ( const Vec* <em>a</em>, const Vec* <em>b</em> );<br> f32 PSVECDistance ( const Vec* <em>a</em>, const Vec* <em>b</em> );<br> <br> #define VECDistance C_VECDistance // for debug build<br> #define VECDistance PSVECDistance // for nondebug build</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>a</EM></STRONG></CODE></TD> 21<TD width="520">Pointer to first vector <A href="../structures/Vec_VecPtr.html"><CODE>Vec</CODE></A> for distance calculation.</TD> 22 </TR> 23 <TR> 24<TD width="120" bgcolor="#ffffe8"><CODE><STRONG><EM><em><strong><code>b</code></strong></em> </EM></STRONG></CODE></TD> 25<TD width="520">Pointer to second vector <A href="../structures/Vec_VecPtr.html"><CODE>Vec</CODE></A> for distance calculation.</TD> 26 </TR> 27 </TBODY> 28</TABLE> 29</DIV> 30<H2 align="left">Return Values</H2> 31<P align="left">The distance between the two vectors.</P> 32<H2 align="left">Description</H2> 33<P align="left">Returns the distance between vectors <code><em><strong>a</strong></em> and <em><strong>b</strong></em></code>.</P> 34<P>During a debug build, <code>VECDistance</code> is interpreted as <code>C_VECDistance</code>, which exists in a standard C language version. During a nondebug build using a Broadway processor, the paired singles equivalent to this function, <code>PSVECDistance</code>, is automatically substituted. You can also explicitly call each <code>C_VECDistance/PSVECDistance</code>.</P> 35 36 37<H2 align="left">See Also</H2> 38<P align="left"><A href="../structures/Vec_VecPtr.html"><CODE>Vec, VecPtr</CODE></A></P> 39<P align="left"><A href="VECSquareDistance.html"><CODE>VECSquareDistance</CODE></A></P> 40<H2>Revision History</H2> 41<P>2006/03/01 Initial version.</P> 42<hr> 43<P>CONFIDENTIAL</p> 44</BODY> 45</HTML>