1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
|
// This file is generated by WOK (CPPExt).
// Please do not edit this file; modify original file instead.
// The copyright and license terms as defined for the original file apply to
// this header file considered to be the "object code" form of the original source.
#ifndef _ShapeExtend_WireData_HeaderFile
#define _ShapeExtend_WireData_HeaderFile
#ifndef _Standard_HeaderFile
#include <Standard.hxx>
#endif
#ifndef _Standard_DefineHandle_HeaderFile
#include <Standard_DefineHandle.hxx>
#endif
#ifndef _Handle_ShapeExtend_WireData_HeaderFile
#include <Handle_ShapeExtend_WireData.hxx>
#endif
#ifndef _Handle_TopTools_HSequenceOfShape_HeaderFile
#include <Handle_TopTools_HSequenceOfShape.hxx>
#endif
#ifndef _Handle_TColStd_HSequenceOfInteger_HeaderFile
#include <Handle_TColStd_HSequenceOfInteger.hxx>
#endif
#ifndef _Standard_Integer_HeaderFile
#include <Standard_Integer.hxx>
#endif
#ifndef _Standard_Boolean_HeaderFile
#include <Standard_Boolean.hxx>
#endif
#ifndef _MMgt_TShared_HeaderFile
#include <MMgt_TShared.hxx>
#endif
class TopTools_HSequenceOfShape;
class TColStd_HSequenceOfInteger;
class TopoDS_Wire;
class TopoDS_Edge;
class TopoDS_Shape;
class TopoDS_Face;
//! This class provides a data structure necessary for work with the wire as with <br>
//! ordered list of edges, what is required for many algorithms. The advantage of <br>
//! this class is that it allows to work with wires which are not correct. <br>
//! The object of the class ShapeExtend_WireData can be initialized by <br>
//! TopoDS_Wire, and converted back to TopoDS_Wire. <br>
//! An edge in the wire is defined by its rank number. Operations of accessing, <br>
//! adding and removing edge at the given rank number are provided. On the whole <br>
//! wire, operations of circular permutation and reversing (both orientations of <br>
//! all edges and order of edges) are provided as well. <br>
//! This class also provides a method to check if the edge in the wire is a seam <br>
//! (if the wire lies on a face). <br>
//! This class is handled by reference. Such an approach gives the following advantages: <br>
//! 1. Sharing the object of this class strongly optimizes the processes of <br>
//! analysis and fixing performed in parallel on the wire stored in the form <br>
//! of this class. Fixing tool (e.g. ShapeFix_Wire) fixes problems one by <br>
//! one using analyzing tool (e.g. ShapeAnalysis_Wire). Sharing allows not <br>
//! to reinitialize each time the analyzing tool with modified <br>
//! ShapeExtend_WireData what consumes certain time. <br>
//! 2. No copying of contents. The object of ShapeExtend_WireData class has <br>
//! quite big size, returning it as a result of the function would cause <br>
//! additional copying of contents if this class were one handled by value. <br>
//! Moreover, this class is stored as a field in other classes which are <br>
//! they returned as results of functions, storing only a handle to <br>
//! ShapeExtend_WireData saves time and memory. <br>
class ShapeExtend_WireData : public MMgt_TShared {
public:
//! Empty constructor, creates empty wire with no edges <br>
Standard_EXPORT ShapeExtend_WireData();
//! Constructor initializing the data from TopoDS_Wire. Calls Init(wire,chained). <br>
Standard_EXPORT ShapeExtend_WireData(const TopoDS_Wire& wire,const Standard_Boolean chained = Standard_True,const Standard_Boolean theManifoldMode = Standard_True);
//! Copies data from another WireData <br>
Standard_EXPORT void Init(const Handle(ShapeExtend_WireData)& other) ;
//! Loads an already existing wire <br>
//! If <chained> is True (default), edges are added in the <br>
//! sequence as they are explored by TopoDS_Iterator <br>
//! Else, if <chained> is False, wire is explored by <br>
//! BRepTools_WireExplorer and it is guaranteed that edges will <br>
//! be sequencially connected. <br>
//! Remark : In the latter case it can happen that not all edges <br>
//! will be found (because of limitations of <br>
//! BRepTools_WireExplorer for disconnected wires and wires <br>
//! with seam edges). <br>
Standard_EXPORT Standard_Boolean Init(const TopoDS_Wire& wire,const Standard_Boolean chained = Standard_True,const Standard_Boolean theManifoldMode = Standard_True) ;
//! Clears data about Wire. <br>
Standard_EXPORT void Clear() ;
//! Computes the list of seam edges <br>
//! By default (direct call), computing is enforced <br>
//! For indirect call (from IsSeam) it is redone only if not yet <br>
//! already done or if the list of edges has changed <br>
//! Remark : A Seam Edge is an Edge present twice in the list, once as <br>
//! FORWARD and once as REVERSED <br>
//! Each sense has its own PCurve, the one for FORWARD <br>
//! must be set in first <br>
Standard_EXPORT void ComputeSeams(const Standard_Boolean enforce = Standard_True) ;
//! Does a circular permutation in order to set <num>th edge last <br>
Standard_EXPORT void SetLast(const Standard_Integer num) ;
//! When the wire contains at least one degenerated edge, sets it <br>
//! as last one <br>
//! Note : It is useful to process pcurves, for instance, while the pcurve <br>
//! of a DGNR may not be computed from its 3D part (there is none) <br>
//! it is computed after the other edges have been computed and <br>
//! chained. <br>
Standard_EXPORT void SetDegeneratedLast() ;
//! Adds an edge to a wire, being defined (not yet ended) <br>
//! This is the plain, basic, function to add an edge <br>
//! <num> = 0 (D): Appends at end <br>
//! <num> = 1: Preprends at start <br>
//! else, Insert before <num> <br>
//! Remark : Null Edge is simply ignored <br>
Standard_EXPORT void Add(const TopoDS_Edge& edge,const Standard_Integer atnum = 0) ;
//! Adds an entire wire, considered as a list of edges <br>
//! Remark : The wire is assumed to be ordered (TopoDS_Iterator <br>
//! is used) <br>
Standard_EXPORT void Add(const TopoDS_Wire& wire,const Standard_Integer atnum = 0) ;
//! Adds a wire in the form of WireData <br>
Standard_EXPORT void Add(const Handle(ShapeExtend_WireData)& wire,const Standard_Integer atnum = 0) ;
//! Adds an edge or a wire invoking corresponding method Add <br>
Standard_EXPORT void Add(const TopoDS_Shape& shape,const Standard_Integer atnum = 0) ;
//! Adds an edge to start or end of <me>, according to <mode> <br>
//! 0: at end, as direct <br>
//! 1: at end, as reversed <br>
//! 2: at start, as direct <br>
//! 3: at start, as reversed <br>
//! < 0: no adding <br>
Standard_EXPORT void AddOriented(const TopoDS_Edge& edge,const Standard_Integer mode) ;
//! Adds a wire to start or end of <me>, according to <mode> <br>
//! 0: at end, as direct <br>
//! 1: at end, as reversed <br>
//! 2: at start, as direct <br>
//! 3: at start, as reversed <br>
//! < 0: no adding <br>
Standard_EXPORT void AddOriented(const TopoDS_Wire& wire,const Standard_Integer mode) ;
//! Adds an edge or a wire invoking corresponding method <br>
//! AddOriented <br>
Standard_EXPORT void AddOriented(const TopoDS_Shape& shape,const Standard_Integer mode) ;
//! Removes an Edge, given its rank. By default removes the last edge. <br>
Standard_EXPORT void Remove(const Standard_Integer num = 0) ;
//! Replaces an edge at the given <br>
//! rank number <num> with new one. Default is last edge (<num> = 0). <br>
Standard_EXPORT void Set(const TopoDS_Edge& edge,const Standard_Integer num = 0) ;
//! Reverses the sense of the list and the orientation of each Edge <br>
//! This method should be called when either wire has no seam edges <br>
//! or face is not available <br>
Standard_EXPORT void Reverse() ;
//! Reverses the sense of the list and the orientation of each Edge <br>
//! The face is necessary for swapping pcurves for seam edges <br>
//! (first pcurve corresponds to orientation FORWARD, and second to <br>
//! REVERSED; when edge is reversed, pcurves must be swapped) <br>
//! If face is NULL, no swapping is performed <br>
Standard_EXPORT void Reverse(const TopoDS_Face& face) ;
//! Returns the count of currently recorded edges <br>
Standard_EXPORT Standard_Integer NbEdges() const;
//! Returns the count of currently recorded non-manifold edges <br>
Standard_EXPORT Standard_Integer NbNonManifoldEdges() const;
//! Returns <num>th nonmanifold Edge <br>
Standard_EXPORT TopoDS_Edge NonmanifoldEdge(const Standard_Integer num) const;
//! Returns sequence of non-manifold edges <br>
//! This sequence can be not empty if wire data set in manifold mode but <br>
//! initial wire has INTERNAL orientation or contains INTERNAL edges <br>
Standard_EXPORT Handle_TopTools_HSequenceOfShape NonmanifoldEdges() const;
//! Returns mode defining manifold wire data or not. <br>
//! If manifold that nonmanifold edges will not be not <br>
//! consider during operations(previous behaviour) <br>
//! and they will be added only in result wire <br>
//! else non-manifold edges will consider during operations <br>
Standard_EXPORT Standard_Boolean& ManifoldMode() ;
//! Returns <num>th Edge <br>
Standard_EXPORT TopoDS_Edge Edge(const Standard_Integer num) const;
//! Returns the index of the edge <br>
//! If the edge is a seam the orientation is also checked <br>
//! Returns 0 if the edge is not found in the list <br>
Standard_EXPORT Standard_Integer Index(const TopoDS_Edge& edge) ;
//! Tells if an Edge is seam (see ComputeSeams) <br>
//! An edge is considered as seam if it presents twice in <br>
//! the edge list, once as FORWARD and once as REVERSED. <br>
Standard_EXPORT Standard_Boolean IsSeam(const Standard_Integer num) ;
//! Makes TopoDS_Wire using <br>
//! BRep_Builder (just creates the TopoDS_Wire object and adds <br>
//! all edges into it). This method should be called when <br>
//! the wire is correct (for example, after successful <br>
//! fixes by ShapeFix_Wire) and adjacent edges share common <br>
//! vertices. In case if adjacent edges do not share the same <br>
//! vertices the resulting TopoDS_Wire will be invalid. <br>
Standard_EXPORT TopoDS_Wire Wire() const;
//! Makes TopoDS_Wire using <br>
//! BRepAPI_MakeWire. Class BRepAPI_MakeWire merges <br>
//! geometrically coincided vertices and can disturb <br>
//! correct order of edges in the wire. If this class fails, <br>
//! null shape is returned. <br>
Standard_EXPORT TopoDS_Wire WireAPIMake() const;
DEFINE_STANDARD_RTTI(ShapeExtend_WireData)
protected:
private:
Handle_TopTools_HSequenceOfShape myEdges;
Handle_TopTools_HSequenceOfShape myNonmanifoldEdges;
Handle_TColStd_HSequenceOfInteger mySeams;
Standard_Integer mySeamF;
Standard_Integer mySeamR;
Standard_Boolean myManifoldMode;
};
// other Inline functions and methods (like "C++: function call" methods)
#endif
|
