CirculatorsT.hh 91.3 KB
Newer Older
Jan Möbius's avatar
Jan Möbius committed
1
2
3
/*===========================================================================*\
 *                                                                           *
 *                               OpenMesh                                    *
Jan Möbius's avatar
Jan Möbius committed
4
 *      Copyright (C) 2001-2012 by Computer Graphics Group, RWTH Aachen      *
Jan Möbius's avatar
Jan Möbius committed
5
6
7
 *                           www.openmesh.org                                *
 *                                                                           *
 *---------------------------------------------------------------------------* 
8
 *  This file is part of OpenMesh.                                           *
Jan Möbius's avatar
Jan Möbius committed
9
 *                                                                           *
10
11
12
13
14
 *  OpenMesh is free software: you can redistribute it and/or modify         * 
 *  it under the terms of the GNU Lesser General Public License as           *
 *  published by the Free Software Foundation, either version 3 of           *
 *  the License, or (at your option) any later version with the              *
 *  following exceptions:                                                    *
Jan Möbius's avatar
Jan Möbius committed
15
 *                                                                           *
16
17
18
19
20
21
22
 *  If other files instantiate templates or use macros                       *
 *  or inline functions from this file, or you compile this file and         *
 *  link it with other files to produce an executable, this file does        *
 *  not by itself cause the resulting executable to be covered by the        *
 *  GNU Lesser General Public License. This exception does not however       *
 *  invalidate any other reasons why the executable file might be            *
 *  covered by the GNU Lesser General Public License.                        *
Jan Möbius's avatar
Jan Möbius committed
23
 *                                                                           *
24
25
26
27
 *  OpenMesh is distributed in the hope that it will be useful,              *
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of           *
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the            *
 *  GNU Lesser General Public License for more details.                      *
Jan Möbius's avatar
Jan Möbius committed
28
 *                                                                           *
29
30
31
32
33
34
35
36
37
38
 *  You should have received a copy of the GNU LesserGeneral Public          *
 *  License along with OpenMesh.  If not,                                    *
 *  see <http://www.gnu.org/licenses/>.                                      *
 *                                                                           *
\*===========================================================================*/ 

/*===========================================================================*\
 *                                                                           *             
 *   $Revision$                                                         *
 *   $Date$                   *
Jan Möbius's avatar
Jan Möbius committed
39
40
 *                                                                           *
\*===========================================================================*/
41

Jan Möbius's avatar
Jan Möbius committed
42
43
44
45
46
47
48
49
50
51
52
53
54
#ifndef OPENMESH_CIRCULATORS_HH
#define OPENMESH_CIRCULATORS_HH
//=============================================================================
//
//  Vertex and Face circulators for PolyMesh/TriMesh
//
//=============================================================================



//== INCLUDES =================================================================

#include <OpenMesh/Core/System/config.h>
55
#include <cassert>
56
#include <cstddef>
Jan Möbius's avatar
Jan Möbius committed
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


//== NAMESPACES ===============================================================

namespace OpenMesh {
namespace Iterators {


//== FORWARD DECLARATIONS =====================================================


template <class Mesh> class VertexVertexIterT;
template <class Mesh> class VertexIHalfedgeIterT;
template <class Mesh> class VertexOHalfedgeIterT;
template <class Mesh> class VertexEdgeIterT;
template <class Mesh> class VertexFaceIterT;

template <class Mesh> class ConstVertexVertexIterT;
template <class Mesh> class ConstVertexIHalfedgeIterT;
template <class Mesh> class ConstVertexOHalfedgeIterT;
template <class Mesh> class ConstVertexEdgeIterT;
template <class Mesh> class ConstVertexFaceIterT;

template <class Mesh> class FaceVertexIterT;
template <class Mesh> class FaceHalfedgeIterT;
template <class Mesh> class FaceEdgeIterT;
template <class Mesh> class FaceFaceIterT;

template <class Mesh> class ConstFaceVertexIterT;
template <class Mesh> class ConstFaceHalfedgeIterT;
template <class Mesh> class ConstFaceEdgeIterT;
template <class Mesh> class ConstFaceFaceIterT;



//== CLASS DEFINITION =========================================================

	      
/** \class VertexVertexIterT CirculatorsT.hh <OpenMesh/Mesh/Iterators/CirculatorsT.hh>
    Circulator.
*/

template <class Mesh>
class VertexVertexIterT
{
 public:


