1
0
Fork 0
freesewing/sites/dev/docs/reference/api/utils/curvesintersect
Benjamin Fan ed8a166ea9 fix(reference:api): Revert incorrect Example formatting (#367)
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>
2025-05-19 08:04:05 +02:00
..
readme.mdx fix(reference:api): Revert incorrect Example formatting (#367) 2025-05-19 08:04:05 +02:00

---
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>