BRepFilletAPI — OpenCascade.js

OCCT package BRepFilletAPI: BRepFilletAPI_LocalOperation, BRepFilletAPI_MakeChamfer, BRepFilletAPI_MakeFillet, BRepFilletAPI_MakeFillet2d.

BRepFilletAPI_LocalOperation

BRepBuilderAPI_MakeShapeBRepBuilderAPI_Command

Construction of fillets on the edges of a Shell.

Instance methods(18)

Add(E: TopoDS_Edge): void
Adds a contour in the builder (builds a contour of tangent edges).
Parameters (1)
- E
ResetContour(IC: number): void
Reset the contour of index IC, there is nomore information in the contour.
Parameters (1)
- IC
NbContours(): number
Number of contours.
Contour(E: TopoDS_Edge): number
Returns the index of the contour containing the edge E, returns 0 if E doesn't belong to any contour.
Parameters (1)
- E
NbEdges(I: number): number
Number of Edges in the contour I.
Parameters (1)
- I
Edge(I: number, J: number): TopoDS_Edge
Returns the Edge J in the contour I.
Parameters (2)
- I
- J
Remove(E: TopoDS_Edge): void
remove the contour containing the Edge E.
Parameters (1)
- E
Length(IC: number): number
returns the length the contour of index IC.
Parameters (1)
- IC
FirstVertex(IC: number): TopoDS_Vertex
Returns the first Vertex of the contour of index IC.
Parameters (1)
- IC
LastVertex(IC: number): TopoDS_Vertex
Returns the last Vertex of the contour of index IC.
Parameters (1)
- IC
Abscissa(IC: number, V: TopoDS_Vertex): number
returns the abscissa of the vertex V on the contour of index IC.
Parameters (2)
- IC
- V
RelativeAbscissa(IC: number, V: TopoDS_Vertex): number
returns the relative abscissa([0.,1.]) of the vertex V on the contour of index IC.
Parameters (2)
- IC
- V
ClosedAndTangent(IC: number): boolean
returns true if the contour of index IC is closed an tangent.
Parameters (1)
- IC
Closed(IC: number): boolean
returns true if the contour of index IC is closed
Parameters (1)
- IC
Reset(): void
Reset all the fields updated by Build operation and leave the algorithm in the same state than before build call. It allows contours and radius modifications to build the result another time.
Simulate(IC: number): void
Parameters (1)
- IC
NbSurf(IC: number): number
Parameters (1)
- IC
Sect(IC: number, IS: number): NCollection_HArray1_ChFiDS_CircSection
Parameters (2)
- IC
- IS

BRepFilletAPI_MakeChamfer

BRepFilletAPI_LocalOperationBRepBuilderAPI_MakeShapeBRepBuilderAPI_Command

Describes functions to build chamfers on edges of a shell or solid. Chamfered Edge of a Shell or Solid A MakeChamfer object provides a framework for:

initializing the construction algorithm with a given shape,
acquiring the data characterizing the chamfers,
building the chamfers and constructing the resulting shape, and
consulting the result.

Constructors(1)

constructor(S: TopoDS_Shape): BRepFilletAPI_MakeChamfer
Initializes an algorithm for computing chamfers on the shape S. The edges on which chamfers are built are defined using the Add function.
Parameters (1)
- S

Instance methods(36)

