Struct godot::builtin::Vector4i

#[repr(C)]
pub struct Vector4i {
    pub x: i32,
    pub y: i32,
    pub z: i32,
    pub w: i32,
}

Vector used for 4D math using integer coordinates.

4-element structure that can be used to represent 4D grid coordinates or sets of integers.

It uses integer coordinates and is therefore preferable to Vector4 when exact precision is required. Note that the values are limited to 32 bits, and unlike Vector4 this cannot be configured with an engine build option. Use i64 or PackedInt64Array if 64-bit values are needed.

Fields

x: i32

The vector’s X component.

y: i32

The vector’s Y component.

z: i32

The vector’s Z component.

w: i32

The vector’s W component.

Implementations

impl Vector4i

pub const ZERO: Vector4i = _

Zero vector, a vector with all components set to 0.

pub const ONE: Vector4i = _

One vector, a vector with all components set to 1.

impl Vector4i

pub const MIN: Vector4i = _

Min vector, a vector with all components equal to i32::MIN. Can be used as a negative integer equivalent of real::INF.

pub const MAX: Vector4i = _

Max vector, a vector with all components equal to i32::MAX. Can be used as an integer equivalent of real::INF.

impl Vector4i

pub const fn new(x: i32, y: i32, z: i32, w: i32) -> Vector4i

Returns a vector with the given components.

pub const fn splat(v: i32) -> Vector4i

Returns a new vector with all components set to v.

pub fn abs(self) -> Vector4i

Returns a new vector with all components in absolute values (i.e. positive or zero).

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

Returns a new vector with all components clamped between the components of min and max.

Panics

If min > max, min is NaN, or max is NaN.

pub fn length(self) -> f32

Returns the length (magnitude) of this vector.

pub fn length_squared(self) -> i32

Squared length (squared magnitude) of this vector.

Runs faster than Self::length, so prefer it if you need to compare vectors or need the squared distance for some formula.

pub fn coord_min(self, other: Vector4i) -> Vector4i

Returns a new vector containing the minimum of the two vectors, component-wise.

pub fn coord_max(self, other: Vector4i) -> Vector4i

Returns a new vector containing the maximum of the two vectors, component-wise.

pub fn sign(self) -> Vector4i

Returns a new vector with each component set to 1 if it’s positive, -1 if it’s negative, and 0 if it’s zero.

impl Vector4i

pub fn max_axis(self) -> Option<Vector4Axis>

Returns the axis of the vector’s highest value. See Vector4Axis enum. If all components are equal, this method returns None.

To mimic Godot’s behavior, unwrap this function’s result with unwrap_or(Vector4Axis::X).

pub fn min_axis(self) -> Option<Vector4Axis>

Returns the axis of the vector’s lowest value. See Vector4Axis enum. If all components are equal, this method returns None.

To mimic Godot’s behavior, unwrap this function’s result with unwrap_or(Vector4Axis::W).

impl Vector4i

pub fn snapped(self, step: Vector4i) -> Vector4i

A new vector with each component snapped to the closest multiple of the corresponding component in step.

Panics

On under- or overflow:

• If any component of self is i32::MIN while the same component on step is -1.
• If any component of self plus half of the same component of step is not in range on i32.

pub const fn from_vector4(v: Vector4) -> Vector4i

Constructs a new Vector4i from a Vector4. The floating point coordinates will be truncated.

Trait Implementations

impl Add for Vector4i

type Output = Vector4i

The resulting type after applying the + operator.

fn add(self, rhs: Vector4i) -> <Vector4i as Add>::Output

Performs the + operation.

impl AddAssign for Vector4i

fn add_assign(&mut self, rhs: Vector4i)

Performs the += operation.

impl Clone for Vector4i

fn clone(&self) -> Vector4i

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Vector4i

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

Formats the value using the given formatter.

impl Default for Vector4i

fn default() -> Vector4i

Returns the “default value” for a type.

impl Display for Vector4i

Formats the vector like Godot: (x, y, z, w).

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

Formats the value using the given formatter.

impl Div<i32> for Vector4i

type Output = Vector4i

The resulting type after applying the / operator.

fn div(self, rhs: i32) -> <Vector4i as Div<i32>>::Output

Performs the / operation.

impl Div for Vector4i

type Output = Vector4i

The resulting type after applying the / operator.

fn div(self, rhs: Vector4i) -> <Vector4i as Div>::Output

