Open CASCADE Technology  7.3.0
Public Member Functions

BRepFilletAPI_MakeFillet2d Class Reference

Describes functions to build fillets and chamfers on the vertices of a planar face. Fillets and Chamfers on the Vertices of a Planar Face A MakeFillet2d object provides a framework for: More...

#include <BRepFilletAPI_MakeFillet2d.hxx>

Inheritance diagram for BRepFilletAPI_MakeFillet2d:
Inheritance graph
[legend]

Public Member Functions

 BRepFilletAPI_MakeFillet2d ()
 Initializes an empty algorithm for computing fillets and chamfers. The face on which the fillets and chamfers are built is defined using the Init function. The vertices on which fillets or chamfers are built are defined using the AddFillet or AddChamfer function. Warning The status of the initialization, as given by the Status function, can be one of the following: More...
 
 BRepFilletAPI_MakeFillet2d (const TopoDS_Face &F)
 Initializes an algorithm for computing fillets and chamfers on the face F. The vertices on which fillets or chamfers are built are defined using the AddFillet or AddChamfer function. Warning The status of the initialization, as given by the Status function, can be one of the following: More...
 
void Init (const TopoDS_Face &F)
 Initializes this algorithm for constructing fillets or chamfers with the face F. Warning The status of the initialization, as given by the Status function, can be one of the following: More...
 
void Init (const TopoDS_Face &RefFace, const TopoDS_Face &ModFace)
 This initialize method allow to init the builder from a face <RefFace> and another face <ModFace> which derive from <RefFace>. This is usefull to modify a fillet or a chamfer already created on <ModFace> . More...
 
TopoDS_Edge AddFillet (const TopoDS_Vertex &V, const Standard_Real Radius)
 Adds a fillet of radius Radius between the two edges adjacent to the vertex V on the face modified by this algorithm. The two edges do not need to be rectilinear. This function returns the fillet and builds the resulting face. Warning The status of the construction, as given by the Status function, can be one of the following: More...
 
TopoDS_Edge ModifyFillet (const TopoDS_Edge &Fillet, const Standard_Real Radius)
 Assigns the radius Radius to the fillet Fillet already built on the face modified by this algorithm. This function returns the new fillet and modifies the existing face. Warning The status of the construction, as given by the Status function, can be one of the following: More...
 
TopoDS_Vertex RemoveFillet (const TopoDS_Edge &Fillet)
 Removes the fillet Fillet already built on the face modified by this algorithm. This function returns the vertex connecting the two adjacent edges of Fillet and modifies the existing face. Warning. More...
 
TopoDS_Edge AddChamfer (const TopoDS_Edge &E1, const TopoDS_Edge &E2, const Standard_Real D1, const Standard_Real D2)
 Adds a chamfer on the face modified by this algorithm between the two adjacent edges E1 and E2, where the extremities of the chamfer are on E1 and E2 at distances D1 and D2 respectively In cases where the edges are not rectilinear, distances are measured using the curvilinear abscissa of the edges and the angle is measured with respect to the tangent at the corresponding point. The angle Ang is given in radians. This function returns the chamfer and builds the resulting face. More...
 
TopoDS_Edge AddChamfer (const TopoDS_Edge &E, const TopoDS_Vertex &V, const Standard_Real D, const Standard_Real Ang)
 Adds a chamfer on the face modified by this algorithm between the two edges connected by the vertex V, where E is one of the two edges. The chamfer makes an angle Ang with E and one of its extremities is on E at distance D from V. In cases where the edges are not rectilinear, distances are measured using the curvilinear abscissa of the edges and the angle is measured with respect to the tangent at the corresponding point. The angle Ang is given in radians. This function returns the chamfer and builds the resulting face. Warning The status of the construction, as given by the Status function, can be one of the following: More...
 
TopoDS_Edge ModifyChamfer (const TopoDS_Edge &Chamfer, const TopoDS_Edge &E1, const TopoDS_Edge &E2, const Standard_Real D1, const Standard_Real D2)
 Modifies the chamfer Chamfer on the face modified by this algorithm, where: E1 and E2 are the two adjacent edges on which Chamfer is already built; the extremities of the new chamfer are on E1 and E2 at distances D1 and D2 respectively. More...
 
