Index · Vector3i

Vector3i

A 3D vector using integer coordinates.

Class Description

A 3-element structure that can be used to represent 3D grid coordinates or any other triplet of integers.

It 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 int or PackedInt64Array if 64-bit values are needed.

Note: In a boolean context, a Vector3i will evaluate to false if it's equal to Vector3i(0, 0, 0). Otherwise, a Vector3i will always evaluate to true.

Properties

var x: int = 0

The vector's X component. Also accessible by using the index position [0].

var y: int = 0

The vector's Y component. Also accessible by using the index position [1].

var z: int = 0

The vector's Z component. Also accessible by using the index position [2].

Methods

func abs() -> Vector3i

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

func clamp(min: Vector3i, max: Vector3i) -> Vector3i

Returns a new vector with all components clamped between the components of min and max, by running clamp() on each component.

func clampi(min: int, max: int) -> Vector3i

Returns a new vector with all components clamped between min and max, by running clamp() on each component.

func distance_squared_to(to: Vector3i) -> int

Returns the squared Euclidean distance between this vector and to.

This method runs faster than distance_to(), so prefer it if you need to compare vectors or need the squared distance for some formula.

func distance_to(to: Vector3i) -> float

Returns the Euclidean distance between this vector and to.

func length() -> float

Returns the length (magnitude) of this vector.

func length_squared() -> int

Returns the squared length (squared magnitude) of this vector.

This method runs faster than length(), so prefer it if you need to compare vectors or need the squared distance for some formula.

func max(with: Vector3i) -> Vector3i

Returns the component-wise maximum of this and with, equivalent to Vector3i(maxi(x, with.x), maxi(y, with.y), maxi(z, with.z)).

func max_axis_index() -> int

Returns the axis of the vector's highest value. See AXIS_* constants. If all components are equal, this method returns AXIS_X.

func maxi(with: int) -> Vector3i

Returns the component-wise maximum of this and with, equivalent to Vector3i(maxi(x, with), maxi(y, with), maxi(z, with)).

func min(with: Vector3i) -> Vector3i

Returns the component-wise minimum of this and with, equivalent to Vector3i(mini(x, with.x), mini(y, with.y), mini(z, with.z)).

func min_axis_index() -> int

Returns the axis of the vector's lowest value. See AXIS_* constants. If all components are equal, this method returns AXIS_Z.

func mini(with: int) -> Vector3i

Returns the component-wise minimum of this and with, equivalent to Vector3i(mini(x, with), mini(y, with), mini(z, with)).

func sign() -> Vector3i

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. The result is identical to calling sign() on each component.

func snapped(step: Vector3i) -> Vector3i

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

func snappedi(step: int) -> Vector3i

Returns a new vector with each component snapped to the closest multiple of step.

Enums & Constants

enum Axis
AXIS_X = 0

Enumerated value for the X axis. Returned by max_axis_index() and min_axis_index().

AXIS_Y = 1

Enumerated value for the Y axis. Returned by max_axis_index() and min_axis_index().

AXIS_Z = 2

Enumerated value for the Z axis. Returned by max_axis_index() and min_axis_index().

const ZERO = Vector3i(0, 0, 0)

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

const ONE = Vector3i(1, 1, 1)

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

const MIN = Vector3i(-2147483648, -2147483648, -2147483648)

Min vector, a vector with all components equal to INT32_MIN. Can be used as a negative integer equivalent of Vector3.INF.

const MAX = Vector3i(2147483647, 2147483647, 2147483647)

Max vector, a vector with all components equal to INT32_MAX. Can be used as an integer equivalent of Vector3.INF.

const LEFT = Vector3i(-1, 0, 0)

Left unit vector. Represents the local direction of left, and the global direction of west.

const RIGHT = Vector3i(1, 0, 0)

Right unit vector. Represents the local direction of right, and the global direction of east.

const UP = Vector3i(0, 1, 0)

Up unit vector.

const DOWN = Vector3i(0, -1, 0)

Down unit vector.

const FORWARD = Vector3i(0, 0, -1)

Forward unit vector. Represents the local direction of forward, and the global direction of north.

const BACK = Vector3i(0, 0, 1)

Back unit vector. Represents the local direction of back, and the global direction of south.