This lab is only losely based on Chapter 8 on human interface devices in the text book. The focus here is on being able to control the on-screen character with a specialized game interface device.

Discussion thread for this lab is here: Lab 4 Discussion Thread

The primary goal of this lab is to hook a joypad game input device up to your Ogre application and use it to control both the character and the camera. This is also an opportunity to see how you set up buffered input (previously you've been using unbuffered input in this application).

No special preparation is required - preparing the joypad is explained in the project steps below.

Follow these steps to complete the lab project:

1. Create a New Project Create a new empty project called “Lab4” in the same way you have created new projectsfor other lab projects.
2. Move Character with Arrow Keys In the hand-out from Lab 1 you should now complete the then optional step 10: Controlling the model with the arrow keys. NOTE: Be aware that you have already made some changes to your code since Lab 1, you need to preserve those. For example, continue to pass your ogre entity into the MyFrameListener constructor, even if you now also have to pass your ogre node into the same constructor.
3. Adding Animation Continue with the hand-out from Lab 1 and now complete the then optional step 11: Adding Animation. Again make sure you preserve your prior code.
4. Plug in and Test Joypad Plug a USB joypad into your computer and find the device in your system's control panel (usually under “Devices and Printers”). Examine the device properties and find a small test panel for the device. Make sure the device works. Intall necessary drivers if the system is not picking it up.
5. Initialize Joystick Input Your MyFrameListener class needs to receive callbacks from the joystick device and therefore has to inherit joystick callback methods from an abstract class called OIS::JoyStickListener. Luckily you can inherit from multiple classes! Change your declaration of your MyFrameListener into this:

   class MyFrameListener : public Ogre::FrameListener, public OIS::JoyStickListener { 

   You then have to provide implementations of a few abstract callback methods:

   	bool axisMoved( const OIS::JoyStickEvent &e, int axis ) {
   		return true;
   	}
   	
   	bool buttonPressed( const OIS::JoyStickEvent &arg, int button ) {
   		return true;
   	};
   
   	bool buttonReleased( const OIS::JoyStickEvent &arg, int button ) {
   	        return true;
   	};
   
   	bool povMoved( const OIS::JoyStickEvent &arg, int pov ) {
   	        return true;
   	};

   In this class you need a new member variable to hold a pointer to a new joystick input object (e.g. OIS::JoyStick* _Joystick;) and then you have to create this object in your constructor. Because it is not guaranteed that the joypad is connected, you need to catch a possible exception upon creation and let the application gracefully continue even if the creation fails:

   		try {
   			_Joystick = static_cast<OIS::JoyStick*>(_InputManager->createInputObject( OIS::OISJoyStick, true ));
   			_Joystick->setEventCallback(this);
   			std::cout << "Successfuly created Joystick";
   		}
   		catch(...) {
   			std::cout << "Failed to initialize Joystick";
   			_Joystick = 0;
   		}

Upload your commented source files into Lab4 in MySchool (zip them up if more than one). The lab projects will not be graded, but their completion counts towards your participation grade.