Add(E: TopoDS_Edge): void
Adds edge E to the table of edges used by this algorithm to build chamfers, where the parameters of the chamfer must be set after the.
Parameters (1)
- E
Add(Dis: number, E: TopoDS_Edge): void
Adds edge E to the table of edges used by this algorithm to build chamfers, where the parameters of the chamfer are given by the distance Dis (symmetric chamfer). The Add function results in a contour being built by propagation from the edge E (i.e. the contour contains at least this edge). This contour is composed of edges of the shape which are tangential to one another and which delimit two series of tangential faces, with one series of faces being located on either side of the contour. Warning Nothing is done if edge E or the face F does not belong to the initial shape.
Parameters (2)
- Dis
- E
Add(Dis1: number, Dis2: number, E: TopoDS_Edge, F: TopoDS_Face): void
Adds edge E to the table of edges used by this algorithm to build chamfers, where the parameters of the chamfer are given by the two distances Dis1 and Dis2; the face F identifies the side where Dis1 is measured. The Add function results in a contour being built by propagation from the edge E (i.e. the contour contains at least this edge).
This contour is composed of edges of the shape which are tangential to one another and which delimit two series of tangential faces, with one series of faces being located on either side of the contour. Warning Nothing is done if edge E or the face F does not belong to the initial shape.
Parameters (4)
- Dis1
- Dis2
- E
- F
SetDist(Dis: number, IC: number, F: TopoDS_Face): void
Sets the distances Dis1 and Dis2 which give the parameters of the chamfer along the contour of index IC generated using the Add function in the internal data structure of this algorithm. The face F identifies the side where Dis1 is measured. Warning Nothing is done if either the edge E or the face F does not belong to the initial shape.
Parameters (3)
- Dis
- IC
- F
GetDist(IC: number, Dis: number): { Dis: number }
Parameters (2)
- IC
- Dis
SetDists(Dis1: number, Dis2: number, IC: number, F: TopoDS_Face): void
Sets the distances Dis1 and Dis2 which give the parameters of the chamfer along the contour of index IC generated using the Add function in the internal data structure of this algorithm. The face F identifies the side where Dis1 is measured. Warning Nothing is done if either the edge E or the face F does not belong to the initial shape.
Parameters (4)
- Dis1
- Dis2
- IC
- F
Dists(IC: number, Dis1: number, Dis2: number): { Dis1: number; Dis2: number }
Returns the distances Dis1 and Dis2 which give the parameters of the chamfer along the contour of index IC in the internal data structure of this algorithm. Warning -1. is returned if IC is outside the bounds of the table of contours.
Parameters (3)
- IC
- Dis1
- Dis2
Returns
A result object with fields:
- Dis1: updated value from the call.
- Dis2: updated value from the call.
AddDA(Dis: number, Angle: number, E: TopoDS_Edge, F: TopoDS_Face): void
Adds a fillet contour in the builder (builds a contour of tangent edges to <E> and sets the distance <Dis1> and angle <Angle> ( parameters of the chamfer ) ).
Parameters (4)
- Dis
- Angle
- E
- F
SetDistAngle(Dis: number, Angle: number, IC: number, F: TopoDS_Face): void
set the distance <Dis> and <Angle> of the fillet contour of index <IC> in the DS with <Dis> on <F>. if the face <F> is not one of common faces of an edge of the contour <IC>
Parameters (4)
- Dis
- Angle
- IC
- F
GetDistAngle(IC: number, Dis: number, Angle: number): { Dis: number; Angle: number }
gives the distances <Dis> and <Angle> of the fillet contour of index <IC> in the DS
Parameters (3)
- IC
- Dis
- Angle
Returns
A result object with fields:
- Dis: updated value from the call.
- Angle: updated value from the call.
SetMode(theMode: ChFiDS_ChamfMode): void
Sets the mode of chamfer.
Parameters (1)
- theMode
IsSymetric(IC: number): boolean
return True if chamfer symmetric false else.
Parameters (1)
- IC
IsTwoDistances(IC: number): boolean
return True if chamfer is made with two distances false else.
Parameters (1)
- IC
IsDistanceAngle(IC: number): boolean
return True if chamfer is made with distance and angle false else.
Parameters (1)
- IC
ResetContour(IC: number): void
Erases the chamfer parameters on the contour of index IC in the internal data structure of this algorithm. Use the SetDists function to reset this data. Warning Nothing is done if IC is outside the bounds of the table of contours.
Parameters (1)
- IC
NbContours(): number
Returns the number of contours generated using the Add function in the internal data structure of this algorithm.
Contour(E: TopoDS_Edge): number
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.
Parameters (1)
- E
NbEdges(I: number): number
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.
Parameters (1)
- I
Edge(I: number, J: number): TopoDS_Edge
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:
- I is outside the bounds of the table of contours, or
- J is outside the bounds of the table of edges of the contour of index I.
Parameters (2)
- I
- J
Remove(E: TopoDS_Edge): void
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.
Parameters (1)
- E
Length(IC: number): number
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.
Parameters (1)
- IC
FirstVertex(IC: number): TopoDS_Vertex
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.
Parameters (1)
- IC
LastVertex(IC: number): TopoDS_Vertex
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.
Parameters (1)
- IC
Abscissa(IC: number, V: TopoDS_Vertex): number
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:
- IC is outside the bounds of the table of contours, or
- V is not on the contour of index IC.
Parameters (2)
- IC
- V
RelativeAbscissa(IC: number, V: TopoDS_Vertex): number
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:
- IC is outside the bounds of the table of contours, or
- V is not on the contour of index IC.
Parameters (2)
- IC
- V
ClosedAndTangent(IC: number): boolean
eturns 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.
Parameters (1)
- IC
Closed(IC: number): boolean
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.
Parameters (1)
- IC
Build(theRange?: Message_ProgressRange): void
Builds the chamfers 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 chamfered shape is built. Use the function Shape to retrieve the chamfered shape. Warning The construction of chamfers implements highly complex construction algorithms.
Consequently, there may be instances where the algorithm fails, for example if the data defining the parameters of the chamfer is not compatible with the geometry of the initial shape. There is no initial analysis of errors and these only become evident at the construction stage. Additionally, in the current software release, the following cases are not handled:
- the end point of the contour is the point of intersection of 4 or more edges of the shape, or
- the intersection of the chamfer with a face which limits the contour is not fully contained in this face.
Parameters (1)
- theRange
Reset(): void
Reinitializes this algorithm, thus canceling the effects of the Build function. This function allows modifications to be made to the contours and chamfer parameters in order to rebuild the shape.
Builder(): unknown
Returns the internal filleting algorithm.
Generated(S: TopoDS_Shape): NCollection_List_TopoDS_Shape
Returns the list of shapes generated from the shape <EorV>.
Parameters (1)
- S
Modified(S: TopoDS_Shape): NCollection_List_TopoDS_Shape
Returns the list of shapes modified from the shape <F>.
Parameters (1)
- S
IsDeleted(S: TopoDS_Shape): boolean
Returns true if the shape S has been deleted.
Parameters (1)
- S
Simulate(IC: number): void
Parameters (1)
- IC
NbSurf(IC: number): number
Parameters (1)
- IC
Sect(IC: number, IS: number): NCollection_HArray1_ChFiDS_CircSection
Parameters (2)
- IC
- IS