  //--- Typedefs ---

107
  typedef typename Mesh::HalfedgeHandle     HalfedgeHandle;
Jan Möbius's avatar
Jan Möbius committed
108

109
  typedef typename Mesh::Vertex             value_type;
110
  typedef typename Mesh::VertexHandle       value_handle;
Jan Möbius's avatar
Jan Möbius committed
111
112

#if 0
113
  typedef std::bidirectional_iterator_tag   iterator_category;
114
  typedef std::ptrdiff_t                    difference_type;
115
116
117
118
  typedef const Mesh&                       mesh_ref;
  typedef const Mesh*                       mesh_ptr;
  typedef const typename Mesh::Vertex&      reference;
  typedef const typename Mesh::Vertex*      pointer;
Jan Möbius's avatar
Jan Möbius committed
119
#else
120
  typedef std::bidirectional_iterator_tag   iterator_category;
121
  typedef std::ptrdiff_t                    difference_type;
122
123
124
125
  typedef Mesh&                             mesh_ref;
  typedef Mesh*                             mesh_ptr;
  typedef typename Mesh::Vertex&            reference;
  typedef typename Mesh::Vertex*            pointer;
Jan Möbius's avatar
Jan Möbius committed
126
127
128
129
130
#endif



  /// Default constructor
131
  VertexVertexIterT() : mesh_(0), lap_counter_(0) {}
Jan Möbius's avatar
Jan Möbius committed
132
133
134


  /// Construct with mesh and a typename Mesh::VertexHandle
135
  VertexVertexIterT(mesh_ref _mesh, typename Mesh::VertexHandle _start, bool _end = false) :
Jan Möbius's avatar
Jan Möbius committed
136
137
138
    mesh_(&_mesh), 
    start_(_mesh.halfedge_handle(_start)),
    heh_(start_),
139
    lap_counter_(_end)
Jan Möbius's avatar
Jan Möbius committed
140
141
142
143
  {  ; }


  /// Construct with mesh and start halfedge
144
  VertexVertexIterT(mesh_ref _mesh, HalfedgeHandle _heh, bool _end = false) :
Jan Möbius's avatar
Jan Möbius committed
145
146
147
    mesh_(&_mesh),
    start_(_heh),
    heh_(_heh),
148
    lap_counter_(_end)
Jan Möbius's avatar
Jan Möbius committed
149
150
151
152
153
154
155
156
  {  ; }


  /// Copy constructor
  VertexVertexIterT(const VertexVertexIterT& _rhs) :
    mesh_(_rhs.mesh_),
    start_(_rhs.start_),
    heh_(_rhs.heh_),
157
    lap_counter_(_rhs.lap_counter_)
Jan Möbius's avatar
Jan Möbius committed
158
159
160
161
162
163
164
165
166
  {  ; }


  /// Assignment operator
  VertexVertexIterT& operator=(const VertexVertexIterT<Mesh>& _rhs)
  {
    mesh_   = _rhs.mesh_;
    start_  = _rhs.start_;
    heh_    = _rhs.heh_;
167
    lap_counter_ = _rhs.lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
168
169
170
171
172
173
174
175
176
177
    return *this;
  }


#if 0
  /// construct from non-const circulator type
  VertexVertexIterT(const VertexVertexIterT<Mesh>& _rhs) :
    mesh_(_rhs.mesh_),
    start_(_rhs.start_),
    heh_(_rhs.heh_),
178
    lap_counter_(_rhs.lap_counter_)
Jan Möbius's avatar
Jan Möbius committed
179
180
181
182
183
184
185
186
187
  {  ; }


  /// assign from non-const circulator
  VertexVertexIterT& operator=(const VertexVertexIterT<Mesh>& _rhs)
  {
    mesh_   = _rhs.mesh_;
    start_  = _rhs.start_;
    heh_    = _rhs.heh_;
188
    lap_counter_ = _rhs.lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
189
190
191
192
193
194
195
196
197
198
199
200
    return *this;
  }
#else
  friend class ConstVertexVertexIterT<Mesh>;
#endif  


