Open CASCADE Technology
7.6.0

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 righthanded, 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: More...
#include <gp_Pln.hxx>
Public Member Functions  
gp_Pln ()  
Creates a plane coincident with OXY plane of the reference coordinate system. More...  
gp_Pln (const gp_Ax3 &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. More...  
gp_Pln (const gp_Pnt &theP, const gp_Dir &theV)  
Creates a plane with the "Location" point <theP> and the normal direction <theV>. More...  
gp_Pln (const Standard_Real theA, const Standard_Real theB, const Standard_Real theC, const Standard_Real theD)  
Creates a plane from its cartesian equation : More...  
void  Coefficients (Standard_Real &theA, Standard_Real &theB, Standard_Real &theC, Standard_Real &theD) const 
Returns the coefficients of the plane's cartesian equation : More...  
void  SetAxis (const gp_Ax1 &theA1) 
Modifies this plane, by redefining its local coordinate system so that. More...  
void  SetLocation (const gp_Pnt &theLoc) 
Changes the origin of the plane. More...  
void  SetPosition (const gp_Ax3 &theA3) 
Changes the local coordinate system of the plane. More...  
void  UReverse () 
Reverses the U parametrization of the plane reversing the XAxis. More...  
void  VReverse () 
Reverses the V parametrization of the plane reversing the YAxis. More...  
Standard_Boolean  Direct () const 
returns true if the Ax3 is right handed. More...  
const gp_Ax1 &  Axis () const 
Returns the plane's normal Axis. More...  
const gp_Pnt &  Location () const 
Returns the plane's location (origin). More...  
const gp_Ax3 &  Position () const 
Returns the local coordinate system of the plane . More...  
Standard_Real  Distance (const gp_Pnt &theP) const 
Computes the distance between <me> and the point <theP>. More...  
Standard_Real  Distance (const gp_Lin &theL) const 
Computes the distance between <me> and the line <theL>. More...  
Standard_Real  Distance (const gp_Pln &theOther) const 
Computes the distance between two planes. More...  
Standard_Real  SquareDistance (const gp_Pnt &theP) const 
Computes the square distance between <me> and the point <theP>. More...  
Standard_Real  SquareDistance (const gp_Lin &theL) const 
Computes the square distance between <me> and the line <theL>. More...  
Standard_Real  SquareDistance (const gp_Pln &theOther) const 
Computes the square distance between two planes. More...  
gp_Ax1  XAxis () const 
Returns the X axis of the plane. More...  
gp_Ax1  YAxis () const 
Returns the Y axis of the plane. More...  
Standard_Boolean  Contains (const gp_Pnt &theP, const Standard_Real theLinearTolerance) const 
Returns true if this plane contains the point theP. This means that. More...  
Standard_Boolean  Contains (const gp_Lin &theL, const Standard_Real theLinearTolerance, const Standard_Real theAngularTolerance) const 
Returns true if this plane contains the line theL. This means that. More...  
void  Mirror (const gp_Pnt &theP) 
gp_Pln  Mirrored (const gp_Pnt &theP) const 
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. More...  
void  Mirror (const gp_Ax1 &theA1) 
gp_Pln  Mirrored (const gp_Ax1 &theA1) const 
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. More...  
void  Mirror (const gp_Ax2 &theA2) 
gp_Pln  Mirrored (const gp_Ax2 &theA2) const 
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. More...  
void  Rotate (const gp_Ax1 &theA1, const Standard_Real theAng) 
gp_Pln  Rotated (const gp_Ax1 &theA1, const Standard_Real theAng) const 
rotates a plane. theA1 is the axis of the rotation. theAng is the angular value of the rotation in radians. More...  
void  Scale (const gp_Pnt &theP, const Standard_Real theS) 
gp_Pln  Scaled (const gp_Pnt &theP, const Standard_Real theS) const 
Scales a plane. theS is the scaling value. More...  
void  Transform (const gp_Trsf &theT) 
gp_Pln  Transformed (const gp_Trsf &theT) const 
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. More...  
void  Translate (const gp_Vec &theV) 
gp_Pln  Translated (const gp_Vec &theV) const 
Translates a plane in the direction of the vector theV. The magnitude of the translation is the vector's magnitude. More...  
void  Translate (const gp_Pnt &theP1, const gp_Pnt &theP2) 
gp_Pln  Translated (const gp_Pnt &theP1, const gp_Pnt &theP2) const 
Translates a plane from the point theP1 to the point theP2. More...  
void  DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=1) const 
Dumps the content of me into the stream. More...  
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 righthanded, 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:

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

inline 
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.
Creates a plane with the "Location" point <theP> and the normal direction <theV>.
gp_Pln::gp_Pln  (  const Standard_Real  theA, 
const Standard_Real  theB,  
const Standard_Real  theC,  
const Standard_Real  theD  
) 
Creates a plane from its cartesian equation :
Raises ConstructionError if Sqrt (theA*theA + theB*theB + theC*theC) <= Resolution from gp.

inline 
Returns the plane's normal Axis.

inline 
Returns the coefficients of the plane's cartesian equation :

inline 
Returns true if this plane contains the line theL. This means that.

inline 
Returns true if this plane contains the point theP. This means that.

inline 
returns true if the Ax3 is right handed.

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

inline 
Computes the distance between two planes.

inline 
Computes the distance between <me> and the point <theP>.
void gp_Pln::DumpJson  (  Standard_OStream &  theOStream, 
Standard_Integer  theDepth = 1 

)  const 
Dumps the content of me into the stream.

inline 
Returns the plane's location (origin).
void gp_Pln::Mirror  (  const gp_Ax1 &  theA1  ) 
void gp_Pln::Mirror  (  const gp_Ax2 &  theA2  ) 
void gp_Pln::Mirror  (  const gp_Pnt &  theP  ) 
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.
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.
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.

inline 
Returns the local coordinate system of the plane .

inline 

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

inline 

inline 
Scales a plane. theS is the scaling value.

inline 
Modifies this plane, by redefining its local coordinate system so that.

inline 
Changes the origin of the plane.

inline 
Changes the local coordinate system of the plane.

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

inline 
Computes the square distance between two planes.

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

inline 
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.

inline 
Translates a plane from the point theP1 to the point theP2.
Translates a plane in the direction of the vector theV. The magnitude of the translation is the vector's magnitude.

inline 
Reverses the U parametrization of the plane reversing the XAxis.

inline 
Reverses the V parametrization of the plane reversing the YAxis.

inline 
Returns the X axis of the plane.

inline 
Returns the Y axis of the plane.