glam_det 2.0.0-beta.3

// Copyright (C) 2020-2025 glam-det authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

// Generated from vec.rs.tera template. Edit the template, not the generated file.

use crate::nums::*;
use crate::{BVec3x4, Vec3x4};

use crate::UnitVec3;

#[cfg(not(target_arch = "spirv"))]
use core::fmt;
use core::ops::*;

use auto_ops_det::{impl_op_ex, impl_op_ex_commutative};
use core::ops;

union VecUnionCast {
    v: Vec3x4,
    uv: UnitVec3x4,
}

impl Vec3x4 {
    #[inline]
    pub fn as_unit_vec3x4_unchecked(self) -> UnitVec3x4 {
        unsafe { VecUnionCast { v: self }.uv }
    }
}

impl UnitVec3x4 {
    #[inline]
    pub fn as_vec3x4(self) -> Vec3x4 {
        unsafe { VecUnionCast { uv: self }.v }
    }
}

/// A 3-dimensional 4 lanes SOAunit vector.
/// This type is 16 byte aligned, same as f32x4.
#[derive(Clone, Copy, PartialEq)]
#[repr(C)]
pub struct UnitVec3x4 {
    pub x: f32x4,
    pub y: f32x4,
    pub z: f32x4,
}

impl UnitVec3x4 {
    /// A unit-length vector pointing along the positive X axis.
    pub const X: Self = Self::new_unchecked(f32x4::ONE, f32x4::ZERO, f32x4::ZERO);

    /// A unit-length vector pointing along the positive Y axis.
    pub const Y: Self = Self::new_unchecked(f32x4::ZERO, f32x4::ONE, f32x4::ZERO);

    /// A unit-length vector pointing along the positive Z axis.
    pub const Z: Self = Self::new_unchecked(f32x4::ZERO, f32x4::ZERO, f32x4::ONE);

    /// A unit-length vector pointing along the negative X axis.
    pub const NEG_X: Self = Self::new_unchecked(f32x4::NEG_ONE, f32x4::ZERO, f32x4::ZERO);

    /// A unit-length vector pointing along the negative Y axis.
    pub const NEG_Y: Self = Self::new_unchecked(f32x4::ZERO, f32x4::NEG_ONE, f32x4::ZERO);

    /// A unit-length vector pointing along the negative Z axis.
    pub const NEG_Z: Self = Self::new_unchecked(f32x4::ZERO, f32x4::ZERO, f32x4::NEG_ONE);

    /// The unit axes.
    pub const AXES: [Self; 3] = [Self::X, Self::Y, Self::Z];

    /// Creates a new unit vector without checking if it is normalized.
    #[inline]
    pub const fn new_unchecked(x: f32x4, y: f32x4, z: f32x4) -> Self {
        Self { x, y, z }
    }

    /// Creates a new unit vector after normalizing the parameters.
    ///
    /// For valid results, vector represented by the parameters must _not_ be of length zero, nor very close to zero.
    ///
    /// See also [`Vec3x4::normalize`].
    ///
    /// # Panics
    ///
    /// Will panic if vector represented by the parameters is zero length when `glam_assert` is enabled.
    #[inline]
    pub fn new_normalized(x: f32x4, y: f32x4, z: f32x4) -> Self {
        Vec3x4::new(x, y, z).normalize().as_unit_vec3x4_unchecked()
    }

    /// Creates a vector from the elements in `if_true` and `if_false`, selecting which to use
    /// for each element of `self`.
    ///
    /// A true element in the mask uses the corresponding element from `if_true`, and false
    /// uses the element from `if_false`.
    #[inline]
    pub fn select(mask: BVec3x4, if_true: Self, if_false: Self) -> Vec3x4 {
        Vec3x4::select(mask, if_true.as_vec3x4(), if_false.as_vec3x4())
    }

    /// Creates a new vector from an array.
    #[inline]
    pub const fn from_array_unchecked(a: [f32x4; 3]) -> Self {
        Self::new_unchecked(a[0], a[1], a[2])
    }

