graphene/auto/

vec4.rs

// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use crate::{ffi, Vec2, Vec3};
use glib::translate::*;

glib::wrapper! {
    /// A structure capable of holding a vector with four dimensions: x, y, z, and w.
    ///
    /// The contents of the [`Vec4`][crate::Vec4] structure are private and should
    /// never be accessed directly.
    pub struct Vec4(BoxedInline<ffi::graphene_vec4_t>);

    match fn {
        copy => |ptr| glib::gobject_ffi::g_boxed_copy(ffi::graphene_vec4_get_type(), ptr as *mut _) as *mut ffi::graphene_vec4_t,
        free => |ptr| glib::gobject_ffi::g_boxed_free(ffi::graphene_vec4_get_type(), ptr as *mut _),
        type_ => || ffi::graphene_vec4_get_type(),
    }
}

impl Vec4 {
    /// Adds each component of the two given vectors.
    /// ## `b`
    /// a [`Vec4`][crate::Vec4]
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the resulting vector
    #[doc(alias = "graphene_vec4_add")]
    #[must_use]
    pub fn add(&self, b: &Vec4) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_add(
                self.to_glib_none().0,
                b.to_glib_none().0,
                res.to_glib_none_mut().0,
            );
            res
        }
    }

    /// Divides each component of the first operand `self` by the corresponding
    /// component of the second operand `b`, and places the results into the
    /// vector `res`.
    /// ## `b`
    /// a [`Vec4`][crate::Vec4]
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the resulting vector
    #[doc(alias = "graphene_vec4_divide")]
    #[must_use]
    pub fn divide(&self, b: &Vec4) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_divide(
                self.to_glib_none().0,
                b.to_glib_none().0,
                res.to_glib_none_mut().0,
            );
            res
        }
    }

    /// Computes the dot product of the two given vectors.
    /// ## `b`
    /// a [`Vec4`][crate::Vec4]
    ///
    /// # Returns
    ///
    /// the value of the dot product
    #[doc(alias = "graphene_vec4_dot")]
    pub fn dot(&self, b: &Vec4) -> f32 {
        unsafe { ffi::graphene_vec4_dot(self.to_glib_none().0, b.to_glib_none().0) }
    }

    #[doc(alias = "graphene_vec4_equal")]
    fn equal(&self, v2: &Vec4) -> bool {
        unsafe { ffi::graphene_vec4_equal(self.to_glib_none().0, v2.to_glib_none().0) }
    }

    /// Retrieves the value of the fourth component of the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    /// the value of the fourth component
    #[doc(alias = "graphene_vec4_get_w")]
    #[doc(alias = "get_w")]
    pub fn w(&self) -> f32 {
        unsafe { ffi::graphene_vec4_get_w(self.to_glib_none().0) }
    }

    /// Retrieves the value of the first component of the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    /// the value of the first component
    #[doc(alias = "graphene_vec4_get_x")]
    #[doc(alias = "get_x")]
    pub fn x(&self) -> f32 {
        unsafe { ffi::graphene_vec4_get_x(self.to_glib_none().0) }
    }

    /// Creates a [`Vec2`][crate::Vec2] that contains the first two components
    /// of the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for a [`Vec2`][crate::Vec2]
    #[doc(alias = "graphene_vec4_get_xy")]
    #[doc(alias = "get_xy")]
    pub fn xy(&self) -> Vec2 {
        unsafe {
            let mut res = Vec2::uninitialized();
            ffi::graphene_vec4_get_xy(self.to_glib_none().0, res.to_glib_none_mut().0);
            res
        }
    }

    /// Creates a [`Vec3`][crate::Vec3] that contains the first three components
    /// of the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for a graphene_vec3_t
    #[doc(alias = "graphene_vec4_get_xyz")]
    #[doc(alias = "get_xyz")]
    pub fn xyz(&self) -> Vec3 {
        unsafe {
            let mut res = Vec3::uninitialized();
            ffi::graphene_vec4_get_xyz(self.to_glib_none().0, res.to_glib_none_mut().0);
            res
        }
    }

    /// Retrieves the value of the second component of the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    /// the value of the second component
    #[doc(alias = "graphene_vec4_get_y")]
    #[doc(alias = "get_y")]
    pub fn y(&self) -> f32 {
        unsafe { ffi::graphene_vec4_get_y(self.to_glib_none().0) }
    }

    /// Retrieves the value of the third component of the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    /// the value of the third component
    #[doc(alias = "graphene_vec4_get_z")]
    #[doc(alias = "get_z")]
    pub fn z(&self) -> f32 {
        unsafe { ffi::graphene_vec4_get_z(self.to_glib_none().0) }
    }

    /// Linearly interpolates `self` and `v2` using the given `factor`.
    /// ## `v2`
    /// a [`Vec4`][crate::Vec4]
    /// ## `factor`
    /// the interpolation factor
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// the interpolated vector
    #[doc(alias = "graphene_vec4_interpolate")]
    #[must_use]
    pub fn interpolate(&self, v2: &Vec4, factor: f64) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_interpolate(
                self.to_glib_none().0,
                v2.to_glib_none().0,
                factor,
                res.to_glib_none_mut().0,
            );
            res
        }
    }

    /// Computes the length of the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    /// the length of the vector
    #[doc(alias = "graphene_vec4_length")]
    pub fn length(&self) -> f32 {
        unsafe { ffi::graphene_vec4_length(self.to_glib_none().0) }
    }

    /// Compares each component of the two given vectors and creates a
    /// vector that contains the maximum values.
    /// ## `b`
    /// a [`Vec4`][crate::Vec4]
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the result vector
    #[doc(alias = "graphene_vec4_max")]
    #[must_use]
    pub fn max(&self, b: &Vec4) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_max(
                self.to_glib_none().0,
                b.to_glib_none().0,
                res.to_glib_none_mut().0,
            );
            res
        }
    }

    /// Compares each component of the two given vectors and creates a
    /// vector that contains the minimum values.
    /// ## `b`
    /// a [`Vec4`][crate::Vec4]
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the result vector
    #[doc(alias = "graphene_vec4_min")]
    #[must_use]
    pub fn min(&self, b: &Vec4) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_min(
                self.to_glib_none().0,
                b.to_glib_none().0,
                res.to_glib_none_mut().0,
            );
            res
        }
    }

    /// Multiplies each component of the two given vectors.
    /// ## `b`
    /// a [`Vec4`][crate::Vec4]
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the resulting vector
    #[doc(alias = "graphene_vec4_multiply")]
    #[must_use]
    pub fn multiply(&self, b: &Vec4) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_multiply(
                self.to_glib_none().0,
                b.to_glib_none().0,
                res.to_glib_none_mut().0,
            );
            res
        }
    }

    /// Compares the two given [`Vec4`][crate::Vec4] vectors and checks
    /// whether their values are within the given `epsilon`.
    /// ## `v2`
    /// a [`Vec4`][crate::Vec4]
    /// ## `epsilon`
    /// the threshold between the two vectors
    ///
    /// # Returns
    ///
    /// `true` if the two vectors are near each other
    #[doc(alias = "graphene_vec4_near")]
    pub fn near(&self, v2: &Vec4, epsilon: f32) -> bool {
        unsafe { ffi::graphene_vec4_near(self.to_glib_none().0, v2.to_glib_none().0, epsilon) }
    }

    /// Negates the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the result vector
    #[doc(alias = "graphene_vec4_negate")]
    #[must_use]
    pub fn negate(&self) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_negate(self.to_glib_none().0, res.to_glib_none_mut().0);
            res
        }
    }

    /// Normalizes the given [`Vec4`][crate::Vec4].
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the normalized
    ///  vector
    #[doc(alias = "graphene_vec4_normalize")]
    #[must_use]
    pub fn normalize(&self) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_normalize(self.to_glib_none().0, res.to_glib_none_mut().0);
            res
        }
    }

    /// Multiplies all components of the given vector with the given scalar `factor`.
    /// ## `factor`
    /// the scalar factor
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the result vector
    #[doc(alias = "graphene_vec4_scale")]
    #[must_use]
    pub fn scale(&self, factor: f32) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_scale(self.to_glib_none().0, factor, res.to_glib_none_mut().0);
            res
        }
    }

    /// Subtracts from each component of the first operand `self` the
    /// corresponding component of the second operand `b` and places
    /// each result into the components of `res`.
    /// ## `b`
    /// a [`Vec4`][crate::Vec4]
    ///
    /// # Returns
    ///
    ///
    /// ## `res`
    /// return location for the resulting vector
    #[doc(alias = "graphene_vec4_subtract")]
    #[must_use]
    pub fn subtract(&self, b: &Vec4) -> Vec4 {
        unsafe {
            let mut res = Vec4::uninitialized();
            ffi::graphene_vec4_subtract(
                self.to_glib_none().0,
                b.to_glib_none().0,
                res.to_glib_none_mut().0,
            );
            res
        }
    }

    /// Retrieves a pointer to a [`Vec4`][crate::Vec4] with all its
    /// components set to 1.
    ///
    /// # Returns
    ///
    /// a constant vector
    #[doc(alias = "graphene_vec4_one")]
    pub fn one() -> Vec4 {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::graphene_vec4_one()) }
    }

    /// Retrieves a pointer to a [`Vec4`][crate::Vec4] with its
    /// components set to (0, 0, 0, 1).
    ///
    /// # Returns
    ///
    /// a constant vector
    #[doc(alias = "graphene_vec4_w_axis")]
    pub fn w_axis() -> Vec4 {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::graphene_vec4_w_axis()) }
    }

    /// Retrieves a pointer to a [`Vec4`][crate::Vec4] with its
    /// components set to (1, 0, 0, 0).
    ///
    /// # Returns
    ///
    /// a constant vector
    #[doc(alias = "graphene_vec4_x_axis")]
    pub fn x_axis() -> Vec4 {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::graphene_vec4_x_axis()) }
    }

    /// Retrieves a pointer to a [`Vec4`][crate::Vec4] with its
    /// components set to (0, 1, 0, 0).
    ///
    /// # Returns
    ///
    /// a constant vector
    #[doc(alias = "graphene_vec4_y_axis")]
    pub fn y_axis() -> Vec4 {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::graphene_vec4_y_axis()) }
    }

    /// Retrieves a pointer to a [`Vec4`][crate::Vec4] with its
    /// components set to (0, 0, 1, 0).
    ///
    /// # Returns
    ///
    /// a constant vector
    #[doc(alias = "graphene_vec4_z_axis")]
    pub fn z_axis() -> Vec4 {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::graphene_vec4_z_axis()) }
    }

    /// Retrieves a pointer to a [`Vec4`][crate::Vec4] with all its
    /// components set to 0.
    ///
    /// # Returns
    ///
    /// a constant vector
    #[doc(alias = "graphene_vec4_zero")]
    pub fn zero() -> Vec4 {
        assert_initialized_main_thread!();
        unsafe { from_glib_none(ffi::graphene_vec4_zero()) }
    }
}

impl PartialEq for Vec4 {
    #[inline]
    fn eq(&self, other: &Self) -> bool {
        self.equal(other)
    }
}

impl Eq for Vec4 {}