modeling-app/docs/kcl/polygon.md

title, excerpt, layout

title	excerpt	layout
polygon	Create a regular polygon with the specified number of sides that is either inscribed or circumscribed around a circle of the specified radius.	manual

Create a regular polygon with the specified number of sides that is either inscribed or circumscribed around a circle of the specified radius.

polygon(
  sketchSurfaceOrGroup: [[Sketch](/docs/kcl/types/Sketch)OrSurface](/docs/kcl/types/[Sketch](/docs/kcl/types/Sketch)OrSurface),
  radius: [number](/docs/kcl/types/number),
  numSides: u64,
  center: [[[number](/docs/kcl/types/number)]](/docs/kcl/types/[number](/docs/kcl/types/number)),
  inscribed?: [bool](/docs/kcl/types/bool),
): [Sketch](/docs/kcl/types/Sketch)

Arguments

Name	Type	Description	Required
sketchSurfaceOrGroup	SketchOrSurface	Plane or surface to sketch on	Yes
radius	number	The radius of the polygon	Yes
numSides	u64	The number of sides in the polygon	Yes
center	[number]	The center point of the polygon	Yes
inscribed	bool	Whether the polygon is inscribed (true, the default) or circumscribed (false) about a circle with the specified radius	No

Returns

Sketch

Examples

// Create a regular hexagon inscribed in a circle of radius 10
hex = startSketchOn(XY)
  |> polygon(
       radius = 10,
       numSides = 6,
       center = [0, 0],
       inscribed = true,
     )

example = extrude(hex, length = 5)

// Create a square circumscribed around a circle of radius 5
square = startSketchOn(XY)
  |> polygon(
       radius = 5.0,
       numSides = 4,
       center = [10, 10],
       inscribed = false,
     )
example = extrude(square, length = 5)