BRepOffsetAPI_DraftAngle Class Reference

Taper-adding transformations on a shape.
The resulting shape is constructed by defining one face
to be tapered after another one, as well as the
geometric properties of their tapered transformation.
Each tapered transformation is propagated along the
series of faces which are tangential to one another and
which contains the face to be tapered.
This algorithm is useful in the construction of molds or
dies. It facilitates the removal of the article being produced.
A DraftAngle object provides a framework for:
More...

#include <BRepOffsetAPI_DraftAngle.hxx>

Inheritance diagram for BRepOffsetAPI_DraftAngle:

Public Member Functions
	BRepOffsetAPI_DraftAngle ()
	Constructs an empty algorithm to perform <br> taper-adding transformations on faces of a shape. Use the Init function to define the shape to be tapered. More...
	BRepOffsetAPI_DraftAngle (const TopoDS_Shape &S)
	Initializes an algorithm to perform taper-adding <br> transformations on faces of the shape S. S will be referred to as the initial shape of the algorithm. More...
void	Clear ()
	Cancels the results of all taper-adding transformations <br> performed by this algorithm on the initial shape. These results will have been defined by successive calls to the function Add. More...
void	Init (const TopoDS_Shape &S)
	Initializes, or reinitializes this taper-adding algorithm with the shape S. <br> S will be referred to as the initial shape of this algorithm. More...
void	Add (const TopoDS_Face &F, const gp_Dir &Direction, const Standard_Real Angle, const gp_Pln &NeutralPlane, const Standard_Boolean Flag=Standard_True)
	Adds the face F, the direction <br> Direction, the angle Angle, the plane NeutralPlane, and the flag Flag to the framework created at construction time, and with this data, defines the taper-adding transformation. F is a face, which belongs to the initial shape of this algorithm or to the shape loaded by the function Init. Only planar, cylindrical or conical faces can be tapered: More...
Standard_Boolean	AddDone () const
	Returns true if the previous taper-adding <br> transformation performed by this algorithm in the last call to Add, was successful. If AddDone returns false: More...
void	Remove (const TopoDS_Face &F)
	Cancels the taper-adding transformation previously <br> performed by this algorithm on the face F and the series of tangential faces which contain F, and retrieves the shape before the last taper-adding transformation. Warning You will have to use this function if the previous call to Add fails. Use the function AddDone to check it. Exceptions More...
const TopoDS_Shape &	ProblematicShape () const
	Returns the shape on which an error occurred after an <br> unsuccessful call to Add or when IsDone returns false. Exceptions Standard_NullObject if the initial shape has not been defined, i.e. if this algorithm has not been initialized with the non-empty constructor or the Init function. More...
Draft_ErrorStatus	Status () const
	Returns an error status when an error has occured (Face, Edge or Vertex recomputaion problem). Otherwise returns Draft_NoError. The method may be called if AddDone returns Standard_False, or when IsDone returns Standard_False. More...
const TopTools_ListOfShape &	ConnectedFaces (const TopoDS_Face &F) const
	Returns all the faces which have been added <br> together with the face <F>. <br> More...
const TopTools_ListOfShape &	ModifiedFaces () const
	Returns all the faces on which a modification has <br> been given. <br> More...
virtual void	Build ()
	Builds the resulting shape (redefined from MakeShape). More...
void	CorrectWires ()
virtual const TopTools_ListOfShape &	Generated (const TopoDS_Shape &S)
	Returns the list of shapes generated from the shape <S>. More...
virtual const TopTools_ListOfShape &	Modified (const TopoDS_Shape &S)
	Returns the list of shapes modified from the shape <S>. More...
Public Member Functions inherited from BRepBuilderAPI_ModifyShape
virtual const TopoDS_Shape &	ModifiedShape (const TopoDS_Shape &S) const
	Returns the modified shape corresponding to <S>. <br> S can correspond to the entire initial shape or to its subshape. Exceptions Standard_NoSuchObject if S is not the initial shape or a subshape of the initial shape to which the transformation has been applied. Raises NoSuchObject from Standard if S is not the initial shape or a sub-shape of the initial shape. More...