  /// Equal ?
  bool operator==(const VertexVertexIterT& _rhs) const {
    return ((mesh_   == _rhs.mesh_) &&
	    (start_  == _rhs.start_) &&
	    (heh_    == _rhs.heh_) &&
201
	    (lap_counter_ == _rhs.lap_counter_));
Jan Möbius's avatar
Jan Möbius committed
202
203
204
205
206
207
208
209
210
211
212
213
  }


  /// Not equal ?
  bool operator!=(const VertexVertexIterT& _rhs) const {
    return !operator==(_rhs);
  }


  /// Pre-Increment (next cw target)
  VertexVertexIterT& operator++() { 
    assert(mesh_);
214
215
    heh_=mesh_->cw_rotated_halfedge_handle(heh_);
    if(heh_ == start_) lap_counter_++;
Jan Möbius's avatar
Jan Möbius committed
216
217
218
219
220
221
222
    return *this;
  }


  /// Pre-Decrement (next ccw target)
  VertexVertexIterT& operator--() { 
    assert(mesh_);
223
224
    if(heh_ == start_) lap_counter_--;
    heh_=mesh_->ccw_rotated_halfedge_handle(heh_);
Jan Möbius's avatar
Jan Möbius committed
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
    return *this;
  }


  /** Get the current halfedge. There are \c Vertex*Iters and \c
      Face*Iters.  For both the current state is defined by the
      current halfedge. This is what this method returns. 
  */
  HalfedgeHandle current_halfedge_handle() const {
    return heh_;
  }


  /// Return the handle of the current target.
  typename Mesh::VertexHandle handle() const {
    assert(mesh_);
241
    return mesh_->to_vertex_handle(heh_);
Jan Möbius's avatar
Jan Möbius committed
242
243
244
245
246
247
  }


  /// Cast to the handle of the current target.
  operator typename Mesh::VertexHandle() const {
    assert(mesh_);
248
    return mesh_->to_vertex_handle(heh_);
Jan Möbius's avatar
Jan Möbius committed
249
250
251
252
  }
    

  ///  Return a reference to the current target.
253
254
255
  reference operator*() const { 
    assert(mesh_);
    return mesh_->deref(handle());
Jan Möbius's avatar
Jan Möbius committed
256
257
258
259
  }


  /// Return a pointer to the current target.
260
261
262
  pointer operator->() const {
    assert(mesh_);
    return &mesh_->deref(handle());
Jan Möbius's avatar
Jan Möbius committed
263
264
265
266
267
268
269
270
271
272
  }


  /** Returns whether the circulator is still valid.
      After one complete round around a vertex/face the circulator becomes
      invalid, i.e. this function will return \c false. Nevertheless you
      can continue circulating. This method just tells you whether you
      have completed the first round.
   */
  operator bool() const {
273
    return heh_.is_valid() && ((start_ != heh_) || (lap_counter_ == 0));
Jan Möbius's avatar
Jan Möbius committed
274
275
276
277
278
279
280
  }


protected:

  mesh_ptr         mesh_;
  HalfedgeHandle   start_, heh_;
281
  int              lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
};



//== CLASS DEFINITION =========================================================

	      
/** \class ConstVertexVertexIterT CirculatorsT.hh <OpenMesh/Mesh/Iterators/CirculatorsT.hh>
    Circulator.
*/

template <class Mesh>
class ConstVertexVertexIterT
{
 public:


  //--- Typedefs ---

301
  typedef typename Mesh::HalfedgeHandle     HalfedgeHandle;
Jan Möbius's avatar
Jan Möbius committed
302

303
304
  typedef typename Mesh::Vertex             value_type;
  typedef typename Mesh::VertexHandle       value_handle;
Jan Möbius's avatar
Jan Möbius committed
305
306

#if 1
307
  typedef std::bidirectional_iterator_tag   iterator_category;
308
  typedef std::ptrdiff_t                    difference_type;
309
310
311
312
  typedef const Mesh&                       mesh_ref;
  typedef const Mesh*                       mesh_ptr;
  typedef const typename Mesh::Vertex&      reference;
  typedef const typename Mesh::Vertex*      pointer;
Jan Möbius's avatar
Jan Möbius committed
313
#else
314
  typedef std::bidirectional_iterator_tag   iterator_category;
315
  typedef std::ptrdiff_t                    difference_type;
316
317
318
319
  typedef Mesh&                             mesh_ref;
  typedef Mesh*                             mesh_ptr;
  typedef typename Mesh::Vertex&            reference;
  typedef typename Mesh::Vertex*            pointer;
Jan Möbius's avatar
Jan Möbius committed
320
321
322
323
324
#endif



  /// Default constructor
325
  ConstVertexVertexIterT() : mesh_(0), lap_counter_(0) {}
Jan Möbius's avatar
Jan Möbius committed
326
327
328


  /// Construct with mesh and a typename Mesh::VertexHandle
329
  ConstVertexVertexIterT(mesh_ref _mesh, typename Mesh::VertexHandle _start, bool _end = false) :
Jan Möbius's avatar
Jan Möbius committed
330
331
332
    mesh_(&_mesh), 
    start_(_mesh.halfedge_handle(_start)),
    heh_(start_),
333
    lap_counter_(_end)
Jan Möbius's avatar
Jan Möbius committed
334
335
336
337
  {  ; }


  /// Construct with mesh and start halfedge
338
  ConstVertexVertexIterT(mesh_ref _mesh, HalfedgeHandle _heh, bool _end = false) :
Jan Möbius's avatar
Jan Möbius committed
339
340
341
    mesh_(&_mesh),
    start_(_heh),
    heh_(_heh),
342
    lap_counter_(_end)
Jan Möbius's avatar
Jan Möbius committed
343
344
345
346
347
348
349
350
  {  ; }


  /// Copy constructor
  ConstVertexVertexIterT(const ConstVertexVertexIterT& _rhs) :
    mesh_(_rhs.mesh_),
    start_(_rhs.start_),
    heh_(_rhs.heh_),
351
    lap_counter_(_rhs.lap_counter_)
Jan Möbius's avatar
Jan Möbius committed
352
353
354
355
356
357
358
359
360
  {  ; }


  /// Assignment operator
  ConstVertexVertexIterT& operator=(const ConstVertexVertexIterT<Mesh>& _rhs)
  {
    mesh_   = _rhs.mesh_;
    start_  = _rhs.start_;
    heh_    = _rhs.heh_;
361
    lap_counter_ = _rhs.lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
362
363
364
365
366
367
368
369
370
371
    return *this;
  }


#if 1
  /// construct from non-const circulator type
  ConstVertexVertexIterT(const VertexVertexIterT<Mesh>& _rhs) :
    mesh_(_rhs.mesh_),
    start_(_rhs.start_),
    heh_(_rhs.heh_),
372
    lap_counter_(_rhs.lap_counter_)
Jan Möbius's avatar
Jan Möbius committed
373
374
375
376
377
378
379
380
381
  {  ; }


  /// assign from non-const circulator
  ConstVertexVertexIterT& operator=(const VertexVertexIterT<Mesh>& _rhs)
  {
    mesh_   = _rhs.mesh_;
    start_  = _rhs.start_;
    heh_    = _rhs.heh_;
382
    lap_counter_ = _rhs.lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
383
384
385
386
387
388
389
390
391
392
393
394
    return *this;
  }
#else
  friend class ConstVertexVertexIterT<Mesh>;
#endif  


  /// Equal ?
  bool operator==(const ConstVertexVertexIterT& _rhs) const {
    return ((mesh_   == _rhs.mesh_) &&
	    (start_  == _rhs.start_) &&
	    (heh_    == _rhs.heh_) &&
395
	    (lap_counter_ == _rhs.lap_counter_));
Jan Möbius's avatar
Jan Möbius committed
396
397
398
399
400
401
402
403
404
405
406
407
  }


  /// Not equal ?
  bool operator!=(const ConstVertexVertexIterT& _rhs) const {
    return !operator==(_rhs);
  }


  /// Pre-Increment (next cw target)
  ConstVertexVertexIterT& operator++() { 
    assert(mesh_);
408
409
    heh_=mesh_->cw_rotated_halfedge_handle(heh_);
    if(heh_ == start_) lap_counter_++;
Jan Möbius's avatar
Jan Möbius committed
410
411
412
413
414
415
416
    return *this;
  }


  /// Pre-Decrement (next ccw target)
  ConstVertexVertexIterT& operator--() { 
    assert(mesh_);
417
418
    if(heh_ == start_) lap_counter_--;
    heh_=mesh_->ccw_rotated_halfedge_handle(heh_);
Jan Möbius's avatar
Jan Möbius committed
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
    return *this;
  }


