@itwin/core-geometry 5.1.0-dev.3 → 5.1.0-dev.32

package/lib/esm/geometry3d/Range.js

@@ -646,8 +646,20 @@ export class Range3d extends RangeBase {
             && other.high.y <= this.high.y
             && other.high.z <= this.high.z;
     }
-    /** Test if there is any intersection with other range */
-    intersectsRange(other) {
+    /**
+     * Test if there is any intersection with the other range.
+     * @param other the other range.
+     * @param margin optional signed distance by which to expand/shrink `other` in all directions.
+     */
+    intersectsRange(other, margin) {
+        if (margin) {
+            return !(this.low.x > other.high.x + margin
+                || this.low.y > other.high.y + margin
+                || this.low.z > other.high.z + margin
+                || other.low.x > this.high.x + margin
+                || other.low.y > this.high.y + margin
+                || other.low.z > this.high.z + margin);
+        }
         return !(this.low.x > other.high.x
             || this.low.y > other.high.y
             || this.low.z > other.high.z
@@ -655,8 +667,18 @@ export class Range3d extends RangeBase {
             || other.low.y > this.high.y
             || other.low.z > this.high.z);
     }
-    /** Test if there is any intersection with other range, ignoring z. */
-    intersectsRangeXY(other) {
+    /**
+     * Test if there is any intersection with the other range, ignoring z.
+     * @param other the other range.
+     * @param margin optional signed distance by which to expand/shrink `other` in all xy-directions.
+     */
+    intersectsRangeXY(other, margin) {
+        if (margin) {
+            return !(this.low.x > other.high.x + margin
+                || this.low.y > other.high.y + margin
+                || other.low.x > this.high.x + margin
+                || other.low.y > this.high.y + margin);
+        }
         return !(this.low.x > other.high.x
             || this.low.y > other.high.y
             || other.low.x > this.high.x
@@ -672,7 +694,7 @@ export class Range3d extends RangeBase {
     distanceToRange(other) {
         return Math.min(Geometry.hypotenuseXYZ(RangeBase.rangeToRangeAbsoluteDistance(this.low.x, this.high.x, other.low.x, other.high.x), RangeBase.rangeToRangeAbsoluteDistance(this.low.y, this.high.y, other.low.y, other.high.y), RangeBase.rangeToRangeAbsoluteDistance(this.low.z, this.high.z, other.low.z, other.high.z)), RangeBase._EXTREME_POSITIVE);
     }
-    /** Expand this range by distances a (possibly signed) in all directions */
+    /** Expand this range to include the given point. */
     extendXYZ(x, y, z) {
         if (x < this.low.x)
             this.low.x = x;
@@ -698,28 +720,28 @@ export class Range3d extends RangeBase {
             this.extendXYZ(xyz1.x + g * (xyz0.x - xyz1.x), xyz1.y + g * (xyz0.y - xyz1.y), xyz1.z + g * (xyz0.z - xyz1.z));
         }
     }
-    /** Expand this range by distances a in only the x direction.  */
+    /** Expand this range to include the x-coordinate. */
     extendXOnly(x) {
         if (x < this.low.x)
             this.low.x = x;
         if (x > this.high.x)
             this.high.x = x;
     }
-    /** Expand this range by distances a in only the x direction.  */
+    /** Expand this range to include the y-coordinate. */
     extendYOnly(y) {
         if (y < this.low.y)
             this.low.y = y;
         if (y > this.high.y)
             this.high.y = y;
     }
-    /** Expand this range by distances a in only the x direction.  */
+    /** Expand this range to include the z-coordinate. */
     extendZOnly(z) {
         if (z < this.low.z)
             this.low.z = z;
         if (z > this.high.z)
             this.high.z = z;
     }
-    /** Expand one component of this range  */
+    /** Expand this range to include the specified coordinate `a`. */
     extendSingleAxis(a, axisIndex) {
         if (axisIndex === AxisIndex.X)
             this.extendXOnly(a);
@@ -733,7 +755,7 @@ export class Range3d extends RangeBase {
         if (!Geometry.isSmallMetricDistance(w))
             this.extendXYZ(x / w, y / w, z / w);
     }
-    /** Expand this range to include a point. */
+    /** Expand this range to include an optionally transformed point. */
     extendPoint(point, transform) {
         if (transform) {
             this.extendTransformedXYZ(transform, point.x, point.y, point.z);