BRepFilletAPI_MakeFillet

BRepFilletAPI_LocalOperationBRepBuilderAPI_MakeShapeBRepBuilderAPI_Command

Describes functions to build fillets on the broken edges of a shell or solid. A MakeFillet object provides a framework for:

initializing the construction algorithm with a given shape,
acquiring the data characterizing the fillets,
building the fillets and constructing the resulting shape, and
consulting the result.

Constructors(1)

constructor(S: TopoDS_Shape, FShape?: ChFi3d_FilletShape): BRepFilletAPI_MakeFillet
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.
Parameters (2)
- S
- FShape

Instance methods(55)

SetParams(Tang: number, Tesp: number, T2d: number, TApp3d: number, TolApp2d: number, Fleche: number): void
Parameters (6)
- Tang
- Tesp
- T2d
- TApp3d
- TolApp2d
- Fleche
SetContinuity(InternalContinuity: GeomAbs_Shape, AngularTolerance: number): void
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.
Parameters (2)
- InternalContinuity
- AngularTolerance
Add(E: TopoDS_Edge): void
Adds a fillet contour in the builder (builds a contour of tangent edges). The Radius must be set after.
Parameters (1)
- E
Add(Radius: number, E: TopoDS_Edge): void
Adds a fillet description in the builder.
- builds a contour of tangent edges,
- sets the radius.
Parameters (2)
- Radius
- E
Add(L: Law_Function, E: TopoDS_Edge): void
Adds a fillet description in the builder.
- builds a contour of tangent edges,
- sest the radius evolution law.
Parameters (2)
- L
- E
Add(UandR: NCollection_Array1_gp_Pnt2d, E: TopoDS_Edge): void
Adds a fillet description in the builder.
- builds a contour of tangent edges,
- sets the radius evolution law interpolating the values given in the array UandR :
  p2d.X() = relative parameter on the spine [0,1] p2d.Y() = value of the radius.
