Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

XRPose

Eredita: RefCounted < Object

Questo oggetto contiene tutti i dati relativi a una posa su un oggetto tracciato.

Descrizione

I runtime XR spesso identificano più posizioni su dispositivi come controller che sono tracciati spazialmente.

Orientamento, posizione, velocità lineare e velocità angolare sono tutti forniti per ogni posa dal runtime XR. Questo oggetto contiene questo stato di una posa.

Tutorial

Proprietà

Vector3

angular_velocity

Vector3(0, 0, 0)

bool

has_tracking_data

false

Vector3

linear_velocity

Vector3(0, 0, 0)

StringName

name

&""

TrackingConfidence

tracking_confidence

0

Transform3D

transform

Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0)

Metodi

Transform3D

get_adjusted_transform() const


Enumerazioni

enum TrackingConfidence: 🔗

TrackingConfidence XR_TRACKING_CONFIDENCE_NONE = 0

Non sono disponibili informazioni di tracciamento per questa posa.

TrackingConfidence XR_TRACKING_CONFIDENCE_LOW = 1

Le informazioni di tracciamento potrebbero essere imprecise o stimate. Ad esempio, con il tracciamento "inside out" questo indicherebbe che un controller potrebbe essere (parzialmente) oscurato.

TrackingConfidence XR_TRACKING_CONFIDENCE_HIGH = 2

Le informazioni di tracciamento sono considerate accurate e aggiornate.


Descrizioni delle proprietà

Vector3 angular_velocity = Vector3(0, 0, 0) 🔗

  • void set_angular_velocity(value: Vector3)

  • Vector3 get_angular_velocity()

La velocità angolare per questa posa.


bool has_tracking_data = false 🔗

  • void set_has_tracking_data(value: bool)

  • bool get_has_tracking_data()

Se true i nostri dati di tracciamento sono aggiornati. Se false non stiamo ricevendo più nuovi dati di tracciamento e il nostro stato è qualunque fosse l'ultimo stato valido.


Vector3 linear_velocity = Vector3(0, 0, 0) 🔗

  • void set_linear_velocity(value: Vector3)

  • Vector3 get_linear_velocity()

La velocità lineare di questa posa.


StringName name = &"" 🔗

Il nome di questa posa. Di solito, questo nome è derivato da una mappa di azioni configurata dall'utente. Godot suggerisce inoltre alcuni nomi di pose che gli oggetti XRInterface dovrebbero implementare:

  • root è la posizione radice, spesso utilizzata per gli oggetti tracciati che non hanno ulteriori nodi.

  • aim è la punta di un controller con l'orientamento rivolto verso l'esterno, spesso usato per i raycast.

  • grip è la posizione in cui l'utente afferra il controller

  • skeleton è la posizione radice di una mesh di mano, quando si utilizza il tracciamento della mano e uno scheletro animato è fornito dal runtime XR.


TrackingConfidence tracking_confidence = 0 🔗

L'affidabilità del tracciamento per questa posa fornisce informazioni su quanto sia accurato il posizionamento spaziale di questa registrazione.


Transform3D transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0) 🔗

La trasformazione contenente l'origine e la trasformazione come riportata dal runtime XR.


Descrizioni dei metodi

Transform3D get_adjusted_transform() const 🔗

Restituisce la transform con scala mondiale e il nostro sistema di riferimento applicato. Questa è la trasformazione usata per posizionare gli oggetti XRNode3D.