:github_url: hide .. DO NOT EDIT THIS FILE!!! .. Generated automatically from Godot engine sources. .. Generator: https://github.com/godotengine/godot/tree/4.0/doc/tools/make_rst.py. .. XML source: https://github.com/godotengine/godot/tree/4.0/doc/classes/Vector4i.xml. .. _class_Vector4i: Vector4i ======== A 4D vector using integer coordinates. .. rst-class:: classref-introduction-group 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 :ref:`Vector4` when exact precision is required. Note that the values are limited to 32 bits, and unlike :ref:`Vector4` this cannot be configured with an engine build option. Use :ref:`int` or :ref:`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``. .. rst-class:: classref-reftable-group Properties ---------- .. table:: :widths: auto +-----------------------+-------------------------------------+-------+ | :ref:`int` | :ref:`w` | ``0`` | +-----------------------+-------------------------------------+-------+ | :ref:`int` | :ref:`x` | ``0`` | +-----------------------+-------------------------------------+-------+ | :ref:`int` | :ref:`y` | ``0`` | +-----------------------+-------------------------------------+-------+ | :ref:`int` | :ref:`z` | ``0`` | +-----------------------+-------------------------------------+-------+ .. rst-class:: classref-reftable-group Constructors ------------ .. table:: :widths: auto +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`Vector4i` **(** **)** | +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`Vector4i` **(** :ref:`Vector4i` from **)** | +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`Vector4i` **(** :ref:`Vector4` from **)** | +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`Vector4i` **(** :ref:`int` x, :ref:`int` y, :ref:`int` z, :ref:`int` w **)** | +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Methods ------- .. table:: :widths: auto +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`abs` **(** **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`clamp` **(** :ref:`Vector4i` min, :ref:`Vector4i` max **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`length` **(** **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`length_squared` **(** **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`max_axis_index` **(** **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`min_axis_index` **(** **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`sign` **(** **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`snapped` **(** :ref:`Vector4i` step **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Operators --------- .. table:: :widths: auto +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator !=` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator %` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator %` **(** :ref:`int` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator *` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4` | :ref:`operator *` **(** :ref:`float` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator *` **(** :ref:`int` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator +` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator -` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator /` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4` | :ref:`operator /` **(** :ref:`float` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator /` **(** :ref:`int` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator \<` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator \<=` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator ==` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator >` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator >=` **(** :ref:`Vector4i` right **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`operator []` **(** :ref:`int` index **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator unary+` **(** **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ | :ref:`Vector4i` | :ref:`operator unary-` **(** **)** | +---------------------------------+-------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Constants --------- .. _class_Vector4i_constant_AXIS_X: .. rst-class:: classref-constant **AXIS_X** = ``0`` Enumerated value for the X axis. Returned by :ref:`max_axis_index` and :ref:`min_axis_index`. .. _class_Vector4i_constant_AXIS_Y: .. rst-class:: classref-constant **AXIS_Y** = ``1`` Enumerated value for the Y axis. Returned by :ref:`max_axis_index` and :ref:`min_axis_index`. .. _class_Vector4i_constant_AXIS_Z: .. rst-class:: classref-constant **AXIS_Z** = ``2`` Enumerated value for the Z axis. Returned by :ref:`max_axis_index` and :ref:`min_axis_index`. .. _class_Vector4i_constant_AXIS_W: .. rst-class:: classref-constant **AXIS_W** = ``3`` Enumerated value for the W axis. Returned by :ref:`max_axis_index` and :ref:`min_axis_index`. .. _class_Vector4i_constant_ZERO: .. rst-class:: classref-constant **ZERO** = ``Vector4i(0, 0, 0, 0)`` Zero vector, a vector with all components set to ``0``. .. _class_Vector4i_constant_ONE: .. rst-class:: classref-constant **ONE** = ``Vector4i(1, 1, 1, 1)`` One vector, a vector with all components set to ``1``. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Property Descriptions --------------------- .. _class_Vector4i_property_w: .. rst-class:: classref-property :ref:`int` **w** = ``0`` The vector's W component. Also accessible by using the index position ``[3]``. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_property_x: .. rst-class:: classref-property :ref:`int` **x** = ``0`` The vector's X component. Also accessible by using the index position ``[0]``. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_property_y: .. rst-class:: classref-property :ref:`int` **y** = ``0`` The vector's Y component. Also accessible by using the index position ``[1]``. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_property_z: .. rst-class:: classref-property :ref:`int` **z** = ``0`` The vector's Z component. Also accessible by using the index position ``[2]``. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Constructor Descriptions ------------------------ .. _class_Vector4i_constructor_Vector4i: .. rst-class:: classref-constructor :ref:`Vector4i` **Vector4i** **(** **)** Constructs a default-initialized **Vector4i** with all components set to ``0``. .. rst-class:: classref-item-separator ---- .. rst-class:: classref-constructor :ref:`Vector4i` **Vector4i** **(** :ref:`Vector4i` from **)** Constructs a **Vector4i** as a copy of the given **Vector4i**. .. rst-class:: classref-item-separator ---- .. rst-class:: classref-constructor :ref:`Vector4i` **Vector4i** **(** :ref:`Vector4` from **)** Constructs a new **Vector4i** from the given :ref:`Vector4` by truncating components' fractional parts (rounding towards zero). For a different behavior consider passing the result of :ref:`Vector4.ceil`, :ref:`Vector4.floor` or :ref:`Vector4.round` to this constructor instead. .. rst-class:: classref-item-separator ---- .. rst-class:: classref-constructor :ref:`Vector4i` **Vector4i** **(** :ref:`int` x, :ref:`int` y, :ref:`int` z, :ref:`int` w **)** Returns a **Vector4i** with the given components. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Method Descriptions ------------------- .. _class_Vector4i_method_abs: .. rst-class:: classref-method :ref:`Vector4i` **abs** **(** **)** |const| Returns a new vector with all components in absolute values (i.e. positive). .. rst-class:: classref-item-separator ---- .. _class_Vector4i_method_clamp: .. rst-class:: classref-method :ref:`Vector4i` **clamp** **(** :ref:`Vector4i` min, :ref:`Vector4i` max **)** |const| Returns a new vector with all components clamped between the components of ``min`` and ``max``, by running :ref:`@GlobalScope.clamp` on each component. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_method_length: .. rst-class:: classref-method :ref:`float` **length** **(** **)** |const| Returns the length (magnitude) of this vector. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_method_length_squared: .. rst-class:: classref-method :ref:`int` **length_squared** **(** **)** |const| Returns the squared length (squared magnitude) of this vector. This method runs faster than :ref:`length`, so prefer it if you need to compare vectors or need the squared distance for some formula. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_method_max_axis_index: .. rst-class:: classref-method :ref:`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 :ref:`AXIS_X`. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_method_min_axis_index: .. rst-class:: classref-method :ref:`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 :ref:`AXIS_W`. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_method_sign: .. rst-class:: classref-method :ref:`Vector4i` **sign** **(** **)** |const| 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 :ref:`@GlobalScope.sign` on each component. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_method_snapped: .. rst-class:: classref-method :ref:`Vector4i` **snapped** **(** :ref:`Vector4i` step **)** |const| Returns a new vector with each component snapped to the closest multiple of the corresponding component in ``step``. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Operator Descriptions --------------------- .. _class_Vector4i_operator_neq_Vector4i: .. rst-class:: classref-operator :ref:`bool` **operator !=** **(** :ref:`Vector4i` right **)** Returns ``true`` if the vectors are not equal. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_mod_Vector4i: .. rst-class:: classref-operator :ref:`Vector4i` **operator %** **(** :ref:`Vector4i` right **)** Gets the remainder of each component of the **Vector4i** with the components of the given **Vector4i**. This operation uses truncated division, which is often not desired as it does not work well with negative numbers. Consider using :ref:`@GlobalScope.posmod` instead if you want to handle negative numbers. :: print(Vector4i(10, -20, 30, -40) % Vector4i(7, 8, 9, 10)) # Prints "(3, -4, 3, 0)" .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_mod_int: .. rst-class:: classref-operator :ref:`Vector4i` **operator %** **(** :ref:`int` right **)** Gets the remainder of each component of the **Vector4i** with the the given :ref:`int`. This operation uses truncated division, which is often not desired as it does not work well with negative numbers. Consider using :ref:`@GlobalScope.posmod` instead if you want to handle negative numbers. :: print(Vector4i(10, -20, 30, -40) % 7) # Prints "(3, -6, 2, -5)" .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_mul_Vector4i: .. rst-class:: classref-operator :ref:`Vector4i` **operator *** **(** :ref:`Vector4i` right **)** Multiplies each component of the **Vector4i** by the components of the given **Vector4i**. :: print(Vector4i(10, 20, 30, 40) * Vector4i(3, 4, 5, 6)) # Prints "(30, 80, 150, 240)" .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_mul_float: .. rst-class:: classref-operator :ref:`Vector4` **operator *** **(** :ref:`float` right **)** Multiplies each component of the **Vector4i** by the given :ref:`float`. Returns a Vector4 value due to floating-point operations. :: print(Vector4i(10, 20, 30, 40) * 2) # Prints "(20, 40, 60, 80)" .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_mul_int: .. rst-class:: classref-operator :ref:`Vector4i` **operator *** **(** :ref:`int` right **)** Multiplies each component of the **Vector4i** by the given :ref:`int`. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_sum_Vector4i: .. rst-class:: classref-operator :ref:`Vector4i` **operator +** **(** :ref:`Vector4i` right **)** Adds each component of the **Vector4i** by the components of the given **Vector4i**. :: print(Vector4i(10, 20, 30, 40) + Vector4i(3, 4, 5, 6)) # Prints "(13, 24, 35, 46)" .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_dif_Vector4i: .. rst-class:: classref-operator :ref:`Vector4i` **operator -** **(** :ref:`Vector4i` right **)** Subtracts each component of the **Vector4i** by the components of the given **Vector4i**. :: print(Vector4i(10, 20, 30, 40) - Vector4i(3, 4, 5, 6)) # Prints "(7, 16, 25, 34)" .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_div_Vector4i: .. rst-class:: classref-operator :ref:`Vector4i` **operator /** **(** :ref:`Vector4i` right **)** Divides each component of the **Vector4i** by the components of the given **Vector4i**. :: print(Vector4i(10, 20, 30, 40) / Vector4i(2, 5, 3, 4)) # Prints "(5, 4, 10, 10)" .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_div_float: .. rst-class:: classref-operator :ref:`Vector4` **operator /** **(** :ref:`float` right **)** Divides each component of the **Vector4i** by the given :ref:`float`. Returns a Vector4 value due to floating-point operations. :: print(Vector4i(10, 20, 30, 40) / 2 # Prints "(5, 10, 15, 20)" .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_div_int: .. rst-class:: classref-operator :ref:`Vector4i` **operator /** **(** :ref:`int` right **)** Divides each component of the **Vector4i** by the given :ref:`int`. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_lt_Vector4i: .. rst-class:: classref-operator :ref:`bool` **operator <** **(** :ref:`Vector4i` right **)** Compares two **Vector4i** 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, Z values of the two vectors, and then with the W values. This operator is useful for sorting vectors. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_lte_Vector4i: .. rst-class:: classref-operator :ref:`bool` **operator <=** **(** :ref:`Vector4i` right **)** Compares two **Vector4i** 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, Z values of the two vectors, and then with the W values. This operator is useful for sorting vectors. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_eq_Vector4i: .. rst-class:: classref-operator :ref:`bool` **operator ==** **(** :ref:`Vector4i` right **)** Returns ``true`` if the vectors are exactly equal. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_gt_Vector4i: .. rst-class:: classref-operator :ref:`bool` **operator >** **(** :ref:`Vector4i` right **)** Compares two **Vector4i** 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, Z values of the two vectors, and then with the W values. This operator is useful for sorting vectors. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_gte_Vector4i: .. rst-class:: classref-operator :ref:`bool` **operator >=** **(** :ref:`Vector4i` right **)** Compares two **Vector4i** 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, Z values of the two vectors, and then with the W values. This operator is useful for sorting vectors. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_idx_int: .. rst-class:: classref-operator :ref:`int` **operator []** **(** :ref:`int` index **)** Access vector components using their ``index``. ``v[0]`` is equivalent to ``v.x``, ``v[1]`` is equivalent to ``v.y``, ``v[2]`` is equivalent to ``v.z``, and ``v[3]`` is equivalent to ``v.w``. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_unplus: .. rst-class:: classref-operator :ref:`Vector4i` **operator unary+** **(** **)** Returns the same value as if the ``+`` was not there. Unary ``+`` does nothing, but sometimes it can make your code more readable. .. rst-class:: classref-item-separator ---- .. _class_Vector4i_operator_unminus: .. rst-class:: classref-operator :ref:`Vector4i` **operator unary-** **(** **)** Returns the negative value of the **Vector4i**. This is the same as writing ``Vector4i(-v.x, -v.y, -v.z, -v.w)``. This operation flips the direction of the vector while keeping the same magnitude. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)` .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)` .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)` .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)` .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)` .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`