TopoDS_Edge ModifyChamfer (const TopoDS_Edge &Chamfer, const TopoDS_Edge &E, const Standard_Real D, const Standard_Real Ang)
 Modifies the chamfer Chamfer on the face modified by this algorithm, where: E is one of the two adjacent edges on which Chamfer is already built; the new chamfer makes an angle Ang with E and one of its extremities is on E at distance D from the vertex on which the chamfer is built. In cases where the edges are not rectilinear, the distances are measured using the curvilinear abscissa of the edges and the angle is measured with respect to the tangent at the corresponding point. The angle Ang is given in radians. This function returns the new chamfer and modifies the existing face. Warning The status of the construction, as given by the Status function, can be one of the following: More...
 
TopoDS_Vertex RemoveChamfer (const TopoDS_Edge &Chamfer)
 Removes the chamfer Chamfer already built on the face modified by this algorithm. This function returns the vertex connecting the two adjacent edges of Chamfer and modifies the existing face. Warning. More...
 
Standard_Boolean IsModified (const TopoDS_Edge &E) const
 Returns true if the edge E on the face modified by this algorithm is chamfered or filleted. Warning Returns false if E does not belong to the face modified by this algorithm. More...
 
const TopTools_SequenceOfShapeFilletEdges () const
 Returns the table of fillets on the face modified by this algorithm. More...
 
Standard_Integer NbFillet () const
 Returns the number of fillets on the face modified by this algorithm. More...
 
const TopTools_SequenceOfShapeChamferEdges () const
 Returns the table of chamfers on the face modified by this algorithm. More...
 
Standard_Integer NbChamfer () const
 Returns the number of chamfers on the face modified by this algorithm. More...
 
virtual const TopTools_ListOfShapeModified (const TopoDS_Shape &S) override
 Returns the list of shapes modified from the shape <S>. More...
 
Standard_Integer NbCurves () const
 returns the number of new curves after the shape creation. More...
 
const TopTools_ListOfShapeNewEdges (const Standard_Integer I)
 Return the Edges created for curve I. More...
 
Standard_Boolean HasDescendant (const TopoDS_Edge &E) const
 
const TopoDS_EdgeDescendantEdge (const TopoDS_Edge &E) const
 Returns the chamfered or filleted edge built from the edge E on the face modified by this algorithm. If E has not been modified, this function returns E. Exceptions Standard_NoSuchObject if the edge E does not belong to the initial face. More...
 
const TopoDS_EdgeBasisEdge (const TopoDS_Edge &E) const
 Returns the basis edge on the face modified by this algorithm from which the chamfered or filleted edge E is built. If E has not been modified, this function returns E. Warning E is returned if it does not belong to the initial face. More...
 
ChFi2d_ConstructionError Status () const
 
virtual void Build () override
 Update the result and set the Done flag. More...
 
- Public Member Functions inherited from BRepBuilderAPI_MakeShape
virtual const TopoDS_ShapeShape ()
 Returns a shape built by the shape construction algorithm. Raises exception StdFail_NotDone if the shape was not built. More...
 
 operator TopoDS_Shape ()
 
virtual const TopTools_ListOfShapeGenerated (const TopoDS_Shape &S)
 Returns the list of shapes generated from the shape <S>. More...
 
virtual Standard_Boolean IsDeleted (const TopoDS_Shape &S)
 Returns true if the shape S has been deleted. More...
 
- Public Member Functions inherited from BRepBuilderAPI_Command
virtual ~BRepBuilderAPI_Command ()
 
virtual Standard_Boolean IsDone () const
 
void Check () const
 Raises NotDone if done is false. More...
 

Additional Inherited Members

- Protected Member Functions inherited from BRepBuilderAPI_MakeShape
 BRepBuilderAPI_MakeShape ()
 
- Protected Member Functions inherited from BRepBuilderAPI_Command
 BRepBuilderAPI_Command ()
 Set done to False. More...
 