Performs the / operation.

impl DivAssign<i32> for Vector4i

fn div_assign(&mut self, rhs: i32)

Performs the /= operation.

impl DivAssign for Vector4i

fn div_assign(&mut self, rhs: Vector4i)

Performs the /= operation.

impl Export for Vector4i

fn default_export_info() -> PropertyHintInfo

The export info to use for an exported field of this type, if no other export info is specified.

impl FromGodot for Vector4i

fn try_from_godot( via: <Vector4i as GodotConvert>::Via, ) -> Result<Vector4i, ConvertError>

Converts the Godot representation to this type, returning Err on failure.

fn from_godot(via: Self::Via) -> Self

⚠️ Converts the Godot representation to this type.

fn try_from_variant(variant: &Variant) -> Result<Self, ConvertError>

Performs the conversion from a Variant, returning Err on failure.

fn from_variant(variant: &Variant) -> Self

⚠️ Performs the conversion from a Variant.

impl GodotConvert for Vector4i

type Via = Vector4i

The type through which Self is represented in Godot.

impl Hash for Vector4i

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

where __H: Hasher,

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 Index<Vector4Axis> for Vector4i

type Output = i32

The returned type after indexing.

fn index(&self, axis: Vector4Axis) -> &i32

Performs the indexing (container[index]) operation.

impl IndexMut<Vector4Axis> for Vector4i

fn index_mut(&mut self, axis: Vector4Axis) -> &mut i32

Performs the mutable indexing (container[index]) operation.

impl Mul<i32> for Vector4i

type Output = Vector4i

The resulting type after applying the * operator.

fn mul(self, rhs: i32) -> <Vector4i as Mul<i32>>::Output

Performs the * operation.

impl Mul for Vector4i

type Output = Vector4i

The resulting type after applying the * operator.

fn mul(self, rhs: Vector4i) -> <Vector4i as Mul>::Output

Performs the * operation.

impl MulAssign<i32> for Vector4i

fn mul_assign(&mut self, rhs: i32)

Performs the *= operation.

impl MulAssign for Vector4i

fn mul_assign(&mut self, rhs: Vector4i)

Performs the *= operation.

impl Neg for Vector4i

type Output = Vector4i

The resulting type after applying the - operator.

fn neg(self) -> <Vector4i as Neg>::Output

Performs the unary - operation.

impl Ord for Vector4i

fn cmp(&self, other: &Vector4i) -> 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 + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Vector4i

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Vector4i

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl<'a> Product<&'a Vector4i> for Vector4i

fn product<I>(iter: I) -> Vector4i

where I: Iterator<Item = &'a Vector4i>,

Element-wise product of all vectors in the iterator.

impl Product for Vector4i

fn product<I>(iter: I) -> Vector4i

where I: Iterator<Item = Vector4i>,

Element-wise product of all vectors in the iterator.

impl Sub for Vector4i

type Output = Vector4i

The resulting type after applying the - operator.

fn sub(self, rhs: Vector4i) -> <Vector4i as Sub>::Output

Performs the - operation.

impl SubAssign for Vector4i

fn sub_assign(&mut self, rhs: Vector4i)

Performs the -= operation.

impl<'a> Sum<&'a Vector4i> for Vector4i

fn sum<I>(iter: I) -> Vector4i

where I: Iterator<Item = &'a Vector4i>,

Element-wise sum of all vectors in the iterator.

impl Sum for Vector4i

fn sum<I>(iter: I) -> Vector4i

where I: Iterator<Item = Vector4i>,

Element-wise sum of all vectors in the iterator.

impl ToGodot for Vector4i

fn to_godot(&self) -> <Vector4i as GodotConvert>::Via

Converts this type to the Godot type by reference, usually by cloning.

fn into_godot(self) -> <Vector4i as GodotConvert>::Via

Converts this type to the Godot type.

fn to_variant(&self) -> Variant

Converts this type to a Variant.

impl TypeStringHint for Vector4i

fn type_string() -> String

Returns the representation of this type as a type string.

impl Var for Vector4i

fn get_property(&self) -> <Vector4i as GodotConvert>::Via

fn set_property(&mut self, value: <Vector4i as GodotConvert>::Via)

fn property_hint() -> PropertyHintInfo

impl ArrayElement for Vector4i

impl Copy for Vector4i

impl Eq for Vector4i

impl GodotType for Vector4i

impl StructuralPartialEq for Vector4i