:github_url: hide .. DO NOT EDIT THIS FILE!!! .. Generated automatically from Godot engine sources. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/Vector3i.xml. .. _class_Vector3i: 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 triplet of numeric values. It uses integer coordinates and is therefore preferable to :ref:`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 --------- - :doc:`Math documentation index <../tutorials/math/index>` - :doc:`Vector math <../tutorials/math/vector_math>` - `3Blue1Brown Essence of Linear Algebra `__ Properties ---------- +-----------------------+-------------------------------------+-------+ | :ref:`int` | :ref:`x` | ``0`` | +-----------------------+-------------------------------------+-------+ | :ref:`int` | :ref:`y` | ``0`` | +-----------------------+-------------------------------------+-------+ | :ref:`int` | :ref:`z` | ``0`` | +-----------------------+-------------------------------------+-------+ Constructors ------------ +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`Vector3i` **(** **)** | +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`Vector3i` **(** :ref:`Vector3i` from **)** | +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`Vector3i` **(** :ref:`Vector3` from **)** | +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`Vector3i` **(** :ref:`int` x, :ref:`int` y, :ref:`int` z **)** | +---------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------+ Methods ------- +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`abs` **(** **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`clamp` **(** :ref:`Vector3i` min, :ref:`Vector3i` 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:`Vector3i` | :ref:`sign` **(** **)** |const| | +---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------+ Operators --------- +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator !=` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator %` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator %` **(** :ref:`int` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator *` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`operator *` **(** :ref:`float` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator *` **(** :ref:`int` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator +` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator -` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator /` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`operator /` **(** :ref:`float` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator /` **(** :ref:`int` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator <` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator <=` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator ==` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator >` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`operator >=` **(** :ref:`Vector3i` right **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`operator []` **(** :ref:`int` index **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator unary+` **(** **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ | :ref:`Vector3i` | :ref:`operator unary-` **(** **)** | +---------------------------------+-----------------------------------------------------------------------------------------------------------+ Constants --------- .. _class_Vector3i_constant_AXIS_X: .. _class_Vector3i_constant_AXIS_Y: .. _class_Vector3i_constant_AXIS_Z: .. _class_Vector3i_constant_ZERO: .. _class_Vector3i_constant_ONE: .. _class_Vector3i_constant_LEFT: .. _class_Vector3i_constant_RIGHT: .. _class_Vector3i_constant_UP: .. _class_Vector3i_constant_DOWN: .. _class_Vector3i_constant_FORWARD: .. _class_Vector3i_constant_BACK: - **AXIS_X** = **0** --- Enumerated value for the X axis. Returned by :ref:`max_axis_index` and :ref:`min_axis_index`. - **AXIS_Y** = **1** --- Enumerated value for the Y axis. Returned by :ref:`max_axis_index` and :ref:`min_axis_index`. - **AXIS_Z** = **2** --- Enumerated value for the Z axis. Returned by :ref:`max_axis_index` and :ref:`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 --------------------- .. _class_Vector3i_property_x: - :ref:`int` **x** +-----------+-------+ | *Default* | ``0`` | +-----------+-------+ The vector's X component. Also accessible by using the index position ``[0]``. ---- .. _class_Vector3i_property_y: - :ref:`int` **y** +-----------+-------+ | *Default* | ``0`` | +-----------+-------+ The vector's Y component. Also accessible by using the index position ``[1]``. ---- .. _class_Vector3i_property_z: - :ref:`int` **z** +-----------+-------+ | *Default* | ``0`` | +-----------+-------+ The vector's Z component. Also accessible by using the index position ``[2]``. Constructor Descriptions ------------------------ .. _class_Vector3i_constructor_Vector3i: - :ref:`Vector3i` **Vector3i** **(** **)** Constructs a default-initialized ``Vector3i`` with all components set to ``0``. ---- - :ref:`Vector3i` **Vector3i** **(** :ref:`Vector3i` from **)** Constructs a ``Vector3i`` as a copy of the given ``Vector3i``. ---- - :ref:`Vector3i` **Vector3i** **(** :ref:`Vector3` from **)** Constructs a new ``Vector3i`` from :ref:`Vector3`. The floating point coordinates will be truncated. ---- - :ref:`Vector3i` **Vector3i** **(** :ref:`int` x, :ref:`int` y, :ref:`int` z **)** Returns a ``Vector3i`` with the given components. Method Descriptions ------------------- .. _class_Vector3i_method_abs: - :ref:`Vector3i` **abs** **(** **)** |const| Returns a new vector with all components in absolute values (i.e. positive). ---- .. _class_Vector3i_method_clamp: - :ref:`Vector3i` **clamp** **(** :ref:`Vector3i` min, :ref:`Vector3i` 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. ---- .. _class_Vector3i_method_length: - :ref:`float` **length** **(** **)** |const| Returns the length (magnitude) of this vector. ---- .. _class_Vector3i_method_length_squared: - :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. ---- .. _class_Vector3i_method_max_axis_index: - :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`. ---- .. _class_Vector3i_method_min_axis_index: - :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_Z`. ---- .. _class_Vector3i_method_sign: - :ref:`Vector3i` **sign** **(** **)** |const| Returns the vector with each component set to one or negative one, depending on the signs of the components. Operator Descriptions --------------------- .. _class_Vector3i_operator_neq_bool: - :ref:`bool` **operator !=** **(** :ref:`Vector3i` right **)** Returns ``true`` if the vectors are not equal. ---- .. _class_Vector3i_operator_mod_Vector3i: - :ref:`Vector3i` **operator %** **(** :ref:`Vector3i` right **)** 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 :ref:`@GlobalScope.posmod` instead if you want to handle negative numbers. :: print(Vector3i(10, -20, 30) % Vector3i(7, 8, 9)) # Prints "(3, -4, 3)" ---- - :ref:`Vector3i` **operator %** **(** :ref:`int` right **)** Gets the remainder of each component of the ``Vector3i`` 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(Vector3i(10, -20, 30) % 7) # Prints "(3, -6, 2)" ---- .. _class_Vector3i_operator_mul_Vector3i: - :ref:`Vector3i` **operator *** **(** :ref:`Vector3i` right **)** 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)" ---- - :ref:`Vector3` **operator *** **(** :ref:`float` right **)** Multiplies each component of the ``Vector3i`` by the given :ref:`float`. Returns a :ref:`Vector3`. :: print(Vector3i(10, 15, 20) * 0.9) # Prints "(9, 13.5, 18)" ---- - :ref:`Vector3i` **operator *** **(** :ref:`int` right **)** Multiplies each component of the ``Vector3i`` by the given :ref:`int`. ---- .. _class_Vector3i_operator_sum_Vector3i: - :ref:`Vector3i` **operator +** **(** :ref:`Vector3i` right **)** 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)" ---- .. _class_Vector3i_operator_dif_Vector3i: - :ref:`Vector3i` **operator -** **(** :ref:`Vector3i` right **)** 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)" ---- .. _class_Vector3i_operator_div_Vector3i: - :ref:`Vector3i` **operator /** **(** :ref:`Vector3i` right **)** 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)" ---- - :ref:`Vector3` **operator /** **(** :ref:`float` right **)** Divides each component of the ``Vector3i`` by the given :ref:`float`. Returns a :ref:`Vector3`. :: print(Vector3i(10, 20, 30) / 2.9) # Prints "(5, 10, 15)" ---- - :ref:`Vector3i` **operator /** **(** :ref:`int` right **)** Divides each component of the ``Vector3i`` by the given :ref:`int`. ---- .. _class_Vector3i_operator_lt_bool: - :ref:`bool` **operator <** **(** :ref:`Vector3i` right **)** 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. ---- .. _class_Vector3i_operator_lte_bool: - :ref:`bool` **operator <=** **(** :ref:`Vector3i` right **)** 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. ---- .. _class_Vector3i_operator_eq_bool: - :ref:`bool` **operator ==** **(** :ref:`Vector3i` right **)** Returns ``true`` if the vectors are equal. ---- .. _class_Vector3i_operator_gt_bool: - :ref:`bool` **operator >** **(** :ref:`Vector3i` right **)** 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. ---- .. _class_Vector3i_operator_gte_bool: - :ref:`bool` **operator >=** **(** :ref:`Vector3i` right **)** 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. ---- .. _class_Vector3i_operator_idx_int: - :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``, and ``v[2]`` is equivalent to ``v.z``. ---- .. _class_Vector3i_operator_unplus_Vector3i: - :ref:`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. ---- .. _class_Vector3i_operator_unminus_Vector3i: - :ref:`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. .. |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.)`