void Done ()
 Set done to true. More...
 
void NotDone ()
 Set done to false. More...
 
- Protected Attributes inherited from BRepBuilderAPI_MakeShape
TopoDS_Shape myShape
 
TopTools_ListOfShape myGenerated
 

Detailed Description

Describes functions to build fillets and chamfers on the vertices of a planar face. Fillets and Chamfers on the Vertices of a Planar Face A MakeFillet2d object provides a framework for:

Constructor & Destructor Documentation

◆ BRepFilletAPI_MakeFillet2d() [1/2]

BRepFilletAPI_MakeFillet2d::BRepFilletAPI_MakeFillet2d ( )

Initializes an empty algorithm for computing fillets and chamfers. The face on which the fillets and chamfers are built is defined using the Init function. The vertices on which fillets or chamfers are built are defined using the AddFillet or AddChamfer function. Warning The status of the initialization, as given by the Status function, can be one of the following:

  • ChFi2d_Ready if the initialization is correct,
  • ChFi2d_NotPlanar if F is not planar,
  • ChFi2d_NoFace if F is a null face.

◆ BRepFilletAPI_MakeFillet2d() [2/2]

BRepFilletAPI_MakeFillet2d::BRepFilletAPI_MakeFillet2d ( const TopoDS_Face F)

Initializes an algorithm for computing fillets and chamfers on the face F. The vertices on which fillets or chamfers are built are defined using the AddFillet or AddChamfer function. Warning The status of the initialization, as given by the Status function, can be one of the following:

  • ChFi2d_Ready if the initialization is correct,
  • ChFi2d_NotPlanar if F is not planar,
  • ChFi2d_NoFace if F is a null face.

Member Function Documentation

◆ AddChamfer() [1/2]

TopoDS_Edge BRepFilletAPI_MakeFillet2d::AddChamfer ( const TopoDS_Edge E1,
const TopoDS_Edge E2,
const Standard_Real  D1,
const Standard_Real  D2 
)

Adds a chamfer on the face modified by this algorithm between the two adjacent edges E1 and E2, where the extremities of the chamfer are on E1 and E2 at distances D1 and D2 respectively In cases where the edges are not rectilinear, distances are measured using the curvilinear abscissa of the edges and the angle is measured with respect to the tangent at the corresponding point. The angle Ang is given in radians. This function returns the chamfer and builds the resulting face.

◆ AddChamfer() [2/2]

TopoDS_Edge BRepFilletAPI_MakeFillet2d::AddChamfer ( const TopoDS_Edge E,
const TopoDS_Vertex V,
const Standard_Real  D,
const Standard_Real  Ang 
)

Adds a chamfer on the face modified by this algorithm between the two edges connected by the vertex V, where E is one of the two edges. The chamfer makes an angle Ang with E and one of its extremities is on E at distance D from V. In cases where the edges are not rectilinear, distances are measured using the curvilinear abscissa of the edges and the angle is measured with respect to the tangent at the corresponding point. The angle Ang is given in radians. This function returns the chamfer and builds the resulting face. Warning The status of the construction, as given by the Status function, can be one of the following:

  • ChFi2d_IsDone if the chamfer is built,
  • ChFi2d_ParametersError if D1, D2, D or Ang is less than or equal to zero,
  • ChFi2d_ConnexionError if:
  • the edge E, E1 or E2 does not belong to the initial face, or
  • the edges E1 and E2 are not adjacent, or
  • the vertex V is not one of the limit points of the edge E,
  • ChFi2d_ComputationError if the parameters of the chamfer are too large to build a chamfer between the two adjacent edges,
  • ChFi2d_NotAuthorized if:
  • the edge E1, E2 or one of the two edges connected to V is a fillet or chamfer, or
  • a curve other than a straight line or an arc of a circle is used as E, E1 or E2. Do not use the returned chamfer if the status of the construction is not ChFi2d_IsDone.

◆ AddFillet()

TopoDS_Edge BRepFilletAPI_MakeFillet2d::AddFillet ( const TopoDS_Vertex V,
const Standard_Real  Radius 
)

