ed8a166ea9
This PR reverts the incorrect lint/prettier changes applied to <Example> code in the reference Core API docs l by the husky pre-commit hook, the problem mentioned in Issue #333. (These are just the changes for the Core API docs. Additional PRs will be filed for changes in the other reference, howtos, and guides documentation.) Co-authored-by: Benjamin Fan <ben-git@swinglonga.com> Reviewed-on: https://codeberg.org/freesewing/freesewing/pulls/367 Reviewed-by: Joost De Cock <joostdecock@noreply.codeberg.org> Co-authored-by: Benjamin Fan <benjamesben@noreply.codeberg.org> Co-committed-by: Benjamin Fan <benjamesben@noreply.codeberg.org>
73 lines
1.6 KiB
Text
73 lines
1.6 KiB
Text
---
|
|
title: utils.curvesIntersect()
|
|
---
|
|
|
|
The `utils.curvesIntersect()` function finds the intersections between two curves
|
|
described by 4 points each.
|
|
|
|
## Signature
|
|
|
|
```js
|
|
array | Point | false utils.curvesIntersect(
|
|
Point startA,
|
|
Point Cp1A,
|
|
Point Cp2A,
|
|
Point endA,
|
|
Point startB,
|
|
Point Cp1B,
|
|
Point Cp2B,
|
|
Point endB)
|
|
```
|
|
|
|
This returns `false` if no intersections are found,
|
|
a [Point](/reference/api/point) object if
|
|
a single intersection is found, and an array
|
|
of [Point](/reference/api/point) objects if
|
|
multiple intersections are found.
|
|
|
|
## Example
|
|
|
|
<Example caption="A Utils.curvesIntersect() example">
|
|
```js
|
|
({ Point, points, Path, paths, Snippet, snippets, utils, getId, part }) => {
|
|
|
|
points.A = new Point(10, 10)
|
|
points.Acp = new Point(310, 40)
|
|
points.B = new Point(110, 70)
|
|
points.Bcp = new Point(-210, 40)
|
|
|
|
points.C = new Point(20, -5)
|
|
points.Ccp = new Point(60, 300)
|
|
points.D = new Point(100, 85)
|
|
points.Dcp = new Point(70, -220)
|
|
paths.curveA = new Path()
|
|
.move(points.A)
|
|
.curve(points.Acp, points.Bcp, points.B)
|
|
paths.curveB = new Path()
|
|
.move(points.C)
|
|
.curve(points.Ccp, points.Dcp, points.D)
|
|
|
|
const intersections = utils.curvesIntersect(
|
|
points.A,
|
|
points.Acp,
|
|
points.Bcp,
|
|
points.B,
|
|
points.C,
|
|
points.Ccp,
|
|
points.Dcp,
|
|
points.D
|
|
)
|
|
|
|
if (intersections) {
|
|
if (intersections instanceof Array) {
|
|
for (const p of intersections)
|
|
snippets[getId()] = new Snippet('notch', p)
|
|
} else {
|
|
snippets[getId()] = new Snippet('notch', intersections)
|
|
}
|
|
}
|
|
|
|
return part
|
|
}
|
|
```
|
|
</Example>
|