Public 成员函数
	GPln ()

	GPln (GAx3 theA3)

	GPln (GPnt theP, GDir theV)

	GPln (double theA, double theB, double theC, double theD)

void	Coefficients (double[] theA, double[] theB, double[] theC, double[] theD)

void	SetAxis (GAx1 theA1)

void	SetLocation (GPnt theLoc)

void	SetPosition (GAx3 theA3)

void	UReverse ()

void	VReverse ()

boolean	Direct ()

GAx1	Axis ()

GPnt	Location ()

GAx3	Position ()

double	Distance (GPnt theP)

double	Distance (GLin theL)

double	Distance (GPln theOther)

double	SquareDistance (GPnt theP)

double	SquareDistance (GLin theL)

double	SquareDistance (GPln theOther)

GAx1	XAxis ()

GAx1	YAxis ()

boolean	Contains (GPnt theP, double theLinearTolerance)

boolean	Contains (GLin theL, double theLinearTolerance, double theAngularTolerance)

void	Mirror (GPnt theP)

GPln	Mirrored (GPnt theP)

void	Mirror (GAx1 theA1)

GPln	Mirrored (GAx1 theA1)

void	Mirror (GAx2 theA2)

GPln	Mirrored (GAx2 theA2)

void	Rotate (GAx1 theA1, double theAng)

GPln	Rotated (GAx1 theA1, double theAng)

void	Scale (GPnt theP, double theS)

GPln	Scaled (GPnt theP, double theS)

void	Transform (GTrsf theT)

GPln	Transformed (GTrsf theT)

void	Translate (GVec theV)

GPln	Translated (GVec theV)

void	Translate (GPnt theP1, GPnt theP2)

GPln	Translated (GPnt theP1, GPnt theP2)

详细描述

Describes a plane. A plane is positioned in space with a coordinate system (a gp_Ax3 object), such that the plane is defined by the origin, "X Direction" and "Y Direction" of this coordinate system, which is the "local coordinate system" of the plane. The "main Direction" of the coordinate system is a vector normal to the plane. It gives the plane an implicit orientation such that the plane is said to be "direct", if the coordinate system is right-handed, or "indirect" in the other case. Note: when a gp_Pln plane is converted into a Geom_Plane plane, some implicit properties of its local coordinate system are used explicitly: - its origin defines the origin of the two parameters of the planar surface, - its implicit orientation is also that of the Geom_Plane. See Also gce_MakePln which provides functions for more complex plane constructions Geom_Plane which provides additional functions for constructing planes and works, in particular, with the parametric equations of planes

构造及析构函数说明

◆ GPln() [1/4]

GPln.GPln ( )

Creates a plane coincident with OXY plane of the reference coordinate system.

◆ GPln() [2/4]

GPln.GPln ( GAx3 theA3 )

The coordinate system of the plane is defined with the axis placement theA3. The "Direction" of theA3 defines the normal to the plane. The "Location" of theA3 defines the location (origin) of the plane. The "XDirection" and "YDirection" of theA3 define the "XAxis" and the "YAxis" of the plane used to parametrize the plane.

◆ GPln() [3/4]

GPln.GPln	(	GPnt	theP,
		GDir	theV
	)

Creates a plane with the "Location" point <theP> and the normal direction <theV>.

◆ GPln() [4/4]

GPln.GPln	(	double	theA,
		double	theB,
		double	theC,
		double	theD
	)

Creates a plane from its cartesian equation : theA * X + theB * Y + theC * Z + theD = 0.0 Raises ConstructionError if Sqrt (theA*theA + theB*theB + theC*theC) <= Resolution from gp.

成员函数说明

◆ Axis()

GAx1 GPln.Axis ( )

Returns the plane's normal Axis.

◆ Coefficients()

void GPln.Coefficients	(	double[]	theA,
		double[]	theB,
		double[]	theC,
		double[]	theD
	)

Returns the coefficients of the plane's cartesian equation : theA * X + theB * Y + theC * Z + theD = 0.

◆ Contains() [1/2]

boolean GPln.Contains	(	GLin	theL,
		double	theLinearTolerance,
		double	theAngularTolerance
	)

Returns true if this plane contains the line theL. This means that - the distance between point P and this plane is less than or equal to LinearTolerance, or - line theL is normal to the "main Axis" of the local coordinate system of this plane, within the tolerance theAngularTolerance, and the distance between the origin of line theL and this plane is less than or equal to theLinearTolerance.

◆ Contains() [2/2]

boolean GPln.Contains	(	GPnt	theP,
		double	theLinearTolerance
	)

