Open CASCADE Technology
7.5.0

This class provides a data structure necessary for work with the wire as with ordered list of edges, what is required for many algorithms. The advantage of this class is that it allows to work with wires which are not correct. The object of the class ShapeExtend_WireData can be initialized by TopoDS_Wire, and converted back to TopoDS_Wire. An edge in the wire is defined by its rank number. Operations of accessing, adding and removing edge at the given rank number are provided. On the whole wire, operations of circular permutation and reversing (both orientations of all edges and order of edges) are provided as well. This class also provides a method to check if the edge in the wire is a seam (if the wire lies on a face). This class is handled by reference. Such an approach gives the following advantages: More...
#include <ShapeExtend_WireData.hxx>
Public Member Functions  
ShapeExtend_WireData ()  
Empty constructor, creates empty wire with no edges. More...  
ShapeExtend_WireData (const TopoDS_Wire &wire, const Standard_Boolean chained=Standard_True, const Standard_Boolean theManifoldMode=Standard_True)  
Constructor initializing the data from TopoDS_Wire. Calls Init(wire,chained). More...  
void  Init (const Handle< ShapeExtend_WireData > &other) 
Copies data from another WireData. More...  
Standard_Boolean  Init (const TopoDS_Wire &wire, const Standard_Boolean chained=Standard_True, const Standard_Boolean theManifoldMode=Standard_True) 
Loads an already existing wire If <chained> is True (default), edges are added in the sequence as they are explored by TopoDS_Iterator Else, if <chained> is False, wire is explored by BRepTools_WireExplorer and it is guaranteed that edges will be sequencially connected. Remark : In the latter case it can happen that not all edges will be found (because of limitations of BRepTools_WireExplorer for disconnected wires and wires with seam edges). More...  
void  Clear () 
Clears data about Wire. More...  
void  ComputeSeams (const Standard_Boolean enforce=Standard_True) 
Computes the list of seam edges By default (direct call), computing is enforced For indirect call (from IsSeam) it is redone only if not yet already done or if the list of edges has changed Remark : A Seam Edge is an Edge present twice in the list, once as FORWARD and once as REVERSED Each sense has its own PCurve, the one for FORWARD must be set in first. More...  
void  SetLast (const Standard_Integer num) 
Does a circular permutation in order to set <num>th edge last. More...  
void  SetDegeneratedLast () 
When the wire contains at least one degenerated edge, sets it as last one Note : It is useful to process pcurves, for instance, while the pcurve of a DGNR may not be computed from its 3D part (there is none) it is computed after the other edges have been computed and chained. More...  
void  Add (const TopoDS_Edge &edge, const Standard_Integer atnum=0) 
Adds an edge to a wire, being defined (not yet ended) This is the plain, basic, function to add an edge <num> = 0 (D): Appends at end <num> = 1: Preprends at start else, Insert before <num> Remark : Null Edge is simply ignored. More...  
void  Add (const TopoDS_Wire &wire, const Standard_Integer atnum=0) 
Adds an entire wire, considered as a list of edges Remark : The wire is assumed to be ordered (TopoDS_Iterator is used) More...  
void  Add (const Handle< ShapeExtend_WireData > &wire, const Standard_Integer atnum=0) 
Adds a wire in the form of WireData. More...  
void  Add (const TopoDS_Shape &shape, const Standard_Integer atnum=0) 
Adds an edge or a wire invoking corresponding method Add. More...  
void  AddOriented (const TopoDS_Edge &edge, const Standard_Integer mode) 
Adds an edge to start or end of <me>, according to <mode> 0: at end, as direct 1: at end, as reversed 2: at start, as direct 3: at start, as reversed < 0: no adding. More...  
void  AddOriented (const TopoDS_Wire &wire, const Standard_Integer mode) 
Adds a wire to start or end of <me>, according to <mode> 0: at end, as direct 1: at end, as reversed 2: at start, as direct 3: at start, as reversed < 0: no adding. More...  
void  AddOriented (const TopoDS_Shape &shape, const Standard_Integer mode) 
Adds an edge or a wire invoking corresponding method AddOriented. More...  
void  Remove (const Standard_Integer num=0) 
Removes an Edge, given its rank. By default removes the last edge. More...  
void  Set (const TopoDS_Edge &edge, const Standard_Integer num=0) 
Replaces an edge at the given rank number <num> with new one. Default is last edge (<num> = 0). More...  
void  Reverse () 
Reverses the sense of the list and the orientation of each Edge This method should be called when either wire has no seam edges or face is not available. More...  
void  Reverse (const TopoDS_Face &face) 
Reverses the sense of the list and the orientation of each Edge The face is necessary for swapping pcurves for seam edges (first pcurve corresponds to orientation FORWARD, and second to REVERSED; when edge is reversed, pcurves must be swapped) If face is NULL, no swapping is performed. More...  
Standard_Integer  NbEdges () const 
Returns the count of currently recorded edges. More...  
Standard_Integer  NbNonManifoldEdges () const 
Returns the count of currently recorded nonmanifold edges. More...  
TopoDS_Edge  NonmanifoldEdge (const Standard_Integer num) const 
Returns <num>th nonmanifold Edge. More...  
Handle< TopTools_HSequenceOfShape >  NonmanifoldEdges () const 
Returns sequence of nonmanifold edges This sequence can be not empty if wire data set in manifold mode but initial wire has INTERNAL orientation or contains INTERNAL edges. More...  
Standard_Boolean &  ManifoldMode () 
Returns mode defining manifold wire data or not. If manifold that nonmanifold edges will not be not consider during operations(previous behaviour) and they will be added only in result wire else nonmanifold edges will consider during operations. More...  
TopoDS_Edge  Edge (const Standard_Integer num) const 
Returns <num>th Edge. More...  
Standard_Integer  Index (const TopoDS_Edge &edge) 
Returns the index of the edge If the edge is a seam the orientation is also checked Returns 0 if the edge is not found in the list. More...  
Standard_Boolean  IsSeam (const Standard_Integer num) 
Tells if an Edge is seam (see ComputeSeams) An edge is considered as seam if it presents twice in the edge list, once as FORWARD and once as REVERSED. More...  
TopoDS_Wire  Wire () const 
Makes TopoDS_Wire using BRep_Builder (just creates the TopoDS_Wire object and adds all edges into it). This method should be called when the wire is correct (for example, after successful fixes by ShapeFix_Wire) and adjacent edges share common vertices. In case if adjacent edges do not share the same vertices the resulting TopoDS_Wire will be invalid. More...  
TopoDS_Wire  WireAPIMake () const 
Makes TopoDS_Wire using BRepAPI_MakeWire. Class BRepAPI_MakeWire merges geometrically coincided vertices and can disturb correct order of edges in the wire. If this class fails, null shape is returned. More...  
Public Member Functions inherited from Standard_Transient  
Standard_Transient ()  
Empty constructor. More...  
Standard_Transient (const Standard_Transient &)  
Copy constructor – does nothing. More...  
Standard_Transient &  operator= (const Standard_Transient &) 
Assignment operator, needed to avoid copying reference counter. More...  
virtual  ~Standard_Transient () 
Destructor must be virtual. More...  
virtual void  Delete () const 
Memory deallocator for transient classes. More...  
virtual const opencascade::handle< Standard_Type > &  DynamicType () const 
Returns a type descriptor about this object. More...  
Standard_Boolean  IsInstance (const opencascade::handle< Standard_Type > &theType) const 
Returns a true value if this is an instance of Type. More...  
Standard_Boolean  IsInstance (const Standard_CString theTypeName) const 
Returns a true value if this is an instance of TypeName. More...  
Standard_Boolean  IsKind (const opencascade::handle< Standard_Type > &theType) const 
Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...  
Standard_Boolean  IsKind (const Standard_CString theTypeName) const 
Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...  
Standard_Transient *  This () const 
Returns nonconst pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero. More...  
Standard_Integer  GetRefCount () const 
Get the reference counter of this object. More...  
void  IncrementRefCounter () const 
Increments the reference counter of this object. More...  
Standard_Integer  DecrementRefCounter () const 
Decrements the reference counter of this object; returns the decremented value. More...  
Additional Inherited Members  
Public Types inherited from Standard_Transient  
typedef void  base_type 
Returns a type descriptor about this object. More...  
Static Public Member Functions inherited from Standard_Transient  
static const char *  get_type_name () 
Returns a type descriptor about this object. More...  
static const opencascade::handle< Standard_Type > &  get_type_descriptor () 
Returns type descriptor of Standard_Transient class. More...  
This class provides a data structure necessary for work with the wire as with ordered list of edges, what is required for many algorithms. The advantage of this class is that it allows to work with wires which are not correct. The object of the class ShapeExtend_WireData can be initialized by TopoDS_Wire, and converted back to TopoDS_Wire. An edge in the wire is defined by its rank number. Operations of accessing, adding and removing edge at the given rank number are provided. On the whole wire, operations of circular permutation and reversing (both orientations of all edges and order of edges) are provided as well. This class also provides a method to check if the edge in the wire is a seam (if the wire lies on a face). This class is handled by reference. Such an approach gives the following advantages:
ShapeExtend_WireData::ShapeExtend_WireData  (  ) 
Empty constructor, creates empty wire with no edges.
ShapeExtend_WireData::ShapeExtend_WireData  (  const TopoDS_Wire &  wire, 
const Standard_Boolean  chained = Standard_True , 

const Standard_Boolean  theManifoldMode = Standard_True 

) 
Constructor initializing the data from TopoDS_Wire. Calls Init(wire,chained).
void ShapeExtend_WireData::Add  (  const TopoDS_Edge &  edge, 
const Standard_Integer  atnum = 0 

) 
Adds an edge to a wire, being defined (not yet ended) This is the plain, basic, function to add an edge <num> = 0 (D): Appends at end <num> = 1: Preprends at start else, Insert before <num> Remark : Null Edge is simply ignored.
void ShapeExtend_WireData::Add  (  const TopoDS_Wire &  wire, 
const Standard_Integer  atnum = 0 

) 
Adds an entire wire, considered as a list of edges Remark : The wire is assumed to be ordered (TopoDS_Iterator is used)
void ShapeExtend_WireData::Add  (  const Handle< ShapeExtend_WireData > &  wire, 
const Standard_Integer  atnum = 0 

) 
Adds a wire in the form of WireData.
void ShapeExtend_WireData::Add  (  const TopoDS_Shape &  shape, 
const Standard_Integer  atnum = 0 

) 
Adds an edge or a wire invoking corresponding method Add.
void ShapeExtend_WireData::AddOriented  (  const TopoDS_Edge &  edge, 
const Standard_Integer  mode  
) 
Adds an edge to start or end of <me>, according to <mode> 0: at end, as direct 1: at end, as reversed 2: at start, as direct 3: at start, as reversed < 0: no adding.
void ShapeExtend_WireData::AddOriented  (  const TopoDS_Wire &  wire, 
const Standard_Integer  mode  
) 
Adds a wire to start or end of <me>, according to <mode> 0: at end, as direct 1: at end, as reversed 2: at start, as direct 3: at start, as reversed < 0: no adding.
void ShapeExtend_WireData::AddOriented  (  const TopoDS_Shape &  shape, 
const Standard_Integer  mode  
) 
Adds an edge or a wire invoking corresponding method AddOriented.
void ShapeExtend_WireData::Clear  (  ) 
Clears data about Wire.
void ShapeExtend_WireData::ComputeSeams  (  const Standard_Boolean  enforce = Standard_True  ) 
Computes the list of seam edges By default (direct call), computing is enforced For indirect call (from IsSeam) it is redone only if not yet already done or if the list of edges has changed Remark : A Seam Edge is an Edge present twice in the list, once as FORWARD and once as REVERSED Each sense has its own PCurve, the one for FORWARD must be set in first.
TopoDS_Edge ShapeExtend_WireData::Edge  (  const Standard_Integer  num  )  const 
Returns <num>th Edge.
Standard_Integer ShapeExtend_WireData::Index  (  const TopoDS_Edge &  edge  ) 
Returns the index of the edge If the edge is a seam the orientation is also checked Returns 0 if the edge is not found in the list.
void ShapeExtend_WireData::Init  (  const Handle< ShapeExtend_WireData > &  other  ) 
Copies data from another WireData.
Standard_Boolean ShapeExtend_WireData::Init  (  const TopoDS_Wire &  wire, 
const Standard_Boolean  chained = Standard_True , 

const Standard_Boolean  theManifoldMode = Standard_True 

) 
Loads an already existing wire If <chained> is True (default), edges are added in the sequence as they are explored by TopoDS_Iterator Else, if <chained> is False, wire is explored by BRepTools_WireExplorer and it is guaranteed that edges will be sequencially connected. Remark : In the latter case it can happen that not all edges will be found (because of limitations of BRepTools_WireExplorer for disconnected wires and wires with seam edges).
Standard_Boolean ShapeExtend_WireData::IsSeam  (  const Standard_Integer  num  ) 
Tells if an Edge is seam (see ComputeSeams) An edge is considered as seam if it presents twice in the edge list, once as FORWARD and once as REVERSED.
Standard_Boolean& ShapeExtend_WireData::ManifoldMode  (  ) 
Returns mode defining manifold wire data or not. If manifold that nonmanifold edges will not be not consider during operations(previous behaviour) and they will be added only in result wire else nonmanifold edges will consider during operations.
Standard_Integer ShapeExtend_WireData::NbEdges  (  )  const 
Returns the count of currently recorded edges.
Standard_Integer ShapeExtend_WireData::NbNonManifoldEdges  (  )  const 
Returns the count of currently recorded nonmanifold edges.
TopoDS_Edge ShapeExtend_WireData::NonmanifoldEdge  (  const Standard_Integer  num  )  const 
Returns <num>th nonmanifold Edge.
Handle< TopTools_HSequenceOfShape > ShapeExtend_WireData::NonmanifoldEdges  (  )  const 
Returns sequence of nonmanifold edges This sequence can be not empty if wire data set in manifold mode but initial wire has INTERNAL orientation or contains INTERNAL edges.
void ShapeExtend_WireData::Remove  (  const Standard_Integer  num = 0  ) 
Removes an Edge, given its rank. By default removes the last edge.
void ShapeExtend_WireData::Reverse  (  ) 
Reverses the sense of the list and the orientation of each Edge This method should be called when either wire has no seam edges or face is not available.
void ShapeExtend_WireData::Reverse  (  const TopoDS_Face &  face  ) 
Reverses the sense of the list and the orientation of each Edge The face is necessary for swapping pcurves for seam edges (first pcurve corresponds to orientation FORWARD, and second to REVERSED; when edge is reversed, pcurves must be swapped) If face is NULL, no swapping is performed.
void ShapeExtend_WireData::Set  (  const TopoDS_Edge &  edge, 
const Standard_Integer  num = 0 

) 
Replaces an edge at the given rank number <num> with new one. Default is last edge (<num> = 0).
void ShapeExtend_WireData::SetDegeneratedLast  (  ) 
When the wire contains at least one degenerated edge, sets it as last one Note : It is useful to process pcurves, for instance, while the pcurve of a DGNR may not be computed from its 3D part (there is none) it is computed after the other edges have been computed and chained.
void ShapeExtend_WireData::SetLast  (  const Standard_Integer  num  ) 
Does a circular permutation in order to set <num>th edge last.
TopoDS_Wire ShapeExtend_WireData::Wire  (  )  const 
Makes TopoDS_Wire using BRep_Builder (just creates the TopoDS_Wire object and adds all edges into it). This method should be called when the wire is correct (for example, after successful fixes by ShapeFix_Wire) and adjacent edges share common vertices. In case if adjacent edges do not share the same vertices the resulting TopoDS_Wire will be invalid.
TopoDS_Wire ShapeExtend_WireData::WireAPIMake  (  )  const 
Makes TopoDS_Wire using BRepAPI_MakeWire. Class BRepAPI_MakeWire merges geometrically coincided vertices and can disturb correct order of edges in the wire. If this class fails, null shape is returned.