  /** Get the current halfedge. There are \c Vertex*Iters and \c
      Face*Iters.  For both the current state is defined by the
      current halfedge. This is what this method returns. 
  */
  HalfedgeHandle current_halfedge_handle() const {
    return heh_;
  }


  /// Return the handle of the current target.
  typename Mesh::VertexHandle handle() const {
    assert(mesh_);
435
    return mesh_->to_vertex_handle(heh_);
Jan Möbius's avatar
Jan Möbius committed
436
437
438
439
440
441
  }


  /// Cast to the handle of the current target.
  operator typename Mesh::VertexHandle() const {
    assert(mesh_);
442
    return mesh_->to_vertex_handle(heh_);
Jan Möbius's avatar
Jan Möbius committed
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
  }
    

  ///  Return a reference to the current target.
  reference operator*() const { 
    assert(mesh_);
    return mesh_->deref(handle());
  }


  /// Return a pointer to the current target.
  pointer operator->() const { 
    assert(mesh_);
    return &mesh_->deref(handle());
  }


  /** Returns whether the circulator is still valid.
      After one complete round around a vertex/face the circulator becomes
      invalid, i.e. this function will return \c false. Nevertheless you
      can continue circulating. This method just tells you whether you
      have completed the first round.
   */
  operator bool() const { 
467
    return heh_.is_valid() && ((start_ != heh_) || (lap_counter_ == 0));
Jan Möbius's avatar
Jan Möbius committed
468
469
470
471
472
473
474
  }


protected:

  mesh_ptr         mesh_;
  HalfedgeHandle   start_, heh_;
475
  int              lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
};



//== CLASS DEFINITION =========================================================


/** \class VertexOHalfedgeIterT CirculatorsT.hh <OpenMesh/Mesh/Iterators/CirculatorsT.hh>
    Circulator.
*/

template <class Mesh>
class VertexOHalfedgeIterT
{
 public:


  //--- Typedefs ---

495
  typedef typename Mesh::HalfedgeHandle     HalfedgeHandle;
Jan Möbius's avatar
Jan Möbius committed
496
497

  typedef typename Mesh::Halfedge           value_type;
498
  typedef typename Mesh::HalfedgeHandle     value_handle;
Jan Möbius's avatar
Jan Möbius committed
499
500

#if 0
501
  typedef std::bidirectional_iterator_tag   iterator_category;
502
  typedef std::ptrdiff_t                    difference_type;
503
504
505
506
  typedef const Mesh&                       mesh_ref;
  typedef const Mesh*                       mesh_ptr;
  typedef const typename Mesh::Halfedge&    reference;
  typedef const typename Mesh::Halfedge*    pointer;
Jan Möbius's avatar
Jan Möbius committed
507
#else
508
  typedef std::bidirectional_iterator_tag   iterator_category;
509
  typedef std::ptrdiff_t                    difference_type;
510
511
512
513
  typedef Mesh&                             mesh_ref;
  typedef Mesh*                             mesh_ptr;
  typedef typename Mesh::Halfedge&          reference;
  typedef typename Mesh::Halfedge*          pointer;
Jan Möbius's avatar
Jan Möbius committed
514
515
516
517
518
#endif



  /// Default constructor
519
  VertexOHalfedgeIterT() : mesh_(0), lap_counter_(false) {}
Jan Möbius's avatar
Jan Möbius committed
520
521
522


  /// Construct with mesh and a typename Mesh::VertexHandle
523
  VertexOHalfedgeIterT(mesh_ref _mesh, typename Mesh::VertexHandle _start, bool _end = false) :
Jan Möbius's avatar
Jan Möbius committed
524
525
526
    mesh_(&_mesh), 
    start_(_mesh.halfedge_handle(_start)),
    heh_(start_),
527
    lap_counter_(_end)
Jan Möbius's avatar
Jan Möbius committed
528
529
530
531
  {  ; }


  /// Construct with mesh and start halfedge
532
  VertexOHalfedgeIterT(mesh_ref _mesh, HalfedgeHandle _heh, bool _end = false) :
Jan Möbius's avatar
Jan Möbius committed
533
534
535
    mesh_(&_mesh),
    start_(_heh),
    heh_(_heh),
536
    lap_counter_(_end)
Jan Möbius's avatar
Jan Möbius committed
537
538
539
540
541
542
543
544
  {  ; }


