mxcad_3d API 文档 / Mx3dGeomToroidalSurface

Class: Mx3dGeomToroidalSurface

表示三维空间中的环面（Toroidal Surface）。 此类封装了操作环面属性和方法的功能。

Hierarchy

• Mx3dGeomElementarySurface

  ↳ Mx3dGeomToroidalSurface

Table of contents

Constructors

• constructor

Methods

• Area
• Axis
• Bounds
• Coefficients
• Continuity
• Copy
• D0
• D1
• D2
• D3
• DN
• DynamicType
• Face
• IsCNu
• IsCNv
• IsUClosed
• IsUPeriodic
• IsVClosed
• IsVPeriodic
• Location
• MajorRadius
• MinorRadius
• MirrorByAxis
• MirrorByCSYSR
• MirrorByPoint
• MirroredByAxis
• MirroredByCSYSR
• MirroredByPoint
• Position
• Rotate
• Rotated
• Scale
• Scaled
• SetAxis
• SetLocation
• SetMajorRadius
• SetMinorRadius
• SetPosition
• Transform
• TransformParameters
• Transformed
• TranslateBy2Points
• TranslateByVec
• TranslatedBy2Points
• TranslatedByVec
• UPeriod
• UReverse
• UReversed
• UReversedParameter
• VPeriod
• VReverse
• VReversed
• VReversedParameter
• Value
• Volume
• DownCast

Constructors

constructor

• new Mx3dGeomToroidalSurface(A3, MajorRadius, MinorRadius)

构造一个具有给定坐标系统和主要、次要半径的环面。

Parameters

Name	Type	Description
A3	Mx3dGeCSYSR	表面局部坐标系统（Mx3dGeCSYSR）。
MajorRadius	number	环面的主要半径。
MinorRadius	number	环面的次要半径。

Overrides

Mx3dGeomElementarySurface.constructor

Methods

Area

▸ Area(): number

计算并返回环面的表面积。

Returns

number

表面积。

---

Axis

▸ Axis(): Mx3dGeAxis

获取表面的主轴（Z轴）。

Returns

Mx3dGeAxis

表面的主轴定义。

Inherited from

Mx3dGeomElementarySurface.Axis

---

Bounds

▸ Bounds(U1U2V1V2): void

设置参数范围的边界。

Parameters

Name	Type	Description
U1U2V1V2	[dU1: number, dU2: number, dV1: number, dV2: number]	参数范围[U1, U2, V1, V2]。

Returns

void

---

Coefficients

▸ Coefficients(Coef): void

获取隐式方程系数。

Parameters

Name	Type	Description
Coef	number[]	系数数组，长度至少为31。

Returns

void

---

Continuity

▸ Continuity(): MxGAShapeEnum

返回表面在全局上的连续性（MxGAShapeEnum）。

Returns

MxGAShapeEnum

表面在全局上的连续性。

Inherited from

Mx3dGeomElementarySurface.Continuity

---

Copy

▸ Copy(): Mx3dGeomObject

创建一个新的对象，它是此环面的副本。

Returns

Mx3dGeomObject

环面的副本（Mx3dGeomObject）。

---

D0

▸ D0(U, V, P): void

计算并返回指定U和V参数处的点。

Parameters

Name	Type	Description
U	number	参数U。
V	number	参数V。
P	Mx3dGePoint	输出点（Mx3dGePoint）。

Returns

void

---

D1

▸ D1(U, V, P, D1U, D1V): void

计算当前点和U、V方向的一阶导数。

Parameters

Name	Type	Description
U	number	参数U。
V	number	参数V。
P	Mx3dGePoint	输出点（Mx3dGePoint）。
D1U	Mx3dGeVec	输出U方向的一阶导数（Mx3dGeVec）。
D1V	Mx3dGeVec	输出V方向的一阶导数（Mx3dGeVec）。

Returns

void

---

D2

▸ D2(U, V, P, D1U, D1V, D2U, D2V, D2UV): void

计算当前点、一阶和二阶导数。

Parameters

Name	Type	Description
U	number	参数U。
V	number	参数V。
P	Mx3dGePoint	输出点（Mx3dGePoint）。
D1U	Mx3dGeVec	输出U方向的一阶导数（Mx3dGeVec）。
D1V	Mx3dGeVec	输出V方向的一阶导数（Mx3dGeVec）。
D2U	Mx3dGeVec	输出U方向的二阶导数（Mx3dGeVec）。
D2V	Mx3dGeVec	输出V方向的二阶导数（Mx3dGeVec）。
D2UV	Mx3dGeVec	输出U,V方向的二阶混合导数（Mx3dGeVec）。

Returns

void

---

D3

▸ D3(U, V, P, D1U, D1V, D2U, D2V, D2UV, D3U, D3V, D3UUV, D3UVV): void

计算当前点、一阶、二阶和三阶导数。

Parameters

Name	Type	Description
U	number	参数U。
V	number	参数V。
P	Mx3dGePoint	输出点（Mx3dGePoint）。
D1U	Mx3dGeVec	输出U方向的一阶导数（Mx3dGeVec）。
D1V	Mx3dGeVec	输出V方向的一阶导数（Mx3dGeVec）。
D2U	Mx3dGeVec	输出U方向的二阶导数（Mx3dGeVec）。
D2V	Mx3dGeVec	输出V方向的二阶导数（Mx3dGeVec）。
D2UV	Mx3dGeVec	输出U,V方向的二阶混合导数（Mx3dGeVec）。
D3U	Mx3dGeVec	输出U方向的三阶导数（Mx3dGeVec）。
D3V	Mx3dGeVec	输出V方向的三阶导数（Mx3dGeVec）。
D3UUV	Mx3dGeVec	输出U方向的二阶混合三阶导数（Mx3dGeVec）。
D3UVV	Mx3dGeVec	输出V方向的二阶混合三阶导数（Mx3dGeVec）。

Returns

void

---

DN

▸ DN(U, V, Nu, Nv): Mx3dGeVec

计算指定参数(U, V)处的高阶导数。

Parameters

Name	Type	Description
U	number	参数U。
V	number	参数V。
Nu	number	高阶导数的U方向阶数。
Nv	number	高阶导数的V方向阶数。

Returns

Mx3dGeVec

高阶导数（Mx3dGeVec）。

---

DynamicType

▸ DynamicType(): string

返回对象的动态类型字符串。

Returns

string

动态类型字符串。

Overrides

Mx3dGeomElementarySurface.DynamicType

---

Face

▸ Face(TolDegen): Mx3dShapeFace

创建一个表示环面的平面（由面容表示）。

Parameters

Name	Type	Description
TolDegen	number	退化容差。

Returns

Mx3dShapeFace

平面（Mx3dShapeFace）。

▸ Face(W, Inside): Mx3dShapeFace

创建一个表示环面的平面（由线条表示）。

Parameters

Name	Type	Description
W	Mx3dShapeWire	线条（Mx3dShapeWire）。
Inside	boolean	表示环面是否在内部。

Returns

Mx3dShapeFace

平面（Mx3dShapeFace）。

▸ Face(UMin, UMax, VMin, VMax, TolDegen): Mx3dShapeFace

创建一个表示环面的平面（指定U, V范围）。

Parameters

Name	Type	Description
UMin	number	最小U参数。
UMax	number	最大U参数。
VMin	number	最小V参数。
VMax	number	最大V参数。
TolDegen	number	退化容差。

Returns

Mx3dShapeFace

平面（Mx3dShapeFace）。

---

IsCNu

▸ IsCNu(N): boolean

检查表面在 U 参数方向上的连续性是否达到指定的等级。

Parameters

Name	Type	Description
N	number	要检查的连续性等级。

Returns

boolean

如果连续性等级满足条件，则返回 true；否则返回 false。

Inherited from

Mx3dGeomElementarySurface.IsCNu

---

IsCNv

▸ IsCNv(N): boolean

检查表面在 V 参数方向上的连续性是否达到指定的等级。

Parameters

Name	Type	Description
N	number	要检查的连续性等级。

Returns

boolean

如果连续性等级满足条件，则返回 true；否则返回 false。

Inherited from

Mx3dGeomElementarySurface.IsCNv

---

IsUClosed

▸ IsUClosed(): boolean

检查环面U方向是否闭合。

Returns

boolean

如果U方向闭合则返回true，否则返回false。

---

IsUPeriodic

▸ IsUPeriodic(): boolean

检查环面U方向是否周期性。

Returns

boolean

如果U方向周期性则返回true，否则返回false。

---

IsVClosed

▸ IsVClosed(): boolean

检查环面V方向是否闭合。

Returns

boolean

如果V方向闭合则返回true，否则返回false。

---

IsVPeriodic

▸ IsVPeriodic(): boolean

检查环面V方向是否周期性。

Returns

boolean

如果V方向周期性则返回true，否则返回false。

---

Location

▸ Location(): Mx3dGePoint

获取表面局部坐标系的位置点。

Returns

Mx3dGePoint

表面位置点。

Inherited from

Mx3dGeomElementarySurface.Location

---

MajorRadius

▸ MajorRadius(): number

返回环面的主要半径。

Returns

number

主要半径。

---

MinorRadius

▸ MinorRadius(): number

返回环面的次要半径。

Returns

number

次要半径。

---

MirrorByAxis

▸ MirrorByAxis(A1): void

通过轴对几何对象进行镜像变换。

Parameters

Name	Type	Description
A1	Mx3dGeAxis	轴对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.MirrorByAxis

---

MirrorByCSYSR

▸ MirrorByCSYSR(A2): void

通过右手坐标系对几何对象进行镜像变换。

Parameters

Name	Type	Description
A2	Mx3dGeCSYSR	右手坐标系对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.MirrorByCSYSR

---

MirrorByPoint

▸ MirrorByPoint(P): void

通过点对几何对象进行镜像变换。

Parameters

Name	Type	Description
P	Mx3dGePoint	点对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.MirrorByPoint

---

MirroredByAxis

▸ MirroredByAxis(A1): Mx3dGeomToroidalSurface

返回通过轴镜像变换后的新几何对象。

Parameters

Name	Type	Description
A1	Mx3dGeAxis	轴对象。

Returns

Mx3dGeomToroidalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByAxis

---

MirroredByCSYSR

▸ MirroredByCSYSR(A2): Mx3dGeomToroidalSurface

返回通过右手坐标系镜像变换后的新几何对象。

Parameters

Name	Type	Description
A2	Mx3dGeCSYSR	右手坐标系对象。

Returns

Mx3dGeomToroidalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByCSYSR

---

MirroredByPoint

▸ MirroredByPoint(P): Mx3dGeomToroidalSurface

返回通过点镜像变换后的新几何对象。

Parameters

Name	Type	Description
P	Mx3dGePoint	点对象。

Returns

Mx3dGeomToroidalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByPoint

---

Position

▸ Position(): Mx3dGeCSYSR

获取表面的局部坐标系。

Returns

Mx3dGeCSYSR

表面的局部坐标系。

Inherited from

Mx3dGeomElementarySurface.Position

---

Rotate

▸ Rotate(A1, Ang): void

旋转几何对象。

Parameters

Name	Type	Description
A1	Mx3dGeAxis	轴对象。
Ang	number	旋转角度。

Returns

void

Inherited from

Mx3dGeomElementarySurface.Rotate

---

Rotated

▸ Rotated(A1, Ang): Mx3dGeomToroidalSurface

返回旋转后的新几何对象。

Parameters

Name	Type	Description
A1	Mx3dGeAxis	轴对象。
Ang	number	旋转角度。

Returns

Mx3dGeomToroidalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.Rotated

---

Scale

▸ Scale(P, S): void

缩放几何对象。

Parameters

Name	Type	Description
P	Mx3dGePoint	点对象。
S	number	缩放比例。

Returns

void

Inherited from

Mx3dGeomElementarySurface.Scale

---

Scaled

▸ Scaled(P, S): Mx3dGeomToroidalSurface

返回缩放后的新几何对象。

Parameters

Name	Type	Description
P	Mx3dGePoint	点对象。
S	number	缩放比例。

Returns

Mx3dGeomToroidalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.Scaled

---

SetAxis

▸ SetAxis(theA1): void

设置表面的主轴（Z轴）。

Parameters

Name	Type	Description
theA1	Mx3dGeAxis	表面的主轴定义。

Returns

void

Inherited from

Mx3dGeomElementarySurface.SetAxis

---

SetLocation

▸ SetLocation(theLoc): void

设置表面局部坐标系的位置点。

Parameters

Name	Type	Description
theLoc	Mx3dGePoint	新的位置点。

Returns

void

Inherited from

Mx3dGeomElementarySurface.SetLocation

---

SetMajorRadius

▸ SetMajorRadius(MajorRadius): void

设置环面主要半径。

Parameters

Name	Type	Description
MajorRadius	number	新的主要半径。必须为非负数。

Returns

void

---

SetMinorRadius

▸ SetMinorRadius(MinorRadius): void

设置环面次要半径。

Parameters

Name	Type	Description
MinorRadius	number	新的次要半径。必须为非负数。

Returns

void

---

SetPosition

▸ SetPosition(theAx3): void

设置表面的局部坐标系。

Parameters

Name	Type	Description
theAx3	Mx3dGeCSYSR	新的坐标系，包含位置和方向。

Returns

void

Inherited from

