mxcad_3d API 文档 / Mx3dGeomPlane

Class: Mx3dGeomPlane

Mx3dGeomPlane 类，提供描述和操作3D空间中平面的功能。一个平面由坐标系 (Mx3dGeCSYSR) 定义，可以通过其法向量、原点和参数方向来描述。

Hierarchy

Mx3dGeomElementarySurface
↳ Mx3dGeomPlane

Constructors

constructor

Methods

Constructors

constructor

• new Mx3dGeomPlane(A3)

根据指定的轴向位置构造一个位于3D空间中的平面。

Parameters

Name	Type	Description
`A3`	`Mx3dGeCSYSR`	定义平面位置和方向的坐标系 (Mx3dGeCSYSR)。

Overrides

Mx3dGeomElementarySurface.constructor

• new Mx3dGeomPlane(P, V)

根据一个点和法向量构造一个平面。

Parameters

Name	Type	Description
`P`	`UniPoint`	平面的原点。
`V`	`UniDir`	法向量，指向平面的方向。

Overrides

Mx3dGeomElementarySurface.constructor

• new Mx3dGeomPlane(A, B, C, D)

根据平面方程的系数构造一个平面。

Parameters

Name	Type	Description
`A`	`number`	方程 Ax + By + Cz + D = 0 的系数 A。
`B`	`number`	方程 Ax + By + Cz + D = 0 的系数 B。
`C`	`number`	方程 Ax + By + Cz + D = 0 的系数 C。
`D`	`number`	方程 Ax + By + Cz + D = 0 的系数 D。

Overrides

Mx3dGeomElementarySurface.constructor

Methods

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(ABCD): void

计算平面方程的系数。

Parameters

Name	Type	Description
`ABCD`	[dA: number, dB: number, dC: number, dD: number]	系数数组 [dA, dB, dC, dD]。

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)。计算公式为 P = O + U * XDir + V * YDir，其中 O 为平面的原点，XDir 和 YDir 分别是 U 和 V 参数方向的基向量。

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)。计算公式为： - 点：P = O + U * XDir + V * YDir。 - 第一导数：D1U 和 D1V 分别为 XDir 和 YDir 的偏导数。

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`	用于存储计算点的目标对象 (Mx3dGePoint)。
`D1U`	`Mx3dGeVec`	用于存储 U 方向第一导数的目标对象 (Mx3dGeVec)。
`D1V`	`Mx3dGeVec`	用于存储 V 方向第一导数的目标对象 (Mx3dGeVec)。
`D2U`	`Mx3dGeVec`	用于存储 U 方向第二导数的目标对象 (Mx3dGeVec)。
`D2V`	`Mx3dGeVec`	用于存储 V 方向第二导数的目标对象 (Mx3dGeVec)。
`D2UV`	`Mx3dGeVec`	用于存储 UV 方向第二导数的目标对象 (Mx3dGeVec)。计算公式为： - 点：P = O + U * XDir + V * YDir。 - 第一导数：D1U 和 D1V 分别为 XDir 和 YDir 的偏导数。 - 第二导数：D2U、D2V 和 D2UV 为二阶偏导数。

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`	用于存储计算点的目标对象 (Mx3dGePoint)。
`D1U`	`Mx3dGeVec`	用于存储 U 方向第一导数的目标对象 (Mx3dGeVec)。
`D1V`	`Mx3dGeVec`	用于存储 V 方向第一导数的目标对象 (Mx3dGeVec)。
`D2U`	`Mx3dGeVec`	用于存储 U 方向第二导数的目标对象 (Mx3dGeVec)。
`D2V`	`Mx3dGeVec`	用于存储 V 方向第二导数的目标对象 (Mx3dGeVec)。
`D2UV`	`Mx3dGeVec`	用于存储 UV 方向第二导数的目标对象 (Mx3dGeVec)。
`D3U`	`Mx3dGeVec`	用于存储 U 方向第三导数的目标对象 (Mx3dGeVec)。
`D3V`	`Mx3dGeVec`	用于存储 V 方向第三导数的目标对象 (Mx3dGeVec)。
`D3UUV`	`Mx3dGeVec`	用于存储 UUU 方向第三导数的目标对象 (Mx3dGeVec)。
`D3UVV`	`Mx3dGeVec`	用于存储 UVV 方向第三导数的目标对象 (Mx3dGeVec)。计算公式为： - 点：P = O + U * XDir + V * YDir。 - 第一导数：D1U 和 D1V 分别为 XDir 和 YDir 的偏导数。 - 第二导数：D2U、D2V 和 D2UV 为二阶偏导数。 - 第三导数：D3U、D3V、D3UUV 和 D3UVV 为三阶偏导数。

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)。

Throws

错误：如果 Nu + Nv < 1 或 Nu < 0 或 Nv < 0，则抛出异常。计算公式为计算指定阶数的偏导数，返回对应的向量。

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

返回 false。

IsUPeriodic

▸ IsUPeriodic(): boolean

判断平面在 U 方向上是否周期性。

Returns

boolean

返回 false。

IsVClosed

▸ IsVClosed(): boolean

判断平面在 V 方向上是否闭合。

Returns

boolean

返回 false。

IsVPeriodic

▸ IsVPeriodic(): boolean

判断平面在 V 方向上是否周期性。

Returns

