`polygon`Element

A closed polygon.

The polygon is defined by its corner points and is closed automatically.

Example

#polygon(
  fill: blue.lighten(80%),
  stroke: blue,
  (20%, 0pt),
  (60%, 0pt),
  (80%, 2cm),
  (0%,  2cm),
)

Parameters

polygon(

fill: none color gradient tiling,fill-rule: str,stroke: none auto length color gradient stroke tiling dictionary,..array,

) -> content

`fill`

none or color or gradient or tiling
Settable

How to fill the polygon.

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

The drawing rule used to fill the polygon.

See the curve documentation for an example.

Variant	Details
`"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"

`stroke`

none or auto or length or color or gradient or stroke or tiling or dictionary
Settable

How to stroke the polygon.

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

Default: auto

`vertices`

array
Required Positional

Variadic

The vertices of the polygon. Each point is specified as an array of two relative lengths.

Definitions

`regular`

A regular polygon, defined by its size and number of vertices.

View example

#polygon.regular(
  fill: blue.lighten(80%),
  stroke: blue,
  size: 30pt,
  vertices: 3,
)

polygon.regular(

fill: none color gradient tiling,stroke: none auto length color gradient stroke tiling dictionary,size: length,vertices: int,

) -> content

`fill`

none or color or gradient or tiling

How to fill the polygon. See the general polygon's documentation for more details.

`stroke`

none or auto or length or color or gradient or stroke or tiling or dictionary

How to stroke the polygon. See the general polygon's documentation for more details.

`size`

length

The diameter of the circumcircle of the regular polygon.

Default: 1em

`vertices`

int

The number of vertices in the polygon.

Default: 3

PathPrevious page

RectangleNext page

Example

Parameters Question mark Parameters are the inputs to a function. They are specified in parentheses after the function name.

fill none or color or gradient or tiling Settable Question mark Settable parameters can be customized for all following uses of the function with a set rule.

fill-rule str Settable Question mark Settable parameters can be customized for all following uses of the function with a set rule.

stroke none or auto or length or color or gradient or stroke or tiling or dictionary Settable Question mark Settable parameters can be customized for all following uses of the function with a set rule.

vertices array Required Positional Question mark Positional parameters are specified in order, without names. Variadic Question mark Variadic parameters can be specified multiple times.

Definitions Question mark Functions and types can have associated definitions. These are accessed by specifying the function or type, followed by a period, and then the definition's name.

regular

fill none or color or gradient or tiling

stroke none or auto or length or color or gradient or stroke or tiling or dictionary

size length

vertices int