PostGIS  3.1.6dev-r@@SVN_REVISION@@

◆ point_in_cone()

static int point_in_cone ( const POINT3D A1,
const POINT3D A2,
const POINT3D P 
)
static

Utility function for checking if P is within the cone defined by A1/A2.

Definition at line 3449 of file lwgeodetic.c.

3450 {
3451  POINT3D AC; /* Center point of A1/A2 */
3452  double min_similarity, similarity;
3453 
3454  /* Boundary case */
3455  if (point3d_equals(A1, P) || point3d_equals(A2, P))
3456  return LW_TRUE;
3457 
3458  /* The normalized sum bisects the angle between start and end. */
3459  vector_sum(A1, A2, &AC);
3460  normalize(&AC);
3461 
3462  /* The projection of start onto the center defines the minimum similarity */
3463  min_similarity = dot_product(A1, &AC);
3464 
3465  /* If the edge is sufficiently curved, use the dot product test */
3466  if (fabs(1.0 - min_similarity) > 1e-10)
3467  {
3468  /* The projection of candidate p onto the center */
3469  similarity = dot_product(P, &AC);
3470 
3471  /* If the projection of the candidate is larger than */
3472  /* the projection of the start point, the candidate */
3473  /* must be closer to the center than the start, so */
3474  /* therefor inside the cone */
3475  if (similarity > min_similarity)
3476  {
3477  return LW_TRUE;
3478  }
3479  else
3480  {
3481  return LW_FALSE;
3482  }
3483  }
3484  else
3485  {
3486  /* Where the edge is very narrow, the dot product test */
3487  /* fails, but we can use the almost-planar nature of the */
3488  /* problem space then to test if the vector from the */
3489  /* candidate to the start point in a different direction */
3490  /* to the vector from candidate to end point */
3491  /* If so, then candidate is between start and end */
3492  POINT3D PA1, PA2;
3493  vector_difference(P, A1, &PA1);
3494  vector_difference(P, A2, &PA2);
3495  normalize(&PA1);
3496  normalize(&PA2);
3497  if (dot_product(&PA1, &PA2) < 0.0)
3498  {
3499  return LW_TRUE;
3500  }
3501  else
3502  {
3503  return LW_FALSE;
3504  }
3505  }
3506  return LW_FALSE;
3507 }
#define LW_FALSE
Definition: liblwgeom.h:108
#define LW_TRUE
Return types for functions with status returns.
Definition: liblwgeom.h:107
void normalize(POINT3D *p)
Normalize to a unit vector.
Definition: lwgeodetic.c:615
static void vector_difference(const POINT3D *a, const POINT3D *b, POINT3D *n)
Calculate the difference of two vectors.
Definition: lwgeodetic.c:476
static double dot_product(const POINT3D *p1, const POINT3D *p2)
Convert cartesian coordinates on unit sphere to lon/lat coordinates static void cart2ll(const POINT3D...
Definition: lwgeodetic.c:446
void vector_sum(const POINT3D *a, const POINT3D *b, POINT3D *n)
Calculate the sum of two vectors.
Definition: lwgeodetic.c:465
static int point3d_equals(const POINT3D *p1, const POINT3D *p2)
Utility function for ptarray_contains_point_sphere()
Definition: lwgeodetic.c:42

References dot_product(), LW_FALSE, LW_TRUE, normalize(), point3d_equals(), vector_difference(), and vector_sum().

Referenced by edge_intersects().

Here is the call graph for this function:
Here is the caller graph for this function: