mxcad_3d API 文档 / Mx3dGeomToroidalSurface
Class: Mx3dGeomToroidalSurface
表示三维空间中的环面(Toroidal Surface)。 此类封装了操作环面属性和方法的功能。
Hierarchy
↳
Mx3dGeomToroidalSurface
Table of contents
Constructors
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
表面的主轴定义。
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
表面在全局上的连续性。
Inherited from
Mx3dGeomElementarySurface.Continuity
Copy
▸ Copy(): Mx3dGeomObject
创建一个新的对象,它是此环面的副本。
Returns
环面的副本(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)。
DynamicType
▸ DynamicType(): string
返回对象的动态类型字符串。
Returns
string
动态类型字符串。
Overrides
Mx3dGeomElementarySurface.DynamicType
Face
▸ Face(TolDegen
): Mx3dShapeFace
创建一个表示环面的平面(由面容表示)。
Parameters
Name | Type | Description |
---|---|---|
TolDegen | number | 退化容差。 |
Returns
平面(Mx3dShapeFace)。
▸ Face(W
, Inside
): Mx3dShapeFace
创建一个表示环面的平面(由线条表示)。
Parameters
Name | Type | Description |
---|---|---|
W | Mx3dShapeWire | 线条(Mx3dShapeWire)。 |
Inside | boolean | 表示环面是否在内部。 |
Returns
平面(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)。
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
表面位置点。
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
新的几何对象。
Inherited from
Mx3dGeomElementarySurface.MirroredByAxis
MirroredByCSYSR
▸ MirroredByCSYSR(A2
): Mx3dGeomToroidalSurface
返回通过右手坐标系镜像变换后的新几何对象。
Parameters
Name | Type | Description |
---|---|---|
A2 | Mx3dGeCSYSR | 右手坐标系对象。 |
Returns
新的几何对象。
Inherited from
Mx3dGeomElementarySurface.MirroredByCSYSR
MirroredByPoint
▸ MirroredByPoint(P
): Mx3dGeomToroidalSurface
返回通过点镜像变换后的新几何对象。
Parameters
Name | Type | Description |
---|---|---|
P | Mx3dGePoint | 点对象。 |
Returns
新的几何对象。
Inherited from
Mx3dGeomElementarySurface.MirroredByPoint
Position
▸ Position(): Mx3dGeCSYSR
获取表面的局部坐标系。
Returns
表面的局部坐标系。
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
新的几何对象。
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
新的几何对象。
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
新的几何对象。
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
新的几何对象。
Inherited from
Mx3dGeomElementarySurface.TranslatedBy2Points
TranslatedByVec
▸ TranslatedByVec(V
): Mx3dGeomToroidalSurface
返回通过向量平移后的新几何对象。
Parameters
Name | Type | Description |
---|---|---|
V | Mx3dGeVec | 向量对象。 |
Returns
新的几何对象。
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
返回当前对象以实现链式调用。
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
返回当前对象以实现链式调用。
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
对应的点。
Inherited from
Mx3dGeomElementarySurface.Value
Volume
▸ Volume(): number
计算并返回环面的体积。
Returns
number
体积。
DownCast
▸ Static
DownCast(theObject
): Mx3dGeomToroidalSurface
父类对象转 Mx3dGeomToroidalSurface 类对象
Parameters
Name | Type | Description |
---|---|---|
theObject | Mx3dGeomObject | 父类对象 |
Returns
Mx3dGeomToroidalSurface 类对象