Class | Rubygame::Joystick |
In: |
ext/rubygame/rubygame_mixer.c
|
Parent: | Object |
The Joystick class interfaces with joysticks, gamepads, and other similar hardware devices used to play games. Each joystick may have zero or more axes, balls, hats, and/or buttons.
After a Joystick object is successfully created, events for that Joystick will begin appearing on the EventQueue when a button is pressed or released, a control stick is moved, etc.
You can use Joystick.activate_all to start receiving events for all joysticks (equivalent to creating them all individually with Joystick.new). You can use Joystick.deactivate_all to stop receiving events for all joysticks.
As of Rubygame 2.4, these are the current, "new-style" Joystick event classes:
These old Joystick-related events are deprecated and will be removed in Rubygame 3.0:
For more information about "new-style" events, see EventQueue.enable_new_style_events.
Activate all joysticks on the system, equivalent to calling Joystick.new for every joystick available. This will allow joystick-related events to be sent to the EventQueue for all joysticks.
Returns: | Array of zero or more Joysticks. |
Deactivate all joysticks on the system. This will stop all joystick-related events from being sent to the EventQueue.
Create and initialize an interface to the nth joystick on the system. Raises SDLError if the joystick could not be opened.