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::{BVec3, IPoint2, IPoint4, IVec3};

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

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

/// Creates a 3-dimensional point.
#[inline]
pub const fn ipoint3(x: i32, y: i32, z: i32) -> IPoint3 {
    IPoint3::new(x, y, z)
}

/// A 3-dimensional point.
#[cfg_attr(not(target_arch = "spirv"), derive(Hash))]
#[derive(Clone, Copy, PartialEq, Eq)]
#[repr(transparent)]
pub struct IPoint3(pub(crate) IVec3);

impl IPoint3 {
    /// All zeroes.
    pub const ZERO: Self = Self::splat(0);

    /// All ones.
    pub const ONE: Self = Self::splat(1);

    /// All negative ones.
    pub const NEG_ONE: Self = Self::splat(-1);

    /// A unit-length point pointing along the positive X axis.
    pub const X: Self = Self::new(1, 0, 0);

    /// A unit-length point pointing along the positive Y axis.
    pub const Y: Self = Self::new(0, 1, 0);

    /// A unit-length point pointing along the positive Z axis.
    pub const Z: Self = Self::new(0, 0, 1);

    /// A unit-length point pointing along the negative X axis.
    pub const NEG_X: Self = Self::new(-1, 0, 0);

    /// A unit-length point pointing along the negative Y axis.
    pub const NEG_Y: Self = Self::new(0, -1, 0);

    /// A unit-length point pointing along the negative Z axis.
    pub const NEG_Z: Self = Self::new(0, 0, -1);

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

    /// Creates a new point.
    #[inline]
    pub const fn new(x: i32, y: i32, z: i32) -> Self {
        Self(IVec3::new(x, y, z))
    }

    /// Creates a point with all elements set to `v`.
    #[inline]
    pub const fn splat(v: i32) -> Self {
        Self(IVec3::splat(v))
    }

    /// Creates a point 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: BVec3, if_true: Self, if_false: Self) -> Self {
        Self(IVec3::select(mask, if_true.0, if_false.0))
    }

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

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

    /// Creates a point from the first 3 values in `slice`.
    ///
    /// # Panics
    ///
    /// Panics if `slice` is less than 3 elements long.
    #[inline]
    pub const fn from_slice(slice: &[i32]) -> Self {
        Self::new(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 [i32]) {
        self.0.write_to_slice(slice)
    }

    /// Creates a 4D point from `self` and the given `w` value.
    #[inline]
    pub fn extend(self, w: i32) -> IPoint4 {
        IPoint4::new(self.x, self.y, self.z, w)
    }

    /// Creates a 2D point from the `x` and `y` elements of `self`, discarding `z`.
    ///
    /// Truncation may also be performed by using `self.xy()` or `IPoint2::from()`.
    #[inline]
    pub fn truncate(self) -> IPoint2 {
        use crate::swizzles::Vec3Swizzles;
        self.xy()
    }

    /// Returns a point containing the minimum values for each element of `self` and `rhs`.
    ///
    /// In other words this computes `[self.x.min(rhs.x), self.y.min(rhs.y), ..]`.
    #[inline]
    pub fn min(self, rhs: Self) -> Self {
        Self(self.0.min(rhs.0))
    }

    /// Returns a point containing the maximum values for each element of `self` and `rhs`.
    ///
    /// In other words this computes `[self.x.max(rhs.x), self.y.max(rhs.y), ..]`.
    #[inline]
    pub fn max(self, rhs: Self) -> Self {
        Self(self.0.max(rhs.0))
    }

    /// Component-wise clamping of values, similar to [`f32::clamp`].
    ///
    /// Each element in `min` must be less-or-equal to the corresponding element in `max`.
    ///
    /// # Panics
    ///
    /// Will panic if `min` is greater than `max` when `glam_assert` is enabled.
    #[inline]
    pub fn clamp(self, min: Self, max: Self) -> Self {
        Self(self.0.clamp(min.0, max.0))
    }

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

    /// Returns the horizontal maximum of `self`.
    ///
    /// In other words this computes `max(x, y, ..)`.
    #[inline]
    pub fn max_element(self) -> i32 {
        self.0.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) -> BVec3 {
        self.0.cmpeq(rhs.0)
    }

    /// 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) -> BVec3 {
        self.0.cmpne(rhs.0)
    }

    /// 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) -> BVec3 {
        self.0.cmpge(rhs.0)
    }

    /// 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) -> BVec3 {
        self.0.cmpgt(rhs.0)
    }

    /// 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) -> BVec3 {
        self.0.cmple(rhs.0)
    }

    /// 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) -> BVec3 {
        self.0.cmplt(rhs.0)
    }

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

    /// 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`
    #[inline]
    pub fn signum(self) -> IVec3 {
        self.0.signum()
    }

    /// Casts all elements of `self` to `f32`.
    #[inline]
    pub fn as_point3(&self) -> crate::Point3 {
        crate::Point3::new(self.x as f32, self.y as f32, self.z as f32)
    }

    /// Casts all elements of `self` to `f32`.
    #[inline]
    pub fn as_point3a(&self) -> crate::Point3A {
        crate::Point3A::new(self.x as f32, self.y as f32, self.z as f32)
    }

    /// Casts all elements of `self` to `f64`.
    #[inline]
    pub fn as_dpoint3(&self) -> crate::DPoint3 {
        crate::DPoint3::new(self.x as f64, self.y as f64, self.z as f64)
    }

    /// Casts all elements of `self` to `u32`.
    #[inline]
    pub fn as_upoint3(&self) -> crate::UPoint3 {
        crate::UPoint3::new(self.x as u32, self.y as u32, self.z as u32)
    }

    #[inline]
    pub fn as_ivec3(&self) -> IVec3 {
        self.0
    }

    #[inline]
    pub fn from_ivec3(v: IVec3) -> Self {
        Self(v)
    }
}

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

