... | ... |
@@ -24,13 +24,14 @@ |
24 | 24 |
///\brief Elevator class |
25 | 25 |
/// |
26 | 26 |
///Elevator class implements an efficient data structure |
27 | 27 |
///for labeling items in push-relabel type algorithms. |
28 | 28 |
/// |
29 | 29 |
|
30 |
#include < |
|
30 |
#include <lemon/bits/traits.h> |
|
31 |
|
|
31 | 32 |
namespace lemon { |
32 | 33 |
|
33 | 34 |
///Class for handling "labels" in push-relabel type algorithms. |
34 | 35 |
|
35 | 36 |
///A class for handling "labels" in push-relabel type algorithms. |
36 | 37 |
/// |
... | ... |
@@ -41,15 +42,15 @@ |
41 | 42 |
/// |
42 | 43 |
///Each item is either \em active or not, and you can also choose a |
43 | 44 |
///highest level active item. |
44 | 45 |
/// |
45 | 46 |
///\sa LinkedElevator |
46 | 47 |
/// |
47 |
///\param Graph the underlying graph |
|
48 |
///\param Graph Type of the underlying graph. |
|
48 | 49 |
///\param Item Type of the items the data is assigned to (Graph::Node, |
49 |
///Graph:: |
|
50 |
///Graph::Arc, Graph::Edge). |
|
50 | 51 |
template<class Graph, class Item> |
51 | 52 |
class Elevator |
52 | 53 |
{ |
53 | 54 |
public: |
54 | 55 |
|
55 | 56 |
typedef Item Key; |
... | ... |
@@ -97,38 +98,38 @@ |
97 | 98 |
public: |
98 | 99 |
|
99 | 100 |
///Constructor with given maximum level. |
100 | 101 |
|
101 | 102 |
///Constructor with given maximum level. |
102 | 103 |
/// |
103 |
///\param g The underlying graph |
|
104 |
///\param max_level Set the range of the possible labels to |
|
105 |
///[0...\c max_level] |
|
106 |
Elevator(const Graph &g,int max_level) : |
|
107 |
|
|
104 |
///\param graph The underlying graph. |
|
105 |
///\param max_level The maximum allowed level. |
|
106 |
///Set the range of the possible labels to <tt>[0..max_level]</tt>. |
|
107 |
Elevator(const Graph &graph,int max_level) : |
|
108 |
_g(graph), |
|
108 | 109 |
_max_level(max_level), |
109 | 110 |
_item_num(_max_level), |
110 |
_where(g), |
|
111 |
_level(g,0), |
|
111 |
_where(graph), |
|
112 |
_level(graph,0), |
|
112 | 113 |
_items(_max_level), |
113 | 114 |
_first(_max_level+2), |
114 | 115 |
_last_active(_max_level+2), |
115 | 116 |
_highest_active(-1) {} |
116 | 117 |
///Constructor. |
117 | 118 |
|
118 | 119 |
///Constructor. |
119 | 120 |
/// |
120 |
///\param g The underlying graph |
|
121 |
///The range of the possible labels is [0...\c max_level], |
|
121 |
///\param graph The underlying graph. |
|
122 |
///Set the range of the possible labels to <tt>[0..max_level]</tt>, |
|
122 | 123 |
///where \c max_level is equal to the number of labeled items in the graph. |
123 |
Elevator(const Graph &g) : |
|
124 |
_g(g), |
|
125 |
|
|
124 |
Elevator(const Graph &graph) : |
|
125 |
_g(graph), |
|
126 |
_max_level(countItems<Graph, Item>(graph)), |
|
126 | 127 |
_item_num(_max_level), |
127 |
_where(g), |
|
128 |
_level(g,0), |
|
128 |
_where(graph), |
|
129 |
_level(graph,0), |
|
129 | 130 |
_items(_max_level), |
130 | 131 |
_first(_max_level+2), |
131 | 132 |
_last_active(_max_level+2), |
132 | 133 |
_highest_active(-1) |
133 | 134 |
{ |
134 | 135 |
} |
... | ... |
@@ -164,13 +165,13 @@ |
164 | 165 |
|
165 | 166 |
///Return the number of items on level \c l. |
166 | 167 |
int onLevel(int l) const |
167 | 168 |
{ |
168 | 169 |
return _first[l+1]-_first[l]; |
169 | 170 |
} |
170 |
///Return true if |
|
171 |
///Return true if level \c l is empty. |
|
171 | 172 |
bool emptyLevel(int l) const |
172 | 173 |
{ |
173 | 174 |
return _first[l+1]-_first[l]==0; |
174 | 175 |
} |
175 | 176 |
///Return the number of items above level \c l. |
176 | 177 |
int aboveLevel(int l) const |
... | ... |
@@ -179,13 +180,13 @@ |
179 | 180 |
} |
180 | 181 |
///Return the number of active items on level \c l. |
181 | 182 |
int activesOnLevel(int l) const |
182 | 183 |
{ |
183 | 184 |
return _last_active[l]-_first[l]+1; |
184 | 185 |
} |
185 |
///Return true if there is |
|
186 |
///Return true if there is no active item on level \c l. |
|
186 | 187 |
bool activeFree(int l) const |
187 | 188 |
{ |
188 | 189 |
return _last_active[l]<_first[l]; |
189 | 190 |
} |
190 | 191 |
///Return the maximum allowed level. |
191 | 192 |
int maxLevel() const |
... | ... |
@@ -198,26 +199,22 @@ |
198 | 199 |
///active item. |
199 | 200 |
|
200 | 201 |
///@{ |
201 | 202 |
|
202 | 203 |
///Return a highest level active item. |
203 | 204 |
|
204 |
///Return a highest level active item. |
|
205 |
/// |
|
206 |
/// |
|
205 |
///Return a highest level active item or INVALID if there is no active |
|
207 | 206 |
///item. |
208 | 207 |
Item highestActive() const |
209 | 208 |
{ |
210 | 209 |
return _highest_active>=0?*_last_active[_highest_active]:INVALID; |
211 | 210 |
} |
212 | 211 |
|
213 |
///Return |
|
212 |
///Return the highest active level. |
|
214 | 213 |
|
215 |
///Return a highest active level. |
|
216 |
/// |
|
217 |
/// |
|
214 |
///Return the level of the highest active item or -1 if there is no active |
|
218 | 215 |
///item. |
219 | 216 |
int highestActiveLevel() const |
220 | 217 |
{ |
221 | 218 |
return _highest_active; |
222 | 219 |
} |
223 | 220 |
|
... | ... |
@@ -230,13 +227,13 @@ |
230 | 227 |
Item it = *_last_active[_highest_active]; |
231 | 228 |
_level.set(it,_level[it]+1); |
232 | 229 |
swap(_last_active[_highest_active]--,_last_active[_highest_active+1]); |
233 | 230 |
--_first[++_highest_active]; |
234 | 231 |
} |
235 | 232 |
|
236 |
///Lift the highest active item. |
|
233 |
///Lift the highest active item to the given level. |
|
237 | 234 |
|
238 | 235 |
///Lift the item returned by highestActive() to level \c new_level. |
239 | 236 |
/// |
240 | 237 |
///\warning \c new_level must be strictly higher |
241 | 238 |
///than the current level. |
242 | 239 |
/// |
... | ... |
@@ -252,20 +249,16 @@ |
252 | 249 |
} |
253 | 250 |
copy(li,_first[new_level]); |
254 | 251 |
_level.set(li,new_level); |
255 | 252 |
_highest_active=new_level; |
256 | 253 |
} |
257 | 254 |
|
258 |
///Lift the highest active item. |
|
255 |
///Lift the highest active item to the top level. |
|
259 | 256 |
|
260 | 257 |
///Lift the item returned by highestActive() to the top level and |
261 |
///deactivates it. |
|
262 |
/// |
|
263 |
///\warning \c new_level must be strictly higher |
|
264 |
///than the current level. |
|
265 |
/// |
|
258 |
///deactivate it. |
|
266 | 259 |
void liftHighestActiveToTop() |
267 | 260 |
{ |
268 | 261 |
const Item li = *_last_active[_highest_active]; |
269 | 262 |
|
270 | 263 |
copy(--_first[_highest_active+1],_last_active[_highest_active]--); |
271 | 264 |
for(int l=_highest_active+1;l<_max_level;l++) |
... | ... |
@@ -286,38 +279,36 @@ |
286 | 279 |
|
287 | 280 |
///\name Active Item on Certain Level |
288 | 281 |
///Functions for working with the active items. |
289 | 282 |
|
290 | 283 |
///@{ |
291 | 284 |
|
292 |
/// |
|
285 |
///Return an active item on level \c l. |
|
293 | 286 |
|
294 |
///Returns an active item on level \c l. |
|
295 |
/// |
|
296 |
/// |
|
287 |
///Return an active item on level \c l or \ref INVALID if there is no such |
|
297 | 288 |
///an item. (\c l must be from the range [0...\c max_level]. |
298 | 289 |
Item activeOn(int l) const |
299 | 290 |
{ |
300 | 291 |
return _last_active[l]>=_first[l]?*_last_active[l]:INVALID; |
301 | 292 |
} |
302 | 293 |
|
303 |
/// |
|
294 |
///Lift the active item returned by \c activeOn(level) by one. |
|
304 | 295 |
|
305 |
/// |
|
296 |
///Lift the active item returned by \ref activeOn() "activeOn(level)" |
|
306 | 297 |
///by one. |
307 | 298 |
Item liftActiveOn(int level) |
308 | 299 |
{ |
309 | 300 |
Item it =*_last_active[level]; |
310 | 301 |
_level.set(it,_level[it]+1); |
311 | 302 |
swap(_last_active[level]--, --_first[level+1]); |
312 | 303 |
if (level+1>_highest_active) ++_highest_active; |
313 | 304 |
} |
314 | 305 |
|
315 |
/// |
|
306 |
///Lift the active item returned by \c activeOn(level) to the given level. |
|
316 | 307 |
|
317 |
/// |
|
308 |
///Lift the active item returned by \ref activeOn() "activeOn(level)" |
|
318 | 309 |
///to the given level. |
319 | 310 |
void liftActiveOn(int level, int new_level) |
320 | 311 |
{ |
321 | 312 |
const Item ai = *_last_active[level]; |
322 | 313 |
|
323 | 314 |
copy(--_first[level+1], _last_active[level]--); |
... | ... |
@@ -328,16 +319,16 @@ |
328 | 319 |
} |
329 | 320 |
copy(ai,_first[new_level]); |
330 | 321 |
_level.set(ai,new_level); |
331 | 322 |
if (new_level>_highest_active) _highest_active=new_level; |
332 | 323 |
} |
333 | 324 |
|
334 |
/// |
|
325 |
///Lift the active item returned by \c activeOn(level) to the top level. |
|
335 | 326 |
|
336 |
///Lifts the active item returned by \c activeOn() member function |
|
337 |
///to the top level. |
|
327 |
///Lift the active item returned by \ref activeOn() "activeOn(level)" |
|
328 |
///to the top level and deactivate it. |
|
338 | 329 |
void liftActiveToTop(int level) |
339 | 330 |
{ |
340 | 331 |
const Item ai = *_last_active[level]; |
341 | 332 |
|
342 | 333 |
copy(--_first[level+1],_last_active[level]--); |
343 | 334 |
for(int l=level+1;l<_max_level;l++) |
... | ... |
@@ -381,24 +372,25 @@ |
381 | 372 |
_level.set(i,new_level); |
382 | 373 |
if(new_level>_highest_active) _highest_active=new_level; |
383 | 374 |
} |
384 | 375 |
|
385 | 376 |
///Move an inactive item to the top but one level (in a dirty way). |
386 | 377 |
|
387 |
///This function moves an inactive item to the top but one level. |
|
388 |
///It makes the underlying datastructure corrupt, so use is only if |
|
389 |
/// |
|
378 |
///This function moves an inactive item from the top level to the top |
|
379 |
///but one level (in a dirty way). |
|
380 |
///\warning It makes the underlying datastructure corrupt, so use it |
|
381 |
///only if you really know what it is for. |
|
390 | 382 |
///\pre The item is on the top level. |
391 | 383 |
void dirtyTopButOne(Item i) { |
392 | 384 |
_level.set(i,_max_level - 1); |
393 | 385 |
} |
394 | 386 |
|
395 |
///Lift all items on and above |
|
387 |
///Lift all items on and above the given level to the top level. |
|
396 | 388 |
|
397 |
///This function lifts all items on and above level \c l to \c |
|
398 |
///maxLevel(), and also deactivates them. |
|
389 |
///This function lifts all items on and above level \c l to the top |
|
390 |
///level and deactivates them. |
|
399 | 391 |
void liftToTop(int l) |
400 | 392 |
{ |
401 | 393 |
const Vit f=_first[l]; |
402 | 394 |
const Vit tl=_first[_max_level]; |
403 | 395 |
for(Vit i=f;i!=tl;++i) |
404 | 396 |
_level.set(*i,_max_level); |
... | ... |
@@ -417,24 +409,22 @@ |
417 | 409 |
int _init_lev; |
418 | 410 |
Vit _init_num; |
419 | 411 |
|
420 | 412 |
public: |
421 | 413 |
|
422 | 414 |
///\name Initialization |
423 |
///Using |
|
415 |
///Using these functions you can initialize the levels of the items. |
|
424 | 416 |
///\n |
425 |
///This initializatios is started with calling \c initStart(). |
|
426 |
///Then the |
|
427 |
///items should be listed levels by levels statring with the lowest one |
|
428 |
///(with level 0). This is done by using \c initAddItem() |
|
429 |
///and \c initNewLevel(). Finally \c initFinish() must be called. |
|
430 |
///The items not listed will be put on the highest level. |
|
417 |
///The initialization must be started with calling \c initStart(). |
|
418 |
///Then the items should be listed level by level starting with the |
|
419 |
///lowest one (level 0) using \c initAddItem() and \c initNewLevel(). |
|
420 |
///Finally \c initFinish() must be called. |
|
421 |
///The items not listed are put on the highest level. |
|
431 | 422 |
///@{ |
432 | 423 |
|
433 | 424 |
///Start the initialization process. |
434 |
|
|
435 | 425 |
void initStart() |
436 | 426 |
{ |
437 | 427 |
_init_lev=0; |
438 | 428 |
_init_num=&_items[0]; |
439 | 429 |
_first[0]=&_items[0]; |
440 | 430 |
_last_active[0]=&_items[0]-1; |
... | ... |
@@ -446,13 +436,12 @@ |
446 | 436 |
_level.set(i,_max_level); |
447 | 437 |
++n; |
448 | 438 |
} |
449 | 439 |
} |
450 | 440 |
|
451 | 441 |
///Add an item to the current level. |
452 |
|
|
453 | 442 |
void initAddItem(Item i) |
454 | 443 |
{ |
455 | 444 |
swap(_where[i],_init_num); |
456 | 445 |
_level.set(i,_init_lev); |
457 | 446 |
++_init_num; |
458 | 447 |
} |
... | ... |
@@ -466,13 +455,12 @@ |
466 | 455 |
_init_lev++; |
467 | 456 |
_first[_init_lev]=_init_num; |
468 | 457 |
_last_active[_init_lev]=_init_num-1; |
469 | 458 |
} |
470 | 459 |
|
471 | 460 |
///Finalize the initialization process. |
472 |
|
|
473 | 461 |
void initFinish() |
474 | 462 |
{ |
475 | 463 |
for(_init_lev++;_init_lev<=_max_level;_init_lev++) |
476 | 464 |
{ |
477 | 465 |
_first[_init_lev]=_init_num; |
478 | 466 |
_last_active[_init_lev]=_init_num-1; |
... | ... |
@@ -497,15 +485,15 @@ |
497 | 485 |
/// |
498 | 486 |
///Each item is either \em active or not, and you can also choose a |
499 | 487 |
///highest level active item. |
500 | 488 |
/// |
501 | 489 |
///\sa Elevator |
502 | 490 |
/// |
503 |
///\param Graph the underlying graph |
|
491 |
///\param Graph Type of the underlying graph. |
|
504 | 492 |
///\param Item Type of the items the data is assigned to (Graph::Node, |
505 |
///Graph:: |
|
493 |
///Graph::Arc, Graph::Edge). |
|
506 | 494 |
template <class Graph, class Item> |
507 | 495 |
class LinkedElevator { |
508 | 496 |
public: |
509 | 497 |
|
510 | 498 |
typedef Item Key; |
511 | 499 |
typedef int Value; |
... | ... |
@@ -530,27 +518,27 @@ |
530 | 518 |
|
531 | 519 |
public: |
532 | 520 |
///Constructor with given maximum level. |
533 | 521 |
|
534 | 522 |
///Constructor with given maximum level. |
535 | 523 |
/// |
536 |
///\param g The underlying graph |
|
537 |
///\param max_level Set the range of the possible labels to |
|
538 |
/// |
|
524 |
///\param graph The underlying graph. |
|
525 |
///\param max_level The maximum allowed level. |
|
526 |
///Set the range of the possible labels to <tt>[0..max_level]</tt>. |
|
539 | 527 |
LinkedElevator(const Graph& graph, int max_level) |
540 | 528 |
: _graph(graph), _max_level(max_level), _item_num(_max_level), |
541 | 529 |
_first(_max_level + 1), _last(_max_level + 1), |
542 | 530 |
_prev(graph), _next(graph), |
543 | 531 |
_highest_active(-1), _level(graph), _active(graph) {} |
544 | 532 |
|
545 | 533 |
///Constructor. |
546 | 534 |
|
547 | 535 |
///Constructor. |
548 | 536 |
/// |
549 |
///\param g The underlying graph |
|
550 |
///The range of the possible labels is [0...\c max_level], |
|
537 |
///\param graph The underlying graph. |
|
538 |
///Set the range of the possible labels to <tt>[0..max_level]</tt>, |
|
551 | 539 |
///where \c max_level is equal to the number of labeled items in the graph. |
552 | 540 |
LinkedElevator(const Graph& graph) |
553 | 541 |
: _graph(graph), _max_level(countItems<Graph, Item>(graph)), |
554 | 542 |
_item_num(_max_level), |
555 | 543 |
_first(_max_level + 1), _last(_max_level + 1), |
556 | 544 |
_prev(graph, INVALID), _next(graph, INVALID), |
... | ... |
@@ -654,13 +642,13 @@ |
654 | 642 |
++num; |
655 | 643 |
n = _next[n]; |
656 | 644 |
} |
657 | 645 |
return num; |
658 | 646 |
} |
659 | 647 |
|
660 |
///Return true if there is |
|
648 |
///Return true if there is no active item on level \c l. |
|
661 | 649 |
bool activeFree(int l) const { |
662 | 650 |
return _first[l] == INVALID || !_active[_first[l]]; |
663 | 651 |
} |
664 | 652 |
|
665 | 653 |
///Return the maximum allowed level. |
666 | 654 |
int maxLevel() const { |
... | ... |
@@ -672,26 +660,22 @@ |
672 | 660 |
///active item. |
673 | 661 |
|
674 | 662 |
///@{ |
675 | 663 |
|
676 | 664 |
///Return a highest level active item. |
677 | 665 |
|
678 |
///Return a highest level active item. |
|
679 |
/// |
|
680 |
///\return the highest level active item or INVALID if there is no |
|
681 |
///active item. |
|
666 |
///Return a highest level active item or INVALID if there is no active |
|
667 |
///item. |
|
682 | 668 |
Item highestActive() const { |
683 | 669 |
return _highest_active >= 0 ? _first[_highest_active] : INVALID; |
684 | 670 |
} |
685 | 671 |
|
686 |
///Return |
|
672 |
///Return the highest active level. |
|
687 | 673 |
|
688 |
///Return a highest active level. |
|
689 |
/// |
|
690 |
///\return the level of the highest active item or -1 if there is |
|
691 |
///no active item. |
|
674 |
///Return the level of the highest active item or -1 if there is no active |
|
675 |
///item. |
|
692 | 676 |
int highestActiveLevel() const { |
693 | 677 |
return _highest_active; |
694 | 678 |
} |
695 | 679 |
|
696 | 680 |
///Lift the highest active item by one. |
697 | 681 |
|
... | ... |
@@ -716,13 +700,13 @@ |
716 | 700 |
_prev.set(_first[_highest_active], i); |
717 | 701 |
_next.set(i, _first[_highest_active]); |
718 | 702 |
_first[_highest_active] = i; |
719 | 703 |
} |
720 | 704 |
} |
721 | 705 |
|
722 |
///Lift the highest active item. |
|
706 |
///Lift the highest active item to the given level. |
|
723 | 707 |
|
724 | 708 |
///Lift the item returned by highestActive() to level \c new_level. |
725 | 709 |
/// |
726 | 710 |
///\warning \c new_level must be strictly higher |
727 | 711 |
///than the current level. |
728 | 712 |
/// |
... | ... |
@@ -744,17 +728,16 @@ |
744 | 728 |
_prev.set(_first[_highest_active], i); |
745 | 729 |
_next.set(i, _first[_highest_active]); |
746 | 730 |
_first[_highest_active] = i; |
747 | 731 |
} |
748 | 732 |
} |
749 | 733 |
|
750 |
///Lift the highest active to top. |
|
734 |
///Lift the highest active item to the top level. |
|
751 | 735 |
|
752 | 736 |
///Lift the item returned by highestActive() to the top level and |
753 |
///deactivates the item. |
|
754 |
/// |
|
737 |
///deactivate it. |
|
755 | 738 |
void liftHighestActiveToTop() { |
756 | 739 |
Item i = _first[_highest_active]; |
757 | 740 |
_level.set(i, _max_level); |
758 | 741 |
if (_next[i] != INVALID) { |
759 | 742 |
_prev.set(_next[i], INVALID); |
760 | 743 |
_first[_highest_active] = _next[i]; |
... | ... |
@@ -770,26 +753,24 @@ |
770 | 753 |
|
771 | 754 |
///\name Active Item on Certain Level |
772 | 755 |
///Functions for working with the active items. |
773 | 756 |
|
774 | 757 |
///@{ |
775 | 758 |
|
776 |
/// |
|
759 |
///Return an active item on level \c l. |
|
777 | 760 |
|
778 |
///Returns an active item on level \c l. |
|
779 |
/// |
|
780 |
/// |
|
761 |
///Return an active item on level \c l or \ref INVALID if there is no such |
|
781 | 762 |
///an item. (\c l must be from the range [0...\c max_level]. |
782 | 763 |
Item activeOn(int l) const |
783 | 764 |
{ |
784 | 765 |
return _active[_first[l]] ? _first[l] : INVALID; |
785 | 766 |
} |
786 | 767 |
|
787 |
/// |
|
768 |
///Lift the active item returned by \c activeOn(l) by one. |
|
788 | 769 |
|
789 |
/// |
|
770 |
///Lift the active item returned by \ref activeOn() "activeOn(l)" |
|
790 | 771 |
///by one. |
791 | 772 |
Item liftActiveOn(int l) |
792 | 773 |
{ |
793 | 774 |
Item i = _first[l]; |
794 | 775 |
if (_next[i] != INVALID) { |
795 | 776 |
_prev.set(_next[i], INVALID); |
... | ... |
@@ -810,16 +791,16 @@ |
810 | 791 |
} |
811 | 792 |
if (_highest_active < l) { |
812 | 793 |
_highest_active = l; |
813 | 794 |
} |
814 | 795 |
} |
815 | 796 |
|
816 |
/// \brief Lifts the active item returned by \c activeOn() member function. |
|
817 |
/// |
|
818 |
/// Lifts the active item returned by \c activeOn() member function |
|
819 |
/// to the given level. |
|
797 |
///Lift the active item returned by \c activeOn(l) to the given level. |
|
798 |
|
|
799 |
///Lift the active item returned by \ref activeOn() "activeOn(l)" |
|
800 |
///to the given level. |
|
820 | 801 |
void liftActiveOn(int l, int new_level) |
821 | 802 |
{ |
822 | 803 |
Item i = _first[l]; |
823 | 804 |
if (_next[i] != INVALID) { |
824 | 805 |
_prev.set(_next[i], INVALID); |
825 | 806 |
_first[l] = _next[i]; |
... | ... |
@@ -839,16 +820,16 @@ |
839 | 820 |
} |
840 | 821 |
if (_highest_active < l) { |
841 | 822 |
_highest_active = l; |
842 | 823 |
} |
843 | 824 |
} |
844 | 825 |
|
845 |
/// |
|
826 |
///Lift the active item returned by \c activeOn(l) to the top level. |
|
846 | 827 |
|
847 |
///Lifts the active item returned by \c activeOn() member function |
|
848 |
///to the top level. |
|
828 |
///Lift the active item returned by \ref activeOn() "activeOn(l)" |
|
829 |
///to the top level and deactivate it. |
|
849 | 830 |
void liftActiveToTop(int l) |
850 | 831 |
{ |
851 | 832 |
Item i = _first[l]; |
852 | 833 |
if (_next[i] != INVALID) { |
853 | 834 |
_prev.set(_next[i], INVALID); |
854 | 835 |
_first[l] = _next[i]; |
... | ... |
@@ -897,24 +878,25 @@ |
897 | 878 |
_highest_active = new_level; |
898 | 879 |
} |
899 | 880 |
} |
900 | 881 |
|
901 | 882 |
///Move an inactive item to the top but one level (in a dirty way). |
902 | 883 |
|
903 |
///This function moves an inactive item to the top but one level. |
|
904 |
///It makes the underlying datastructure corrupt, so use is only if |
|
905 |
/// |
|
884 |
///This function moves an inactive item from the top level to the top |
|
885 |
///but one level (in a dirty way). |
|
886 |
///\warning It makes the underlying datastructure corrupt, so use it |
|
887 |
///only if you really know what it is for. |
|
906 | 888 |
///\pre The item is on the top level. |
907 | 889 |
void dirtyTopButOne(Item i) { |
908 | 890 |
_level.set(i, _max_level - 1); |
909 | 891 |
} |
910 | 892 |
|
911 |
///Lift all items on and above |
|
893 |
///Lift all items on and above the given level to the top level. |
|
912 | 894 |
|
913 |
///This function lifts all items on and above level \c l to \c |
|
914 |
///maxLevel(), and also deactivates them. |
|
895 |
///This function lifts all items on and above level \c l to the top |
|
896 |
///level and deactivates them. |
|
915 | 897 |
void liftToTop(int l) { |
916 | 898 |
for (int i = l + 1; _first[i] != INVALID; ++i) { |
917 | 899 |
Item n = _first[i]; |
918 | 900 |
while (n != INVALID) { |
919 | 901 |
_level.set(n, _max_level); |
920 | 902 |
n = _next[n]; |
... | ... |
@@ -933,24 +915,22 @@ |
933 | 915 |
|
934 | 916 |
int _init_level; |
935 | 917 |
|
936 | 918 |
public: |
937 | 919 |
|
938 | 920 |
///\name Initialization |
939 |
///Using |
|
921 |
///Using these functions you can initialize the levels of the items. |
|
940 | 922 |
///\n |
941 |
///This initializatios is started with calling \c initStart(). |
|
942 |
///Then the |
|
943 |
///items should be listed levels by levels statring with the lowest one |
|
944 |
///(with level 0). This is done by using \c initAddItem() |
|
945 |
///and \c initNewLevel(). Finally \c initFinish() must be called. |
|
946 |
///The items not listed will be put on the highest level. |
|
923 |
///The initialization must be started with calling \c initStart(). |
|
924 |
///Then the items should be listed level by level starting with the |
|
925 |
///lowest one (level 0) using \c initAddItem() and \c initNewLevel(). |
|
926 |
///Finally \c initFinish() must be called. |
|
927 |
///The items not listed are put on the highest level. |
|
947 | 928 |
///@{ |
948 | 929 |
|
949 | 930 |
///Start the initialization process. |
950 |
|
|
951 | 931 |
void initStart() { |
952 | 932 |
|
953 | 933 |
for (int i = 0; i <= _max_level; ++i) { |
954 | 934 |
_first[i] = _last[i] = INVALID; |
955 | 935 |
} |
956 | 936 |
_init_level = 0; |
... | ... |
@@ -959,13 +939,12 @@ |
959 | 939 |
_level.set(i, _max_level); |
960 | 940 |
_active.set(i, false); |
961 | 941 |
} |
962 | 942 |
} |
963 | 943 |
|
964 | 944 |
///Add an item to the current level. |
965 |
|
|
966 | 945 |
void initAddItem(Item i) { |
967 | 946 |
_level.set(i, _init_level); |
968 | 947 |
if (_last[_init_level] == INVALID) { |
969 | 948 |
_first[_init_level] = i; |
970 | 949 |
_last[_init_level] = i; |
971 | 950 |
_prev.set(i, INVALID); |
... | ... |
@@ -984,13 +963,12 @@ |
984 | 963 |
///It shouldn't be used before the items on level 0 are listed. |
985 | 964 |
void initNewLevel() { |
986 | 965 |
++_init_level; |
987 | 966 |
} |
988 | 967 |
|
989 | 968 |
///Finalize the initialization process. |
990 |
|
|
991 | 969 |
void initFinish() { |
992 | 970 |
_highest_active = -1; |
993 | 971 |
} |
994 | 972 |
|
995 | 973 |
///@} |
996 | 974 |
|
0 comments (0 inline)