doc/plane_coefficients.3.html

   1 <html>
   2 <head>
   3 <meta name="generator" content="groff -Thtml, see www.gnu.org">
   4 <meta name="Content-Style" content="text/css">
   5 <title>plane_coefficients</title>
   6 </head>
   7 <body>
   8
   9 <h1 align=center>plane_coefficients</h1>
  10 <a href="#NAME">NAME</a><br>
  11 <a href="#SYNOPSIS">SYNOPSIS</a><br>
  12 <a href="#DESCRIPTION">DESCRIPTION</a><br>
  13 <a href="#AUTHOR">AUTHOR</a><br>
  14 <a href="#LICENSE">LICENSE</a><br>
  15 <a href="#VERSION">VERSION</a><br>
  16
  17 <hr>
  18 <!-- Creator     : groff version 1.17.2 -->
  19 <!-- CreationDate: Fri May  3 14:57:27 2002 -->
  20 <a name="NAME"></a>
  21 <h2>NAME</h2>
  22 <table width="100%" border=0 rules="none" frame="void"
  23        cols="2" cellspacing="0" cellpadding="0">
  24 <tr valign="top" align="left">
  25 <td width="10%"></td><td width="90%">
  26 plane_coefficients - calculate the coefficient form for a plane</td></table>
  27 <a name="SYNOPSIS"></a>
  28 <h2>SYNOPSIS</h2>
  29
  30 <table width="100%" border=0 rules="none" frame="void"
  31        cols="2" cellspacing="0" cellpadding="0">
  32 <tr valign="top" align="left">
  33 <td width="10%"></td><td width="90%">
  34 <pre><b>#include &lt;matvec.h&gt;
  35
  36 void plane_coefficients (const float *p, const float *q, const float *r, float *co);
  37 </b></pre></td></table>
  38 <a name="DESCRIPTION"></a>
  39 <h2>DESCRIPTION</h2>
  40
  41 <table width="100%" border=0 rules="none" frame="void"
  42        cols="2" cellspacing="0" cellpadding="0">
  43 <tr valign="top" align="left">
  44 <td width="10%"></td><td width="90%">
  45 Given three points, not colinear, which naturally form a
  46 plane, calculate the 4-vector form for the plane
  47 coefficients. The three points are passed as <b>p</b>,
  48 <b>q</b> and <b>r</b>. The coefficients are returned in
  49 vector <b>co</b>.</td></table>
  50
  51 <table width="100%" border=0 rules="none" frame="void"
  52        cols="2" cellspacing="0" cellpadding="0">
  53 <tr valign="top" align="left">
  54 <td width="10%"></td><td width="90%">
  55 The four coefficients returned are respectively <b>a</b>,
  56 <b>b</b>, <b>c</b> and <b>d</b> in the standard plane
  57 equation:</td></table>
  58
  59 <table width="100%" border=0 rules="none" frame="void"
  60        cols="2" cellspacing="0" cellpadding="0">
  61 <tr valign="top" align="left">
  62 <td width="10%"></td><td width="90%">
  63 <b>a x + b y + c z + d = 0</b></td></table>
  64
  65 <table width="100%" border=0 rules="none" frame="void"
  66        cols="2" cellspacing="0" cellpadding="0">
  67 <tr valign="top" align="left">
  68 <td width="10%"></td><td width="90%">
  69 (Note that many texts use <b>- d</b>, so be
  70 warned).</td></table>
  71
  72 <table width="100%" border=0 rules="none" frame="void"
  73        cols="2" cellspacing="0" cellpadding="0">
  74 <tr valign="top" align="left">
  75 <td width="10%"></td><td width="90%">
  76 The normal (perpendicular) vector to the plane may be
  77 derived immediately: it is just <b>(a, b, c)</b>. Note that
  78 the normal vector is not normalized!</td></table>
  79
  80 <table width="100%" border=0 rules="none" frame="void"
  81        cols="2" cellspacing="0" cellpadding="0">
  82 <tr valign="top" align="left">
  83 <td width="10%"></td><td width="90%">
  84 Planes are unbounded: they stretch off to infinity in all
  85 directions. If what you really want are bounded convex
  86 polygons, then you need to use a c2lib
  87 &quot;face&quot;.</td></table>
  88 <a name="AUTHOR"></a>
  89 <h2>AUTHOR</h2>
  90
  91 <table width="100%" border=0 rules="none" frame="void"
  92        cols="2" cellspacing="0" cellpadding="0">
  93 <tr valign="top" align="left">
  94 <td width="10%"></td><td width="90%">
  95 Richard Jones &lt;rich@annexia.org&gt;</td></table>
  96 <a name="LICENSE"></a>
  97 <h2>LICENSE</h2>
  98
  99 <table width="100%" border=0 rules="none" frame="void"
 100        cols="2" cellspacing="0" cellpadding="0">
 101 <tr valign="top" align="left">
 102 <td width="10%"></td><td width="90%">
 103 GNU LGPL (see http://www.gnu.org/)</td></table>
 104 <a name="VERSION"></a>
 105 <h2>VERSION</h2>
 106
 107 <table width="100%" border=0 rules="none" frame="void"
 108        cols="2" cellspacing="0" cellpadding="0">
 109 <tr valign="top" align="left">
 110 <td width="10%"></td><td width="90%">
 111 c2lib-1.2.13</td></table>
 112 <hr>
 113 </body>
 114 </html>