Adds a fillet of radius Radius between the two edges adjacent to the vertex V on the face modified by this algorithm. The two edges do not need to be rectilinear. This function returns the fillet and builds the resulting face. Warning The status of the construction, as given by the Status function, can be one of the following:

  • ChFi2d_IsDone if the fillet is built,
  • ChFi2d_ConnexionError if V does not belong to the initial face,
  • ChFi2d_ComputationError if Radius is too large to build a fillet between the two adjacent edges,
  • ChFi2d_NotAuthorized
  • if one of the two edges connected to V is a fillet or chamfer, or
  • if a curve other than a straight line or an arc of a circle is used as E, E1 or E2. Do not use the returned fillet if the status of the construction is not ChFi2d_IsDone. Exceptions Standard_NegativeValue if Radius is less than or equal to zero.

◆ BasisEdge()

const TopoDS_Edge& BRepFilletAPI_MakeFillet2d::BasisEdge ( const TopoDS_Edge E) const

Returns the basis edge on the face modified by this algorithm from which the chamfered or filleted edge E is built. If E has not been modified, this function returns E. Warning E is returned if it does not belong to the initial face.

◆ Build()

virtual void BRepFilletAPI_MakeFillet2d::Build ( )
overridevirtual

Update the result and set the Done flag.

Reimplemented from BRepBuilderAPI_MakeShape.

◆ ChamferEdges()

const TopTools_SequenceOfShape& BRepFilletAPI_MakeFillet2d::ChamferEdges ( ) const

Returns the table of chamfers on the face modified by this algorithm.

◆ DescendantEdge()

const TopoDS_Edge& BRepFilletAPI_MakeFillet2d::DescendantEdge ( const TopoDS_Edge E) const

Returns the chamfered or filleted edge built from the edge E on the face modified by this algorithm. If E has not been modified, this function returns E. Exceptions Standard_NoSuchObject if the edge E does not belong to the initial face.

◆ FilletEdges()

const TopTools_SequenceOfShape& BRepFilletAPI_MakeFillet2d::FilletEdges ( ) const

Returns the table of fillets on the face modified by this algorithm.

◆ HasDescendant()

Standard_Boolean BRepFilletAPI_MakeFillet2d::HasDescendant ( const TopoDS_Edge E) const

◆ Init() [1/2]

void BRepFilletAPI_MakeFillet2d::Init ( const TopoDS_Face F)

Initializes this algorithm for constructing fillets or chamfers with the face F. Warning The status of the initialization, as given by the Status function, can be one of the following:

  • ChFi2d_Ready if the initialization is correct,
  • ChFi2d_NotPlanar if F is not planar,
  • ChFi2d_NoFace if F is a null face.

◆ Init() [2/2]

void BRepFilletAPI_MakeFillet2d::Init ( const TopoDS_Face RefFace,
const TopoDS_Face ModFace 
)

This initialize method allow to init the builder from a face <RefFace> and another face <ModFace> which derive from <RefFace>. This is usefull to modify a fillet or a chamfer already created on <ModFace> .

◆ IsModified()

Standard_Boolean BRepFilletAPI_MakeFillet2d::IsModified ( const TopoDS_Edge E) const

Returns true if the edge E on the face modified by this algorithm is chamfered or filleted. Warning Returns false if E does not belong to the face modified by this algorithm.

◆ Modified()

virtual const TopTools_ListOfShape& BRepFilletAPI_MakeFillet2d::Modified ( const TopoDS_Shape S)
overridevirtual

Returns the list of shapes modified from the shape <S>.

Reimplemented from BRepBuilderAPI_MakeShape.

◆ ModifyChamfer() [1/2]

TopoDS_Edge BRepFilletAPI_MakeFillet2d::ModifyChamfer ( const TopoDS_Edge Chamfer,
const TopoDS_Edge E1,
const TopoDS_Edge E2,
const Standard_Real  D1,
const Standard_Real  D2 
)

Modifies the chamfer Chamfer on the face modified by this algorithm, where: E1 and E2 are the two adjacent edges on which Chamfer is already built; the extremities of the new chamfer are on E1 and E2 at distances D1 and D2 respectively.

