2024-03-13 14:22:22 -07:00
|
|
|
|
---
|
|
|
|
|
title: "angledLineToX"
|
|
|
|
|
excerpt: "Draw an angled line to a given x coordinate."
|
|
|
|
|
layout: manual
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Draw an angled line to a given x coordinate.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2024-03-13 15:43:42 -07:00
|
|
|
|
```js
|
2024-03-13 14:22:22 -07:00
|
|
|
|
angledLineToX(data: AngledLineToData, sketch_group: SketchGroup) -> SketchGroup
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Examples
|
|
|
|
|
|
2024-03-13 15:43:42 -07:00
|
|
|
|
```js
|
2024-03-13 14:22:22 -07:00
|
|
|
|
startSketchOn('XY')
|
|
|
|
|
|> startProfileAt([0, 0], %)
|
|
|
|
|
|> angledLineToX({ angle: 45, to: 10, tag: "edge1" }, %)
|
|
|
|
|
|> line([10, 10], %)
|
|
|
|
|
|> line([0, 10], %)
|
|
|
|
|
|> close(%, "edge2")
|
|
|
|
|
|> extrude(10, %)
|
|
|
|
|
|> fillet({ radius: 2, tags: ["edge1"] }, %)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Arguments
|
|
|
|
|
|
|
|
|
|
* `data`: `AngledLineToData` - Data to draw an angled line to a point. (REQUIRED)
|
2024-03-13 15:43:42 -07:00
|
|
|
|
```js
|
2024-03-13 14:22:22 -07:00
|
|
|
|
{
|
|
|
|
|
// The angle of the line.
|
|
|
|
|
angle: number,
|
|
|
|
|
// The tag.
|
|
|
|
|
tag: string,
|
|
|
|
|
// The point to draw to.
|
|
|
|
|
to: number,
|
|
|
|
|
} |
|
|
|
|
|
[number, number]
|
|
|
|
|
```
|
|
|
|
|
* `sketch_group`: `SketchGroup` - A sketch group is a collection of paths. (REQUIRED)
|
2024-03-13 15:43:42 -07:00
|
|
|
|
```js
|
2024-03-13 14:22:22 -07:00
|
|
|
|
{
|
|
|
|
|
// The plane id or face id of the sketch group.
|
|
|
|
|
entityId: uuid,
|
|
|
|
|
// The id of the sketch group.
|
|
|
|
|
id: uuid,
|
|
|
|
|
// What the sketch is on (can be a plane or a face).
|
|
|
|
|
on: {
|
|
|
|
|
// The id of the plane.
|
|
|
|
|
id: uuid,
|
|
|
|
|
// Origin of the plane.
|
|
|
|
|
origin: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
type: "plane",
|
|
|
|
|
// Type for a plane.
|
|
|
|
|
value: "XY" | "XZ" | "YZ" | "Custom",
|
|
|
|
|
// What should the plane’s X axis be?
|
|
|
|
|
xAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// What should the plane’s Y axis be?
|
|
|
|
|
yAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// The z-axis (normal).
|
|
|
|
|
zAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The id of the face.
|
|
|
|
|
id: uuid,
|
|
|
|
|
// The original sketch group id of the object we are sketching on.
|
|
|
|
|
sketchGroupId: uuid,
|
|
|
|
|
type: "face",
|
|
|
|
|
// The tag of the face.
|
|
|
|
|
value: string,
|
|
|
|
|
// What should the face’s X axis be?
|
|
|
|
|
xAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// What should the face’s Y axis be?
|
|
|
|
|
yAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// The z-axis (normal).
|
|
|
|
|
zAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
},
|
|
|
|
|
// The position of the sketch group.
|
|
|
|
|
position: [number, number, number],
|
|
|
|
|
// The rotation of the sketch group base plane.
|
|
|
|
|
rotation: [number, number, number, number],
|
|
|
|
|
// The starting path.
|
|
|
|
|
start: {
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
},
|
|
|
|
|
// The paths in the sketch group.
|
|
|
|
|
value: [{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "ToPoint",
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// arc's direction
|
|
|
|
|
ccw: string,
|
|
|
|
|
// the arc's center
|
|
|
|
|
center: [number, number],
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "TangentialArcTo",
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "TangentialArc",
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "Horizontal",
|
|
|
|
|
// The x coordinate.
|
|
|
|
|
x: number,
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "AngledLineTo",
|
|
|
|
|
// The x coordinate.
|
|
|
|
|
x: number,
|
|
|
|
|
// The y coordinate.
|
|
|
|
|
y: number,
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "Base",
|
|
|
|
|
}],
|
|
|
|
|
// The x-axis of the sketch group base plane in the 3D space
|
|
|
|
|
xAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// The y-axis of the sketch group base plane in the 3D space
|
|
|
|
|
yAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// The z-axis of the sketch group base plane in the 3D space
|
|
|
|
|
zAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Returns
|
|
|
|
|
|
|
|
|
|
`SketchGroup` - A sketch group is a collection of paths.
|
2024-03-13 15:43:42 -07:00
|
|
|
|
```js
|
2024-03-13 14:22:22 -07:00
|
|
|
|
{
|
|
|
|
|
// The plane id or face id of the sketch group.
|
|
|
|
|
entityId: uuid,
|
|
|
|
|
// The id of the sketch group.
|
|
|
|
|
id: uuid,
|
|
|
|
|
// What the sketch is on (can be a plane or a face).
|
|
|
|
|
on: {
|
|
|
|
|
// The id of the plane.
|
|
|
|
|
id: uuid,
|
|
|
|
|
// Origin of the plane.
|
|
|
|
|
origin: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
type: "plane",
|
|
|
|
|
// Type for a plane.
|
|
|
|
|
value: "XY" | "XZ" | "YZ" | "Custom",
|
|
|
|
|
// What should the plane’s X axis be?
|
|
|
|
|
xAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// What should the plane’s Y axis be?
|
|
|
|
|
yAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// The z-axis (normal).
|
|
|
|
|
zAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The id of the face.
|
|
|
|
|
id: uuid,
|
|
|
|
|
// The original sketch group id of the object we are sketching on.
|
|
|
|
|
sketchGroupId: uuid,
|
|
|
|
|
type: "face",
|
|
|
|
|
// The tag of the face.
|
|
|
|
|
value: string,
|
|
|
|
|
// What should the face’s X axis be?
|
|
|
|
|
xAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// What should the face’s Y axis be?
|
|
|
|
|
yAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// The z-axis (normal).
|
|
|
|
|
zAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
},
|
|
|
|
|
// The position of the sketch group.
|
|
|
|
|
position: [number, number, number],
|
|
|
|
|
// The rotation of the sketch group base plane.
|
|
|
|
|
rotation: [number, number, number, number],
|
|
|
|
|
// The starting path.
|
|
|
|
|
start: {
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
},
|
|
|
|
|
// The paths in the sketch group.
|
|
|
|
|
value: [{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "ToPoint",
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// arc's direction
|
|
|
|
|
ccw: string,
|
|
|
|
|
// the arc's center
|
|
|
|
|
center: [number, number],
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "TangentialArcTo",
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "TangentialArc",
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "Horizontal",
|
|
|
|
|
// The x coordinate.
|
|
|
|
|
x: number,
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "AngledLineTo",
|
|
|
|
|
// The x coordinate.
|
|
|
|
|
x: number,
|
|
|
|
|
// The y coordinate.
|
|
|
|
|
y: number,
|
|
|
|
|
} |
|
|
|
|
|
{
|
|
|
|
|
// The from point.
|
|
|
|
|
from: [number, number],
|
|
|
|
|
// The name of the path.
|
|
|
|
|
name: string,
|
|
|
|
|
// The to point.
|
|
|
|
|
to: [number, number],
|
|
|
|
|
type: "Base",
|
|
|
|
|
}],
|
|
|
|
|
// The x-axis of the sketch group base plane in the 3D space
|
|
|
|
|
xAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// The y-axis of the sketch group base plane in the 3D space
|
|
|
|
|
yAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
// The z-axis of the sketch group base plane in the 3D space
|
|
|
|
|
zAxis: {
|
|
|
|
|
x: number,
|
|
|
|
|
y: number,
|
|
|
|
|
z: number,
|
|
|
|
|
},
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|