Skip to content
On this page

mxcad_3d API 文档 / Mx3dGeomPlane

Class: Mx3dGeomPlane

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

Hierarchy

Table of contents

Constructors

Methods

Constructors

constructor

new Mx3dGeomPlane(A3)

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

Parameters

NameTypeDescription
A3Mx3dGeCSYSR定义平面位置和方向的坐标系 (Mx3dGeCSYSR)。

Overrides

Mx3dGeomElementarySurface.constructor

new Mx3dGeomPlane(P, V)

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

Parameters

NameTypeDescription
PUniPoint平面的原点。
VUniDir法向量,指向平面的方向。

Overrides

Mx3dGeomElementarySurface.constructor

new Mx3dGeomPlane(A, B, C, D)

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

Parameters

NameTypeDescription
Anumber方程 Ax + By + Cz + D = 0 的系数 A。
Bnumber方程 Ax + By + Cz + D = 0 的系数 B。
Cnumber方程 Ax + By + Cz + D = 0 的系数 C。
Dnumber方程 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

NameTypeDescription
U1U2V1V2[dU1: number, dU2: number, dV1: number, dV2: number]参数范围数组 [dU1, dU2, dV1, dV2]。

Returns

void


Coefficients

Coefficients(ABCD): void

计算平面方程的系数。

Parameters

NameTypeDescription
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

