chore: Port FreeSewing.dev to docusaurus
The replaces the NextJS site powering FreeSewing.dev with a Docusaurus setup. It's part of my efforts to simplify FreeSewing's setup so we can focus on our core value proposition.
This commit is contained in:
parent
497633d1d3
commit
ab3204f9f1
692 changed files with 11037 additions and 20674 deletions
|
@ -0,0 +1,77 @@
|
|||
---
|
||||
title: utils.curveParameterFromPoint()
|
||||
---
|
||||
|
||||
The `utils.curveParameterFromPoint()` function calculates where the point `check` lies on a
|
||||
curve described by points `start`, `cp1`, `cp2`, and `end`.
|
||||
|
||||
For example a return value of 0 indicates that the given point is the start of the curve, a return value
|
||||
of 1 indicated that the given point is identical to the end of the curve.
|
||||
|
||||
A return value of 0.5 indicates that the start point and the first control point had the same influence
|
||||
as the end point and the second control point, to create the checked point, but this doesn't necessarily mean
|
||||
that the point lies exactly half-way on the curve.
|
||||
|
||||
This method returns `false` if the point isn't (approximately) located on the curve.
|
||||
|
||||
## Signature
|
||||
|
||||
```js
|
||||
number|false utils.curveParameterFromPoint(
|
||||
Point start,
|
||||
Point cp1,
|
||||
Point cp2,
|
||||
Point end,
|
||||
Point check
|
||||
)
|
||||
```
|
||||
|
||||
## Example
|
||||
|
||||
<Example caption="A Utils.curveParameterFromPoint() example">
|
||||
```js
|
||||
({ Point, points, Path, paths, Snippet, snippets, getId, utils, part }) => {
|
||||
|
||||
points.start = new Point(10, 10)
|
||||
points.cp1 = new Point(90, 30)
|
||||
points.cp2 = new Point(10, 40)
|
||||
points.end = new Point(90, 60)
|
||||
|
||||
const scatter = []
|
||||
for (let i = 1; i < 19; i++) {
|
||||
for (let j = 1; j < 14; j++) {
|
||||
scatter.push(new Point(i * 10, j * 10))
|
||||
}
|
||||
}
|
||||
let snippet
|
||||
for (let point of scatter) {
|
||||
let t = utils.curveParameterFromPoint(
|
||||
points.start,
|
||||
points.cp1,
|
||||
points.cp2,
|
||||
points.end,
|
||||
point
|
||||
)
|
||||
if(t !== false) {
|
||||
points[getId()] = point.addText(` ${Math.round(t * 100) / 100}`, 'text-sm')
|
||||
snippets[getId()] = new Snippet('notch', point)
|
||||
}
|
||||
}
|
||||
paths.curve = new Path()
|
||||
.move(points.start)
|
||||
.curve(points.cp1, points.cp2, points.end)
|
||||
.addClass("fabric stroke-lg")
|
||||
|
||||
return part
|
||||
}
|
||||
```
|
||||
</Example>
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
Keep in mind that calculations with Bézier curves are often approximations.
|
||||
|
||||
This method is mostly used as internal building block for methods like
|
||||
`utils.pointOnCurve()`, `Path.split()` or `Path.angleAt()` and probably is not very relevant
|
||||
for direct usage from pattern code.
|
Loading…
Add table
Add a link
Reference in a new issue