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: More...

#include <BRepFilletAPI_MakeChamfer.hxx>

Inheritance diagram for BRepFilletAPI_MakeChamfer:

[legend]

Public Member Functions
	BRepFilletAPI_MakeChamfer (const TopoDS_Shape &S)
	Initializes an algorithm for computing chamfers on the shape S. The edges on which chamfers are built are defined using the Add function.

void	Add (const TopoDS_Edge &E) override
	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.

void	Add (const Standard_Real Dis, const TopoDS_Edge &E)
	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.

void	SetDist (const Standard_Real Dis, const Standard_Integer IC, const TopoDS_Face &F)
	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.

void	GetDist (const Standard_Integer IC, Standard_Real &Dis) const

void	Add (const Standard_Real Dis1, const Standard_Real Dis2, const TopoDS_Edge &E, const TopoDS_Face &F)
	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.

void	SetDists (const Standard_Real Dis1, const Standard_Real Dis2, const Standard_Integer IC, const TopoDS_Face &F)
	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.

void	Dists (const Standard_Integer IC, Standard_Real &Dis1, Standard_Real &Dis2) const
	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.

void	AddDA (const Standard_Real Dis, const Standard_Real Angle, const TopoDS_Edge &E, const TopoDS_Face &F)
	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 ) ).

void	SetDistAngle (const Standard_Real Dis, const Standard_Real Angle, const Standard_Integer IC, const TopoDS_Face &F)
	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>

void	GetDistAngle (const Standard_Integer IC, Standard_Real &Dis, Standard_Real &Angle) const
	gives the distances <Dis> and <Angle> of the fillet contour of index <IC> in the DS

void	SetMode (const ChFiDS_ChamfMode theMode)
	Sets the mode of chamfer.

Standard_Boolean	IsSymetric (const Standard_Integer IC) const
	return True if chamfer symmetric false else.

Standard_Boolean	IsTwoDistances (const Standard_Integer IC) const
	return True if chamfer is made with two distances false else.

Standard_Boolean	IsDistanceAngle (const Standard_Integer IC) const
	return True if chamfer is made with distance and angle false else.

void	ResetContour (const Standard_Integer IC) override
	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.

Standard_Integer	NbContours () const override
	Returns the number of contours generated using the Add function in the internal data structure of this algorithm.

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

