libDwm-0.6.0
DwmPacer.hh
Go to the documentation of this file.
1 //===========================================================================
2 // @(#) $DwmPath: dwm/libDwm/tags/libDwm-0.6.0/include/DwmPacer.hh 8401 $
3 // @(#) $Id: DwmPacer.hh 8401 2016-04-17 06:44:31Z dwm $
4 //===========================================================================
5 // Copyright (c) Daniel W. McRobb 1998-2007, 2016
6 // All rights reserved.
7 //
8 // Redistribution and use in source and binary forms, with or without
9 // modification, are permitted provided that the following conditions
10 // are met:
11 //
12 // 1. Redistributions of source code must retain the above copyright
13 // notice, this list of conditions and the following disclaimer.
14 // 2. Redistributions in binary form must reproduce the above copyright
15 // notice, this list of conditions and the following disclaimer in the
16 // documentation and/or other materials provided with the distribution.
17 // 3. The names of the authors and copyright holders may not be used to
18 // endorse or promote products derived from this software without
19 // specific prior written permission.
20 //
21 // IN NO EVENT SHALL DANIEL W. MCROBB BE LIABLE TO ANY PARTY FOR
22 // DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
23 // INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE,
24 // EVEN IF DANIEL W. MCROBB HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
25 // DAMAGE.
26 //
27 // THE SOFTWARE PROVIDED HEREIN IS ON AN "AS IS" BASIS, AND
28 // DANIEL W. MCROBB HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT,
29 // UPDATES, ENHANCEMENTS, OR MODIFICATIONS. DANIEL W. MCROBB MAKES NO
30 // REPRESENTATIONS AND EXTENDS NO WARRANTIES OF ANY KIND, EITHER
31 // IMPLIED OR EXPRESS, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
32 // WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE,
33 // OR THAT THE USE OF THIS SOFTWARE WILL NOT INFRINGE ANY PATENT,
34 // TRADEMARK OR OTHER RIGHTS.
35 //===========================================================================
36 
37 //---------------------------------------------------------------------------
40 //---------------------------------------------------------------------------
41 
42 #ifndef _DWMPACER_HH_
43 #define _DWMPACER_HH_
44 
45 #include "DwmTimeValue.hh"
46 
47 namespace Dwm {
48 
49  //--------------------------------------------------------------------------
55  //--------------------------------------------------------------------------
56  class Pacer
57  {
58  public:
59  //------------------------------------------------------------------------
61  //------------------------------------------------------------------------
62  Pacer(uint32_t rate);
63 
64  //------------------------------------------------------------------------
66  //------------------------------------------------------------------------
67  uint32_t Rate() const;
68 
69  //------------------------------------------------------------------------
71  //------------------------------------------------------------------------
72  uint32_t Rate(uint32_t rate);
73 
74  //------------------------------------------------------------------------
79  //------------------------------------------------------------------------
80  void Pace();
81 
82  private:
83  uint32_t _rate;
84  TimeValue _nextTime;
85  TimeValue _interval;
86 
87  static TimeValue _minSleep;
88  void SetMinSleep();
89  };
90 
91 } // namespace Dwm
92 
93 #endif // _DWMPACER_HH_
94 
95 //---------------------------- emacs settings -----------------------------
96 // Local Variables:
97 // mode: C++/la
98 // tab-width: 2
99 // indent-tabs-mode: nil
100 // c-basic-offset: 2
101 // End:
102 //-------------------------------------------------------------------------
uint32_t Rate() const
Returns the rate (reps per second).
void Pace()
This should be called between each call you wish to throttle.
This class encapsulates a time value beyond the UNIX epoch, with microsecond granularity.
Definition: DwmTimeValue.hh:72
Pacer(uint32_t rate)
Construct with the given rate (reps per second).
This class permits throttling of functions to a max number of repetitions per second.
Definition: DwmPacer.hh:56
Dwm::TimeValue class definition.
Definition: DwmBZ2IO.hh:67