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

游戏引擎

开发平台:

C++ Builder

  1. /** 
  2.  * @file llframetimer.h
  3.  * @brief A lightweight timer that measures seconds and is only
  4.  * updated once per frame.
  5.  *
  6.  * $LicenseInfo:firstyear=2002&license=viewergpl$
  7.  * 
  8.  * Copyright (c) 2002-2010, Linden Research, Inc.
  9.  * 
  10.  * Second Life Viewer Source Code
  11.  * The source code in this file ("Source Code") is provided by Linden Lab
  12.  * to you under the terms of the GNU General Public License, version 2.0
  13.  * ("GPL"), unless you have obtained a separate licensing agreement
  14.  * ("Other License"), formally executed by you and Linden Lab.  Terms of
  15.  * the GPL can be found in doc/GPL-license.txt in this distribution, or
  16.  * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  17.  * 
  18.  * There are special exceptions to the terms and conditions of the GPL as
  19.  * it is applied to this Source Code. View the full text of the exception
  20.  * in the file doc/FLOSS-exception.txt in this software distribution, or
  21.  * online at
  22.  * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  23.  * 
  24.  * By copying, modifying or distributing this software, you acknowledge
  25.  * that you have read and understood your obligations described above,
  26.  * and agree to abide by those obligations.
  27.  * 
  28.  * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  29.  * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  30.  * COMPLETENESS OR PERFORMANCE.
  31.  * $/LicenseInfo$
  32.  */
  33. #ifndef LL_LLFRAMETIMER_H
  34. #define LL_LLFRAMETIMER_H
  35. /**
  36.  * *NOTE: Because of limitations on linux which we do not really have
  37.  * time to explore, the total time is derived from the frame time
  38.  * and is recsynchronized on every frame.
  39.  */
  40. #include "lltimer.h"
  41. #include "timing.h"
  42. class LL_COMMON_API LLFrameTimer 
  43. {
  44. public:
  45. LLFrameTimer() : mStartTime( sFrameTime ), mExpiry(0), mStarted(TRUE) {}
  46. // Return the number of seconds since the start of this
  47. // application instance.
  48. static F64 getElapsedSeconds()
  49. {
  50. // Loses msec precision after ~4.5 hours...
  51. return sFrameTime;
  52. // Return a low precision usec since epoch
  53. static U64 getTotalTime()
  54. {
  55. return sTotalTime ? sTotalTime : totalTime();
  56. }
  57. // Return a low precision seconds since epoch
  58. static F64 getTotalSeconds()
  59. {
  60. return sTotalSeconds;
  61. }
  62. // Call this method once per frame to update the current frame time.   This is actually called
  63. // at some other times as well
  64. static void updateFrameTime();
  65. // Call this method once, and only once, per frame to update the current frame count.
  66. static void updateFrameCount() { sFrameCount++; }
  67. static U32  getFrameCount() { return sFrameCount; }
  68. static F32 getFrameDeltaTimeF32();
  69. // Return seconds since the current frame started
  70. static F32  getCurrentFrameTime();
  71. // MANIPULATORS
  72. void start();
  73. void stop();
  74. void reset();
  75. void resetWithExpiry(F32 expiration);
  76. void pause();
  77. void unpause();
  78. void setTimerExpirySec(F32 expiration);
  79. void setExpiryAt(F64 seconds_since_epoch);
  80. BOOL checkExpirationAndReset(F32 expiration);
  81. F32 getElapsedTimeAndResetF32()  { F32 t = F32(sFrameTime - mStartTime); reset(); return t; }
  82. void setAge(const F64 age) { mStartTime = sFrameTime - age; }
  83. // ACCESSORS
  84. BOOL hasExpired() const { return (sFrameTime >= mExpiry); }
  85. F32  getTimeToExpireF32() const { return (F32)(mExpiry - sFrameTime); }
  86. F32  getElapsedTimeF32() const { return mStarted ? (F32)(sFrameTime - mStartTime) : (F32)mStartTime; }
  87. BOOL getStarted() const { return mStarted; }
  88. // return the seconds since epoch when this timer will expire.
  89. F64 expiresAt() const;
  90. protected:
  91. // A single, high resolution timer that drives all LLFrameTimers
  92. // *NOTE: no longer used.
  93. //static LLTimer sInternalTimer;
  94. //
  95. // Aplication constants
  96. //
  97. // Start time of opp in usec since epoch
  98. static U64 sStartTotalTime;
  99. // 
  100. // Data updated per frame
  101. //
  102. // Seconds since application start
  103. static F64 sFrameTime;
  104. // Time that has elapsed since last call to updateFrameTime()
  105. static U64 sFrameDeltaTime;
  106. // Total microseconds since epoch.
  107. static U64 sTotalTime;
  108. // Seconds since epoch.
  109. static F64 sTotalSeconds;
  110. // Total number of frames elapsed in application
  111. static S32 sFrameCount;
  112. //
  113. // Member data
  114. //
  115. // Number of seconds after application start when this timer was
  116. // started. Set equal to sFrameTime when reset.
  117. F64 mStartTime;
  118. // Timer expires this many seconds after application start time.
  119. F64 mExpiry;
  120. // Useful bit of state usually associated with timers, but does
  121. // not affect actual functionality
  122. BOOL mStarted;
  123. };
  124. // Glue code for Havok (or anything else that doesn't want the full .h files)
  125. extern F32  getCurrentFrameTime();
  126. #endif  // LL_LLFRAMETIMER_H