  /// Copy constructor
  VertexOHalfedgeIterT(const VertexOHalfedgeIterT& _rhs) :
    mesh_(_rhs.mesh_),
    start_(_rhs.start_),
    heh_(_rhs.heh_),
545
    lap_counter_(_rhs.lap_counter_)
Jan Möbius's avatar
Jan Möbius committed
546
547
548
549
550
551
552
553
554
  {  ; }


  /// Assignment operator
  VertexOHalfedgeIterT& operator=(const VertexOHalfedgeIterT<Mesh>& _rhs)
  {
    mesh_   = _rhs.mesh_;
    start_  = _rhs.start_;
    heh_    = _rhs.heh_;
555
    lap_counter_ = _rhs.lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
556
557
558
559
560
561
562
563
564
565
    return *this;
  }


#if 0
  /// construct from non-const circulator type
  VertexOHalfedgeIterT(const VertexOHalfedgeIterT<Mesh>& _rhs) :
    mesh_(_rhs.mesh_),
    start_(_rhs.start_),
    heh_(_rhs.heh_),
566
    lap_counter_(_rhs.lap_counter_)
Jan Möbius's avatar
Jan Möbius committed
567
568
569
570
571
572
573
574
575
  {  ; }


  /// assign from non-const circulator
  VertexOHalfedgeIterT& operator=(const VertexOHalfedgeIterT<Mesh>& _rhs)
  {
    mesh_   = _rhs.mesh_;
    start_  = _rhs.start_;
    heh_    = _rhs.heh_;
576
    lap_counter_ = _rhs.lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
577
578
579
580
581
582
583
584
585
586
587
588
    return *this;
  }
#else
  friend class ConstVertexOHalfedgeIterT<Mesh>;
#endif  


  /// Equal ?
  bool operator==(const VertexOHalfedgeIterT& _rhs) const {
    return ((mesh_   == _rhs.mesh_) &&
	    (start_  == _rhs.start_) &&
	    (heh_    == _rhs.heh_) &&
589
	    (lap_counter_ == _rhs.lap_counter_));
Jan Möbius's avatar
Jan Möbius committed
590
591
592
593
594
595
596
597
598
599
600
601
  }


  /// Not equal ?
  bool operator!=(const VertexOHalfedgeIterT& _rhs) const {
    return !operator==(_rhs);
  }


  /// Pre-Increment (next cw target)
  VertexOHalfedgeIterT& operator++() { 
    assert(mesh_);
602
603
    heh_=mesh_->cw_rotated_halfedge_handle(heh_);
    if(heh_ == start_) lap_counter_++;
Jan Möbius's avatar
Jan Möbius committed
604
605
606
607
608
609
610
    return *this;
  }


  /// Pre-Decrement (next ccw target)
  VertexOHalfedgeIterT& operator--() { 
    assert(mesh_);
611
612
    if(heh_ == start_) lap_counter_--;
    heh_=mesh_->ccw_rotated_halfedge_handle(heh_);
Jan Möbius's avatar
Jan Möbius committed
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
    return *this;
  }


  /** Get the current halfedge. There are \c Vertex*Iters and \c
      Face*Iters.  For both the current state is defined by the
      current halfedge. This is what this method returns. 
  */
  HalfedgeHandle current_halfedge_handle() const {
    return heh_;
  }


  /// Return the handle of the current target.
  typename Mesh::HalfedgeHandle handle() const {
    assert(mesh_);
    return heh_; 
  }


  /// Cast to the handle of the current target.
  operator typename Mesh::HalfedgeHandle() const {
    assert(mesh_);
    return heh_; 
  }
    

  ///  Return a reference to the current target.
  reference operator*() const {
    assert(mesh_);
    return mesh_->deref(handle());
  }


  /// Return a pointer to the current target.
  pointer operator->() const { 
    assert(mesh_);
    return &mesh_->deref(handle());
  }


