OCCT3D OCCT 8.0.1
OCCT documentation

Search guides and API reference

Enter at least two characters.

    Open CASCADE Technology Reference Manual 8.0.1
    BRepBuilderAPI_FindPlane Class Reference

    Describes functions to find the plane in which the edges of a given shape are located. A FindPlane object provides a framework for: More...

    #include <BRepBuilderAPI_FindPlane.hxx>

    Public Member Functions

     BRepBuilderAPI_FindPlane ()
     Initializes an empty algorithm. The function Init is then used to define the shape.
     BRepBuilderAPI_FindPlane (const TopoDS_Shape &S, const double Tol=-1)
     Constructs the plane containing the edges of the shape S. A plane is built only if all the edges are within a distance of less than or equal to tolerance from a planar surface. This tolerance value is equal to the larger of the following two values:
    void Init (const TopoDS_Shape &S, const double Tol=-1)
     Constructs the plane containing the edges of the shape S. A plane is built only if all the edges are within a distance of less than or equal to tolerance from a planar surface. This tolerance value is equal to the larger of the following two values:
    bool Found () const
     Returns true if a plane containing the edges of the shape is found and built. Use the function Plane to consult the result.
    occ::handle< Geom_PlanePlane () const
     Returns the plane containing the edges of the shape. Warning Use the function Found to verify that the plane is built. If a plane is not found, Plane returns a null handle.

    Detailed Description

    Describes functions to find the plane in which the edges of a given shape are located. A FindPlane object provides a framework for:

    • extracting the edges of a given shape,
    • implementing the construction algorithm, and
    • consulting the result.

    Constructor & Destructor Documentation

    ◆ BRepBuilderAPI_FindPlane() [1/2]

    BRepBuilderAPI_FindPlane::BRepBuilderAPI_FindPlane ( )

    Initializes an empty algorithm. The function Init is then used to define the shape.

    ◆ BRepBuilderAPI_FindPlane() [2/2]

    BRepBuilderAPI_FindPlane::BRepBuilderAPI_FindPlane ( const TopoDS_Shape & S,
    const double Tol = -1 )

    Constructs the plane containing the edges of the shape S. A plane is built only if all the edges are within a distance of less than or equal to tolerance from a planar surface. This tolerance value is equal to the larger of the following two values:

    • Tol, where the default value is negative, or
    • the largest of the tolerance values assigned to the individual edges of S. Use the function Found to verify that a plane is built. The resulting plane is then retrieved using the function Plane.

    Member Function Documentation

    ◆ Found()

    bool BRepBuilderAPI_FindPlane::Found ( ) const

    Returns true if a plane containing the edges of the shape is found and built. Use the function Plane to consult the result.

    ◆ Init()

    void BRepBuilderAPI_FindPlane::Init ( const TopoDS_Shape & S,
    const double Tol = -1 )

    Constructs the plane containing the edges of the shape S. A plane is built only if all the edges are within a distance of less than or equal to tolerance from a planar surface. This tolerance value is equal to the larger of the following two values:

    • Tol, where the default value is negative, or
    • the largest of the tolerance values assigned to the individual edges of S. Use the function Found to verify that a plane is built. The resulting plane is then retrieved using the function Plane.

    ◆ Plane()

    occ::handle< Geom_Plane > BRepBuilderAPI_FindPlane::Plane ( ) const

    Returns the plane containing the edges of the shape. Warning Use the function Found to verify that the plane is built. If a plane is not found, Plane returns a null handle.


    The documentation for this class was generated from the following file: