Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Vector4i

A 4D vector using integer coordinates.

Description

A 4-element structure that can be used to represent 4D grid coordinates or any other quadruplet 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 int or PackedInt64Array if 64-bit values are needed.

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

Properties

int

w

0

int

x

0

int

y

0

int

z

0

Constructors

Vector4i

Vector4i ( )

Vector4i

Vector4i ( Vector4i from )

Vector4i

Vector4i ( Vector4 from )

Vector4i

Vector4i ( int x, int y, int z, int w )

Methods

Vector4i

abs ( ) const

Vector4i

clamp ( Vector4i min, Vector4i max ) const

float

length ( ) const

int

length_squared ( ) const

int

max_axis_index ( ) const

int

min_axis_index ( ) const

Vector4i

sign ( ) const

Vector4i

snapped ( Vector4i step ) const

Operators

bool

operator != ( Vector4i right )

Vector4i

operator % ( Vector4i right )

Vector4i

operator % ( int right )

Vector4i

operator * ( Vector4i right )

Vector4

operator * ( float right )

Vector4i

operator * ( int right )

Vector4i

operator + ( Vector4i right )

Vector4i

operator - ( Vector4i right )

Vector4i

operator / ( Vector4i right )

Vector4

operator / ( float right )

Vector4i

operator / ( int right )

bool

operator < ( Vector4i right )

bool

operator <= ( Vector4i right )

bool

operator == ( Vector4i right )

bool

operator > ( Vector4i right )

bool

operator >= ( Vector4i right )

int

operator [] ( int index )

Vector4i

operator unary+ ( )

Vector4i

operator unary- ( )


Constants

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.

AXIS_W = 3

Enumerated value for the W axis. Returned by max_axis_index and min_axis_index.

ZERO = Vector4i(0, 0, 0, 0)

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

ONE = Vector4i(1, 1, 1, 1)

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

MIN = Vector4i(-2147483648, -2147483648, -2147483648, -2147483648)

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

MAX = Vector4i(2147483647, 2147483647, 2147483647, 2147483647)

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


Property Descriptions

int w = 0

The vector's W component. Also accessible by using the index position [3].


int x = 0

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


int y = 0

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


int z = 0

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


Constructor Descriptions

Vector4i Vector4i ( )

Constructs a default-initialized Vector4i with all components set to 0.


Vector4i Vector4i ( Vector4i from )

Constructs a Vector4i as a copy of the given Vector4i.


Vector4i Vector4i ( Vector4 from )

Constructs a new Vector4i from the given Vector4 by truncating components' fractional parts (rounding towards zero). For a different behavior consider passing the result of Vector4.ceil, Vector4.floor or Vector4.round to this constructor instead.


Vector4i Vector4i (