  /** Returns whether the circulator is still valid.
      After one complete round around a vertex/face the circulator becomes
      invalid, i.e. this function will return \c false. Nevertheless you
      can continue circulating. This method just tells you whether you
      have completed the first round.
   */
  operator bool() const { 
661
    return heh_.is_valid() && ((start_ != heh_) || (lap_counter_ == 0));
Jan Möbius's avatar
Jan Möbius committed
662
663
664
665
666
667
668
  }


protected:

  mesh_ptr         mesh_;
  HalfedgeHandle   start_, heh_;
669
  int              lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
};



//== CLASS DEFINITION =========================================================

	      
/** \class ConstVertexOHalfedgeIterT CirculatorsT.hh <OpenMesh/Mesh/Iterators/CirculatorsT.hh>
    Circulator.
*/

template <class Mesh>
class ConstVertexOHalfedgeIterT
{
 public:


  //--- Typedefs ---

689
  typedef typename Mesh::HalfedgeHandle     HalfedgeHandle;
Jan Möbius's avatar
Jan Möbius committed
690
691

  typedef typename Mesh::Halfedge           value_type;
692
  typedef typename Mesh::HalfedgeHandle     value_handle;
Jan Möbius's avatar
Jan Möbius committed
693
694

#if 1
695
  typedef std::bidirectional_iterator_tag   iterator_category;
696
  typedef std::ptrdiff_t                    difference_type;
697
698
699
700
  typedef const Mesh&                       mesh_ref;
  typedef const Mesh*                       mesh_ptr;
  typedef const typename Mesh::Halfedge&    reference;
  typedef const typename Mesh::Halfedge*    pointer;
Jan Möbius's avatar
Jan Möbius committed
701
#else
702
  typedef std::bidirectional_iterator_tag   iterator_category;
703
  typedef std::ptrdiff_t                    difference_type;
704
705
706
707
  typedef Mesh&                             mesh_ref;
  typedef Mesh*                             mesh_ptr;
  typedef typename Mesh::Halfedge&          reference;
  typedef typename Mesh::Halfedge*          pointer;
Jan Möbius's avatar
Jan Möbius committed
708
709
710
711
712
#endif



  /// Default constructor
713
  ConstVertexOHalfedgeIterT() : mesh_(0), lap_counter_(false) {}
Jan Möbius's avatar
Jan Möbius committed
714
715
716


  /// Construct with mesh and a typename Mesh::VertexHandle
717
  ConstVertexOHalfedgeIterT(mesh_ref _mesh, typename Mesh::VertexHandle _start, bool _end = false) :
Jan Möbius's avatar
Jan Möbius committed
718
719
720
    mesh_(&_mesh), 
    start_(_mesh.halfedge_handle(_start)),
    heh_(start_),
721
    lap_counter_(_end)
Jan Möbius's avatar
Jan Möbius committed
722
723
724
725
  {  ; }


  /// Construct with mesh and start halfedge
726
  ConstVertexOHalfedgeIterT(mesh_ref _mesh, HalfedgeHandle _heh, bool _end = false) :
Jan Möbius's avatar
Jan Möbius committed
727
728
729
    mesh_(&_mesh),
    start_(_heh),
    heh_(_heh),
730
    lap_counter_(_end)
Jan Möbius's avatar
Jan Möbius committed
731
732
733
734
735
736
737
738
  {  ; }


  /// Copy constructor
  ConstVertexOHalfedgeIterT(const ConstVertexOHalfedgeIterT& _rhs) :
    mesh_(_rhs.mesh_),
    start_(_rhs.start_),
    heh_(_rhs.heh_),
739
    lap_counter_(_rhs.lap_counter_)
Jan Möbius's avatar
Jan Möbius committed
740
741
742
743
744
745
746
747
748
  {  ; }


  /// Assignment operator
  ConstVertexOHalfedgeIterT& operator=(const ConstVertexOHalfedgeIterT<Mesh>& _rhs)
  {
    mesh_   = _rhs.mesh_;
    start_  = _rhs.start_;
    heh_    = _rhs.heh_;
749
    lap_counter_ = _rhs.lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
750
751
752
753
754
755
756
757
758
759
    return *this;
  }


#if 1
  /// construct from non-const circulator type
  ConstVertexOHalfedgeIterT(const VertexOHalfedgeIterT<Mesh>& _rhs) :
    mesh_(_rhs.mesh_),
    start_(_rhs.start_),
    heh_(_rhs.heh_),
760
    lap_counter_(_rhs.lap_counter_)
Jan Möbius's avatar
Jan Möbius committed
761
762
763
764
765
766
767
768
769
  {  ; }


