SCA_PythonJoystick(EXP_PyObjectPlus)

base class — EXP_PyObjectPlus

class bge.types.SCA_PythonJoystick(EXP_PyObjectPlus)

A Python interface to a joystick.

name

The name assigned to the joystick by the operating system. (read-only)

Type: string

activeButtons

A list of active button values. (read-only)

Type: list

axisValues

The state of the joysticks axis as a list of values numAxis long. (read-only).

Type: list of ints.

Each specifying the value of an axis between -1.0 and 1.0 depending on how far the axis is pushed, 0 for nothing. The first 2 values are used by most joysticks and gamepads for directional control. 3rd and 4th values are only on some joysticks and can be used for arbitary controls.

left:[-1.0, 0.0, …]
right:[1.0, 0.0, …]
up:[0.0, -1.0, …]
down:[0.0, 1.0, …]

hatValues: Deprecated since version 0.2.2: Use activeButtons instead.

numAxis

The number of axes for the joystick at this index. (read-only).

Type: integer

numButtons

The number of buttons for the joystick at this index. (read-only).

Type: integer

numHats: Deprecated since version 0.2.2: Use numButtons instead.

startVibration()

Starts the vibration.

Returns: None

stopVibration()

Stops the vibration.

Returns: None

strengthLeft

Strength of the Low frequency joystick’s motor (placed at left position usually).

Type: float (0.0 to 1.0)

strengthRight

Strength of the High frequency joystick’s motor (placed at right position usually).

Type: float (0.0 to 1.0)

duration

Duration of the vibration in milliseconds.

Type: integer (0 to infinite)

isVibrating

Check status of joystick vibration

Type: bool (true vibrating and false stopped)

hasVibration

Check if the joystick supports vibration

Type: bool (true supported and false not supported)