1
0
Fork 0

chore(markdown): Updated Point.shiftTowards() docs

This commit is contained in:
Joost De Cock 2022-09-29 16:27:52 +02:00
parent a28420f6f4
commit f83b9f14ea

View file

@ -2,43 +2,48 @@
title: Point.shiftTowards() title: Point.shiftTowards()
--- ---
Returns a new `Point` that is shifted `distance` (mm) in the direction of the `target`. The `Point.shiftTowards()` method returns a new `Point` that is shifted
`distance` (mm) in the direction of the `target`.
If you need to move a point a percentage instead of a specific distance, use [`Point.shiftFractionTowards()`](/reference/api/point/shiftfractiontowards/) instead. ## Signature
## Point.shiftTowards() signature
```js ```js
Point point.shiftTowards(Point target, float distance) Point point.shiftTowards(Point target, float distance)
``` ```
## Point.shiftTowards() example ## Example
<Example part="point_shifttowards"> <Example caption="An example of the Point.shiftTowards() method">
An example of the Point.shiftTowards() method ```js
({ Point, points, Path, paths, macro, part }) => {
points.A = new Point(90, 70).setText("Point A", "right text-sm")
points.B = new Point(10, 10).setText("Point B", "text-sm")
points.C = points.A.shiftTowards(points.B, 35)
.setText("Point C is point A shifted 3.5cm\nin the direction of point B", "center, text-sm")
.attr("data-text-lineheight", 6)
paths.direction = new Path()
.move(points.A)
.line(points.B)
.addClass("note dashed")
macro("ld", {
from: points.C,
to: points.A,
d: -10
})
return part
}
```
</Example> </Example>
```js
let { Point, points, Path, paths, macro } = part.shorthand();
points.A = new Point(90, 70).attr("data-text", "Point A"); ## Notes
points.B = new Point(10, 10).attr("data-text", "Point B");
points.C = points.A.shiftTowards(points.B, 35) If you need to move a point a percentage instead of a specific distance, use
.attr( [`Point.shiftFractionTowards()`](/reference/api/point/shiftfractiontowards/)
"data-text", instead.
"Point C is point A shifted 3.5cm\nin the direction of point B"
)
.attr("data-text-class", "center")
.attr("data-text-lineheight", 6);
paths.direction = new Path()
.move(points.A)
.line(points.B)
.attr("class", "note dashed");
macro("ld", {
from: points.C,
to: points.A,
d: -10
});
```