KBoundedCurve2d

kds-plugin-document / Exports / KBoundedCurve2d

Interface: KBoundedCurve2d

所有二维轮廓曲线的基类，例如KLineSegment2d（线段）和KArc2d（圆弧）。

The base class for all 2D bounded curves, such as KLineSegment2d and KArc2d.

Hierarchy

• KCurve2d

  ↳ KBoundedCurve2d

  ↳↳ KArc2d

  ↳↳ KEllipticalArc2d

  ↳↳ KLineSegment2d

  ↳↳ KNurbsCurve2d

  ↳↳ KPolylineCurve2d

Table of contents

Properties

• endPoint
• length
• middlePoint
• startPoint

Methods

• clone
• getApproximatePointsInfoByNormalTol
• getApproximatePointsInfoByRatio
• getBounding
• getClosestPoint
• getCurvatureVector
• getInterval
• getParam
• getPoint
• getType
• isEqual
• isPointOnCurve
• reverse
• splitByPoint
• splitByPoints
• transform

Properties

endPoint

• Readonly endPoint: KPoint2d

获得轮廓线的终点。

Get bounded curve's end point.

Defined in

api.d.ts:5449

---

length

• Readonly length: number

获得轮廓线的长度。

Get bounded curve's length.

Defined in

api.d.ts:5461

---

middlePoint

• Readonly middlePoint: KPoint2d

获得轮廓线的中点。

Get bounded curve's middle point.

Defined in

api.d.ts:5455

---

startPoint

• Readonly startPoint: KPoint2d

获得轮廓线的起点。

Get bounded curve's start point.

Defined in

api.d.ts:5443

Methods

clone

▸ clone(): KCurve2d

复制一个当前曲线。

Return the cloned curve of this.

Returns

KCurve2d

复制的曲线。

The cloned curve.

Inherited from

KCurve2d.clone

Defined in

api.d.ts:6297

---

getApproximatePointsInfoByNormalTol

▸ getApproximatePointsInfoByNormalTol(normTol?, areaTol?): Object

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

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

Parameters

Name	Type	Description
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.

Name	Type
params	number[]
points	KPoint2d[]

Defined in

api.d.ts:5505

---

getApproximatePointsInfoByRatio

▸ getApproximatePointsInfoByRatio(ratio?, areaTol?): Object

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

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

Parameters

Name	Type	Description
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.

Name	Type
params	number[]
points	KPoint2d[]

Defined in

api.d.ts:5483

---

getBounding

▸ getBounding(): KBoundingBox2d

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

Get the Axis-aligned bounding box of the bounded curve

Returns

KBoundingBox2d

轴对齐的包围盒

the Axis-aligned bounding box

Defined in

api.d.ts:5555

---

getClosestPoint

▸ getClosestPoint(point, tolerance?): KPoint2d

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

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

Parameters

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

Returns

KPoint2d

最近点。

The closest point.

Inherited from

KCurve2d.getClosestPoint

Defined in

api.d.ts:6269

---

getCurvatureVector

▸ getCurvatureVector(point): KVector2d

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

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

Parameters

Name	Type	Description
point	KPoint2d	曲线上一点。 A point on curve.

Returns

KVector2d

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

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

Inherited from

KCurve2d.getCurvatureVector

Defined in

api.d.ts:6319

---

getInterval

▸ getInterval(): KInterval

获取曲线的参数域区间。

Get the parameter interval of the curve.

Returns

KInterval

曲线的参数域区间。

The parameter interval of the curve.

Inherited from

KCurve2d.getInterval

Defined in

api.d.ts:6191

---

getParam

▸ getParam(point): number

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

Get point's corresponding parameter value on the curve.

Parameters

Name	Type	Description
point	KPoint2d	曲线上的一点。 Point on curve

Returns

number

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

The corresponding parameter of the point on curve.

Inherited from

KCurve2d.getParam

Defined in

api.d.ts:6219

---

getPoint

▸ getPoint(t): KPoint2d

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

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

Parameters

Name	Type	Description
t	number	参数值 Parameter value

Returns

KPoint2d

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

The point on the curve for the input parameter.

Inherited from

KCurve2d.getPoint

Defined in

api.d.ts:6205

---

getType

▸ getType(): KCurve2dType

获得曲线的类型。

Get the curve's type.

Returns

KCurve2dType

曲线的类型。

The curve's type.

Inherited from

KCurve2d.getType

Defined in

api.d.ts:6181

---

isEqual

▸ isEqual(curve, tolerance?): boolean

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

Check whether two curves are equal with specified tolerance.

Parameters

Name	Type	Description
curve	KCurve2d	-
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

KCurve2d.isEqual

Defined in

api.d.ts:6287

---

isPointOnCurve

▸ isPointOnCurve(point, tolerance?): boolean

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

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

Parameters

Name	Type	Description
point	KPoint2d	传入点。 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

KCurve2d.isPointOnCurve

Defined in

api.d.ts:6251

---

reverse

▸ reverse(): void

把当前曲线反向。

reverse the current curve.

Returns

void

Inherited from

KCurve2d.reverse

Defined in

api.d.ts:6303

---

splitByPoint

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

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

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

Parameters

Name	Type	Description
point	KPoint2d	分割点。 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.

Defined in

api.d.ts:5545

---

splitByPoints

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

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

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

Parameters

Name	Type	Description
points	KPoint2d[]	分割点列。 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.

Defined in

api.d.ts:5525

---

transform

▸ transform(matrix): boolean

对当前曲线进行变换。

Transform this curve to a new one.

Parameters

Name	Type	Description
matrix	KMatrix3	变换矩阵。 The transform matrix.

Returns

boolean

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

Return true if successful, otherwise return false.

Inherited from

KCurve2d.transform

Defined in

api.d.ts:6233