Standard_Integer	NbEdges (const Standard_Integer 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 Standard_Integer I, const Standard_Integer 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.

Standard_Real	Length (const Standard_Integer 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 Standard_Integer 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 Standard_Integer 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.

Standard_Real	Abscissa (const Standard_Integer 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:

Standard_Real	RelativeAbscissa (const Standard_Integer 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:

Standard_Boolean	ClosedAndTangent (const Standard_Integer IC) const override
	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.

Standard_Boolean	Closed (const Standard_Integer 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.

virtual void	Build (const Message_ProgressRange &theRange=Message_ProgressRange()) override
	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:

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 chamfer parameters in order to rebuild the shape.

Handle< TopOpeBRepBuild_HBuilder >	Builder () const
	Returns the internal filleting algorithm.

virtual const TopTools_ListOfShape &	Generated (const TopoDS_Shape &EorV) override
	Returns the list of shapes generated from the shape <EorV>.

virtual const TopTools_ListOfShape &	Modified (const TopoDS_Shape &F) override
	Returns the list of shapes modified from the shape <F>.

virtual Standard_Boolean	IsDeleted (const TopoDS_Shape &F) override
	Returns true if the shape S has been deleted.

void	Simulate (const Standard_Integer IC) override

Standard_Integer	NbSurf (const Standard_Integer IC) const override

Handle< ChFiDS_SecHArray1 >	Sect (const Standard_Integer IC, const Standard_Integer IS) const override

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 Standard_Boolean	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

TopTools_ListOfShape	myGenerated

Detailed Description

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.

Constructor & Destructor Documentation

◆ BRepFilletAPI_MakeChamfer()

BRepFilletAPI_MakeChamfer::BRepFilletAPI_MakeChamfer ( const TopoDS_Shape & S )

Initializes an algorithm for computing chamfers on the shape S. The edges on which chamfers are built are defined using the Add function.

Member Function Documentation

◆ Abscissa()

Standard_Real BRepFilletAPI_MakeChamfer::Abscissa	(	const Standard_Integer	IC,
		const TopoDS_Vertex &	V
	)		const

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:

IC is outside the bounds of the table of contours, or
V is not on the contour of index IC.

Implements BRepFilletAPI_LocalOperation.

◆ Add() [1/3]

void BRepFilletAPI_MakeChamfer::Add	(	const Standard_Real	Dis,
		const TopoDS_Edge &	E
	)

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.

◆ Add() [2/3]

void BRepFilletAPI_MakeChamfer::Add	(	const Standard_Real	Dis1,
		const Standard_Real	Dis2,
		const TopoDS_Edge &	E,
		const TopoDS_Face &	F
	)

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.

◆ Add() [3/3]

void BRepFilletAPI_MakeChamfer::Add ( const TopoDS_Edge & E )

overridevirtual

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.

Implements BRepFilletAPI_LocalOperation.

◆ AddDA()

void BRepFilletAPI_MakeChamfer::AddDA	(	const Standard_Real	Dis,
		const Standard_Real	Angle,
		const TopoDS_Edge &	E,
		const TopoDS_Face &	F
	)

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

◆ Build()

virtual void BRepFilletAPI_MakeChamfer::Build ( const Message_ProgressRange & theRange = Message_ProgressRange() )

overridevirtual

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.

Reimplemented from BRepBuilderAPI_MakeShape.

◆ Builder()

Handle< TopOpeBRepBuild_HBuilder > BRepFilletAPI_MakeChamfer::Builder ( ) const

Returns the internal filleting algorithm.

◆ Closed()

Standard_Boolean BRepFilletAPI_MakeChamfer::Closed ( const Standard_Integer IC ) const

overridevirtual

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.

◆ ClosedAndTangent()

Standard_Boolean BRepFilletAPI_MakeChamfer::ClosedAndTangent ( const Standard_Integer IC ) const

overridevirtual

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.

Implements BRepFilletAPI_LocalOperation.

◆ Contour()

Standard_Integer BRepFilletAPI_MakeChamfer::Contour ( const TopoDS_Edge & E ) const

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.

◆ Dists()

void BRepFilletAPI_MakeChamfer::Dists	(	const Standard_Integer	IC,
		Standard_Real &	Dis1,
		Standard_Real &	Dis2
	)		const

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.

◆ Edge()

const TopoDS_Edge & BRepFilletAPI_MakeChamfer::Edge	(	const Standard_Integer	I,
		const Standard_Integer	J
	)		const

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:

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.

Implements BRepFilletAPI_LocalOperation.

◆ FirstVertex()

TopoDS_Vertex BRepFilletAPI_MakeChamfer::FirstVertex ( const Standard_Integer IC ) const

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.

◆ Generated()

virtual const TopTools_ListOfShape & BRepFilletAPI_MakeChamfer::Generated ( const TopoDS_Shape & EorV )

overridevirtual

Returns the list of shapes generated from the shape <EorV>.

Reimplemented from BRepBuilderAPI_MakeShape.

◆ GetDist()

void BRepFilletAPI_MakeChamfer::GetDist	(	const Standard_Integer	IC,
		Standard_Real &	Dis
	)		const

◆ GetDistAngle()

void BRepFilletAPI_MakeChamfer::GetDistAngle	(	const Standard_Integer	IC,
		Standard_Real &	Dis,
		Standard_Real &	Angle
	)		const

gives the distances <Dis> and <Angle> of the fillet contour of index <IC> in the DS

◆ IsDeleted()

virtual Standard_Boolean BRepFilletAPI_MakeChamfer::IsDeleted ( const TopoDS_Shape & S )

overridevirtual

Returns true if the shape S has been deleted.

Reimplemented from BRepBuilderAPI_MakeShape.

◆ IsDistanceAngle()

Standard_Boolean BRepFilletAPI_MakeChamfer::IsDistanceAngle ( const Standard_Integer IC ) const

return True if chamfer is made with distance and angle false else.

◆ IsSymetric()

Standard_Boolean BRepFilletAPI_MakeChamfer::IsSymetric ( const Standard_Integer IC ) const

return True if chamfer symmetric false else.

◆ IsTwoDistances()

Standard_Boolean BRepFilletAPI_MakeChamfer::IsTwoDistances ( const Standard_Integer IC ) const

return True if chamfer is made with two distances false else.

◆ LastVertex()

TopoDS_Vertex BRepFilletAPI_MakeChamfer::LastVertex ( const Standard_Integer IC ) const

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.

◆ Length()

Standard_Real BRepFilletAPI_MakeChamfer::Length ( const Standard_Integer IC ) const

overridevirtual

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.

◆ Modified()

virtual const TopTools_ListOfShape & BRepFilletAPI_MakeChamfer::Modified ( const TopoDS_Shape & F )

overridevirtual

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

Reimplemented from BRepBuilderAPI_MakeShape.

◆ NbContours()

Standard_Integer BRepFilletAPI_MakeChamfer::NbContours ( ) const

overridevirtual

Returns the number of contours generated using the Add function in the internal data structure of this algorithm.

Implements BRepFilletAPI_LocalOperation.

◆ NbEdges()

Standard_Integer BRepFilletAPI_MakeChamfer::NbEdges ( const Standard_Integer I ) const

overridevirtual

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.

◆ NbSurf()

Standard_Integer BRepFilletAPI_MakeChamfer::NbSurf ( const Standard_Integer IC ) const

overridevirtual

Implements BRepFilletAPI_LocalOperation.

◆ RelativeAbscissa()

Standard_Real BRepFilletAPI_MakeChamfer::RelativeAbscissa	(	const Standard_Integer	IC,
		const TopoDS_Vertex &	V
	)		const

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:

IC is outside the bounds of the table of contours, or
V is not on the contour of index IC.

Implements BRepFilletAPI_LocalOperation.

◆ Remove()

void BRepFilletAPI_MakeChamfer::Remove ( const TopoDS_Edge & E )

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.

◆ Reset()

void BRepFilletAPI_MakeChamfer::Reset ( )

overridevirtual

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.

Implements BRepFilletAPI_LocalOperation.

◆ ResetContour()

void BRepFilletAPI_MakeChamfer::ResetContour ( const Standard_Integer IC )

overridevirtual

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.

Implements BRepFilletAPI_LocalOperation.

◆ Sect()

Handle< ChFiDS_SecHArray1 > BRepFilletAPI_MakeChamfer::Sect	(	const Standard_Integer	IC,
		const Standard_Integer	IS
	)		const

overridevirtual

Implements BRepFilletAPI_LocalOperation.

◆ SetDist()

void BRepFilletAPI_MakeChamfer::SetDist	(	const Standard_Real	Dis,
		const Standard_Integer	IC,
		const TopoDS_Face &	F
	)

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.

◆ SetDistAngle()

void BRepFilletAPI_MakeChamfer::SetDistAngle	(	const Standard_Real	Dis,
		const Standard_Real	Angle,
		const Standard_Integer	IC,
		const TopoDS_Face &	F
	)

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>

◆ SetDists()

void BRepFilletAPI_MakeChamfer::SetDists	(	const Standard_Real	Dis1,
		const Standard_Real	Dis2,
		const Standard_Integer	IC,
		const TopoDS_Face &	F
	)

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.

◆ SetMode()

void BRepFilletAPI_MakeChamfer::SetMode ( const ChFiDS_ChamfMode theMode )

Sets the mode of chamfer.

◆ Simulate()

void BRepFilletAPI_MakeChamfer::Simulate ( const Standard_Integer IC )

overridevirtual

Implements BRepFilletAPI_LocalOperation.

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

BRepFilletAPI_MakeChamfer.hxx

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ BRepFilletAPI_MakeChamfer()

Member Function Documentation

◆ Abscissa()

◆ Add() [1/3]

◆ Add() [2/3]

◆ Add() [3/3]

◆ AddDA()

◆ Build()

◆ Builder()

◆ Closed()

◆ ClosedAndTangent()

◆ Contour()

◆ Dists()

◆ Edge()

◆ FirstVertex()

◆ Generated()

◆ GetDist()

◆ GetDistAngle()

◆ IsDeleted()

◆ IsDistanceAngle()

◆ IsSymetric()

◆ IsTwoDistances()

◆ LastVertex()

◆ Length()

◆ Modified()

◆ NbContours()

◆ NbEdges()

◆ NbSurf()

◆ RelativeAbscissa()

◆ Remove()

◆ Reset()

◆ ResetContour()

◆ Sect()

◆ SetDist()

◆ SetDistAngle()

◆ SetDists()

◆ SetMode()

◆ Simulate()