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.

XRInterfaceExtension

Eredita: XRInterface < RefCounted < Object

Classe di base per le estensioni dell'interfaccia XR (plugin).

Descrizione

Le estensioni esterne dell'interfaccia XR dovrebbero ereditare da questa classe.

Tutorial

Metodi

void

_end_frame() virtual

bool

_get_anchor_detection_is_enabled() virtual const

int

_get_camera_feed_id() virtual const

Transform3D

_get_camera_transform() virtual

int

_get_capabilities() virtual const

RID

_get_color_texture() virtual

RID

_get_depth_texture() virtual

StringName

_get_name() virtual const

PackedVector3Array

_get_play_area() virtual const

PlayAreaMode

_get_play_area_mode() virtual const

PackedFloat64Array

_get_projection_for_view(view: int, aspect: float, z_near: float, z_far: float) virtual

Vector2

_get_render_target_size() virtual

PackedStringArray

_get_suggested_pose_names(tracker_name: StringName) virtual const

PackedStringArray

_get_suggested_tracker_names() virtual const

Dictionary

_get_system_info() virtual const

TrackingStatus

_get_tracking_status() virtual const

Transform3D

_get_transform_for_view(view: int, cam_transform: Transform3D) virtual

RID

_get_velocity_texture() virtual

int

_get_view_count() virtual

RID

_get_vrs_texture() virtual

VRSTextureFormat

_get_vrs_texture_format() virtual

bool

_initialize() virtual

bool

_is_initialized() virtual const

void

_post_draw_viewport(render_target: RID, screen_rect: Rect2) virtual

bool

_pre_draw_viewport(render_target: RID) virtual

void

_pre_render() virtual

void

_process() virtual

void

_set_anchor_detection_is_enabled(enabled: bool) virtual

bool

_set_play_area_mode(mode: PlayAreaMode) virtual const

bool

_supports_play_area_mode(mode: PlayAreaMode) virtual const

void

_trigger_haptic_pulse(action_name: String, tracker_name: StringName, frequency: float, amplitude: float, duration_sec: float, delay_sec: float) virtual

void

_uninitialize() virtual

void

add_blit(render_target: RID, src_rect: Rect2, dst_rect: Rect2i, use_layer: bool, layer: int, apply_lens_distortion: bool, eye_center: Vector2, k1: float, k2: float, upscale: float, aspect_ratio: float)

RID

get_color_texture()

RID

get_depth_texture()

RID

get_render_target_texture(render_target: RID)

RID

get_velocity_texture()


Descrizioni dei metodi

void _end_frame() virtual 🔗

Chiamato se l'interfaccia è attiva e sono state inviate le code.


bool _get_anchor_detection_is_enabled() virtual const 🔗

Restituisce true se il rilevamento dell'ancoraggio è abilitato per questa interfaccia.


int _get_camera_feed_id() virtual const 🔗

Restituisce l'ID del feed della telecamera per il CameraFeed registrato con il CameraServer che dovrebbe essere presentato come sfondo su un dispositivo compatibile con AR (se applicabile).


Transform3D _get_camera_transform() virtual 🔗

Restituisce il Transform3D che posiziona la XRCamera3D nel mondo.


int _get_capabilities() virtual const 🔗

Restituisce le capacità di questa interfaccia.


RID _get_color_texture() virtual 🔗

Restituisce la texture del colore in cui effettuare il rendering (se applicabile).


RID _get_depth_texture() virtual 🔗

Restituisce la texture di profondità in cui effettuare il rendering (se applicabile).


StringName _get_name() virtual const 🔗

Restituisce il nome di questa interfaccia.


PackedVector3Array _get_play_area() virtual const 🔗

Restituisce un PackedVector3Array che rappresenta i limiti delle aree di gioco (se applicabile).


PlayAreaMode _get_play_area_mode() virtual const 🔗

Restituisce la modalità dell'area di gioco che imposta la nostra area di gioco.


PackedFloat64Array _get_projection_for_view(view: int, aspect: float, z_near: float, z_far: float) virtual 🔗

Restituisce la matrice di proiezione per la vista fornita sotto forma di un PackedFloat64Array.


Vector2 _get_render_target_size() virtual 🔗

Restituisce le dimensioni delle nostre destinazioni di rendering per questa interfaccia, ciò sovrascrive le dimensioni della Viewport contrassegnata come la viewport per XR.