impl_op_ex_commutative!(+ |a: &IPoint3, b: &IVec3| -> IPoint3 { IPoint3(a.0 + b) });
impl_op_ex_commutative!(+ |a: &IPoint3, b: &i32| -> IPoint3 { IPoint3(a.0 + b) });
impl_op!(+= |a: &mut IPoint3, b: &IVec3| { a.0 += b });
impl_op!(-= |a: &mut IPoint3, b: &IVec3| { a.0 -= b });
impl_op!(+= |a: &mut IPoint3, b: IVec3| { a.0 += b });
impl_op!(-= |a: &mut IPoint3, b: IVec3| { a.0 -= b });

impl_op_ex!(-|a: &IPoint3, b: &IVec3| -> IPoint3 { IPoint3(a.0 - b) });
impl_op_ex!(-|a: &IPoint3, b: &i32| -> IPoint3 { IPoint3(a.0 - b) });
impl_op_ex!(-|a: &IPoint3, b: &IPoint3| -> IVec3 { a.0 - b.0 });

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

impl Not for IPoint3 {
    type Output = Self;
    #[inline]
    fn not(self) -> Self::Output {
        Self(self.0.not())
    }
}

impl BitAnd for IPoint3 {
    type Output = Self;
    #[inline]
    fn bitand(self, rhs: Self) -> Self::Output {
        Self(self.0.bitand(rhs.0))
    }
}

impl BitOr for IPoint3 {
    type Output = Self;
    #[inline]
    fn bitor(self, rhs: Self) -> Self::Output {
        Self(self.0.bitor(rhs.0))
    }
}

impl BitXor for IPoint3 {
    type Output = Self;
    #[inline]
    fn bitxor(self, rhs: Self) -> Self::Output {
        Self(self.0.bitxor(rhs.0))
    }
}

impl BitAnd<i32> for IPoint3 {
    type Output = Self;
    #[inline]
    fn bitand(self, rhs: i32) -> Self::Output {
        Self(self.0.bitand(rhs))
    }
}

impl BitOr<i32> for IPoint3 {
    type Output = Self;
    #[inline]
    fn bitor(self, rhs: i32) -> Self::Output {
        Self(self.0.bitor(rhs))
    }
}

impl BitXor<i32> for IPoint3 {
    type Output = Self;
    #[inline]
    fn bitxor(self, rhs: i32) -> Self::Output {
        Self(self.0.bitxor(rhs))
    }
}