Public Member Functions inherited from BRepBuilderAPI_MakeShape
virtual void	Delete ()
virtual	~BRepBuilderAPI_MakeShape ()
const TopoDS_Shape &	Shape () const
	Returns a shape built by the shape construction algorithm. <br> Raises exception StdFail_NotDone if the shape was not built. More...
	operator TopoDS_Shape () const
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_ModifyShape
	BRepBuilderAPI_ModifyShape ()
	Empty constructor. More...
	BRepBuilderAPI_ModifyShape (const TopoDS_Shape &S)
	Initializes the modifier with the Shape <S>, and set the field <myInitialShape> to <S>. More...
	BRepBuilderAPI_ModifyShape (const Handle< BRepTools_Modification > &M)
	Set the field <myModification> with <M>. More...
	BRepBuilderAPI_ModifyShape (const TopoDS_Shape &S, const Handle< BRepTools_Modification > &M)
	Initializes the modifier with the Shape <S>, and set the field <myInitialShape> to <S>, and set the field <myModification> with <M>, the performs the modification. More...
void	DoModif (const TopoDS_Shape &S)
	Performs the previously given modification on the shape <S>. More...
void	DoModif (const Handle< BRepTools_Modification > &M)
	Performs the modification <M> on a previously given shape. More...
void	DoModif (const TopoDS_Shape &S, const Handle< BRepTools_Modification > &M)
	Performs the modification <M> on the shape <S>. More...
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_ModifyShape
BRepTools_Modifier	myModifier
TopoDS_Shape	myInitialShape
Handle_BRepTools_Modification	myModification
Protected Attributes inherited from BRepBuilderAPI_MakeShape
TopoDS_Shape	myShape
TopTools_ListOfShape	myGenerated

Detailed Description

Taper-adding transformations on a shape.
The resulting shape is constructed by defining one face
to be tapered after another one, as well as the
geometric properties of their tapered transformation.
Each tapered transformation is propagated along the
series of faces which are tangential to one another and
which contains the face to be tapered.
This algorithm is useful in the construction of molds or
dies. It facilitates the removal of the article being produced.
A DraftAngle object provides a framework for:

• initializing the construction algorithm with a given shape,
  
• acquiring the data characterizing the faces to be tapered,
  
• implementing the construction algorithm, and
  
• consulting the results.
  Warning
  
• This algorithm treats planar, cylindrical and conical faces.
  
• Do not use shapes, which with a draft angle added to
  a face would modify the topology. This would, for
  example, involve creation of new vertices, edges or
  faces, or suppression of existing vertices, edges or faces.
  
• Any face, which is continuous in tangency with the
  face to be tapered, will also be tapered. These
  connected faces must also respect the above criteria.
  

Constructor & Destructor Documentation

BRepOffsetAPI_DraftAngle::BRepOffsetAPI_DraftAngle

(

)

 Constructs an empty algorithm to perform <br>

taper-adding transformations on faces of a shape.
Use the Init function to define the shape to be tapered.

BRepOffsetAPI_DraftAngle::BRepOffsetAPI_DraftAngle

(

const TopoDS_Shape &

S

)

 Initializes an algorithm to perform taper-adding <br>

transformations on faces of the shape S.
S will be referred to as the initial shape of the algorithm.

Member Function Documentation

void BRepOffsetAPI_DraftAngle::Add	(	const TopoDS_Face &	F,
		const gp_Dir &	Direction,
		const Standard_Real	Angle,
		const gp_Pln &	NeutralPlane,
		const Standard_Boolean	Flag = Standard_True
	)

  Adds the face F, the direction <br>

Direction, the angle Angle, the plane NeutralPlane, and the flag
Flag to the framework created at construction time, and with this
data, defines the taper-adding transformation.
F is a face, which belongs to the initial shape of this algorithm or
to the shape loaded by the function Init.
Only planar, cylindrical or conical faces can be tapered:

• If the face F is planar, it is tapered by inclining it
  through the angle Angle about the line of intersection between the
  plane NeutralPlane and F.
  Direction indicates the side of NeutralPlane from which matter is
  removed if Angle is positive or added if Angle is negative.
  
