Vector3i¶
Vector used for 3D math using integer coordinates.
Description¶
3-element structure that can be used to represent positions in 3D space or any other pair of numeric values.
It uses integer coordinates and is therefore preferable to Vector3 when exact precision is required.
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
.
Tutorials¶
Properties¶
|
||
|
||
|
Constructors¶
Vector3i ( ) |
|
Methods¶
abs ( ) const |
|
length ( ) const |
|
length_squared ( ) const |
|
max_axis_index ( ) const |
|
min_axis_index ( ) const |
|
sign ( ) const |
Operators¶
operator != ( ) |
|
operator != ( Vector3i right ) |
|
operator % ( Vector3i right ) |
|
operator % ( int right ) |
|
operator * ( Vector3i right ) |
|
operator * ( float right ) |
|
operator * ( int right ) |
|
operator + ( Vector3i right ) |
|
operator - ( Vector3i right ) |
|
operator / ( Vector3i right ) |
|
operator / ( float right ) |
|
operator / ( int right ) |
|
operator ( Vector3i right ) |
|
operator ( Vector3i right ) |
|
operator == ( ) |
|
operator == ( Vector3i right ) |
|
operator > ( Vector3i right ) |
|
operator >= ( Vector3i right ) |
|
operator [] ( int index ) |
|
operator unary+ ( ) |
|
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.
ZERO = Vector3i(0, 0, 0) --- Zero vector, a vector with all components set to
0
.ONE = Vector3i(1, 1, 1) --- One vector, a vector with all components set to
1
.LEFT = Vector3i(-1, 0, 0) --- Left unit vector. Represents the local direction of left, and the global direction of west.
RIGHT = Vector3i(1, 0, 0) --- Right unit vector. Represents the local direction of right, and the global direction of east.
UP = Vector3i(0, 1, 0) --- Up unit vector.
DOWN = Vector3i(0, -1, 0) --- Down unit vector.
FORWARD = Vector3i(0, 0, -1) --- Forward unit vector. Represents the local direction of forward, and the global direction of north.
BACK = Vector3i(0, 0, 1) --- Back unit vector. Represents the local direction of back, and the global direction of south.
Property Descriptions¶
int x
Default |
|
The vector's X component. Also accessible by using the index position [0]
.
int y
Default |
|
The vector's Y component. Also accessible by using the index position [1]
.
int z
Default |
|
The vector's Z component. Also accessible by using the index position [2]
.
Constructor Descriptions¶
Vector3i Vector3i ( )
Constructs a default-initialized Vector3i
with all components set to 0
.
Constructs a Vector3i
as a copy of the given Vector3i
.
Constructs a new Vector3i
from Vector3. The floating point coordinates will be truncated.
Returns a Vector3i
with the given components.
Method Descriptions¶
Vector3i abs ( ) const
Returns a new vector with all components in absolute values (i.e. positive).
Returns a new vector with all components clamped between the components of min
and max
, by running @GlobalScope.clamp on each component.
float length ( ) const
Returns the length (magnitude) of this vector.
int length_squared ( ) const
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.
int max_axis_index ( ) const
Returns the axis of the vector's highest value. See AXIS_*
constants. If all components are equal, this method returns AXIS_X.
int min_axis_index ( ) const
Returns the axis of the vector's lowest value. See AXIS_*
constants. If all components are equal, this method returns AXIS_Z.
Vector3i sign ( ) const
Returns the vector with each component set to one or negative one, depending on the signs of the components.
Operator Descriptions¶
bool operator != ( )
Returns true
if the vectors are not equal.
Gets the remainder of each component of the Vector3i
with the components of the given Vector3i
. This operation uses truncated division, which is often not desired as it does not work well with negative numbers. Consider using @GlobalScope.posmod instead if you want to handle negative numbers.
print(Vector3i(10, -20, 30) % Vector3i(7, 8, 9)) # Prints "(3, -4, 3)"
Gets the remainder of each component of the Vector3i
with the the given int. This operation uses truncated division, which is often not desired as it does not work well with negative numbers. Consider using @GlobalScope.posmod instead if you want to handle negative numbers.
print(Vector2i(10, -20, 30) % 7) # Prints "(3, -6, 2)"
Multiplies each component of the Vector3i
by the components of the given Vector3i
.
print(Vector3i(10, 20, 30) * Vector3i(3, 4, 5)) # Prints "(30, 80, 150)"
Multiplies each component of the Vector3i
by the given float. Returns a Vector3.
print(Vector3i(10, 15, 20) * 0.9) # Prints "(9, 13.5, 18)"
Multiplies each component of the Vector3i
by the given int.
Adds each component of the Vector3i
by the components of the given Vector3i
.
print(Vector3i(10, 20, 30) + Vector3i(3, 4, 5)) # Prints "(13, 24, 35)"
Subtracts each component of the Vector3i
by the components of the given Vector3i
.
print(Vector3i(10, 20, 30) - Vector3i(3, 4, 5)) # Prints "(7, 16, 25)"
Divides each component of the Vector3i
by the components of the given Vector3i
.
print(Vector3i(10, 20, 30) / Vector3i(2, 5, 3)) # Prints "(5, 4, 10)"
Divides each component of the Vector3i
by the given float. Returns a Vector3.
print(Vector3i(10, 20, 30) / 2.9) # Prints "(5, 10, 15)"
Divides each component of the Vector3i
by the given int.
Compares two Vector3i
vectors by first checking if the X value of the left vector is less than the X value of the right
vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors, and then with the Z values. This operator is useful for sorting vectors.
Compares two Vector3i
vectors by first checking if the X value of the left vector is less than or equal to the X value of the right
vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors, and then with the Z values. This operator is useful for sorting vectors.
bool operator == ( )
Returns true
if the vectors are equal.
Compares two Vector3i
vectors by first checking if the X value of the left vector is greater than the X value of the right
vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors, and then with the Z values. This operator is useful for sorting vectors.
Compares two Vector3i
vectors by first checking if the X value of the left vector is greater than or equal to the X value of the right
vector. If the X values are exactly equal, then it repeats this check with the Y values of the two vectors, and then with the Z values. This operator is useful for sorting vectors.
Access vector components using their index. v[0]
is equivalent to v.x
, v[1]
is equivalent to v.y
, and v[2]
is equivalent to v.z
.
Vector3i operator unary+ ( )
Returns the same value as if the +
was not there. Unary +
does nothing, but sometimes it can make your code more readable.
Vector3i operator unary- ( )
Returns the negative value of the Vector3i
. This is the same as writing Vector3i(-v.x, -v.y, -v.z)
. This operation flips the direction of the vector while keeping the same magnitude.