SimWinGamePad 1.2.1

SimWinGamePad

Usage

Install SimWinGamePad via NuGet or pull the source and add a project reference.

Before issuing other commands, call SimGamePad.Instance.Initialize().

Upon first initialization on a given PC, the user may be prompted to accept automatic installation of the ScpVBus driver required to simulate Xbox 360 GamePads attached to Windows. (This is accomplished via the ScpDriverInterface installer, which is now an embedded resource in SimWinInput and extracted at runtime as needed. Thus you no longer need to explicitly include the installer executable with your own application/installers.) Recovery from missing driver requires neither reboot nor app restart, but Initialize will throw an exception if something prevents success (such as the user declining the prompt or UAC elevation for the installer).

There can be up to four simulated GamePads, but they do not start plugged in. To plug one in as the first GamePad:

SimGamePad.Instance.PlugIn();

Then, to simulate pressing the 'A' button on the GamePad for a moment, before releasing it:

SimGamePad.Instance.Use(GamePadControl.A);

Even the analog controls can be simulated into maximum state for a moment, before returning them to their default, unheld positions:

// Pull and release the left trigger.
SimGamePad.Instance.Use(GamePadControl.LeftTrigger);
// Move the right analog stick into the leftmost position, then return to neutral position.
SimGamePad.Instance.Use(GamePadControl.RightStickLeft);

To unplug the virtual GamePad:

SimGamePad.Instance.Unplug();

When exiting the program, you should always call SimGamePad.Instance.ShutDown(). This will unplug any remaining simulated GamePads and clean up any utilized resources, such as disposing the driver.

Intermediate GamePad Simulation

Should you need more than one GamePad simulated, each command can optionally specify an index from 0 to 3 for which one to drive. You can also specify hold times (in milliseconds) if the default is not suitable for your needs:

SimGamePad.Instance.Use(GamePadControl.LeftTrigger, 2, 500);

You can use GamePadControl as flags to designate multiple controls to use at the same time. You can also simulate controls in a held position until later asking to release them. This example demonstrates both:

SimGamePad.Instance.SetControl(GamePadControl.RightTrigger | GamePadControl.RightBumper);
...
SimGamePad.Instance.ReleaseControl(GamePadControl.RightTrigger | GamePadControl.RightBumper);

Advanced GamePad Simulation

For more advanced scenarios, you can exercise full control over all analog controls and buttons, including the guide button, by modifying and managing state updates manually. For example:

// Get a reference to the state of the first GamePad:
var simPad = SimGamePad.Instance;
var state = simPad.State[0];
// Pull the left trigger halfway back:
state.LeftTrigger = 127;
// Move the right analog stick three quarters of the way to the left:
state.RightStickX = short.MinValue * 3 / 4;
// Add the RightBumber to the set of held buttons:
state.Buttons |= GamePadControl.RightShoulder;
// Update the driver's simulated state with the above state changes:
simPad.Update(0);
...
// Reset the GamePad to the natural at-rest state:
state.Reset();
simPad.Update();