Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
godotengine
GitHub Repository: godotengine/godot
Path: blob/master/modules/openxr/scene/openxr_composition_layer.cpp
21087 views
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
31
#include "openxr_composition_layer.h"
32
33
#include "../extensions/openxr_composition_layer_extension.h"
34
#include "../openxr_api.h"
35
#include "../openxr_interface.h"
36
37
#include "scene/3d/mesh_instance_3d.h"
38
#include "scene/3d/xr/xr_nodes.h"
39
#include "scene/main/viewport.h"
40
41
#include "platform/android/api/java_class_wrapper.h"
42
43
Vector<OpenXRCompositionLayer *> OpenXRCompositionLayer::composition_layer_nodes;
44
45
static const char *HOLE_PUNCH_SHADER_CODE =
46
"shader_type spatial;\n"
47
"render_mode blend_mix, depth_draw_opaque, cull_back, shadow_to_opacity, shadows_disabled;\n"
48
"void fragment() {\n"
49
"\tALBEDO = vec3(0.0, 0.0, 0.0);\n"
50
"}\n";
51
52
OpenXRCompositionLayer::OpenXRCompositionLayer() {
53
openxr_api = OpenXRAPI::get_singleton();
54
composition_layer_extension = OpenXRCompositionLayerExtension::get_singleton();
55
56
if (openxr_api) {
57
openxr_session_running = openxr_api->is_running();
58
}
59
60
Ref<OpenXRInterface> openxr_interface = XRServer::get_singleton()->find_interface("OpenXR");
61
if (openxr_interface.is_valid()) {
62
openxr_interface->connect("session_begun", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_begun));
63
openxr_interface->connect("session_stopping", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_stopping));
64
}
65
66
XRServer::get_singleton()->connect("reference_frame_changed", callable_mp(this, &OpenXRCompositionLayer::update_transform));
67
68
set_process_internal(true);
69
set_notify_local_transform(true);
70
71
if (Engine::get_singleton()->is_editor_hint()) {
72
// In the editor, create the fallback right away.
73
_create_fallback_node();
74
}
75
}
76
77
OpenXRCompositionLayer::~OpenXRCompositionLayer() {
78
Ref<OpenXRInterface> openxr_interface = XRServer::get_singleton()->find_interface("OpenXR");
79
if (openxr_interface.is_valid()) {
80
openxr_interface->disconnect("session_begun", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_begun));
81
openxr_interface->disconnect("session_stopping", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_stopping));
82
}
83
84
composition_layer_nodes.erase(this);
85
86
if (composition_layer_extension && composition_layer.is_valid()) {
87
composition_layer_extension->composition_layer_free(composition_layer);
88
}
89
}
90
91
void OpenXRCompositionLayer::_bind_methods() {
92
ClassDB::bind_method(D_METHOD("set_layer_viewport", "viewport"), &OpenXRCompositionLayer::set_layer_viewport);
93
ClassDB::bind_method(D_METHOD("get_layer_viewport"), &OpenXRCompositionLayer::get_layer_viewport);
94
95
ClassDB::bind_method(D_METHOD("set_use_android_surface", "enable"), &OpenXRCompositionLayer::set_use_android_surface);
96
ClassDB::bind_method(D_METHOD("get_use_android_surface"), &OpenXRCompositionLayer::get_use_android_surface);
97
98
ClassDB::bind_method(D_METHOD("set_android_surface_size", "size"), &OpenXRCompositionLayer::set_android_surface_size);
99
ClassDB::bind_method(D_METHOD("get_android_surface_size"), &OpenXRCompositionLayer::get_android_surface_size);
100
101
ClassDB::bind_method(D_METHOD("set_enable_hole_punch", "enable"), &OpenXRCompositionLayer::set_enable_hole_punch);
102
ClassDB::bind_method(D_METHOD("get_enable_hole_punch"), &OpenXRCompositionLayer::get_enable_hole_punch);
103
104
ClassDB::bind_method(D_METHOD("set_sort_order", "order"), &OpenXRCompositionLayer::set_sort_order);
105
ClassDB::bind_method(D_METHOD("get_sort_order"), &OpenXRCompositionLayer::get_sort_order);
106
107
ClassDB::bind_method(D_METHOD("set_alpha_blend", "enabled"), &OpenXRCompositionLayer::set_alpha_blend);
108
ClassDB::bind_method(D_METHOD("get_alpha_blend"), &OpenXRCompositionLayer::get_alpha_blend);
109
110
ClassDB::bind_method(D_METHOD("get_android_surface"), &OpenXRCompositionLayer::get_android_surface);
111
ClassDB::bind_method(D_METHOD("is_natively_supported"), &OpenXRCompositionLayer::is_natively_supported);
112
113
ClassDB::bind_method(D_METHOD("is_protected_content"), &OpenXRCompositionLayer::is_protected_content);
114
ClassDB::bind_method(D_METHOD("set_protected_content", "protected_content"), &OpenXRCompositionLayer::set_protected_content);
115
116
ClassDB::bind_method(D_METHOD("set_min_filter", "mode"), &OpenXRCompositionLayer::set_min_filter);
117
ClassDB::bind_method(D_METHOD("get_min_filter"), &OpenXRCompositionLayer::get_min_filter);
118
119
ClassDB::bind_method(D_METHOD("set_mag_filter", "mode"), &OpenXRCompositionLayer::set_mag_filter);
120
ClassDB::bind_method(D_METHOD("get_mag_filter"), &OpenXRCompositionLayer::get_mag_filter);
121
122
ClassDB::bind_method(D_METHOD("set_mipmap_mode", "mode"), &OpenXRCompositionLayer::set_mipmap_mode);
123
ClassDB::bind_method(D_METHOD("get_mipmap_mode"), &OpenXRCompositionLayer::get_mipmap_mode);
124
125
ClassDB::bind_method(D_METHOD("set_horizontal_wrap", "mode"), &OpenXRCompositionLayer::set_horizontal_wrap);
126
ClassDB::bind_method(D_METHOD("get_horizontal_wrap"), &OpenXRCompositionLayer::get_horizontal_wrap);
127
128
ClassDB::bind_method(D_METHOD("set_vertical_wrap", "mode"), &OpenXRCompositionLayer::set_vertical_wrap);
129
ClassDB::bind_method(D_METHOD("get_vertical_wrap"), &OpenXRCompositionLayer::get_vertical_wrap);
130
131
ClassDB::bind_method(D_METHOD("set_red_swizzle", "mode"), &OpenXRCompositionLayer::set_red_swizzle);
132
ClassDB::bind_method(D_METHOD("get_red_swizzle"), &OpenXRCompositionLayer::get_red_swizzle);
133
134
ClassDB::bind_method(D_METHOD("set_green_swizzle", "mode"), &OpenXRCompositionLayer::set_green_swizzle);
135
ClassDB::bind_method(D_METHOD("get_green_swizzle"), &OpenXRCompositionLayer::get_green_swizzle);
136
137
ClassDB::bind_method(D_METHOD("set_blue_swizzle", "mode"), &OpenXRCompositionLayer::set_blue_swizzle);
138
ClassDB::bind_method(D_METHOD("get_blue_swizzle"), &OpenXRCompositionLayer::get_blue_swizzle);
139
140
ClassDB::bind_method(D_METHOD("set_alpha_swizzle", "mode"), &OpenXRCompositionLayer::set_alpha_swizzle);
141
ClassDB::bind_method(D_METHOD("get_alpha_swizzle"), &OpenXRCompositionLayer::get_alpha_swizzle);
142
143
ClassDB::bind_method(D_METHOD("set_max_anisotropy", "value"), &OpenXRCompositionLayer::set_max_anisotropy);
144
ClassDB::bind_method(D_METHOD("get_max_anisotropy"), &OpenXRCompositionLayer::get_max_anisotropy);
145
146
ClassDB::bind_method(D_METHOD("set_border_color", "color"), &OpenXRCompositionLayer::set_border_color);
147
ClassDB::bind_method(D_METHOD("get_border_color"), &OpenXRCompositionLayer::get_border_color);
148
149
ClassDB::bind_method(D_METHOD("set_eye_visibility", "eye_visibility"), &OpenXRCompositionLayer::set_eye_visibility);
150
ClassDB::bind_method(D_METHOD("get_eye_visibility"), &OpenXRCompositionLayer::get_eye_visibility);
151
152
ClassDB::bind_method(D_METHOD("intersects_ray", "origin", "direction"), &OpenXRCompositionLayer::intersects_ray);
153
154
ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "layer_viewport", PROPERTY_HINT_NODE_TYPE, "SubViewport"), "set_layer_viewport", "get_layer_viewport");
155
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "use_android_surface", PROPERTY_HINT_NONE, ""), "set_use_android_surface", "get_use_android_surface");
156
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "protected_content", PROPERTY_HINT_NONE, ""), "set_protected_content", "is_protected_content");
157
ADD_PROPERTY(PropertyInfo(Variant::VECTOR2I, "android_surface_size", PROPERTY_HINT_NONE, ""), "set_android_surface_size", "get_android_surface_size");
158
ADD_PROPERTY(PropertyInfo(Variant::INT, "sort_order", PROPERTY_HINT_NONE, ""), "set_sort_order", "get_sort_order");
159
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "alpha_blend", PROPERTY_HINT_NONE, ""), "set_alpha_blend", "get_alpha_blend");
160
ADD_PROPERTY(PropertyInfo(Variant::BOOL, "enable_hole_punch", PROPERTY_HINT_NONE, ""), "set_enable_hole_punch", "get_enable_hole_punch");
161
ADD_PROPERTY(PropertyInfo(Variant::INT, "eye_visibility", PROPERTY_HINT_ENUM, "Both,Left,Right"), "set_eye_visibility", "get_eye_visibility");
162
163
ADD_GROUP("Swapchain State", "swapchain_state_");
164
ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_min_filter", PROPERTY_HINT_ENUM, "Nearest,Linear,Cubic"), "set_min_filter", "get_min_filter");
165
ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_mag_filter", PROPERTY_HINT_ENUM, "Nearest,Linear,Cubic"), "set_mag_filter", "get_mag_filter");
166
ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_mipmap_mode", PROPERTY_HINT_ENUM, "Disabled,Nearest,Linear"), "set_mipmap_mode", "get_mipmap_mode");
167
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");
168
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");
169
ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_red_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_red_swizzle", "get_red_swizzle");
170
ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_green_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_green_swizzle", "get_green_swizzle");
171
ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_blue_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_blue_swizzle", "get_blue_swizzle");
172
ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_alpha_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_alpha_swizzle", "get_alpha_swizzle");
173
ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "swapchain_state_max_anisotropy", PROPERTY_HINT_RANGE, "1.0,16.0,0.001"), "set_max_anisotropy", "get_max_anisotropy");
174
ADD_PROPERTY(PropertyInfo(Variant::COLOR, "swapchain_state_border_color"), "set_border_color", "get_border_color");
175
ADD_GROUP("", "");
176
177
BIND_ENUM_CONSTANT(FILTER_NEAREST);
178
BIND_ENUM_CONSTANT(FILTER_LINEAR);
179
BIND_ENUM_CONSTANT(FILTER_CUBIC);
180
181
BIND_ENUM_CONSTANT(MIPMAP_MODE_DISABLED);
182
BIND_ENUM_CONSTANT(MIPMAP_MODE_NEAREST);
183
BIND_ENUM_CONSTANT(MIPMAP_MODE_LINEAR);
184
185
BIND_ENUM_CONSTANT(WRAP_CLAMP_TO_BORDER);
186
BIND_ENUM_CONSTANT(WRAP_CLAMP_TO_EDGE);
187
BIND_ENUM_CONSTANT(WRAP_REPEAT);
188
BIND_ENUM_CONSTANT(WRAP_MIRRORED_REPEAT);
189
BIND_ENUM_CONSTANT(WRAP_MIRROR_CLAMP_TO_EDGE);
190
191
BIND_ENUM_CONSTANT(SWIZZLE_RED);
192
BIND_ENUM_CONSTANT(SWIZZLE_GREEN);
193
BIND_ENUM_CONSTANT(SWIZZLE_BLUE);
194
BIND_ENUM_CONSTANT(SWIZZLE_ALPHA);
195
BIND_ENUM_CONSTANT(SWIZZLE_ZERO);
196
BIND_ENUM_CONSTANT(SWIZZLE_ONE);
197
198
BIND_ENUM_CONSTANT(EYE_VISIBILITY_BOTH);
199
BIND_ENUM_CONSTANT(EYE_VISIBILITY_LEFT);
200
BIND_ENUM_CONSTANT(EYE_VISIBILITY_RIGHT);
201
}
202
203
bool OpenXRCompositionLayer::_should_use_fallback_node() {
204
if (Engine::get_singleton()->is_editor_hint() || openxr_api == nullptr) {
205
return true;
206
} else if (openxr_session_running) {
207
return enable_hole_punch || (!is_natively_supported() && !use_android_surface);
208
}
209
return false;
210
}
211
212
void OpenXRCompositionLayer::_create_fallback_node() {
213
ERR_FAIL_COND(fallback);
214
fallback = memnew(MeshInstance3D);
215
fallback->set_cast_shadows_setting(GeometryInstance3D::SHADOW_CASTING_SETTING_OFF);
216
add_child(fallback, false, INTERNAL_MODE_FRONT);
217
should_update_fallback_mesh = true;
218
}
219
220
void OpenXRCompositionLayer::_remove_fallback_node() {
221
ERR_FAIL_COND(fallback != nullptr);
222
remove_child(fallback);
223
fallback->queue_free();
224
fallback = nullptr;
225
}
226
227
void OpenXRCompositionLayer::_setup_composition_layer() {
228
if (use_android_surface || layer_viewport) {
229
if (composition_layer_extension) {
230
composition_layer_extension->composition_layer_register(composition_layer);
231
registered = true;
232
233
// NOTE: We don't setup/clear when using Android surfaces, so we don't destroy the surface unexpectedly.
234
if (layer_viewport) {
235
// Set our properties on the layer provider, which will create all the necessary resources (ex swap chains).
236
composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());
237
}
238
}
239
}
240
}
241
242
void OpenXRCompositionLayer::_clear_composition_layer() {
243
if (composition_layer_extension) {
244
composition_layer_extension->composition_layer_unregister(composition_layer);
245
registered = false;
246
247
// NOTE: We don't setup/clear when using Android surfaces, so we don't destroy the surface unexpectedly.
248
if (!use_android_surface) {
249
// This will reset the viewport and free all the resources (ex swap chains) used by the layer.
250
composition_layer_extension->composition_layer_set_viewport(composition_layer, RID(), Size2i());
251
}
252
}
253
}
254
255
void OpenXRCompositionLayer::_viewport_size_changed() {
256
if (layer_viewport && openxr_session_running && composition_layer_extension && is_natively_supported() && is_visible() && is_inside_tree()) {
257
composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());
258
}
259
}
260
261
void OpenXRCompositionLayer::_on_openxr_session_begun() {
262
openxr_session_running = true;
263
if (_should_register()) {
264
_setup_composition_layer();
265
}
266
if (!fallback && _should_use_fallback_node()) {
267
_create_fallback_node();
268
}
269
}
270
271
void OpenXRCompositionLayer::_on_openxr_session_stopping() {
272
openxr_session_running = false;
273
if (fallback && !_should_use_fallback_node()) {
274
_remove_fallback_node();
275
}
276
_clear_composition_layer();
277
}
278
279
void OpenXRCompositionLayer::update_transform() {
280
if (composition_layer_extension) {
281
bool parent_is_xr_camera = Object::cast_to<XRCamera3D>(get_parent()) != nullptr;
282
OpenXRCompositionLayerExtension::PoseSpace new_pose_space;
283
284
// Automatically set the PoseSpace to POSE_HEAD_LOCKED if layer is a child of XRCamera3D.
285
if (parent_is_xr_camera) {
286
new_pose_space = OpenXRCompositionLayerExtension::PoseSpace::POSE_HEAD_LOCKED;
287
} else {
288
new_pose_space = OpenXRCompositionLayerExtension::PoseSpace::POSE_WORLD_LOCKED;
289
}
290
291
// Pose space must be set first, as composition_layer_set_transform() depends on it.
292
composition_layer_extension->composition_layer_set_pose_space(composition_layer, new_pose_space);
293
composition_layer_extension->composition_layer_set_transform(composition_layer, get_transform());
294
}
295
}
296
297
void OpenXRCompositionLayer::update_fallback_mesh() {
298
should_update_fallback_mesh = true;
299
}
300
301
bool OpenXRCompositionLayer::_should_register() {
302
return !registered && openxr_session_running && is_inside_tree() && is_visible() && is_natively_supported();
303
}
304
305
bool OpenXRCompositionLayer::is_viewport_in_use(SubViewport *p_viewport) {
306
ERR_FAIL_NULL_V(p_viewport, false);
307
for (const OpenXRCompositionLayer *other_composition_layer : composition_layer_nodes) {
308
if (other_composition_layer != this && other_composition_layer->is_inside_tree() && other_composition_layer->get_layer_viewport() == p_viewport) {
309
return true;
310
}
311
}
312
return false;
313
}
314
315
void OpenXRCompositionLayer::set_layer_viewport(SubViewport *p_viewport) {
316
if (layer_viewport == p_viewport) {
317
return;
318
}
319
320
if (p_viewport != nullptr) {
321
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."));
322
}
323
if (use_android_surface) {
324
ERR_FAIL_COND_MSG(p_viewport != nullptr, RTR("Cannot set SubViewport on an OpenXR composition layer when using an Android surface."));
325
}
326
327
if (layer_viewport) {
328
layer_viewport->disconnect("size_changed", callable_mp(this, &OpenXRCompositionLayer::_viewport_size_changed));
329
}
330
331
layer_viewport = p_viewport;
332
if (_should_register()) {
333
_setup_composition_layer();
334
}
335
336
if (layer_viewport) {
337
layer_viewport->connect("size_changed", callable_mp(this, &OpenXRCompositionLayer::_viewport_size_changed));
338
339
SubViewport::UpdateMode update_mode = layer_viewport->get_update_mode();
340
if (update_mode == SubViewport::UPDATE_WHEN_VISIBLE || update_mode == SubViewport::UPDATE_WHEN_PARENT_VISIBLE) {
341
WARN_PRINT_ONCE("OpenXR composition layers cannot use SubViewports with UPDATE_WHEN_VISIBLE or UPDATE_WHEN_PARENT_VISIBLE. Switching to UPDATE_ALWAYS.");
342
layer_viewport->set_update_mode(SubViewport::UPDATE_ALWAYS);
343
}
344
}
345
346
if (fallback) {
347
_reset_fallback_material();
348
} else if (openxr_session_running && composition_layer_extension && is_visible() && is_inside_tree()) {
349
if (layer_viewport) {
350
composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());
351
} else {
352
composition_layer_extension->composition_layer_set_viewport(composition_layer, RID(), Size2i());
353
}
354
}
355
}
356
357
void OpenXRCompositionLayer::set_use_android_surface(bool p_use_android_surface) {
358
if (use_android_surface == p_use_android_surface) {
359
return;
360
}
361
362
use_android_surface = p_use_android_surface;
363
if (use_android_surface) {
364
// It's possible that the layer provider is unregistered here (if previously invisible)
365
set_layer_viewport(nullptr);
366
if (composition_layer_extension) {
367
composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, true, android_surface_size);
368
}
369
// ...and it may not be set up above because of viewport = null, android surface is false, so set it up again:
370
if (_should_register()) {
371
_setup_composition_layer();
372
}
373
} else {
374
if (composition_layer_extension) {
375
composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, false, Size2i());
376
}
377
}
378
379
notify_property_list_changed();
380
}
381
382
bool OpenXRCompositionLayer::get_use_android_surface() const {
383
return use_android_surface;
384
}
385
386
void OpenXRCompositionLayer::set_android_surface_size(Size2i p_size) {
387
if (android_surface_size == p_size) {
388
return;
389
}
390
391
android_surface_size = p_size;
392
if (use_android_surface && composition_layer_extension) {
393
composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, true, android_surface_size);
394
}
395
}
396
397
Size2i OpenXRCompositionLayer::get_android_surface_size() const {
398
return android_surface_size;
399
}
400
401
SubViewport *OpenXRCompositionLayer::get_layer_viewport() const {
402
return layer_viewport;
403
}
404
405
void OpenXRCompositionLayer::set_enable_hole_punch(bool p_enable) {
406
if (enable_hole_punch == p_enable) {
407
return;
408
}
409
410
enable_hole_punch = p_enable;
411
if (_should_use_fallback_node()) {
412
if (fallback) {
413
_reset_fallback_material();
414
} else {
415
_create_fallback_node();
416
}
417
} else if (fallback) {
418
_remove_fallback_node();
419
}
420
421
update_configuration_warnings();
422
}
423
424
bool OpenXRCompositionLayer::get_enable_hole_punch() const {
425
return enable_hole_punch;
426
}
427
428
void OpenXRCompositionLayer::set_sort_order(int p_order) {
429
sort_order = p_order;
430
if (composition_layer_extension) {
431
composition_layer_extension->composition_layer_set_sort_order(composition_layer, p_order);
432
}
433
update_configuration_warnings();
434
}
435
436
int OpenXRCompositionLayer::get_sort_order() const {
437
return sort_order;
438
}
439
440
void OpenXRCompositionLayer::set_alpha_blend(bool p_alpha_blend) {
441
alpha_blend = p_alpha_blend;
442
if (composition_layer_extension) {
443
composition_layer_extension->composition_layer_set_alpha_blend(composition_layer, p_alpha_blend);
444
}
445
if (fallback) {
446
_reset_fallback_material();
447
}
448
}
449
450
bool OpenXRCompositionLayer::get_alpha_blend() const {
451
return alpha_blend;
452
}
453
454
bool OpenXRCompositionLayer::is_natively_supported() const {
455
if (composition_layer_extension && openxr_api) {
456
return composition_layer_extension->is_available(_get_openxr_type());
457
}
458
return false;
459
}
460
461
void OpenXRCompositionLayer::set_protected_content(bool p_protected_content) {
462
if (protected_content == p_protected_content) {
463
return;
464
}
465
protected_content = p_protected_content;
466
if (composition_layer_extension) {
467
composition_layer_extension->composition_layer_set_protected_content(composition_layer, p_protected_content);
468
}
469
}
470
471
bool OpenXRCompositionLayer::is_protected_content() const {
472
return protected_content;
473
}
474
475
void OpenXRCompositionLayer::set_min_filter(Filter p_mode) {
476
if (min_filter == p_mode) {
477
return;
478
}
479
min_filter = p_mode;
480
if (composition_layer_extension) {
481
composition_layer_extension->composition_layer_set_min_filter(composition_layer, (OpenXRCompositionLayerExtension::Filter)p_mode);
482
}
483
}
484
485
OpenXRCompositionLayer::Filter OpenXRCompositionLayer::get_min_filter() const {
486
return min_filter;
487
}
488
489
void OpenXRCompositionLayer::set_mag_filter(Filter p_mode) {
490
if (mag_filter == p_mode) {
491
return;
492
}
493
mag_filter = p_mode;
494
if (composition_layer_extension) {
495
composition_layer_extension->composition_layer_set_mag_filter(composition_layer, (OpenXRCompositionLayerExtension::Filter)p_mode);
496
}
497
}
498
499
OpenXRCompositionLayer::Filter OpenXRCompositionLayer::get_mag_filter() const {
500
return mag_filter;
501
}
502
503
void OpenXRCompositionLayer::set_mipmap_mode(MipmapMode p_mode) {
504
if (mipmap_mode == p_mode) {
505
return;
506
}
507
mipmap_mode = p_mode;
508
if (composition_layer_extension) {
509
composition_layer_extension->composition_layer_set_mipmap_mode(composition_layer, (OpenXRCompositionLayerExtension::MipmapMode)p_mode);
510
}
511
}
512
513
OpenXRCompositionLayer::MipmapMode OpenXRCompositionLayer::get_mipmap_mode() const {
514
return mipmap_mode;
515
}
516
517
void OpenXRCompositionLayer::set_horizontal_wrap(Wrap p_mode) {
518
if (horizontal_wrap == p_mode) {
519
return;
520
}
521
horizontal_wrap = p_mode;
522
if (composition_layer_extension) {
523
composition_layer_extension->composition_layer_set_horizontal_wrap(composition_layer, (OpenXRCompositionLayerExtension::Wrap)p_mode);
524
}
525
}
526
527
OpenXRCompositionLayer::Wrap OpenXRCompositionLayer::get_horizontal_wrap() const {
528
return horizontal_wrap;
529
}
530
531
void OpenXRCompositionLayer::set_vertical_wrap(Wrap p_mode) {
532
if (vertical_wrap == p_mode) {
533
return;
534
}
535
vertical_wrap = p_mode;
536
if (composition_layer_extension) {
537
composition_layer_extension->composition_layer_set_vertical_wrap(composition_layer, (OpenXRCompositionLayerExtension::Wrap)p_mode);
538
}
539
}
540
541
OpenXRCompositionLayer::Wrap OpenXRCompositionLayer::get_vertical_wrap() const {
542
return vertical_wrap;
543
}
544
545
void OpenXRCompositionLayer::set_red_swizzle(Swizzle p_mode) {
546
if (red_swizzle == p_mode) {
547
return;
548
}
549
red_swizzle = p_mode;
550
if (composition_layer_extension) {
551
composition_layer_extension->composition_layer_set_red_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);
552
}
553
}
554
555
OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_red_swizzle() const {
556
return red_swizzle;
557
}
558
559
void OpenXRCompositionLayer::set_green_swizzle(Swizzle p_mode) {
560
if (green_swizzle == p_mode) {
561
return;
562
}
563
green_swizzle = p_mode;
564
if (composition_layer_extension) {
565
composition_layer_extension->composition_layer_set_green_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);
566
}
567
}
568
569
OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_green_swizzle() const {
570
return green_swizzle;
571
}
572
573
void OpenXRCompositionLayer::set_blue_swizzle(Swizzle p_mode) {
574
if (blue_swizzle == p_mode) {
575
return;
576
}
577
blue_swizzle = p_mode;
578
if (composition_layer_extension) {
579
composition_layer_extension->composition_layer_set_blue_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);
580
}
581
}
582
583
OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_blue_swizzle() const {
584
return blue_swizzle;
585
}
586
587
void OpenXRCompositionLayer::set_alpha_swizzle(Swizzle p_mode) {
588
if (alpha_swizzle == p_mode) {
589
return;
590
}
591
alpha_swizzle = p_mode;
592
if (composition_layer_extension) {
593
composition_layer_extension->composition_layer_set_alpha_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);
594
}
595
}
596
597
OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_alpha_swizzle() const {
598
return alpha_swizzle;
599
}
600
601
void OpenXRCompositionLayer::set_max_anisotropy(float p_value) {
602
if (max_anisotropy == p_value) {
603
return;
604
}
605
max_anisotropy = p_value;
606
if (composition_layer_extension) {
607
composition_layer_extension->composition_layer_set_max_anisotropy(composition_layer, p_value);
608
}
609
}
610
611
float OpenXRCompositionLayer::get_max_anisotropy() const {
612
return max_anisotropy;
613
}
614
615
void OpenXRCompositionLayer::set_border_color(const Color &p_color) {
616
if (border_color == p_color) {
617
return;
618
}
619
border_color = p_color;
620
if (composition_layer_extension) {
621
composition_layer_extension->composition_layer_set_border_color(composition_layer, p_color);
622
}
623
}
624
625
Color OpenXRCompositionLayer::get_border_color() const {
626
return border_color;
627
}
628
629
void OpenXRCompositionLayer::set_eye_visibility(EyeVisibility p_eye_visibility) {
630
if (eye_visibility == p_eye_visibility) {
631
return;
632
}
633
eye_visibility = p_eye_visibility;
634
if (composition_layer_extension) {
635
composition_layer_extension->composition_layer_set_eye_visibility(composition_layer, (OpenXRCompositionLayerExtension::EyeVisibility)p_eye_visibility);
636
}
637
}
638
639
OpenXRCompositionLayer::EyeVisibility OpenXRCompositionLayer::get_eye_visibility() const {
640
return eye_visibility;
641
}
642
643
Ref<JavaObject> OpenXRCompositionLayer::get_android_surface() {
644
if (composition_layer_extension) {
645
return composition_layer_extension->composition_layer_get_android_surface(composition_layer);
646
}
647
return Ref<JavaObject>();
648
}
649
650
Vector2 OpenXRCompositionLayer::intersects_ray(const Vector3 &p_origin, const Vector3 &p_direction) const {
651
return Vector2(-1.0, -1.0);
652
}
653
654
void OpenXRCompositionLayer::_reset_fallback_material() {
655
ERR_FAIL_NULL(fallback);
656
657
if (fallback->get_mesh().is_null()) {
658
return;
659
}
660
661
if (enable_hole_punch && !Engine::get_singleton()->is_editor_hint() && is_natively_supported()) {
662
Ref<ShaderMaterial> material = fallback->get_surface_override_material(0);
663
if (material.is_null()) {
664
Ref<Shader> shader;
665
shader.instantiate();
666
shader->set_code(HOLE_PUNCH_SHADER_CODE);
667
668
material.instantiate();
669
material->set_shader(shader);
670
671
fallback->set_surface_override_material(0, material);
672
}
673
} else if (layer_viewport) {
674
Ref<StandardMaterial3D> material = fallback->get_surface_override_material(0);
675
if (material.is_null()) {
676
material.instantiate();
677
material->set_shading_mode(StandardMaterial3D::SHADING_MODE_UNSHADED);
678
material->set_local_to_scene(true);
679
fallback->set_surface_override_material(0, material);
680
}
681
682
material->set_flag(StandardMaterial3D::FLAG_DISABLE_DEPTH_TEST, !enable_hole_punch);
683
material->set_transparency(get_alpha_blend() ? StandardMaterial3D::TRANSPARENCY_ALPHA : StandardMaterial3D::TRANSPARENCY_DISABLED);
684
material->set_texture(StandardMaterial3D::TEXTURE_ALBEDO, layer_viewport->get_texture());
685
} else {
686
fallback->set_surface_override_material(0, Ref<Material>());
687
}
688
}
689
690
void OpenXRCompositionLayer::_notification(int p_what) {
691
switch (p_what) {
692
case NOTIFICATION_POSTINITIALIZE: {
693
composition_layer_nodes.push_back(this);
694
695
for (OpenXRExtensionWrapper *extension : OpenXRAPI::get_registered_extension_wrappers()) {
696
extension_property_values.merge(extension->get_viewport_composition_layer_extension_property_defaults());
697
}
698
if (composition_layer_extension) {
699
composition_layer_extension->composition_layer_set_extension_property_values(composition_layer, extension_property_values);
700
}
701
} break;
702
case NOTIFICATION_INTERNAL_PROCESS: {
703
if (fallback) {
704
if (should_update_fallback_mesh) {
705
fallback->set_mesh(_create_fallback_mesh());
706
_reset_fallback_material();
707
should_update_fallback_mesh = false;
708
}
709
}
710
} break;
711
case NOTIFICATION_VISIBILITY_CHANGED: {
712
if (is_natively_supported() && openxr_session_running && is_inside_tree()) {
713
if (is_visible()) {
714
_setup_composition_layer();
715
update_transform();
716
} else {
717
_clear_composition_layer();
718
}
719
}
720
update_configuration_warnings();
721
} break;
722
case NOTIFICATION_LOCAL_TRANSFORM_CHANGED: {
723
update_transform();
724
update_configuration_warnings();
725
} break;
726
case NOTIFICATION_ENTER_TREE: {
727
if (layer_viewport && is_viewport_in_use(layer_viewport)) {
728
_clear_composition_layer();
729
} else if (openxr_session_running && is_visible()) {
730
_setup_composition_layer();
731
}
732
update_transform();
733
} break;
734
case NOTIFICATION_PARENTED: {
735
update_transform();
736
} break;
737
case NOTIFICATION_EXIT_TREE: {
738
// This will clean up existing resources.
739
_clear_composition_layer();
740
} break;
741
}
742
}
743
744
void OpenXRCompositionLayer::_get_property_list(List<PropertyInfo> *p_property_list) const {
745
List<PropertyInfo> extension_properties;
746
for (OpenXRExtensionWrapper *extension : OpenXRAPI::get_registered_extension_wrappers()) {
747
extension->get_viewport_composition_layer_extension_properties(&extension_properties);
748
}
749
750
for (const PropertyInfo &pinfo : extension_properties) {
751
StringName prop_name = pinfo.name;
752
if (!String(prop_name).contains_char('/')) {
753
WARN_PRINT_ONCE(vformat("Discarding OpenXRCompositionLayer property name '%s' from extension because it doesn't contain a '/'."));
754
continue;
755
}
756
p_property_list->push_back(pinfo);
757
}
758
}
759
760
bool OpenXRCompositionLayer::_get(const StringName &p_property, Variant &r_value) const {
761
if (extension_property_values.has(p_property)) {
762
r_value = extension_property_values[p_property];
763
return true;
764
}
765
766
return false;
767
}
768
769
bool OpenXRCompositionLayer::_set(const StringName &p_property, const Variant &p_value) {
770
extension_property_values[p_property] = p_value;
771
772
if (composition_layer_extension) {
773
composition_layer_extension->composition_layer_set_extension_property_values(composition_layer, extension_property_values);
774
}
775
776
return true;
777
}
778
779
void OpenXRCompositionLayer::_validate_property(PropertyInfo &p_property) const {
780
if (!Engine::get_singleton()->is_editor_hint()) {
781
return;
782
}
783
if (p_property.name == "layer_viewport") {
784
if (use_android_surface) {
785
p_property.usage &= ~PROPERTY_USAGE_EDITOR;
786
} else {
787
p_property.usage |= PROPERTY_USAGE_EDITOR;
788
}
789
} else if (p_property.name == "android_surface_size") {
790
if (use_android_surface) {
791
p_property.usage |= PROPERTY_USAGE_EDITOR;
792
} else {
793
p_property.usage &= ~PROPERTY_USAGE_EDITOR;
794
}
795
}
796
}
797
798
PackedStringArray OpenXRCompositionLayer::get_configuration_warnings() const {
799
PackedStringArray warnings = Node3D::get_configuration_warnings();
800
801
if (is_visible() && is_inside_tree()) {
802
XROrigin3D *xr_origin = Object::cast_to<XROrigin3D>(get_parent());
803
XRCamera3D *xr_camera = Object::cast_to<XRCamera3D>(get_parent());
804
805
if (xr_origin == nullptr && xr_camera == nullptr) {
806
warnings.push_back(RTR("OpenXR composition layers must have have either an XROrigin3D or XRCamera3D node as their parent."));
807
}
808
}
809
810
if (!get_transform().basis.is_orthonormal()) {
811
warnings.push_back(RTR("OpenXR composition layers must have orthonormalized transforms (ie. no scale or shearing)."));
812
}
813
814
if (enable_hole_punch && get_sort_order() >= 0) {
815
warnings.push_back(RTR("Hole punching won't work as expected unless the sort order is less than zero."));
816
}
817
818
return warnings;
819
}
820
821