2021-10-17 18:26:00 +02:00
|
|
|
---
|
2021-11-06 18:20:45 +01:00
|
|
|
title: Point.translate()
|
2021-10-17 18:26:00 +02:00
|
|
|
---
|
2021-11-06 18:20:45 +01:00
|
|
|
|
|
|
|
Returns a new `Point` with a [translate transform](https://developer.mozilla.org/en-US/docs/Web/CSS/transform-function/translate) applied.
|
|
|
|
|
2021-11-06 19:03:54 +01:00
|
|
|
## Point.translate() signature
|
|
|
|
|
2021-08-25 16:09:31 +02:00
|
|
|
```js
|
|
|
|
Point point.translate(float deltaX, float deltaY)
|
|
|
|
```
|
|
|
|
|
|
|
|
In other words, this will:
|
|
|
|
|
2022-02-20 14:44:38 +01:00
|
|
|
- Add `deltaX` to the point's X-coordinate
|
|
|
|
- Add `deltaY` to the point's Y-coordinate
|
2021-11-06 18:20:45 +01:00
|
|
|
|
|
|
|
Positive values for `deltaX` will move the point to the right. Positive values for `deltaY` will move the point downwards.
|
2021-08-25 16:09:31 +02:00
|
|
|
|
2021-11-06 19:03:54 +01:00
|
|
|
## Point.translate() example
|
|
|
|
|
2022-01-19 11:31:39 +01:00
|
|
|
<Example part="point_translate">
|
|
|
|
An example of the Point.translate() method
|
|
|
|
</Example>
|
2021-08-25 16:09:31 +02:00
|
|
|
|
|
|
|
```js
|
|
|
|
let { Point, points, Snippet, snippets, macro } = part.shorthand();
|
|
|
|
|
|
|
|
points.A = new Point(10, 10).attr("data-text", "Point A");
|
|
|
|
points.B = points.A.translate(120, 60)
|
|
|
|
.attr(
|
|
|
|
"data-text",
|
|
|
|
"Point B is point A with a\ntranslate(120, 60)\ntransform applied"
|
|
|
|
)
|
|
|
|
.attr("data-text-class", "right")
|
|
|
|
.attr("data-text-dy", -6)
|
|
|
|
.attr("data-text-lineheight", 6);
|
|
|
|
|
|
|
|
snippets.A = new Snippet("x", points.A);
|
|
|
|
snippets.B = new Snippet("x", points.B);
|
|
|
|
|
|
|
|
macro("ld", {
|
|
|
|
from: points.A,
|
|
|
|
to: points.B,
|
|
|
|
text: "translate(120,60)",
|
|
|
|
noStartMarker: true
|
|
|
|
});
|
|
|
|
```
|