Documentation

pathElement
Question mark

A path through a list of points, connected by Bezier curves.

Example

#path(
  fill: blue.lighten(80%),
  stroke: blue,
  closed: true,
  (0pt, 50pt),
  (100%, 50pt),
  ((50%, 0pt), (40pt, 0pt)),
)
Preview

Parameters
Question mark

fill
none or color or gradient or pattern
Settable
Question mark

How to fill the path.

When setting a fill, the default stroke disappears. To create a rectangle with both fill and stroke, you have to configure both.

Default: none

fill-rule
str
Settable
Question mark

The drawing rule used to fill the path.

VariantDetails
"non-zero"

Specifies that "inside" is computed by a non-zero sum of signed edge crossings.

"even-odd"

Specifies that "inside" is computed by an odd number of edge crossings.

Default: "non-zero"

View example
// We use `.with` to get a new
// function that has the common
// arguments pre-applied.
#let star = path.with(
  fill: red,
  closed: true,
  (25pt, 0pt),
  (10pt, 50pt),
  (50pt, 20pt),
  (0pt, 20pt),
  (40pt, 50pt),
)

#star(fill-rule: "non-zero")
#star(fill-rule: "even-odd")
Preview

stroke
none or auto or length or color or gradient or stroke or pattern or dictionary
Settable
Question mark

How to stroke the path. This can be:

Can be set to none to disable the stroke or to auto for a stroke of 1pt black if and if only if no fill is given.

Default: auto

closed
bool
Settable
Question mark

Whether to close this path with one last bezier curve. This curve will takes into account the adjacent control points. If you want to close with a straight line, simply add one last point that's the same as the start point.

Default: false

vertices
array
RequiredPositional
Question mark
Variadic
Question mark

The vertices of the path.

Each vertex can be defined in 3 ways: