mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
847 lines
37 KiB
ReStructuredText
847 lines
37 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. _class_Vector3i:
|
|
|
|
Vector3i
|
|
========
|
|
|
|
Un vector 3D que utiliza coordenadas enteras.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Descripción
|
|
----------------------
|
|
|
|
Una estructura de 3 elementos que puede usarse para representar coordenadas de cuadrícula 3D o cualquier otro triplete de enteros.
|
|
|
|
Utiliza coordenadas enteras y, por lo tanto, es preferible a :ref:`Vector3<class_Vector3>` cuando se requiere precisión exacta. Ten en cuenta que los valores están limitados a 32 bits y, a diferencia de :ref:`Vector3<class_Vector3>`, esto no se puede configurar con una opción de compilación del motor. Utiliza :ref:`int<class_int>` o :ref:`PackedInt64Array<class_PackedInt64Array>` si necesitan valores de 64 bits.
|
|
|
|
\ **Nota:** En un contexto booleano, un Vector3i se evaluará como ``false`` si es igual a ``Vector3i(0, 0, 0)``. De lo contrario, un Vector3i siempre se evaluará como ``true``.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Tutoriales
|
|
--------------------
|
|
|
|
- :doc:`Índice de documentación matemática <../tutorials/math/index>`
|
|
|
|
- :doc:`Matemáticas vectoriales <../tutorials/math/vector_math>`
|
|
|
|
- `Esencia del álgebra lineal de 3Blue1Brown <https://www.youtube.com/playlist?list=PLZHQObOWTQDPD3MizzM2xVFitgF8hE_ab>`__
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Propiedades
|
|
----------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+-----------------------+-------------------------------------+-------+
|
|
| :ref:`int<class_int>` | :ref:`x<class_Vector3i_property_x>` | ``0`` |
|
|
+-----------------------+-------------------------------------+-------+
|
|
| :ref:`int<class_int>` | :ref:`y<class_Vector3i_property_y>` | ``0`` |
|
|
+-----------------------+-------------------------------------+-------+
|
|
| :ref:`int<class_int>` | :ref:`z<class_Vector3i_property_z>` | ``0`` |
|
|
+-----------------------+-------------------------------------+-------+
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Constructores
|
|
--------------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`Vector3i<class_Vector3i_constructor_Vector3i>`\ (\ ) |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`Vector3i<class_Vector3i_constructor_Vector3i>`\ (\ from\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`Vector3i<class_Vector3i_constructor_Vector3i>`\ (\ from\: :ref:`Vector3<class_Vector3>`\ ) |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`Vector3i<class_Vector3i_constructor_Vector3i>`\ (\ x\: :ref:`int<class_int>`, y\: :ref:`int<class_int>`, z\: :ref:`int<class_int>`\ ) |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Métodos
|
|
--------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`abs<class_Vector3i_method_abs>`\ (\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`clamp<class_Vector3i_method_clamp>`\ (\ min\: :ref:`Vector3i<class_Vector3i>`, max\: :ref:`Vector3i<class_Vector3i>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`clampi<class_Vector3i_method_clampi>`\ (\ min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`distance_squared_to<class_Vector3i_method_distance_squared_to>`\ (\ to\: :ref:`Vector3i<class_Vector3i>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`distance_to<class_Vector3i_method_distance_to>`\ (\ to\: :ref:`Vector3i<class_Vector3i>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`length<class_Vector3i_method_length>`\ (\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`length_squared<class_Vector3i_method_length_squared>`\ (\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`max<class_Vector3i_method_max>`\ (\ with\: :ref:`Vector3i<class_Vector3i>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`max_axis_index<class_Vector3i_method_max_axis_index>`\ (\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`maxi<class_Vector3i_method_maxi>`\ (\ with\: :ref:`int<class_int>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`min<class_Vector3i_method_min>`\ (\ with\: :ref:`Vector3i<class_Vector3i>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`min_axis_index<class_Vector3i_method_min_axis_index>`\ (\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`mini<class_Vector3i_method_mini>`\ (\ with\: :ref:`int<class_int>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`sign<class_Vector3i_method_sign>`\ (\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`snapped<class_Vector3i_method_snapped>`\ (\ step\: :ref:`Vector3i<class_Vector3i>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`snappedi<class_Vector3i_method_snappedi>`\ (\ step\: :ref:`int<class_int>`\ ) |const| |
|
|
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Operadores
|
|
--------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`operator !=<class_Vector3i_operator_neq_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator %<class_Vector3i_operator_mod_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator %<class_Vector3i_operator_mod_int>`\ (\ right\: :ref:`int<class_int>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator *<class_Vector3i_operator_mul_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3<class_Vector3>` | :ref:`operator *<class_Vector3i_operator_mul_float>`\ (\ right\: :ref:`float<class_float>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator *<class_Vector3i_operator_mul_int>`\ (\ right\: :ref:`int<class_int>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator +<class_Vector3i_operator_sum_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator -<class_Vector3i_operator_dif_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator /<class_Vector3i_operator_div_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3<class_Vector3>` | :ref:`operator /<class_Vector3i_operator_div_float>`\ (\ right\: :ref:`float<class_float>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator /<class_Vector3i_operator_div_int>`\ (\ right\: :ref:`int<class_int>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`operator \<<class_Vector3i_operator_lt_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`operator \<=<class_Vector3i_operator_lte_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`operator ==<class_Vector3i_operator_eq_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`operator ><class_Vector3i_operator_gt_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`operator >=<class_Vector3i_operator_gte_Vector3i>`\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`operator []<class_Vector3i_operator_idx_int>`\ (\ index\: :ref:`int<class_int>`\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator unary+<class_Vector3i_operator_unplus>`\ (\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector3i<class_Vector3i>` | :ref:`operator unary-<class_Vector3i_operator_unminus>`\ (\ ) |
|
|
+---------------------------------+----------------------------------------------------------------------------------------------------------+
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Enumeraciones
|
|
--------------------------
|
|
|
|
.. _enum_Vector3i_Axis:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **Axis**: :ref:`🔗<enum_Vector3i_Axis>`
|
|
|
|
.. _class_Vector3i_constant_AXIS_X:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Axis<enum_Vector3i_Axis>` **AXIS_X** = ``0``
|
|
|
|
Valor enumerado para el eje X. Devuelto por :ref:`max_axis_index()<class_Vector3i_method_max_axis_index>` y :ref:`min_axis_index()<class_Vector3i_method_min_axis_index>`.
|
|
|
|
.. _class_Vector3i_constant_AXIS_Y:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Axis<enum_Vector3i_Axis>` **AXIS_Y** = ``1``
|
|
|
|
Valor enumerado para el eje Y. Devuelto por :ref:`max_axis_index()<class_Vector3i_method_max_axis_index>` y :ref:`min_axis_index()<class_Vector3i_method_min_axis_index>`.
|
|
|
|
.. _class_Vector3i_constant_AXIS_Z:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Axis<enum_Vector3i_Axis>` **AXIS_Z** = ``2``
|
|
|
|
Valor enumerado para el eje Z. Devuelto por :ref:`max_axis_index()<class_Vector3i_method_max_axis_index>` y :ref:`min_axis_index()<class_Vector3i_method_min_axis_index>`.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Constantes
|
|
--------------------
|
|
|
|
.. _class_Vector3i_constant_ZERO:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**ZERO** = ``Vector3i(0, 0, 0)`` :ref:`🔗<class_Vector3i_constant_ZERO>`
|
|
|
|
Vector cero, un vector con todos los componentes ajustados a ``0``.
|
|
|
|
.. _class_Vector3i_constant_ONE:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**ONE** = ``Vector3i(1, 1, 1)`` :ref:`🔗<class_Vector3i_constant_ONE>`
|
|
|
|
Un vector, un vector con todos los componentes ajustados a ``1``.
|
|
|
|
.. _class_Vector3i_constant_MIN:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**MIN** = ``Vector3i(-2147483648, -2147483648, -2147483648)`` :ref:`🔗<class_Vector3i_constant_MIN>`
|
|
|
|
Vector mínimo, un vector con todos los componentes iguales a ``INT32_MIN``. Se puede utilizar como un entero negativo equivalente a :ref:`Vector3.INF<class_Vector3_constant_INF>`.
|
|
|
|
.. _class_Vector3i_constant_MAX:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**MAX** = ``Vector3i(2147483647, 2147483647, 2147483647)`` :ref:`🔗<class_Vector3i_constant_MAX>`
|
|
|
|
Vector máximo, un vector con todos los componentes iguales a ``INT32_MAX``. Se puede utilizar como un entero equivalente a :ref:`Vector3.INF<class_Vector3_constant_INF>`.
|
|
|
|
.. _class_Vector3i_constant_LEFT:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**LEFT** = ``Vector3i(-1, 0, 0)`` :ref:`🔗<class_Vector3i_constant_LEFT>`
|
|
|
|
Vector de la unidad izquierda. Representa la dirección local de la izquierda y la dirección global del oeste.
|
|
|
|
.. _class_Vector3i_constant_RIGHT:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**RIGHT** = ``Vector3i(1, 0, 0)`` :ref:`🔗<class_Vector3i_constant_RIGHT>`
|
|
|
|
Vector de la unidad derecha. Representa la dirección local de la derecha, y la dirección global del este.
|
|
|
|
.. _class_Vector3i_constant_UP:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**UP** = ``Vector3i(0, 1, 0)`` :ref:`🔗<class_Vector3i_constant_UP>`
|
|
|
|
Vector de la unidad superior.
|
|
|
|
.. _class_Vector3i_constant_DOWN:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**DOWN** = ``Vector3i(0, -1, 0)`` :ref:`🔗<class_Vector3i_constant_DOWN>`
|
|
|
|
Vector de la unidad inferior.
|
|
|
|
.. _class_Vector3i_constant_FORWARD:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**FORWARD** = ``Vector3i(0, 0, -1)`` :ref:`🔗<class_Vector3i_constant_FORWARD>`
|
|
|
|
Vector de la unidad de adelante. Representa la dirección local de avance, y la dirección global del norte.
|
|
|
|
.. _class_Vector3i_constant_BACK:
|
|
|
|
.. rst-class:: classref-constant
|
|
|
|
**BACK** = ``Vector3i(0, 0, 1)`` :ref:`🔗<class_Vector3i_constant_BACK>`
|
|
|
|
Vector de la unidad trasera. Representa la dirección local de la espalda, y la dirección global del sur.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Propiedades
|
|
--------------------------------------------------------
|
|
|
|
.. _class_Vector3i_property_x:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`int<class_int>` **x** = ``0`` :ref:`🔗<class_Vector3i_property_x>`
|
|
|
|
El componente X del vector. También se puede acceder utilizando la posición del índice ``[0]``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_property_y:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`int<class_int>` **y** = ``0`` :ref:`🔗<class_Vector3i_property_y>`
|
|
|
|
El componente Y del vector. También se puede acceder usando la posición del índice ``[1]``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_property_z:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`int<class_int>` **z** = ``0`` :ref:`🔗<class_Vector3i_property_z>`
|
|
|
|
El componente Z del vector. También se puede acceder usando la posición del índice ``[2]``.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Constructores
|
|
------------------------------------------------------------
|
|
|
|
.. _class_Vector3i_constructor_Vector3i:
|
|
|
|
.. rst-class:: classref-constructor
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **Vector3i**\ (\ ) :ref:`🔗<class_Vector3i_constructor_Vector3i>`
|
|
|
|
Construye un **Vector3i** inicializado por defecto con todos los componentes establecidos en ``0``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-constructor
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **Vector3i**\ (\ from\: :ref:`Vector3i<class_Vector3i>`\ )
|
|
|
|
Construye un **Vector3i** como una copia del **Vector3i** dado.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-constructor
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **Vector3i**\ (\ from\: :ref:`Vector3<class_Vector3>`\ )
|
|
|
|
Construye un nuevo **Vector3i** a partir del :ref:`Vector3<class_Vector3>` dado truncando las fracciones de los componentes (redondeando hacia cero). Para un comportamiento diferente, considera pasar el resultado de :ref:`Vector3.ceil()<class_Vector3_method_ceil>`, :ref:`Vector3.floor()<class_Vector3_method_floor>` o :ref:`Vector3.round()<class_Vector3_method_round>` a este constructor.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-constructor
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **Vector3i**\ (\ x\: :ref:`int<class_int>`, y\: :ref:`int<class_int>`, z\: :ref:`int<class_int>`\ )
|
|
|
|
Devuelve un **Vector3i** con los componentes dados.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Métodos
|
|
------------------------------------------------
|
|
|
|
.. _class_Vector3i_method_abs:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **abs**\ (\ ) |const| :ref:`🔗<class_Vector3i_method_abs>`
|
|
|
|
Devuelve un nuevo vector con todos los componentes en valores absolutos (es decir, positivos).
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_clamp:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **clamp**\ (\ min\: :ref:`Vector3i<class_Vector3i>`, max\: :ref:`Vector3i<class_Vector3i>`\ ) |const| :ref:`🔗<class_Vector3i_method_clamp>`
|
|
|
|
Devuelve un nuevo vector con todos los componentes limitados entre los componentes de ``min`` y ``max``, ejecutando :ref:`@GlobalScope.clamp()<class_@GlobalScope_method_clamp>` en cada componente.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_clampi:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **clampi**\ (\ min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Vector3i_method_clampi>`
|
|
|
|
Devuelve un nuevo vector con todos los componentes restringidos entre ``min`` y ``max``, ejecutando :ref:`@GlobalScope.clamp()<class_@GlobalScope_method_clamp>` en cada componente.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_distance_squared_to:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`int<class_int>` **distance_squared_to**\ (\ to\: :ref:`Vector3i<class_Vector3i>`\ ) |const| :ref:`🔗<class_Vector3i_method_distance_squared_to>`
|
|
|
|
Devuelve la distancia al cuadrado entre este vector y ``to``.
|
|
|
|
Este método se ejecuta más rápido que :ref:`distance_to()<class_Vector3i_method_distance_to>`, así que es preferible si necesitas comparar vectores o necesitas la distancia al cuadrado para alguna fórmula.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_distance_to:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`float<class_float>` **distance_to**\ (\ to\: :ref:`Vector3i<class_Vector3i>`\ ) |const| :ref:`🔗<class_Vector3i_method_distance_to>`
|
|
|
|
Devuelve la distancia entre este vector y ``to``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_length:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`float<class_float>` **length**\ (\ ) |const| :ref:`🔗<class_Vector3i_method_length>`
|
|
|
|
Devuelve la longitud (magnitud) de este vector.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_length_squared:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`int<class_int>` **length_squared**\ (\ ) |const| :ref:`🔗<class_Vector3i_method_length_squared>`
|
|
|
|
Devuelve la longitud cuadrada (magnitud cuadrada) de este vector.
|
|
|
|
Este método funciona más rápido que el :ref:`length()<class_Vector3i_method_length>`, por lo que es preferible si necesitas comparar vectores o necesitas la distancia al cuadrado para alguna fórmula.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_max:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **max**\ (\ with\: :ref:`Vector3i<class_Vector3i>`\ ) |const| :ref:`🔗<class_Vector3i_method_max>`
|
|
|
|
Devuelve el máximo por componente de este y ``with``, equivalente a ``Vector3i(maxi(x, with.x), maxi(y, with.y), maxi(z, with.z))``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_max_axis_index:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`int<class_int>` **max_axis_index**\ (\ ) |const| :ref:`🔗<class_Vector3i_method_max_axis_index>`
|
|
|
|
Devuelve el eje del valor más alto del vector. Consulta las constantes ``AXIS_*``. Si todos los componentes son iguales, este método devuelve :ref:`AXIS_X<class_Vector3i_constant_AXIS_X>`.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_maxi:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **maxi**\ (\ with\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Vector3i_method_maxi>`
|
|
|
|
Devuelve el máximo por componente de este y ``with``, equivalente a ``Vector3i(maxi(x, with), maxi(y, with), maxi(z, with))``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_min:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **min**\ (\ with\: :ref:`Vector3i<class_Vector3i>`\ ) |const| :ref:`🔗<class_Vector3i_method_min>`
|
|
|
|
Devuelve el mínimo componente por componente de este y ``with``, equivalente a ``Vector3i(mini(x, with.x), mini(y, with.y), mini(z, with.z))``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_min_axis_index:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`int<class_int>` **min_axis_index**\ (\ ) |const| :ref:`🔗<class_Vector3i_method_min_axis_index>`
|
|
|
|
Devuelve el eje del valor más bajo del vector. Consulta las constantes ``AXIS_*``. Si todos los componentes son iguales, este método devuelve la constante :ref:`AXIS_Z<class_Vector3i_constant_AXIS_Z>`.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_mini:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **mini**\ (\ with\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Vector3i_method_mini>`
|
|
|
|
Devuelve el mínimo componente por componente de este y ``with``, equivalente a ``Vector3i(mini(x, with), mini(y, with), mini(z, with))``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_sign:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **sign**\ (\ ) |const| :ref:`🔗<class_Vector3i_method_sign>`
|
|
|
|
Devuelve un nuevo vector con cada componente establecido en ``1`` si es positivo, ``-1`` si es negativo y ``0`` si es cero. El resultado es idéntico a llamar a :ref:`@GlobalScope.sign()<class_@GlobalScope_method_sign>` en cada componente.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_snapped:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **snapped**\ (\ step\: :ref:`Vector3i<class_Vector3i>`\ ) |const| :ref:`🔗<class_Vector3i_method_snapped>`
|
|
|
|
Devuelve un nuevo vector con cada componente ajustado al múltiplo más cercano del componente correspondiente en ``step``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_method_snappedi:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **snappedi**\ (\ step\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Vector3i_method_snappedi>`
|
|
|
|
Devuelve un nuevo vector con cada componente ajustado al múltiplo más cercano de ``step``.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Operadores
|
|
------------------------------------------------------
|
|
|
|
.. _class_Vector3i_operator_neq_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`bool<class_bool>` **operator !=**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_neq_Vector3i>`
|
|
|
|
Devuelve ``true`` si los vectores no son iguales.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_mod_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator %**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_mod_Vector3i>`
|
|
|
|
Obtiene el resto de cada componente del **Vector3i** con los componentes del **Vector3i** dado. Esta operación utiliza la división truncada, que a menudo no es deseada ya que no funciona bien con números negativos. Considera usar :ref:`@GlobalScope.posmod()<class_@GlobalScope_method_posmod>` en su lugar si quieres manejar números negativos.
|
|
|
|
::
|
|
|
|
print(Vector3i(10, -20, 30) % Vector3i(7, 8, 9)) # Imprime (3, -4, 3)
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_mod_int:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator %**\ (\ right\: :ref:`int<class_int>`\ ) :ref:`🔗<class_Vector3i_operator_mod_int>`
|
|
|
|
Obtiene el resto de cada componente del **Vector3i** con el :ref:`int<class_int>` dado. Esta operación utiliza la división truncada, que a menudo no es deseada ya que no funciona bien con números negativos. Considera usar :ref:`@GlobalScope.posmod()<class_@GlobalScope_method_posmod>` en su lugar si quieres manejar números negativos.
|
|
|
|
::
|
|
|
|
print(Vector3i(10, -20, 30) % 7) # Imprime (3, -6, 2)
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_mul_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator ***\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_mul_Vector3i>`
|
|
|
|
Multiplica cada componente del **Vector3i** por los componentes del **Vector3i** dado.
|
|
|
|
::
|
|
|
|
print(Vector3i(10, 20, 30) * Vector3i(3, 4, 5)) # Imprime (30, 80, 150)
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_mul_float:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3<class_Vector3>` **operator ***\ (\ right\: :ref:`float<class_float>`\ ) :ref:`🔗<class_Vector3i_operator_mul_float>`
|
|
|
|
Multiplica cada componente del **Vector3i** por el :ref:`float<class_float>` dado. Devuelve un :ref:`Vector3<class_Vector3>`.
|
|
|
|
::
|
|
|
|
print(Vector3i(10, 15, 20) * 0.9) # Imprime (9.0, 13.5, 18.0)
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_mul_int:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator ***\ (\ right\: :ref:`int<class_int>`\ ) :ref:`🔗<class_Vector3i_operator_mul_int>`
|
|
|
|
Multiplica cada componente del **Vector3i** por el :ref:`int<class_int>` dado.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_sum_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator +**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_sum_Vector3i>`
|
|
|
|
Suma cada componente del **Vector3i** por los componentes del **Vector3i** dado.
|
|
|
|
::
|
|
|
|
print(Vector3i(10, 20, 30) + Vector3i(3, 4, 5)) # Imprime (13, 24, 35)
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_dif_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator -**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_dif_Vector3i>`
|
|
|
|
Resta cada componente del **Vector3i** por los componentes del **Vector3i** dado.
|
|
|
|
::
|
|
|
|
print(Vector3i(10, 20, 30) - Vector3i(3, 4, 5)) # Imprime (7, 16, 25)
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_div_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator /**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_div_Vector3i>`
|
|
|
|
Divide cada componente del **Vector3i** por los componentes del **Vector3i** dado.
|
|
|
|
::
|
|
|
|
print(Vector3i(10, 20, 30) / Vector3i(2, 5, 3)) # Imprime (5, 4, 10)
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_div_float:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3<class_Vector3>` **operator /**\ (\ right\: :ref:`float<class_float>`\ ) :ref:`🔗<class_Vector3i_operator_div_float>`
|
|
|
|
Divides each component of the **Vector3i** by the given :ref:`float<class_float>`. Returns a :ref:`Vector3<class_Vector3>`.
|
|
|
|
::
|
|
|
|
print(Vector3i(1, 2, 3) / 2.5) # Prints (0.4, 0.8, 1.2)
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_div_int:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator /**\ (\ right\: :ref:`int<class_int>`\ ) :ref:`🔗<class_Vector3i_operator_div_int>`
|
|
|
|
Divide cada componente de **Vector3i** por el :ref:`int<class_int>` dado.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_lt_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`bool<class_bool>` **operator <**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_lt_Vector3i>`
|
|
|
|
Compara dos vectores **Vector3i** comprobando primero si el valor X del vector de la izquierda es menor que el valor X del vector ``right``. Si los valores X son exactamente iguales, entonces repite esta comprobación con los valores Y de los dos vectores, y luego con los valores Z. Este operador es útil para ordenar vectores.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_lte_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`bool<class_bool>` **operator <=**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_lte_Vector3i>`
|
|
|
|
Compara dos vectores **Vector3i** comprobando primero si el valor X del vector de la izquierda es menor o igual que el valor X del vector ``right``. Si los valores X son exactamente iguales, entonces repite esta comprobación con los valores Y de los dos vectores, y luego con los valores Z. Este operador es útil para ordenar vectores.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_eq_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`bool<class_bool>` **operator ==**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_eq_Vector3i>`
|
|
|
|
Devuelve ``true`` si los vectores son iguales.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_gt_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`bool<class_bool>` **operator >**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_gt_Vector3i>`
|
|
|
|
Compara dos vectores **Vector3i** comprobando primero si el valor X del vector de la izquierda es mayor que el valor X del vector ``right``. Si los valores X son exactamente iguales, entonces repite esta comprobación con los valores Y de los dos vectores, y luego con los valores Z. Este operador es útil para ordenar vectores.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_gte_Vector3i:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`bool<class_bool>` **operator >=**\ (\ right\: :ref:`Vector3i<class_Vector3i>`\ ) :ref:`🔗<class_Vector3i_operator_gte_Vector3i>`
|
|
|
|
Compara dos vectores **Vector3i** comprobando primero si el valor X del vector de la izquierda es mayor o igual que el valor X del vector ``right``. Si los valores X son exactamente iguales, entonces repite esta comprobación con los valores Y de los dos vectores, y luego con los valores Z. Este operador es útil para ordenar vectores.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_idx_int:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`int<class_int>` **operator []**\ (\ index\: :ref:`int<class_int>`\ ) :ref:`🔗<class_Vector3i_operator_idx_int>`
|
|
|
|
Accede a los componentes del vector utilizando su ``index``. ``v[0]`` es equivalente a ``v.x``, ``v[1]`` es equivalente a ``v.y``, y ``v[2]`` es equivalente a ``v.z``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_unplus:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator unary+**\ (\ ) :ref:`🔗<class_Vector3i_operator_unplus>`
|
|
|
|
Devuelve el mismo valor como si el ``+`` no estuviera ahí. El ``+`` unario no hace nada, pero a veces puede hacer que tu código sea más legible.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_Vector3i_operator_unminus:
|
|
|
|
.. rst-class:: classref-operator
|
|
|
|
:ref:`Vector3i<class_Vector3i>` **operator unary-**\ (\ ) :ref:`🔗<class_Vector3i_operator_unminus>`
|
|
|
|
Devuelve el valor negativo del **Vector3i**. Esto es lo mismo que escribir ``Vector3i(-v.x, -v.y, -v.z)``. Esta operación invierte la dirección del vector manteniendo la misma magnitud.
|
|
|
|
.. |virtual| replace:: :abbr:`virtual (Normalmente, este método debería ser sobreescrito por el usuario para que tenga algún efecto.)`
|
|
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
|
.. |const| replace:: :abbr:`const (Este método no tiene efectos secundarios. No modifica ninguna de las variables miembro de la instancia.)`
|
|
.. |vararg| replace:: :abbr:`vararg (Este método permite agregar cualquier número de argumentos después de los descritos aquí.)`
|
|
.. |constructor| replace:: :abbr:`constructor (Este método se utiliza para construir un tipo.)`
|
|
.. |static| replace:: :abbr:`static (Este método no necesita una instancia para ser llamado, por lo que puede llamarse directamente utilizando el nombre de la clase.)`
|
|
.. |operator| replace:: :abbr:`operator (Este método describe un operador válido para usar con este tipo como operando izquierdo.)`
|
|
.. |bitfield| replace:: :abbr:`BitField (Este valor es un entero compuesto como una máscara de bits de las siguientes banderas.)`
|
|
.. |void| replace:: :abbr:`void (Sin valor de retorno.)`
|