lltimer.h
上传用户:king477883
上传日期:2021-03-01
资源大小:9553k
文件大小:5k
源码类别:

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file lltimer.h
  3.  * @brief Cross-platform objects for doing timing 
  4.  *
  5.  * $LicenseInfo:firstyear=2000&license=viewergpl$
  6.  * 
  7.  * Copyright (c) 2000-2010, Linden Research, Inc.
  8.  * 
  9.  * Second Life Viewer Source Code
  10.  * The source code in this file ("Source Code") is provided by Linden Lab
  11.  * to you under the terms of the GNU General Public License, version 2.0
  12.  * ("GPL"), unless you have obtained a separate licensing agreement
  13.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  14.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  15.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  16.  * 
  17.  * There are special exceptions to the terms and conditions of the GPL as
  18.  * it is applied to this Source Code. View the full text of the exception
  19.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  20.  * online at
  21.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  22.  * 
  23.  * By copying, modifying or distributing this software, you acknowledge
  24.  * that you have read and understood your obligations described above,
  25.  * and agree to abide by those obligations.
  26.  * 
  27.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  28.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  29.  * COMPLETENESS OR PERFORMANCE.
  30.  * $/LicenseInfo$
  31.  */
  32. #ifndef LL_TIMER_H
  33. #define LL_TIMER_H
  34. #if LL_LINUX || LL_DARWIN || LL_SOLARIS
  35. #include <sys/time.h>
  36. #endif
  37. #include <limits.h>
  38. #include "stdtypes.h"
  39. #include <string>
  40. #include <list>
  41. // units conversions
  42. #ifndef USEC_PER_SEC
  43.     const U32 USEC_PER_SEC = 1000000;
  44. #endif
  45. const U32 SEC_PER_MIN = 60;
  46. const U32 MIN_PER_HOUR = 60;
  47. const U32 USEC_PER_MIN = USEC_PER_SEC * SEC_PER_MIN;
  48. const U32 USEC_PER_HOUR = USEC_PER_MIN * MIN_PER_HOUR;
  49. const U32 SEC_PER_HOUR = SEC_PER_MIN * MIN_PER_HOUR;
  50. const F64  SEC_PER_USEC  = 1.0 / (F64) USEC_PER_SEC;
  51. class LL_COMMON_API LLTimer 
  52. {
  53. public:
  54. static LLTimer *sTimer; // global timer
  55. protected:
  56. U64 mLastClockCount;
  57. U64 mExpirationTicks;
  58. BOOL mStarted;
  59. public:
  60. LLTimer();
  61. ~LLTimer();
  62. static void initClass() { if (!sTimer) sTimer = new LLTimer; }
  63. static void cleanupClass() { delete sTimer; sTimer = NULL; }
  64. // Return a high precision number of seconds since the start of
  65. // this application instance.
  66. static F64 getElapsedSeconds()
  67. {
  68. return sTimer->getElapsedTimeF64();
  69. }
  70. // Return a high precision usec since epoch
  71. static U64 getTotalTime();
  72. // Return a high precision seconds since epoch
  73. static F64 getTotalSeconds();
  74. // MANIPULATORS
  75. void start() { reset(); mStarted = TRUE; }
  76. void stop() { mStarted = FALSE; }
  77. void reset(); // Resets the timer
  78. void setLastClockCount(U64 current_count); // Sets the timer so that the next elapsed call will be relative to this time
  79. void setTimerExpirySec(F32 expiration);
  80. BOOL checkExpirationAndReset(F32 expiration);
  81. BOOL hasExpired() const;
  82. F32 getElapsedTimeAndResetF32(); // Returns elapsed time in seconds with reset
  83. F64 getElapsedTimeAndResetF64();
  84. F32 getRemainingTimeF32() const;
  85. static BOOL knownBadTimer();
  86. // ACCESSORS
  87. F32 getElapsedTimeF32() const; // Returns elapsed time in seconds
  88. F64 getElapsedTimeF64() const; // Returns elapsed time in seconds
  89. BOOL getStarted() const { return mStarted; }
  90. static U64 getCurrentClockCount(); // Returns the raw clockticks
  91. };
  92. //
  93. // Various functions for initializing/accessing clock and timing stuff.  Don't use these without REALLY knowing how they work.
  94. //
  95. LL_COMMON_API U64 get_clock_count();
  96. LL_COMMON_API F64 calc_clock_frequency(U32 msecs);
  97. LL_COMMON_API void update_clock_frequencies();
  98. // Sleep for milliseconds
  99. LL_COMMON_API void ms_sleep(U32 ms);
  100. LL_COMMON_API U32 micro_sleep(U64 us, U32 max_yields = 0xFFFFFFFF);
  101. // Returns the correct UTC time in seconds, like time(NULL).
  102. // Useful on the viewer, which may have its local clock set wrong.
  103. LL_COMMON_API time_t time_corrected();
  104. static inline time_t time_min()
  105. {
  106. if (sizeof(time_t) == 4)
  107. {
  108. return (time_t) INT_MIN;
  109. } else {
  110. #ifdef LLONG_MIN
  111. return (time_t) LLONG_MIN;
  112. #else
  113. return (time_t) LONG_MIN;
  114. #endif
  115. }
  116. }
  117. static inline time_t time_max()
  118. {
  119. if (sizeof(time_t) == 4)
  120. {
  121. return (time_t) INT_MAX;
  122. } else {
  123. #ifdef LLONG_MAX
  124. return (time_t) LLONG_MAX;
  125. #else
  126. return (time_t) LONG_MAX;
  127. #endif
  128. }
  129. }
  130. // Correction factor used by time_corrected() above.
  131. extern LL_COMMON_API S32 gUTCOffset;
  132. // Is the current computer (in its current time zone)
  133. // observing daylight savings time?
  134. LL_COMMON_API BOOL is_daylight_savings();
  135. // Converts internal "struct tm" time buffer to Pacific Standard/Daylight Time
  136. // Usage:
  137. // S32 utc_time;
  138. // utc_time = time_corrected();
  139. // struct tm* internal_time = utc_to_pacific_time(utc_time, gDaylight);
  140. LL_COMMON_API struct tm* utc_to_pacific_time(time_t utc_time, BOOL pacific_daylight_time);
  141. LL_COMMON_API void microsecondsToTimecodeString(U64 current_time, std::string& tcstring);
  142. LL_COMMON_API void secondsToTimecodeString(F32 current_time, std::string& tcstring);
  143. U64 LL_COMMON_API totalTime(); // Returns current system time in microseconds
  144. #endif