    /// `[x, y, z]`
    #[inline]
    pub const fn to_array(&self) -> [f32x4; 3] {
        [self.x, self.y, self.z]
    }

    /// Creates a vector from the first 3 values in `slice`.
    ///
    /// # Panics
    ///
    /// Panics if `slice` is less than 3 elements long.
    #[inline]
    pub const fn from_slice_unchecked(slice: &[f32x4]) -> Self {
        Self::new_unchecked(slice[0], slice[1], slice[2])
    }

    /// Writes the elements of `self` to the first 3 elements in `slice`.
    ///
    /// # Panics
    ///
    /// Panics if `slice` is less than 3 elements long.
    #[inline]
    pub fn write_to_slice(self, slice: &mut [f32x4]) {
        slice[0] = self.x;
        slice[1] = self.y;
        slice[2] = self.z;
    }

    /// Computes the dot product of `self` and `rhs`.
    #[inline]
    pub(crate) fn dot(self, rhs: Self) -> f32x4 {
        self.as_vec3x4().dot(rhs.as_vec3x4())
    }

    /// Computes the cross product of `self` and `rhs`.
    #[inline]
    pub(crate) fn cross(self, rhs: Self) -> Vec3x4 {
        self.as_vec3x4().cross(rhs.as_vec3x4())
    }

    /// Returns the horizontal minimum of `self`.
    ///
    /// In other words this computes `min(x, y, ..)`.
    #[inline]
    pub fn min_element(self) -> f32x4 {
        self.as_vec3x4().min_element()
    }

    /// Returns the horizontal maximum of `self`.
    ///
    /// In other words this computes `max(x, y, ..)`.
    #[inline]
    pub fn max_element(self) -> f32x4 {
        self.as_vec3x4().max_element()
    }

    /// Returns a vector mask containing the result of a `==` comparison for each element of
    /// `self` and `rhs`.
    ///
    /// In other words, this computes `[self.x == rhs.x, self.y == rhs.y, ..]` for all
    /// elements.
    #[inline]
    pub fn cmpeq(self, rhs: Self) -> BVec3x4 {
        self.as_vec3x4().cmpeq(rhs.as_vec3x4())
    }

    /// Returns a vector mask containing the result of a `!=` comparison for each element of
    /// `self` and `rhs`.
    ///
    /// In other words this computes `[self.x != rhs.x, self.y != rhs.y, ..]` for all
    /// elements.
    #[inline]
    pub fn cmpne(self, rhs: Self) -> BVec3x4 {
        self.as_vec3x4().cmpne(rhs.as_vec3x4())
    }

    /// Returns a vector mask containing the result of a `>=` comparison for each element of
    /// `self` and `rhs`.
    ///
    /// In other words this computes `[self.x >= rhs.x, self.y >= rhs.y, ..]` for all
    /// elements.
    #[inline]
    pub fn cmpge(self, rhs: Self) -> BVec3x4 {
        self.as_vec3x4().cmpge(rhs.as_vec3x4())
    }

    /// Returns a vector mask containing the result of a `>` comparison for each element of
    /// `self` and `rhs`.
    ///
    /// In other words this computes `[self.x > rhs.x, self.y > rhs.y, ..]` for all
    /// elements.
    #[inline]
    pub fn cmpgt(self, rhs: Self) -> BVec3x4 {
        self.as_vec3x4().cmpgt(rhs.as_vec3x4())
    }

    /// Returns a vector mask containing the result of a `<=` comparison for each element of
    /// `self` and `rhs`.
    ///
    /// In other words this computes `[self.x <= rhs.x, self.y <= rhs.y, ..]` for all
    /// elements.
    #[inline]
    pub fn cmple(self, rhs: Self) -> BVec3x4 {
        self.as_vec3x4().cmple(rhs.as_vec3x4())
    }

    /// Returns a vector mask containing the result of a `<` comparison for each element of
    /// `self` and `rhs`.
    ///
    /// In other words this computes `[self.x < rhs.x, self.y < rhs.y, ..]` for all
    /// elements.
    #[inline]
    pub fn cmplt(self, rhs: Self) -> BVec3x4 {
        self.as_vec3x4().cmple(rhs.as_vec3x4())
    }

