vjoy-sys 0.2.0

Rust bindings to vJoy - a virtual input device driver for Windows
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
## vjoy-sys

Rust bindings to [vJoy](https://sourceforge.net/projects/vjoystick/) via bindgen.
Built against version 2.1.9.1-160719.

## About vJoy

vJoy simulates up to 16 input devices with up to 128 buttons, 8 axes, and 4 hat switches.
The virtual devices can be used to 
1) Emulate gamepads/joysticks for older games that require a specific kind of input.
2) Combine multiple physical devices into one virtual.
3) Apply transformations from a physical device to a virtual device (e.g. 2-button to axis rebind, software filtering etc.).

## Usage

The [vJoy driver](https://sourceforge.net/projects/vjoystick/) needs to be installed and is only available for Windows.

The vJoy shared library is loaded at runtime via libloading. See the [sanity test](tests/test.rs) for specifics.

## Updating bindings

For a new version of vJoy, the header files in /vjoy have be replaced and may have to be modified (e.g. search and replace "BOOL" with "int", insert "enum" keyword, remove unused includes etc.) to work with bindgen - as of this verison the original C headers resulted in various bindgen errors during build.