PostGIS  3.0.6dev-r@@SVN_REVISION@@

◆ edge_intersects()

uint32_t edge_intersects ( const POINT3D A1,
const POINT3D A2,
const POINT3D B1,
const POINT3D B2 
)

Returns non-zero if edges A and B interact.

The type of interaction is given in the return value with the bitmask elements defined above.

Definition at line 3541 of file lwgeodetic.c.

3542 {
3543  POINT3D AN, BN, VN; /* Normals to plane A and plane B */
3544  double ab_dot;
3545  int a1_side, a2_side, b1_side, b2_side;
3546  int rv = PIR_NO_INTERACT;
3547 
3548  /* Normals to the A-plane and B-plane */
3549  unit_normal(A1, A2, &AN);
3550  unit_normal(B1, B2, &BN);
3551 
3552  /* Are A-plane and B-plane basically the same? */
3553  ab_dot = dot_product(&AN, &BN);
3554 
3555  if ( FP_EQUALS(fabs(ab_dot), 1.0) )
3556  {
3557  /* Co-linear case */
3558  if ( point_in_cone(A1, A2, B1) || point_in_cone(A1, A2, B2) ||
3559  point_in_cone(B1, B2, A1) || point_in_cone(B1, B2, A2) )
3560  {
3561  rv |= PIR_INTERSECTS;
3562  rv |= PIR_COLINEAR;
3563  }
3564  return rv;
3565  }
3566 
3567  /* What side of plane-A and plane-B do the end points */
3568  /* of A and B fall? */
3569  a1_side = dot_product_side(&BN, A1);
3570  a2_side = dot_product_side(&BN, A2);
3571  b1_side = dot_product_side(&AN, B1);
3572  b2_side = dot_product_side(&AN, B2);
3573 
3574  /* Both ends of A on the same side of plane B. */
3575  if ( a1_side == a2_side && a1_side != 0 )
3576  {
3577  /* No intersection. */
3578  return PIR_NO_INTERACT;
3579  }
3580 
3581  /* Both ends of B on the same side of plane A. */
3582  if ( b1_side == b2_side && b1_side != 0 )
3583  {
3584  /* No intersection. */
3585  return PIR_NO_INTERACT;
3586  }
3587 
3588  /* A straddles B and B straddles A, so... */
3589  if ( a1_side != a2_side && (a1_side + a2_side) == 0 &&
3590  b1_side != b2_side && (b1_side + b2_side) == 0 )
3591  {
3592  /* Have to check if intersection point is inside both arcs */
3593  unit_normal(&AN, &BN, &VN);
3594  if ( point_in_cone(A1, A2, &VN) && point_in_cone(B1, B2, &VN) )
3595  {
3596  return PIR_INTERSECTS;
3597  }
3598 
3599  /* Have to check if intersection point is inside both arcs */
3600  vector_scale(&VN, -1);
3601  if ( point_in_cone(A1, A2, &VN) && point_in_cone(B1, B2, &VN) )
3602  {
3603  return PIR_INTERSECTS;
3604  }
3605 
3606  return PIR_NO_INTERACT;
3607  }
3608 
3609  /* The rest are all intersects variants... */
3610  rv |= PIR_INTERSECTS;
3611 
3612  /* A touches B */
3613  if ( a1_side == 0 )
3614  {
3615  /* Touches at A1, A2 is on what side? */
3616  rv |= (a2_side < 0 ? PIR_A_TOUCH_RIGHT : PIR_A_TOUCH_LEFT);
3617  }
3618  else if ( a2_side == 0 )
3619  {
3620  /* Touches at A2, A1 is on what side? */
3621  rv |= (a1_side < 0 ? PIR_A_TOUCH_RIGHT : PIR_A_TOUCH_LEFT);
3622  }
3623 
3624  /* B touches A */
3625  if ( b1_side == 0 )
3626  {
3627  /* Touches at B1, B2 is on what side? */
3628  rv |= (b2_side < 0 ? PIR_B_TOUCH_RIGHT : PIR_B_TOUCH_LEFT);
3629  }
3630  else if ( b2_side == 0 )
3631  {
3632  /* Touches at B2, B1 is on what side? */
3633  rv |= (b1_side < 0 ? PIR_B_TOUCH_RIGHT : PIR_B_TOUCH_LEFT);
3634  }
3635 
3636  return rv;
3637 }
#define FP_EQUALS(A, B)
static int point_in_cone(const POINT3D *A1, const POINT3D *A2, const POINT3D *P)
Utility function for checking if P is within the cone defined by A1/A2.
Definition: lwgeodetic.c:3459
void vector_scale(POINT3D *n, double scale)
Scale a vector out by a factor.
Definition: lwgeodetic.c:487
static int dot_product_side(const POINT3D *p, const POINT3D *q)
Utility function for edge_intersects(), signum with a tolerance in determining if the value is zero.
Definition: lwgeodetic.c:3526
void unit_normal(const POINT3D *P1, const POINT3D *P2, POINT3D *normal)
Calculates the unit normal to two vectors, trying to avoid problems with over-narrow or over-wide cas...
Definition: lwgeodetic.c:541
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
#define PIR_A_TOUCH_LEFT
Definition: lwgeodetic.h:91
#define PIR_COLINEAR
Definition: lwgeodetic.h:89
#define PIR_INTERSECTS
Definition: lwgeodetic.h:88
#define PIR_A_TOUCH_RIGHT
Definition: lwgeodetic.h:90
#define PIR_B_TOUCH_RIGHT
Definition: lwgeodetic.h:92
#define PIR_B_TOUCH_LEFT
Definition: lwgeodetic.h:93
#define PIR_NO_INTERACT
Bitmask elements for edge_intersects() return value.
Definition: lwgeodetic.h:87

References dot_product(), dot_product_side(), FP_EQUALS, PIR_A_TOUCH_LEFT, PIR_A_TOUCH_RIGHT, PIR_B_TOUCH_LEFT, PIR_B_TOUCH_RIGHT, PIR_COLINEAR, PIR_INTERSECTS, PIR_NO_INTERACT, point_in_cone(), unit_normal(), and vector_scale().

Referenced by circ_tree_contains_point(), circ_tree_distance_tree_internal(), lwpoly_intersects_line(), ptarray_contains_point_sphere(), ptarray_distance_spheroid(), and test_edge_intersects().

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