Struct InputAxisValue 

pub struct InputAxisValue(/* private fields */);

A finite normalized value for one float input axis.

The raw Input API describes this representation only as a float. The game consumes bindable axes in the inclusive -1.0..=1.0 interval, where zero is the center and the endpoints are the two maximum directions. Real ETS2 validation showed that a value below -1.0 still crosses the ABI boundary successfully but is interpreted by the input UI as the neutral center. Keeping the normalized domain in this type prevents safe plugins from emitting those semantically invalid values.

Construction rejects NaN and infinities as well as finite out-of-range values. Values are never silently clamped because that would hide a device conversion error and would not match the observed game behavior.

Implementations

impl InputAxisValue

pub const MIN: InputAxisValue

Maximum movement in the negative direction.

pub const CENTER: InputAxisValue

Neutral centered position.

pub const MAX: InputAxisValue

Maximum movement in the positive direction.

pub fn new(value: f32) -> Result<InputAxisValue, InputAxisValueError>

Validates one normalized axis value.

Both positive and negative zero are accepted and preserved exactly.

Errors

Returns InputAxisValueError::NotFinite for NaN or either infinity, and InputAxisValueError::OutOfRange for a finite value outside the inclusive -1.0..=1.0 interval.

pub const fn get(self) -> f32

Returns the validated SDK float representation.

Trait Implementations

impl Clone for InputAxisValue

fn clone(&self) -> InputAxisValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for InputAxisValue

impl Debug for InputAxisValue

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

Formats the value using the given formatter.

impl PartialEq for InputAxisValue

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InputAxisValue

impl TryFrom<f32> for InputAxisValue

type Error = InputAxisValueError

The type returned in the event of a conversion error.

fn try_from( value: f32, ) -> Result<InputAxisValue, <InputAxisValue as TryFrom<f32>>::Error>

Performs the conversion.