NameTypeDescription
UnumberU 参数值。
VnumberV 参数值。
PMx3dGePoint用于存储计算点的目标对象 (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

NameTypeDescription
UnumberU 参数值。
VnumberV 参数值。
PMx3dGePoint用于存储计算点的目标对象 (Mx3dGePoint)。
D1UMx3dGeVec用于存储 U 方向第一导数的目标对象 (Mx3dGeVec)。
D1VMx3dGeVec用于存储 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

NameTypeDescription
UnumberU 参数值。
VnumberV 参数值。
PMx3dGePoint用于存储计算点的目标对象 (Mx3dGePoint)。
D1UMx3dGeVec用于存储 U 方向第一导数的目标对象 (Mx3dGeVec)。
D1VMx3dGeVec用于存储 V 方向第一导数的目标对象 (Mx3dGeVec)。
D2UMx3dGeVec用于存储 U 方向第二导数的目标对象 (Mx3dGeVec)。
D2VMx3dGeVec用于存储 V 方向第二导数的目标对象 (Mx3dGeVec)。
D2UVMx3dGeVec用于存储 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

NameTypeDescription
UnumberU 参数值。
VnumberV 参数值。
PMx3dGePoint用于存储计算点的目标对象 (Mx3dGePoint)。
D1UMx3dGeVec用于存储 U 方向第一导数的目标对象 (Mx3dGeVec)。
D1VMx3dGeVec用于存储 V 方向第一导数的目标对象 (Mx3dGeVec)。
D2UMx3dGeVec用于存储 U 方向第二导数的目标对象 (Mx3dGeVec)。
D2VMx3dGeVec用于存储 V 方向第二导数的目标对象 (Mx3dGeVec)。
D2UVMx3dGeVec用于存储 UV 方向第二导数的目标对象 (Mx3dGeVec)。
D3UMx3dGeVec用于存储 U 方向第三导数的目标对象 (Mx3dGeVec)。
D3VMx3dGeVec用于存储 V 方向第三导数的目标对象 (Mx3dGeVec)。
D3UUVMx3dGeVec用于存储 UUU 方向第三导数的目标对象 (Mx3dGeVec)。
D3UVVMx3dGeVec用于存储 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 参数值处的指定阶数的导数。

Throws

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

Parameters

NameTypeDescription
UnumberU 参数值。
VnumberV 参数值。
NunumberU 方向的导数阶数。
NvnumberV 方向的导数阶数。

Returns

Mx3dGeVec

返回计算的向量对象 (Mx3dGeVec)。


DynamicType

DynamicType(): string

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

Returns

string

类型名称字符串。

Overrides

Mx3dGeomElementarySurface.DynamicType


Face

Face(TolDegen): Mx3dShapeFace

根据公差生成一个平面面。

Parameters

NameTypeDescription
TolDegennumber公差值。

Returns

Mx3dShapeFace

生成的平面面 (Mx3dShapeFace)。

Face(W, Inside): Mx3dShapeFace

根据给定的轮廓线和是否在内部生成一个平面面。

Parameters

NameTypeDescription
WMx3dShapeWire轮廓线 (Mx3dShapeWire)。
Insideboolean是否在内部。

Returns

Mx3dShapeFace

生成的平面面 (Mx3dShapeFace)。

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

根据 U 和 V 范围以及公差生成一个平面面。

Parameters

NameTypeDescription
UMinnumberU 方向的最小值。
UMaxnumberU 方向的最大值。
VMinnumberV 方向的最小值。
VMaxnumberV 方向的最大值。
TolDegennumber公差值。

Returns

Mx3dShapeFace

生成的平面面 (Mx3dShapeFace)。


IsCNu

IsCNu(N): boolean

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

Parameters

NameTypeDescription
Nnumber要检查的连续性等级。

Returns

boolean

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

Inherited from

Mx3dGeomElementarySurface.IsCNu


IsCNv

IsCNv(N): boolean

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

Parameters

NameTypeDescription
Nnumber要检查的连续性等级。

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

NameTypeDescription
A1Mx3dGeAxis轴对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.MirrorByAxis


MirrorByCSYSR

MirrorByCSYSR(A2): void

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

Parameters

NameTypeDescription
A2Mx3dGeCSYSR右手坐标系对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.MirrorByCSYSR


MirrorByPoint

MirrorByPoint(P): void

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

Parameters

NameTypeDescription
PMx3dGePoint点对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.MirrorByPoint


MirroredByAxis

MirroredByAxis(A1): Mx3dGeomPlane

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

Parameters

NameTypeDescription
A1Mx3dGeAxis轴对象。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByAxis


MirroredByCSYSR

MirroredByCSYSR(A2): Mx3dGeomPlane

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

Parameters

NameTypeDescription
A2Mx3dGeCSYSR右手坐标系对象。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByCSYSR


MirroredByPoint

MirroredByPoint(P): Mx3dGeomPlane

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

Parameters

NameTypeDescription
PMx3dGePoint点对象。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.MirroredByPoint


Position

Position(): Mx3dGeCSYSR

获取表面的局部坐标系。

Returns

Mx3dGeCSYSR

表面的局部坐标系。

Inherited from

Mx3dGeomElementarySurface.Position


Rotate

Rotate(A1, Ang): void

旋转几何对象。

Parameters

NameTypeDescription
A1Mx3dGeAxis轴对象。
Angnumber旋转角度。

Returns

void

Inherited from

Mx3dGeomElementarySurface.Rotate


Rotated

Rotated(A1, Ang): Mx3dGeomPlane

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

Parameters

NameTypeDescription
A1Mx3dGeAxis轴对象。
Angnumber旋转角度。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.Rotated


Scale

Scale(P, S): void

缩放几何对象。

Parameters

NameTypeDescription
PMx3dGePoint点对象。
Snumber缩放比例。

Returns

void

Inherited from

Mx3dGeomElementarySurface.Scale


Scaled

Scaled(P, S): Mx3dGeomPlane

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

Parameters

NameTypeDescription
PMx3dGePoint点对象。
Snumber缩放比例。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.Scaled


SetAxis

SetAxis(theA1): void

设置表面的主轴(Z轴)。

Parameters

NameTypeDescription
theA1Mx3dGeAxis表面的主轴定义。

Returns

void

Inherited from

Mx3dGeomElementarySurface.SetAxis


SetLocation

SetLocation(theLoc): void

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

Parameters

NameTypeDescription
theLocMx3dGePoint新的位置点。

Returns

void

Inherited from

Mx3dGeomElementarySurface.SetLocation


SetPosition

SetPosition(theAx3): void

设置表面的局部坐标系。

Parameters

NameTypeDescription
theAx3Mx3dGeCSYSR新的坐标系,包含位置和方向。

Returns

void

Inherited from

Mx3dGeomElementarySurface.SetPosition


Transform

Transform(T): void

应用变换 T 到平面上。

Parameters

NameTypeDescription
TMx3dGeTrsf变换 (Mx3dGeTrsf)。

Returns

void


TransformParameters

TransformParameters(UV, T): void

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

Parameters

NameTypeDescription
UV[dU: number, dV: number]参数值数组 [dU, dV]。
TMx3dGeTrsf变换 (Mx3dGeTrsf)。

Returns

void

Overrides

Mx3dGeomElementarySurface.TransformParameters


Transformed

Transformed(T): Mx3dGeomPlane

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

Parameters

NameTypeDescription
TMx3dGeTrsf变换对象。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.Transformed


TranslateBy2Points

TranslateBy2Points(P1, P2): void

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

Parameters

NameTypeDescription
P1Mx3dGePoint起始点对象。
P2Mx3dGePoint终止点对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.TranslateBy2Points


TranslateByVec

TranslateByVec(V): void

通过向量平移几何对象。

Parameters

NameTypeDescription
VMx3dGeVec向量对象。

Returns

void

Inherited from

Mx3dGeomElementarySurface.TranslateByVec


TranslatedBy2Points

TranslatedBy2Points(P1, P2): Mx3dGeomPlane

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

Parameters

NameTypeDescription
P1Mx3dGePoint起始点对象。
P2Mx3dGePoint终止点对象。

Returns

Mx3dGeomPlane

新的几何对象。

Inherited from

Mx3dGeomElementarySurface.TranslatedBy2Points


TranslatedByVec

TranslatedByVec(V): Mx3dGeomPlane

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

Parameters

NameTypeDescription
VMx3dGeVec向量对象。

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

NameTypeDescription
Unumber原始的 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

NameTypeDescription
Vnumber原始的 V 参数。

Returns

number

翻转后的 V 参数。


Value

Value(U, V): Mx3dGePoint

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

Parameters

NameTypeDescription
Unumber表面参数 U。
Vnumber表面参数 V。

Returns

Mx3dGePoint

对应的点。

Inherited from

Mx3dGeomElementarySurface.Value


DownCast

Static DownCast(theObject): Mx3dGeomPlane

父类对象转 Mx3dGeomPlane 类对象

Parameters

NameTypeDescription
theObjectMx3dGeomObject父类对象

Returns

Mx3dGeomPlane

Mx3dGeomPlane 类对象