2021-10-17 18:26:00 +02:00
|
|
|
---
|
2021-11-06 18:20:45 +01:00
|
|
|
title: Point.shiftTowards()
|
2021-10-17 18:26:00 +02:00
|
|
|
---
|
2021-08-25 16:09:31 +02:00
|
|
|
|
2022-09-29 16:27:52 +02:00
|
|
|
The `Point.shiftTowards()` method returns a new `Point` that is shifted
|
|
|
|
`distance` (mm) in the direction of the `target`.
|
2021-11-06 18:20:45 +01:00
|
|
|
|
2022-09-29 16:27:52 +02:00
|
|
|
## Signature
|
2021-11-06 19:03:54 +01:00
|
|
|
|
2021-08-25 16:09:31 +02:00
|
|
|
```js
|
|
|
|
Point point.shiftTowards(Point target, float distance)
|
|
|
|
```
|
|
|
|
|
2022-09-29 16:27:52 +02:00
|
|
|
## Example
|
2021-08-25 16:09:31 +02:00
|
|
|
|
2022-09-29 16:27:52 +02:00
|
|
|
<Example caption="An example of the Point.shiftTowards() method">
|
2021-08-25 16:09:31 +02:00
|
|
|
```js
|
2022-09-29 16:27:52 +02:00
|
|
|
({ 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)
|
2022-12-26 07:00:16 -08:00
|
|
|
.setText("Point C is point A shifted 3.5 cm\nin the direction of point B", "center, text-sm")
|
2022-09-29 16:27:52 +02:00
|
|
|
.attr("data-text-lineheight", 6)
|
2022-12-30 07:47:29 -08:00
|
|
|
|
2022-09-29 16:27:52 +02:00
|
|
|
paths.direction = new Path()
|
|
|
|
.move(points.A)
|
|
|
|
.line(points.B)
|
|
|
|
.addClass("note dashed")
|
2022-12-30 07:47:29 -08:00
|
|
|
|
2022-09-29 16:27:52 +02:00
|
|
|
macro("ld", {
|
|
|
|
from: points.C,
|
|
|
|
to: points.A,
|
2025-05-19 17:20:45 -07:00
|
|
|
d: -10,
|
|
|
|
force: true,
|
2022-09-29 16:27:52 +02:00
|
|
|
})
|
|
|
|
|
2025-05-19 17:20:45 -07:00
|
|
|
// Boundary box
|
|
|
|
paths.bbox = new Path()
|
|
|
|
.move(new Point(10,10))
|
|
|
|
.move(new Point(125,70))
|
|
|
|
|
2022-09-29 16:27:52 +02:00
|
|
|
return part
|
|
|
|
}
|
2021-08-25 16:09:31 +02:00
|
|
|
```
|
2022-09-29 16:27:52 +02:00
|
|
|
</Example>
|
|
|
|
|
|
|
|
|
|
|
|
## Notes
|
|
|
|
|
|
|
|
If you need to move a point a percentage instead of a specific distance, use
|
|
|
|
[`Point.shiftFractionTowards()`](/reference/api/point/shiftfractiontowards/)
|
|
|
|
instead.
|