impl Shl<i8> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shl(self, rhs: i8) -> Self::Output {
        Self(self.0.shl(rhs))
    }
}

impl Shr<i8> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shr(self, rhs: i8) -> Self::Output {
        Self(self.0.shr(rhs))
    }
}

impl Shl<i16> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shl(self, rhs: i16) -> Self::Output {
        Self(self.0.shl(rhs))
    }
}

impl Shr<i16> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shr(self, rhs: i16) -> Self::Output {
        Self(self.0.shr(rhs))
    }
}

impl Shl<i32> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shl(self, rhs: i32) -> Self::Output {
        Self(self.0.shl(rhs))
    }
}

impl Shr<i32> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shr(self, rhs: i32) -> Self::Output {
        Self(self.0.shr(rhs))
    }
}

impl Shl<u8> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shl(self, rhs: u8) -> Self::Output {
        Self(self.0.shl(rhs))
    }
}

impl Shr<u8> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shr(self, rhs: u8) -> Self::Output {
        Self(self.0.shr(rhs))
    }
}

impl Shl<u16> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shl(self, rhs: u16) -> Self::Output {
        Self(self.0.shl(rhs))
    }
}

impl Shr<u16> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shr(self, rhs: u16) -> Self::Output {
        Self(self.0.shr(rhs))
    }
}

impl Shl<u32> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shl(self, rhs: u32) -> Self::Output {
        Self(self.0.shl(rhs))
    }
}

impl Shr<u32> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shr(self, rhs: u32) -> Self::Output {
        Self(self.0.shr(rhs))
    }
}

impl Shl<crate::IVec3> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shl(self, rhs: crate::IVec3) -> Self::Output {
        Self(self.0.shl(rhs))
    }
}

impl Shr<crate::IVec3> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shr(self, rhs: crate::IVec3) -> Self::Output {
        Self(self.0.shr(rhs))
    }
}

impl Shl<crate::UVec3> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shl(self, rhs: crate::UVec3) -> Self::Output {
        Self(self.0.shl(rhs))
    }
}

impl Shr<crate::UVec3> for IPoint3 {
    type Output = Self;
    #[inline]
    fn shr(self, rhs: crate::UVec3) -> Self::Output {
        Self(self.0.shr(rhs))
    }
}

impl Index<usize> for IPoint3 {
    type Output = i32;
    #[inline]
    fn index(&self, index: usize) -> &Self::Output {
        self.0.index(index)
    }
}

impl IndexMut<usize> for IPoint3 {
    #[inline]
    fn index_mut(&mut self, index: usize) -> &mut Self::Output {
        self.0.index_mut(index)
    }
}

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

impl From<[i32; 3]> for IPoint3 {
    #[inline]
    fn from(a: [i32; 3]) -> Self {
        Self(IVec3::from(a))
    }
}

impl From<IPoint3> for [i32; 3] {
    #[inline]
    fn from(v: IPoint3) -> Self {
        v.0.into()
    }
}

impl From<(i32, i32, i32)> for IPoint3 {
    #[inline]
    fn from(t: (i32, i32, i32)) -> Self {
        Self(IVec3::from(t))
    }
}

impl From<IPoint3> for (i32, i32, i32) {
    #[inline]
    fn from(v: IPoint3) -> Self {
        v.0.into()
    }
}

impl From<(IPoint2, i32)> for IPoint3 {
    #[inline]
    fn from((v, z): (IPoint2, i32)) -> Self {
        Self::new(v.x, v.y, z)
    }
}

impl Deref for IPoint3 {
    type Target = crate::deref::Vec3<i32>;
    #[inline]
    fn deref(&self) -> &Self::Target {
        unsafe { &*(self as *const Self).cast() }
    }
}

impl DerefMut for IPoint3 {
    #[inline]
    fn deref_mut(&mut self) -> &mut Self::Target {
        unsafe { &mut *(self as *mut Self).cast() }
    }
}

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

#[cfg(not(target_arch = "spirv"))]
impl AsMut<[i32; 3]> for IPoint3 {
    #[inline]
    fn as_mut(&mut self) -> &mut [i32; 3] {
        unsafe { &mut *(self as *mut IPoint3 as *mut [i32; 3]) }
    }
}