User Tools

Site Tools


manual:hid_output

HID Output

Virtual Joystick

HID stands for Human Interface Device. It is a protocol used by many USB controllers, like Mice, Keyboards, or Joysticks, but also games softwares and Quartz Composer which is a great application for creating visual effects and animations1).

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

HID Joystick Event

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

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

There are three types of values you can choose from:

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.
1)
this application is bundled with the Apple Developer tools you can get freely from the Apple website.
manual/hid_output.txt · Last modified: 2009/06/04 01:42 by camille