Trait rust_examples::rsqrt::FastNormalize

pub trait FastNormalize {
    type NormVec;
    fn normalize(&self) -> Self::NormVec;
}

This trait is a typeclass for all vectors that are normalized via a fast (approximate) inverse square root

Associated Types

type NormVec

Normalization return type

Required methods

fn normalize(&self) -> Self::NormVec

Normalize this vector and return NormVec

Implementations on Foreign Types

impl FastNormalize for (Float, Float, Float)

Optimized implementation of FastNormalize for 3D vector of Floats.

In this implementation we know that Float is non-zero, not nan and not infinity, so the squares are always PositiveFloats. Therefore we can skip the checks on the components of the input vector.

type NormVec = Self

fn normalize(&self) -> Self::NormVec

Implementors

impl FastNormalize for Vec3D

This implementation of FastNormalize uses a fast_rsqrt<1> to compute compute the invese square root of x^2 + y^2 + z^2 of the components of the initial vector.

Because the components must be converted to PositiveFloats, additional checks are necessary to validate the inputs. Moreover, because the validation might fail, the return type must be wrapped into an Option.

type NormVec = Option<Vec3D>