gamepad
moon add Milky2018/gamepad@0.4.7
Download zipAuthor
Version
0.4.7
License
Apache-2.0
Last updated
13 days ago
Downloads
6K
README#Milky2018/gamepad
MoonBit port of core gilrs concepts (mappings, events, state, and filters), with a native-first focus.
#Status
- Core types: Axis, Button, Event, EventType, GamepadState
- SDL mapping parser + mapping utilities
- Filters: jitter, deadzone, axis_dpad_to_button, Repeat
- Mockable core: Gilrs::new_mock, GilrsBuilder (mock), Gamepad handle
- Blocking event wait: Gilrs::next_event_blocking(timeout_ms)
#Platform Support (Checklist)
This project is macOS-first. Linux/Windows are tracked as follow-ups and may have behavioral gaps.
- macOS (native / IOHIDManager)
- Linux (native / evdev) (planned to harden later)
- Windows (native / XInput) (planned to harden later)
#Notes / Limitations (vs upstream gilrs)
- Code is backend-specific. On macOS it matches gilrs-core's HID EvCode encoding: (usage_page << 16) | usage.
- On macOS, some HID axes (e.g. GenericDesktop Rx/Ry) are intentionally left unmapped to Axis by default (matching gilrs-core's "unconfirmed" constants). Use the SDL mapping DB to get semantic axis/button names for these codes.
- On macOS, PowerInfo is intentionally Unknown (parity with upstream gilrs-core).
- Force-feedback repeat mode is exposed as FfRepeat to avoid naming collision with event filter Repeat.
#Quickstart (native)
let gilrs = Gilrs::new()
while true {
match gilrs.next_event() {
None => break
Some(ev) => println(ev)
}
}#Quickstart (mock)
let gilrs =
GilrsBuilder::new()
.with_mock_gamepad_count(1)
.with_default_filters(true)
.build()
let id = GamepadId::new(0)
gilrs.insert_event(Event::at(id, EventType::ButtonPressed(Button::South, BTN_SOUTH), 0L))
match gilrs.next_event() {
None => ()
Some(ev) => println(ev.id().value())
}#ParserError
type ParserError#Axis
pub(all) enum Axis {
LeftStickX
LeftStickY
LeftZ
RightStickX
RightStickY
RightZ
DPadX
DPadY
Unknown
}#AxisData
pub struct AxisData {
last_event_ts : Int64
last_event_c : Int64
value : Double
}#AxisInfo
pub struct AxisInfo {
min : Int
max : Int
deadzone : Int?
}#AxisOrBtn
#BaseEffect
#Button
pub(all) enum Button {
South
East
C
North
West
Z
LeftTrigger
RightTrigger
LeftTrigger2
RightTrigger2
Select
Start
Mode
LeftThumb
RightThumb
DPadUp
DPadDown
DPadLeft
DPadRight
Unknown
}#ButtonData
pub struct ButtonData {
last_event_ts : Int64
counter : Int64
value : Double
is_pressed : Bool
is_repeating : Bool
}#DistanceModel
pub enum DistanceModel {
None
Linear(Double, Double, Double)
LinearClamped(Double, Double, Double)
Inverse(Double, Double)
InverseClamped(Double, Double, Double)
Exponential(Double, Double)
ExponentialClamped(Double, Double, Double)
}#DistanceModel::validate
#Effect
pub struct Effect {
gilrs : Gilrs
gamepads : Array[GamepadId]
strong : Double
weak : Double
duration_ms : Int64
base_effects : Array[BaseEffect]
repeat_mode : FfRepeat
distance_model : DistanceModel
position : (Double, Double, Double)
gain : Double
}#Effect::add_gamepad
#Effect::set_distance_model
#Effect::set_gamepads
#Effect::set_position
#EffectBuilder
pub struct EffectBuilder {
gamepads : Array[GamepadId]
base_effects : Array[BaseEffect]
repeat_mode : FfRepeat
distance_model : DistanceModel
position : (Double, Double, Double)
gain : Double
strong : Double
weak : Double
duration_ms : Int64
}#EffectBuilder::add_effect
#EffectBuilder::add_gamepad
#EffectBuilder::add_gamepad_id
#EffectBuilder::distance_model
#EffectBuilder::duration
#EffectBuilder::finish
#EffectBuilder::gain
#EffectBuilder::gamepads
#EffectBuilder::position
fn EffectBuilder::position(self : EffectBuilder, position : (Double, Double, Double)) -> EffectBuilder#EffectBuilder::repeat
#EffectBuilder::rumble
#Envelope
pub struct Envelope {
attack_length : Int
attack_level : Double
fade_length : Int
fade_level : Double
}#Event
#EventType
#Gamepad
#Gamepad::axis_or_btn_name
#Gamepad::set_listener_position
#GamepadData
pub struct GamepadData {
state : GamepadState
connected : Bool
mapping : Mapping
name : String
uuid : Uuid
vendor_id : Int?
product_id : Int?
ff_supported : Bool
power_info : PowerInfo
axes : Array[Int]
buttons : Array[Int]
axis_info : Array[(Int, AxisInfo)]
deadzones : Array[(Int, Double)]
have_sent_nonzero_for_axis : Array[Bool]
}#GamepadId
pub struct GamepadId {
value : Int
}#GamepadState
#GamepadState::axes_entries
#GamepadState::axis_data
#GamepadState::button_data
#GamepadState::buttons_entries
#Gilrs
pub struct Gilrs {
counter : Int64
update_state : Bool
default_filters : Bool
axis_to_btn_pressed : Double
axis_to_btn_released : Double
events : Array[Event]
events_head : Int
gamepads_data : Array[GamepadData]
mappings : MappingDb
now_ms : Int64
backend : NativeBackend?
}#Gilrs::axis_or_btn_name
#Gilrs::connected_gamepad
#Gilrs::new_mock
#Gilrs::new_native
#Gilrs::next_event_blocking
#Gilrs::set_axis_to_btn
fn Gilrs::set_axis_to_btn(self : Gilrs, pressed : Double, released : Double) -> Unit raise GilrsError#Gilrs::set_deadzone
#Gilrs::set_mapping
#Gilrs::set_mapping_data
fn Gilrs::set_mapping_data(self : Gilrs, id : GamepadId, mapping_data : MappingData, name? : String?) -> String raise MappingError#Gilrs::set_mapping_data_strict
fn Gilrs::set_mapping_data_strict(self : Gilrs, id : GamepadId, mapping_data : MappingData, name? : String?) -> String raise MappingError#GilrsBuilder
pub struct GilrsBuilder {
update_state : Bool
default_filters : Bool
axis_to_btn_pressed : Double
axis_to_btn_released : Double
env_mappings : Bool
included_mappings : Bool
mock_gamepad_count : Int
use_native_backend : Bool
mapping_inputs : Array[String]
}#GilrsBuilder::add_env_mappings
#GilrsBuilder::add_included_mappings
fn GilrsBuilder::add_included_mappings(self : GilrsBuilder, included_mappings : Bool) -> GilrsBuilder#GilrsBuilder::add_mappings
#GilrsBuilder::set_axis_to_btn
fn GilrsBuilder::set_axis_to_btn(self : GilrsBuilder, pressed : Double, released : Double) -> GilrsBuilder#GilrsBuilder::set_update_state
#GilrsBuilder::with_default_filters
#GilrsBuilder::with_mock_gamepad_count
#GilrsBuilder::with_native_backend
#Jitter
pub struct Jitter {
threshold : Double
}#Mapping
#Mapping::from_data
fn Mapping::from_data(data : MappingData, buttons : Array[Int], axes : Array[Int], name : String, uuid : Uuid) -> (Mapping, String) raise MappingError#Mapping::parse_sdl_mapping
fn Mapping::parse_sdl_mapping(line : String, buttons : Array[Int], axes : Array[Int]) -> Mapping raise ParseSdlMappingError#MappingData
#MappingData::insert_axis
#MappingData::insert_btn
#MappingData::remove_button
#MappingDb
#MappingDb::add_included_mappings
#NativeBackend
#NativeBackend::axis_info
#NativeBackend::buttons
#NativeBackend::is_ff_supported
#NativeBackend::poll_timeout
#NativeBackend::product_id
#NativeBackend::set_rumble
fn NativeBackend::set_rumble(self : NativeBackend, id : Int, strong : Double, weak : Double, duration_ms : Int) -> Bool#NativeBackend::uuid_simple
#NativeEvent
#NativeEventTag
pub(all) enum NativeEventTag {
Connected
Disconnected
ButtonPressed
ButtonReleased
AxisChanged
ButtonChanged
}#ParserErrorKind
pub(all) enum ParserErrorKind {
InvalidGuid
InvalidKeyValPair
InvalidValue
EmptyValue
UnknownAxis
UnknownButton
InvalidParserState
UnexpectedEnd
}#Repeat
pub struct Repeat {
after_ms : Int64
every_ms : Int64
}#Replay
pub struct Replay {
after : Int
play_for : Int
with_delay : Int
}#Ticks
pub struct Ticks {
ms : Int64
}#Token
#Uuid
pub struct Uuid {
simple : String
}#filter_ev
0.4.7
Apache-2.0
Updated 13 days ago
6K downloads