• If F is cylindrical or conical, it is transformed in the
  same way on a single face, resulting in a conical face if F
  is cylindrical, and a conical or cylindrical face if it is already conical.
  The taper-adding transformation is propagated from the face F along
  the series of planar, cylindrical or conical faces containing F,
  which are tangential to one another.
  Use the function AddDone to check if this taper-adding transformation is successful.
  Warning
  Nothing is done if:
  
• the face F does not belong to the initial shape of this algorithm, or
  
• the face F is not planar, cylindrical or conical.
  Exceptions
  
• Standard_NullObject if the initial shape is not
  defined, i.e. if this algorithm has not been initialized
  with the non-empty constructor or the Init function.
  
• Standard_ConstructionError if the previous call to
  Add has failed. The function AddDone ought to have
  been used to check for this, and the function Remove
  to cancel the results of the unsuccessful taper-adding
  transformation and to retrieve the previous shape.
  

Standard_Boolean BRepOffsetAPI_DraftAngle::AddDone

(

)

const

 Returns true if the previous taper-adding <br>

transformation performed by this algorithm in the last
call to Add, was successful.
If AddDone returns false:

• the function ProblematicShape returns the face
  on which the error occurred,
  
• the function Remove has to be used to cancel the
  results of the unsuccessful taper-adding
  transformation and to retrieve the previous shape.
  Exceptions
  Standard_NullObject if the initial shape has not
  been defined, i.e. if this algorithm has not been
  initialized with the non-empty constructor or the .Init function.
  

virtual void BRepOffsetAPI_DraftAngle::Build ( )

virtual

Builds the resulting shape (redefined from MakeShape).

Reimplemented from BRepBuilderAPI_MakeShape.

void BRepOffsetAPI_DraftAngle::Clear

(

)

 Cancels the results of all taper-adding transformations <br>

performed by this algorithm on the initial shape. These
results will have been defined by successive calls to the function Add.

const TopTools_ListOfShape& BRepOffsetAPI_DraftAngle::ConnectedFaces

(

const TopoDS_Face &

F

)

const

 Returns all  the  faces   which  have been   added <br>
     together with the face <F>. <br>

void BRepOffsetAPI_DraftAngle::CorrectWires

(

)

virtual const TopTools_ListOfShape& BRepOffsetAPI_DraftAngle::Generated ( const TopoDS_Shape &  S )

virtual

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

Reimplemented from BRepBuilderAPI_MakeShape.

void BRepOffsetAPI_DraftAngle::Init

(

const TopoDS_Shape &

S

)

 Initializes, or reinitializes this taper-adding algorithm with the shape S. <br>

S will be referred to as the initial shape of this algorithm.

virtual const TopTools_ListOfShape& BRepOffsetAPI_DraftAngle::Modified ( const TopoDS_Shape &  S )

virtual

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

Reimplemented from BRepBuilderAPI_ModifyShape.

const TopTools_ListOfShape& BRepOffsetAPI_DraftAngle::ModifiedFaces

(

)

const

 Returns all the faces  on which a modification has <br>
     been given. <br>

const TopoDS_Shape& BRepOffsetAPI_DraftAngle::ProblematicShape

(

)

const

 Returns the shape on which an error occurred after an <br>

unsuccessful call to Add or when IsDone returns false.
Exceptions
Standard_NullObject if the initial shape has not been
defined, i.e. if this algorithm has not been initialized with
the non-empty constructor or the Init function.

void BRepOffsetAPI_DraftAngle::Remove

(

const TopoDS_Face &

F

)

 Cancels the taper-adding transformation previously <br>

performed by this algorithm on the face F and the
series of tangential faces which contain F, and retrieves
the shape before the last taper-adding transformation.
Warning
You will have to use this function if the previous call to
Add fails. Use the function AddDone to check it.
Exceptions

• Standard_NullObject if the initial shape has not
  been defined, i.e. if this algorithm has not been
  initialized with the non-empty constructor or the Init function.
  
• Standard_NoSuchObject if F has not been added
  or has already been removed.
  

Draft_ErrorStatus BRepOffsetAPI_DraftAngle::Status

(

)

const

Returns an error status when an error has occured
(Face, Edge or Vertex recomputaion problem).
Otherwise returns Draft_NoError. The method may be
called if AddDone returns Standard_False, or when
IsDone returns Standard_False.

---

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

• BRepOffsetAPI_DraftAngle.hxx