1. Virtual HID

HID (Human Interface Device) is a protocol used by many USB controllers, like Mice, Keyboards, or Joysticks.

Just like MIDI is used to control MIDI enabled software or devices, the HID protocol can be used as an input for softwares that are HID enabled, such as games, emulators, VJ apps, or the graphical suite Quartz Composer.

OSCulator creates two fake (or virtual) HID controllers that can be used by those applications. The OSC messages sent to OSCulator are used to drive those virtual devices.

2. HID Joystick Event Type

To control a virtual joystick, you need to assign a joystick control (button, axis, etc.) to a OSC message. To do this, in the main window, select "HID Joystick" as Event Type, and choose a item in the Value column.

OSCulator exposes two virtual joysticks "OSCulator HID 1" and "OSCulator HID 2". You can select them by choosing the right value in the Channel column, just like MIDI channels. For example, a value of Button-1 with channel 2 will control the button 1 of the virtual joystick named "OSCulator HID 2".

You can choose between three types of values:

Button
There are independant 16 buttons. A button can only have a value of 0 or 1 (depressed or pressed).
Button (Analog)
There are 4 independant analog buttons. An analog button is like a button but with all the steps in between. This is useful for games that can use analog buttons as an input.
Axis
There are 2 sets of two axes (X & Y). For X, a value is full left, and 1 is full right. For Y axes, 0 is down, and 1 is up.

<< Mouse | UsersManual | Applescript >>