    /// Returns a vector containing the absolute value of each element of `self`.
    #[inline]
    pub fn abs(self) -> Self {
        self.as_vec3x4().abs().as_unit_vec3x4_unchecked()
    }

    /// Returns a vector with elements representing the sign of `self`.
    ///
    /// - `1.0` if the number is positive, `+0.0` or `INFINITY`
    /// - `-1.0` if the number is negative, `-0.0` or `NEG_INFINITY`
    /// - `NAN` if the number is `NAN`
    ///
    /// # Warning
    ///
    /// Because of the fact that `-UnitVec3x4::ZERO` output `UnitVec3x4::ZERO`,
    /// so the sign of `-UnitVec3x4::ZERO` is `1.0`, which is different from the behavior of `std::f32`.
    /// This phenomenon exists if some of vector elements is zero.
    #[inline]
    pub fn signum(self) -> Vec3x4 {
        self.as_vec3x4().signum()
    }

    /// Computes the Euclidean distance between two points in space.
    #[inline]
    pub fn distance(self, rhs: Self) -> f32x4 {
        self.as_vec3x4().distance(rhs.as_vec3x4())
    }

    /// Compute the squared euclidean distance between two points in space.
    #[inline]
    pub fn distance_squared(self, rhs: Self) -> f32x4 {
        self.as_vec3x4().distance_squared(rhs.as_vec3x4())
    }

    /// Select lanes from two SOA vector to compose a new SOA vector.
    #[inline]
    pub fn lane_select(cond: bool32x4, if_true: Self, if_false: Self) -> Self {
        Self {
            x: if_true.x.select(cond, if_false.x),
            y: if_true.y.select(cond, if_false.y),
            z: if_true.z.select(cond, if_false.z),
        }
    }

    /// Create a SOA vector with all lanes set to `v`.
    #[inline]
    pub fn splat_soa(v: UnitVec3) -> Self {
        Self {
            x: f32x4::splat(v.x),
            y: f32x4::splat(v.y),
            z: f32x4::splat(v.z),
        }
    }

    /// Extract a single lane from a SOA vector.
    ///
    /// # Panics
    ///
    /// Panics if `i` is larger than 3.
    #[inline]
    pub fn extract_lane(&self, i: usize) -> UnitVec3 {
        UnitVec3::new_unchecked(self.x.extract(i), self.y.extract(i), self.z.extract(i))
    }

    /// Replace a single lane in a SOA vector.
    ///
    /// # Panics
    ///
    /// Panics if `i` is larger than 3.
    #[inline]
    pub fn replace_lane(&mut self, i: usize, v: UnitVec3) {
        let mut nv = self.as_vec3x4();
        nv.replace_lane(i, v.as_vec3());
        *self = nv.as_unit_vec3x4_unchecked();
    }

    /// Split a SOA vector into 4 vector.
    #[inline]
    pub fn split_soa(self) -> [UnitVec3; 4] {
        [
            self.extract_lane(0),
            self.extract_lane(1),
            self.extract_lane(2),
            self.extract_lane(3),
        ]
    }

    /// Compose a SOA vector from 4 vector.
    #[inline]
    pub fn compose_soa(a: &[UnitVec3; 4]) -> UnitVec3x4 {
        let mut v = Self::default();
        v.replace_lane(0, a[0]);
        v.replace_lane(1, a[1]);
        v.replace_lane(2, a[2]);
        v.replace_lane(3, a[3]);
        v
    }

    /// Returns the vector projection of `self` onto `rhs`.
    #[must_use]
    #[inline]
    pub fn project_onto(self, rhs: Self) -> Vec3x4 {
        rhs.as_vec3x4() * self.dot(rhs)
    }

    /// Returns the vector rejection of `self` from `rhs`.
    #[must_use]
    #[inline]
    pub fn reject_from(self, rhs: Self) -> Vec3x4 {
        self.as_vec3x4() - self.project_onto(rhs)
    }

