Struct sdl2::joystick::Joystick[−][src]

pub struct Joystick { /* fields omitted */ }

Expand description

Wrapper around the SDL_Joystick object

Implementations

[src]

impl Joystick

[src]

pub const fn subsystem(&self) -> &JoystickSubsystem

[src]

pub fn name(&self) -> String

Return the name of the joystick or an empty string if no name is found.

[src]

pub fn attached(&self) -> bool

Return true if the joystick has been opened and currently connected.

[src]

pub fn instance_id(&self) -> u32

[src]

pub fn guid(&self) -> Guid

Retrieve the joystick’s GUID

[src]

pub fn power_level(&self) -> Result<PowerLevel, IntegerOrSdlError>

Retrieve the battery level of this joystick

[src]

pub fn num_axes(&self) -> u32

Retrieve the number of axes for this joystick

[src]

pub fn axis(&self, axis: u32) -> Result<i16, IntegerOrSdlError>

Gets the position of the given axis.

The function will fail if the joystick doesn’t have the provided axis.

[src]

pub fn num_buttons(&self) -> u32

Retrieve the number of buttons for this joystick

[src]

pub fn button(&self, button: u32) -> Result<bool, IntegerOrSdlError>

Return Ok(true) if button is pressed.

The function will fail if the joystick doesn’t have the provided button.

[src]

pub fn num_balls(&self) -> u32

Retrieve the number of balls for this joystick

[src]

pub fn ball(&self, ball: u32) -> Result<(i32, i32 ), IntegerOrSdlError>

Return a pair (dx, dy) containing the difference in axis position since the last poll

[src]

pub fn num_hats(&self) -> u32

Retrieve the number of balls for this joystick

[src]

pub fn hat(&self, hat: u32) -> Result<HatState, IntegerOrSdlError>

Return the position of hat for this joystick

[src]

pub fn set_rumble(
 &mut self,
 low_frequency_rumble: u16,
 high_frequency_rumble: u16,
 duration_ms: u32
) -> Result<(), IntegerOrSdlError>

Set the rumble motors to their specified intensities, if supported. Automatically resets back to zero after duration_ms milliseconds have passed.

Notes

The value range for the intensities is 0 to 0xFFFF.

Do not use std::u32::MAX or similar for duration_ms if you want the rumble effect to keep playing for a long time, as this results in the effect ending immediately after starting due to an overflow. Use some smaller, “huge enough” number instead.