cartobase 6.0.6
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
42namespace carto
43{
44
45 class LoopContext;
46
47
49 {
50
51 public:
52
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()