    /// Performs a linear interpolation between `self` and `rhs` based on the value `s`.
    ///
    /// When `s` is `0.0`, the result will be equal to `self`.  When `s` is `1.0`, the result
    /// will be equal to `rhs`. When `s` is outside of range `[0, 1]`, the result is linearly
    /// extrapolated.
    #[doc(alias = "mix")]
    #[inline]
    pub fn lerp(self, rhs: Self, s: f32x4) -> Vec3x4 {
        self.as_vec3x4().lerp(rhs.as_vec3x4(), s)
    }

    /// Returns true if the absolute difference of all elements between `self` and `rhs` is
    /// less than or equal to `max_abs_diff`.
    ///
    /// This can be used to compare if two vectors contain similar elements. It works best when
    /// comparing with a known value. The `max_abs_diff` that should be used depends on
    /// the values being compared against.
    ///
    /// For more see
    /// [comparing floating point numbers](https://randomascii.wordpress.com/2012/02/25/comparing-floating-point-numbers-2012-edition/).
    #[inline]
    pub fn abs_diff_eq(self, rhs: Self, max_abs_diff: f32x4) -> bool32x4 {
        Vec3x4::abs_diff_eq(self.as_vec3x4(), rhs.as_vec3x4(), max_abs_diff)
    }

    /// Fused multiply-add. Computes `(self * a) + b` element-wise with only one rounding
    /// error, yielding a more accurate result than an unfused multiply-add.
    ///
    /// Using `mul_add` *may* be more performant than an unfused multiply-add if the target
    /// architecture has a dedicated fma CPU instruction. However, this is not always true,
    /// and will be heavily dependant on designing algorithms with specific target hardware in
    /// mind.
    #[inline]
    pub fn mul_add(self, a: Self, b: Self) -> Vec3x4 {
        self.as_vec3x4().mul_add(a.as_vec3x4(), b.as_vec3x4())
    }

    /// Returns the angle (in radians) between two vectors.
    #[inline]
    pub fn angle_between(self, rhs: Self) -> f32x4 {
        use crate::FloatEx;
        self.dot(rhs).acos_approx()
    }

    /// Returns someunit vector that is orthogonal to the given one.
    #[inline]
    pub fn any_orthogonal_vector(&self) -> Self {
        // From https://graphics.pixar.com/library/OrthonormalB/paper.pdf
        let sign = f32x4::ONE.copysignf(self.z);
        let a = f32x4::NEG_ONE / (sign + self.z);
        let b = self.x * self.y * a;
        Self::new_unchecked(b, sign + self.y * self.y * a, -self.y)
    }

    /// Given a unit-length vector return two other vectors that together form an orthonormal
    /// basis.  That is, all three vectors are orthogonal to each other and are normalized.
    #[inline]
    pub fn any_orthogonal_pair(&self) -> (Self, Self) {
        // From https://graphics.pixar.com/library/OrthonormalB/paper.pdf
        let sign = f32x4::ONE.copysignf(self.z);
        let a = f32x4::NEG_ONE / (sign + self.z);
        let b = self.x * self.y * a;
        (
            Self::new_unchecked(
                f32x4::ONE + sign * self.x * self.x * a,
                sign * b,
                -sign * self.x,
            ),
            Self::new_unchecked(b, sign + self.y * self.y * a, -self.y),
        )
    }
}

impl Default for UnitVec3x4 {
    #[inline]
    fn default() -> Self {
        Self::X
    }
}

impl Neg for UnitVec3x4 {
    type Output = Self;
    #[inline]
    fn neg(self) -> Self {
        self.as_vec3x4().neg().as_unit_vec3x4_unchecked()
    }
}

impl_op_ex!(/ |a: &UnitVec3x4, b: &UnitVec3x4| -> Vec3x4 {
    a.as_vec3x4() / b.as_vec3x4()
});

impl_op_ex!(/ |a: &UnitVec3x4, b: &f32x4| -> Vec3x4 {
    a.as_vec3x4() / b
});

impl_op_ex!(/ |a: &f32x4, b: &UnitVec3x4| -> Vec3x4 {
    a / b.as_vec3x4()
});

