Struct Q15 

#[repr(transparent)]
pub struct Q15(pub i16);

Strongly-typed Q1.15 fixed-point number stored in an i16.

Range is [-1.0, 0.999969482421875]. Provides operator overloading (+, -, *, /) with saturating fixed-point arithmetic.

Tuple Fields

0: i16

Implementations

impl Q15

pub const ZERO: Self

Zero representation (0.0).

pub const ONE: Self

Maximum positive value (0.999969482... = 32767).

pub const MIN: Self

Minimum representable value (-1.0 = -32768).

pub const MAX: Self

Maximum representable value (0.999969482... = 32767).

pub const DELTA: Self

Smallest positive step (1 / 32768).

pub const fn from_bits(bits: i16) -> Self

Create from raw integer bits.

pub const fn to_bits(self) -> i16

Retrieve raw integer bits.

pub fn from_f32(v: f32) -> Self

Convert from f32 with rounding and saturation to [-1.0, 0.999969].

pub fn to_f32(self) -> f32

Convert to f32.

pub const fn saturating_add(self, rhs: Self) -> Self

Saturating addition.

pub const fn saturating_sub(self, rhs: Self) -> Self

Saturating subtraction.

pub fn saturating_mul(self, rhs: Self) -> Self

Saturating Q15 multiplication.

pub fn saturating_div(self, rhs: Self) -> Self

Saturating Q15 division with division-by-zero protection.

pub const fn abs(self) -> Self

Absolute value (saturating at Self::MAX for -1.0).

pub fn clamp(self, min: Self, max: Self) -> Self

Clamp to [min, max].

Trait Implementations

impl Add for Q15

type Output = Q15

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl AddAssign for Q15

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for Q15

fn clone(&self) -> Q15

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Q15

impl Debug for Q15

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

Formats the value using the given formatter.

impl Default for Q15

fn default() -> Q15

Returns the “default value” for a type.

impl Div for Q15

type Output = Q15

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self

Performs the / operation.

impl DivAssign for Q15

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl DspSample for Q15

const ZERO: Self = Self::ZERO

Additive identity (0.0).

const ONE: Self = Self::ONE

Multiplicative identity or normalized unity (1.0).

fn sat_add(self, rhs: Self) -> Self

Saturating addition.

fn sat_sub(self, rhs: Self) -> Self

Saturating subtraction.

fn sat_mul(self, rhs: Self) -> Self

Saturating multiplication.

fn sat_div(self, rhs: Self) -> Self

Saturating division.

fn abs_val(self) -> Self

Absolute value.

fn to_f32(self) -> f32

Convert to floating-point f32.

fn from_f32(val: f32) -> Self

Convert from floating-point f32.

impl Eq for Q15

impl From<Q15> for i16

fn from(v: Q15) -> Self

Converts to this type from the input type.

impl From<Q15> for f32

fn from(v: Q15) -> Self

Converts to this type from the input type.

impl From<f32> for Q15

fn from(v: f32) -> Self

Converts to this type from the input type.

impl From<i16> for Q15

fn from(v: i16) -> Self

Converts to this type from the input type.

impl Hash for Q15

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Mul for Q15

type Output = Q15

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self

Performs the * operation.

impl MulAssign for Q15

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Neg for Q15

type Output = Q15

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl Ord for Q15

fn cmp(&self, other: &Q15) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Q15

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Q15

fn partial_cmp(&self, other: &Q15) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Q15

impl Sub for Q15

type Output = Q15

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl SubAssign for Q15

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.