OSCulator Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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.