impl_op_ex_commutative!(/ |a: &UnitVec3x4, b: &Vec3x4| -> Vec3x4 {
    a.as_vec3x4() / b
});

impl_op_ex!(*|a: &UnitVec3x4, b: &UnitVec3x4| -> Vec3x4 { a.as_vec3x4() * b.as_vec3x4() });

impl_op_ex!(*|a: &UnitVec3x4, b: &f32x4| -> Vec3x4 { a.as_vec3x4() * b });

impl_op_ex!(*|a: &f32x4, b: &UnitVec3x4| -> Vec3x4 { a * b.as_vec3x4() });

impl_op_ex_commutative!(*|a: &UnitVec3x4, b: &Vec3x4| -> Vec3x4 { a.as_vec3x4() * b });

impl_op_ex!(+ |a: &UnitVec3x4, b: &UnitVec3x4| -> Vec3x4 {
    a.as_vec3x4() + b.as_vec3x4()
});

impl_op_ex!(+ |a: &UnitVec3x4, b: &f32x4| -> Vec3x4 {
    a.as_vec3x4() + b
});

impl_op_ex!(+ |a: &f32x4, b: &UnitVec3x4| -> Vec3x4 {
    a + b.as_vec3x4()
});

impl_op_ex_commutative!(+ |a: &UnitVec3x4, b: &Vec3x4| -> Vec3x4 {
    a.as_vec3x4() + b
});

impl_op_ex!(-|a: &UnitVec3x4, b: &UnitVec3x4| -> Vec3x4 { a.as_vec3x4() - b.as_vec3x4() });

impl_op_ex!(-|a: &UnitVec3x4, b: &f32x4| -> Vec3x4 { a.as_vec3x4() - b });

impl_op_ex!(-|a: &f32x4, b: &UnitVec3x4| -> Vec3x4 { a - b.as_vec3x4() });

impl_op_ex_commutative!(-|a: &UnitVec3x4, b: &Vec3x4| -> Vec3x4 { a.as_vec3x4() - b });

impl_op_ex!(% |a: &UnitVec3x4, b: &UnitVec3x4| -> Vec3x4 {
    a.as_vec3x4() % b.as_vec3x4()
});

impl_op_ex!(% |a: &UnitVec3x4, b: &f32x4| -> Vec3x4 {
    a.as_vec3x4() % b
});

impl_op_ex!(% |a: &f32x4, b: &UnitVec3x4| -> Vec3x4 {
    a % b.as_vec3x4()
});

impl_op_ex_commutative!(% |a: &UnitVec3x4, b: &Vec3x4| -> Vec3x4 {
    a.as_vec3x4() % b
});

impl Index<usize> for UnitVec3x4 {
    type Output = f32x4;
    #[inline]
    fn index(&self, index: usize) -> &Self::Output {
        match index {
            0 => &self.x,
            1 => &self.y,
            2 => &self.z,
            _ => panic!("index out of bounds"),
        }
    }
}

#[cfg(not(target_arch = "spirv"))]
impl fmt::Display for UnitVec3x4 {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "[{}, {}, {}]", self.x, self.y, self.z)
    }
}

#[cfg(not(target_arch = "spirv"))]
impl fmt::Debug for UnitVec3x4 {
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt.debug_tuple(stringify!(UnitVec3x4))
            .field(&self.x)
            .field(&self.y)
            .field(&self.z)
            .finish()
    }
}

impl From<UnitVec3x4> for [f32x4; 3] {
    #[inline]
    fn from(v: UnitVec3x4) -> Self {
        v.as_vec3x4().into()
    }
}

impl From<UnitVec3x4> for (f32x4, f32x4, f32x4) {
    #[inline]
    fn from(v: UnitVec3x4) -> Self {
        v.as_vec3x4().into()
    }
}

#[cfg(not(target_arch = "spirv"))]
impl AsRef<[f32x4; 3]> for UnitVec3x4 {
    #[inline]
    fn as_ref(&self) -> &[f32x4; 3] {
        unsafe { &*(self as *const UnitVec3x4 as *const [f32x4; 3]) }
    }
}