godot::prelude

Struct Vector3i

#[repr(C)]
pub struct Vector3i { pub x: i32, pub y: i32, pub z: i32, }
Expand description

Vector used for 3D math using integer coordinates.

3-element structure that can be used to represent discrete positions or directions in 3D space, as well as any other triple of numeric values.

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

Conversions are provided via various from_* and to_* functions, not via the From trait. This encourages new() as the main way to construct vectors, is explicit about the conversion taking place, needs no type inference, and works in const contexts.

§All vector types

DimensionFloating-pointInteger
2DVector2Vector2i
3DVector3Vector3i
4DVector4Vector4i


You can convert to 2D vectors using to_2d(), and to Vector3 using cast_float().

§Godot docs

Vector3i (stable)

Fields§

§x: i32

The vector’s X component.

§y: i32

The vector’s Y component.

§z: i32

The vector’s Z component.

Implementations§

§

impl Vector3i

§Constants

pub const ZERO: Vector3i = _

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

pub const ONE: Vector3i = _

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

pub const MIN: Vector3i = _

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: Vector3i = _

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

pub const LEFT: Vector3i = _

Unit vector in -X direction. Can be interpreted as left in an untransformed 3D world.

pub const RIGHT: Vector3i = _

Unit vector in +X direction. Can be interpreted as right in an untransformed 3D world.

pub const UP: Vector3i = _

Unit vector in +Y direction. Typically interpreted as up in a 3D world.

pub const DOWN: Vector3i = _

Unit vector in -Y direction. Typically interpreted as down in a 3D world.

pub const FORWARD: Vector3i = _

Unit vector in -Z direction. Can be interpreted as “into the screen” in an untransformed 3D world.

pub const BACK: Vector3i = _

Unit vector in +Z direction. Can be interpreted as “out of the screen” in an untransformed 3D world.

§

impl Vector3i

§Constructors and general vector functions

The following associated functions and methods are available on all vectors (2D, 3D, 4D; float and int).

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

Creates a vector with the given components.

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

Creates a vector with all components set to v.

pub const fn from_tuple(tuple: (i32, i32, i32)) -> Vector3i

Creates a vector from the given tuple.

pub const fn from_array(array: [i32; 3]) -> Vector3i

Creates a vector from the given array.

pub const fn to_tuple(&self) -> (i32, i32, i32)

Returns a tuple with the components of the vector.

pub const fn to_array(&self) -> [i32; 3]

Returns an array with the components of the vector.

pub fn abs(self) -> Vector3i

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

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

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 length(), so prefer it if you need to compare vectors or need the squared distance for some formula.

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

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

You may consider using the fully-qualified syntax Vector3i::coord_min(a, b) for symmetry.

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

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

You may consider using the fully-qualified syntax Vector3i::coord_max(a, b) for symmetry.

pub fn sign(self) -> Vector3i

Returns a new vector with each component set to 1 if the component is positive, -1 if negative, and 0 if zero.

§

impl Vector3i

§Specialized Vector3i functions

pub const fn from_vector3(v: Vector3) -> Vector3i

👎Deprecated: Moved to Vector3::cast_int()

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

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 cast_float(self) -> Vector3

Converts to a vector with floating-point real components, using as casts.

§

impl Vector3i

§3D functions

The following methods are only available on 3D vectors (for both float and int).

pub fn to_2d(self) -> Vector2i

Reduces dimension to 2D, discarding the Z component.

See also swizzle! for a more general way to extract components. self.to_2d() is equivalent to swizzle!(self => x, y).

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

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

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

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

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

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

Trait Implementations§

§

impl Add for Vector3i

§

type Output = Vector3i

The resulting type after applying the + operator.
§

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

Performs the + operation. Read more
§

impl AddAssign for Vector3i

§

fn add_assign(&mut self, rhs: Vector3i)

Performs the += operation. Read more
§

impl ArrayElement for Vector3i

§

impl Clone for Vector3i

§

fn clone(&self) -> Vector3i

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
§

impl Debug for Vector3i

§

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

Formats the value using the given formatter. Read more
§

impl Default for Vector3i

§

