Enum gilrs::ff::DistanceModel

pub enum DistanceModel {
    None,
    Linear {
        ref_distance: f32,
        rolloff_factor: f32,
        max_distance: f32,
    },
    LinearClamped {
        ref_distance: f32,
        rolloff_factor: f32,
        max_distance: f32,
    },
    Inverse {
        ref_distance: f32,
        rolloff_factor: f32,
    },
    InverseClamped {
        ref_distance: f32,
        rolloff_factor: f32,
        max_distance: f32,
    },
    Exponential {
        ref_distance: f32,
        rolloff_factor: f32,
    },
    ExponentialClamped {
        ref_distance: f32,
        rolloff_factor: f32,
        max_distance: f32,
    },
}

Specifies how distance between effect source and listener attenuates effect.

They are based on OpenAL Specification (chapter 3.4), but the best way to see how they differ is to run ff_pos example.

Make sure that all parameters are ≥ 0. Additionally Linear and LinearClamped models don’t like if ref_distance == max_distance while others would prefer ref_distance > 0.

Variants

None

Effect is not attenuated by distance.

Linear

Fields

ref_distance: f32

rolloff_factor: f32

max_distance: f32

Linear distance model.

LinearClamped

Fields

ref_distance: f32

rolloff_factor: f32

max_distance: f32

Linear distance clamped model.

Inverse

Fields

ref_distance: f32

rolloff_factor: f32

Inverse distance model.

InverseClamped

Fields

ref_distance: f32

rolloff_factor: f32

max_distance: f32

Inverse distance clamped model.

Exponential

Fields

ref_distance: f32

rolloff_factor: f32

Exponential distance model.

ExponentialClamped

Fields

ref_distance: f32

rolloff_factor: f32

max_distance: f32

Exponential distance clamped model.

Trait Implementations

impl Clone for DistanceModel

fn clone(&self) -> DistanceModel

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DistanceModel

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

Formats the value using the given formatter.

impl Default for DistanceModel

fn default() -> DistanceModel

Returns the “default value” for a type.

impl PartialEq for DistanceModel

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Copy for DistanceModel

impl StructuralPartialEq for DistanceModel