mxcad_3d API 文档 / Mx3dGeomSphericalSurface

Class: Mx3dGeomSphericalSurface

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

Hierarchy

• Mx3dGeomElementarySurface

  ↳ Mx3dGeomSphericalSurface

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
• MirrorByAxis
• MirrorByCSYSR
• MirrorByPoint
• MirroredByAxis
• MirroredByCSYSR
• MirroredByPoint
• Position
• Radius
• Rotate
• Rotated
• Scale
• Scaled
• SetAxis
• SetLocation
• SetPosition
• SetRadius
• Transform
• TransformParameters
• Transformed
• TranslateBy2Points
• TranslateByVec
• TranslatedBy2Points
• TranslatedByVec
• UPeriod
• UReverse
• UReversed
• UReversedParameter
• VPeriod
• VReverse
• VReversed
• VReversedParameter
• Value
• Volume
• DownCast

Constructors

constructor

• new Mx3dGeomSphericalSurface(A3, Radius)

构造一个具有给定坐标系统和半径的球面。

Parameters

Name	Type	Description
A3	Mx3dGeCSYSR	表面局部坐标系统（Mx3dGeCSYSR）。
Radius	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]	包含边界的数组：[dU1, dU2, dV1, dV2]。

Returns

void

---

Coefficients

▸ Coefficients(A1A2A3B1B2B3C1C2C3D): void

设置球面隐式方程的系数。

Parameters

Name	Type	Description
A1A2A3B1B2B3C1C2C3D	[A1: number, A2: number, A3: number, B1: number, B2: number, B3: number, C1: number, C2: number, C3: number, D: number]	系数数组：[A1, A2, A3, B1, B2, B3, C1, C2, C3, D]。

Returns

void

---

Continuity

▸ Continuity(): MxGAShapeEnum

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

Returns

MxGAShapeEnum

表面在全局上的连续性。

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	表面上的点。

Returns

void

---

D1

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

计算给定U和V参数的点及其一阶导数。

Parameters

Name	Type	Description
U	number	U参数。
V	number	V参数。
P	Mx3dGePoint	表面上的点。
D1U	Mx3dGeVec	U方向的导数。
D1V	Mx3dGeVec	V方向的导数。

Returns

void

---

D2

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

计算给定U和V参数的点、一阶和二阶导数。

Parameters

Name	Type	Description
U	number	U参数。
V	number	V参数。
P	Mx3dGePoint	表面上的点。
D1U	Mx3dGeVec	U方向的一阶导数。
D1V	Mx3dGeVec	V方向的一阶导数。
D2U	Mx3dGeVec	U方向的二阶导数。
D2V	Mx3dGeVec	V方向的二阶导数。
D2UV	Mx3dGeVec	二阶混合导数。

Returns

void

---

D3

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

计算给定U和V参数的点、一阶、二阶和三阶导数。

Parameters

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

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

第N阶导数向量。

---

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	定义边界的线框。
Inside	boolean	布尔值，表示面是否在线框内。

Returns

Mx3dShapeFace

表面表示的面。

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

使用指定的参数范围和退化容差生成表面的面。

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

Mx3dGePoint

表面位置点。

Inherited from

Mx3dGeomElementarySurface.Location

---

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): Mx3dGeomSphericalSurface

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

Parameters

Name	Type	Description
A1	Mx3dGeAxis	轴对象。

Returns

Mx3dGeomSphericalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByAxis

---

MirroredByCSYSR

▸ MirroredByCSYSR(A2): Mx3dGeomSphericalSurface

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

Parameters

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

Returns

Mx3dGeomSphericalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByCSYSR

---

MirroredByPoint

▸ MirroredByPoint(P): Mx3dGeomSphericalSurface

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

Parameters

Name	Type	Description
P	Mx3dGePoint	点对象。

Returns

Mx3dGeomSphericalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByPoint

---

Position

▸ Position(): Mx3dGeCSYSR

获取表面的局部坐标系。

Returns

Mx3dGeCSYSR

表面的局部坐标系。

Inherited from

Mx3dGeomElementarySurface.Position

---

Radius

▸ Radius(): number

返回球面半径。

Returns

number

球的半径。

---

Rotate

▸ Rotate(A1, Ang): void

旋转几何对象。

Parameters

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

Returns

void

Inherited from

Mx3dGeomElementarySurface.Rotate

---

Rotated

▸ Rotated(A1, Ang): Mx3dGeomSphericalSurface

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

Parameters

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

Returns

Mx3dGeomSphericalSurface

新的几何对象。

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): Mx3dGeomSphericalSurface

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

Parameters

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

Returns

Mx3dGeomSphericalSurface

新的几何对象。

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

---

SetPosition

▸ SetPosition(theAx3): void

设置表面的局部坐标系。

Parameters

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

Returns

void

Inherited from

Mx3dGeomElementarySurface.SetPosition

---

SetRadius

▸ SetRadius(R): void

设置球面半径。

Parameters

Name	Type	Description
R	number	新的球面半径。必须为非负数。

Returns

void

---

Transform

▸ Transform(T): void

应用变换到球面。

Parameters

Name	Type	Description
T	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): Mx3dGeomSphericalSurface

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

Parameters

Name	Type	Description
T	Mx3dGeTrsf	变换对象。

Returns

Mx3dGeomSphericalSurface

新的几何对象。

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): Mx3dGeomSphericalSurface

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

Parameters

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

Returns

Mx3dGeomSphericalSurface

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.TranslatedBy2Points

---

TranslatedByVec

▸ TranslatedByVec(V): Mx3dGeomSphericalSurface

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

Parameters

Name	Type	Description
V	Mx3dGeVec	向量对象。

Returns

Mx3dGeomSphericalSurface

新的几何对象。

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(): Mx3dGeomSphericalSurface

反转 U 方向的参数化。

Returns

Mx3dGeomSphericalSurface

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

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(): Mx3dGeomSphericalSurface

反转 V 方向的参数化。

Returns

Mx3dGeomSphericalSurface

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

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): Mx3dGeomSphericalSurface

父类对象转 Mx3dGeomSphericalSurface 类对象

Parameters

Name	Type	Description
theObject	Mx3dGeomObject	父类对象

Returns

Mx3dGeomSphericalSurface

Mx3dGeomSphericalSurface 类对象