Ogre Timer
一个图形绘制引擎底层有很多工具类(utility),通过读基础工具类源码可以学习到不少东西。
Ogre引擎中与Timer相关的文件大致不多,大致如下(只列出头文件)
WIN32/OgreTimerImp.h
GLX/OgreTimerImp.h
OSX/OgreTimerImp.h
iPhone/OgreTimerImp.h
OgreTimer.h
其实这部分代码很少,真正意义上的头文件就是OgreTimer.h,以下是这个头文件的全部了.
1 | #if OGRE_PLATFORM == OGRE_PLATFORM_WIN32 |
2 | # include "WIN32/OgreTimerImp.h" |
3 | #elif (OGRE_PLATFORM == OGRE_PLATFORM_LINUX) || (OGRE_PLATFORM == OGRE_PLATFORM_SYMBIAN) |
4 | # include "GLX/OgreTimerImp.h" |
5 | #elif OGRE_PLATFORM == OGRE_PLATFORM_APPLE |
6 | # include "OSX/OgreTimerImp.h" |
7 | #elif OGRE_PLATFORM == OGRE_PLATFORM_IPHONE |
8 | # include "iPhone/OgreTimerImp.h" |
看明白了么?很简单,根据OGRE_PLATFORM宏,选择包含相应平台的Timer实现头文件。如win32下,OgreTimer.h就简单地include WIN32/OgreTimerImp.h就可以了。OgreTimerImp.h中就是Timer的定义了。(下面的源码都以win32平台的Timer为例)
成员变量
4 | LARGE_INTEGER mStartTime; |
5 | LARGE_INTEGER mFrequency; |
(1)mZeroClock
程序启动后所执行的时间。
clock函数返回进程启动后的执行时间,表示方法是CPU的tick数(也俗称滴答数)。笔者的环境是vs2008,宏CLOCKS_PER_SEC的定义是1000,也就是说一个滴答数大致1/1000秒。用mZeroClock乘以这个0.001秒就可以得到进程启动后的运行时间了,当然在计算的时候只计算tick数就足够了。
(2)mStartTick
系统启动后所经历的时间,时间单位是毫秒。
1 | mStartTick = GetTickCount(); |
(3)mLastTime
在调用读取时间函数 unsigned long getMilliseconds() / unsigned long getMicroseconds() 后记录当前读取的最后时间,作用是当下一次时间读取错误时,进行调整。(关于时间读取错误后面会有展开。)
(4)mStartTime / mFrequency
用于高精度计时器时间读取 分别通过函数QueryPerformanceCounter和QueryPerformanceFrequency获得count数以及frequency。这里需要注意的是,Timer里应用两套计时度量方法。
一套是通过使用clock()获得cpu中时钟tick,在获取时间时,使用的api如下
1 | unsigned long getMillisecondsCPU(); |
2 | unsigned long getMicrosecondsCPU(); |
另一种就是高精度计时器函数,api如下
1 | unsigned long getMilliseconds(); |
2 | unsigned long getMicroseconds(); |
在后面会讨论下这些api值得关注的细节。
(5)mTimerMask
这个变量看名字有点不明白,其实这个变量和高精度计时器读取时间有关。查询msdn中QueryPerformanceCounter函数的注解中可以发现,这个函数调用环境如果是多处理器(CPU)的话,由于BIOS或者HAL的原因,切换到不同CPU上的线程调用后会造成不正确的结果。所以必须保证每次调用这个函数都是在同一个CPU上进行。这个mask就是将线程调用限定在某一个CPU上。
01 | HANDLE thread = GetCurrentThread(); |
04 | DWORD_PTR oldMask = SetThreadAffinityMask( thread , mTimerMask); |
07 | QueryPerformanceFrequency(&mFrequency); |
10 | QueryPerformanceCounter(&mStartTime); |
11 | mStartTick = GetTickCount(); |
14 | SetThreadAffinityMask( thread , oldMask); |
通过SetThreadAffinityMask函数,设置允许执行本线程的CPU标示位,就可以达到这一目的。每次时间获取都在限定处理器上执行,执行完后恢复oldMask即可。
成员函数
01 | bool setOption( const String& strKey, const void * pValue ); |
07 | unsigned long getMilliseconds(); |
10 | unsigned long getMicroseconds(); |
13 | unsigned long getMillisecondsCPU(); |
16 | unsigned long getMicrosecondsCPU(); |
注:此处省略了构造函数和析构函数,构造函数就简单调用reset函数,析构函数为空函数
(1) bool setOption( const String& strKey, const void* pValue )
这个函数的作用是设置mTimerMask,方法是通过GetProcessAffinityMask()获取能够执行程序的CPU标示,以mask形式给出,然后取最低标示位标示的CPU作为mTimerMask的值,作为限定CPU执行高精度计时读取。这个函数在Ogre中并没有被调用,mTimerMask在构造函数中初始化为0,并在reset函数中有进一步的赋值。
(2)void reset()
顾名思义,重置一次计时状态,也用于第一次Timer的初始化。这个函数主要做两件事情:
1、设置mTimerMask
04 | GetProcessAffinityMask(GetCurrentProcess(), &procMask, &sysMask); |
10 | while ( ( mTimerMask & procMask ) == 0 ) |
设置的过程在讲解(5)mTimerMask已经提及,不再赘述。
2、在两种度量方法下,读取当前时间
01 | HANDLE thread = GetCurrentThread(); |
04 | DWORD_PTR oldMask = SetThreadAffinityMask( thread , mTimerMask); |
07 | QueryPerformanceFrequency(&mFrequency); |
10 | QueryPerformanceCounter(&mStartTime); |
12 | mStartTick = GetTickCount(); |
15 | SetThreadAffinityMask( thread , oldMask); |
可以看到使用上面提到过的方式,将CPU限定后,读取了两种度量下的时间,并将所有成员变量进行初始化。
(3)时间读取函数
剩下四个函数就是两套度量方式读取时间的函数,每套方式有读取毫秒和百分之一秒两个API。两种度量方式也已经提到过,这里讲下各自的方法。
1、CPU tick度量
基本一句代码就可以实现,就是通过clock读取当前的tick数,减去Timer初始化的mZeroClock就可以得到毫秒数,并不需要进行CPU限定。
2、高精度计时器度量
这个度量步骤和CPU度量相似,在CPU限定的情况下,读取count数,进行相减。但是这里有个需要提及,就是在讲成员变量mLastTime时提到的错误时间调整。
通过查询Microsoft KB: Q274323,由于芯片组的设计缺陷,QueryPerformanceCounter函数返回的结果会意外的产生跳跃的错误时间。这也就是不能单独使用高精度计时器的原因,必须有另一个计时方法来进行补偿调整。
01 | unsigned long check = GetTickCount() - mStartTick; |
02 | signed long msecOff = ( signed long )(newTicks - check); |
03 | if (msecOff < -100 || msecOff > 100) |
05 | LONGLONG adjust = (std::min)(msecOff * mFrequency.QuadPart / 1000, newTime - mLastTime); |
06 | mStartTime.QuadPart += adjust; |
10 | newTicks = (unsigned long ) (1000 * newTime / mFrequency.QuadPart); |
这个是读取完高精度时间后需要进行的检验。check变量是CPU tick度量方式得到的时间,然后将两种方式得到的时间相减,检查这个差值的绝对值,如果过大就需要进行调整。然后重新计算newTick就可以了。