60 lines
90 KiB
Markdown
60 lines
90 KiB
Markdown
---
|
|
title: "xLine"
|
|
subtitle: "Function in std::sketch"
|
|
excerpt: "Draw a line relative to the current origin to a specified distance away from the current position along the 'x' axis."
|
|
layout: manual
|
|
---
|
|
|
|
Draw a line relative to the current origin to a specified distance away from the current position along the 'x' axis.
|
|
|
|
```kcl
|
|
xLine(
|
|
@sketch: Sketch,
|
|
length?: number(Length),
|
|
endAbsolute?: number(Length),
|
|
tag?: tag,
|
|
): Sketch
|
|
```
|
|
|
|
|
|
|
|
### Arguments
|
|
|
|
| Name | Type | Description | Required |
|
|
|----------|------|-------------|----------|
|
|
| `sketch` | [`Sketch`](/docs/kcl-std/types/std-types-Sketch) | Which sketch should this path be added to? | Yes |
|
|
| `length` | [`number(Length)`](/docs/kcl-std/types/std-types-number) | How far away along the X axis should this line go? Incompatible with `endAbsolute`. | No |
|
|
| `endAbsolute` | [`number(Length)`](/docs/kcl-std/types/std-types-number) | Which absolute X value should this line go to? Incompatible with `length`. | No |
|
|
| [`tag`](/docs/kcl-std/types/std-types-tag) | [`tag`](/docs/kcl-std/types/std-types-tag) | Create a new tag which refers to this line. | No |
|
|
|
|
### Returns
|
|
|
|
[`Sketch`](/docs/kcl-std/types/std-types-Sketch) - A sketch is a collection of paths.
|
|
|
|
|
|
### Examples
|
|
|
|
```kcl
|
|
exampleSketch = startSketchOn(XZ)
|
|
|> startProfile(at = [0, 0])
|
|
|> xLine(length = 15)
|
|
|> angledLine(
|
|
angle = 80,
|
|
length = 15,
|
|
)
|
|
|> line(end = [8, -10])
|
|
|> xLine(length = 10)
|
|
|> angledLine(
|
|
angle = 120,
|
|
length = 30,
|
|
)
|
|
|> xLine(length = -15)
|
|
|> close()
|
|
|
|
example = extrude(exampleSketch, length = 10)
|
|
```
|
|
|
|
|
|
|
|
|