fn default() -> Vector3i

Returns the “default value” for a type. Read more
§

impl Display for Vector3i

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

§

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

Formats the value using the given formatter. Read more
§

impl Div<i32> for Vector3i

§

type Output = Vector3i

The resulting type after applying the / operator.
§

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

Performs the / operation. Read more
§

impl Div for Vector3i

§

type Output = Vector3i

The resulting type after applying the / operator.
§

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

Performs the / operation. Read more
§

impl DivAssign<i32> for Vector3i

§

fn div_assign(&mut self, rhs: i32)

Performs the /= operation. Read more
§

impl DivAssign for Vector3i

§

fn div_assign(&mut self, rhs: Vector3i)

Performs the /= operation. Read more
§

impl Export for Vector3i

§

fn export_hint() -> PropertyHintInfo

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

fn as_node_class() -> Option<ClassName>

If this is a class inheriting Node, returns the ClassName; otherwise None. Read more
§

impl FromGodot for Vector3i

§

fn try_from_godot( via: <Vector3i as GodotConvert>::Via, ) -> Result<Vector3i, 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. Read more
§

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. Read more
§

impl GodotConvert for Vector3i

§

type Via = Vector3i

The type through which Self is represented in Godot.
§

impl Hash for Vector3i

§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
§

impl Index<Vector3Axis> for Vector3i

§

type Output = i32

The returned type after indexing.
§

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

Performs the indexing (container[index]) operation. Read more
§

impl IndexMut<Vector3Axis> for Vector3i

§

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

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

impl Mul<i32> for Vector3i

§

type Output = Vector3i

The resulting type after applying the * operator.
§

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

Performs the * operation. Read more
§

impl Mul for Vector3i

§

type Output = Vector3i

The resulting type after applying the * operator.
§

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

Performs the * operation. Read more
§

impl MulAssign<i32> for Vector3i

§

fn mul_assign(&mut self, rhs: i32)

Performs the *= operation. Read more
§

impl MulAssign for Vector3i

§

fn mul_assign(&mut self, rhs: Vector3i)

Performs the *= operation. Read more
§

impl Neg for Vector3i

§

type Output = Vector3i

The resulting type after applying the - operator.
§

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

Performs the unary - operation. Read more
§

impl Ord for Vector3i

§

fn cmp(&self, other: &Vector3i) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
§

impl PartialEq for Vector3i

§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl PartialOrd for Vector3i

§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

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

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
§

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

§

fn product<I>(iter: I) -> Vector3i
where I: Iterator<Item = &'a Vector3i>,

Element-wise product of all vectors in the iterator.

§

impl Product for Vector3i

§

fn product<I>(iter: I) -> Vector3i
where I: Iterator<Item = Vector3i>,

Element-wise product of all vectors in the iterator.

§

impl Sub for Vector3i

§

type Output = Vector3i

The resulting type after applying the - operator.
§

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

Performs the - operation. Read more
§

impl SubAssign for Vector3i

§

fn sub_assign(&mut self, rhs: Vector3i)

Performs the -= operation. Read more
§

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

§

fn sum<I>(iter: I) -> Vector3i
where I: Iterator<Item = &'a Vector3i>,

Element-wise sum of all vectors in the iterator.

§

impl Sum for Vector3i

§

fn sum<I>(iter: I) -> Vector3i
where I: Iterator<Item = Vector3i>,

Element-wise sum of all vectors in the iterator.

§

impl ToGodot for Vector3i

§

type ToVia<'v> = <Vector3i as GodotConvert>::Via

Target type of to_godot(), which differs from Via for pass-by-reference types.
§

fn to_godot(&self) -> <Vector3i as ToGodot>::ToVia<'_>

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

fn to_variant(&self) -> Variant

Converts this type to a Variant.
§

impl Var for Vector3i

§

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

§

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

§

fn var_hint() -> PropertyHintInfo

Specific property hints, only override if they deviate from GodotType::property_info, e.g. for enums/newtypes.
§

impl Copy for Vector3i

§

impl Eq for Vector3i

§

impl GodotType for Vector3i

§

impl StructuralPartialEq for Vector3i

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.