PackedStringArray _get_suggested_pose_names(tracker_name: StringName) virtual const 🔗

Restituisce un PackedStringArray con i nomi di posa configurati da questa interfaccia. Si noti che la configurazione dell'utente può sovrascrivere questa lista.


PackedStringArray _get_suggested_tracker_names() virtual const 🔗

Restituisce un PackedStringArray con i nomi dei tracker configurati da questa interfaccia. Si noti che la configurazione dell'utente può sovrascrivere questa lista.


Dictionary _get_system_info() virtual const 🔗

Restituisce un Dictionary con informazioni di sistema relative a questa interfaccia.


TrackingStatus _get_tracking_status() virtual const 🔗

Returns the current status of our tracking.


Transform3D _get_transform_for_view(view: int, cam_transform: Transform3D) virtual 🔗

Restituisce un Transform3D per una vista fornita.


RID _get_velocity_texture() virtual 🔗

Restituisce la texture della velocità in cui renderizzare (se applicabile).


int _get_view_count() virtual 🔗

Restituisce il numero di viste che questa interfaccia richiede, 1 per mono, 2 per stereoscopico.


RID _get_vrs_texture() virtual 🔗

There is currently no description for this method. Please help us by contributing one!


VRSTextureFormat _get_vrs_texture_format() virtual 🔗

Restituisce il formato della texture restituita da _get_vrs_texture().


bool _initialize() virtual 🔗

Inizializza l'interfaccia, restituisce true al successo.


bool _is_initialized() virtual const 🔗

Restituisce true se questa interfaccia è stata inizializzata.


void _post_draw_viewport(render_target: RID, screen_rect: Rect2) virtual 🔗

Chiamato dopo che la logica di disegno del XR Viewport ha completato.


bool _pre_draw_viewport(render_target: RID) virtual 🔗

Chiamato se questa è la nostra XRInterfaceExtension primaria prima di iniziare a elaborare una Viewport per ogni Viewport XR attivo, restituisce true se quella viewport deve essere renderizzata. Un'interfaccia XR può restituire false se l'utente ha tolto il visore e possiamo mettere in pausa il rendering.


void _pre_render() virtual 🔗

Chiamato se questa XRInterfaceExtension è attiva prima dell'inizio del rendering. La maggior parte delle interfacce XR sincronizzerà il tracciamento in questo momento.


void _process() virtual 🔗

Chiamato se questa XRInterfaceExtension è attiva prima che il nostro processo di fisica e di gioco venga chiamato. La maggior parte delle interfacce XR aggiornerà i suoi XRPositionalTracker in questo momento.


void _set_anchor_detection_is_enabled(enabled: bool) virtual 🔗

Abilita il rilevamento dell'ancoraggio su questa interfaccia, se supportato.


bool _set_play_area_mode(mode: PlayAreaMode) virtual const 🔗

Imposta la modalità dell'area di gioco per questa interfaccia.


bool _supports_play_area_mode(mode: PlayAreaMode) virtual const 🔗

Restituisce true se questa interfaccia supporta questa modalità di area di gioco.


void _trigger_haptic_pulse(action_name: String, tracker_name: StringName, frequency: float, amplitude: float, duration_sec: float, delay_sec: float) virtual 🔗

Attiva l'emissione di un impulso tattile sul tracciatore specificato.


void _uninitialize() virtual 🔗

Deinizializza l'interfaccia.


void add_blit(render_target: RID, src_rect: Rect2, dst_rect: Rect2i, use_layer: bool, layer: int, apply_lens_distortion: bool, eye_center: Vector2, k1: float, k2: float, upscale: float, aspect_ratio: float) 🔗

Trasmette i risultati del rendering sullo schermo, applicando facoltativamente la distorsione dell'obiettivo. Può essere chiamato solo durante l'elaborazione di _commit_views.


RID get_color_texture() 🔗

There is currently no description for this method. Please help us by contributing one!


RID get_depth_texture() 🔗

There is currently no description for this method. Please help us by contributing one!


RID get_render_target_texture(render_target: RID) 🔗

Restituisce un RID valido per una texture su cui dovremmo renderizzare il frame attuale, se supportato dall'interfaccia.


RID get_velocity_texture() 🔗

There is currently no description for this method. Please help us by contributing one!