Files
modeling-app/docs/kcl-std/functions/std-sketch-close.md
Nick Cameron 3936017f10 Tag types (#7458)
* Replace tag type with tagIdent and tagDecl

Signed-off-by: Nick Cameron <nrc@ncameron.org>

* Replace tagIdent with TaggedEdge and TaggedFace

Signed-off-by: Nick Cameron <nrc@ncameron.org>

---------

Signed-off-by: Nick Cameron <nrc@ncameron.org>
2025-06-16 09:10:36 +12:00

169 KiB

title, subtitle, excerpt, layout
title subtitle excerpt layout
close Function in std::sketch Construct a line segment from the current origin back to the profile's origin, ensuring the resulting 2-dimensional sketch is not open-ended. manual

Construct a line segment from the current origin back to the profile's origin, ensuring the resulting 2-dimensional sketch is not open-ended.

close(
  @sketch: Sketch,
  tag?: TagDecl,
): Sketch

If you want to perform some 3-dimensional operation on a sketch, like extrude or sweep, you must close it first. close must be called even if the end point of the last segment is coincident with the sketch starting point.

Arguments

Name Type Description Required
sketch Sketch The sketch you want to close. Yes
tag TagDecl Create a new tag which refers to this line. No

Returns

Sketch - A sketch is a collection of paths.

Examples

startSketchOn(XZ)
  |> startProfile(at = [0, 0])
  |> line(end = [10, 10])
  |> line(end = [10, 0])
  |> close()
  |> extrude(length = 10)

Rendered example of close 0

exampleSketch = startSketchOn(-XZ)
  |> startProfile(at = [0, 0])
  |> line(end = [10, 0])
  |> line(end = [0, 10])
  |> close()

example = extrude(exampleSketch, length = 10)

Rendered example of close 1