Returns true if this plane contains the point theP. This means that - the distance between point theP and this plane is less than or equal to theLinearTolerance, or - line L is normal to the "main Axis" of the local coordinate system of this plane, within the tolerance AngularTolerance, and the distance between the origin of line L and this plane is less than or equal to theLinearTolerance.

◆ Direct()

boolean GPln.Direct ( )

returns true if the Ax3 is right handed.

◆ Distance() [1/3]

double GPln.Distance ( GLin theL )

Computes the distance between <me> and the line <theL>.

◆ Distance() [2/3]

double GPln.Distance ( GPln theOther )

Computes the distance between two planes.

◆ Distance() [3/3]

double GPln.Distance ( GPnt theP )

Computes the distance between <me> and the point <theP>.

◆ Location()

GPnt GPln.Location ( )

Returns the plane's location (origin).

◆ Mirrored() [1/3]

GPln GPln.Mirrored ( GAx1 theA1 )

Performs the symmetrical transformation of a plane with respect to an axis placement which is the axis of the symmetry. The transformation is performed on the "Location" point, on the "XAxis" and the "YAxis". The resulting normal direction is the cross product between the "XDirection" and the "YDirection" after transformation if the initial plane was right handed, else it is the opposite.

◆ Mirrored() [2/3]

GPln GPln.Mirrored ( GAx2 theA2 )

Performs the symmetrical transformation of a plane with respect to an axis placement. The axis placement <A2> locates the plane of the symmetry. The transformation is performed on the "Location" point, on the "XAxis" and the "YAxis". The resulting normal direction is the cross product between the "XDirection" and the "YDirection" after transformation if the initial plane was right handed, else it is the opposite.

◆ Mirrored() [3/3]

GPln GPln.Mirrored ( GPnt theP )

Performs the symmetrical transformation of a plane with respect to the point <theP> which is the center of the symmetry Warnings : The normal direction to the plane is not changed. The "XAxis" and the "YAxis" are reversed.

◆ Position()

GAx3 GPln.Position ( )

Returns the local coordinate system of the plane .

◆ Rotated()

GPln GPln.Rotated	(	GAx1	theA1,
		double	theAng
	)

rotates a plane. theA1 is the axis of the rotation. theAng is the angular value of the rotation in radians.

◆ Scaled()

GPln GPln.Scaled	(	GPnt	theP,
		double	theS
	)

Scales a plane. theS is the scaling value.

◆ SetAxis()

void GPln.SetAxis ( GAx1 theA1 )

Modifies this plane, by redefining its local coordinate system so that - its origin and "main Direction" become those of the axis theA1 (the "X Direction" and "Y Direction" are then recomputed). Raises ConstructionError if the theA1 is parallel to the "XAxis" of the plane.

◆ SetLocation()

void GPln.SetLocation ( GPnt theLoc )

Changes the origin of the plane.

◆ SetPosition()

void GPln.SetPosition ( GAx3 theA3 )

Changes the local coordinate system of the plane.

◆ SquareDistance() [1/3]

double GPln.SquareDistance ( GLin theL )

Computes the square distance between <me> and the line <theL>.

◆ SquareDistance() [2/3]

double GPln.SquareDistance ( GPln theOther )

Computes the square distance between two planes.

◆ SquareDistance() [3/3]

double GPln.SquareDistance ( GPnt theP )

Computes the square distance between <me> and the point <theP>.

◆ Transformed()

GPln GPln.Transformed ( GTrsf theT )

Transforms a plane with the transformation theT from class Trsf. The transformation is performed on the "Location" point, on the "XAxis" and the "YAxis". The resulting normal direction is the cross product between the "XDirection" and the "YDirection" after transformation.

◆ Translated() [1/2]

GPln GPln.Translated	(	GPnt	theP1,
		GPnt	theP2
	)

Translates a plane from the point theP1 to the point theP2.

◆ Translated() [2/2]

GPln GPln.Translated ( GVec theV )

Translates a plane in the direction of the vector theV. The magnitude of the translation is the vector's magnitude.

◆ UReverse()

void GPln.UReverse ( )

Reverses the U parametrization of the plane reversing the XAxis.

◆ VReverse()

void GPln.VReverse ( )

Reverses the V parametrization of the plane reversing the YAxis.

◆ XAxis()

GAx1 GPln.XAxis ( )

Returns the X axis of the plane.

◆ YAxis()

GAx1 GPln.YAxis ( )

Returns the Y axis of the plane.

Public 成员函数