Skip to main content

KPolylineCurve2d

kds-plugin-document / Exports / KPolylineCurve2d

Interface: KPolylineCurve2d

KPolylineCurve2d 类代表着二维空间中的一个折线段。

The KPolylineCurve2d class represents a polyline in 2d space.

Hierarchy​

Table of contents​

Properties​

Methods​

Properties​

endPoint​

• Readonly endPoint: KPoint2d

获得轮廓线的终点。

Get bounded curve's end point.

Inherited from​

KBoundedCurve2d.endPoint

Defined in​

api.d.ts:7345

length​

• Readonly length: number

获得轮廓线的长度。

Get bounded curve's length.

Inherited from​

KBoundedCurve2d.length

Defined in​

api.d.ts:7357

middlePoint​

• Readonly middlePoint: KPoint2d

获得轮廓线的中点。

Get bounded curve's middle point.

Inherited from​

KBoundedCurve2d.middlePoint

Defined in​

api.d.ts:7351

params​

• Readonly params: number[]

获取当前折线段每个顶点的弧长参数。

Get arc length parameters of all the vertices of the polyline.

Defined in​

api.d.ts:11706

points​

• Readonly points: KPoint2d[]

获取当前折线段的所有顶点。

Get all the vertices of the polyline.

Defined in​

api.d.ts:11700

startPoint​

• Readonly startPoint: KPoint2d

获得轮廓线的起点。

Get bounded curve's start point.

Inherited from​

KBoundedCurve2d.startPoint

Defined in​

api.d.ts:7339

Methods​

clone​

▸ clone(): KCurve2d

复制一个当前曲线。

Return the cloned curve of this.

Returns​

KCurve2d

复制的曲线。

The cloned curve.

Inherited from​

KBoundedCurve2d.clone

Defined in​

api.d.ts:8226

getApproximatePointsInfoByNormalTol​

▸ getApproximatePointsInfoByNormalTol(normTol?, areaTol?): Object

对当前有界曲线进行离散，保证相邻两点之间的法向夹角小于给定值，相邻两点之间的曲线段和弦之间的近似三角形面积小于给定值。

Discretize bounded curve to points with specified normal tolerance and area tolerance.

Parameters​

NameTypeDescription
normTol?number相邻两点之间法向夹角误差（angle < acos(1-normTol)）。 如果没有输入法向误差值或者输入值过小（<1.0e-6）或者过大（>1.0 - 1.0e-6），则默认会采用0.01。 The normal tolerance between two adjacent points (angle < acos(1-normTol)). If normTol is not provided or the value is too small(<1.0e-6) or too big(>1.0 - 1.0e-6), then it will use default value 0.01.
areaTol?number相邻两点之间的曲线段和弦之间的近似三角形面积。 如果没有输入面积值或者面积值过小（<1.0e-6）, 则不使用面积误差作为判断条件。 The approximate area between the bounded curve and the chord of two adjacent points. If the area is not provided or the vlaue is too small(<1.0e-6), then the check condition will not use the area.

Returns​

Object

离散点列和它们的参数值。

The approximate points info which contains the point locations and parameters.

NameType
paramsnumber[]
pointsKPoint2d[]

Inherited from​

KBoundedCurve2d.getApproximatePointsInfoByNormalTol

Defined in​

api.d.ts:7401

getApproximatePointsInfoByRatio​

▸ getApproximatePointsInfoByRatio(ratio?, areaTol?): Object

对当前有界曲线进行离散，保证相邻两点之间的弦高和弦长之比小于给定的比例值，相邻两点之间的曲线段和弦之间的近似三角形面积小于给定值。

Discretize bounded curve to points with specified ratio and area tolerance.

Parameters​

NameTypeDescription
ratio?number相邻两点之间曲线段的弦高和弦长之比。 如果没有输入弦高和弦长比例值或者输入值不在（0，1）之间，则默认会采用0.1。 ratio = sagitta / chord length. If ratio is not provided or the value is not between (0,1), then it will use ratio = 0.1 to discretize the bounded curve.
areaTol?number相邻两点之间的曲线段和弦之间的近似三角形面积。 如果没有输入面积值或者面积值过小（<1.0e-6）, 则不使用面积误差作为判断条件。 The approximate area between the bounded curve and the chord of two adjacent points. If the area is not provided or the vlaue is too small(<1.0e-6), then the check condition will not use the area.

Returns​

Object

离散点列和它们的参数值。

The approximate points info which contains the point locations and parameters.

NameType
paramsnumber[]
pointsKPoint2d[]

Inherited from​

KBoundedCurve2d.getApproximatePointsInfoByRatio

Defined in​

api.d.ts:7379

getBounding​

▸ getBounding(): KBoundingBox2d

获得当前有界曲线的轴对齐的包围盒。

Get the Axis-aligned bounding box of the bounded curve

Returns​

KBoundingBox2d

轴对齐的包围盒

the Axis-aligned bounding box

Inherited from​

KBoundedCurve2d.getBounding

Defined in​

api.d.ts:7451

getClosestPoint​

▸ getClosestPoint(point, tolerance?): KPoint2d

获得在指定容差下曲线上距离传入点最近的一点。

Get the closest point on curve for the input point with specified tolerance.

Parameters​

NameTypeDescription
pointKPoint2d传入点。 The input point.
tolerance?number指定容差，默认容差是1e-6。 The specified tolerance.The default value is 1e-6.

Returns​

KPoint2d

最近点。

The closest point.

Inherited from​

KBoundedCurve2d.getClosestPoint

Defined in​

api.d.ts:8198

