cartobase  5.1.2
threadedLoop.h
Go to the documentation of this file.
1 /* This software and supporting documentation are distributed by
2  * Institut Federatif de Recherche 49
3  * CEA/NeuroSpin, Batiment 145,
4  * 91191 Gif-sur-Yvette cedex
5  * France
6  *
7  * This software is governed by the CeCILL-B license under
8  * French law and abiding by the rules of distribution of free software.
9  * You can use, modify and/or redistribute the software under the
10  * terms of the CeCILL-B license as circulated by CEA, CNRS
11  * and INRIA at the following URL "http://www.cecill.info".
12  *
13  * As a counterpart to the access to the source code and rights to copy,
14  * modify and redistribute granted by the license, users are provided only
15  * with a limited warranty and the software's author, the holder of the
16  * economic rights, and the successive licensors have only limited
17  * liability.
18  *
19  * In this respect, the user's attention is drawn to the risks associated
20  * with loading, using, modifying and/or developing or reproducing the
21  * software by the user in light of its specific status of free software,
22  * that may mean that it is complicated to manipulate, and that also
23  * therefore means that it is reserved for developers and experienced
24  * professionals having in-depth computer knowledge. Users are therefore
25  * encouraged to load and test the software's suitability as regards their
26  * requirements in conditions enabling the security of their systems and/or
27  * data to be ensured and, more generally, to use and operate it in the
28  * same conditions as regards security.
29  *
30  * The fact that you are presently reading this means that you have had
31  * knowledge of the CeCILL-B license and that you accept its terms.
32  */
33 
34 
35 #ifndef CARTOBASE_THREAD_THREADEDLOOP_H
36 #define CARTOBASE_THREAD_THREADEDLOOP_H
37 
39 
40 #ifndef CARTO_NO_THREAD
41 
42 namespace carto
43 {
44 
45  class LoopContext;
46 
47 
49  {
50 
51  public:
52 
53  ThreadedLoop( LoopContext* loopContext,
54  int startIndex, int count, int maxThreadCount = 0,
55  float threadsByCpu = 1.0f );
56  virtual ~ThreadedLoop();
57 
63 
65  bool launch( bool resetGauge = true, bool resetCancel = true );
67  void run();
68 
71  void setEndThreadsWhenDone( bool x );
84  bool endThreadsWhenDone() const;
85  void setLoopCount( int n );
86  bool runSingleThreaded( bool resetGauge = true, bool resetCancel = true );
87 
88  private:
89  struct Private;
90 
91  Private *d;
92 
93  LoopContext* _loopContext;
94  int _grain;
95  int _startIndex;
96  int _count;
97  int _maxThreadCount;
98  float _threadsByCpu;
99 
100  int _currentIndex;
101  int _todo;
102  int _remain;
103 
104  };
105 
106 }
107 
108 
109 #endif
110 #endif
void setLoopCount(int n)
bool endThreadsWhenDone() const
The loop can work in two modes: single run (endThreadsWhenDone() is true) or multiple runs (endThread...
void run()
run one iteration step. It normally calls the LoopContext diIt() method
bool launch(bool resetGauge=true, bool resetCancel=true)
run the loop to the end until all iterations are finished
void setEndThreadsWhenDone(bool x)
Warning: it's possibly not safe to change this value from false to true after launch() has been calle...
void setLoopContext(LoopContext *)
This function is only useful in multiple run mode (endThreadsWhenDone false).
ThreadedLoop(LoopContext *loopContext, int startIndex, int count, int maxThreadCount=0, float threadsByCpu=1.0f)
bool runSingleThreaded(bool resetGauge=true, bool resetCancel=true)
virtual ~ThreadedLoop()