Mx3dGeomElementarySurface.SetPosition

---

Transform

▸ Transform(T): void

应用变换T到环面。

Parameters

Name	Type	Description
T	Mx3dGeTrsf	变换（Mx3dGeTrsf）。

Returns

void

---

TransformParameters

▸ TransformParameters(UV, T): void

根据给定的变换矩阵 T 变换表面参数。

Parameters

Name	Type	Description
UV	[dU: number, dV: number]	参数数组，包含 U 和 V 的值。
T	Mx3dGeTrsf	变换矩阵。

Returns

void

Inherited from

Mx3dGeomElementarySurface.TransformParameters

---

Transformed

▸ Transformed(T): Mx3dGeomToroidalSurface

返回变换后的新几何对象。

Parameters

Name	Type	Description
T	Mx3dGeTrsf	变换对象。

Returns

Mx3dGeomToroidalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.Transformed

---

TranslateBy2Points

▸ TranslateBy2Points(P1, P2): void

通过两个点平移几何对象。

Parameters

Name	Type	Description
P1	Mx3dGePoint	起始点对象。
P2	Mx3dGePoint	终止点对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.TranslateBy2Points

---

TranslateByVec

▸ TranslateByVec(V): void

通过向量平移几何对象。

Parameters

Name	Type	Description
V	Mx3dGeVec	向量对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.TranslateByVec

---

TranslatedBy2Points

▸ TranslatedBy2Points(P1, P2): Mx3dGeomToroidalSurface

返回通过两个点平移后的新几何对象。

Parameters

Name	Type	Description
P1	Mx3dGePoint	起始点对象。
P2	Mx3dGePoint	终止点对象。

Returns

Mx3dGeomToroidalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.TranslatedBy2Points

---

TranslatedByVec

▸ TranslatedByVec(V): Mx3dGeomToroidalSurface

返回通过向量平移后的新几何对象。

Parameters

Name	Type	Description
V	Mx3dGeVec	向量对象。

Returns

Mx3dGeomToroidalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.TranslatedByVec

---

UPeriod

▸ UPeriod(): number

返回表面在 U 方向的周期。

Returns

number

表面在 U 方向的周期。

Inherited from

Mx3dGeomElementarySurface.UPeriod

---

UReverse

▸ UReverse(): void

反转表面在 U 参数方向上的参数化方向。

Returns

void

Inherited from

Mx3dGeomElementarySurface.UReverse

---

UReversed

▸ UReversed(): Mx3dGeomToroidalSurface

反转 U 方向的参数化。

Returns

Mx3dGeomToroidalSurface

返回当前对象以实现链式调用。

Inherited from

Mx3dGeomElementarySurface.UReversed

---

UReversedParameter

▸ UReversedParameter(U): number

计算在给定U参数上的环面U方向反转后的参数值。

Parameters

Name	Type	Description
U	number	原始的U参数。

Returns

number

反转后的U参数值。

---

VPeriod

▸ VPeriod(): number

返回表面在 V 方向的周期。

Returns

number

表面在 V 方向的周期。

Inherited from

Mx3dGeomElementarySurface.VPeriod

---

VReverse

▸ VReverse(): void

反转表面在 V 参数方向上的参数化方向。

Returns

void

Inherited from

Mx3dGeomElementarySurface.VReverse

---

VReversed

▸ VReversed(): Mx3dGeomToroidalSurface

反转 V 方向的参数化。

Returns

Mx3dGeomToroidalSurface

返回当前对象以实现链式调用。

Inherited from

Mx3dGeomElementarySurface.VReversed

---

VReversedParameter

▸ VReversedParameter(V): number

计算在给定V参数上的环面V方向反转后的参数值。

Parameters

Name	Type	Description
V	number	原始的V参数。

Returns

number

反转后的V参数值。

---

Value

▸ Value(U, V): Mx3dGePoint

计算参数 (U, V) 对应的表面上的点。

Parameters

Name	Type	Description
U	number	表面参数 U。
V	number	表面参数 V。

Returns

Mx3dGePoint

对应的点。

Inherited from

Mx3dGeomElementarySurface.Value

---

Volume

▸ Volume(): number

计算并返回环面的体积。

Returns

number

体积。

---

DownCast

▸ Static DownCast(theObject): Mx3dGeomToroidalSurface

父类对象转 Mx3dGeomToroidalSurface 类对象

Parameters

Name	Type	Description
theObject	Mx3dGeomObject	父类对象

Returns

Mx3dGeomToroidalSurface

Mx3dGeomToroidalSurface 类对象