getCurvatureVector​

▸ getCurvatureVector(point): KVector2d

求曲线上某点处的曲率向量。

Get curve's curvature vector for the input point on the curve.

Parameters​

NameTypeDescription
pointKPoint2d曲线上一点。 A point on curve.

Returns​

KVector2d

曲率向量。 向量的模为曲率值，向量的方向为曲率方向。

A curvature vector. Its norm represents the curvature value. Its direction represents the curvature's direction.

Inherited from​

KBoundedCurve2d.getCurvatureVector

Defined in​

api.d.ts:8248

getInterval​

▸ getInterval(): KInterval

获取曲线的参数域区间。

Get the parameter interval of the curve.

Returns​

KInterval

曲线的参数域区间。

The parameter interval of the curve.

Inherited from​

KBoundedCurve2d.getInterval

Defined in​

api.d.ts:8120

getParam​

▸ getParam(point): number

反求输入点对应的曲线参数值。

Get point's corresponding parameter value on the curve.

Parameters​

NameTypeDescription
pointKPoint2d曲线上的一点。 Point on curve

Returns​

number

输入点对应的曲线参数值。

The corresponding parameter of the point on curve.

Inherited from​

KBoundedCurve2d.getParam

Defined in​

api.d.ts:8148

getPoint​

▸ getPoint(t): KPoint2d

求曲线参数值对应的曲线上的点位置。

Get the point on the curve specified by the input parameter t.

Parameters​

NameTypeDescription
tnumber参数值 Parameter value

Returns​

KPoint2d

曲线参数对应的曲线上的点。

The point on the curve for the input parameter.

Inherited from​

KBoundedCurve2d.getPoint

Defined in​

api.d.ts:8134

getTangent​

▸ getTangent(point): KVector2d

获得折线段上一点处的切向量。 注意：该函数调用需要确保传入点在折线段上。

Get tangent vector of a point on the polyline. NOTE: the caller needs to make sure the point is on the polyline.

Parameters​

NameTypeDescription
pointKPoint2d折线段上一点。 A point on the polyline.

Returns​

KVector2d

切向量。

The tangent vector.

Defined in​

api.d.ts:11722

getType​

▸ getType(): KCurve2dType

获得曲线的类型。

Get the curve's type.

Returns​

KCurve2dType

曲线的类型。

The curve's type.

Inherited from​

KBoundedCurve2d.getType

Defined in​

api.d.ts:8110

isEqual​

▸ isEqual(curve, tolerance?): boolean

检查两个曲线在指定容差下是否相等。

Check whether two curves are equal with specified tolerance.

Parameters​

NameTypeDescription
curveKCurve2d-
tolerance?number指定容差，默认容差是1e-6。 The specified tolerance.The default value is 1e-6.

Returns​

boolean

如果相等上返回true。

Return true if equal, otherwise return false.

Inherited from​

KBoundedCurve2d.isEqual

Defined in​

api.d.ts:8216

isPointOnCurve​

▸ isPointOnCurve(point, tolerance?): boolean

检查传入点在指定容差下是否位于曲线上。

Check whether the input point is on the curve or not with specified tolerance.

Parameters​

NameTypeDescription
pointKPoint2d传入点。 The input point.
tolerance?number指定容差，默认容差是1e-6。 The specified tolerance.The default value is 1e-6.

Returns​

boolean

如果在曲线上返回true。

Return true if on the curve, otherwise return false.

Inherited from​

KBoundedCurve2d.isPointOnCurve

Defined in​

api.d.ts:8180

reverse​

▸ reverse(): void

把当前曲线反向。

reverse the current curve.

Returns​

void

Inherited from​

KBoundedCurve2d.reverse

Defined in​

api.d.ts:8232

splitByPoint​

▸ splitByPoint(point, distTol?): KBoundedCurve2d[]

把当前有界曲线按给定点分成两段。

Split the bounded curve into two segments by the given point.

Parameters​

NameTypeDescription
pointKPoint2d分割点。 split point.
distTol?number距离容差。如果不给定，则使用全局容差。 Distance tolerance. If not provided, then global tolerance will be used.

Returns​

KBoundedCurve2d[]

多段有界曲线。 如果分割点靠近当前有界曲线的起点或者终点，则返回一条克隆曲线。

Multiple segments of bounded curves. If the split point is close to start or end point, a cloned bounded curve will be returned.

Inherited from​

KBoundedCurve2d.splitByPoint

Defined in​

api.d.ts:7441

splitByPoints​

▸ splitByPoints(points, distTol?): KBoundedCurve2d[]

把当前有界曲线按给定点分成多段。

Split the bounded curve into multiple segments by the given points.

Parameters​

NameTypeDescription
pointsKPoint2d[]分割点列。 split points.
distTol?number距离容差。如果不给定，则使用全局容差。 Distance tolerance. If not provided, then global tolerance will be used.

Returns​

KBoundedCurve2d[]

多段有界曲线。 如果点列只包含起点和终点，则返回空数组。

Multiple segments of bounded curves. If points only contain start and end points, empty array will be returned.

Inherited from​

KBoundedCurve2d.splitByPoints

Defined in​

api.d.ts:7421

transform​

▸ transform(matrix): boolean

对当前曲线进行变换。

Transform this curve to a new one.

Parameters​

NameTypeDescription
matrixKMatrix3变换矩阵。 The transform matrix.

Returns​

boolean

当执行正确的话，返回true。

Return true if successful, otherwise return false.

Inherited from​

KBoundedCurve2d.transform

Defined in​

api.d.ts:8162