Parameters (2)
- UandR
- E
Add(R1: number, R2: number, E: TopoDS_Edge): void
Adds a fillet description in the builder.
- builds a contour of tangent edges,
- sets a linear radius evolution law between the first and last vertex of the spine.
Parameters (3)
- R1
- R2
- E
SetRadius(Radius: number, IC: number, IinC: number): void
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.
Parameters (3)
- Radius
- IC
- IinC
SetRadius(L: Law_Function, IC: number, IinC: number): void
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.
Parameters (3)
- L
- IC
- IinC
SetRadius(UandR: NCollection_Array1_gp_Pnt2d, IC: number, IinC: number): void
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:
- the X coordinate of a point in UandR defines a relative parameter on the contour (i.e. a parameter between 0 and 1),
- the Y coordinate of a point in UandR gives the corresponding value of the radius, and the radius evolves between the first and last vertices of the contour of index IC.
Parameters (3)
- UandR
- IC
- IinC
SetRadius(Radius: number, IC: number, E: TopoDS_Edge): void
Assigns Radius as the radius of the fillet on the edge E.
Parameters (3)
- Radius
- IC
- E
SetRadius(Radius: number, IC: number, V: TopoDS_Vertex): void
Parameters (3)
- Radius
- IC
- V
SetRadius(R1: number, R2: number, IC: number, IinC: number): void
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.
Parameters (4)
- R1
- R2
- IC
- IinC
ResetContour(IC: number): void
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.
Parameters (1)
- IC
IsConstant(IC: number): boolean
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.
Parameters (1)
- IC
IsConstant(IC: number, E: TopoDS_Edge): boolean
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.
Parameters (2)
- IC
- E
Radius(IC: number): number
Returns the radius of the fillet along the contour of index IC in the internal data structure of this algorithm Warning.
- Use this function only if the radius is constant.
- -1. 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.
Parameters (1)
- IC
Radius(IC: number, E: TopoDS_Edge): number
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.
- Use this function only if the radius is constant.
- -1 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.
Parameters (2)
- IC
- E
GetBounds(IC: number, E: TopoDS_Edge, F: number, L: number): { returnValue: boolean; F: number; L: number }
Parameters (4)
- IC
- E
- F
- L
GetLaw(IC: number, E: TopoDS_Edge): Law_Function
Parameters (2)
- IC
- E
SetLaw(IC: number, E: TopoDS_Edge, L: Law_Function): void
Parameters (3)
- IC
- E
- L
SetFilletShape(FShape: ChFi3d_FilletShape): void
Assigns FShape as the type of fillet shape built by this algorithm.
Parameters (1)
- FShape
GetFilletShape(): ChFi3d_FilletShape
Returns the type of fillet shape built by this algorithm.
NbContours(): number
Returns the number of contours generated using the Add function in the internal data structure of this algorithm.
Contour(E: TopoDS_Edge): number
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.
Parameters (1)
- E
NbEdges(I: number): number
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.
Parameters (1)
- I
Edge(I: number, J: number): TopoDS_Edge
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:
- I is outside the bounds of the table of contours, or
- J is outside the bounds of the table of edges of the index I contour.
Parameters (2)
- I
- J
Remove(E: TopoDS_Edge): void
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.
Parameters (1)
- E
Length(IC: number): number
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.
Parameters (1)
- IC
FirstVertex(IC: number): TopoDS_Vertex
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.
Parameters (1)
- IC
LastVertex(IC: number): TopoDS_Vertex
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.
Parameters (1)
- IC
Abscissa(IC: number, V: TopoDS_Vertex): number
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:
- IC is outside the bounds of the table of contours, or
- V is not on the contour of index IC.
Parameters (2)
- IC
- V
RelativeAbscissa(IC: number, V: TopoDS_Vertex): number
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:
- IC is outside the bounds of the table of contours, or
- V is not on the contour of index IC.
Parameters (2)
- IC
- V
ClosedAndTangent(IC: number): boolean
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.
Parameters (1)
- IC
Closed(IC: number): boolean
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.
Parameters (1)
- IC
Build(theRange?: Message_ProgressRange): void
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:
- the end point of the contour is the point of intersection of 4 or more edges of the shape, or
- the intersection of the fillet with a face which limits the contour is not fully contained in this face.
Parameters (1)
- theRange
Reset(): void
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.
Builder(): unknown
Returns the internal topology building algorithm.
Generated(S: TopoDS_Shape): NCollection_List_TopoDS_Shape
Returns the list of shapes generated from the shape <EorV>.
Parameters (1)
- S
Modified(S: TopoDS_Shape): NCollection_List_TopoDS_Shape
Returns the list of shapes modified from the shape <F>.
Parameters (1)
- S
IsDeleted(S: TopoDS_Shape): boolean
Returns true if the shape S has been deleted.
Parameters (1)
- S
NbSurfaces(): number
returns the number of surfaces after the shape creation.
NewFaces(I: number): NCollection_List_TopoDS_Shape
Return the faces created for surface .
Parameters (1)
- I
Simulate(IC: number): void
Parameters (1)
- IC
NbSurf(IC: number): number
Parameters (1)
- IC
Sect(IC: number, IS: number): NCollection_HArray1_ChFiDS_CircSection
Parameters (2)
- IC
- IS
NbFaultyContours(): number
Returns the number of contours where the computation of the fillet failed.
FaultyContour(I: number): number
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
Parameters (1)
- I
NbComputedSurfaces(IC: number): number
returns the number of surfaces which have been computed on the contour IC
Parameters (1)
- IC
ComputedSurface(IC: number, IS: number): Geom_Surface
returns the surface number IS concerning the contour IC
Parameters (2)
- IC
- IS
NbFaultyVertices(): number
returns the number of vertices where the computation failed
FaultyVertex(IV: number): TopoDS_Vertex
returns the vertex where the computation failed
Parameters (1)
- IV
HasResult(): boolean
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
BadShape(): TopoDS_Shape
if (HasResult()) returns the partial result
StripeStatus(IC: number): ChFiDS_ErrorStatus
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
Parameters (1)
- IC

