mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
Currently including `zh_CN` and `es` which both have very high completion ratios. Others will be added once they reach a significant percentage too. These RST files will be used by godot-docs in place of its `classes` folder after we sync with https://github.com/godotengine/godot-docs/pull/5458. The update workflow is manual for now (example for `zh_CN`): - Build `godotengine/godot` in the branch we currently track (now `3.x`) - Run `godot --doctool -l zh_CN` - Run `cd doc && make rst LANGARG=zh_CN` - Copy `doc/_build/rst/*` to `classes/zh_CN/` here - Make sure to have `classes/zh_CN/index.rst` copied from `docs/classes`
311 lines
18 KiB
ReStructuredText
311 lines
18 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
|
|
.. DO NOT EDIT THIS FILE, but the AnimationNodeBlendSpace2D.xml source instead.
|
|
.. The source is found in doc/classes or modules/<name>/doc_classes.
|
|
|
|
.. _class_AnimationNodeBlendSpace2D:
|
|
|
|
AnimationNodeBlendSpace2D
|
|
=========================
|
|
|
|
**Inherits:** :ref:`AnimationRootNode<class_AnimationRootNode>` **<** :ref:`AnimationNode<class_AnimationNode>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
|
|
|
|
Se mezcla linealmente entre tres :ref:`AnimationNode<class_AnimationNode>` de cualquier tipo colocados en un espacio 2D.
|
|
|
|
Descripción
|
|
----------------------
|
|
|
|
Un recurso para añadir a un :ref:`AnimationNodeBlendTree<class_AnimationNodeBlendTree>`.
|
|
|
|
Este nodo te permite mezclar linealmente entre tres animaciones usando un peso :ref:`Vector2<class_Vector2>`.
|
|
|
|
Puedes añadir vértices al espacio de mezcla con :ref:`add_blend_point<class_AnimationNodeBlendSpace2D_method_add_blend_point>` y triangularlo automáticamente estableciendo :ref:`auto_triangles<class_AnimationNodeBlendSpace2D_property_auto_triangles>` a ``true``. De lo contrario, usa :ref:`add_triangle<class_AnimationNodeBlendSpace2D_method_add_triangle>` y :ref:`remove_triangle<class_AnimationNodeBlendSpace2D_method_remove_triangle>` para crear el espacio de mezcla a mano.
|
|
|
|
Tutoriales
|
|
--------------------
|
|
|
|
- :doc:`AnimationTree <../tutorials/animation/animation_tree>`
|
|
|
|
- `Third Person Shooter Demo <https://godotengine.org/asset-library/asset/678>`__
|
|
|
|
Propiedades
|
|
----------------------
|
|
|
|
+------------------------------------------------------------+--------------------------------------------------------------------------------+-------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`auto_triangles<class_AnimationNodeBlendSpace2D_property_auto_triangles>` | ``true`` |
|
|
+------------------------------------------------------------+--------------------------------------------------------------------------------+-------------------------+
|
|
| :ref:`BlendMode<enum_AnimationNodeBlendSpace2D_BlendMode>` | :ref:`blend_mode<class_AnimationNodeBlendSpace2D_property_blend_mode>` | ``0`` |
|
|
+------------------------------------------------------------+--------------------------------------------------------------------------------+-------------------------+
|
|
| :ref:`Vector2<class_Vector2>` | :ref:`max_space<class_AnimationNodeBlendSpace2D_property_max_space>` | ``Vector2( 1, 1 )`` |
|
|
+------------------------------------------------------------+--------------------------------------------------------------------------------+-------------------------+
|
|
| :ref:`Vector2<class_Vector2>` | :ref:`min_space<class_AnimationNodeBlendSpace2D_property_min_space>` | ``Vector2( -1, -1 )`` |
|
|
+------------------------------------------------------------+--------------------------------------------------------------------------------+-------------------------+
|
|
| :ref:`Vector2<class_Vector2>` | :ref:`snap<class_AnimationNodeBlendSpace2D_property_snap>` | ``Vector2( 0.1, 0.1 )`` |
|
|
+------------------------------------------------------------+--------------------------------------------------------------------------------+-------------------------+
|
|
| :ref:`String<class_String>` | :ref:`x_label<class_AnimationNodeBlendSpace2D_property_x_label>` | ``"x"`` |
|
|
+------------------------------------------------------------+--------------------------------------------------------------------------------+-------------------------+
|
|
| :ref:`String<class_String>` | :ref:`y_label<class_AnimationNodeBlendSpace2D_property_y_label>` | ``"y"`` |
|
|
+------------------------------------------------------------+--------------------------------------------------------------------------------+-------------------------+
|
|
|
|
Métodos
|
|
--------------
|
|
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`add_blend_point<class_AnimationNodeBlendSpace2D_method_add_blend_point>` **(** :ref:`AnimationRootNode<class_AnimationRootNode>` node, :ref:`Vector2<class_Vector2>` pos, :ref:`int<class_int>` at_index=-1 **)** |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`add_triangle<class_AnimationNodeBlendSpace2D_method_add_triangle>` **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y, :ref:`int<class_int>` z, :ref:`int<class_int>` at_index=-1 **)** |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_blend_point_count<class_AnimationNodeBlendSpace2D_method_get_blend_point_count>` **(** **)** |const| |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`AnimationRootNode<class_AnimationRootNode>` | :ref:`get_blend_point_node<class_AnimationNodeBlendSpace2D_method_get_blend_point_node>` **(** :ref:`int<class_int>` point **)** |const| |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector2<class_Vector2>` | :ref:`get_blend_point_position<class_AnimationNodeBlendSpace2D_method_get_blend_point_position>` **(** :ref:`int<class_int>` point **)** |const| |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_triangle_count<class_AnimationNodeBlendSpace2D_method_get_triangle_count>` **(** **)** |const| |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_triangle_point<class_AnimationNodeBlendSpace2D_method_get_triangle_point>` **(** :ref:`int<class_int>` triangle, :ref:`int<class_int>` point **)** |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`remove_blend_point<class_AnimationNodeBlendSpace2D_method_remove_blend_point>` **(** :ref:`int<class_int>` point **)** |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`remove_triangle<class_AnimationNodeBlendSpace2D_method_remove_triangle>` **(** :ref:`int<class_int>` triangle **)** |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_blend_point_node<class_AnimationNodeBlendSpace2D_method_set_blend_point_node>` **(** :ref:`int<class_int>` point, :ref:`AnimationRootNode<class_AnimationRootNode>` node **)** |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_blend_point_position<class_AnimationNodeBlendSpace2D_method_set_blend_point_position>` **(** :ref:`int<class_int>` point, :ref:`Vector2<class_Vector2>` pos **)** |
|
|
+---------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
Señales
|
|
--------------
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_signal_triangles_updated:
|
|
|
|
- **triangles_updated** **(** **)**
|
|
|
|
Emitida cada vez que los triángulos del espacio de mezcla se crean, se eliminan, o cuando uno de sus vértices cambia de posición.
|
|
|
|
Enumeraciones
|
|
--------------------------
|
|
|
|
.. _enum_AnimationNodeBlendSpace2D_BlendMode:
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_constant_BLEND_MODE_INTERPOLATED:
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_constant_BLEND_MODE_DISCRETE:
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_constant_BLEND_MODE_DISCRETE_CARRY:
|
|
|
|
enum **BlendMode**:
|
|
|
|
- **BLEND_MODE_INTERPOLATED** = **0** --- La interpolación entre las animaciones es lineal.
|
|
|
|
- **BLEND_MODE_DISCRETE** = **1** --- El espacio de mezcla reproduce la animación del nodo más cercano a la posición de mezcla. Es útil para las animaciones 2D fotograma a fotograma.
|
|
|
|
- **BLEND_MODE_DISCRETE_CARRY** = **2** --- Similar a :ref:`BLEND_MODE_DISCRETE<class_AnimationNodeBlendSpace2D_constant_BLEND_MODE_DISCRETE>`, pero inicia la nueva animación en la posición de reproducción de la última animación.
|
|
|
|
Descripciones de Propiedades
|
|
--------------------------------------------------------
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_property_auto_triangles:
|
|
|
|
- :ref:`bool<class_bool>` **auto_triangles**
|
|
|
|
+-----------+---------------------------+
|
|
| *Default* | ``true`` |
|
|
+-----------+---------------------------+
|
|
| *Setter* | set_auto_triangles(value) |
|
|
+-----------+---------------------------+
|
|
| *Getter* | get_auto_triangles() |
|
|
+-----------+---------------------------+
|
|
|
|
Si ``true``, el espacio de mezcla se triangula automáticamente. La malla se actualiza cada vez que añades o eliminas puntos con :ref:`add_blend_point<class_AnimationNodeBlendSpace2D_method_add_blend_point>` y :ref:`remove_blend_point<class_AnimationNodeBlendSpace2D_method_remove_blend_point>`.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_property_blend_mode:
|
|
|
|
- :ref:`BlendMode<enum_AnimationNodeBlendSpace2D_BlendMode>` **blend_mode**
|
|
|
|
+-----------+-----------------------+
|
|
| *Default* | ``0`` |
|
|
+-----------+-----------------------+
|
|
| *Setter* | set_blend_mode(value) |
|
|
+-----------+-----------------------+
|
|
| *Getter* | get_blend_mode() |
|
|
+-----------+-----------------------+
|
|
|
|
Controla la interpolación entre las animaciones. Ver las constantes de :ref:`BlendMode<enum_AnimationNodeBlendSpace2D_BlendMode>`.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_property_max_space:
|
|
|
|
- :ref:`Vector2<class_Vector2>` **max_space**
|
|
|
|
+-----------+----------------------+
|
|
| *Default* | ``Vector2( 1, 1 )`` |
|
|
+-----------+----------------------+
|
|
| *Setter* | set_max_space(value) |
|
|
+-----------+----------------------+
|
|
| *Getter* | get_max_space() |
|
|
+-----------+----------------------+
|
|
|
|
El límite superior de los ejes X e Y del espacio de mezcla para la posición de los puntos. Ver :ref:`add_blend_point<class_AnimationNodeBlendSpace2D_method_add_blend_point>`.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_property_min_space:
|
|
|
|
- :ref:`Vector2<class_Vector2>` **min_space**
|
|
|
|
+-----------+-----------------------+
|
|
| *Default* | ``Vector2( -1, -1 )`` |
|
|
+-----------+-----------------------+
|
|
| *Setter* | set_min_space(value) |
|
|
+-----------+-----------------------+
|
|
| *Getter* | get_min_space() |
|
|
+-----------+-----------------------+
|
|
|
|
El límite inferior de los ejes X e Y del espacio de mezcla para la posición de los puntos. Ver :ref:`add_blend_point<class_AnimationNodeBlendSpace2D_method_add_blend_point>`.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_property_snap:
|
|
|
|
- :ref:`Vector2<class_Vector2>` **snap**
|
|
|
|
+-----------+-------------------------+
|
|
| *Default* | ``Vector2( 0.1, 0.1 )`` |
|
|
+-----------+-------------------------+
|
|
| *Setter* | set_snap(value) |
|
|
+-----------+-------------------------+
|
|
| *Getter* | get_snap() |
|
|
+-----------+-------------------------+
|
|
|
|
Incremento de la posición a la que se ajusta cuando se mueve un punto.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_property_x_label:
|
|
|
|
- :ref:`String<class_String>` **x_label**
|
|
|
|
+-----------+--------------------+
|
|
| *Default* | ``"x"`` |
|
|
+-----------+--------------------+
|
|
| *Setter* | set_x_label(value) |
|
|
+-----------+--------------------+
|
|
| *Getter* | get_x_label() |
|
|
+-----------+--------------------+
|
|
|
|
Nombre del eje X del espacio de la mezcla.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_property_y_label:
|
|
|
|
- :ref:`String<class_String>` **y_label**
|
|
|
|
+-----------+--------------------+
|
|
| *Default* | ``"y"`` |
|
|
+-----------+--------------------+
|
|
| *Setter* | set_y_label(value) |
|
|
+-----------+--------------------+
|
|
| *Getter* | get_y_label() |
|
|
+-----------+--------------------+
|
|
|
|
El nombre del eje Y del espacio de mezcla.
|
|
|
|
Descripciones de Métodos
|
|
------------------------------------------------
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_add_blend_point:
|
|
|
|
- void **add_blend_point** **(** :ref:`AnimationRootNode<class_AnimationRootNode>` node, :ref:`Vector2<class_Vector2>` pos, :ref:`int<class_int>` at_index=-1 **)**
|
|
|
|
Añade un nuevo punto que representa un nodo ``pos`` en la posición establecida por ``pos``. Se puede insertar en un índice específico usando el argumento ``at_index``. Si utilizas el valor por defecto de ``at_index``, el punto se inserta al final del array de puntos de mezcla.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_add_triangle:
|
|
|
|
- void **add_triangle** **(** :ref:`int<class_int>` x, :ref:`int<class_int>` y, :ref:`int<class_int>` z, :ref:`int<class_int>` at_index=-1 **)**
|
|
|
|
Crea un nuevo triángulo usando tres puntos ``x``, ``y``, y ``z``. Los triángulos pueden superponerse. Puedes insertar el triángulo en un índice específico usando el argumento ``at_index``. Si utilizas el valor por defecto de ``at_index``, el punto se inserta al final del array de puntos de mezcla.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_get_blend_point_count:
|
|
|
|
- :ref:`int<class_int>` **get_blend_point_count** **(** **)** |const|
|
|
|
|
Devuelve el número de puntos en el espacio de mezcla.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_get_blend_point_node:
|
|
|
|
- :ref:`AnimationRootNode<class_AnimationRootNode>` **get_blend_point_node** **(** :ref:`int<class_int>` point **)** |const|
|
|
|
|
Devuelve el :ref:`AnimationRootNode<class_AnimationRootNode>` referenciado por el punto en el índice ``point``.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_get_blend_point_position:
|
|
|
|
- :ref:`Vector2<class_Vector2>` **get_blend_point_position** **(** :ref:`int<class_int>` point **)** |const|
|
|
|
|
Devuelve la posición del punto en el índice ``point``.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_get_triangle_count:
|
|
|
|
- :ref:`int<class_int>` **get_triangle_count** **(** **)** |const|
|
|
|
|
Devuelve el número de triángulos en el espacio de mezcla.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_get_triangle_point:
|
|
|
|
- :ref:`int<class_int>` **get_triangle_point** **(** :ref:`int<class_int>` triangle, :ref:`int<class_int>` point **)**
|
|
|
|
Devuelve la posición del punto en el índice ``point`` en el triángulo del índice ``triangle``.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_remove_blend_point:
|
|
|
|
- void **remove_blend_point** **(** :ref:`int<class_int>` point **)**
|
|
|
|
Elimina el punto en el índice ``point`` del espacio de mezcla.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_remove_triangle:
|
|
|
|
- void **remove_triangle** **(** :ref:`int<class_int>` triangle **)**
|
|
|
|
Elimina el triángulo en el índice ``triangle`` del espacio de mezcla.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_set_blend_point_node:
|
|
|
|
- void **set_blend_point_node** **(** :ref:`int<class_int>` point, :ref:`AnimationRootNode<class_AnimationRootNode>` node **)**
|
|
|
|
Cambia el :ref:`AnimationNode<class_AnimationNode>` al que se refiere el punto en el índice ``point``.
|
|
|
|
----
|
|
|
|
.. _class_AnimationNodeBlendSpace2D_method_set_blend_point_position:
|
|
|
|
- void **set_blend_point_position** **(** :ref:`int<class_int>` point, :ref:`Vector2<class_Vector2>` pos **)**
|
|
|
|
Actualiza la posición del punto en el índice ``point`` en el eje de la mezcla.
|
|
|
|
.. |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.)`
|