User Tools

Site Tools


manual:hid_output

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

manual:hid_output [2009/06/04 01:42] (current)
camille created
Line 1: Line 1:
 +====== 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 animations((this application is bundled with the Apple Developer tools you can get freely from the Apple website.)).
 +
 +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.
  
manual/hid_output.txt ยท Last modified: 2009/06/04 01:42 by camille