OGRE一起学(十五) 键盘控制
第十五章 键盘控制
这一节我们学习最基本的键盘控制。下面是截图和代码，你可以使用 [I] 、[K] 、[J] 、[L] 控制角色的前后左右移动。
OGRE 使用 InputReader 类来接收系统输入信息，包括键盘输入和鼠标输入。 Ogre::InputReader 类在头文件 OgreInput.h 中定义，对于键盘控制，我们最常用的一个方法是 isKeyDown ：
bool Ogre::InputReader:: isKeyDown ( KeyCode kc ) const [virtual]
当 KeyCode kc 指定的键被按下时返回真。
其中， KeyCode 的枚举也在头文件 OgreInput.h 中定义：
enum KeyCode { KC_ESCAPE =0x01, KC_1 =0x02, KC_2 =0x03, KC_3 =0x04, KC_4 =0x05, KC_5 =0x06, KC_6 =0x07, KC_7 =0x08, KC_8 =0x09, KC_9 =0x0A, KC_0 =0x0B, KC_MINUS =0x0C, /* - on main keyboard */ KC_EQUALS =0x0D, KC_BACK =0x0E, /* backspace */ KC_TAB =0x0F, KC_Q =0x10, KC_W =0x11, KC_E =0x12, KC_R =0x13, KC_T =0x14, KC_Y =0x15, KC_U =0x16, KC_I =0x17, KC_O =0x18, KC_P =0x19, KC_LBRACKET =0x1A, KC_RBRACKET =0x1B, KC_RETURN =0x1C, /* Enter on main keyboard */ KC_LCONTROL =0x1D, KC_A =0x1E, KC_S =0x1F, KC_D =0x20, KC_F =0x21, KC_G =0x22, KC_H =0x23, KC_J =0x24, KC_K =0x25, KC_L =0x26, KC_SEMICOLON =0x27, KC_APOSTROPHE =0x28, KC_GRAVE =0x29, /* accent grave */ KC_LSHIFT =0x2A, KC_BACKSLASH =0x2B, KC_Z =0x2C, KC_X =0x2D, KC_C =0x2E, KC_V =0x2F, KC_B =0x30, KC_N =0x31, KC_M =0x32, KC_COMMA =0x33, KC_PERIOD =0x34, /* . on main keyboard */ KC_SLASH =0x35, /* ''/'' on main keyboard */ KC_RSHIFT =0x36, KC_MULTIPLY =0x37, /* * on numeric keypad */ KC_LMENU =0x38, /* left Alt */ KC_SPACE =0x39, KC_CAPITAL =0x3A, KC_F1 =0x3B, KC_F2 =0x3C, KC_F3 =0x3D, KC_F4 =0x3E, KC_F5 =0x3F, KC_F6 =0x40, KC_F7 =0x41, KC_F8 =0x42, KC_F9 =0x43, KC_F10 =0x44, KC_NUMLOCK =0x45, KC_SCROLL =0x46, /* Scroll Lock */ KC_NUMPAD7 =0x47, KC_NUMPAD8 =0x48, KC_NUMPAD9 =0x49, KC_SUBTRACT =0x4A, /* - on numeric keypad */ KC_NUMPAD4 =0x4B, KC_NUMPAD5 =0x4C, KC_NUMPAD6 =0x4D, KC_ADD =0x4E, /* + on numeric keypad */ KC_NUMPAD1 =0x4F, KC_NUMPAD2 =0x50, KC_NUMPAD3 =0x51, KC_NUMPAD0 =0x52, KC_DECIMAL =0x53, /* . on numeric keypad */ KC_OEM_102 =0x56, /*
<
>
| on UK/Germany keyboards */ KC_F11 =0x57, KC_F12 =0x58, KC_F13 =0x64, /* (NEC PC98) */ KC_F14 =0x65, /* (NEC PC98) */ KC_F15 =0x66, /* (NEC PC98) */ KC_KANA =0x70, /* (Japanese keyboard) */ KC_ABNT_C1 =0x73, /* / ? on Portugese (Brazilian) keyboards */ KC_CONVERT =0x79, /* (Japanese keyboard) */ KC_NOCONVERT =0x7B, /* (Japanese keyboard) */ KC_YEN =0x7D, /* (Japanese keyboard) */ KC_ABNT_C2 =0x7E, /* Numpad . on Portugese (Brazilian) keyboards */ KC_NUMPADEQUALS =0x8D, /* = on numeric keypad (NEC PC98) */ KC_PREVTRACK =0x90, /* Previous Track (KC_CIRCUMFLEX on Japanese keyboard) */ KC_AT =0x91, /* (NEC PC98) */ KC_COLON =0x92, /* (NEC PC98) */ KC_UNDERLINE =0x93, /* (NEC PC98) */ KC_KANJI =0x94, /* (Japanese keyboard) */ KC_STOP =0x95, /* (NEC PC98) */ KC_AX =0x96, /* (Japan AX) */ KC_UNLABELED =0x97, /* (J3100) */ KC_NEXTTRACK =0x99, /* Next Track */ KC_NUMPADENTER =0x9C, /* Enter on numeric keypad */ KC_RCONTROL =0x9D, KC_MUTE =0xA0, /* Mute */ KC_CALCULATOR =0xA1, /* Calculator */ KC_PLAYPAUSE =0xA2, /* Play / Pause */ KC_MEDIASTOP =0xA4, /* Media Stop */ KC_VOLUMEDOWN =0xAE, /* Volume - */ KC_VOLUMEUP =0xB0, /* Volume + */ KC_WEBHOME =0xB2, /* Web home */ KC_NUMPADCOMMA =0xB3, /* , on numeric keypad (NEC PC98) */ KC_DIVIDE =0xB5, /* / on numeric keypad */ KC_SYSRQ =0xB7, KC_RMENU =0xB8, /* right Alt */ KC_PAUSE =0xC5, /* Pause */ KC_HOME =0xC7, /* Home on arrow keypad */ KC_UP =0xC8, /* UpArrow on arrow keypad */ KC_PGUP =0xC9, /* PgUp on arrow keypad */ KC_LEFT =0xCB, /* LeftArrow on arrow keypad */ KC_RIGHT =0xCD, /* RightArrow on arrow keypad */ KC_END =0xCF, /* End on arrow keypad */ KC_DOWN =0xD0, /* DownArrow on arrow keypad */ KC_PGDOWN =0xD1, /* PgDn on arrow keypad */ KC_INSERT =0xD2, /* Insert on arrow keypad */ KC_DELETE =0xD3, /* Delete on arrow keypad */ KC_LWIN =0xDB, /* Left Windows key */ KC_RWIN =0xDC, /* Right Windows key */ KC_APPS =0xDD, /* AppMenu key */ KC_POWER =0xDE, /* System Power */ KC_SLEEP =0xDF, /* System Sleep */ KC_WAKE =0xE3, /* System Wake */ KC_WEBSEARCH =0xE5, /* Web Search */ KC_WEBFAVORITES =0xE6, /* Web Favorites */ KC_WEBREFRESH =0xE7, /* Web Refresh */ KC_WEBSTOP =0xE8, /* Web Stop */ KC_WEBFORWARD =0xE9, /* Web Forward */ KC_WEBBACK =0xEA, /* Web Back */ KC_MYCOMPUTER =0xEB, /* My Computer */ KC_MAIL =0xEC, /* Mail */ KC_MEDIASELECT =0xED /* Media Select */ };
下面分析源代码。
我们需要控制的角色节点，在方法
void KeyboardApplication::createScene( void )
中建立：
// 创建模型实体 Entity* entObject = mSceneMgr->createEntity( "object", "ninja.mesh" ); entObject->setCastShadows( true ); SceneNode* objectNode = rootNode->createChildSceneNode( "objectNode" ); objectNode->attachObject( entObject ); objectNode->setPosition( Vector3( 0, -27, 0 ) );
注意其中这一句：
SceneNode* objectNode = rootNode->createChildSceneNode( "objectNode" );
我们在创建这个场景节点的时候，在括号里顺手为它起了一个名字叫作 "objectNode" ，这是有用处的，以后我们就可以根据这个名字，使用
SceneNode * Ogre::SceneManager:: getSceneNode ( const String & name ) const [virtual]
通过提供场景节点的名字来获取这个场景节点。
因为 SceneManager* mSceneMgr 是应用程序类 Ogre:: ExampleApplication 的保护成员，而我们要控制角色节点的移动，必须在帧监听器类 Ogre:: ExampleFrameListener 中逐帧控制，所以我们必须从 ExampleApplication 向 ExampleFrameListener 传递 mSceneMgr 实例参数。总体说来我们需要这样做：
(1) 在
void KeyboardApplication::createScene( void )
方法中，为角色实体建立并绑定场景到一个节点，并赋予这个场景节点一个唯一的名字；
(2) 在
void KeyboardApplication::createFrameListener( void )
方法中，新建帧监听器实例并向其传递 mSceneMgr ：
// 新建帧监听器实例 mFrameListener= new KeyboardFrameListener( mWindow, mCamera, mSceneMgr ); mRoot->addFrameListener( mFrameListener ); // 添加帧监听器到根节点
(3) 重载 KeyboardFrameListener 的构造函数并接收上一步传递过来的 mSceneMgr 实例参数：
KeyboardFrameListener::KeyboardFrameListener( RenderWindow* win, Camera* cam, SceneManager* sm ) : ExampleFrameListener( win, cam ), mSceneMgr( sm ) { }
(4) 使用
SceneNode * Ogre::SceneManager:: getSceneNode ( const String & name ) const [virtual]
方法，使用角色场景节点的名字来获取这个场景节点：
mSceneNode = mSceneMgr->getSceneNode( "objectNode" ); // 获取角色对象的场景节点
然后嘛，我们就可以对这个场景节点为所欲为了。
我们要在每帧实时控制场景管理器或场景节点的属性，都可以使用这个通用方法。只要我们在帧监听器类中获取了场景节点的实例 mSceneMgr ，我们就可以使用 Ogre::SceneManager 中的大量 get 方法，例如：
virtual Camera * getCamera (const String &name) // 获取摄像机 virtual Light * getLight (const String &name) // 获取光源 virtual Material * getMaterial (const String &name) // 获取材质 virtual SceneNode * getRootSceneNode (void) const // 获取场景根节点 virtual SceneNode * getSceneNode (const String &name) const // 获取场景节点 virtual Entity * getEntity (const String &name) // 获取实体 virtual BillboardSet * getBillboardSet (const String &name) // 获取公告板集 virtual Animation * getAnimation (const String &name) const // 获取动画 virtual AnimationState * getAnimationState (const String &animName) // 获取动画状态 virtual Overlay * getOverlay (const String &name) // 获取盖层(界面)
来获取场景中的任意实例。条件就是你在创建这些实例的时候务必要顺手给它起个名字，方便以后按名字查找。
最后是 static Real timeDelay (时间延迟) 这个静态变量的作用，用来控制接收键盘输入的时间间隔。因为如果我们不去控制每隔多长时间移动一次的话，角色就每帧移动一次，这样，在帧数 FPS 很高的时候它就移动得很快，在 FPS 低的时候它就移动得很慢，我们无法预料客户机的 FPS ，所以如果不使用这个 timeDelay ，我们无法控制角色的实际移动速度。
时间延迟的每帧刷新使用下面的代码：
if (timeDelay >= 0) timeDelay -= evt.timeSinceLastFrame; // 时间延迟 -= 从上次调用时到现在所经历的时间
然后每接收一次键盘输入就使时间延迟重新倒数：
if (mInputDevice->isKeyDown( KC_I ) && timeDelay <= 0) { mSceneNode->translate( Vector3( 0, 0, -walkSpeed ) ); timeDelay = 0.02; }
timeSinceLastFrame 是 Ogre:: FrameEvent 的数据成员，在头文件 OgreFrameListener.h 中定义，单位是秒：
Real Ogre::FrameEvent::timeSinceLastFrame
这个数据成员记录的是：上一次访问 FrameEvent::timeSinceLastFrame 属性到现在的时间差(秒)。