Struct AnalogCalibration 

pub struct AnalogCalibration {
    pub deadzone: f32,
    pub deadzone_shape: DeadzoneShape,
    pub sensitivity: SensitivityCurve,
    pub sensitivity_multiplier: f32,
    pub range_min: i32,
    pub range_max: i32,
    pub invert_x: bool,
    pub invert_y: bool,
}

Analog stick calibration configuration

Defines how analog stick events are processed including deadzone filtering, sensitivity curves, range scaling, and axis inversion.

Fields

deadzone: f32

Deadzone radius (0.0 to 1.0)

Values below this threshold are filtered out. 0.15 (15%) is typical for analog sticks to remove drift without sacrificing usable range.

deadzone_shape: DeadzoneShape

Shape of the deadzone

Circular is recommended for analog sticks (smoother diagonals). Square can be used for precise axis-aligned control.

sensitivity: SensitivityCurve

Sensitivity response curve

Determines the feel of the analog stick response.

sensitivity_multiplier: f32

Sensitivity multiplier (0.1 to 5.0)

Scales the output after curve application. 1.0 = no scaling,

1.0 = more sensitive, < 1.0 = less sensitive.

range_min: i32

Minimum output value

Default -32768 (Linux input minimum). Can be adjusted for specific use cases (e.g., gamepad emulation with different ranges).

range_max: i32

Maximum output value

Default 32767 (Linux input maximum). Can be adjusted for specific use cases.

invert_x: bool

Invert X axis

When true, X-axis input is reversed (left becomes right).

invert_y: bool

Invert Y axis

When true, Y-axis input is reversed (up becomes down). This is commonly needed for Y-axis in camera controls.

Implementations

impl AnalogCalibration

pub fn new() -> Self

Create a new calibration with default values

pub fn with_deadzone(deadzone: f32) -> Self

Create a new calibration with a specific deadzone

pub fn with_sensitivity_curve(curve: SensitivityCurve) -> Self

Create a new calibration with a specific sensitivity curve

pub fn validate(&self) -> Result<(), String>

Check if calibration values are within valid ranges

Returns Ok(()) if valid, Err with description if invalid.

Trait Implementations

impl Clone for AnalogCalibration

fn clone(&self) -> AnalogCalibration

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AnalogCalibration

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AnalogCalibration

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AnalogCalibration

where AnalogCalibration: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AnalogCalibration

fn eq(&self, other: &AnalogCalibration) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AnalogCalibration

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AnalogCalibration