openxr_composition_layer.cpp 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778
  1. /**************************************************************************/
  2. /* openxr_composition_layer.cpp */
  3. /**************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /**************************************************************************/
  8. /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
  9. /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /**************************************************************************/
  30. #include "openxr_composition_layer.h"
  31. #include "../extensions/openxr_composition_layer_extension.h"
  32. #include "../openxr_api.h"
  33. #include "../openxr_interface.h"
  34. #include "scene/3d/mesh_instance_3d.h"
  35. #include "scene/3d/xr/xr_nodes.h"
  36. #include "scene/main/viewport.h"
  37. #include "platform/android/api/java_class_wrapper.h"
  38. Vector<OpenXRCompositionLayer *> OpenXRCompositionLayer::composition_layer_nodes;
  39. static const char *HOLE_PUNCH_SHADER_CODE =
  40. "shader_type spatial;\n"
  41. "render_mode blend_mix, depth_draw_opaque, cull_back, shadow_to_opacity, shadows_disabled;\n"
  42. "void fragment() {\n"
  43. "\tALBEDO = vec3(0.0, 0.0, 0.0);\n"
  44. "}\n";
  45. OpenXRCompositionLayer::OpenXRCompositionLayer() {
  46. openxr_api = OpenXRAPI::get_singleton();
  47. composition_layer_extension = OpenXRCompositionLayerExtension::get_singleton();
  48. if (openxr_api) {
  49. openxr_session_running = openxr_api->is_running();
  50. }
  51. Ref<OpenXRInterface> openxr_interface = XRServer::get_singleton()->find_interface("OpenXR");
  52. if (openxr_interface.is_valid()) {
  53. openxr_interface->connect("session_begun", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_begun));
  54. openxr_interface->connect("session_stopping", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_stopping));
  55. }
  56. XRServer::get_singleton()->connect("reference_frame_changed", callable_mp(this, &OpenXRCompositionLayer::update_transform));
  57. set_process_internal(true);
  58. set_notify_local_transform(true);
  59. if (Engine::get_singleton()->is_editor_hint()) {
  60. // In the editor, create the fallback right away.
  61. _create_fallback_node();
  62. }
  63. }
  64. OpenXRCompositionLayer::~OpenXRCompositionLayer() {
  65. Ref<OpenXRInterface> openxr_interface = XRServer::get_singleton()->find_interface("OpenXR");
  66. if (openxr_interface.is_valid()) {
  67. openxr_interface->disconnect("session_begun", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_begun));
  68. openxr_interface->disconnect("session_stopping", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_stopping));
  69. }
  70. composition_layer_nodes.erase(this);
  71. if (composition_layer_extension && composition_layer.is_valid()) {
  72. composition_layer_extension->composition_layer_free(composition_layer);
  73. }
  74. }
  75. void OpenXRCompositionLayer::_bind_methods() {
  76. ClassDB::bind_method(D_METHOD("set_layer_viewport", "viewport"), &OpenXRCompositionLayer::set_layer_viewport);
  77. ClassDB::bind_method(D_METHOD("get_layer_viewport"), &OpenXRCompositionLayer::get_layer_viewport);
  78. ClassDB::bind_method(D_METHOD("set_use_android_surface", "enable"), &OpenXRCompositionLayer::set_use_android_surface);
  79. ClassDB::bind_method(D_METHOD("get_use_android_surface"), &OpenXRCompositionLayer::get_use_android_surface);
  80. ClassDB::bind_method(D_METHOD("set_android_surface_size", "size"), &OpenXRCompositionLayer::set_android_surface_size);
  81. ClassDB::bind_method(D_METHOD("get_android_surface_size"), &OpenXRCompositionLayer::get_android_surface_size);
  82. ClassDB::bind_method(D_METHOD("set_enable_hole_punch", "enable"), &OpenXRCompositionLayer::set_enable_hole_punch);
  83. ClassDB::bind_method(D_METHOD("get_enable_hole_punch"), &OpenXRCompositionLayer::get_enable_hole_punch);
  84. ClassDB::bind_method(D_METHOD("set_sort_order", "order"), &OpenXRCompositionLayer::set_sort_order);
  85. ClassDB::bind_method(D_METHOD("get_sort_order"), &OpenXRCompositionLayer::get_sort_order);
  86. ClassDB::bind_method(D_METHOD("set_alpha_blend", "enabled"), &OpenXRCompositionLayer::set_alpha_blend);
  87. ClassDB::bind_method(D_METHOD("get_alpha_blend"), &OpenXRCompositionLayer::get_alpha_blend);
  88. ClassDB::bind_method(D_METHOD("get_android_surface"), &OpenXRCompositionLayer::get_android_surface);
  89. ClassDB::bind_method(D_METHOD("is_natively_supported"), &OpenXRCompositionLayer::is_natively_supported);
  90. ClassDB::bind_method(D_METHOD("is_protected_content"), &OpenXRCompositionLayer::is_protected_content);
  91. ClassDB::bind_method(D_METHOD("set_protected_content", "protected_content"), &OpenXRCompositionLayer::set_protected_content);
  92. ClassDB::bind_method(D_METHOD("set_min_filter", "mode"), &OpenXRCompositionLayer::set_min_filter);
  93. ClassDB::bind_method(D_METHOD("get_min_filter"), &OpenXRCompositionLayer::get_min_filter);
  94. ClassDB::bind_method(D_METHOD("set_mag_filter", "mode"), &OpenXRCompositionLayer::set_mag_filter);
  95. ClassDB::bind_method(D_METHOD("get_mag_filter"), &OpenXRCompositionLayer::get_mag_filter);
  96. ClassDB::bind_method(D_METHOD("set_mipmap_mode", "mode"), &OpenXRCompositionLayer::set_mipmap_mode);
  97. ClassDB::bind_method(D_METHOD("get_mipmap_mode"), &OpenXRCompositionLayer::get_mipmap_mode);
  98. ClassDB::bind_method(D_METHOD("set_horizontal_wrap", "mode"), &OpenXRCompositionLayer::set_horizontal_wrap);
  99. ClassDB::bind_method(D_METHOD("get_horizontal_wrap"), &OpenXRCompositionLayer::get_horizontal_wrap);
  100. ClassDB::bind_method(D_METHOD("set_vertical_wrap", "mode"), &OpenXRCompositionLayer::set_vertical_wrap);
  101. ClassDB::bind_method(D_METHOD("get_vertical_wrap"), &OpenXRCompositionLayer::get_vertical_wrap);
  102. ClassDB::bind_method(D_METHOD("set_red_swizzle", "mode"), &OpenXRCompositionLayer::set_red_swizzle);
  103. ClassDB::bind_method(D_METHOD("get_red_swizzle"), &OpenXRCompositionLayer::get_red_swizzle);
  104. ClassDB::bind_method(D_METHOD("set_green_swizzle", "mode"), &OpenXRCompositionLayer::set_green_swizzle);
  105. ClassDB::bind_method(D_METHOD("get_green_swizzle"), &OpenXRCompositionLayer::get_green_swizzle);
  106. ClassDB::bind_method(D_METHOD("set_blue_swizzle", "mode"), &OpenXRCompositionLayer::set_blue_swizzle);
  107. ClassDB::bind_method(D_METHOD("get_blue_swizzle"), &OpenXRCompositionLayer::get_blue_swizzle);
  108. ClassDB::bind_method(D_METHOD("set_alpha_swizzle", "mode"), &OpenXRCompositionLayer::set_alpha_swizzle);
  109. ClassDB::bind_method(D_METHOD("get_alpha_swizzle"), &OpenXRCompositionLayer::get_alpha_swizzle);
  110. ClassDB::bind_method(D_METHOD("set_max_anisotropy", "value"), &OpenXRCompositionLayer::set_max_anisotropy);
  111. ClassDB::bind_method(D_METHOD("get_max_anisotropy"), &OpenXRCompositionLayer::get_max_anisotropy);
  112. ClassDB::bind_method(D_METHOD("set_border_color", "color"), &OpenXRCompositionLayer::set_border_color);
  113. ClassDB::bind_method(D_METHOD("get_border_color"), &OpenXRCompositionLayer::get_border_color);
  114. ClassDB::bind_method(D_METHOD("intersects_ray", "origin", "direction"), &OpenXRCompositionLayer::intersects_ray);
  115. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "layer_viewport", PROPERTY_HINT_NODE_TYPE, "SubViewport"), "set_layer_viewport", "get_layer_viewport");
  116. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "use_android_surface", PROPERTY_HINT_NONE, ""), "set_use_android_surface", "get_use_android_surface");
  117. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "protected_content", PROPERTY_HINT_NONE, ""), "set_protected_content", "is_protected_content");
  118. ADD_PROPERTY(PropertyInfo(Variant::VECTOR2I, "android_surface_size", PROPERTY_HINT_NONE, ""), "set_android_surface_size", "get_android_surface_size");
  119. ADD_PROPERTY(PropertyInfo(Variant::INT, "sort_order", PROPERTY_HINT_NONE, ""), "set_sort_order", "get_sort_order");
  120. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "alpha_blend", PROPERTY_HINT_NONE, ""), "set_alpha_blend", "get_alpha_blend");
  121. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "enable_hole_punch", PROPERTY_HINT_NONE, ""), "set_enable_hole_punch", "get_enable_hole_punch");
  122. ADD_GROUP("Swapchain State", "swapchain_state_");
  123. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_min_filter", PROPERTY_HINT_ENUM, "Nearest,Linear,Cubic"), "set_min_filter", "get_min_filter");
  124. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_mag_filter", PROPERTY_HINT_ENUM, "Nearest,Linear,Cubic"), "set_mag_filter", "get_mag_filter");
  125. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_mipmap_mode", PROPERTY_HINT_ENUM, "Disabled,Nearest,Linear"), "set_mipmap_mode", "get_mipmap_mode");
  126. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_horizontal_wrap", PROPERTY_HINT_ENUM, "Clamp to Border,Clamp to Edge,Repeat,Mirrored Repeat,Mirror Clamp to Edge"), "set_horizontal_wrap", "get_horizontal_wrap");
  127. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_vertical_wrap", PROPERTY_HINT_ENUM, "Clamp to Border,Clamp to Edge,Repeat,Mirrored Repeat,Mirror Clamp to Edge"), "set_vertical_wrap", "get_vertical_wrap");
  128. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_red_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_red_swizzle", "get_red_swizzle");
  129. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_green_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_green_swizzle", "get_green_swizzle");
  130. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_blue_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_blue_swizzle", "get_blue_swizzle");
  131. ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_alpha_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_alpha_swizzle", "get_alpha_swizzle");
  132. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "swapchain_state_max_anisotropy", PROPERTY_HINT_RANGE, "1.0,16.0,0.001"), "set_max_anisotropy", "get_max_anisotropy");
  133. ADD_PROPERTY(PropertyInfo(Variant::COLOR, "swapchain_state_border_color"), "set_border_color", "get_border_color");
  134. ADD_GROUP("", "");
  135. BIND_ENUM_CONSTANT(FILTER_NEAREST);
  136. BIND_ENUM_CONSTANT(FILTER_LINEAR);
  137. BIND_ENUM_CONSTANT(FILTER_CUBIC);
  138. BIND_ENUM_CONSTANT(MIPMAP_MODE_DISABLED);
  139. BIND_ENUM_CONSTANT(MIPMAP_MODE_NEAREST);
  140. BIND_ENUM_CONSTANT(MIPMAP_MODE_LINEAR);
  141. BIND_ENUM_CONSTANT(WRAP_CLAMP_TO_BORDER);
  142. BIND_ENUM_CONSTANT(WRAP_CLAMP_TO_EDGE);
  143. BIND_ENUM_CONSTANT(WRAP_REPEAT);
  144. BIND_ENUM_CONSTANT(WRAP_MIRRORED_REPEAT);
  145. BIND_ENUM_CONSTANT(WRAP_MIRROR_CLAMP_TO_EDGE);
  146. BIND_ENUM_CONSTANT(SWIZZLE_RED);
  147. BIND_ENUM_CONSTANT(SWIZZLE_GREEN);
  148. BIND_ENUM_CONSTANT(SWIZZLE_BLUE);
  149. BIND_ENUM_CONSTANT(SWIZZLE_ALPHA);
  150. BIND_ENUM_CONSTANT(SWIZZLE_ZERO);
  151. BIND_ENUM_CONSTANT(SWIZZLE_ONE);
  152. }
  153. bool OpenXRCompositionLayer::_should_use_fallback_node() {
  154. if (Engine::get_singleton()->is_editor_hint() || openxr_api == nullptr) {
  155. return true;
  156. } else if (openxr_session_running) {
  157. return enable_hole_punch || (!is_natively_supported() && !use_android_surface);
  158. }
  159. return false;
  160. }
  161. void OpenXRCompositionLayer::_create_fallback_node() {
  162. ERR_FAIL_COND(fallback);
  163. fallback = memnew(MeshInstance3D);
  164. fallback->set_cast_shadows_setting(GeometryInstance3D::SHADOW_CASTING_SETTING_OFF);
  165. add_child(fallback, false, INTERNAL_MODE_FRONT);
  166. should_update_fallback_mesh = true;
  167. }
  168. void OpenXRCompositionLayer::_remove_fallback_node() {
  169. ERR_FAIL_COND(fallback != nullptr);
  170. remove_child(fallback);
  171. fallback->queue_free();
  172. fallback = nullptr;
  173. }
  174. void OpenXRCompositionLayer::_setup_composition_layer() {
  175. if (use_android_surface || layer_viewport) {
  176. if (composition_layer_extension) {
  177. composition_layer_extension->composition_layer_register(composition_layer);
  178. registered = true;
  179. // NOTE: We don't setup/clear when using Android surfaces, so we don't destroy the surface unexpectedly.
  180. if (layer_viewport) {
  181. // Set our properties on the layer provider, which will create all the necessary resources (ex swap chains).
  182. composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());
  183. }
  184. }
  185. }
  186. }
  187. void OpenXRCompositionLayer::_clear_composition_layer() {
  188. if (composition_layer_extension) {
  189. composition_layer_extension->composition_layer_unregister(composition_layer);
  190. registered = false;
  191. // NOTE: We don't setup/clear when using Android surfaces, so we don't destroy the surface unexpectedly.
  192. if (!use_android_surface) {
  193. // This will reset the viewport and free all the resources (ex swap chains) used by the layer.
  194. composition_layer_extension->composition_layer_set_viewport(composition_layer, RID(), Size2i());
  195. }
  196. }
  197. }
  198. void OpenXRCompositionLayer::_viewport_size_changed() {
  199. if (layer_viewport && openxr_session_running && composition_layer_extension && is_natively_supported() && is_visible() && is_inside_tree()) {
  200. composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());
  201. }
  202. }
  203. void OpenXRCompositionLayer::_on_openxr_session_begun() {
  204. openxr_session_running = true;
  205. if (_should_register()) {
  206. _setup_composition_layer();
  207. }
  208. if (!fallback && _should_use_fallback_node()) {
  209. _create_fallback_node();
  210. }
  211. }
  212. void OpenXRCompositionLayer::_on_openxr_session_stopping() {
  213. openxr_session_running = false;
  214. if (fallback && !_should_use_fallback_node()) {
  215. _remove_fallback_node();
  216. }
  217. _clear_composition_layer();
  218. }
  219. void OpenXRCompositionLayer::update_transform() {
  220. if (composition_layer_extension) {
  221. composition_layer_extension->composition_layer_set_transform(composition_layer, get_transform());
  222. }
  223. }
  224. void OpenXRCompositionLayer::update_fallback_mesh() {
  225. should_update_fallback_mesh = true;
  226. }
  227. bool OpenXRCompositionLayer::_should_register() {
  228. return !registered && openxr_session_running && is_inside_tree() && is_visible() && is_natively_supported();
  229. }
  230. bool OpenXRCompositionLayer::is_viewport_in_use(SubViewport *p_viewport) {
  231. ERR_FAIL_NULL_V(p_viewport, false);
  232. for (const OpenXRCompositionLayer *other_composition_layer : composition_layer_nodes) {
  233. if (other_composition_layer != this && other_composition_layer->is_inside_tree() && other_composition_layer->get_layer_viewport() == p_viewport) {
  234. return true;
  235. }
  236. }
  237. return false;
  238. }
  239. void OpenXRCompositionLayer::set_layer_viewport(SubViewport *p_viewport) {
  240. if (layer_viewport == p_viewport) {
  241. return;
  242. }
  243. if (p_viewport != nullptr) {
  244. ERR_FAIL_COND_EDMSG(is_viewport_in_use(p_viewport), RTR("Cannot use the same SubViewport with multiple OpenXR composition layers. Clear it from its current layer first."));
  245. }
  246. if (use_android_surface) {
  247. ERR_FAIL_COND_MSG(p_viewport != nullptr, RTR("Cannot set SubViewport on an OpenXR composition layer when using an Android surface."));
  248. }
  249. if (layer_viewport) {
  250. layer_viewport->disconnect("size_changed", callable_mp(this, &OpenXRCompositionLayer::_viewport_size_changed));
  251. }
  252. layer_viewport = p_viewport;
  253. if (_should_register()) {
  254. _setup_composition_layer();
  255. }
  256. if (layer_viewport) {
  257. layer_viewport->connect("size_changed", callable_mp(this, &OpenXRCompositionLayer::_viewport_size_changed));
  258. SubViewport::UpdateMode update_mode = layer_viewport->get_update_mode();
  259. if (update_mode == SubViewport::UPDATE_WHEN_VISIBLE || update_mode == SubViewport::UPDATE_WHEN_PARENT_VISIBLE) {
  260. WARN_PRINT_ONCE("OpenXR composition layers cannot use SubViewports with UPDATE_WHEN_VISIBLE or UPDATE_WHEN_PARENT_VISIBLE. Switching to UPDATE_ALWAYS.");
  261. layer_viewport->set_update_mode(SubViewport::UPDATE_ALWAYS);
  262. }
  263. }
  264. if (fallback) {
  265. _reset_fallback_material();
  266. } else if (openxr_session_running && composition_layer_extension && is_visible() && is_inside_tree()) {
  267. if (layer_viewport) {
  268. composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());
  269. } else {
  270. composition_layer_extension->composition_layer_set_viewport(composition_layer, RID(), Size2i());
  271. }
  272. }
  273. }
  274. void OpenXRCompositionLayer::set_use_android_surface(bool p_use_android_surface) {
  275. if (use_android_surface == p_use_android_surface) {
  276. return;
  277. }
  278. use_android_surface = p_use_android_surface;
  279. if (use_android_surface) {
  280. // It's possible that the layer provider is unregistered here (if previously invisible)
  281. set_layer_viewport(nullptr);
  282. if (composition_layer_extension) {
  283. composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, true, android_surface_size);
  284. }
  285. // ...and it may not be set up above because of viewport = null, android surface is false, so set it up again:
  286. if (_should_register()) {
  287. _setup_composition_layer();
  288. }
  289. } else {
  290. if (composition_layer_extension) {
  291. composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, false, Size2i());
  292. }
  293. }
  294. notify_property_list_changed();
  295. }
  296. bool OpenXRCompositionLayer::get_use_android_surface() const {
  297. return use_android_surface;
  298. }
  299. void OpenXRCompositionLayer::set_android_surface_size(Size2i p_size) {
  300. if (android_surface_size == p_size) {
  301. return;
  302. }
  303. android_surface_size = p_size;
  304. if (use_android_surface && composition_layer_extension) {
  305. composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, true, android_surface_size);
  306. }
  307. }
  308. Size2i OpenXRCompositionLayer::get_android_surface_size() const {
  309. return android_surface_size;
  310. }
  311. SubViewport *OpenXRCompositionLayer::get_layer_viewport() const {
  312. return layer_viewport;
  313. }
  314. void OpenXRCompositionLayer::set_enable_hole_punch(bool p_enable) {
  315. if (enable_hole_punch == p_enable) {
  316. return;
  317. }
  318. enable_hole_punch = p_enable;
  319. if (_should_use_fallback_node()) {
  320. if (fallback) {
  321. _reset_fallback_material();
  322. } else {
  323. _create_fallback_node();
  324. }
  325. } else if (fallback) {
  326. _remove_fallback_node();
  327. }
  328. update_configuration_warnings();
  329. }
  330. bool OpenXRCompositionLayer::get_enable_hole_punch() const {
  331. return enable_hole_punch;
  332. }
  333. void OpenXRCompositionLayer::set_sort_order(int p_order) {
  334. sort_order = p_order;
  335. if (composition_layer_extension) {
  336. composition_layer_extension->composition_layer_set_sort_order(composition_layer, p_order);
  337. }
  338. update_configuration_warnings();
  339. }
  340. int OpenXRCompositionLayer::get_sort_order() const {
  341. return sort_order;
  342. }
  343. void OpenXRCompositionLayer::set_alpha_blend(bool p_alpha_blend) {
  344. alpha_blend = p_alpha_blend;
  345. if (composition_layer_extension) {
  346. composition_layer_extension->composition_layer_set_alpha_blend(composition_layer, p_alpha_blend);
  347. }
  348. if (fallback) {
  349. _reset_fallback_material();
  350. }
  351. }
  352. bool OpenXRCompositionLayer::get_alpha_blend() const {
  353. return alpha_blend;
  354. }
  355. bool OpenXRCompositionLayer::is_natively_supported() const {
  356. if (composition_layer_extension && openxr_api) {
  357. return composition_layer_extension->is_available(_get_openxr_type());
  358. }
  359. return false;
  360. }
  361. void OpenXRCompositionLayer::set_protected_content(bool p_protected_content) {
  362. if (protected_content == p_protected_content) {
  363. return;
  364. }
  365. protected_content = p_protected_content;
  366. if (composition_layer_extension) {
  367. composition_layer_extension->composition_layer_set_protected_content(composition_layer, p_protected_content);
  368. }
  369. }
  370. bool OpenXRCompositionLayer::is_protected_content() const {
  371. return protected_content;
  372. }
  373. void OpenXRCompositionLayer::set_min_filter(Filter p_mode) {
  374. if (min_filter == p_mode) {
  375. return;
  376. }
  377. min_filter = p_mode;
  378. if (composition_layer_extension) {
  379. composition_layer_extension->composition_layer_set_min_filter(composition_layer, (OpenXRCompositionLayerExtension::Filter)p_mode);
  380. }
  381. }
  382. OpenXRCompositionLayer::Filter OpenXRCompositionLayer::get_min_filter() const {
  383. return min_filter;
  384. }
  385. void OpenXRCompositionLayer::set_mag_filter(Filter p_mode) {
  386. if (mag_filter == p_mode) {
  387. return;
  388. }
  389. mag_filter = p_mode;
  390. if (composition_layer_extension) {
  391. composition_layer_extension->composition_layer_set_mag_filter(composition_layer, (OpenXRCompositionLayerExtension::Filter)p_mode);
  392. }
  393. }
  394. OpenXRCompositionLayer::Filter OpenXRCompositionLayer::get_mag_filter() const {
  395. return mag_filter;
  396. }
  397. void OpenXRCompositionLayer::set_mipmap_mode(MipmapMode p_mode) {
  398. if (mipmap_mode == p_mode) {
  399. return;
  400. }
  401. mipmap_mode = p_mode;
  402. if (composition_layer_extension) {
  403. composition_layer_extension->composition_layer_set_mipmap_mode(composition_layer, (OpenXRCompositionLayerExtension::MipmapMode)p_mode);
  404. }
  405. }
  406. OpenXRCompositionLayer::MipmapMode OpenXRCompositionLayer::get_mipmap_mode() const {
  407. return mipmap_mode;
  408. }
  409. void OpenXRCompositionLayer::set_horizontal_wrap(Wrap p_mode) {
  410. if (horizontal_wrap == p_mode) {
  411. return;
  412. }
  413. horizontal_wrap = p_mode;
  414. if (composition_layer_extension) {
  415. composition_layer_extension->composition_layer_set_horizontal_wrap(composition_layer, (OpenXRCompositionLayerExtension::Wrap)p_mode);
  416. }
  417. }
  418. OpenXRCompositionLayer::Wrap OpenXRCompositionLayer::get_horizontal_wrap() const {
  419. return horizontal_wrap;
  420. }
  421. void OpenXRCompositionLayer::set_vertical_wrap(Wrap p_mode) {
  422. if (vertical_wrap == p_mode) {
  423. return;
  424. }
  425. vertical_wrap = p_mode;
  426. if (composition_layer_extension) {
  427. composition_layer_extension->composition_layer_set_vertical_wrap(composition_layer, (OpenXRCompositionLayerExtension::Wrap)p_mode);
  428. }
  429. }
  430. OpenXRCompositionLayer::Wrap OpenXRCompositionLayer::get_vertical_wrap() const {
  431. return vertical_wrap;
  432. }
  433. void OpenXRCompositionLayer::set_red_swizzle(Swizzle p_mode) {
  434. if (red_swizzle == p_mode) {
  435. return;
  436. }
  437. red_swizzle = p_mode;
  438. if (composition_layer_extension) {
  439. composition_layer_extension->composition_layer_set_red_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);
  440. }
  441. }
  442. OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_red_swizzle() const {
  443. return red_swizzle;
  444. }
  445. void OpenXRCompositionLayer::set_green_swizzle(Swizzle p_mode) {
  446. if (green_swizzle == p_mode) {
  447. return;
  448. }
  449. green_swizzle = p_mode;
  450. if (composition_layer_extension) {
  451. composition_layer_extension->composition_layer_set_green_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);
  452. }
  453. }
  454. OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_green_swizzle() const {
  455. return green_swizzle;
  456. }
  457. void OpenXRCompositionLayer::set_blue_swizzle(Swizzle p_mode) {
  458. if (blue_swizzle == p_mode) {
  459. return;
  460. }
  461. blue_swizzle = p_mode;
  462. if (composition_layer_extension) {
  463. composition_layer_extension->composition_layer_set_blue_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);
  464. }
  465. }
  466. OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_blue_swizzle() const {
  467. return blue_swizzle;
  468. }
  469. void OpenXRCompositionLayer::set_alpha_swizzle(Swizzle p_mode) {
  470. if (alpha_swizzle == p_mode) {
  471. return;
  472. }
  473. alpha_swizzle = p_mode;
  474. if (composition_layer_extension) {
  475. composition_layer_extension->composition_layer_set_alpha_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);
  476. }
  477. }
  478. OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_alpha_swizzle() const {
  479. return alpha_swizzle;
  480. }
  481. void OpenXRCompositionLayer::set_max_anisotropy(float p_value) {
  482. if (max_anisotropy == p_value) {
  483. return;
  484. }
  485. max_anisotropy = p_value;
  486. if (composition_layer_extension) {
  487. composition_layer_extension->composition_layer_set_max_anisotropy(composition_layer, p_value);
  488. }
  489. }
  490. float OpenXRCompositionLayer::get_max_anisotropy() const {
  491. return max_anisotropy;
  492. }
  493. void OpenXRCompositionLayer::set_border_color(const Color &p_color) {
  494. if (border_color == p_color) {
  495. return;
  496. }
  497. border_color = p_color;
  498. if (composition_layer_extension) {
  499. composition_layer_extension->composition_layer_set_border_color(composition_layer, p_color);
  500. }
  501. }
  502. Color OpenXRCompositionLayer::get_border_color() const {
  503. return border_color;
  504. }
  505. Ref<JavaObject> OpenXRCompositionLayer::get_android_surface() {
  506. if (composition_layer_extension) {
  507. return composition_layer_extension->composition_layer_get_android_surface(composition_layer);
  508. }
  509. return Ref<JavaObject>();
  510. }
  511. Vector2 OpenXRCompositionLayer::intersects_ray(const Vector3 &p_origin, const Vector3 &p_direction) const {
  512. return Vector2(-1.0, -1.0);
  513. }
  514. void OpenXRCompositionLayer::_reset_fallback_material() {
  515. ERR_FAIL_NULL(fallback);
  516. if (fallback->get_mesh().is_null()) {
  517. return;
  518. }
  519. if (enable_hole_punch && !Engine::get_singleton()->is_editor_hint() && is_natively_supported()) {
  520. Ref<ShaderMaterial> material = fallback->get_surface_override_material(0);
  521. if (material.is_null()) {
  522. Ref<Shader> shader;
  523. shader.instantiate();
  524. shader->set_code(HOLE_PUNCH_SHADER_CODE);
  525. material.instantiate();
  526. material->set_shader(shader);
  527. fallback->set_surface_override_material(0, material);
  528. }
  529. } else if (layer_viewport) {
  530. Ref<StandardMaterial3D> material = fallback->get_surface_override_material(0);
  531. if (material.is_null()) {
  532. material.instantiate();
  533. material->set_shading_mode(StandardMaterial3D::SHADING_MODE_UNSHADED);
  534. material->set_local_to_scene(true);
  535. fallback->set_surface_override_material(0, material);
  536. }
  537. material->set_flag(StandardMaterial3D::FLAG_DISABLE_DEPTH_TEST, !enable_hole_punch);
  538. material->set_transparency(get_alpha_blend() ? StandardMaterial3D::TRANSPARENCY_ALPHA : StandardMaterial3D::TRANSPARENCY_DISABLED);
  539. material->set_texture(StandardMaterial3D::TEXTURE_ALBEDO, layer_viewport->get_texture());
  540. } else {
  541. fallback->set_surface_override_material(0, Ref<Material>());
  542. }
  543. }
  544. void OpenXRCompositionLayer::_notification(int p_what) {
  545. switch (p_what) {
  546. case NOTIFICATION_POSTINITIALIZE: {
  547. composition_layer_nodes.push_back(this);
  548. for (OpenXRExtensionWrapper *extension : OpenXRAPI::get_registered_extension_wrappers()) {
  549. extension_property_values.merge(extension->get_viewport_composition_layer_extension_property_defaults());
  550. }
  551. if (composition_layer_extension) {
  552. composition_layer_extension->composition_layer_set_extension_property_values(composition_layer, extension_property_values);
  553. }
  554. } break;
  555. case NOTIFICATION_INTERNAL_PROCESS: {
  556. if (fallback) {
  557. if (should_update_fallback_mesh) {
  558. fallback->set_mesh(_create_fallback_mesh());
  559. _reset_fallback_material();
  560. should_update_fallback_mesh = false;
  561. }
  562. }
  563. } break;
  564. case NOTIFICATION_VISIBILITY_CHANGED: {
  565. if (is_natively_supported() && openxr_session_running && is_inside_tree()) {
  566. if (is_visible()) {
  567. _setup_composition_layer();
  568. } else {
  569. _clear_composition_layer();
  570. }
  571. }
  572. update_configuration_warnings();
  573. } break;
  574. case NOTIFICATION_LOCAL_TRANSFORM_CHANGED: {
  575. update_transform();
  576. update_configuration_warnings();
  577. } break;
  578. case NOTIFICATION_ENTER_TREE: {
  579. if (layer_viewport && is_viewport_in_use(layer_viewport)) {
  580. _clear_composition_layer();
  581. } else if (openxr_session_running && is_visible()) {
  582. _setup_composition_layer();
  583. }
  584. } break;
  585. case NOTIFICATION_EXIT_TREE: {
  586. // This will clean up existing resources.
  587. _clear_composition_layer();
  588. } break;
  589. }
  590. }
  591. void OpenXRCompositionLayer::_get_property_list(List<PropertyInfo> *p_property_list) const {
  592. List<PropertyInfo> extension_properties;
  593. for (OpenXRExtensionWrapper *extension : OpenXRAPI::get_registered_extension_wrappers()) {
  594. extension->get_viewport_composition_layer_extension_properties(&extension_properties);
  595. }
  596. for (const PropertyInfo &pinfo : extension_properties) {
  597. StringName prop_name = pinfo.name;
  598. if (!String(prop_name).contains_char('/')) {
  599. WARN_PRINT_ONCE(vformat("Discarding OpenXRCompositionLayer property name '%s' from extension because it doesn't contain a '/'."));
  600. continue;
  601. }
  602. p_property_list->push_back(pinfo);
  603. }
  604. }
  605. bool OpenXRCompositionLayer::_get(const StringName &p_property, Variant &r_value) const {
  606. if (extension_property_values.has(p_property)) {
  607. r_value = extension_property_values[p_property];
  608. return true;
  609. }
  610. return false;
  611. }
  612. bool OpenXRCompositionLayer::_set(const StringName &p_property, const Variant &p_value) {
  613. extension_property_values[p_property] = p_value;
  614. if (composition_layer_extension) {
  615. composition_layer_extension->composition_layer_set_extension_property_values(composition_layer, extension_property_values);
  616. }
  617. return true;
  618. }
  619. void OpenXRCompositionLayer::_validate_property(PropertyInfo &p_property) const {
  620. if (!Engine::get_singleton()->is_editor_hint()) {
  621. return;
  622. }
  623. if (p_property.name == "layer_viewport") {
  624. if (use_android_surface) {
  625. p_property.usage &= ~PROPERTY_USAGE_EDITOR;
  626. } else {
  627. p_property.usage |= PROPERTY_USAGE_EDITOR;
  628. }
  629. } else if (p_property.name == "android_surface_size") {
  630. if (use_android_surface) {
  631. p_property.usage |= PROPERTY_USAGE_EDITOR;
  632. } else {
  633. p_property.usage &= ~PROPERTY_USAGE_EDITOR;
  634. }
  635. }
  636. }
  637. PackedStringArray OpenXRCompositionLayer::get_configuration_warnings() const {
  638. PackedStringArray warnings = Node3D::get_configuration_warnings();
  639. if (is_visible() && is_inside_tree()) {
  640. XROrigin3D *origin = Object::cast_to<XROrigin3D>(get_parent());
  641. if (origin == nullptr) {
  642. warnings.push_back(RTR("OpenXR composition layers must have an XROrigin3D node as their parent."));
  643. }
  644. }
  645. if (!get_transform().basis.is_orthonormal()) {
  646. warnings.push_back(RTR("OpenXR composition layers must have orthonormalized transforms (ie. no scale or shearing)."));
  647. }
  648. if (enable_hole_punch && get_sort_order() >= 0) {
  649. warnings.push_back(RTR("Hole punching won't work as expected unless the sort order is less than zero."));
  650. }
  651. return warnings;
  652. }