Files
godot-docs-l10n/classes/es/class_boneattachment3d.rst
2025-12-19 14:34:07 +01:00

188 lines
9.9 KiB
ReStructuredText

:github_url: hide
.. meta::
:keywords: tag
.. _class_BoneAttachment3D:
BoneAttachment3D
================
**Hereda:** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
Un nodo que copia u omite dinámicamente la transformación 3D de un hueso en su :ref:`Skeleton3D<class_Skeleton3D>` padre.
.. rst-class:: classref-introduction-group
Descripción
----------------------
Este nodo selecciona un hueso en un :ref:`Skeleton3D<class_Skeleton3D>` y se adjunta a él. Esto significa que el nodo **BoneAttachment3D** copiará dinámicamente o anulará la transformación 3D del hueso seleccionado.
.. rst-class:: classref-reftable-group
Propiedades
----------------------
.. table::
:widths: auto
+---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`bone_idx<class_BoneAttachment3D_property_bone_idx>` | ``-1`` |
+---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`bone_name<class_BoneAttachment3D_property_bone_name>` | ``""`` |
+---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+
| :ref:`NodePath<class_NodePath>` | :ref:`external_skeleton<class_BoneAttachment3D_property_external_skeleton>` | |
+---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`override_pose<class_BoneAttachment3D_property_override_pose>` | ``false`` |
+---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+
| :ref:`PhysicsInterpolationMode<enum_Node_PhysicsInterpolationMode>` | physics_interpolation_mode | ``2`` (overrides :ref:`Node<class_Node_property_physics_interpolation_mode>`) |
+---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`use_external_skeleton<class_BoneAttachment3D_property_use_external_skeleton>` | ``false`` |
+---------------------------------------------------------------------+-------------------------------------------------------------------------------------+-------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Métodos
--------------
.. table::
:widths: auto
+-------------------------------------+-----------------------------------------------------------------------------------+
| :ref:`Skeleton3D<class_Skeleton3D>` | :ref:`get_skeleton<class_BoneAttachment3D_method_get_skeleton>`\ (\ ) |
+-------------------------------------+-----------------------------------------------------------------------------------+
| |void| | :ref:`on_skeleton_update<class_BoneAttachment3D_method_on_skeleton_update>`\ (\ ) |
+-------------------------------------+-----------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descripciones de Propiedades
--------------------------------------------------------
.. _class_BoneAttachment3D_property_bone_idx:
.. rst-class:: classref-property
:ref:`int<class_int>` **bone_idx** = ``-1`` :ref:`🔗<class_BoneAttachment3D_property_bone_idx>`
.. rst-class:: classref-property-setget
- |void| **set_bone_idx**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_bone_idx**\ (\ )
El índice del hueso adjunto.
.. rst-class:: classref-item-separator
----
.. _class_BoneAttachment3D_property_bone_name:
.. rst-class:: classref-property
:ref:`String<class_String>` **bone_name** = ``""`` :ref:`🔗<class_BoneAttachment3D_property_bone_name>`
.. rst-class:: classref-property-setget
- |void| **set_bone_name**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_bone_name**\ (\ )
El nombre del hueso unido.
.. rst-class:: classref-item-separator
----
.. _class_BoneAttachment3D_property_external_skeleton:
.. rst-class:: classref-property
:ref:`NodePath<class_NodePath>` **external_skeleton** :ref:`🔗<class_BoneAttachment3D_property_external_skeleton>`
.. rst-class:: classref-property-setget
- |void| **set_external_skeleton**\ (\ value\: :ref:`NodePath<class_NodePath>`\ )
- :ref:`NodePath<class_NodePath>` **get_external_skeleton**\ (\ )
El :ref:`NodePath<class_NodePath>` al nodo :ref:`Skeleton3D<class_Skeleton3D>` externo.
.. rst-class:: classref-item-separator
----
.. _class_BoneAttachment3D_property_override_pose:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **override_pose** = ``false`` :ref:`🔗<class_BoneAttachment3D_property_override_pose>`
.. rst-class:: classref-property-setget
- |void| **set_override_pose**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_override_pose**\ (\ )
Indica si el nodo **BoneAttachment3D** va a sobrescribir la pose del hueso al que está adjunto. Cuando se establece en ``true``, el nodo **BoneAttachment3D** puede cambiar la pose del hueso. Cuando se establece en ``false``, el **BoneAttachment3D** siempre se establecerá en la transformación del hueso.
\ **Nota:** Esta sobrescritura se realiza de forma interrumpida en el proceso de actualización del esqueleto mediante señales debido al antiguo diseño. Puede causar un comportamiento no deseado cuando se utiliza al mismo tiempo que :ref:`SkeletonModifier3D<class_SkeletonModifier3D>`.
.. rst-class:: classref-item-separator
----
.. _class_BoneAttachment3D_property_use_external_skeleton:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **use_external_skeleton** = ``false`` :ref:`🔗<class_BoneAttachment3D_property_use_external_skeleton>`
.. rst-class:: classref-property-setget
- |void| **set_use_external_skeleton**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_use_external_skeleton**\ (\ )
Indica si el nodo **BoneAttachment3D** usará un nodo :ref:`Skeleton3D<class_Skeleton3D>` externo en lugar de intentar usar su nodo padre como :ref:`Skeleton3D<class_Skeleton3D>`. Cuando se establece en ``true``, el nodo **BoneAttachment3D** usará el nodo :ref:`Skeleton3D<class_Skeleton3D>` externo establecido en :ref:`external_skeleton<class_BoneAttachment3D_property_external_skeleton>`.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descripciones de Métodos
------------------------------------------------
.. _class_BoneAttachment3D_method_get_skeleton:
.. rst-class:: classref-method
:ref:`Skeleton3D<class_Skeleton3D>` **get_skeleton**\ (\ ) :ref:`🔗<class_BoneAttachment3D_method_get_skeleton>`
Devuelve el nodo :ref:`Skeleton3D<class_Skeleton3D>` padre o externo si existe, de lo contrario devuelve ``null``.
.. rst-class:: classref-item-separator
----
.. _class_BoneAttachment3D_method_on_skeleton_update:
.. rst-class:: classref-method
|void| **on_skeleton_update**\ (\ ) :ref:`🔗<class_BoneAttachment3D_method_on_skeleton_update>`
Una función que se llama automáticamente cuando se actualiza el :ref:`Skeleton3D<class_Skeleton3D>`. Esta función es donde el nodo **BoneAttachment3D** actualiza su posición para que esté correctamente vinculado cuando *no* está configurado para sobrescribir la pose del hueso.
.. |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.)`