BRepFilletAPI_MakeFillet2d

BRepBuilderAPI_MakeShapeBRepBuilderAPI_Command

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:

initializing the construction algorithm with a given face,
acquiring the data characterizing the fillets and chamfers,
building the fillets and chamfers, and constructing the resulting shape, and
consulting the result. Warning Only segments of straight lines and arcs of circles are treated. BSplines are not processed.

Constructors(2)

constructor(): 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.
constructor(F: TopoDS_Face): BRepFilletAPI_MakeFillet2d
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.
Parameters (1)
- F

Instance methods(23)

Init(F: TopoDS_Face): void
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.
Parameters (1)
- F
Init(RefFace: TopoDS_Face, ModFace: TopoDS_Face): void
This initialize method allow to init the builder from a face RefFace and another face ModFace which derive from RefFace. This is useful to modify a fillet or a chamfer already created on ModFace.
Parameters (2)
- RefFace
- ModFace
AddFillet(V: TopoDS_Vertex, Radius: number): TopoDS_Edge
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.
Parameters (2)
- V
- Radius
ModifyFillet(Fillet: TopoDS_Edge, Radius: number): TopoDS_Edge
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.
Parameters (2)
- Fillet
- Radius
RemoveFillet(Fillet: TopoDS_Edge): TopoDS_Vertex
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.
Parameters (1)
- Fillet
AddChamfer(E1: TopoDS_Edge, E2: TopoDS_Edge, D1: number, D2: number): TopoDS_Edge
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.
Parameters (4)
- E1
- E2
- D1
- D2
AddChamfer(E: TopoDS_Edge, V: TopoDS_Vertex, D: number, Ang: number): TopoDS_Edge
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.
Parameters (4)
- E
- V
- D
- Ang
ModifyChamfer(Chamfer: TopoDS_Edge, E1: TopoDS_Edge, E2: TopoDS_Edge, D1: number, D2: number): TopoDS_Edge
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.
Parameters (5)
- Chamfer
- E1
- E2
- D1
- D2
ModifyChamfer(Chamfer: TopoDS_Edge, E: TopoDS_Edge, D: number, Ang: number): TopoDS_Edge
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.
Parameters (4)
- Chamfer
- E
- D
- Ang
RemoveChamfer(Chamfer: TopoDS_Edge): TopoDS_Vertex
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.
Parameters (1)
- Chamfer
IsModified(E: TopoDS_Edge): boolean
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.
Parameters (1)
- E
FilletEdges(): NCollection_Sequence_TopoDS_Shape
Returns the table of fillets on the face modified by this algorithm.
NbFillet(): number
Returns the number of fillets on the face modified by this algorithm.
ChamferEdges(): NCollection_Sequence_TopoDS_Shape
Returns the table of chamfers on the face modified by this algorithm.
NbChamfer(): number
Returns the number of chamfers on the face modified by this algorithm.
Modified(S: TopoDS_Shape): NCollection_List_TopoDS_Shape
Returns the list of shapes modified from the shape .
Parameters (1)
- S
NbCurves(): number
returns the number of new curves after the shape creation.
NewEdges(I: number): NCollection_List_TopoDS_Shape
Return the Edges created for curve I.
Parameters (1)
- I
HasDescendant(E: TopoDS_Edge): boolean
Parameters (1)
- E
DescendantEdge(E: TopoDS_Edge): TopoDS_Edge
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.
Parameters (1)
- E
BasisEdge(E: TopoDS_Edge): TopoDS_Edge
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.
Parameters (1)
- E
Status(): ChFi2d_ConstructionError
Build(theRange?: Message_ProgressRange): void
Update the result and set the Done flag.
Parameters (1)
- theRange