• 
• 
• Reference
• 
• Visualize
• 
• Polygon

polygonElement

Element functions can be customized with set and show rules.

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

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

fill

none or color or gradient or pattern

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

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.

Currently all polygons are filled according to the non-zero winding rule.

Default: none

stroke

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

Settable

Settable parameters can be customized for all following uses of the function with a set rule.

How to stroke the polygon. 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

vertices

array

RequiredPositional

Positional parameters are specified in order, without names.

Variadic

Variadic parameters can be specified multiple times.

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

Definitions

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

regular

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

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

fill

none or color or gradient or pattern

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 pattern 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

PatternPrevious page

RectangleNext page