Class Polyline

折线：穿过一列点的直线段链，以形如 { points, isClosed } 的普通对象保存。闭合折线将其最后一点连回第一点。这里的方法测量折线，将其转换为线段或直线，查找折线的交点，将零散线段排列成链，并为其角点确定圆角大小。长度以模型单位表示。

Index

Constructors

constructor

convert

reverse polylineToLines polylineToSegments

create

Constructors

constructor

new Polyline(
    vector: Bit.Vector,
    point: Bit.Point,
    line: Bit.Line,
    geometryHelper: GeometryHelper,
): Bit.Polyline
Parameters
- vector: Bit.Vector
- point: Bit.Point
- line: Bit.Line
- geometryHelper: GeometryHelper
Returns Bit.Polyline
- Defined in bitbybit-docs.d.ts:56305

convert

reverse

reverse(
inputs: Bit.Inputs.Polyline.PolylineDto,
): Bit.Inputs.Polyline.PolylinePropertiesDto
反转点的顺序，使折线反向。

给定折线自身的点列表被就地反转，并包装在一个新的折线对象中返回。示例：[[0,0,0], [1,0,0], [2,0,0]] -> [[2,0,0], [1,0,0], [0,0,0]]
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  折线
Returns Bit.Inputs.Polyline.PolylinePropertiesDto
点顺序反转后的折线
Example
```
const back = bitbybit.polyline.reverse({ polyline: { points: [[0, 0, 0], [1, 0, 0], [2, 0, 0]] } });
```
- Defined in bitbybit-docs.d.ts:56360

polylineToLines

polylineToLines(inputs: Bit.Inputs.Polyline.PolylineDto): Line3[]
将折线拆分为直线对象，每段一个，各有起点和终点。

闭合折线还会得到从其最后一个点回到第一个点的线段，除非两点重合。示例：三个点 -> 两条直线，闭合时为三条
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  折线
Returns Line3[]
每条线段一条直线，按顺序排列
Example
```
const lines = bitbybit.polyline.polylineToLines({ polyline: { points: [[0, 0, 0], [1, 0, 0], [1, 1, 0]], isClosed: true } });
```
- Defined in bitbybit-docs.d.ts:56410

polylineToSegments

polylineToSegments(inputs: Bit.Inputs.Polyline.PolylineDto): Segment3[]
将折线拆分为线段，每条是一对点。

闭合折线还会得到从其最后一个点回到第一个点的线段，除非两点重合。少于两个点不给出线段。示例：四个点，闭合 -> 绕环四条线段
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  折线
Returns Segment3[]
每条线段一对点，按顺序排列
Example
```
const segments = bitbybit.polyline.polylineToSegments({ polyline: { points: [[0, 0, 0], [1, 0, 0], [1, 1, 0]], isClosed: false } });
```
- Defined in bitbybit-docs.d.ts:56427

create

create(inputs: PolylineCreateDto): Bit.Inputs.Polyline.PolylinePropertiesDto
由点构建折线对象，开放或闭合。

示例：三个点，isClosed 为 true -> 一个三角形
Parameters
- inputs: PolylineCreateDto
  点以及最后一点是否连回第一点
Returns Bit.Inputs.Polyline.PolylinePropertiesDto
折线对象
Example
```
const triangle = bitbybit.polyline.create({ points: [[0, 0, 0], [1, 0, 0], [1, 1, 0]], isClosed: true });
```
- Defined in bitbybit-docs.d.ts:56393

fillet

maxFilletsHalfLine

maxFilletsHalfLine(inputs: PolylineToleranceDto): number[]
找出折线每个角的最大圆角，各自限制在其线段较近的一半内，使圆角永不重叠。

闭合折线包含其两端的两个角。少于三个点给出空列表。
Parameters
- inputs: PolylineToleranceDto
  折线和容差
Returns number[]
每个角点一个半径，按角点顺序排列
Example
```
const radii = bitbybit.polyline.maxFilletsHalfLine({
    polyline: { points: [[0, 0, 0], [10, 0, 0], [10, 10, 0], [0, 10, 0]], isClosed: true },
    tolerance: 1e-7,
});
```
- Defined in bitbybit-docs.d.ts:56508

safestFilletRadius

safestFilletRadius(inputs: PolylineToleranceDto): number
找出适合折线每个角的一个圆角半径：半线段规则下各角最大值中的最小者。

少于三个点，或任一角不允许圆角，给出 0。
Parameters
- inputs: PolylineToleranceDto
  折线和容差
Returns number
适用于每个角点的半径，以模型单位表示
Example
```
const radius = bitbybit.polyline.safestFilletRadius({
    polyline: { points: [[0, 0, 0], [10, 0, 0], [10, 10, 0], [0, 10, 0]], isClosed: true },
    tolerance: 1e-7,
});
```
- Defined in bitbybit-docs.d.ts:56527

get

length

length(inputs: Bit.Inputs.Polyline.PolylineDto): number
通过累加相邻点之间的直线距离来测量折线。

