›› RegionOps

Examples of `RegionOps`

RegionOps.splitPathsByRegionInOnOutXY

This splits any curve into parts in, on, and outside an xy region.


25 points
split the black path into parts inside and outside the grey area	`const splitParts = RegionOps.splitPathsByRegionInOnOutXY(path, loop);`
(red) Path parts "inside" the region `splitParts.insideParts`
(green) Path parts "outside" the region `splitParts.outsideParts`

Remarks

Using a closed region as the cutter is a specialized high level operation, just one of the many ways that splitting may be needed. It is a combination of


a split step uses the region boundary curves but not the interior/exterior properties.	`const splitPaths = RegionOps.splitToPathsBetweenFlagBreaks ((pathWithIntersectionMarkup, true);`
a classification step tests one point from each fragment of the `splitPaths`:
(a) obtain one point on a fragment being tested	`const pointOnChild = CurveCollection.createCurveLocationDetailOnAnyCurvePrimiitive(splitPaths);`
(b) determine if that single point is inside or outside. since the fragments have no interior crossings, that point classifies the whole fragment	`const inOnOut = RegionOps.testPointInOnOutRegionXY(region, pointOnChild.point.x, pointOnChild.point.y);`

Unit Test

source: core\geometry\src\test\topology\RegionOps.test.ts
test name: "InOutSplits"
output: core\geometry\src\test\output\RegionOps\InOutSplits.imjs

RegionOps.testPointInOnOutRegionXY

This tests whether single points are in, out, or on an xy region.


Parity region with various test points circle is "on" diamond is "in" plus is "out"

Unit Test

source: core\geometry\src\test\topology\RegionOps.test.ts
test name: "MixedInOut"
output: core\geometry\src\test\output\RegionOps\MixedInOut.imjs

RegionOps.regionBooleanXY

Compute union, intersection, and difference among area regions.

The call form is RegionOps.regionBooleanXY(regionA, regionB, opcode) where

Each of regionA and regionB may be
- a single Loop
- a single ParityRegion
- an array of Loop and ParityRegion
  - all the loops and parity regions within each array are considered as a union.
The operation between regionA and regionB is one of
- RegionBinaryOpType.Union
- RegionBinaryOpType.Intersection
- RegionBinaryOpType.AMinusB
- RegionBinaryOpType.BMinusA

For a first example, each of regionA and regionB is a single Loop:


filletedRectangle = CurveFactory.createRectangleXY(0, 0, 5, 4, 0, 1);
splitter = CurveFactory.createRectangleXY(1, -1, 6, 2);
Both regions, placed for operations
union = RegionOps.regionBooleanXY(filletedRectangle, splitter, RegionBinaryOpType.Union);
intersection = RegionOps.regionBooleanXY(filletedRectangle, splitter, RegionBinaryOpType.Intersection);
diff = RegionOps.regionBooleanXY(filletedRectangle, splitter, RegionBinaryOpType.AMinusB);

For a second example, each of regionA and regionB is an array of regions to be treated as a union:

region A is constructed by

const manyRoundedRectangles = []; for (let a = 0; a < 5; a += 1) { manyRoundedRectangles.push(CurveFactory.createRectangleXY(a, a, a + 4, a + 1.75, 0, 0.5)); }
and region B by

const splitterB0 = CurveFactory.createRectangleXY(0.5, 0.4, 6, 2.1, 0, 0); const splitterB1 = splitterB0.cloneTransformed(Transform.createFixedPointAndMatrix({ x: 1, y: 2, z: 0 }, Matrix3d.createRotationAroundAxisIndex(2, Angle.createDegrees(40)))) as Loop; const splitterB = [splitterB0, splitterB1];


region A
region B
Both regions, placed for operations
unionB = RegionOps.regionBooleanXY(manyRoundedRectangles, splitterB, RegionBinaryOpType.Union);
intersectionB = RegionOps.regionBooleanXY(manyRoundedRectangles, splitterB, RegionBinaryOpType.Intersection);
diffB = RegionOps.regionBooleanXY(manyRoundedRectangles, splitterB, RegionBinaryOpType.AMinusB);