![]() |
Open CASCADE Technology Reference Manual 8.0.0
|
Describes functions to build fillets on the broken edges of a shell or solid. A MakeFillet object provides a framework for: More...
#include <BRepFilletAPI_MakeFillet.hxx>

Public Member Functions | |
| BRepFilletAPI_MakeFillet (const TopoDS_Shape &S, const ChFi3d_FilletShape FShape=ChFi3d_Rational) | |
| Initializes the computation of the fillets. <FShape> sets the type of fillet surface. The default value is ChFi3d_Rational (classical nurbs representation of circles). ChFi3d_QuasiAngular corresponds to a nurbs representation of circles which parameterisation matches the circle one. ChFi3d_Polynomial corresponds to a polynomial representation of circles. | |
| void | SetParams (const double Tang, const double Tesp, const double T2d, const double TApp3d, const double TolApp2d, const double Fleche) |
| void | SetContinuity (const GeomAbs_Shape InternalContinuity, const double AngularTolerance) |
| Changes the parameters of continiuity InternalContinuity to produce fillet'surfaces with an continuity Ci (i=0,1 or 2). By defaultInternalContinuity = GeomAbs_C1. AngularTolerance is the G1 tolerance between fillet and support'faces. | |
| void | Add (const TopoDS_Edge &E) override |
| Adds a fillet contour in the builder (builds a contour of tangent edges). The Radius must be set after. | |
| void | Add (const double Radius, const TopoDS_Edge &E) |
| Adds a fillet description in the builder. | |
| void | Add (const double R1, const double R2, const TopoDS_Edge &E) |
| Adds a fillet description in the builder. | |
| void | Add (const occ::handle< Law_Function > &L, const TopoDS_Edge &E) |
| Adds a fillet description in the builder. | |
| void | Add (const NCollection_Array1< gp_Pnt2d > &UandR, const TopoDS_Edge &E) |
| Adds a fillet description in the builder. | |
| void | SetRadius (const double Radius, const int IC, const int IinC) |
| Sets the parameters of the fillet along the contour of index IC generated using the Add function in the internal data structure of this algorithm, where Radius is the radius of the fillet. | |
| void | SetRadius (const double R1, const double R2, const int IC, const int IinC) |
| Sets the parameters of the fillet along the contour of index IC generated using the Add function in the internal data structure of this algorithm, where the radius of the fillet evolves according to a linear evolution law defined from R1 to R2, between the first and last vertices of the contour of index IC. | |
| void | SetRadius (const occ::handle< Law_Function > &L, const int IC, const int IinC) |
| Sets the parameters of the fillet along the contour of index IC generated using the Add function in the internal data structure of this algorithm, where the radius of the fillet evolves according to the evolution law L, between the first and last vertices of the contour of index IC. | |
| void | SetRadius (const NCollection_Array1< gp_Pnt2d > &UandR, const int IC, const int IinC) |
| Sets the parameters of the fillet along the contour of index IC generated using the Add function in the internal data structure of this algorithm, where the radius of the fillet evolves according to the evolution law which interpolates the set of parameter and radius pairs given in the array UandR as follows: | |
| void | ResetContour (const int IC) override |
| Erases the radius information on the contour of index IC in the internal data structure of this algorithm. Use the SetRadius function to reset this data. Warning Nothing is done if IC is outside the bounds of the table of contours. | |
| bool | IsConstant (const int IC) |
| Returns true if the radius of the fillet along the contour of index IC in the internal data structure of this algorithm is constant, Warning False is returned if IC is outside the bounds of the table of contours or if E does not belong to the contour of index IC. | |
| double | Radius (const int IC) |
| Returns the radius of the fillet along the contour of index IC in the internal data structure of this algorithm Warning. | |
| bool | IsConstant (const int IC, const TopoDS_Edge &E) |
| Returns true if the radius of the fillet along the edge E of the contour of index IC in the internal data structure of this algorithm is constant. Warning False is returned if IC is outside the bounds of the table of contours or if E does not belong to the contour of index IC. | |
| double | Radius (const int IC, const TopoDS_Edge &E) |
| Returns the radius of the fillet along the edge E of the contour of index IC in the internal data structure of this algorithm. Warning. | |
| void | SetRadius (const double Radius, const int IC, const TopoDS_Edge &E) |
| Assigns Radius as the radius of the fillet on the edge E. | |
| void | SetRadius (const double Radius, const int IC, const TopoDS_Vertex &V) |
| bool | GetBounds (const int IC, const TopoDS_Edge &E, double &F, double &L) |
| occ::handle< Law_Function > | GetLaw (const int IC, const TopoDS_Edge &E) |
| void | SetLaw (const int IC, const TopoDS_Edge &E, const occ::handle< Law_Function > &L) |
| void | SetFilletShape (const ChFi3d_FilletShape FShape) |
| Assigns FShape as the type of fillet shape built by this algorithm. | |
| ChFi3d_FilletShape | GetFilletShape () const |
| Returns the type of fillet shape built by this algorithm. | |
| int | NbContours () const override |
| Returns the number of contours generated using the Add function in the internal data structure of this algorithm. | |
| int | Contour (const TopoDS_Edge &E) const override |
| Returns the index of the contour in the internal data structure of this algorithm which contains the edge E of the shape. This function returns 0 if the edge E does not belong to any contour. Warning This index can change if a contour is removed from the internal data structure of this algorithm using the function Remove. | |
| int | NbEdges (const int I) const override |
| Returns the number of edges in the contour of index I in the internal data structure of this algorithm. Warning Returns 0 if I is outside the bounds of the table of contours. | |
| const TopoDS_Edge & | Edge (const int I, const int J) const override |
| Returns the edge of index J in the contour of index I in the internal data structure of this algorithm. Warning Returns a null shape if: | |
| void | Remove (const TopoDS_Edge &E) override |
| Removes the contour in the internal data structure of this algorithm which contains the edge E of the shape. Warning Nothing is done if the edge E does not belong to the contour in the internal data structure of this algorithm. | |
| double | Length (const int IC) const override |
| Returns the length of the contour of index IC in the internal data structure of this algorithm. Warning Returns -1. if IC is outside the bounds of the table of contours. | |
| TopoDS_Vertex | FirstVertex (const int IC) const override |
| Returns the first vertex of the contour of index IC in the internal data structure of this algorithm. Warning Returns a null shape if IC is outside the bounds of the table of contours. | |
| TopoDS_Vertex | LastVertex (const int IC) const override |
| Returns the last vertex of the contour of index IC in the internal data structure of this algorithm. Warning Returns a null shape if IC is outside the bounds of the table of contours. | |
| double | Abscissa (const int IC, const TopoDS_Vertex &V) const override |
| Returns the curvilinear abscissa of the vertex V on the contour of index IC in the internal data structure of this algorithm. Warning Returns -1. if: | |
| double | RelativeAbscissa (const int IC, const TopoDS_Vertex &V) const override |
| Returns the relative curvilinear abscissa (i.e. between 0 and 1) of the vertex V on the contour of index IC in the internal data structure of this algorithm. Warning Returns -1. if: | |
| bool | ClosedAndTangent (const int IC) const override |
| Returns true if the contour of index IC in the internal data structure of this algorithm is closed and tangential at the point of closure. Warning Returns false if IC is outside the bounds of the table of contours. | |
| bool | Closed (const int IC) const override |
| Returns true if the contour of index IC in the internal data structure of this algorithm is closed. Warning Returns false if IC is outside the bounds of the table of contours. | |
| void | Build (const Message_ProgressRange &theRange=Message_ProgressRange()) override |
| Builds the fillets on all the contours in the internal data structure of this algorithm and constructs the resulting shape. Use the function IsDone to verify that the filleted shape is built. Use the function Shape to retrieve the filleted shape. Warning The construction of fillets implements highly complex construction algorithms. Consequently, there may be instances where the algorithm fails, for example if the data defining the radius of the fillet is not compatible with the geometry of the initial shape. There is no initial analysis of errors and they only become evident at the construction stage. Additionally, in the current software release, the following cases are not handled: | |
| void | Reset () override |
| Reinitializes this algorithm, thus canceling the effects of the Build function. This function allows modifications to be made to the contours and fillet parameters in order to rebuild the shape. | |
| occ::handle< TopOpeBRepBuild_HBuilder > | Builder () const |
| Returns the internal topology building algorithm. | |
| const NCollection_List< TopoDS_Shape > & | Generated (const TopoDS_Shape &EorV) override |
| Returns the list of shapes generated from the shape <EorV>. | |
| const NCollection_List< TopoDS_Shape > & | Modified (const TopoDS_Shape &F) override |
| Returns the list of shapes modified from the shape <F>. | |
| bool | IsDeleted (const TopoDS_Shape &F) override |
| Returns true if the shape S has been deleted. | |
| int | NbSurfaces () const |
| returns the number of surfaces after the shape creation. | |
| const NCollection_List< TopoDS_Shape > & | NewFaces (const int I) |
| Return the faces created for surface . | |
| void | Simulate (const int IC) override |
| int | NbSurf (const int IC) const override |
| occ::handle< NCollection_HArray1< ChFiDS_CircSection > > | Sect (const int IC, const int IS) const override |
| int | NbFaultyContours () const |
| Returns the number of contours where the computation of the fillet failed. | |
| int | FaultyContour (const int I) const |
| for each I in [1.. NbFaultyContours] returns the index IC of the contour where the computation of the fillet failed. the method NbEdges(IC) gives the number of edges in the contour IC the method Edge(IC,ie) gives the edge number ie of the contour IC | |
| int | NbComputedSurfaces (const int IC) const |
| returns the number of surfaces which have been computed on the contour IC | |
| occ::handle< Geom_Surface > | ComputedSurface (const int IC, const int IS) const |
| returns the surface number IS concerning the contour IC | |
| int | NbFaultyVertices () const |
| returns the number of vertices where the computation failed | |
| TopoDS_Vertex | FaultyVertex (const int IV) const |
| returns the vertex where the computation failed | |
| bool | HasResult () const |
| returns true if a part of the result has been computed if the filling in a corner failed a shape with a hole is returned | |
| TopoDS_Shape | BadShape () const |
| if (HasResult()) returns the partial result | |
| ChFiDS_ErrorStatus | StripeStatus (const int IC) const |
| returns the status concerning the contour IC in case of error ChFiDS_Ok : the computation is Ok ChFiDS_StartsolFailure : the computation can't start, perhaps the the radius is too big ChFiDS_TwistedSurface : the computation failed because of a twisted surface ChFiDS_WalkingFailure : there is a problem in the walking ChFiDS_Error: other error different from above | |
Public Member Functions inherited from BRepBuilderAPI_MakeShape | |
| virtual const TopoDS_Shape & | Shape () |
| Returns a shape built by the shape construction algorithm. Raises exception StdFail_NotDone if the shape was not built. | |
| operator TopoDS_Shape () | |
Public Member Functions inherited from BRepBuilderAPI_Command | |
| virtual | ~BRepBuilderAPI_Command () |
| virtual bool | IsDone () const |
| void | Check () const |
| Raises NotDone if done is false. | |
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. | |
| void | Done () |
| Set done to true. | |
| void | NotDone () |
| Set done to false. | |
Protected Attributes inherited from BRepBuilderAPI_MakeShape | |
| TopoDS_Shape | myShape |
| NCollection_List< TopoDS_Shape > | myGenerated |
Describes functions to build fillets on the broken edges of a shell or solid. A MakeFillet object provides a framework for:
| BRepFilletAPI_MakeFillet::BRepFilletAPI_MakeFillet | ( | const TopoDS_Shape & | S, |
| const ChFi3d_FilletShape | FShape = ChFi3d_Rational ) |
Initializes the computation of the fillets. <FShape> sets the type of fillet surface. The default value is ChFi3d_Rational (classical nurbs representation of circles). ChFi3d_QuasiAngular corresponds to a nurbs representation of circles which parameterisation matches the circle one. ChFi3d_Polynomial corresponds to a polynomial representation of circles.
|
overridevirtual |
Returns the curvilinear abscissa of the vertex V on the contour of index IC in the internal data structure of this algorithm. Warning Returns -1. if:
Implements BRepFilletAPI_LocalOperation.
| void BRepFilletAPI_MakeFillet::Add | ( | const double | R1, |
| const double | R2, | ||
| const TopoDS_Edge & | E ) |
Adds a fillet description in the builder.
| void BRepFilletAPI_MakeFillet::Add | ( | const double | Radius, |
| const TopoDS_Edge & | E ) |
Adds a fillet description in the builder.
| void BRepFilletAPI_MakeFillet::Add | ( | const NCollection_Array1< gp_Pnt2d > & | UandR, |
| const TopoDS_Edge & | E ) |
Adds a fillet description in the builder.
p2d.X() = relative parameter on the spine [0,1] p2d.Y() = value of the radius.
| void BRepFilletAPI_MakeFillet::Add | ( | const occ::handle< Law_Function > & | L, |
| const TopoDS_Edge & | E ) |
Adds a fillet description in the builder.
|
overridevirtual |
Adds a fillet contour in the builder (builds a contour of tangent edges). The Radius must be set after.
Implements BRepFilletAPI_LocalOperation.
| TopoDS_Shape BRepFilletAPI_MakeFillet::BadShape | ( | ) | const |
if (HasResult()) returns the partial result
|
overridevirtual |
Builds the fillets on all the contours in the internal data structure of this algorithm and constructs the resulting shape. Use the function IsDone to verify that the filleted shape is built. Use the function Shape to retrieve the filleted shape. Warning The construction of fillets implements highly complex construction algorithms. Consequently, there may be instances where the algorithm fails, for example if the data defining the radius of the fillet is not compatible with the geometry of the initial shape. There is no initial analysis of errors and they only become evident at the construction stage. Additionally, in the current software release, the following cases are not handled:
Reimplemented from BRepBuilderAPI_MakeShape.
| occ::handle< TopOpeBRepBuild_HBuilder > BRepFilletAPI_MakeFillet::Builder | ( | ) | const |
Returns the internal topology building algorithm.
Returns true if the contour of index IC in the internal data structure of this algorithm is closed. Warning Returns false if IC is outside the bounds of the table of contours.
Implements BRepFilletAPI_LocalOperation.
Returns true if the contour of index IC in the internal data structure of this algorithm is closed and tangential at the point of closure. Warning Returns false if IC is outside the bounds of the table of contours.
Implements BRepFilletAPI_LocalOperation.
| occ::handle< Geom_Surface > BRepFilletAPI_MakeFillet::ComputedSurface | ( | const int | IC, |
| const int | IS ) const |
returns the surface number IS concerning the contour IC
|
overridevirtual |
Returns the index of the contour in the internal data structure of this algorithm which contains the edge E of the shape. This function returns 0 if the edge E does not belong to any contour. Warning This index can change if a contour is removed from the internal data structure of this algorithm using the function Remove.
Implements BRepFilletAPI_LocalOperation.
|
overridevirtual |
Returns the edge of index J in the contour of index I in the internal data structure of this algorithm. Warning Returns a null shape if:
Implements BRepFilletAPI_LocalOperation.
for each I in [1.. NbFaultyContours] returns the index IC of the contour where the computation of the fillet failed. the method NbEdges(IC) gives the number of edges in the contour IC the method Edge(IC,ie) gives the edge number ie of the contour IC
| TopoDS_Vertex BRepFilletAPI_MakeFillet::FaultyVertex | ( | const int | IV | ) | const |
returns the vertex where the computation failed
|
overridevirtual |
Returns the first vertex of the contour of index IC in the internal data structure of this algorithm. Warning Returns a null shape if IC is outside the bounds of the table of contours.
Implements BRepFilletAPI_LocalOperation.
|
overridevirtual |
Returns the list of shapes generated from the shape <EorV>.
Reimplemented from BRepBuilderAPI_MakeShape.
| bool BRepFilletAPI_MakeFillet::GetBounds | ( | const int | IC, |
| const TopoDS_Edge & | E, | ||
| double & | F, | ||
| double & | L ) |
| ChFi3d_FilletShape BRepFilletAPI_MakeFillet::GetFilletShape | ( | ) | const |
Returns the type of fillet shape built by this algorithm.
| occ::handle< Law_Function > BRepFilletAPI_MakeFillet::GetLaw | ( | const int | IC, |
| const TopoDS_Edge & | E ) |
| bool BRepFilletAPI_MakeFillet::HasResult | ( | ) | const |
returns true if a part of the result has been computed if the filling in a corner failed a shape with a hole is returned
Returns true if the radius of the fillet along the contour of index IC in the internal data structure of this algorithm is constant, Warning False is returned if IC is outside the bounds of the table of contours or if E does not belong to the contour of index IC.
| bool BRepFilletAPI_MakeFillet::IsConstant | ( | const int | IC, |
| const TopoDS_Edge & | E ) |
Returns true if the radius of the fillet along the edge E of the contour of index IC in the internal data structure of this algorithm is constant. Warning False is returned if IC is outside the bounds of the table of contours or if E does not belong to the contour of index IC.
|
overridevirtual |
Returns true if the shape S has been deleted.
Reimplemented from BRepBuilderAPI_MakeShape.
|
overridevirtual |
Returns the last vertex of the contour of index IC in the internal data structure of this algorithm. Warning Returns a null shape if IC is outside the bounds of the table of contours.
Implements BRepFilletAPI_LocalOperation.
Returns the length of the contour of index IC in the internal data structure of this algorithm. Warning Returns -1. if IC is outside the bounds of the table of contours.
Implements BRepFilletAPI_LocalOperation.
|
overridevirtual |
Returns the list of shapes modified from the shape <F>.
Reimplemented from BRepBuilderAPI_MakeShape.
returns the number of surfaces which have been computed on the contour IC
|
overridevirtual |
Returns the number of contours generated using the Add function in the internal data structure of this algorithm.
Implements BRepFilletAPI_LocalOperation.
Returns the number of edges in the contour of index I in the internal data structure of this algorithm. Warning Returns 0 if I is outside the bounds of the table of contours.
Implements BRepFilletAPI_LocalOperation.
| int BRepFilletAPI_MakeFillet::NbFaultyContours | ( | ) | const |
Returns the number of contours where the computation of the fillet failed.
| int BRepFilletAPI_MakeFillet::NbFaultyVertices | ( | ) | const |
returns the number of vertices where the computation failed
Implements BRepFilletAPI_LocalOperation.
| int BRepFilletAPI_MakeFillet::NbSurfaces | ( | ) | const |
returns the number of surfaces after the shape creation.
| const NCollection_List< TopoDS_Shape > & BRepFilletAPI_MakeFillet::NewFaces | ( | const int | I | ) |
Return the faces created for surface .
Returns the radius of the fillet along the contour of index IC in the internal data structure of this algorithm Warning.
| double BRepFilletAPI_MakeFillet::Radius | ( | const int | IC, |
| const TopoDS_Edge & | E ) |
Returns the radius of the fillet along the edge E of the contour of index IC in the internal data structure of this algorithm. Warning.
|
overridevirtual |
Returns the relative curvilinear abscissa (i.e. between 0 and 1) of the vertex V on the contour of index IC in the internal data structure of this algorithm. Warning Returns -1. if:
Implements BRepFilletAPI_LocalOperation.
|
overridevirtual |
Removes the contour in the internal data structure of this algorithm which contains the edge E of the shape. Warning Nothing is done if the edge E does not belong to the contour in the internal data structure of this algorithm.
Implements BRepFilletAPI_LocalOperation.
|
overridevirtual |
Reinitializes this algorithm, thus canceling the effects of the Build function. This function allows modifications to be made to the contours and fillet parameters in order to rebuild the shape.
Implements BRepFilletAPI_LocalOperation.
Erases the radius information on the contour of index IC in the internal data structure of this algorithm. Use the SetRadius function to reset this data. Warning Nothing is done if IC is outside the bounds of the table of contours.
Implements BRepFilletAPI_LocalOperation.
|
overridevirtual |
Implements BRepFilletAPI_LocalOperation.
| void BRepFilletAPI_MakeFillet::SetContinuity | ( | const GeomAbs_Shape | InternalContinuity, |
| const double | AngularTolerance ) |
Changes the parameters of continiuity InternalContinuity to produce fillet'surfaces with an continuity Ci (i=0,1 or 2). By defaultInternalContinuity = GeomAbs_C1. AngularTolerance is the G1 tolerance between fillet and support'faces.
| void BRepFilletAPI_MakeFillet::SetFilletShape | ( | const ChFi3d_FilletShape | FShape | ) |
Assigns FShape as the type of fillet shape built by this algorithm.
| void BRepFilletAPI_MakeFillet::SetLaw | ( | const int | IC, |
| const TopoDS_Edge & | E, | ||
| const occ::handle< Law_Function > & | L ) |
| void BRepFilletAPI_MakeFillet::SetParams | ( | const double | Tang, |
| const double | Tesp, | ||
| const double | T2d, | ||
| const double | TApp3d, | ||
| const double | TolApp2d, | ||
| const double | Fleche ) |
| void BRepFilletAPI_MakeFillet::SetRadius | ( | const double | R1, |
| const double | R2, | ||
| const int | IC, | ||
| const int | IinC ) |
Sets the parameters of the fillet along the contour of index IC generated using the Add function in the internal data structure of this algorithm, where the radius of the fillet evolves according to a linear evolution law defined from R1 to R2, between the first and last vertices of the contour of index IC.
Sets the parameters of the fillet along the contour of index IC generated using the Add function in the internal data structure of this algorithm, where Radius is the radius of the fillet.
| void BRepFilletAPI_MakeFillet::SetRadius | ( | const double | Radius, |
| const int | IC, | ||
| const TopoDS_Edge & | E ) |
Assigns Radius as the radius of the fillet on the edge E.
| void BRepFilletAPI_MakeFillet::SetRadius | ( | const double | Radius, |
| const int | IC, | ||
| const TopoDS_Vertex & | V ) |
| void BRepFilletAPI_MakeFillet::SetRadius | ( | const NCollection_Array1< gp_Pnt2d > & | UandR, |
| const int | IC, | ||
| const int | IinC ) |
Sets the parameters of the fillet along the contour of index IC generated using the Add function in the internal data structure of this algorithm, where the radius of the fillet evolves according to the evolution law which interpolates the set of parameter and radius pairs given in the array UandR as follows:
| void BRepFilletAPI_MakeFillet::SetRadius | ( | const occ::handle< Law_Function > & | L, |
| const int | IC, | ||
| const int | IinC ) |
Sets the parameters of the fillet along the contour of index IC generated using the Add function in the internal data structure of this algorithm, where the radius of the fillet evolves according to the evolution law L, between the first and last vertices of the contour of index IC.
Implements BRepFilletAPI_LocalOperation.
| ChFiDS_ErrorStatus BRepFilletAPI_MakeFillet::StripeStatus | ( | const int | IC | ) | const |
returns the status concerning the contour IC in case of error ChFiDS_Ok : the computation is Ok ChFiDS_StartsolFailure : the computation can't start, perhaps the the radius is too big ChFiDS_TwistedSurface : the computation failed because of a twisted surface ChFiDS_WalkingFailure : there is a problem in the walking ChFiDS_Error: other error different from above