:github_url: hide .. _class_XRPose: XRPose ====== **Hérite de :** :ref:`RefCounted` **<** :ref:`Object` Cet objet contient toutes les données relatives à une pose sur un objet suivi. .. rst-class:: classref-introduction-group Description ----------- Les runtimes XR identifient souvent plusieurs emplacements sur des appareils tels que les contrôleurs qui sont suivis spatialements. L'orientation, la localisation, la vitesse linéaire et la vitesse angulaire sont tous fournis pour chaque pose par le runtime XR. Cet objet contient cet état d'une pose. .. rst-class:: classref-introduction-group Tutoriels ------------------ - :doc:`Index de la documentation sur la XR <../tutorials/xr/index>` .. rst-class:: classref-reftable-group Propriétés -------------------- .. table:: :widths: auto +-----------------------------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------------+ | :ref:`Vector3` | :ref:`angular_velocity` | ``Vector3(0, 0, 0)`` | +-----------------------------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------------+ | :ref:`bool` | :ref:`has_tracking_data` | ``false`` | +-----------------------------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------------+ | :ref:`Vector3` | :ref:`linear_velocity` | ``Vector3(0, 0, 0)`` | +-----------------------------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------------+ | :ref:`StringName` | :ref:`name` | ``&""`` | +-----------------------------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------------+ | :ref:`TrackingConfidence` | :ref:`tracking_confidence` | ``0`` | +-----------------------------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------------+ | :ref:`Transform3D` | :ref:`transform` | ``Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0)`` | +-----------------------------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------------+ .. rst-class:: classref-reftable-group Méthodes ---------------- .. table:: :widths: auto +---------------------------------------+-----------------------------------------------------------------------------------------+ | :ref:`Transform3D` | :ref:`get_adjusted_transform`\ (\ ) |const| | +---------------------------------------+-----------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Énumérations ------------------------ .. _enum_XRPose_TrackingConfidence: .. rst-class:: classref-enumeration enum **TrackingConfidence**: :ref:`🔗` .. _class_XRPose_constant_XR_TRACKING_CONFIDENCE_NONE: .. rst-class:: classref-enumeration-constant :ref:`TrackingConfidence` **XR_TRACKING_CONFIDENCE_NONE** = ``0`` Aucune information de suivi n'est disponible pour cette pose. .. _class_XRPose_constant_XR_TRACKING_CONFIDENCE_LOW: .. rst-class:: classref-enumeration-constant :ref:`TrackingConfidence` **XR_TRACKING_CONFIDENCE_LOW** = ``1`` Les informations de suivi peuvent être inexactes ou estimées. Par exemple, avec le suivi "inside out" (sans balises externes), cela indiquerait qu'un contrôleur peut être (partiellement) obscurci. .. _class_XRPose_constant_XR_TRACKING_CONFIDENCE_HIGH: .. rst-class:: classref-enumeration-constant :ref:`TrackingConfidence` **XR_TRACKING_CONFIDENCE_HIGH** = ``2`` L'information de suivi est considérée comme exacte et à jour. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descriptions des propriétés ------------------------------------------------------ .. _class_XRPose_property_angular_velocity: .. rst-class:: classref-property :ref:`Vector3` **angular_velocity** = ``Vector3(0, 0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_angular_velocity**\ (\ value\: :ref:`Vector3`\ ) - :ref:`Vector3` **get_angular_velocity**\ (\ ) La vitesse angulaire pour cette pose. .. rst-class:: classref-item-separator ---- .. _class_XRPose_property_has_tracking_data: .. rst-class:: classref-property :ref:`bool` **has_tracking_data** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_has_tracking_data**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_has_tracking_data**\ (\ ) Si ``true``, nos données de suivi sont à jour. Si ``false``, nous ne recevons plus de nouvelles données de suivi et notre état est ce qu'était le dernier état valide. .. rst-class:: classref-item-separator ---- .. _class_XRPose_property_linear_velocity: .. rst-class:: classref-property :ref:`Vector3` **linear_velocity** = ``Vector3(0, 0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_linear_velocity**\ (\ value\: :ref:`Vector3`\ ) - :ref:`Vector3` **get_linear_velocity**\ (\ ) La vitesse linéaire pour cette pose. .. rst-class:: classref-item-separator ---- .. _class_XRPose_property_name: .. rst-class:: classref-property :ref:`StringName` **name** = ``&""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_name**\ (\ value\: :ref:`StringName`\ ) - :ref:`StringName` **get_name**\ (\ ) Le nom de cette pose. Habituellement, ce nom est dérivé d'une action map établie par l'utilisateur. Godot suggère également quelques noms de pose que les objets :ref:`XRInterface` sont censés implémenter : - ``root`` est l'emplacement racine, souvent utilisé pour les objets suivis qui n'ont pas d'autres nœuds. - ``aim`` est la pointe d'un contrôleur avec son orientation pointant vers l'extérieur, souvent utilisé pour les raycasts. - ``grip`` est l'endroit où l'utilisateur tient le contrôleur. - ``skeleton`` est l'emplacement racine d'un maillage de main, lorsqu'on utilise le suivi des mains et qu'un squelette animé est fourni par le runtime XR. .. rst-class:: classref-item-separator ---- .. _class_XRPose_property_tracking_confidence: .. rst-class:: classref-property :ref:`TrackingConfidence` **tracking_confidence** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_tracking_confidence**\ (\ value\: :ref:`TrackingConfidence`\ ) - :ref:`TrackingConfidence` **get_tracking_confidence**\ (\ ) La confiance du suivi pour cette pose, donne un aperçu d'à quel point le positionnement spatial de cet enregistrement est précis. .. rst-class:: classref-item-separator ---- .. _class_XRPose_property_transform: .. rst-class:: classref-property :ref:`Transform3D` **transform** = ``Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0)`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_transform**\ (\ value\: :ref:`Transform3D`\ ) - :ref:`Transform3D` **get_transform**\ (\ ) La transformation contenant la transformation originale comme rapporté par le runtime XR. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descriptions des méthodes -------------------------------------------------- .. _class_XRPose_method_get_adjusted_transform: .. rst-class:: classref-method :ref:`Transform3D` **get_adjusted_transform**\ (\ ) |const| :ref:`🔗` Renvoie la transformation :ref:`transform` avec l'échelle globale et notre repère de référence appliqués. C'est la transformation utilisée pour positionner les objets :ref:`XRNode3D`. .. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)` .. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)` .. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)` .. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)` .. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)` .. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)` .. |void| replace:: :abbr:`void (Aucune valeur de retour.)`