Open CASCADE Technology
7.3.0

Taperadding 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>
Public Member Functions  
BRepOffsetAPI_DraftAngle ()  
Constructs an empty algorithm to perform taperadding 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 taperadding 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 taperadding transformations 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 taperadding algorithm with the shape S. 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 Direction, the angle Angle, the plane NeutralPlane, and the flag Flag to the framework created at construction time, and with this data, defines the taperadding 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 taperadding 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 taperadding transformation previously performed by this algorithm on the face F and the series of tangential faces which contain F, and retrieves the shape before the last taperadding 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 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 nonempty 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 together with the face <F>. More...  
const TopTools_ListOfShape &  ModifiedFaces () const 
Returns all the faces on which a modification has been given. More...  
virtual void  Build () override 
Builds the resulting shape (redefined from MakeShape). More...  
void  CorrectWires () 
virtual const TopTools_ListOfShape &  Generated (const TopoDS_Shape &S) override 
Returns the list of shapes generated from the shape <S>. More...  
virtual const TopTools_ListOfShape &  Modified (const TopoDS_Shape &S) override 
Returns the list of shapes modified from the shape <S>. More...  
virtual TopoDS_Shape  ModifiedShape (const TopoDS_Shape &S) const override 
Returns the modified shape corresponding to <S>. S can correspond to the entire initial shape or to its subshape. Raises exceptions Standard_NoSuchObject if S is not the initial shape or a subshape of the initial shape to which the transformation has been applied. More...  
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. More...  
operator TopoDS_Shape ()  
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 
Taperadding 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:
BRepOffsetAPI_DraftAngle::BRepOffsetAPI_DraftAngle  (  ) 
Constructs an empty algorithm to perform taperadding 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 taperadding transformations on faces of the shape S. S will be referred to as the initial shape of the algorithm.
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 Direction, the angle Angle, the plane NeutralPlane, and the flag Flag to the framework created at construction time, and with this data, defines the taperadding 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:
Standard_Boolean BRepOffsetAPI_DraftAngle::AddDone  (  )  const 
Returns true if the previous taperadding transformation performed by this algorithm in the last call to Add, was successful. If AddDone returns false:

overridevirtual 
Builds the resulting shape (redefined from MakeShape).
Reimplemented from BRepBuilderAPI_MakeShape.
void BRepOffsetAPI_DraftAngle::Clear  (  ) 
Cancels the results of all taperadding transformations 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 together with the face <F>.
void BRepOffsetAPI_DraftAngle::CorrectWires  (  ) 

overridevirtual 
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 taperadding algorithm with the shape S. S will be referred to as the initial shape of this algorithm.

overridevirtual 
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 been given.

overridevirtual 
Returns the modified shape corresponding to <S>. S can correspond to the entire initial shape or to its subshape. Raises exceptions Standard_NoSuchObject if S is not the initial shape or a subshape of the initial shape to which the transformation has been applied.
Reimplemented from BRepBuilderAPI_ModifyShape.
const TopoDS_Shape& BRepOffsetAPI_DraftAngle::ProblematicShape  (  )  const 
Returns the shape on which an error occurred after an 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 nonempty constructor or the Init function.
void BRepOffsetAPI_DraftAngle::Remove  (  const TopoDS_Face &  F  ) 
Cancels the taperadding transformation previously performed by this algorithm on the face F and the series of tangential faces which contain F, and retrieves the shape before the last taperadding transformation. Warning You will have to use this function if the previous call to Add fails. Use the function AddDone to check it. Exceptions.
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.