◆ ModifyChamfer() [2/2]

TopoDS_Edge BRepFilletAPI_MakeFillet2d::ModifyChamfer ( const TopoDS_Edge Chamfer,
const TopoDS_Edge E,
const Standard_Real  D,
const Standard_Real  Ang 
)

Modifies the chamfer Chamfer on the face modified by this algorithm, where: E is one of the two adjacent edges on which Chamfer is already built; the new chamfer makes an angle Ang with E and one of its extremities is on E at distance D from the vertex on which the chamfer is built. In cases where the edges are not rectilinear, the distances are measured using the curvilinear abscissa of the edges and the angle is measured with respect to the tangent at the corresponding point. The angle Ang is given in radians. This function returns the new chamfer and modifies the existing face. Warning The status of the construction, as given by the Status function, can be one of the following:

  • ChFi2d_IsDone if the chamfer is built,
  • ChFi2d_ParametersError if D1, D2, D or Ang is less than or equal to zero,
  • ChFi2d_ConnexionError if:
  • the edge E, E1, E2 or Chamfer does not belong to the existing face, or
  • the edges E1 and E2 are not adjacent,
  • ChFi2d_ComputationError if the parameters of the chamfer are too large to build a chamfer between the two adjacent edges,
  • ChFi2d_NotAuthorized if E1 or E2 is a fillet or chamfer. Do not use the returned chamfer if the status of the construction is not ChFi2d_IsDone.

◆ ModifyFillet()

TopoDS_Edge BRepFilletAPI_MakeFillet2d::ModifyFillet ( const TopoDS_Edge Fillet,
const Standard_Real  Radius 
)

Assigns the radius Radius to the fillet Fillet already built on the face modified by this algorithm. This function returns the new fillet and modifies the existing face. Warning The status of the construction, as given by the Status function, can be one of the following:

  • ChFi2d_IsDone if the new fillet is built,
  • ChFi2d_ConnexionError if Fillet does not belong to the existing face,
  • ChFi2d_ComputationError if Radius is too large to build a fillet between the two adjacent edges. Do not use the returned fillet if the status of the construction is not ChFi2d_IsDone. Exceptions Standard_NegativeValue if Radius is less than or equal to zero.

◆ NbChamfer()

Standard_Integer BRepFilletAPI_MakeFillet2d::NbChamfer ( ) const

Returns the number of chamfers on the face modified by this algorithm.

◆ NbCurves()

Standard_Integer BRepFilletAPI_MakeFillet2d::NbCurves ( ) const

returns the number of new curves after the shape creation.

◆ NbFillet()

Standard_Integer BRepFilletAPI_MakeFillet2d::NbFillet ( ) const

Returns the number of fillets on the face modified by this algorithm.

◆ NewEdges()

const TopTools_ListOfShape& BRepFilletAPI_MakeFillet2d::NewEdges ( const Standard_Integer  I)

Return the Edges created for curve I.

◆ RemoveChamfer()

TopoDS_Vertex BRepFilletAPI_MakeFillet2d::RemoveChamfer ( const TopoDS_Edge Chamfer)

Removes the chamfer Chamfer already built on the face modified by this algorithm. This function returns the vertex connecting the two adjacent edges of Chamfer and modifies the existing face. Warning.

  • The returned vertex is only valid if the Status function returns ChFi2d_IsDone.
  • A null vertex is returned if the edge Chamfer does not belong to the initial face.

◆ RemoveFillet()

TopoDS_Vertex BRepFilletAPI_MakeFillet2d::RemoveFillet ( const TopoDS_Edge Fillet)

Removes the fillet Fillet already built on the face modified by this algorithm. This function returns the vertex connecting the two adjacent edges of Fillet and modifies the existing face. Warning.

  • The returned vertex is only valid if the Status function returns ChFi2d_IsDone.
  • A null vertex is returned if the edge Fillet does not belong to the initial face.

◆ Status()

ChFi2d_ConstructionError BRepFilletAPI_MakeFillet2d::Status ( ) const

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