Spaces:
Runtime error
Runtime error
File size: 6,247 Bytes
d82cf6a |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 |
"""Joystick, Game Controller, Tablet and USB HID device support.
This module provides a unified interface to almost any input device, besides
the regular mouse and keyboard support provided by
:py:class:`~pyglet.window.Window`. At the lowest
level, :py:func:`get_devices` can be used to retrieve a list of all supported
devices, including joysticks, tablets, space controllers, wheels, pedals, remote
controls, keyboards and mice. The set of returned devices varies greatly
depending on the operating system (and, of course, what's plugged in).
At this level pyglet does not try to interpret *what* a particular device is,
merely what controls it provides. A :py:class:`Control` can be either a button,
whose value is either ``True`` or ``False``, or a relative or absolute-valued
axis, whose value is a float. Sometimes the name of a control can be provided
(for example, ``x``, representing the horizontal axis of a joystick), but often
not. In these cases the device API may still be useful -- the user will have
to be asked to press each button in turn or move each axis separately to
identify them.
Higher-level interfaces are provided for joysticks, game controllers, tablets
and the Apple remote control. These devices can usually be identified by pyglet
positively, and a base level of functionality for each one provided through a
common interface.
To use an input device:
1. Call :py:func:`get_devices`, :py:func:`get_apple_remote`,
:py:func:`get_controllers` or :py:func:`get_joysticks` to retrieve and
identify the device.
2. For low-level devices (retrieved by :py:func:`get_devices`), query the
devices list of controls and determine which ones you are interested in. For
high-level interfaces the set of controls is provided by the interface.
3. Optionally attach event handlers to controls on the device. For high-level
interfaces, additional events are available.
4. Call :py:meth:`Device.open` to begin receiving events on the device. You can
begin querying the control values after this time; they will be updated
asynchronously.
5. Call :py:meth:`Device.close` when you are finished with the device (not
needed if your application quits at this time).
To use a tablet, follow the procedure above using :py:func:`get_tablets`, but
note that no control list is available; instead, calling :py:meth:`Tablet.open`
returns a :py:class:`TabletCanvas` onto which you should set your event
handlers.
For game controllers, the :py:class:`ControllerManager` is available. This
provides a convenient way to handle hot-plugging of controllers.
.. versionadded:: 1.2
"""
import sys
import pyglet
from .base import Device, Control, RelativeAxis, AbsoluteAxis, ControllerManager
from .base import Button, Joystick, AppleRemote, Tablet, Controller
from .base import DeviceException, DeviceOpenException, DeviceExclusiveException
_is_pyglet_doc_run = hasattr(sys, "is_pyglet_doc_run") and sys.is_pyglet_doc_run
def get_apple_remote(display=None):
"""Get the Apple remote control device.
The Apple remote is the small white 6-button remote control that
accompanies most recent Apple desktops and laptops. The remote can only
be used with Mac OS X.
:Parameters:
display : `~pyglet.canvas.Display`
Currently ignored.
:rtype: AppleRemote
:return: The remote device, or `None` if the computer does not support it.
"""
return None
if _is_pyglet_doc_run:
def get_devices(display=None):
"""Get a list of all attached input devices.
:Parameters:
display : `~pyglet.canvas.Display`
The display device to query for input devices. Ignored on Mac
OS X and Windows. On Linux, defaults to the default display
device.
:rtype: list of :py:class:`Device`
"""
def get_joysticks(display=None):
"""Get a list of attached joysticks.
:Parameters:
display : `~pyglet.canvas.Display`
The display device to query for input devices. Ignored on Mac
OS X and Windows. On Linux, defaults to the default display
device.
:rtype: list of :py:class:`Joystick`
"""
def get_controllers(display=None):
"""Get a list of attached controllers.
:Parameters:
display : `~pyglet.canvas.Display`
The display device to query for input devices. Ignored on Mac
OS X and Windows. On Linux, defaults to the default display
device.
:rtype: list of :py:class:`Controller`
"""
def get_tablets(display=None):
"""Get a list of tablets.
This function may return a valid tablet device even if one is not
attached (for example, it is not possible on Mac OS X to determine if
a tablet device is connected). Despite returning a list of tablets,
pyglet does not currently support multiple tablets, and the behaviour
is undefined if more than one is attached.
:Parameters:
display : `~pyglet.canvas.Display`
The display device to query for input devices. Ignored on Mac
OS X and Windows. On Linux, defaults to the default display
device.
:rtype: list of :py:class:`Tablet`
"""
else:
from pyglet import compat_platform
if compat_platform.startswith('linux'):
from .linux import get_devices
from .linux import get_joysticks
from .linux import get_controllers
from .linux import get_tablets
from .linux import ControllerManager
elif compat_platform in ('cygwin', 'win32'):
from .win32 import get_devices
from .win32 import get_joysticks
from .win32 import get_controllers
from .win32 import get_tablets
from .win32 import Win32ControllerManager as ControllerManager
elif compat_platform == 'darwin':
from .macos import get_devices
from .macos import get_joysticks
from .macos import get_apple_remote
from .macos import get_controllers
from .macos import get_tablets
from .macos import ControllerManager
|