mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
287 lines
10 KiB
ReStructuredText
287 lines
10 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. _class_OpenXRHand:
|
|
|
|
OpenXRHand
|
|
==========
|
|
|
|
**Obsoleto:** Use :ref:`XRHandModifier3D<class_XRHandModifier3D>` instead.
|
|
|
|
**Hereda:** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
|
|
|
Nodo que soporta el seguimiento de manos y dedos en OpenXR.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Descripción
|
|
----------------------
|
|
|
|
Este nodo habilita la funcionalidad de seguimiento de manos de OpenXR. El nodo debe ser un nodo hijo de un nodo :ref:`XROrigin3D<class_XROrigin3D>`, el seguimiento actualizará su posición a la ubicación de la articulación de la palma de la mano rastreada del jugador (el centro del hueso metacarpiano del dedo medio). Este nodo también actualiza el esqueleto de un modelo de mano o avatar correctamente skinneado.
|
|
|
|
Si el esqueleto es una mano (uno de los huesos de la mano es el nodo raíz del esqueleto), entonces el esqueleto se colocará en relación con la ubicación de la palma de la mano y la malla de la mano y el esqueleto deben ser hijos del nodo OpenXRHand.
|
|
|
|
Si los huesos de la mano son parte de un esqueleto completo, entonces la raíz de la mano mantendrá su ubicación con la suposición de que se usa IK para posicionar la mano y el brazo.
|
|
|
|
Por defecto, los huesos de la mano del esqueleto se reposicionan para que coincidan con el tamaño de la mano rastreada. Para preservar los tamaños de los huesos modelados, cambia :ref:`bone_update<class_OpenXRHand_property_bone_update>` para aplicar solo la rotación.
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Propiedades
|
|
----------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+-------------------------------------------------+---------------------------------------------------------------+------------------+
|
|
| :ref:`BoneUpdate<enum_OpenXRHand_BoneUpdate>` | :ref:`bone_update<class_OpenXRHand_property_bone_update>` | ``0`` |
|
|
+-------------------------------------------------+---------------------------------------------------------------+------------------+
|
|
| :ref:`Hands<enum_OpenXRHand_Hands>` | :ref:`hand<class_OpenXRHand_property_hand>` | ``0`` |
|
|
+-------------------------------------------------+---------------------------------------------------------------+------------------+
|
|
| :ref:`NodePath<class_NodePath>` | :ref:`hand_skeleton<class_OpenXRHand_property_hand_skeleton>` | ``NodePath("")`` |
|
|
+-------------------------------------------------+---------------------------------------------------------------+------------------+
|
|
| :ref:`MotionRange<enum_OpenXRHand_MotionRange>` | :ref:`motion_range<class_OpenXRHand_property_motion_range>` | ``0`` |
|
|
+-------------------------------------------------+---------------------------------------------------------------+------------------+
|
|
| :ref:`SkeletonRig<enum_OpenXRHand_SkeletonRig>` | :ref:`skeleton_rig<class_OpenXRHand_property_skeleton_rig>` | ``0`` |
|
|
+-------------------------------------------------+---------------------------------------------------------------+------------------+
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Enumeraciones
|
|
--------------------------
|
|
|
|
.. _enum_OpenXRHand_Hands:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **Hands**: :ref:`🔗<enum_OpenXRHand_Hands>`
|
|
|
|
.. _class_OpenXRHand_constant_HAND_LEFT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Hands<enum_OpenXRHand_Hands>` **HAND_LEFT** = ``0``
|
|
|
|
Rastrea la mano izquierda del jugador.
|
|
|
|
.. _class_OpenXRHand_constant_HAND_RIGHT:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Hands<enum_OpenXRHand_Hands>` **HAND_RIGHT** = ``1``
|
|
|
|
Rastrea la mano derecha del jugador.
|
|
|
|
.. _class_OpenXRHand_constant_HAND_MAX:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`Hands<enum_OpenXRHand_Hands>` **HAND_MAX** = ``2``
|
|
|
|
Máximo de manos admitidas.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _enum_OpenXRHand_MotionRange:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **MotionRange**: :ref:`🔗<enum_OpenXRHand_MotionRange>`
|
|
|
|
.. _class_OpenXRHand_constant_MOTION_RANGE_UNOBSTRUCTED:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`MotionRange<enum_OpenXRHand_MotionRange>` **MOTION_RANGE_UNOBSTRUCTED** = ``0``
|
|
|
|
Cuando el jugador agarra, el esqueleto de la mano formará un puño completo.
|
|
|
|
.. _class_OpenXRHand_constant_MOTION_RANGE_CONFORM_TO_CONTROLLER:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`MotionRange<enum_OpenXRHand_MotionRange>` **MOTION_RANGE_CONFORM_TO_CONTROLLER** = ``1``
|
|
|
|
Cuando el jugador agarra, el esqueleto de la mano se adapta al controlador que está sujetando el jugador.
|
|
|
|
.. _class_OpenXRHand_constant_MOTION_RANGE_MAX:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`MotionRange<enum_OpenXRHand_MotionRange>` **MOTION_RANGE_MAX** = ``2``
|
|
|
|
Rangos de movimiento máximos admitidos.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _enum_OpenXRHand_SkeletonRig:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **SkeletonRig**: :ref:`🔗<enum_OpenXRHand_SkeletonRig>`
|
|
|
|
.. _class_OpenXRHand_constant_SKELETON_RIG_OPENXR:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`SkeletonRig<enum_OpenXRHand_SkeletonRig>` **SKELETON_RIG_OPENXR** = ``0``
|
|
|
|
Un esqueleto compatible con OpenXR.
|
|
|
|
.. _class_OpenXRHand_constant_SKELETON_RIG_HUMANOID:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`SkeletonRig<enum_OpenXRHand_SkeletonRig>` **SKELETON_RIG_HUMANOID** = ``1``
|
|
|
|
Un esqueleto compatible con :ref:`SkeletonProfileHumanoid<class_SkeletonProfileHumanoid>`.
|
|
|
|
.. _class_OpenXRHand_constant_SKELETON_RIG_MAX:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`SkeletonRig<enum_OpenXRHand_SkeletonRig>` **SKELETON_RIG_MAX** = ``2``
|
|
|
|
Máximo de manos admitidas.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _enum_OpenXRHand_BoneUpdate:
|
|
|
|
.. rst-class:: classref-enumeration
|
|
|
|
enum **BoneUpdate**: :ref:`🔗<enum_OpenXRHand_BoneUpdate>`
|
|
|
|
.. _class_OpenXRHand_constant_BONE_UPDATE_FULL:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`BoneUpdate<enum_OpenXRHand_BoneUpdate>` **BONE_UPDATE_FULL** = ``0``
|
|
|
|
Los huesos del esqueleto se actualizan por completo (tanto la posición como la rotación) para que coincidan con los huesos rastreados.
|
|
|
|
.. _class_OpenXRHand_constant_BONE_UPDATE_ROTATION_ONLY:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`BoneUpdate<enum_OpenXRHand_BoneUpdate>` **BONE_UPDATE_ROTATION_ONLY** = ``1``
|
|
|
|
Los huesos del esqueleto solo se rotan para alinearse con los huesos rastreados, preservando la longitud de los huesos.
|
|
|
|
.. _class_OpenXRHand_constant_BONE_UPDATE_MAX:
|
|
|
|
.. rst-class:: classref-enumeration-constant
|
|
|
|
:ref:`BoneUpdate<enum_OpenXRHand_BoneUpdate>` **BONE_UPDATE_MAX** = ``2``
|
|
|
|
Modo de actualización de hueso máximo admitido.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descripciones de Propiedades
|
|
--------------------------------------------------------
|
|
|
|
.. _class_OpenXRHand_property_bone_update:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`BoneUpdate<enum_OpenXRHand_BoneUpdate>` **bone_update** = ``0`` :ref:`🔗<class_OpenXRHand_property_bone_update>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_bone_update**\ (\ value\: :ref:`BoneUpdate<enum_OpenXRHand_BoneUpdate>`\ )
|
|
- :ref:`BoneUpdate<enum_OpenXRHand_BoneUpdate>` **get_bone_update**\ (\ )
|
|
|
|
Especifica el tipo de actualizaciones que se realizarán en el hueso.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_OpenXRHand_property_hand:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`Hands<enum_OpenXRHand_Hands>` **hand** = ``0`` :ref:`🔗<class_OpenXRHand_property_hand>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_hand**\ (\ value\: :ref:`Hands<enum_OpenXRHand_Hands>`\ )
|
|
- :ref:`Hands<enum_OpenXRHand_Hands>` **get_hand**\ (\ )
|
|
|
|
Especifica si este nodo rastrea la mano izquierda o derecha del jugador.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_OpenXRHand_property_hand_skeleton:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`NodePath<class_NodePath>` **hand_skeleton** = ``NodePath("")`` :ref:`🔗<class_OpenXRHand_property_hand_skeleton>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_hand_skeleton**\ (\ value\: :ref:`NodePath<class_NodePath>`\ )
|
|
- :ref:`NodePath<class_NodePath>` **get_hand_skeleton**\ (\ )
|
|
|
|
Establece un nodo :ref:`Skeleton3D<class_Skeleton3D>` para el cual se actualizarán las posiciones de la pose.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_OpenXRHand_property_motion_range:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`MotionRange<enum_OpenXRHand_MotionRange>` **motion_range** = ``0`` :ref:`🔗<class_OpenXRHand_property_motion_range>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_motion_range**\ (\ value\: :ref:`MotionRange<enum_OpenXRHand_MotionRange>`\ )
|
|
- :ref:`MotionRange<enum_OpenXRHand_MotionRange>` **get_motion_range**\ (\ )
|
|
|
|
Establece el rango de movimiento (si es compatible) limitando el movimiento de la mano.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_OpenXRHand_property_skeleton_rig:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`SkeletonRig<enum_OpenXRHand_SkeletonRig>` **skeleton_rig** = ``0`` :ref:`🔗<class_OpenXRHand_property_skeleton_rig>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_skeleton_rig**\ (\ value\: :ref:`SkeletonRig<enum_OpenXRHand_SkeletonRig>`\ )
|
|
- :ref:`SkeletonRig<enum_OpenXRHand_SkeletonRig>` **get_skeleton_rig**\ (\ )
|
|
|
|
Establece el tipo de rig de esqueleto con el que :ref:`hand_skeleton<class_OpenXRHand_property_hand_skeleton>` es compatible.
|
|
|
|
.. |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.)`
|