class_xrinterfaceextension.rst 52 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/XRInterfaceExtension.xml.
  6. .. _class_XRInterfaceExtension:
  7. XRInterfaceExtension
  8. ====================
  9. **Inherits:** :ref:`XRInterface<class_XRInterface>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
  10. Base class for XR interface extensions (plugins).
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. External XR interface plugins should inherit from this class.
  15. .. rst-class:: classref-introduction-group
  16. Tutorials
  17. ---------
  18. - :doc:`XR documentation index <../tutorials/xr/index>`
  19. .. rst-class:: classref-reftable-group
  20. Methods
  21. -------
  22. .. table::
  23. :widths: auto
  24. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  25. | void | :ref:`_end_frame<class_XRInterfaceExtension_private_method__end_frame>` **(** **)** |virtual| |
  26. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  27. | :ref:`bool<class_bool>` | :ref:`_get_anchor_detection_is_enabled<class_XRInterfaceExtension_private_method__get_anchor_detection_is_enabled>` **(** **)** |virtual| |const| |
  28. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  29. | :ref:`int<class_int>` | :ref:`_get_camera_feed_id<class_XRInterfaceExtension_private_method__get_camera_feed_id>` **(** **)** |virtual| |const| |
  30. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  31. | :ref:`Transform3D<class_Transform3D>` | :ref:`_get_camera_transform<class_XRInterfaceExtension_private_method__get_camera_transform>` **(** **)** |virtual| |
  32. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  33. | :ref:`int<class_int>` | :ref:`_get_capabilities<class_XRInterfaceExtension_private_method__get_capabilities>` **(** **)** |virtual| |const| |
  34. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  35. | :ref:`RID<class_RID>` | :ref:`_get_color_texture<class_XRInterfaceExtension_private_method__get_color_texture>` **(** **)** |virtual| |
  36. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  37. | :ref:`RID<class_RID>` | :ref:`_get_depth_texture<class_XRInterfaceExtension_private_method__get_depth_texture>` **(** **)** |virtual| |
  38. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  39. | :ref:`StringName<class_StringName>` | :ref:`_get_name<class_XRInterfaceExtension_private_method__get_name>` **(** **)** |virtual| |const| |
  40. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  41. | :ref:`PackedVector3Array<class_PackedVector3Array>` | :ref:`_get_play_area<class_XRInterfaceExtension_private_method__get_play_area>` **(** **)** |virtual| |const| |
  42. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  43. | :ref:`PlayAreaMode<enum_XRInterface_PlayAreaMode>` | :ref:`_get_play_area_mode<class_XRInterfaceExtension_private_method__get_play_area_mode>` **(** **)** |virtual| |const| |
  44. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  45. | :ref:`PackedFloat64Array<class_PackedFloat64Array>` | :ref:`_get_projection_for_view<class_XRInterfaceExtension_private_method__get_projection_for_view>` **(** :ref:`int<class_int>` view, :ref:`float<class_float>` aspect, :ref:`float<class_float>` z_near, :ref:`float<class_float>` z_far **)** |virtual| |
  46. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  47. | :ref:`Vector2<class_Vector2>` | :ref:`_get_render_target_size<class_XRInterfaceExtension_private_method__get_render_target_size>` **(** **)** |virtual| |
  48. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  49. | :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`_get_suggested_pose_names<class_XRInterfaceExtension_private_method__get_suggested_pose_names>` **(** :ref:`StringName<class_StringName>` tracker_name **)** |virtual| |const| |
  50. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  51. | :ref:`PackedStringArray<class_PackedStringArray>` | :ref:`_get_suggested_tracker_names<class_XRInterfaceExtension_private_method__get_suggested_tracker_names>` **(** **)** |virtual| |const| |
  52. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  53. | :ref:`Dictionary<class_Dictionary>` | :ref:`_get_system_info<class_XRInterfaceExtension_private_method__get_system_info>` **(** **)** |virtual| |const| |
  54. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  55. | :ref:`TrackingStatus<enum_XRInterface_TrackingStatus>` | :ref:`_get_tracking_status<class_XRInterfaceExtension_private_method__get_tracking_status>` **(** **)** |virtual| |const| |
  56. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  57. | :ref:`Transform3D<class_Transform3D>` | :ref:`_get_transform_for_view<class_XRInterfaceExtension_private_method__get_transform_for_view>` **(** :ref:`int<class_int>` view, :ref:`Transform3D<class_Transform3D>` cam_transform **)** |virtual| |
  58. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  59. | :ref:`RID<class_RID>` | :ref:`_get_velocity_texture<class_XRInterfaceExtension_private_method__get_velocity_texture>` **(** **)** |virtual| |
  60. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  61. | :ref:`int<class_int>` | :ref:`_get_view_count<class_XRInterfaceExtension_private_method__get_view_count>` **(** **)** |virtual| |
  62. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  63. | :ref:`RID<class_RID>` | :ref:`_get_vrs_texture<class_XRInterfaceExtension_private_method__get_vrs_texture>` **(** **)** |virtual| |
  64. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  65. | :ref:`bool<class_bool>` | :ref:`_initialize<class_XRInterfaceExtension_private_method__initialize>` **(** **)** |virtual| |
  66. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  67. | :ref:`bool<class_bool>` | :ref:`_is_initialized<class_XRInterfaceExtension_private_method__is_initialized>` **(** **)** |virtual| |const| |
  68. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  69. | void | :ref:`_post_draw_viewport<class_XRInterfaceExtension_private_method__post_draw_viewport>` **(** :ref:`RID<class_RID>` render_target, :ref:`Rect2<class_Rect2>` screen_rect **)** |virtual| |
  70. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  71. | :ref:`bool<class_bool>` | :ref:`_pre_draw_viewport<class_XRInterfaceExtension_private_method__pre_draw_viewport>` **(** :ref:`RID<class_RID>` render_target **)** |virtual| |
  72. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  73. | void | :ref:`_pre_render<class_XRInterfaceExtension_private_method__pre_render>` **(** **)** |virtual| |
  74. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  75. | void | :ref:`_process<class_XRInterfaceExtension_private_method__process>` **(** **)** |virtual| |
  76. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  77. | void | :ref:`_set_anchor_detection_is_enabled<class_XRInterfaceExtension_private_method__set_anchor_detection_is_enabled>` **(** :ref:`bool<class_bool>` enabled **)** |virtual| |
  78. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  79. | :ref:`bool<class_bool>` | :ref:`_set_play_area_mode<class_XRInterfaceExtension_private_method__set_play_area_mode>` **(** :ref:`PlayAreaMode<enum_XRInterface_PlayAreaMode>` mode **)** |virtual| |const| |
  80. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  81. | :ref:`bool<class_bool>` | :ref:`_supports_play_area_mode<class_XRInterfaceExtension_private_method__supports_play_area_mode>` **(** :ref:`PlayAreaMode<enum_XRInterface_PlayAreaMode>` mode **)** |virtual| |const| |
  82. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  83. | void | :ref:`_trigger_haptic_pulse<class_XRInterfaceExtension_private_method__trigger_haptic_pulse>` **(** :ref:`String<class_String>` action_name, :ref:`StringName<class_StringName>` tracker_name, :ref:`float<class_float>` frequency, :ref:`float<class_float>` amplitude, :ref:`float<class_float>` duration_sec, :ref:`float<class_float>` delay_sec **)** |virtual| |
  84. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  85. | void | :ref:`_uninitialize<class_XRInterfaceExtension_private_method__uninitialize>` **(** **)** |virtual| |
  86. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  87. | void | :ref:`add_blit<class_XRInterfaceExtension_method_add_blit>` **(** :ref:`RID<class_RID>` render_target, :ref:`Rect2<class_Rect2>` src_rect, :ref:`Rect2i<class_Rect2i>` dst_rect, :ref:`bool<class_bool>` use_layer, :ref:`int<class_int>` layer, :ref:`bool<class_bool>` apply_lens_distortion, :ref:`Vector2<class_Vector2>` eye_center, :ref:`float<class_float>` k1, :ref:`float<class_float>` k2, :ref:`float<class_float>` upscale, :ref:`float<class_float>` aspect_ratio **)** |
  88. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  89. | :ref:`RID<class_RID>` | :ref:`get_color_texture<class_XRInterfaceExtension_method_get_color_texture>` **(** **)** |
  90. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  91. | :ref:`RID<class_RID>` | :ref:`get_depth_texture<class_XRInterfaceExtension_method_get_depth_texture>` **(** **)** |
  92. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  93. | :ref:`RID<class_RID>` | :ref:`get_render_target_texture<class_XRInterfaceExtension_method_get_render_target_texture>` **(** :ref:`RID<class_RID>` render_target **)** |
  94. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  95. | :ref:`RID<class_RID>` | :ref:`get_velocity_texture<class_XRInterfaceExtension_method_get_velocity_texture>` **(** **)** |
  96. +--------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  97. .. rst-class:: classref-section-separator
  98. ----
  99. .. rst-class:: classref-descriptions-group
  100. Method Descriptions
  101. -------------------
  102. .. _class_XRInterfaceExtension_private_method__end_frame:
  103. .. rst-class:: classref-method
  104. void **_end_frame** **(** **)** |virtual|
  105. Called if interface is active and queues have been submitted.
  106. .. rst-class:: classref-item-separator
  107. ----
  108. .. _class_XRInterfaceExtension_private_method__get_anchor_detection_is_enabled:
  109. .. rst-class:: classref-method
  110. :ref:`bool<class_bool>` **_get_anchor_detection_is_enabled** **(** **)** |virtual| |const|
  111. Return ``true`` if anchor detection is enabled for this interface.
  112. .. rst-class:: classref-item-separator
  113. ----
  114. .. _class_XRInterfaceExtension_private_method__get_camera_feed_id:
  115. .. rst-class:: classref-method
  116. :ref:`int<class_int>` **_get_camera_feed_id** **(** **)** |virtual| |const|
  117. Returns the camera feed ID for the :ref:`CameraFeed<class_CameraFeed>` registered with the :ref:`CameraServer<class_CameraServer>` that should be presented as the background on an AR capable device (if applicable).
  118. .. rst-class:: classref-item-separator
  119. ----
  120. .. _class_XRInterfaceExtension_private_method__get_camera_transform:
  121. .. rst-class:: classref-method
  122. :ref:`Transform3D<class_Transform3D>` **_get_camera_transform** **(** **)** |virtual|
  123. Returns the :ref:`Transform3D<class_Transform3D>` that positions the :ref:`XRCamera3D<class_XRCamera3D>` in the world.
  124. .. rst-class:: classref-item-separator
  125. ----
  126. .. _class_XRInterfaceExtension_private_method__get_capabilities:
  127. .. rst-class:: classref-method
  128. :ref:`int<class_int>` **_get_capabilities** **(** **)** |virtual| |const|
  129. Returns the capabilities of this interface.
  130. .. rst-class:: classref-item-separator
  131. ----
  132. .. _class_XRInterfaceExtension_private_method__get_color_texture:
  133. .. rst-class:: classref-method
  134. :ref:`RID<class_RID>` **_get_color_texture** **(** **)** |virtual|
  135. Return color texture into which to render (if applicable).
  136. .. rst-class:: classref-item-separator
  137. ----
  138. .. _class_XRInterfaceExtension_private_method__get_depth_texture:
  139. .. rst-class:: classref-method
  140. :ref:`RID<class_RID>` **_get_depth_texture** **(** **)** |virtual|
  141. Return depth texture into which to render (if applicable).
  142. .. rst-class:: classref-item-separator
  143. ----
  144. .. _class_XRInterfaceExtension_private_method__get_name:
  145. .. rst-class:: classref-method
  146. :ref:`StringName<class_StringName>` **_get_name** **(** **)** |virtual| |const|
  147. Returns the name of this interface.
  148. .. rst-class:: classref-item-separator
  149. ----
  150. .. _class_XRInterfaceExtension_private_method__get_play_area:
  151. .. rst-class:: classref-method
  152. :ref:`PackedVector3Array<class_PackedVector3Array>` **_get_play_area** **(** **)** |virtual| |const|
  153. Returns an :ref:`PackedVector3Array<class_PackedVector3Array>` that denotes the play areas boundaries (if applicable).
  154. .. rst-class:: classref-item-separator
  155. ----
  156. .. _class_XRInterfaceExtension_private_method__get_play_area_mode:
  157. .. rst-class:: classref-method
  158. :ref:`PlayAreaMode<enum_XRInterface_PlayAreaMode>` **_get_play_area_mode** **(** **)** |virtual| |const|
  159. Returns the :ref:`PlayAreaMode<enum_XRInterface_PlayAreaMode>` that sets up our play area.
  160. .. rst-class:: classref-item-separator
  161. ----
  162. .. _class_XRInterfaceExtension_private_method__get_projection_for_view:
  163. .. rst-class:: classref-method
  164. :ref:`PackedFloat64Array<class_PackedFloat64Array>` **_get_projection_for_view** **(** :ref:`int<class_int>` view, :ref:`float<class_float>` aspect, :ref:`float<class_float>` z_near, :ref:`float<class_float>` z_far **)** |virtual|
  165. Returns the projection matrix for the given view as a :ref:`PackedFloat64Array<class_PackedFloat64Array>`.
  166. .. rst-class:: classref-item-separator
  167. ----
  168. .. _class_XRInterfaceExtension_private_method__get_render_target_size:
  169. .. rst-class:: classref-method
  170. :ref:`Vector2<class_Vector2>` **_get_render_target_size** **(** **)** |virtual|
  171. Returns the size of our render target for this interface, this overrides the size of the :ref:`Viewport<class_Viewport>` marked as the xr viewport.
  172. .. rst-class:: classref-item-separator
  173. ----
  174. .. _class_XRInterfaceExtension_private_method__get_suggested_pose_names:
  175. .. rst-class:: classref-method
  176. :ref:`PackedStringArray<class_PackedStringArray>` **_get_suggested_pose_names** **(** :ref:`StringName<class_StringName>` tracker_name **)** |virtual| |const|
  177. Returns a :ref:`PackedStringArray<class_PackedStringArray>` with pose names configured by this interface. Note that user configuration can override this list.
  178. .. rst-class:: classref-item-separator
  179. ----
  180. .. _class_XRInterfaceExtension_private_method__get_suggested_tracker_names:
  181. .. rst-class:: classref-method
  182. :ref:`PackedStringArray<class_PackedStringArray>` **_get_suggested_tracker_names** **(** **)** |virtual| |const|
  183. Returns a :ref:`PackedStringArray<class_PackedStringArray>` with tracker names configured by this interface. Note that user configuration can override this list.
  184. .. rst-class:: classref-item-separator
  185. ----
  186. .. _class_XRInterfaceExtension_private_method__get_system_info:
  187. .. rst-class:: classref-method
  188. :ref:`Dictionary<class_Dictionary>` **_get_system_info** **(** **)** |virtual| |const|
  189. Returns a :ref:`Dictionary<class_Dictionary>` with system information related to this interface.
  190. .. rst-class:: classref-item-separator
  191. ----
  192. .. _class_XRInterfaceExtension_private_method__get_tracking_status:
  193. .. rst-class:: classref-method
  194. :ref:`TrackingStatus<enum_XRInterface_TrackingStatus>` **_get_tracking_status** **(** **)** |virtual| |const|
  195. Returns a :ref:`TrackingStatus<enum_XRInterface_TrackingStatus>` specifying the current status of our tracking.
  196. .. rst-class:: classref-item-separator
  197. ----
  198. .. _class_XRInterfaceExtension_private_method__get_transform_for_view:
  199. .. rst-class:: classref-method
  200. :ref:`Transform3D<class_Transform3D>` **_get_transform_for_view** **(** :ref:`int<class_int>` view, :ref:`Transform3D<class_Transform3D>` cam_transform **)** |virtual|
  201. Returns a :ref:`Transform3D<class_Transform3D>` for a given view.
  202. .. rst-class:: classref-item-separator
  203. ----
  204. .. _class_XRInterfaceExtension_private_method__get_velocity_texture:
  205. .. rst-class:: classref-method
  206. :ref:`RID<class_RID>` **_get_velocity_texture** **(** **)** |virtual|
  207. Return velocity texture into which to render (if applicable).
  208. .. rst-class:: classref-item-separator
  209. ----
  210. .. _class_XRInterfaceExtension_private_method__get_view_count:
  211. .. rst-class:: classref-method
  212. :ref:`int<class_int>` **_get_view_count** **(** **)** |virtual|
  213. Returns the number of views this interface requires, 1 for mono, 2 for stereoscopic.
  214. .. rst-class:: classref-item-separator
  215. ----
  216. .. _class_XRInterfaceExtension_private_method__get_vrs_texture:
  217. .. rst-class:: classref-method
  218. :ref:`RID<class_RID>` **_get_vrs_texture** **(** **)** |virtual|
  219. .. container:: contribute
  220. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  221. .. rst-class:: classref-item-separator
  222. ----
  223. .. _class_XRInterfaceExtension_private_method__initialize:
  224. .. rst-class:: classref-method
  225. :ref:`bool<class_bool>` **_initialize** **(** **)** |virtual|
  226. Initializes the interface, returns ``true`` on success.
  227. .. rst-class:: classref-item-separator
  228. ----
  229. .. _class_XRInterfaceExtension_private_method__is_initialized:
  230. .. rst-class:: classref-method
  231. :ref:`bool<class_bool>` **_is_initialized** **(** **)** |virtual| |const|
  232. Returns ``true`` if this interface has been initialized.
  233. .. rst-class:: classref-item-separator
  234. ----
  235. .. _class_XRInterfaceExtension_private_method__post_draw_viewport:
  236. .. rst-class:: classref-method
  237. void **_post_draw_viewport** **(** :ref:`RID<class_RID>` render_target, :ref:`Rect2<class_Rect2>` screen_rect **)** |virtual|
  238. Called after the XR :ref:`Viewport<class_Viewport>` draw logic has completed.
  239. .. rst-class:: classref-item-separator
  240. ----
  241. .. _class_XRInterfaceExtension_private_method__pre_draw_viewport:
  242. .. rst-class:: classref-method
  243. :ref:`bool<class_bool>` **_pre_draw_viewport** **(** :ref:`RID<class_RID>` render_target **)** |virtual|
  244. Called if this is our primary **XRInterfaceExtension** before we start processing a :ref:`Viewport<class_Viewport>` for every active XR :ref:`Viewport<class_Viewport>`, returns ``true`` if that viewport should be rendered. An XR interface may return ``false`` if the user has taken off their headset and we can pause rendering.
  245. .. rst-class:: classref-item-separator
  246. ----
  247. .. _class_XRInterfaceExtension_private_method__pre_render:
  248. .. rst-class:: classref-method
  249. void **_pre_render** **(** **)** |virtual|
  250. Called if this **XRInterfaceExtension** is active before rendering starts. Most XR interfaces will sync tracking at this point in time.
  251. .. rst-class:: classref-item-separator
  252. ----
  253. .. _class_XRInterfaceExtension_private_method__process:
  254. .. rst-class:: classref-method
  255. void **_process** **(** **)** |virtual|
  256. Called if this **XRInterfaceExtension** is active before our physics and game process is called. Most XR interfaces will update its :ref:`XRPositionalTracker<class_XRPositionalTracker>`\ s at this point in time.
  257. .. rst-class:: classref-item-separator
  258. ----
  259. .. _class_XRInterfaceExtension_private_method__set_anchor_detection_is_enabled:
  260. .. rst-class:: classref-method
  261. void **_set_anchor_detection_is_enabled** **(** :ref:`bool<class_bool>` enabled **)** |virtual|
  262. Enables anchor detection on this interface if supported.
  263. .. rst-class:: classref-item-separator
  264. ----
  265. .. _class_XRInterfaceExtension_private_method__set_play_area_mode:
  266. .. rst-class:: classref-method
  267. :ref:`bool<class_bool>` **_set_play_area_mode** **(** :ref:`PlayAreaMode<enum_XRInterface_PlayAreaMode>` mode **)** |virtual| |const|
  268. Set the play area mode for this interface.
  269. .. rst-class:: classref-item-separator
  270. ----
  271. .. _class_XRInterfaceExtension_private_method__supports_play_area_mode:
  272. .. rst-class:: classref-method
  273. :ref:`bool<class_bool>` **_supports_play_area_mode** **(** :ref:`PlayAreaMode<enum_XRInterface_PlayAreaMode>` mode **)** |virtual| |const|
  274. Returns ``true`` if this interface supports this play area mode.
  275. .. rst-class:: classref-item-separator
  276. ----
  277. .. _class_XRInterfaceExtension_private_method__trigger_haptic_pulse:
  278. .. rst-class:: classref-method
  279. void **_trigger_haptic_pulse** **(** :ref:`String<class_String>` action_name, :ref:`StringName<class_StringName>` tracker_name, :ref:`float<class_float>` frequency, :ref:`float<class_float>` amplitude, :ref:`float<class_float>` duration_sec, :ref:`float<class_float>` delay_sec **)** |virtual|
  280. Triggers a haptic pulse to be emitted on the specified tracker.
  281. .. rst-class:: classref-item-separator
  282. ----
  283. .. _class_XRInterfaceExtension_private_method__uninitialize:
  284. .. rst-class:: classref-method
  285. void **_uninitialize** **(** **)** |virtual|
  286. Uninitialize the interface.
  287. .. rst-class:: classref-item-separator
  288. ----
  289. .. _class_XRInterfaceExtension_method_add_blit:
  290. .. rst-class:: classref-method
  291. void **add_blit** **(** :ref:`RID<class_RID>` render_target, :ref:`Rect2<class_Rect2>` src_rect, :ref:`Rect2i<class_Rect2i>` dst_rect, :ref:`bool<class_bool>` use_layer, :ref:`int<class_int>` layer, :ref:`bool<class_bool>` apply_lens_distortion, :ref:`Vector2<class_Vector2>` eye_center, :ref:`float<class_float>` k1, :ref:`float<class_float>` k2, :ref:`float<class_float>` upscale, :ref:`float<class_float>` aspect_ratio **)**
  292. Blits our render results to screen optionally applying lens distortion. This can only be called while processing ``_commit_views``.
  293. .. rst-class:: classref-item-separator
  294. ----
  295. .. _class_XRInterfaceExtension_method_get_color_texture:
  296. .. rst-class:: classref-method
  297. :ref:`RID<class_RID>` **get_color_texture** **(** **)**
  298. .. container:: contribute
  299. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  300. .. rst-class:: classref-item-separator
  301. ----
  302. .. _class_XRInterfaceExtension_method_get_depth_texture:
  303. .. rst-class:: classref-method
  304. :ref:`RID<class_RID>` **get_depth_texture** **(** **)**
  305. .. container:: contribute
  306. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  307. .. rst-class:: classref-item-separator
  308. ----
  309. .. _class_XRInterfaceExtension_method_get_render_target_texture:
  310. .. rst-class:: classref-method
  311. :ref:`RID<class_RID>` **get_render_target_texture** **(** :ref:`RID<class_RID>` render_target **)**
  312. Returns a valid :ref:`RID<class_RID>` for a texture to which we should render the current frame if supported by the interface.
  313. .. rst-class:: classref-item-separator
  314. ----
  315. .. _class_XRInterfaceExtension_method_get_velocity_texture:
  316. .. rst-class:: classref-method
  317. :ref:`RID<class_RID>` **get_velocity_texture** **(** **)**
  318. .. container:: contribute
  319. There is currently no description for this method. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  320. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  321. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  322. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  323. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  324. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  325. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  326. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`