Path: blob/master/modules/openxr/scene/openxr_composition_layer.cpp
11353 views
/**************************************************************************/1/* openxr_composition_layer.cpp */2/**************************************************************************/3/* This file is part of: */4/* GODOT ENGINE */5/* https://godotengine.org */6/**************************************************************************/7/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */8/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */9/* */10/* Permission is hereby granted, free of charge, to any person obtaining */11/* a copy of this software and associated documentation files (the */12/* "Software"), to deal in the Software without restriction, including */13/* without limitation the rights to use, copy, modify, merge, publish, */14/* distribute, sublicense, and/or sell copies of the Software, and to */15/* permit persons to whom the Software is furnished to do so, subject to */16/* the following conditions: */17/* */18/* The above copyright notice and this permission notice shall be */19/* included in all copies or substantial portions of the Software. */20/* */21/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */22/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */23/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */24/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */25/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */26/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */27/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */28/**************************************************************************/2930#include "openxr_composition_layer.h"3132#include "../openxr_api.h"33#include "../openxr_interface.h"3435#include "scene/3d/mesh_instance_3d.h"36#include "scene/3d/xr/xr_nodes.h"37#include "scene/main/viewport.h"3839#include "platform/android/api/java_class_wrapper.h"4041Vector<OpenXRCompositionLayer *> OpenXRCompositionLayer::composition_layer_nodes;4243static const char *HOLE_PUNCH_SHADER_CODE =44"shader_type spatial;\n"45"render_mode blend_mix, depth_draw_opaque, cull_back, shadow_to_opacity, shadows_disabled;\n"46"void fragment() {\n"47"\tALBEDO = vec3(0.0, 0.0, 0.0);\n"48"}\n";4950OpenXRCompositionLayer::OpenXRCompositionLayer(XrCompositionLayerBaseHeader *p_composition_layer) {51composition_layer_base_header = p_composition_layer;52openxr_layer_provider = memnew(OpenXRViewportCompositionLayerProvider(composition_layer_base_header));53swapchain_state = openxr_layer_provider->get_swapchain_state();5455openxr_api = OpenXRAPI::get_singleton();56composition_layer_extension = OpenXRCompositionLayerExtension::get_singleton();5758if (openxr_api) {59openxr_session_running = openxr_api->is_running();60}6162Ref<OpenXRInterface> openxr_interface = XRServer::get_singleton()->find_interface("OpenXR");63if (openxr_interface.is_valid()) {64openxr_interface->connect("session_begun", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_begun));65openxr_interface->connect("session_stopping", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_stopping));66}6768set_process_internal(true);69set_notify_local_transform(true);7071if (Engine::get_singleton()->is_editor_hint()) {72// In the editor, create the fallback right away.73_create_fallback_node();74}75}7677OpenXRCompositionLayer::~OpenXRCompositionLayer() {78Ref<OpenXRInterface> openxr_interface = XRServer::get_singleton()->find_interface("OpenXR");79if (openxr_interface.is_valid()) {80openxr_interface->disconnect("session_begun", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_begun));81openxr_interface->disconnect("session_stopping", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_stopping));82}8384composition_layer_nodes.erase(this);8586if (openxr_layer_provider != nullptr) {87_clear_composition_layer_provider();88memdelete(openxr_layer_provider);89openxr_layer_provider = nullptr;90}91}9293void OpenXRCompositionLayer::_bind_methods() {94ClassDB::bind_method(D_METHOD("set_layer_viewport", "viewport"), &OpenXRCompositionLayer::set_layer_viewport);95ClassDB::bind_method(D_METHOD("get_layer_viewport"), &OpenXRCompositionLayer::get_layer_viewport);9697ClassDB::bind_method(D_METHOD("set_use_android_surface", "enable"), &OpenXRCompositionLayer::set_use_android_surface);98ClassDB::bind_method(D_METHOD("get_use_android_surface"), &OpenXRCompositionLayer::get_use_android_surface);99100ClassDB::bind_method(D_METHOD("set_android_surface_size", "size"), &OpenXRCompositionLayer::set_android_surface_size);101ClassDB::bind_method(D_METHOD("get_android_surface_size"), &OpenXRCompositionLayer::get_android_surface_size);102103ClassDB::bind_method(D_METHOD("set_enable_hole_punch", "enable"), &OpenXRCompositionLayer::set_enable_hole_punch);104ClassDB::bind_method(D_METHOD("get_enable_hole_punch"), &OpenXRCompositionLayer::get_enable_hole_punch);105106ClassDB::bind_method(D_METHOD("set_sort_order", "order"), &OpenXRCompositionLayer::set_sort_order);107ClassDB::bind_method(D_METHOD("get_sort_order"), &OpenXRCompositionLayer::get_sort_order);108109ClassDB::bind_method(D_METHOD("set_alpha_blend", "enabled"), &OpenXRCompositionLayer::set_alpha_blend);110ClassDB::bind_method(D_METHOD("get_alpha_blend"), &OpenXRCompositionLayer::get_alpha_blend);111112ClassDB::bind_method(D_METHOD("get_android_surface"), &OpenXRCompositionLayer::get_android_surface);113ClassDB::bind_method(D_METHOD("is_natively_supported"), &OpenXRCompositionLayer::is_natively_supported);114115ClassDB::bind_method(D_METHOD("is_protected_content"), &OpenXRCompositionLayer::is_protected_content);116ClassDB::bind_method(D_METHOD("set_protected_content", "protected_content"), &OpenXRCompositionLayer::set_protected_content);117118ClassDB::bind_method(D_METHOD("set_min_filter", "mode"), &OpenXRCompositionLayer::set_min_filter);119ClassDB::bind_method(D_METHOD("get_min_filter"), &OpenXRCompositionLayer::get_min_filter);120121ClassDB::bind_method(D_METHOD("set_mag_filter", "mode"), &OpenXRCompositionLayer::set_mag_filter);122ClassDB::bind_method(D_METHOD("get_mag_filter"), &OpenXRCompositionLayer::get_mag_filter);123124ClassDB::bind_method(D_METHOD("set_mipmap_mode", "mode"), &OpenXRCompositionLayer::set_mipmap_mode);125ClassDB::bind_method(D_METHOD("get_mipmap_mode"), &OpenXRCompositionLayer::get_mipmap_mode);126127ClassDB::bind_method(D_METHOD("set_horizontal_wrap", "mode"), &OpenXRCompositionLayer::set_horizontal_wrap);128ClassDB::bind_method(D_METHOD("get_horizontal_wrap"), &OpenXRCompositionLayer::get_horizontal_wrap);129130ClassDB::bind_method(D_METHOD("set_vertical_wrap", "mode"), &OpenXRCompositionLayer::set_vertical_wrap);131ClassDB::bind_method(D_METHOD("get_vertical_wrap"), &OpenXRCompositionLayer::get_vertical_wrap);132133ClassDB::bind_method(D_METHOD("set_red_swizzle", "mode"), &OpenXRCompositionLayer::set_red_swizzle);134ClassDB::bind_method(D_METHOD("get_red_swizzle"), &OpenXRCompositionLayer::get_red_swizzle);135136ClassDB::bind_method(D_METHOD("set_green_swizzle", "mode"), &OpenXRCompositionLayer::set_green_swizzle);137ClassDB::bind_method(D_METHOD("get_green_swizzle"), &OpenXRCompositionLayer::get_green_swizzle);138139ClassDB::bind_method(D_METHOD("set_blue_swizzle", "mode"), &OpenXRCompositionLayer::set_blue_swizzle);140ClassDB::bind_method(D_METHOD("get_blue_swizzle"), &OpenXRCompositionLayer::get_blue_swizzle);141142ClassDB::bind_method(D_METHOD("set_alpha_swizzle", "mode"), &OpenXRCompositionLayer::set_alpha_swizzle);143ClassDB::bind_method(D_METHOD("get_alpha_swizzle"), &OpenXRCompositionLayer::get_alpha_swizzle);144145ClassDB::bind_method(D_METHOD("set_max_anisotropy", "value"), &OpenXRCompositionLayer::set_max_anisotropy);146ClassDB::bind_method(D_METHOD("get_max_anisotropy"), &OpenXRCompositionLayer::get_max_anisotropy);147148ClassDB::bind_method(D_METHOD("set_border_color", "color"), &OpenXRCompositionLayer::set_border_color);149ClassDB::bind_method(D_METHOD("get_border_color"), &OpenXRCompositionLayer::get_border_color);150151ClassDB::bind_method(D_METHOD("intersects_ray", "origin", "direction"), &OpenXRCompositionLayer::intersects_ray);152153ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "layer_viewport", PROPERTY_HINT_NODE_TYPE, "SubViewport"), "set_layer_viewport", "get_layer_viewport");154ADD_PROPERTY(PropertyInfo(Variant::BOOL, "use_android_surface", PROPERTY_HINT_NONE, ""), "set_use_android_surface", "get_use_android_surface");155ADD_PROPERTY(PropertyInfo(Variant::BOOL, "protected_content", PROPERTY_HINT_NONE, ""), "set_protected_content", "is_protected_content");156ADD_PROPERTY(PropertyInfo(Variant::VECTOR2I, "android_surface_size", PROPERTY_HINT_NONE, ""), "set_android_surface_size", "get_android_surface_size");157ADD_PROPERTY(PropertyInfo(Variant::INT, "sort_order", PROPERTY_HINT_NONE, ""), "set_sort_order", "get_sort_order");158ADD_PROPERTY(PropertyInfo(Variant::BOOL, "alpha_blend", PROPERTY_HINT_NONE, ""), "set_alpha_blend", "get_alpha_blend");159ADD_PROPERTY(PropertyInfo(Variant::BOOL, "enable_hole_punch", PROPERTY_HINT_NONE, ""), "set_enable_hole_punch", "get_enable_hole_punch");160161ADD_GROUP("Swapchain State", "swapchain_state_");162ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_min_filter", PROPERTY_HINT_ENUM, "Nearest,Linear,Cubic"), "set_min_filter", "get_min_filter");163ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_mag_filter", PROPERTY_HINT_ENUM, "Nearest,Linear,Cubic"), "set_mag_filter", "get_mag_filter");164ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_mipmap_mode", PROPERTY_HINT_ENUM, "Disabled,Nearest,Linear"), "set_mipmap_mode", "get_mipmap_mode");165ADD_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");166ADD_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");167ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_red_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_red_swizzle", "get_red_swizzle");168ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_green_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_green_swizzle", "get_green_swizzle");169ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_blue_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_blue_swizzle", "get_blue_swizzle");170ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_alpha_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_alpha_swizzle", "get_alpha_swizzle");171ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "swapchain_state_max_anisotropy", PROPERTY_HINT_RANGE, "1.0,16.0,0.001"), "set_max_anisotropy", "get_max_anisotropy");172ADD_PROPERTY(PropertyInfo(Variant::COLOR, "swapchain_state_border_color"), "set_border_color", "get_border_color");173ADD_GROUP("", "");174175BIND_ENUM_CONSTANT(FILTER_NEAREST);176BIND_ENUM_CONSTANT(FILTER_LINEAR);177BIND_ENUM_CONSTANT(FILTER_CUBIC);178179BIND_ENUM_CONSTANT(MIPMAP_MODE_DISABLED);180BIND_ENUM_CONSTANT(MIPMAP_MODE_NEAREST);181BIND_ENUM_CONSTANT(MIPMAP_MODE_LINEAR);182183BIND_ENUM_CONSTANT(WRAP_CLAMP_TO_BORDER);184BIND_ENUM_CONSTANT(WRAP_CLAMP_TO_EDGE);185BIND_ENUM_CONSTANT(WRAP_REPEAT);186BIND_ENUM_CONSTANT(WRAP_MIRRORED_REPEAT);187BIND_ENUM_CONSTANT(WRAP_MIRROR_CLAMP_TO_EDGE);188189BIND_ENUM_CONSTANT(SWIZZLE_RED);190BIND_ENUM_CONSTANT(SWIZZLE_GREEN);191BIND_ENUM_CONSTANT(SWIZZLE_BLUE);192BIND_ENUM_CONSTANT(SWIZZLE_ALPHA);193BIND_ENUM_CONSTANT(SWIZZLE_ZERO);194BIND_ENUM_CONSTANT(SWIZZLE_ONE);195}196197bool OpenXRCompositionLayer::_should_use_fallback_node() {198if (Engine::get_singleton()->is_editor_hint() || openxr_api == nullptr) {199return true;200} else if (openxr_session_running) {201return enable_hole_punch || (!is_natively_supported() && !use_android_surface);202}203return false;204}205206void OpenXRCompositionLayer::_create_fallback_node() {207ERR_FAIL_COND(fallback);208fallback = memnew(MeshInstance3D);209fallback->set_cast_shadows_setting(GeometryInstance3D::SHADOW_CASTING_SETTING_OFF);210add_child(fallback, false, INTERNAL_MODE_FRONT);211should_update_fallback_mesh = true;212}213214void OpenXRCompositionLayer::_remove_fallback_node() {215ERR_FAIL_COND(fallback != nullptr);216remove_child(fallback);217fallback->queue_free();218fallback = nullptr;219}220221void OpenXRCompositionLayer::_setup_composition_layer_provider() {222if (use_android_surface || layer_viewport) {223if (composition_layer_extension) {224composition_layer_extension->register_viewport_composition_layer_provider(openxr_layer_provider);225registered = true;226}227228// NOTE: We don't setup/clear when using Android surfaces, so we don't destroy the surface unexpectedly.229if (layer_viewport) {230// Set our properties on the layer provider, which will create all the necessary resources (ex swap chains).231openxr_layer_provider->set_viewport(layer_viewport->get_viewport_rid(), layer_viewport->get_size());232}233}234}235236void OpenXRCompositionLayer::_clear_composition_layer_provider() {237if (composition_layer_extension) {238composition_layer_extension->unregister_viewport_composition_layer_provider(openxr_layer_provider);239registered = false;240}241242// NOTE: We don't setup/clear when using Android surfaces, so we don't destroy the surface unexpectedly.243if (!use_android_surface) {244// This will reset the viewport and free all the resources (ex swap chains) used by the layer.245openxr_layer_provider->set_viewport(RID(), Size2i());246}247}248249void OpenXRCompositionLayer::_on_openxr_session_begun() {250openxr_session_running = true;251if (_should_register()) {252_setup_composition_layer_provider();253}254if (!fallback && _should_use_fallback_node()) {255_create_fallback_node();256}257}258259void OpenXRCompositionLayer::_on_openxr_session_stopping() {260openxr_session_running = false;261if (fallback && !_should_use_fallback_node()) {262_remove_fallback_node();263}264_clear_composition_layer_provider();265}266267void OpenXRCompositionLayer::update_fallback_mesh() {268should_update_fallback_mesh = true;269}270271bool OpenXRCompositionLayer::_should_register() {272return !registered && openxr_session_running && is_inside_tree() && is_visible() && is_natively_supported();273}274275XrPosef OpenXRCompositionLayer::get_openxr_pose() {276Transform3D reference_frame = XRServer::get_singleton()->get_reference_frame();277Transform3D transform = reference_frame.inverse() * get_transform();278Quaternion quat(transform.basis.orthonormalized());279return {280{ (float)quat.x, (float)quat.y, (float)quat.z, (float)quat.w },281{ (float)transform.origin.x, (float)transform.origin.y, (float)transform.origin.z }282};283}284285bool OpenXRCompositionLayer::is_viewport_in_use(SubViewport *p_viewport) {286ERR_FAIL_NULL_V(p_viewport, false);287for (const OpenXRCompositionLayer *other_composition_layer : composition_layer_nodes) {288if (other_composition_layer != this && other_composition_layer->is_inside_tree() && other_composition_layer->get_layer_viewport() == p_viewport) {289return true;290}291}292return false;293}294295void OpenXRCompositionLayer::set_layer_viewport(SubViewport *p_viewport) {296if (layer_viewport == p_viewport) {297return;298}299300if (p_viewport != nullptr) {301ERR_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."));302}303if (use_android_surface) {304ERR_FAIL_COND_MSG(p_viewport != nullptr, RTR("Cannot set SubViewport on an OpenXR composition layer when using an Android surface."));305}306307layer_viewport = p_viewport;308if (_should_register()) {309_setup_composition_layer_provider();310}311312if (layer_viewport) {313SubViewport::UpdateMode update_mode = layer_viewport->get_update_mode();314if (update_mode == SubViewport::UPDATE_WHEN_VISIBLE || update_mode == SubViewport::UPDATE_WHEN_PARENT_VISIBLE) {315WARN_PRINT_ONCE("OpenXR composition layers cannot use SubViewports with UPDATE_WHEN_VISIBLE or UPDATE_WHEN_PARENT_VISIBLE. Switching to UPDATE_ALWAYS.");316layer_viewport->set_update_mode(SubViewport::UPDATE_ALWAYS);317}318}319320if (fallback) {321_reset_fallback_material();322} else if (openxr_session_running && is_visible() && is_inside_tree()) {323if (layer_viewport) {324openxr_layer_provider->set_viewport(layer_viewport->get_viewport_rid(), layer_viewport->get_size());325} else {326openxr_layer_provider->set_viewport(RID(), Size2i());327}328}329}330331void OpenXRCompositionLayer::set_use_android_surface(bool p_use_android_surface) {332if (use_android_surface == p_use_android_surface) {333return;334}335336use_android_surface = p_use_android_surface;337if (use_android_surface) {338// It's possible that the layer provider is unregistered here (if previously invisible)339set_layer_viewport(nullptr);340openxr_layer_provider->set_use_android_surface(true, android_surface_size);341// ...and it may not be set up above because of viewport = null, android surface is false, so set it up again:342if (_should_register()) {343_setup_composition_layer_provider();344}345} else {346openxr_layer_provider->set_use_android_surface(false, Size2i());347}348349notify_property_list_changed();350}351352bool OpenXRCompositionLayer::get_use_android_surface() const {353return use_android_surface;354}355356void OpenXRCompositionLayer::set_android_surface_size(Size2i p_size) {357if (android_surface_size == p_size) {358return;359}360361android_surface_size = p_size;362if (use_android_surface) {363openxr_layer_provider->set_use_android_surface(true, android_surface_size);364}365}366367Size2i OpenXRCompositionLayer::get_android_surface_size() const {368return android_surface_size;369}370371SubViewport *OpenXRCompositionLayer::get_layer_viewport() const {372return layer_viewport;373}374375void OpenXRCompositionLayer::set_enable_hole_punch(bool p_enable) {376if (enable_hole_punch == p_enable) {377return;378}379380enable_hole_punch = p_enable;381if (_should_use_fallback_node()) {382if (fallback) {383_reset_fallback_material();384} else {385_create_fallback_node();386}387} else if (fallback) {388_remove_fallback_node();389}390391update_configuration_warnings();392}393394bool OpenXRCompositionLayer::get_enable_hole_punch() const {395return enable_hole_punch;396}397398void OpenXRCompositionLayer::set_sort_order(int p_order) {399openxr_layer_provider->set_sort_order(p_order);400update_configuration_warnings();401}402403int OpenXRCompositionLayer::get_sort_order() const {404return openxr_layer_provider->get_sort_order();405}406407void OpenXRCompositionLayer::set_alpha_blend(bool p_alpha_blend) {408openxr_layer_provider->set_alpha_blend(p_alpha_blend);409if (fallback) {410_reset_fallback_material();411}412}413414bool OpenXRCompositionLayer::get_alpha_blend() const {415return openxr_layer_provider->get_alpha_blend();416}417418bool OpenXRCompositionLayer::is_natively_supported() const {419if (composition_layer_extension && openxr_api) {420return composition_layer_extension->is_available(openxr_layer_provider->get_openxr_type());421}422return false;423}424425void OpenXRCompositionLayer::set_protected_content(bool p_protected_content) {426openxr_layer_provider->set_protected_content(p_protected_content);427}428429bool OpenXRCompositionLayer::is_protected_content() const {430return openxr_layer_provider->is_protected_content();431}432433void OpenXRCompositionLayer::set_min_filter(Filter p_mode) {434if (swapchain_state->min_filter == (OpenXRViewportCompositionLayerProvider::Filter)p_mode) {435return;436}437438swapchain_state->min_filter = (OpenXRViewportCompositionLayerProvider::Filter)p_mode;439swapchain_state->dirty = true;440}441442OpenXRCompositionLayer::Filter OpenXRCompositionLayer::get_min_filter() const {443return (OpenXRCompositionLayer::Filter)swapchain_state->min_filter;444}445446void OpenXRCompositionLayer::set_mag_filter(Filter p_mode) {447if (swapchain_state->mag_filter == (OpenXRViewportCompositionLayerProvider::Filter)p_mode) {448return;449}450451swapchain_state->mag_filter = (OpenXRViewportCompositionLayerProvider::Filter)p_mode;452swapchain_state->dirty = true;453}454455OpenXRCompositionLayer::Filter OpenXRCompositionLayer::get_mag_filter() const {456return (OpenXRCompositionLayer::Filter)swapchain_state->mag_filter;457}458459void OpenXRCompositionLayer::set_mipmap_mode(MipmapMode p_mode) {460if (swapchain_state->mipmap_mode == (OpenXRViewportCompositionLayerProvider::MipmapMode)p_mode) {461return;462}463464swapchain_state->mipmap_mode = (OpenXRViewportCompositionLayerProvider::MipmapMode)p_mode;465swapchain_state->dirty = true;466}467468OpenXRCompositionLayer::MipmapMode OpenXRCompositionLayer::get_mipmap_mode() const {469return (OpenXRCompositionLayer::MipmapMode)swapchain_state->mipmap_mode;470}471472void OpenXRCompositionLayer::set_horizontal_wrap(Wrap p_mode) {473if (swapchain_state->horizontal_wrap == (OpenXRViewportCompositionLayerProvider::Wrap)p_mode) {474return;475}476477swapchain_state->horizontal_wrap = (OpenXRViewportCompositionLayerProvider::Wrap)p_mode;478swapchain_state->dirty = true;479}480481OpenXRCompositionLayer::Wrap OpenXRCompositionLayer::get_horizontal_wrap() const {482return (OpenXRCompositionLayer::Wrap)swapchain_state->horizontal_wrap;483}484485void OpenXRCompositionLayer::set_vertical_wrap(Wrap p_mode) {486if (swapchain_state->vertical_wrap == (OpenXRViewportCompositionLayerProvider::Wrap)p_mode) {487return;488}489490swapchain_state->vertical_wrap = (OpenXRViewportCompositionLayerProvider::Wrap)p_mode;491swapchain_state->dirty = true;492}493494OpenXRCompositionLayer::Wrap OpenXRCompositionLayer::get_vertical_wrap() const {495return (OpenXRCompositionLayer::Wrap)swapchain_state->vertical_wrap;496}497498void OpenXRCompositionLayer::set_red_swizzle(Swizzle p_mode) {499if (swapchain_state->red_swizzle == (OpenXRViewportCompositionLayerProvider::Swizzle)p_mode) {500return;501}502503swapchain_state->red_swizzle = (OpenXRViewportCompositionLayerProvider::Swizzle)p_mode;504swapchain_state->dirty = true;505}506507OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_red_swizzle() const {508return (OpenXRCompositionLayer::Swizzle)swapchain_state->red_swizzle;509}510511void OpenXRCompositionLayer::set_green_swizzle(Swizzle p_mode) {512if (swapchain_state->green_swizzle == (OpenXRViewportCompositionLayerProvider::Swizzle)p_mode) {513return;514}515516swapchain_state->green_swizzle = (OpenXRViewportCompositionLayerProvider::Swizzle)p_mode;517swapchain_state->dirty = true;518}519520OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_green_swizzle() const {521return (OpenXRCompositionLayer::Swizzle)swapchain_state->green_swizzle;522}523524void OpenXRCompositionLayer::set_blue_swizzle(Swizzle p_mode) {525if (swapchain_state->blue_swizzle == (OpenXRViewportCompositionLayerProvider::Swizzle)p_mode) {526return;527}528529swapchain_state->blue_swizzle = (OpenXRViewportCompositionLayerProvider::Swizzle)p_mode;530swapchain_state->dirty = true;531}532533OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_blue_swizzle() const {534return (OpenXRCompositionLayer::Swizzle)swapchain_state->blue_swizzle;535}536537void OpenXRCompositionLayer::set_alpha_swizzle(Swizzle p_mode) {538if (swapchain_state->alpha_swizzle == (OpenXRViewportCompositionLayerProvider::Swizzle)p_mode) {539return;540}541542swapchain_state->alpha_swizzle = (OpenXRViewportCompositionLayerProvider::Swizzle)p_mode;543swapchain_state->dirty = true;544}545546OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_alpha_swizzle() const {547return (OpenXRCompositionLayer::Swizzle)swapchain_state->alpha_swizzle;548}549550void OpenXRCompositionLayer::set_max_anisotropy(float p_value) {551if (swapchain_state->max_anisotropy == p_value) {552return;553}554555swapchain_state->max_anisotropy = p_value;556swapchain_state->dirty = true;557}558559float OpenXRCompositionLayer::get_max_anisotropy() const {560return swapchain_state->max_anisotropy;561}562563void OpenXRCompositionLayer::set_border_color(Color p_color) {564if (swapchain_state->border_color == p_color) {565return;566}567568swapchain_state->border_color = p_color;569swapchain_state->dirty = true;570}571572Color OpenXRCompositionLayer::get_border_color() const {573return swapchain_state->border_color;574}575576Ref<JavaObject> OpenXRCompositionLayer::get_android_surface() {577return openxr_layer_provider->get_android_surface();578}579580Vector2 OpenXRCompositionLayer::intersects_ray(const Vector3 &p_origin, const Vector3 &p_direction) const {581return Vector2(-1.0, -1.0);582}583584void OpenXRCompositionLayer::_reset_fallback_material() {585ERR_FAIL_NULL(fallback);586587if (fallback->get_mesh().is_null()) {588return;589}590591if (enable_hole_punch && !Engine::get_singleton()->is_editor_hint() && is_natively_supported()) {592Ref<ShaderMaterial> material = fallback->get_surface_override_material(0);593if (material.is_null()) {594Ref<Shader> shader;595shader.instantiate();596shader->set_code(HOLE_PUNCH_SHADER_CODE);597598material.instantiate();599material->set_shader(shader);600601fallback->set_surface_override_material(0, material);602}603} else if (layer_viewport) {604Ref<StandardMaterial3D> material = fallback->get_surface_override_material(0);605if (material.is_null()) {606material.instantiate();607material->set_shading_mode(StandardMaterial3D::SHADING_MODE_UNSHADED);608material->set_local_to_scene(true);609fallback->set_surface_override_material(0, material);610}611612material->set_flag(StandardMaterial3D::FLAG_DISABLE_DEPTH_TEST, !enable_hole_punch);613material->set_transparency(get_alpha_blend() ? StandardMaterial3D::TRANSPARENCY_ALPHA : StandardMaterial3D::TRANSPARENCY_DISABLED);614material->set_texture(StandardMaterial3D::TEXTURE_ALBEDO, layer_viewport->get_texture());615} else {616fallback->set_surface_override_material(0, Ref<Material>());617}618}619620void OpenXRCompositionLayer::_notification(int p_what) {621switch (p_what) {622case NOTIFICATION_POSTINITIALIZE: {623composition_layer_nodes.push_back(this);624625for (OpenXRExtensionWrapper *extension : OpenXRAPI::get_registered_extension_wrappers()) {626extension_property_values.merge(extension->get_viewport_composition_layer_extension_property_defaults());627}628openxr_layer_provider->set_extension_property_values(extension_property_values);629} break;630case NOTIFICATION_INTERNAL_PROCESS: {631if (fallback) {632if (should_update_fallback_mesh) {633fallback->set_mesh(_create_fallback_mesh());634_reset_fallback_material();635should_update_fallback_mesh = false;636}637}638} break;639case NOTIFICATION_VISIBILITY_CHANGED: {640if (is_natively_supported() && openxr_session_running && is_inside_tree()) {641if (is_visible()) {642_setup_composition_layer_provider();643} else {644_clear_composition_layer_provider();645}646}647update_configuration_warnings();648} break;649case NOTIFICATION_LOCAL_TRANSFORM_CHANGED: {650update_configuration_warnings();651} break;652case NOTIFICATION_ENTER_TREE: {653if (layer_viewport && is_viewport_in_use(layer_viewport)) {654_clear_composition_layer_provider();655} else if (openxr_session_running && is_visible()) {656_setup_composition_layer_provider();657}658} break;659case NOTIFICATION_EXIT_TREE: {660// This will clean up existing resources.661_clear_composition_layer_provider();662} break;663}664}665666void OpenXRCompositionLayer::_get_property_list(List<PropertyInfo> *p_property_list) const {667List<PropertyInfo> extension_properties;668for (OpenXRExtensionWrapper *extension : OpenXRAPI::get_registered_extension_wrappers()) {669extension->get_viewport_composition_layer_extension_properties(&extension_properties);670}671672for (const PropertyInfo &pinfo : extension_properties) {673StringName prop_name = pinfo.name;674if (!String(prop_name).contains_char('/')) {675WARN_PRINT_ONCE(vformat("Discarding OpenXRCompositionLayer property name '%s' from extension because it doesn't contain a '/'."));676continue;677}678p_property_list->push_back(pinfo);679}680}681682bool OpenXRCompositionLayer::_get(const StringName &p_property, Variant &r_value) const {683if (extension_property_values.has(p_property)) {684r_value = extension_property_values[p_property];685return true;686}687688return false;689}690691bool OpenXRCompositionLayer::_set(const StringName &p_property, const Variant &p_value) {692extension_property_values[p_property] = p_value;693694openxr_layer_provider->set_extension_property_values(extension_property_values);695696return true;697}698699void OpenXRCompositionLayer::_validate_property(PropertyInfo &p_property) const {700if (!Engine::get_singleton()->is_editor_hint()) {701return;702}703if (p_property.name == "layer_viewport") {704if (use_android_surface) {705p_property.usage &= ~PROPERTY_USAGE_EDITOR;706} else {707p_property.usage |= PROPERTY_USAGE_EDITOR;708}709} else if (p_property.name == "android_surface_size") {710if (use_android_surface) {711p_property.usage |= PROPERTY_USAGE_EDITOR;712} else {713p_property.usage &= ~PROPERTY_USAGE_EDITOR;714}715}716}717718PackedStringArray OpenXRCompositionLayer::get_configuration_warnings() const {719PackedStringArray warnings = Node3D::get_configuration_warnings();720721if (is_visible() && is_inside_tree()) {722XROrigin3D *origin = Object::cast_to<XROrigin3D>(get_parent());723if (origin == nullptr) {724warnings.push_back(RTR("OpenXR composition layers must have an XROrigin3D node as their parent."));725}726}727728if (!get_transform().basis.is_orthonormal()) {729warnings.push_back(RTR("OpenXR composition layers must have orthonormalized transforms (ie. no scale or shearing)."));730}731732if (enable_hole_punch && get_sort_order() >= 0) {733warnings.push_back(RTR("Hole punching won't work as expected unless the sort order is less than zero."));734}735736return warnings;737}738739740