How to Use

Setting up

First thing you'll have to do is to add the DLL to your references. You can do that by right clicking on "References" in the project explorer, selecting "Add Reference," and then browsing to the DLL. Now you can add the using directive ("using OXClib;") to the classes you want to use the controller in.

Initialization and Configuration

To initialize the OldGamePad controller, add "OldGamePad.Initialize(this) to the game's Initialize()-method.

protected override void Initialize() { OldGamePad.Initialize(this); ... base.Initialize(); }

After that the controller is ready to go and works very similar to the normal GamePad. But depending on the codec and controller settings, the button mapping might differ from user to user. This controller configuration can be set by accessing the config directly through OldGamePad.Config or by loading a config file.

protected override void Initialize() { OldGamePad.Initialize(this); OldGamePad.Config.DPadUp = 13; OldGamePad.Config.DPadDown = 14; OldGamePad.Config.DPadLeft = 15; OldGamePad.Config.DPadRight = 16; // if you initialize first, you can load a file like this OldGamePad.Config = new OldGamePadConfig("C://config.txt"); // or pass an OldGamePadConfig to the Initialization-method OldGamePadConfig config = new OldGamePadConfig("C://config.txt"); OldGamePad.Initialize(this, config); ... base.Initialize(); }

The config file's structure is pretty simple:

A:1 B:2 X:3 Y:4 Black:5 White:6 Start:9 Back:10 LeftStick:11 RightStick:12 DPadUp:13 DPadDown:14 DPadLeft:15 DPadRight:16 LeftShoulder:0 RightShoulder:0 LeftThumbStickUp:0 LeftThumbStickDown:0 LeftThumbStickLeft:0 LeftThumbStickRight:0 RightThumbStickUp:0 RightThumbStickDown:0 RightThumbStickLeft:0 RightThumbStickRight:0

All values not specified will be set to zero, so you don't have to include items that don't have a digital button state. This, by the way, is the standard configuration, which will be used if you don't change anything.

Using the Controller

The OldGamePad works pretty much the same way the normal GamePad does, so this part should be rather intuitive. Still, here's an example:

OldGamePadState previousState, currentState; Vector2 position; protected override void Update(GameTime gameTime) { previousState = currentState; currentState = OldGamePad.GetState(PlayerIndex.One, GamePadDeadZone.IndependentAxes); if (currentState.Buttons.Back == ButtonState.Pressed && previousState.Buttons.Back == ButtonState.Released) this.Exit(); position += OldGamePad.GetState(PlayerIndex.One).ThumbSticks.Left; ... }

Vibration

The vibration works slightly different than the GamePad's. For one thing, you currently can't apply individual speeds to the two motors, but you can set the duration of the vibration (in milliseconds). The default duration is 250ms.

OldGamePadState previousState, currentState; protected override void Update(GameTime gameTime) { previousState = currentState; currentState = OldGamePad.GetState(PlayerIndex.One); // creates a constant vibration when the A button is pressed if (currentState.Buttons.A == ButtonState.Pressed) OldGamePad.SetVibration(PlayerIndex.One, 0.5f); // creates a second long vibration every time the B button is pressed if (currentState.Buttons.B == ButtonState.Pressed && previousState.Buttons.B == ButtonState.Released) OldGamePad.SetVibration(PlayerIndex.One, 1f, 1000); ... }

Updating the Devices

In order for the OldGamePad to recognize new connections, it has to be updated. That happens automatically by default, but since this is a rather slow process, it only happens every 20 calls. This is a value that worked more than well for me, but if it should slow your game down or you want to shorten the delay, you can adjust it easily to your own value by specifing OldGamePad().UpdateInterval.

protected override void Initialize() { OldGamePad.Initialize(this); OldGamePad.UpdateInterval = 10; ... }

You can also disable automatic connection recognition and check manually by calling OldGamePad.Update() whenever you see fit.

protected override void Initialize() { OldGamePad.Initialize(this); // disabling automatic updates OldGamePad.UpdateInterval = 0; ... } protected override void Update(GameTime gameTime) { if (!OldGamePad.GetState(PlayerIndex.One).IsConnected) { OldGamePad.Update(); // Set GameState to ControllerDisconnected } ... }