  /// assign from non-const circulator
  ConstVertexOHalfedgeIterT& operator=(const VertexOHalfedgeIterT<Mesh>& _rhs)
  {
    mesh_   = _rhs.mesh_;
    start_  = _rhs.start_;
    heh_    = _rhs.heh_;
770
    lap_counter_ = _rhs.lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
771
772
773
774
775
776
777
778
779
780
781
782
    return *this;
  }
#else
  friend class ConstVertexOHalfedgeIterT<Mesh>;
#endif  


  /// Equal ?
  bool operator==(const ConstVertexOHalfedgeIterT& _rhs) const {
    return ((mesh_   == _rhs.mesh_) &&
	    (start_  == _rhs.start_) &&
	    (heh_    == _rhs.heh_) &&
783
	    (lap_counter_ == _rhs.lap_counter_));
Jan Möbius's avatar
Jan Möbius committed
784
785
786
787
788
789
790
791
792
793
794
795
  }


  /// Not equal ?
  bool operator!=(const ConstVertexOHalfedgeIterT& _rhs) const {
    return !operator==(_rhs);
  }


  /// Pre-Increment (next cw target)
  ConstVertexOHalfedgeIterT& operator++() { 
    assert(mesh_);
796
797
    heh_=mesh_->cw_rotated_halfedge_handle(heh_);
    if(heh_ == start_) lap_counter_++;
Jan Möbius's avatar
Jan Möbius committed
798
799
800
801
802
803
804
    return *this;
  }


  /// Pre-Decrement (next ccw target)
  ConstVertexOHalfedgeIterT& operator--() { 
    assert(mesh_);
805
806
    if(heh_ == start_) lap_counter_--;
    heh_=mesh_->ccw_rotated_halfedge_handle(heh_);
Jan Möbius's avatar
Jan Möbius committed
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
    return *this;
  }


  /** Get the current halfedge. There are \c Vertex*Iters and \c
      Face*Iters.  For both the current state is defined by the
      current halfedge. This is what this method returns. 
  */
  HalfedgeHandle current_halfedge_handle() const {
    return heh_;
  }


  /// Return the handle of the current target.
  typename Mesh::HalfedgeHandle handle() const {
    assert(mesh_);
    return heh_; 
  }


  /// Cast to the handle of the current target.
  operator typename Mesh::HalfedgeHandle() const {
    assert(mesh_);
    return heh_; 
  }
    

  ///  Return a reference to the current target.
  reference operator*() const { 
    assert(mesh_);
    return mesh_->deref(handle());
  }


  /// Return a pointer to the current target.
  pointer operator->() const { 
    assert(mesh_);
    return &mesh_->deref(handle());
  }


  /** Returns whether the circulator is still valid.
      After one complete round around a vertex/face the circulator becomes
      invalid, i.e. this function will return \c false. Nevertheless you
      can continue circulating. This method just tells you whether you
      have completed the first round.
   */
  operator bool() const { 
855
    return heh_.is_valid() && ((start_ != heh_) || (lap_counter_ == 0));
Jan Möbius's avatar
Jan Möbius committed
856
857
858
859
860
861
862
  }


protected:

  mesh_ptr         mesh_;
  HalfedgeHandle   start_, heh_;
863
  int              lap_counter_;
Jan Möbius's avatar
Jan Möbius committed
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
};



//== CLASS DEFINITION =========================================================

	      
/** \class VertexIHalfedgeIterT CirculatorsT.hh <OpenMesh/Mesh/Iterators/CirculatorsT.hh>
    Circulator.
*/

template <class Mesh>
class VertexIHalfedgeIterT
{
 public:


  //--- Typedefs ---

883
  typedef typename Mesh::HalfedgeHandle     HalfedgeHandle;
Jan Möbius's avatar
Jan Möbius committed
884
885

  typedef typename Mesh::Halfedge           value_type;
886
  typedef typename Mesh::HalfedgeHandle     value_handle;
Jan Möbius's avatar
Jan Möbius committed
887
888

#if 0
889
  typedef std::bidirectional_iterator_tag   iterator_category;
890
  typedef std::ptrdiff_t                    diff