闭合折线的闭合线段不计入。示例：[[0,0,0], [3,0,0], [3,4,0]] -> 7
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  折线
Returns number
以模型单位表示的长度
Example
```
const len = bitbybit.polyline.length({ polyline: { points: [[0, 0, 0], [3, 0, 0], [3, 4, 0]] } });
```
- Defined in bitbybit-docs.d.ts:56321

countPoints

countPoints(inputs: Bit.Inputs.Polyline.PolylineDto): number
统计折线的点数。

示例：三个点 -> 3
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  折线
Returns number
点的数量
- Defined in bitbybit-docs.d.ts:56332

getPoints

getPoints(inputs: Bit.Inputs.Polyline.PolylineDto): Point3[]
从折线中读取点列表。

示例：{ points: [[0,0,0], [1,0,0]] } -> [[0,0,0], [1,0,0]]
Parameters
- inputs: Bit.Inputs.Polyline.PolylineDto
  折线
Returns Point3[]
其点，按顺序排列
- Defined in bitbybit-docs.d.ts:56343

intersection

twoPolylineIntersection

twoPolylineIntersection(inputs: TwoPolylinesToleranceDto): Point3[]
找出两条折线相交的点，将一条的每条线段与另一条的每条线段测试。

比容差更接近的交点只报告一次。示例：两条折线构成一个 X -> 中间的点
Parameters
- inputs: TwoPolylinesToleranceDto
  两条折线和容差
Returns Point3[]
交点；没有交点时为空
Example
```
const crossings = bitbybit.polyline.twoPolylineIntersection({
    polyline1: { points: [[0, 0, 0], [2, 2, 0]] },
    polyline2: { points: [[0, 2, 0], [2, 0, 0]] },
    tolerance: 1e-6,
});
```
- Defined in bitbybit-docs.d.ts:56468

intersections

polylineSelfIntersection

polylineSelfIntersection(inputs: PolylineToleranceDto): Point3[]
找出折线自相交的点。

相邻线段不互相测试，比容差更接近的交点只报告一次。示例：一个 8 字形 -> 它的那一个交点
Parameters
- inputs: PolylineToleranceDto
  折线和容差
Returns Point3[]
交点；没有交点时为空
Example
```
const crossings = bitbybit.polyline.polylineSelfIntersection({
    polyline: { points: [[0, 0, 0], [2, 2, 0], [2, 0, 0], [0, 2, 0]] },
    tolerance: 1e-6,
});
```
- Defined in bitbybit-docs.d.ts:56447

sort

sortSegmentsIntoPolylines

sortSegmentsIntoPolylines(inputs: SegmentsToleranceDto): Polyline3[]
通过匹配在容差内相接的端点，将零散的线段连接成折线。

首尾相连的线段每条链成为一条折线；不接触任何东西的线段成为单线段折线。示例：十条散落的线段构成两条链 -> 两条折线
Parameters
- inputs: SegmentsToleranceDto
  线段以及判定两个端点相接的容差
Returns Polyline3[]
由线段组成的折线
Example
```
const chains = bitbybit.polyline.sortSegmentsIntoPolylines({
    segments: [[[0, 0, 0], [1, 0, 0]], [[1, 0, 0], [1, 1, 0]], [[5, 5, 0], [6, 5, 0]]],
    tolerance: 1e-5,
});
```
- Defined in bitbybit-docs.d.ts:56488

transforms

transformPolyline

transformPolyline(
inputs: TransformPolylineDto,
): Bit.Inputs.Polyline.PolylinePropertiesDto
对折线的每个点应用一个变换矩阵，或按顺序应用一个矩阵列表。

示例：平移 [5,0,0] -> 每个点沿 X 移动 5
Parameters
- inputs: TransformPolylineDto
  折线和变换
Returns Bit.Inputs.Polyline.PolylinePropertiesDto
点经过变换的新折线
Example
```
const moved = bitbybit.polyline.transformPolyline({
    polyline: { points: [[0, 0, 0], [1, 0, 0]] },
    transformation: bitbybit.transforms.translationXYZ({ translation: [5, 0, 0] }),
});
```
- Defined in bitbybit-docs.d.ts:56378

Class Polyline

Index

Constructors

convert

create

fillet

get

intersection

intersections

sort

transforms

Constructors

constructor

Parameters

Returns Bit.Polyline

convert

reverse

Parameters

Returns Bit.Inputs.Polyline.PolylinePropertiesDto

Example

polylineToLines

Parameters

Returns Line3[]

Example

polylineToSegments

Parameters

Returns Segment3[]

Example

create

create

Parameters

Returns Bit.Inputs.Polyline.PolylinePropertiesDto

Example

fillet

maxFilletsHalfLine

Parameters

Returns number[]

Example

safestFilletRadius

Parameters

Returns number

Example

get

length

Parameters

Returns number

Example

countPoints

Parameters

Returns number

getPoints

Parameters

Returns Point3[]

intersection

twoPolylineIntersection

Parameters

Returns Point3[]

Example

intersections

polylineSelfIntersection

Parameters

Returns Point3[]

Example

sort

sortSegmentsIntoPolylines

Parameters

Returns Polyline3[]

Example

transforms

transformPolyline

Parameters

Returns Bit.Inputs.Polyline.PolylinePropertiesDto

Example

Settings

On This Page