:github_url: hide .. _class_OpenXRInterface: OpenXRInterface =============== **Eredita:** :ref:`XRInterface` **<** :ref:`RefCounted` **<** :ref:`Object` La nostra interfaccia OpenXR. .. rst-class:: classref-introduction-group Descrizione ---------------------- L'interfaccia OpenXR consente a Godot di interagire con le esecuzioni OpenXR e di creare esperienze e giochi XR. A causa delle esigenze di OpenXR, questa interfaccia funziona in modo leggermente diverso rispetto ad altre interfacce XR basate sulle estensioni. Deve essere inizializzata all'avvio di Godot. È necessario abilitare OpenXR, le quali impostazioni sono presenti nelle impostazioni del progetto di gioco sotto l'intestazione XR. È necessario contrassegnare una viewport per l'uso con XR affinché Godot sappia quale risultato di rendering deve essere trasmesso al visore. .. rst-class:: classref-introduction-group Tutorial ---------------- - :doc:`Configurazione dell'XR <../tutorials/xr/setting_up_xr>` .. rst-class:: classref-reftable-group Proprietà ------------------ .. table:: :widths: auto +---------------------------+----------------------------------------------------------------------------------------------------+-----------+ | :ref:`float` | :ref:`display_refresh_rate` | ``0.0`` | +---------------------------+----------------------------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`foveation_dynamic` | ``false`` | +---------------------------+----------------------------------------------------------------------------------------------------+-----------+ | :ref:`int` | :ref:`foveation_level` | ``0`` | +---------------------------+----------------------------------------------------------------------------------------------------+-----------+ | :ref:`float` | :ref:`render_target_size_multiplier` | ``1.0`` | +---------------------------+----------------------------------------------------------------------------------------------------+-----------+ | :ref:`float` | :ref:`vrs_min_radius` | ``20.0`` | +---------------------------+----------------------------------------------------------------------------------------------------+-----------+ | :ref:`float` | :ref:`vrs_strength` | ``1.0`` | +---------------------------+----------------------------------------------------------------------------------------------------+-----------+ .. rst-class:: classref-reftable-group Metodi ------------ .. table:: :widths: auto +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array` | :ref:`get_action_sets`\ (\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array` | :ref:`get_available_display_refresh_rates`\ (\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_hand_joint_angular_velocity`\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |bitfield|\[:ref:`HandJointFlags`\] | :ref:`get_hand_joint_flags`\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_hand_joint_linear_velocity`\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_hand_joint_position`\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_hand_joint_radius`\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Quaternion` | :ref:`get_hand_joint_rotation`\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`HandTrackedSource` | :ref:`get_hand_tracking_source`\ (\ hand\: :ref:`Hand`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`HandMotionRange` | :ref:`get_motion_range`\ (\ hand\: :ref:`Hand`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`SessionState` | :ref:`get_session_state`\ (\ ) | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_action_set_active`\ (\ name\: :ref:`String`\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_eye_gaze_interaction_supported`\ (\ ) | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_foveation_supported`\ (\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_hand_interaction_supported`\ (\ ) |const| | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_hand_tracking_supported`\ (\ ) | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_action_set_active`\ (\ name\: :ref:`String`, active\: :ref:`bool`\ ) | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_cpu_level`\ (\ level\: :ref:`PerfSettingsLevel`\ ) | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_gpu_level`\ (\ level\: :ref:`PerfSettingsLevel`\ ) | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_motion_range`\ (\ hand\: :ref:`Hand`, motion_range\: :ref:`HandMotionRange`\ ) | +--------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Segnali -------------- .. _class_OpenXRInterface_signal_cpu_level_changed: .. rst-class:: classref-signal **cpu_level_changed**\ (\ sub_domain\: :ref:`int`, from_level\: :ref:`int`, to_level\: :ref:`int`\ ) :ref:`🔗` Informa il dispositivo che il livello di prestazioni della CPU è cambiato nel sottodominio specificato. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_gpu_level_changed: .. rst-class:: classref-signal **gpu_level_changed**\ (\ sub_domain\: :ref:`int`, from_level\: :ref:`int`, to_level\: :ref:`int`\ ) :ref:`🔗` Informa il dispositivo che il livello di prestazioni della GPU è cambiato nel sottodominio specificato. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_instance_exiting: .. rst-class:: classref-signal **instance_exiting**\ (\ ) :ref:`🔗` Informa che la nostra istanza OpenXR è in fase di chiusura. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_pose_recentered: .. rst-class:: classref-signal **pose_recentered**\ (\ ) :ref:`🔗` Informa che l'utente ha richiesto un ricentramento della posizione del giocatore. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_refresh_rate_changed: .. rst-class:: classref-signal **refresh_rate_changed**\ (\ refresh_rate\: :ref:`float`\ ) :ref:`🔗` Informa l'utente che la frequenza di aggiornamento dell'HMD è cambiata. \ **Nota:** Emesso solo se l'esecuzione XR supporta l'estensione della frequenza di aggiornamento. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_session_begun: .. rst-class:: classref-signal **session_begun**\ (\ ) :ref:`🔗` Informa che la nostra sessione OpenXR è stata avviata. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_session_focussed: .. rst-class:: classref-signal **session_focussed**\ (\ ) :ref:`🔗` Informa che la nostra sessione OpenXR è ora focalizzata, ad esempio l'output viene inviato all'HMD e stiamo ricevendo input XR. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_session_loss_pending: .. rst-class:: classref-signal **session_loss_pending**\ (\ ) :ref:`🔗` Informa che la nostra sessione OpenXR sta per andare persa. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_session_stopping: .. rst-class:: classref-signal **session_stopping**\ (\ ) :ref:`🔗` Informa che la nostra sessione OpenXR si sta interrompendo. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_session_synchronized: .. rst-class:: classref-signal **session_synchronized**\ (\ ) :ref:`🔗` Informa che la nostra sessione OpenXR è stata sincronizzata. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_signal_session_visible: .. rst-class:: classref-signal **session_visible**\ (\ ) :ref:`🔗` Informa che la nostra sessione OpenXR è ora visibile, ad esempio l'output viene inviato all'HMD e ma non riceviamo input XR. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Enumerazioni ------------------------ .. _enum_OpenXRInterface_SessionState: .. rst-class:: classref-enumeration enum **SessionState**: :ref:`🔗` .. _class_OpenXRInterface_constant_SESSION_STATE_UNKNOWN: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_UNKNOWN** = ``0`` Lo stato della sessione è sconosciuto, non abbiamo ancora provato a configurare OpenXR. .. _class_OpenXRInterface_constant_SESSION_STATE_IDLE: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_IDLE** = ``1`` Lo stato iniziale dopo la creazione della sessione OpenXR o dopo la sua eliminazione. .. _class_OpenXRInterface_constant_SESSION_STATE_READY: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_READY** = ``2`` OpenXR è pronto per iniziare la nostra sessione. :ref:`session_begun` viene emesso quando si passa a questo stato. .. _class_OpenXRInterface_constant_SESSION_STATE_SYNCHRONIZED: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_SYNCHRONIZED** = ``3`` L'applicazione ha sincronizzato il suo ciclo di frame con l'esecuzione, ma nulla è stato renderizzando ancora. :ref:`session_synchronized` viene emesso quando si passa a questo stato. .. _class_OpenXRInterface_constant_SESSION_STATE_VISIBLE: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_VISIBLE** = ``4`` L'applicazione ha sincronizzato il suo ciclo di frame con l'esecuzione e si sta renderizzando il risultato all'utente, tuttavia non è stato ricevuto alcun input dall'utente. :ref:`session_visible` viene emesso quando si passa a questo stato. \ **Nota:** Questo è lo stato attuale appena prima di ottenere lo stato focalizzato, ogni volta che l'utente apre un menu di sistema, passa a un'altra applicazione o si toglie il visore. .. _class_OpenXRInterface_constant_SESSION_STATE_FOCUSED: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_FOCUSED** = ``5`` L'applicazione ha sincronizzato il suo ciclo di frame con l'esecuzione, si sta renderizzando il risultato all'utente e si sta ricevendo l'input XR. :ref:`session_focussed` viene emesso quando si passa a questo stato. \ **Nota:** Questo è lo stato in cui si troverà OpenXR quando l'utente potrà interagire completamente con il gioco. .. _class_OpenXRInterface_constant_SESSION_STATE_STOPPING: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_STOPPING** = ``6`` La nostra sessione è in interruzione. :ref:`session_stopping` viene emesso quando si passa a questo stato. .. _class_OpenXRInterface_constant_SESSION_STATE_LOSS_PENDING: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_LOSS_PENDING** = ``7`` La sessione sta per perdersi. :ref:`session_loss_pending` viene emesso quando si passa a questo stato. .. _class_OpenXRInterface_constant_SESSION_STATE_EXITING: .. rst-class:: classref-enumeration-constant :ref:`SessionState` **SESSION_STATE_EXITING** = ``8`` The OpenXR instance is about to be destroyed and we're exiting. :ref:`instance_exiting` is emitted when we change to this state. .. rst-class:: classref-item-separator ---- .. _enum_OpenXRInterface_Hand: .. rst-class:: classref-enumeration enum **Hand**: :ref:`🔗` .. _class_OpenXRInterface_constant_HAND_LEFT: .. rst-class:: classref-enumeration-constant :ref:`Hand` **HAND_LEFT** = ``0`` Mano sinistra. .. _class_OpenXRInterface_constant_HAND_RIGHT: .. rst-class:: classref-enumeration-constant :ref:`Hand` **HAND_RIGHT** = ``1`` Mano destra. .. _class_OpenXRInterface_constant_HAND_MAX: .. rst-class:: classref-enumeration-constant :ref:`Hand` **HAND_MAX** = ``2`` Valore massimo per la enumeratore della mano. .. rst-class:: classref-item-separator ---- .. _enum_OpenXRInterface_HandMotionRange: .. rst-class:: classref-enumeration enum **HandMotionRange**: :ref:`🔗` .. _class_OpenXRInterface_constant_HAND_MOTION_RANGE_UNOBSTRUCTED: .. rst-class:: classref-enumeration-constant :ref:`HandMotionRange` **HAND_MOTION_RANGE_UNOBSTRUCTED** = ``0`` Intervallo totale della mano: se l'utente chiude le mani, si forma un pugno pieno. .. _class_OpenXRInterface_constant_HAND_MOTION_RANGE_CONFORM_TO_CONTROLLER: .. rst-class:: classref-enumeration-constant :ref:`HandMotionRange` **HAND_MOTION_RANGE_CONFORM_TO_CONTROLLER** = ``1`` Conforme al controller: se l'utente chiude le mani, i dati tracciati si adattano alla forma del controller. .. _class_OpenXRInterface_constant_HAND_MOTION_RANGE_MAX: .. rst-class:: classref-enumeration-constant :ref:`HandMotionRange` **HAND_MOTION_RANGE_MAX** = ``2`` Valore massimo per l'enumeratore della gamma di movimento. .. rst-class:: classref-item-separator ---- .. _enum_OpenXRInterface_HandTrackedSource: .. rst-class:: classref-enumeration enum **HandTrackedSource**: :ref:`🔗` .. _class_OpenXRInterface_constant_HAND_TRACKED_SOURCE_UNKNOWN: .. rst-class:: classref-enumeration-constant :ref:`HandTrackedSource` **HAND_TRACKED_SOURCE_UNKNOWN** = ``0`` La sorgente dei dati di tracciamento della mano è sconosciuta (probabilmente l'estensione non è supportata). .. _class_OpenXRInterface_constant_HAND_TRACKED_SOURCE_UNOBSTRUCTED: .. rst-class:: classref-enumeration-constant :ref:`HandTrackedSource` **HAND_TRACKED_SOURCE_UNOBSTRUCTED** = ``1`` La sorgente del tracciamento della mano non è ostruita, il che significa che è utilizzato un metodo accurato di tracciamento delle mani, ad esempio tracciamento ottico delle mani, guanti per dati, ecc. .. _class_OpenXRInterface_constant_HAND_TRACKED_SOURCE_CONTROLLER: .. rst-class:: classref-enumeration-constant :ref:`HandTrackedSource` **HAND_TRACKED_SOURCE_CONTROLLER** = ``2`` La sorgente dei dati di tracciamento della mano è un controller, le posizioni delle articolazioni sono dedotte dagli input del controller. .. _class_OpenXRInterface_constant_HAND_TRACKED_SOURCE_MAX: .. rst-class:: classref-enumeration-constant :ref:`HandTrackedSource` **HAND_TRACKED_SOURCE_MAX** = ``3`` Rappresenta la dimensione dell'enumerazione :ref:`HandTrackedSource`. .. rst-class:: classref-item-separator ---- .. _enum_OpenXRInterface_HandJoints: .. rst-class:: classref-enumeration enum **HandJoints**: :ref:`🔗` .. _class_OpenXRInterface_constant_HAND_JOINT_PALM: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_PALM** = ``0`` Articolazione del palmo. .. _class_OpenXRInterface_constant_HAND_JOINT_WRIST: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_WRIST** = ``1`` Articolazione del polso. .. _class_OpenXRInterface_constant_HAND_JOINT_THUMB_METACARPAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_THUMB_METACARPAL** = ``2`` Articolazione metacarpale del pollice. .. _class_OpenXRInterface_constant_HAND_JOINT_THUMB_PROXIMAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_THUMB_PROXIMAL** = ``3`` Articolazione prossimale del pollice. .. _class_OpenXRInterface_constant_HAND_JOINT_THUMB_DISTAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_THUMB_DISTAL** = ``4`` Articolazione distale del pollice. .. _class_OpenXRInterface_constant_HAND_JOINT_THUMB_TIP: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_THUMB_TIP** = ``5`` Articolazione della punta del pollice. .. _class_OpenXRInterface_constant_HAND_JOINT_INDEX_METACARPAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_INDEX_METACARPAL** = ``6`` Articolazione metacarpale dell'indice. .. _class_OpenXRInterface_constant_HAND_JOINT_INDEX_PROXIMAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_INDEX_PROXIMAL** = ``7`` Articolazione prossimale della falange dell'indice. .. _class_OpenXRInterface_constant_HAND_JOINT_INDEX_INTERMEDIATE: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_INDEX_INTERMEDIATE** = ``8`` Articolazione intermedia della falange dell'indice. .. _class_OpenXRInterface_constant_HAND_JOINT_INDEX_DISTAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_INDEX_DISTAL** = ``9`` Articolazione distale della falange dell'indice. .. _class_OpenXRInterface_constant_HAND_JOINT_INDEX_TIP: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_INDEX_TIP** = ``10`` Articolazione della punta dell'indice. .. _class_OpenXRInterface_constant_HAND_JOINT_MIDDLE_METACARPAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_MIDDLE_METACARPAL** = ``11`` Articolazione metacarpale del dito medio. .. _class_OpenXRInterface_constant_HAND_JOINT_MIDDLE_PROXIMAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_MIDDLE_PROXIMAL** = ``12`` Articolazione prossimale della falange del dito medio. .. _class_OpenXRInterface_constant_HAND_JOINT_MIDDLE_INTERMEDIATE: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_MIDDLE_INTERMEDIATE** = ``13`` Articolazione intermedia della falange del dito medio. .. _class_OpenXRInterface_constant_HAND_JOINT_MIDDLE_DISTAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_MIDDLE_DISTAL** = ``14`` Articolazione distale della falange del dito medio. .. _class_OpenXRInterface_constant_HAND_JOINT_MIDDLE_TIP: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_MIDDLE_TIP** = ``15`` Articolazione della punta del dito medio. .. _class_OpenXRInterface_constant_HAND_JOINT_RING_METACARPAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_RING_METACARPAL** = ``16`` Articolazione metacarpale dell'anulare. .. _class_OpenXRInterface_constant_HAND_JOINT_RING_PROXIMAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_RING_PROXIMAL** = ``17`` Articolazione prossimale della falange dell'anulare. .. _class_OpenXRInterface_constant_HAND_JOINT_RING_INTERMEDIATE: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_RING_INTERMEDIATE** = ``18`` Articolazione intermedia della falange dell'anulare. .. _class_OpenXRInterface_constant_HAND_JOINT_RING_DISTAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_RING_DISTAL** = ``19`` Articolazione distale della falange dell'anulare. .. _class_OpenXRInterface_constant_HAND_JOINT_RING_TIP: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_RING_TIP** = ``20`` Articolazione della punta dell'anulare. .. _class_OpenXRInterface_constant_HAND_JOINT_LITTLE_METACARPAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_LITTLE_METACARPAL** = ``21`` Articolazione metacarpale del mignolo. .. _class_OpenXRInterface_constant_HAND_JOINT_LITTLE_PROXIMAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_LITTLE_PROXIMAL** = ``22`` Articolazione prossimale della falange del mignolo. .. _class_OpenXRInterface_constant_HAND_JOINT_LITTLE_INTERMEDIATE: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_LITTLE_INTERMEDIATE** = ``23`` Articolazione intermedia della falange del mignolo. .. _class_OpenXRInterface_constant_HAND_JOINT_LITTLE_DISTAL: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_LITTLE_DISTAL** = ``24`` Articolazione distale della falange del mignolo. .. _class_OpenXRInterface_constant_HAND_JOINT_LITTLE_TIP: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_LITTLE_TIP** = ``25`` Articolazione della punta del mignolo. .. _class_OpenXRInterface_constant_HAND_JOINT_MAX: .. rst-class:: classref-enumeration-constant :ref:`HandJoints` **HAND_JOINT_MAX** = ``26`` Rappresenta la dimensione dell'enumerazione :ref:`HandJoints`. .. rst-class:: classref-item-separator ---- .. _enum_OpenXRInterface_PerfSettingsLevel: .. rst-class:: classref-enumeration enum **PerfSettingsLevel**: :ref:`🔗` .. _class_OpenXRInterface_constant_PERF_SETTINGS_LEVEL_POWER_SAVINGS: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsLevel` **PERF_SETTINGS_LEVEL_POWER_SAVINGS** = ``0`` L'applicazione è entrata in una sezione non XR (testa bloccata o schermo statico), durante la quale si deve priorizzare il risparmio energetico. .. _class_OpenXRInterface_constant_PERF_SETTINGS_LEVEL_SUSTAINED_LOW: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsLevel` **PERF_SETTINGS_LEVEL_SUSTAINED_LOW** = ``1`` L'applicazione è entrata in una sezione di complessità bassa e stabile, durante la quale la riduzione del consumo energetico è più importante dei frame di rendering occasionalmente in ritardo. .. _class_OpenXRInterface_constant_PERF_SETTINGS_LEVEL_SUSTAINED_HIGH: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsLevel` **PERF_SETTINGS_LEVEL_SUSTAINED_HIGH** = ``2`` L'applicazione è entrata in una sezione di complessità elevata o dinamica, durante la quale il Runtime XR si impegna a ottenere un compositing XR e un rendering dei frame costanti entro un intervallo termicamente sostenibile. .. _class_OpenXRInterface_constant_PERF_SETTINGS_LEVEL_BOOST: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsLevel` **PERF_SETTINGS_LEVEL_BOOST** = ``3`` L'applicazione è entrata in una sezione di complessità molto elevata, durante la quale il Runtime XR può superare l'intervallo termicamente sostenibile. .. rst-class:: classref-item-separator ---- .. _enum_OpenXRInterface_PerfSettingsSubDomain: .. rst-class:: classref-enumeration enum **PerfSettingsSubDomain**: :ref:`🔗` .. _class_OpenXRInterface_constant_PERF_SETTINGS_SUB_DOMAIN_COMPOSITING: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsSubDomain` **PERF_SETTINGS_SUB_DOMAIN_COMPOSITING** = ``0`` Le prestazioni di compositing in fase di esecuzione hanno raggiunto un nuovo livello. .. _class_OpenXRInterface_constant_PERF_SETTINGS_SUB_DOMAIN_RENDERING: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsSubDomain` **PERF_SETTINGS_SUB_DOMAIN_RENDERING** = ``1`` Le prestazioni di rendering delle applicazioni hanno raggiunto un nuovo livello. .. _class_OpenXRInterface_constant_PERF_SETTINGS_SUB_DOMAIN_THERMAL: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsSubDomain` **PERF_SETTINGS_SUB_DOMAIN_THERMAL** = ``2`` La temperatura del dispositivo ha raggiunto un nuovo livello. .. rst-class:: classref-item-separator ---- .. _enum_OpenXRInterface_PerfSettingsNotificationLevel: .. rst-class:: classref-enumeration enum **PerfSettingsNotificationLevel**: :ref:`🔗` .. _class_OpenXRInterface_constant_PERF_SETTINGS_NOTIF_LEVEL_NORMAL: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsNotificationLevel` **PERF_SETTINGS_NOTIF_LEVEL_NORMAL** = ``0`` Il sottodominio ha raggiunto un livello in cui non sono necessarie ulteriori azioni oltre a quelle attualmente applicate. .. _class_OpenXRInterface_constant_PERF_SETTINGS_NOTIF_LEVEL_WARNING: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsNotificationLevel` **PERF_SETTINGS_NOTIF_LEVEL_WARNING** = ``1`` Il sottodominio ha raggiunto un livello precoce di allerta tale per cui l'applicazione dovrebbe avviare azioni proattive di mitigazione. .. _class_OpenXRInterface_constant_PERF_SETTINGS_NOTIF_LEVEL_IMPAIRED: .. rst-class:: classref-enumeration-constant :ref:`PerfSettingsNotificationLevel` **PERF_SETTINGS_NOTIF_LEVEL_IMPAIRED** = ``2`` Il sottodominio ha raggiunto un livello critico tale per cui l'applicazione dovrebbe avviare drastiche azioni di mitigazione. .. rst-class:: classref-item-separator ---- .. _enum_OpenXRInterface_HandJointFlags: .. rst-class:: classref-enumeration flags **HandJointFlags**: :ref:`🔗` .. _class_OpenXRInterface_constant_HAND_JOINT_NONE: .. rst-class:: classref-enumeration-constant :ref:`HandJointFlags` **HAND_JOINT_NONE** = ``0`` Nessun flag è impostato. .. _class_OpenXRInterface_constant_HAND_JOINT_ORIENTATION_VALID: .. rst-class:: classref-enumeration-constant :ref:`HandJointFlags` **HAND_JOINT_ORIENTATION_VALID** = ``1`` Se impostato, i dati di orientamento sono validi, altrimenti, i dati di orientamento non sono affidabili e non devono essere utilizzati. .. _class_OpenXRInterface_constant_HAND_JOINT_ORIENTATION_TRACKED: .. rst-class:: classref-enumeration-constant :ref:`HandJointFlags` **HAND_JOINT_ORIENTATION_TRACKED** = ``2`` Se impostato, i dati di orientamento provengono dai dati di tracciamento, altrimenti contengono dati anticipati. .. _class_OpenXRInterface_constant_HAND_JOINT_POSITION_VALID: .. rst-class:: classref-enumeration-constant :ref:`HandJointFlags` **HAND_JOINT_POSITION_VALID** = ``4`` Se impostato, i dati posizionali sono validi, altrimenti non sono affidabili e non dovrebbero essere utilizzati. .. _class_OpenXRInterface_constant_HAND_JOINT_POSITION_TRACKED: .. rst-class:: classref-enumeration-constant :ref:`HandJointFlags` **HAND_JOINT_POSITION_TRACKED** = ``8`` Se impostato, i dati posizionali provengono dai dati di tracciamento, altrimenti contengono dati anticipati. .. _class_OpenXRInterface_constant_HAND_JOINT_LINEAR_VELOCITY_VALID: .. rst-class:: classref-enumeration-constant :ref:`HandJointFlags` **HAND_JOINT_LINEAR_VELOCITY_VALID** = ``16`` Se impostato, i nostri dati sulla velocità lineare sono validi, altrimenti i dati sulla velocità lineare non sono affidabili e non dovrebbero essere utilizzati. .. _class_OpenXRInterface_constant_HAND_JOINT_ANGULAR_VELOCITY_VALID: .. rst-class:: classref-enumeration-constant :ref:`HandJointFlags` **HAND_JOINT_ANGULAR_VELOCITY_VALID** = ``32`` Se impostato, i nostri dati sulla velocità angolare sono validi, altrimenti i dati sulla velocità angolare non sono affidabili e non dovrebbero essere utilizzati. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni delle proprietà ------------------------------------------------------ .. _class_OpenXRInterface_property_display_refresh_rate: .. rst-class:: classref-property :ref:`float` **display_refresh_rate** = ``0.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_display_refresh_rate**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_display_refresh_rate**\ (\ ) La frequenza di aggiornamento del display per l'HMD corrente. Funziona solo se questa funzionalità è supportata dall'esecuzione OpenXR e dopo che l'interfaccia è stata inizializzata. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_property_foveation_dynamic: .. rst-class:: classref-property :ref:`bool` **foveation_dynamic** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_foveation_dynamic**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_foveation_dynamic**\ (\ ) If ``true``, enables dynamic foveation adjustment. The interface must be initialized before this is accessible. If enabled, foveation will automatically be adjusted between low and :ref:`foveation_level`. \ **Note:** Only works on the Compatibility renderer. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_property_foveation_level: .. rst-class:: classref-property :ref:`int` **foveation_level** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_foveation_level**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_foveation_level**\ (\ ) The foveation level, from ``0`` (off) to ``3`` (high). The interface must be initialized before this is accessible. \ **Note:** Only works on the Compatibility renderer. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_property_render_target_size_multiplier: .. rst-class:: classref-property :ref:`float` **render_target_size_multiplier** = ``1.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_render_target_size_multiplier**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_render_target_size_multiplier**\ (\ ) Il moltiplicatore delle dimensioni di rendering per l'HMD attuale. Deve essere impostato prima che l'interfaccia sia stata inizializzata. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_property_vrs_min_radius: .. rst-class:: classref-property :ref:`float` **vrs_min_radius** = ``20.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_vrs_min_radius**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_vrs_min_radius**\ (\ ) Il raggio minimo attorno al punto focale in cui è garantita la massima qualità se VRS viene utilizzato come percentuale della dimensione dello schermo. \ **Nota:** Solo per il rendering Mobile e Forward+. Richiede che :ref:`Viewport.vrs_mode` sia impostato su :ref:`Viewport.VRS_XR`. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_property_vrs_strength: .. rst-class:: classref-property :ref:`float` **vrs_strength** = ``1.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_vrs_strength**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_vrs_strength**\ (\ ) L'intensità utilizzata per calcolare la mappa di densità VRS. Maggiore è questo valore, più evidente è VRS. Ciò migliora le prestazioni a scapito della qualità. \ **Nota:** Solo rendering Mobile e Forward+. Richiede che :ref:`Viewport.vrs_mode` sia impostato su :ref:`Viewport.VRS_XR`. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni dei metodi -------------------------------------------- .. _class_OpenXRInterface_method_get_action_sets: .. rst-class:: classref-method :ref:`Array` **get_action_sets**\ (\ ) |const| :ref:`🔗` Restituisce una lista di insiemi di azioni registrati con Godot (caricati dalla mappa delle azioni in fase di esecuzione). .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_available_display_refresh_rates: .. rst-class:: classref-method :ref:`Array` **get_available_display_refresh_rates**\ (\ ) |const| :ref:`🔗` Returns a list of display refresh rates supported by the current HMD. Only returned if this feature is supported by the OpenXR runtime and after the interface has been initialized. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_hand_joint_angular_velocity: .. rst-class:: classref-method :ref:`Vector3` **get_hand_joint_angular_velocity**\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| :ref:`🔗` **Deprecato:** Use :ref:`XRHandTracker.get_hand_joint_angular_velocity()` obtained from :ref:`XRServer.get_tracker()` instead. Se il tracciamento della mano è abilitato, restituisce la velocità angolare di un'articolazione (``joint``) di una mano (``hand``) come fornita da OpenXR. Questa è relativa a :ref:`XROrigin3D`! .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_hand_joint_flags: .. rst-class:: classref-method |bitfield|\[:ref:`HandJointFlags`\] **get_hand_joint_flags**\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| :ref:`🔗` **Deprecato:** Use :ref:`XRHandTracker.get_hand_joint_flags()` obtained from :ref:`XRServer.get_tracker()` instead. Se il tracciamento delle mani è abilitato, restituisce dei flag che ci informano della validità dei dati di tracciamento. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_hand_joint_linear_velocity: .. rst-class:: classref-method :ref:`Vector3` **get_hand_joint_linear_velocity**\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| :ref:`🔗` **Deprecato:** Use :ref:`XRHandTracker.get_hand_joint_linear_velocity()` obtained from :ref:`XRServer.get_tracker()` instead. Se il tracciamento della mano è abilitato, restituisce la velocità lineare di un'articolazione (``joint``) di una mano (``hand``) come fornita da OpenXR. Questa è relativa a :ref:`XROrigin3D` senza scala del mondo applicata! .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_hand_joint_position: .. rst-class:: classref-method :ref:`Vector3` **get_hand_joint_position**\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| :ref:`🔗` **Deprecato:** Use :ref:`XRHandTracker.get_hand_joint_transform()` obtained from :ref:`XRServer.get_tracker()` instead. Se il tracciamento della mano è abilitato, restituisce la posizione di un'articolazione (``joint``) di una mano (``hand``) come fornita da OpenXR. Questa è relativa a :ref:`XROrigin3D` senza scala del mondo applicata! .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_hand_joint_radius: .. rst-class:: classref-method :ref:`float` **get_hand_joint_radius**\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| :ref:`🔗` **Deprecato:** Use :ref:`XRHandTracker.get_hand_joint_radius()` obtained from :ref:`XRServer.get_tracker()` instead. Se il tracciamento della mano è abilitato, restituisce il raggio di un'articolazione (``joint``) di una mano (``hand``) come fornito da OpenXR. Questo è senza scala del mondo applicata! .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_hand_joint_rotation: .. rst-class:: classref-method :ref:`Quaternion` **get_hand_joint_rotation**\ (\ hand\: :ref:`Hand`, joint\: :ref:`HandJoints`\ ) |const| :ref:`🔗` **Deprecato:** Use :ref:`XRHandTracker.get_hand_joint_transform()` obtained from :ref:`XRServer.get_tracker()` instead. Se il tracciamento della mano è abilitato, restituisce la rotazione di un'articolazione (``joint``) di una mano (``hand``) come fornita da OpenXR. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_hand_tracking_source: .. rst-class:: classref-method :ref:`HandTrackedSource` **get_hand_tracking_source**\ (\ hand\: :ref:`Hand`\ ) |const| :ref:`🔗` **Deprecato:** Use :ref:`XRHandTracker.hand_tracking_source` obtained from :ref:`XRServer.get_tracker()` instead. Se il tracciamento della mano è abilitato e la sorgente del tracciamento della mano è supportata, ottiene la sorgente dei dati di tracciamento per la mano ``hand``. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_motion_range: .. rst-class:: classref-method :ref:`HandMotionRange` **get_motion_range**\ (\ hand\: :ref:`Hand`\ ) |const| :ref:`🔗` Se il tracciamento manuale è abilitato e l'intervallo di movimento è supportato, ottiene l'intervallo di movimento attualmente configurato per la mano ``hand``. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_get_session_state: .. rst-class:: classref-method :ref:`SessionState` **get_session_state**\ (\ ) :ref:`🔗` Restituisce lo stato attuale della nostra sessione OpenXR. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_is_action_set_active: .. rst-class:: classref-method :ref:`bool` **is_action_set_active**\ (\ name\: :ref:`String`\ ) |const| :ref:`🔗` Restituisce ``true`` se l'insieme di azioni specificato è attivo. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_is_eye_gaze_interaction_supported: .. rst-class:: classref-method :ref:`bool` **is_eye_gaze_interaction_supported**\ (\ ) :ref:`🔗` Restituisce le capacità dell'estensione di interazione dello sguardo. \ **Nota:** Questo restituisce un valore valido solo dopo che OpenXR è stato inizializzato. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_is_foveation_supported: .. rst-class:: classref-method :ref:`bool` **is_foveation_supported**\ (\ ) |const| :ref:`🔗` Returns ``true`` if OpenXR's foveation extension is supported. The interface must be initialized before this returns a valid value. \ **Note:** When using the Vulkan rendering driver, :ref:`Viewport.vrs_mode` must be set to :ref:`Viewport.VRS_XR` to support foveation. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_is_hand_interaction_supported: .. rst-class:: classref-method :ref:`bool` **is_hand_interaction_supported**\ (\ ) |const| :ref:`🔗` Restituisce ``true`` se il profilo di interazione manuale di OpenXR è supportato e abilitato. \ **Nota:** Questo restituisce un valore valido solo dopo l'avvio della sessione OpenXR. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_is_hand_tracking_supported: .. rst-class:: classref-method :ref:`bool` **is_hand_tracking_supported**\ (\ ) :ref:`🔗` Restituisce ``true`` se il monitoraggio della mano di OpenXR è supportato e abilitato. \ **Nota:** Questo restituisce un valore valido solo dopo l'avvio della sessione OpenXR. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_set_action_set_active: .. rst-class:: classref-method |void| **set_action_set_active**\ (\ name\: :ref:`String`, active\: :ref:`bool`\ ) :ref:`🔗` Imposta l'insieme di azioni come attivo o inattivo. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_set_cpu_level: .. rst-class:: classref-method |void| **set_cpu_level**\ (\ level\: :ref:`PerfSettingsLevel`\ ) :ref:`🔗` Imposta il livello di prestazioni della CPU del dispositivo OpenXR. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_set_gpu_level: .. rst-class:: classref-method |void| **set_gpu_level**\ (\ level\: :ref:`PerfSettingsLevel`\ ) :ref:`🔗` Imposta il livello di prestazioni della GPU del dispositivo OpenXR. .. rst-class:: classref-item-separator ---- .. _class_OpenXRInterface_method_set_motion_range: .. rst-class:: classref-method |void| **set_motion_range**\ (\ hand\: :ref:`Hand`, motion_range\: :ref:`HandMotionRange`\ ) :ref:`🔗` Se il tracciamento della mano è abilitato e l'intervallo di movimento è supportato, imposta l'intervallo di movimento attualmente configurato per la mano ``hand`` su ``motion_range``. .. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)` .. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)` .. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)` .. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)` .. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)` .. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)` .. |void| replace:: :abbr:`void (Nessun valore restituito.)`