DXUT框架剖析（12）

DXUT暂停函数

函数
描述

DXUTPause
将框架的内部计数器和（或）渲染过程设为暂停状态

DXUTRenderingPaused
检查当前设备的渲染状态是否处在暂停状态

DXUTIsTimePaused
检查当前设备的计时器是否处在暂停状态

DXUTPause

Sets the paused state of DXUT internal timer and/or rendering process.

  VOID DXUTPause(  
   BOOL    bPauseTime    ,  
   BOOL    bPauseRendering  
   )  ;

Parameters

bPauseTime

[in] If TRUE, DXUT internal timer is paused. If FALSE, the timer is resumed from a paused state. See Remarks.

bPauseRendering

[in] If TRUE, DXUT will not call the LPDXUTCALLBACKD3D10FRAMERENDER callback function; DXUT will continue to call the LPDXUTCALLBACKFRAMEMOVE callback function. If FALSE, rendering will resume from a paused state. See Remarks.

Return Values

No return value.

Remarks

The timer controls the fTime and fElapsedTime parameters passed to the LPDXUTCALLBACKFRAMEMOVE or render callback functions.

When time is paused, fTime will remain unchanged and fElapsedTime will be 0.0f. The LPDXUTCALLBACKFRAMEMOVE and the render callback functions will still be called. This allows a camera to still move while time is paused.

When rendering is paused, the render callback function and the Direct3D Present method will not be called, and DXUT will periodically yield time to other processes by calling Sleep.

DXUTIsRenderingPaused

Indicates whether rendering has been paused in DXUT.

  BOOL DXUTIsRenderingPaused()  ;

Parameters

None.

Return Values

TRUE if rendering has been paused in DXUT.

DXUTIsTimePaused

Indicates whether time has been paused in DXUT.

  BOOL DXUTIsTimePaused()  ;

Parameters

None.

Return Values

TRUE if time has been paused in DXUT.

DXUT用户输入函数

函数
描述

DXUTIsKeyDown
检查当该函数调用时，键盘上指定的某个键是否按下。

DXUTIsMouseButtonDown
检查当该函数调用时，指定的鼠标键是否按下。

DXUTIsKeyDown

Indicates whether a specified keyboard key is up or down at the time the function is called.

  BOOL DXUTIsKeyDown(  
   BYTE    vKey  
   )  ;

Parameters

vKey

[in] Virtual key code of a keyboard key. For example VK_F1, VK_LSHIFT, VK_RCONTROL, VK_RMENU, and 41 (representing the 'A' key).

Return Values

TRUE if the specified vKey keyboard key is down; FALSE otherwise.

DXUTIsMouseButtonDown

Indicates whether a specified mouse button is up or down at the time the function is called.

  BOOL DXUTIsMouseButtonDown(  
   BYTE    vButton  
   )  ;

Parameters

vButton

[in] Virtual key code of a mouse button. Allowed values are VK_LBUTTON, VK_RBUTTON, VK_MBUTTON, VK_XBUTTON1, and VK_XBUTTON2.

Return Values

TRUE if the specified vButton mouse button is down; FALSE otherwise.