modeling-app/docs/kcl-std/functions/std-sketch-xLine.md

title, subtitle, excerpt, layout

title	subtitle	excerpt	layout
xLine	Function in std::sketch	Draw a line relative to the current origin to a specified distance away from the current position along the 'x' axis.	manual

Draw a line relative to the current origin to a specified distance away from the current position along the 'x' axis.

exampleSketch = startSketchOn(XZ)
  |> startProfile(at = [0, 0])
  |> xLine(length = 15)
  |> angledLine(angle = 80deg, length = 15)
  |> line(end = [8, -10])
  |> xLine(length = 10)
  |> angledLine(angle = 120deg, length = 30)
  |> xLine(length = -15)
  |> close()

example = extrude(exampleSketch, length = 10)

Arguments

Name	Type	Description	Required
sketch	Sketch	Which sketch should this path be added to?	Yes
length	number(Length)	How far away along the X axis should this line go? Incompatible with endAbsolute.	No
endAbsolute	number(Length)	Which absolute X value should this line go to? Incompatible with length.	No
tag	TagDecl	Create a new tag which refers to this line.	No

Returns

Sketch - A sketch is a collection of paths.

Function signature

xLine(
  @sketch: Sketch,
  length?: number(Length),
  endAbsolute?: number(Length),
  tag?: TagDecl,
): Sketch

Examples

exampleSketch = startSketchOn(XZ)
  |> startProfile(at = [0, 0])
  |> xLine(length = 15)
  |> angledLine(angle = 80deg, length = 15)
  |> line(end = [8, -10])
  |> xLine(length = 10)
  |> angledLine(angle = 120deg, length = 30)
  |> xLine(length = -15)
  |> close()

example = extrude(exampleSketch, length = 10)