Sample
Evenly spaced points along a shape's outline or a line.
Node id path/sample
The Sample node outputs count points along object's outline (for a
shape) or along the line (for a line), as an array, in order.
Inputs
| Name | Type | Default | Notes |
|---|---|---|---|
| object | Renderable | — | |
| count | number | 16 |
Outputs
Behaviour
- Count.
countdefaults to 16. It is exactly the number of points. - Open and closed. On a line, the first point is the start and the last one the end. On a shape, the points go once around and the start isn't repeated: 6 points on a circle are the corners of a hexagon.
- Spacing and start. The points are Point At
at equal steps of
t, so they start where Point At does. They're evenly spaced along the path, except on ellipses, Bezier curves and splines. - On the page. Points include the object's position, rotation and scale.
Errors
objectmust be a shape or a line. A group has no outline.countmust be a whole number, 0 or more.
Example
Seven points sampled on a circle, used as the vertices of a polygon: a heptagon inside the circle.