boolean

返回 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): Mx3dGeomPlane

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

Parameters

Name	Type	Description
`A1`	`Mx3dGeAxis`	轴对象。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByAxis

MirroredByCSYSR

▸ MirroredByCSYSR(A2): Mx3dGeomPlane

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

Parameters

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

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByCSYSR

MirroredByPoint

▸ MirroredByPoint(P): Mx3dGeomPlane

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

Parameters

Name	Type	Description
`P`	`Mx3dGePoint`	点对象。

Returns

Mx3dGeomPlane

新的几何对象。

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

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

Parameters

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

Returns

Mx3dGeomPlane

新的几何对象。

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

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

Parameters

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

Returns

Mx3dGeomPlane

新的几何对象。

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

Transform

▸ Transform(T): void

应用变换 T 到平面上。

Parameters

Name	Type	Description
`T`	`Mx3dGeTrsf`	变换 (Mx3dGeTrsf)。

Returns

void

TransformParameters

▸ TransformParameters(UV, T): void

将 U 和 V 参数以及变换 T 应用于平面。

Parameters

Name	Type	Description
`UV`	[dU: number, dV: number]	参数值数组 [dU, dV]。
`T`	`Mx3dGeTrsf`	变换 (Mx3dGeTrsf)。

Returns

void

Overrides

Mx3dGeomElementarySurface.TransformParameters

Transformed

▸ Transformed(T): Mx3dGeomPlane

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

Parameters

Name	Type	Description
`T`	`Mx3dGeTrsf`	变换对象。

Returns

Mx3dGeomPlane

新的几何对象。

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

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

Parameters

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

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.TranslatedBy2Points

TranslatedByVec

▸ TranslatedByVec(V): Mx3dGeomPlane

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

Parameters

Name	Type	Description
`V`	`Mx3dGeVec`	向量对象。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.TranslatedByVec

UPeriod

▸ UPeriod(): number

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

Returns

number

表面在 U 方向的周期。

Inherited from

Mx3dGeomElementarySurface.UPeriod

UReverse

▸ UReverse(): void

翻转平面在 U 参数方向上的方向。

Returns

void

Overrides

Mx3dGeomElementarySurface.UReverse

UReversed

▸ UReversed(): Mx3dGeomPlane

反转 U 方向的参数化。

Returns

Mx3dGeomPlane

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

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

Overrides

Mx3dGeomElementarySurface.VReverse

VReversed

▸ VReversed(): Mx3dGeomPlane

反转 V 方向的参数化。

Returns

Mx3dGeomPlane

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

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

DownCast

▸ Static DownCast(theObject): Mx3dGeomPlane

父类对象转 Mx3dGeomPlane 类对象

Parameters

Name	Type	Description
`theObject`	`Mx3dGeomObject`	父类对象

Returns

Mx3dGeomPlane

Mx3dGeomPlane 类对象

Class: Mx3dGeomPlane ​

Hierarchy ​

Table of contents ​

Constructors ​

Methods ​

Constructors ​

constructor ​

Parameters ​

Overrides ​

Parameters ​

Overrides ​

Parameters ​

Overrides ​

Methods ​

Axis ​

Returns ​

Inherited from ​

Bounds ​

Parameters ​

Returns ​

Coefficients ​

Parameters ​

Returns ​

Continuity ​

Returns ​

Inherited from ​

Copy ​

Returns ​

D0 ​

Parameters ​

Returns ​

D1 ​

Parameters ​

Returns ​

D2 ​

Parameters ​

Returns ​

D3 ​

Parameters ​

Returns ​

DN ​

Parameters ​

Returns ​

DynamicType ​

Returns ​

Overrides ​

Face ​

Parameters ​

Returns ​

Parameters ​

Returns ​

Parameters ​

Returns ​

IsCNu ​

Parameters ​

Returns ​

Inherited from ​

IsCNv ​

Parameters ​

Returns ​

Inherited from ​

IsUClosed ​

Returns ​

IsUPeriodic ​

Returns ​

IsVClosed ​

Returns ​

IsVPeriodic ​

Returns ​

Location ​

Returns ​

Inherited from ​

MirrorByAxis ​

Parameters ​

Returns ​

Inherited from ​

MirrorByCSYSR ​

Parameters ​

Returns ​

Inherited from ​

Class: Mx3dGeomPlane

Hierarchy

Table of contents

Constructors

Methods

Constructors

constructor

Parameters

Overrides

Parameters

Overrides

Parameters

Overrides

Methods

Axis

Returns

Inherited from

Bounds

Parameters

Returns

Coefficients

Parameters

Returns

Continuity

Returns

Inherited from

Copy

Returns

D0

Parameters

Returns

D1

Parameters

Returns

D2

Parameters

Returns

D3

Parameters

Returns

DN

Parameters

Returns

DynamicType

Returns

Overrides

Face

Parameters

Returns

Parameters

Returns

Parameters

Returns

IsCNu

Parameters

Returns

Inherited from

IsCNv

Parameters

Returns

Inherited from

IsUClosed

Returns

IsUPeriodic

Returns

IsVClosed

Returns

IsVPeriodic

Returns

Location

Returns

Inherited from

MirrorByAxis

Parameters

Returns

Inherited from

MirrorByCSYSR

Parameters

Returns

Inherited from