doc/point_lies_in_face.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>point_lies_in_face</title>
   6 </head>
   7 <body>
   8
   9 <h1 align=center>point_lies_in_face</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 <a href="#SEE ALSO">SEE ALSO</a><br>
  17
  18 <hr>
  19 <!-- Creator     : groff version 1.17.2 -->
  20 <!-- CreationDate: Fri May  3 14:57:40 2002 -->
  21 <a name="NAME"></a>
  22 <h2>NAME</h2>
  23 <table width="100%" border=0 rules="none" frame="void"
  24        cols="2" cellspacing="0" cellpadding="0">
  25 <tr valign="top" align="left">
  26 <td width="10%"></td><td width="90%">
  27 point_lies_in_face, point_face_angle_sum - does a point lie on the interior of a bounded convex polygon</td></table>
  28 <a name="SYNOPSIS"></a>
  29 <h2>SYNOPSIS</h2>
  30
  31 <table width="100%" border=0 rules="none" frame="void"
  32        cols="2" cellspacing="0" cellpadding="0">
  33 <tr valign="top" align="left">
  34 <td width="10%"></td><td width="90%">
  35 <pre><b>#include &lt;matvec.h&gt;
  36
  37 int point_lies_in_face (const float *points, int nr_points, const float *point);
  38 float point_face_angle_sum (const float *points, int nr_points, const float *point);
  39 </b></pre></td></table>
  40 <a name="DESCRIPTION"></a>
  41 <h2>DESCRIPTION</h2>
  42
  43 <table width="100%" border=0 rules="none" frame="void"
  44        cols="2" cellspacing="0" cellpadding="0">
  45 <tr valign="top" align="left">
  46 <td width="10%"></td><td width="90%">
  47 Take a bounded convex polygon (a &quot;face&quot;) and a
  48 point. The function <b>point_lies_in_face</b> returns true
  49 iff the point is both (a) coplanar with the face, and (b)
  50 lies inside the edges of the face.</td></table>
  51
  52 <table width="100%" border=0 rules="none" frame="void"
  53        cols="2" cellspacing="0" cellpadding="0">
  54 <tr valign="top" align="left">
  55 <td width="10%"></td><td width="90%">
  56 In order to do this, <b>point_lies_in_face</b> calls
  57 <b>point_face_angle_sum</b> which works out the sum of the
  58 interior angles. If conditions (a) and (b) are both
  59 satisfied then the sum of the interior angles will be very
  60 close to 2.PI.</td></table>
  61
  62 <table width="100%" border=0 rules="none" frame="void"
  63        cols="2" cellspacing="0" cellpadding="0">
  64 <tr valign="top" align="left">
  65 <td width="10%"></td><td width="90%">
  66 The face is expressed as a flat list of points
  67 (3-vectors).</td></table>
  68 <a name="AUTHOR"></a>
  69 <h2>AUTHOR</h2>
  70
  71 <table width="100%" border=0 rules="none" frame="void"
  72        cols="2" cellspacing="0" cellpadding="0">
  73 <tr valign="top" align="left">
  74 <td width="10%"></td><td width="90%">
  75 Richard Jones &lt;rich@annexia.org&gt;</td></table>
  76 <a name="LICENSE"></a>
  77 <h2>LICENSE</h2>
  78
  79 <table width="100%" border=0 rules="none" frame="void"
  80        cols="2" cellspacing="0" cellpadding="0">
  81 <tr valign="top" align="left">
  82 <td width="10%"></td><td width="90%">
  83 GNU LGPL (see http://www.gnu.org/)</td></table>
  84 <a name="VERSION"></a>
  85 <h2>VERSION</h2>
  86
  87 <table width="100%" border=0 rules="none" frame="void"
  88        cols="2" cellspacing="0" cellpadding="0">
  89 <tr valign="top" align="left">
  90 <td width="10%"></td><td width="90%">
  91 c2lib-1.2.13</td></table>
  92 <a name="SEE ALSO"></a>
  93 <h2>SEE ALSO</h2>
  94
  95 <table width="100%" border=0 rules="none" frame="void"
  96        cols="2" cellspacing="0" cellpadding="0">
  97 <tr valign="top" align="left">
  98 <td width="10%"></td><td width="90%">
  99 <b>plane_coefficients(3)</b>,
 100 <b>point_distance_to_face(3)</b>.</td></table>
 101 <hr>
 102 </body>
 103 </html>