Path: blob/master/modules/openxr/scene/openxr_composition_layer.cpp
21087 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 "../extensions/openxr_composition_layer_extension.h"33#include "../openxr_api.h"34#include "../openxr_interface.h"3536#include "scene/3d/mesh_instance_3d.h"37#include "scene/3d/xr/xr_nodes.h"38#include "scene/main/viewport.h"3940#include "platform/android/api/java_class_wrapper.h"4142Vector<OpenXRCompositionLayer *> OpenXRCompositionLayer::composition_layer_nodes;4344static const char *HOLE_PUNCH_SHADER_CODE =45"shader_type spatial;\n"46"render_mode blend_mix, depth_draw_opaque, cull_back, shadow_to_opacity, shadows_disabled;\n"47"void fragment() {\n"48"\tALBEDO = vec3(0.0, 0.0, 0.0);\n"49"}\n";5051OpenXRCompositionLayer::OpenXRCompositionLayer() {52openxr_api = OpenXRAPI::get_singleton();53composition_layer_extension = OpenXRCompositionLayerExtension::get_singleton();5455if (openxr_api) {56openxr_session_running = openxr_api->is_running();57}5859Ref<OpenXRInterface> openxr_interface = XRServer::get_singleton()->find_interface("OpenXR");60if (openxr_interface.is_valid()) {61openxr_interface->connect("session_begun", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_begun));62openxr_interface->connect("session_stopping", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_stopping));63}6465XRServer::get_singleton()->connect("reference_frame_changed", callable_mp(this, &OpenXRCompositionLayer::update_transform));6667set_process_internal(true);68set_notify_local_transform(true);6970if (Engine::get_singleton()->is_editor_hint()) {71// In the editor, create the fallback right away.72_create_fallback_node();73}74}7576OpenXRCompositionLayer::~OpenXRCompositionLayer() {77Ref<OpenXRInterface> openxr_interface = XRServer::get_singleton()->find_interface("OpenXR");78if (openxr_interface.is_valid()) {79openxr_interface->disconnect("session_begun", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_begun));80openxr_interface->disconnect("session_stopping", callable_mp(this, &OpenXRCompositionLayer::_on_openxr_session_stopping));81}8283composition_layer_nodes.erase(this);8485if (composition_layer_extension && composition_layer.is_valid()) {86composition_layer_extension->composition_layer_free(composition_layer);87}88}8990void OpenXRCompositionLayer::_bind_methods() {91ClassDB::bind_method(D_METHOD("set_layer_viewport", "viewport"), &OpenXRCompositionLayer::set_layer_viewport);92ClassDB::bind_method(D_METHOD("get_layer_viewport"), &OpenXRCompositionLayer::get_layer_viewport);9394ClassDB::bind_method(D_METHOD("set_use_android_surface", "enable"), &OpenXRCompositionLayer::set_use_android_surface);95ClassDB::bind_method(D_METHOD("get_use_android_surface"), &OpenXRCompositionLayer::get_use_android_surface);9697ClassDB::bind_method(D_METHOD("set_android_surface_size", "size"), &OpenXRCompositionLayer::set_android_surface_size);98ClassDB::bind_method(D_METHOD("get_android_surface_size"), &OpenXRCompositionLayer::get_android_surface_size);99100ClassDB::bind_method(D_METHOD("set_enable_hole_punch", "enable"), &OpenXRCompositionLayer::set_enable_hole_punch);101ClassDB::bind_method(D_METHOD("get_enable_hole_punch"), &OpenXRCompositionLayer::get_enable_hole_punch);102103ClassDB::bind_method(D_METHOD("set_sort_order", "order"), &OpenXRCompositionLayer::set_sort_order);104ClassDB::bind_method(D_METHOD("get_sort_order"), &OpenXRCompositionLayer::get_sort_order);105106ClassDB::bind_method(D_METHOD("set_alpha_blend", "enabled"), &OpenXRCompositionLayer::set_alpha_blend);107ClassDB::bind_method(D_METHOD("get_alpha_blend"), &OpenXRCompositionLayer::get_alpha_blend);108109ClassDB::bind_method(D_METHOD("get_android_surface"), &OpenXRCompositionLayer::get_android_surface);110ClassDB::bind_method(D_METHOD("is_natively_supported"), &OpenXRCompositionLayer::is_natively_supported);111112ClassDB::bind_method(D_METHOD("is_protected_content"), &OpenXRCompositionLayer::is_protected_content);113ClassDB::bind_method(D_METHOD("set_protected_content", "protected_content"), &OpenXRCompositionLayer::set_protected_content);114115ClassDB::bind_method(D_METHOD("set_min_filter", "mode"), &OpenXRCompositionLayer::set_min_filter);116ClassDB::bind_method(D_METHOD("get_min_filter"), &OpenXRCompositionLayer::get_min_filter);117118ClassDB::bind_method(D_METHOD("set_mag_filter", "mode"), &OpenXRCompositionLayer::set_mag_filter);119ClassDB::bind_method(D_METHOD("get_mag_filter"), &OpenXRCompositionLayer::get_mag_filter);120121ClassDB::bind_method(D_METHOD("set_mipmap_mode", "mode"), &OpenXRCompositionLayer::set_mipmap_mode);122ClassDB::bind_method(D_METHOD("get_mipmap_mode"), &OpenXRCompositionLayer::get_mipmap_mode);123124ClassDB::bind_method(D_METHOD("set_horizontal_wrap", "mode"), &OpenXRCompositionLayer::set_horizontal_wrap);125ClassDB::bind_method(D_METHOD("get_horizontal_wrap"), &OpenXRCompositionLayer::get_horizontal_wrap);126127ClassDB::bind_method(D_METHOD("set_vertical_wrap", "mode"), &OpenXRCompositionLayer::set_vertical_wrap);128ClassDB::bind_method(D_METHOD("get_vertical_wrap"), &OpenXRCompositionLayer::get_vertical_wrap);129130ClassDB::bind_method(D_METHOD("set_red_swizzle", "mode"), &OpenXRCompositionLayer::set_red_swizzle);131ClassDB::bind_method(D_METHOD("get_red_swizzle"), &OpenXRCompositionLayer::get_red_swizzle);132133ClassDB::bind_method(D_METHOD("set_green_swizzle", "mode"), &OpenXRCompositionLayer::set_green_swizzle);134ClassDB::bind_method(D_METHOD("get_green_swizzle"), &OpenXRCompositionLayer::get_green_swizzle);135136ClassDB::bind_method(D_METHOD("set_blue_swizzle", "mode"), &OpenXRCompositionLayer::set_blue_swizzle);137ClassDB::bind_method(D_METHOD("get_blue_swizzle"), &OpenXRCompositionLayer::get_blue_swizzle);138139ClassDB::bind_method(D_METHOD("set_alpha_swizzle", "mode"), &OpenXRCompositionLayer::set_alpha_swizzle);140ClassDB::bind_method(D_METHOD("get_alpha_swizzle"), &OpenXRCompositionLayer::get_alpha_swizzle);141142ClassDB::bind_method(D_METHOD("set_max_anisotropy", "value"), &OpenXRCompositionLayer::set_max_anisotropy);143ClassDB::bind_method(D_METHOD("get_max_anisotropy"), &OpenXRCompositionLayer::get_max_anisotropy);144145ClassDB::bind_method(D_METHOD("set_border_color", "color"), &OpenXRCompositionLayer::set_border_color);146ClassDB::bind_method(D_METHOD("get_border_color"), &OpenXRCompositionLayer::get_border_color);147148ClassDB::bind_method(D_METHOD("set_eye_visibility", "eye_visibility"), &OpenXRCompositionLayer::set_eye_visibility);149ClassDB::bind_method(D_METHOD("get_eye_visibility"), &OpenXRCompositionLayer::get_eye_visibility);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");160ADD_PROPERTY(PropertyInfo(Variant::INT, "eye_visibility", PROPERTY_HINT_ENUM, "Both,Left,Right"), "set_eye_visibility", "get_eye_visibility");161162ADD_GROUP("Swapchain State", "swapchain_state_");163ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_min_filter", PROPERTY_HINT_ENUM, "Nearest,Linear,Cubic"), "set_min_filter", "get_min_filter");164ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_mag_filter", PROPERTY_HINT_ENUM, "Nearest,Linear,Cubic"), "set_mag_filter", "get_mag_filter");165ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_mipmap_mode", PROPERTY_HINT_ENUM, "Disabled,Nearest,Linear"), "set_mipmap_mode", "get_mipmap_mode");166ADD_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");167ADD_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");168ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_red_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_red_swizzle", "get_red_swizzle");169ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_green_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_green_swizzle", "get_green_swizzle");170ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_blue_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_blue_swizzle", "get_blue_swizzle");171ADD_PROPERTY(PropertyInfo(Variant::INT, "swapchain_state_alpha_swizzle", PROPERTY_HINT_ENUM, "Red,Green,Blue,Alpha,Zero,One"), "set_alpha_swizzle", "get_alpha_swizzle");172ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "swapchain_state_max_anisotropy", PROPERTY_HINT_RANGE, "1.0,16.0,0.001"), "set_max_anisotropy", "get_max_anisotropy");173ADD_PROPERTY(PropertyInfo(Variant::COLOR, "swapchain_state_border_color"), "set_border_color", "get_border_color");174ADD_GROUP("", "");175176BIND_ENUM_CONSTANT(FILTER_NEAREST);177BIND_ENUM_CONSTANT(FILTER_LINEAR);178BIND_ENUM_CONSTANT(FILTER_CUBIC);179180BIND_ENUM_CONSTANT(MIPMAP_MODE_DISABLED);181BIND_ENUM_CONSTANT(MIPMAP_MODE_NEAREST);182BIND_ENUM_CONSTANT(MIPMAP_MODE_LINEAR);183184BIND_ENUM_CONSTANT(WRAP_CLAMP_TO_BORDER);185BIND_ENUM_CONSTANT(WRAP_CLAMP_TO_EDGE);186BIND_ENUM_CONSTANT(WRAP_REPEAT);187BIND_ENUM_CONSTANT(WRAP_MIRRORED_REPEAT);188BIND_ENUM_CONSTANT(WRAP_MIRROR_CLAMP_TO_EDGE);189190BIND_ENUM_CONSTANT(SWIZZLE_RED);191BIND_ENUM_CONSTANT(SWIZZLE_GREEN);192BIND_ENUM_CONSTANT(SWIZZLE_BLUE);193BIND_ENUM_CONSTANT(SWIZZLE_ALPHA);194BIND_ENUM_CONSTANT(SWIZZLE_ZERO);195BIND_ENUM_CONSTANT(SWIZZLE_ONE);196197BIND_ENUM_CONSTANT(EYE_VISIBILITY_BOTH);198BIND_ENUM_CONSTANT(EYE_VISIBILITY_LEFT);199BIND_ENUM_CONSTANT(EYE_VISIBILITY_RIGHT);200}201202bool OpenXRCompositionLayer::_should_use_fallback_node() {203if (Engine::get_singleton()->is_editor_hint() || openxr_api == nullptr) {204return true;205} else if (openxr_session_running) {206return enable_hole_punch || (!is_natively_supported() && !use_android_surface);207}208return false;209}210211void OpenXRCompositionLayer::_create_fallback_node() {212ERR_FAIL_COND(fallback);213fallback = memnew(MeshInstance3D);214fallback->set_cast_shadows_setting(GeometryInstance3D::SHADOW_CASTING_SETTING_OFF);215add_child(fallback, false, INTERNAL_MODE_FRONT);216should_update_fallback_mesh = true;217}218219void OpenXRCompositionLayer::_remove_fallback_node() {220ERR_FAIL_COND(fallback != nullptr);221remove_child(fallback);222fallback->queue_free();223fallback = nullptr;224}225226void OpenXRCompositionLayer::_setup_composition_layer() {227if (use_android_surface || layer_viewport) {228if (composition_layer_extension) {229composition_layer_extension->composition_layer_register(composition_layer);230registered = true;231232// NOTE: We don't setup/clear when using Android surfaces, so we don't destroy the surface unexpectedly.233if (layer_viewport) {234// Set our properties on the layer provider, which will create all the necessary resources (ex swap chains).235composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());236}237}238}239}240241void OpenXRCompositionLayer::_clear_composition_layer() {242if (composition_layer_extension) {243composition_layer_extension->composition_layer_unregister(composition_layer);244registered = false;245246// NOTE: We don't setup/clear when using Android surfaces, so we don't destroy the surface unexpectedly.247if (!use_android_surface) {248// This will reset the viewport and free all the resources (ex swap chains) used by the layer.249composition_layer_extension->composition_layer_set_viewport(composition_layer, RID(), Size2i());250}251}252}253254void OpenXRCompositionLayer::_viewport_size_changed() {255if (layer_viewport && openxr_session_running && composition_layer_extension && is_natively_supported() && is_visible() && is_inside_tree()) {256composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());257}258}259260void OpenXRCompositionLayer::_on_openxr_session_begun() {261openxr_session_running = true;262if (_should_register()) {263_setup_composition_layer();264}265if (!fallback && _should_use_fallback_node()) {266_create_fallback_node();267}268}269270void OpenXRCompositionLayer::_on_openxr_session_stopping() {271openxr_session_running = false;272if (fallback && !_should_use_fallback_node()) {273_remove_fallback_node();274}275_clear_composition_layer();276}277278void OpenXRCompositionLayer::update_transform() {279if (composition_layer_extension) {280bool parent_is_xr_camera = Object::cast_to<XRCamera3D>(get_parent()) != nullptr;281OpenXRCompositionLayerExtension::PoseSpace new_pose_space;282283// Automatically set the PoseSpace to POSE_HEAD_LOCKED if layer is a child of XRCamera3D.284if (parent_is_xr_camera) {285new_pose_space = OpenXRCompositionLayerExtension::PoseSpace::POSE_HEAD_LOCKED;286} else {287new_pose_space = OpenXRCompositionLayerExtension::PoseSpace::POSE_WORLD_LOCKED;288}289290// Pose space must be set first, as composition_layer_set_transform() depends on it.291composition_layer_extension->composition_layer_set_pose_space(composition_layer, new_pose_space);292composition_layer_extension->composition_layer_set_transform(composition_layer, get_transform());293}294}295296void OpenXRCompositionLayer::update_fallback_mesh() {297should_update_fallback_mesh = true;298}299300bool OpenXRCompositionLayer::_should_register() {301return !registered && openxr_session_running && is_inside_tree() && is_visible() && is_natively_supported();302}303304bool OpenXRCompositionLayer::is_viewport_in_use(SubViewport *p_viewport) {305ERR_FAIL_NULL_V(p_viewport, false);306for (const OpenXRCompositionLayer *other_composition_layer : composition_layer_nodes) {307if (other_composition_layer != this && other_composition_layer->is_inside_tree() && other_composition_layer->get_layer_viewport() == p_viewport) {308return true;309}310}311return false;312}313314void OpenXRCompositionLayer::set_layer_viewport(SubViewport *p_viewport) {315if (layer_viewport == p_viewport) {316return;317}318319if (p_viewport != nullptr) {320ERR_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."));321}322if (use_android_surface) {323ERR_FAIL_COND_MSG(p_viewport != nullptr, RTR("Cannot set SubViewport on an OpenXR composition layer when using an Android surface."));324}325326if (layer_viewport) {327layer_viewport->disconnect("size_changed", callable_mp(this, &OpenXRCompositionLayer::_viewport_size_changed));328}329330layer_viewport = p_viewport;331if (_should_register()) {332_setup_composition_layer();333}334335if (layer_viewport) {336layer_viewport->connect("size_changed", callable_mp(this, &OpenXRCompositionLayer::_viewport_size_changed));337338SubViewport::UpdateMode update_mode = layer_viewport->get_update_mode();339if (update_mode == SubViewport::UPDATE_WHEN_VISIBLE || update_mode == SubViewport::UPDATE_WHEN_PARENT_VISIBLE) {340WARN_PRINT_ONCE("OpenXR composition layers cannot use SubViewports with UPDATE_WHEN_VISIBLE or UPDATE_WHEN_PARENT_VISIBLE. Switching to UPDATE_ALWAYS.");341layer_viewport->set_update_mode(SubViewport::UPDATE_ALWAYS);342}343}344345if (fallback) {346_reset_fallback_material();347} else if (openxr_session_running && composition_layer_extension && is_visible() && is_inside_tree()) {348if (layer_viewport) {349composition_layer_extension->composition_layer_set_viewport(composition_layer, layer_viewport->get_viewport_rid(), layer_viewport->get_size());350} else {351composition_layer_extension->composition_layer_set_viewport(composition_layer, RID(), Size2i());352}353}354}355356void OpenXRCompositionLayer::set_use_android_surface(bool p_use_android_surface) {357if (use_android_surface == p_use_android_surface) {358return;359}360361use_android_surface = p_use_android_surface;362if (use_android_surface) {363// It's possible that the layer provider is unregistered here (if previously invisible)364set_layer_viewport(nullptr);365if (composition_layer_extension) {366composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, true, android_surface_size);367}368// ...and it may not be set up above because of viewport = null, android surface is false, so set it up again:369if (_should_register()) {370_setup_composition_layer();371}372} else {373if (composition_layer_extension) {374composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, false, Size2i());375}376}377378notify_property_list_changed();379}380381bool OpenXRCompositionLayer::get_use_android_surface() const {382return use_android_surface;383}384385void OpenXRCompositionLayer::set_android_surface_size(Size2i p_size) {386if (android_surface_size == p_size) {387return;388}389390android_surface_size = p_size;391if (use_android_surface && composition_layer_extension) {392composition_layer_extension->composition_layer_set_use_android_surface(composition_layer, true, android_surface_size);393}394}395396Size2i OpenXRCompositionLayer::get_android_surface_size() const {397return android_surface_size;398}399400SubViewport *OpenXRCompositionLayer::get_layer_viewport() const {401return layer_viewport;402}403404void OpenXRCompositionLayer::set_enable_hole_punch(bool p_enable) {405if (enable_hole_punch == p_enable) {406return;407}408409enable_hole_punch = p_enable;410if (_should_use_fallback_node()) {411if (fallback) {412_reset_fallback_material();413} else {414_create_fallback_node();415}416} else if (fallback) {417_remove_fallback_node();418}419420update_configuration_warnings();421}422423bool OpenXRCompositionLayer::get_enable_hole_punch() const {424return enable_hole_punch;425}426427void OpenXRCompositionLayer::set_sort_order(int p_order) {428sort_order = p_order;429if (composition_layer_extension) {430composition_layer_extension->composition_layer_set_sort_order(composition_layer, p_order);431}432update_configuration_warnings();433}434435int OpenXRCompositionLayer::get_sort_order() const {436return sort_order;437}438439void OpenXRCompositionLayer::set_alpha_blend(bool p_alpha_blend) {440alpha_blend = p_alpha_blend;441if (composition_layer_extension) {442composition_layer_extension->composition_layer_set_alpha_blend(composition_layer, p_alpha_blend);443}444if (fallback) {445_reset_fallback_material();446}447}448449bool OpenXRCompositionLayer::get_alpha_blend() const {450return alpha_blend;451}452453bool OpenXRCompositionLayer::is_natively_supported() const {454if (composition_layer_extension && openxr_api) {455return composition_layer_extension->is_available(_get_openxr_type());456}457return false;458}459460void OpenXRCompositionLayer::set_protected_content(bool p_protected_content) {461if (protected_content == p_protected_content) {462return;463}464protected_content = p_protected_content;465if (composition_layer_extension) {466composition_layer_extension->composition_layer_set_protected_content(composition_layer, p_protected_content);467}468}469470bool OpenXRCompositionLayer::is_protected_content() const {471return protected_content;472}473474void OpenXRCompositionLayer::set_min_filter(Filter p_mode) {475if (min_filter == p_mode) {476return;477}478min_filter = p_mode;479if (composition_layer_extension) {480composition_layer_extension->composition_layer_set_min_filter(composition_layer, (OpenXRCompositionLayerExtension::Filter)p_mode);481}482}483484OpenXRCompositionLayer::Filter OpenXRCompositionLayer::get_min_filter() const {485return min_filter;486}487488void OpenXRCompositionLayer::set_mag_filter(Filter p_mode) {489if (mag_filter == p_mode) {490return;491}492mag_filter = p_mode;493if (composition_layer_extension) {494composition_layer_extension->composition_layer_set_mag_filter(composition_layer, (OpenXRCompositionLayerExtension::Filter)p_mode);495}496}497498OpenXRCompositionLayer::Filter OpenXRCompositionLayer::get_mag_filter() const {499return mag_filter;500}501502void OpenXRCompositionLayer::set_mipmap_mode(MipmapMode p_mode) {503if (mipmap_mode == p_mode) {504return;505}506mipmap_mode = p_mode;507if (composition_layer_extension) {508composition_layer_extension->composition_layer_set_mipmap_mode(composition_layer, (OpenXRCompositionLayerExtension::MipmapMode)p_mode);509}510}511512OpenXRCompositionLayer::MipmapMode OpenXRCompositionLayer::get_mipmap_mode() const {513return mipmap_mode;514}515516void OpenXRCompositionLayer::set_horizontal_wrap(Wrap p_mode) {517if (horizontal_wrap == p_mode) {518return;519}520horizontal_wrap = p_mode;521if (composition_layer_extension) {522composition_layer_extension->composition_layer_set_horizontal_wrap(composition_layer, (OpenXRCompositionLayerExtension::Wrap)p_mode);523}524}525526OpenXRCompositionLayer::Wrap OpenXRCompositionLayer::get_horizontal_wrap() const {527return horizontal_wrap;528}529530void OpenXRCompositionLayer::set_vertical_wrap(Wrap p_mode) {531if (vertical_wrap == p_mode) {532return;533}534vertical_wrap = p_mode;535if (composition_layer_extension) {536composition_layer_extension->composition_layer_set_vertical_wrap(composition_layer, (OpenXRCompositionLayerExtension::Wrap)p_mode);537}538}539540OpenXRCompositionLayer::Wrap OpenXRCompositionLayer::get_vertical_wrap() const {541return vertical_wrap;542}543544void OpenXRCompositionLayer::set_red_swizzle(Swizzle p_mode) {545if (red_swizzle == p_mode) {546return;547}548red_swizzle = p_mode;549if (composition_layer_extension) {550composition_layer_extension->composition_layer_set_red_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);551}552}553554OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_red_swizzle() const {555return red_swizzle;556}557558void OpenXRCompositionLayer::set_green_swizzle(Swizzle p_mode) {559if (green_swizzle == p_mode) {560return;561}562green_swizzle = p_mode;563if (composition_layer_extension) {564composition_layer_extension->composition_layer_set_green_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);565}566}567568OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_green_swizzle() const {569return green_swizzle;570}571572void OpenXRCompositionLayer::set_blue_swizzle(Swizzle p_mode) {573if (blue_swizzle == p_mode) {574return;575}576blue_swizzle = p_mode;577if (composition_layer_extension) {578composition_layer_extension->composition_layer_set_blue_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);579}580}581582OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_blue_swizzle() const {583return blue_swizzle;584}585586void OpenXRCompositionLayer::set_alpha_swizzle(Swizzle p_mode) {587if (alpha_swizzle == p_mode) {588return;589}590alpha_swizzle = p_mode;591if (composition_layer_extension) {592composition_layer_extension->composition_layer_set_alpha_swizzle(composition_layer, (OpenXRCompositionLayerExtension::Swizzle)p_mode);593}594}595596OpenXRCompositionLayer::Swizzle OpenXRCompositionLayer::get_alpha_swizzle() const {597return alpha_swizzle;598}599600void OpenXRCompositionLayer::set_max_anisotropy(float p_value) {601if (max_anisotropy == p_value) {602return;603}604max_anisotropy = p_value;605if (composition_layer_extension) {606composition_layer_extension->composition_layer_set_max_anisotropy(composition_layer, p_value);607}608}609610float OpenXRCompositionLayer::get_max_anisotropy() const {611return max_anisotropy;612}613614void OpenXRCompositionLayer::set_border_color(const Color &p_color) {615if (border_color == p_color) {616return;617}618border_color = p_color;619if (composition_layer_extension) {620composition_layer_extension->composition_layer_set_border_color(composition_layer, p_color);621}622}623624Color OpenXRCompositionLayer::get_border_color() const {625return border_color;626}627628void OpenXRCompositionLayer::set_eye_visibility(EyeVisibility p_eye_visibility) {629if (eye_visibility == p_eye_visibility) {630return;631}632eye_visibility = p_eye_visibility;633if (composition_layer_extension) {634composition_layer_extension->composition_layer_set_eye_visibility(composition_layer, (OpenXRCompositionLayerExtension::EyeVisibility)p_eye_visibility);635}636}637638OpenXRCompositionLayer::EyeVisibility OpenXRCompositionLayer::get_eye_visibility() const {639return eye_visibility;640}641642Ref<JavaObject> OpenXRCompositionLayer::get_android_surface() {643if (composition_layer_extension) {644return composition_layer_extension->composition_layer_get_android_surface(composition_layer);645}646return Ref<JavaObject>();647}648649Vector2 OpenXRCompositionLayer::intersects_ray(const Vector3 &p_origin, const Vector3 &p_direction) const {650return Vector2(-1.0, -1.0);651}652653void OpenXRCompositionLayer::_reset_fallback_material() {654ERR_FAIL_NULL(fallback);655656if (fallback->get_mesh().is_null()) {657return;658}659660if (enable_hole_punch && !Engine::get_singleton()->is_editor_hint() && is_natively_supported()) {661Ref<ShaderMaterial> material = fallback->get_surface_override_material(0);662if (material.is_null()) {663Ref<Shader> shader;664shader.instantiate();665shader->set_code(HOLE_PUNCH_SHADER_CODE);666667material.instantiate();668material->set_shader(shader);669670fallback->set_surface_override_material(0, material);671}672} else if (layer_viewport) {673Ref<StandardMaterial3D> material = fallback->get_surface_override_material(0);674if (material.is_null()) {675material.instantiate();676material->set_shading_mode(StandardMaterial3D::SHADING_MODE_UNSHADED);677material->set_local_to_scene(true);678fallback->set_surface_override_material(0, material);679}680681material->set_flag(StandardMaterial3D::FLAG_DISABLE_DEPTH_TEST, !enable_hole_punch);682material->set_transparency(get_alpha_blend() ? StandardMaterial3D::TRANSPARENCY_ALPHA : StandardMaterial3D::TRANSPARENCY_DISABLED);683material->set_texture(StandardMaterial3D::TEXTURE_ALBEDO, layer_viewport->get_texture());684} else {685fallback->set_surface_override_material(0, Ref<Material>());686}687}688689void OpenXRCompositionLayer::_notification(int p_what) {690switch (p_what) {691case NOTIFICATION_POSTINITIALIZE: {692composition_layer_nodes.push_back(this);693694for (OpenXRExtensionWrapper *extension : OpenXRAPI::get_registered_extension_wrappers()) {695extension_property_values.merge(extension->get_viewport_composition_layer_extension_property_defaults());696}697if (composition_layer_extension) {698composition_layer_extension->composition_layer_set_extension_property_values(composition_layer, extension_property_values);699}700} break;701case NOTIFICATION_INTERNAL_PROCESS: {702if (fallback) {703if (should_update_fallback_mesh) {704fallback->set_mesh(_create_fallback_mesh());705_reset_fallback_material();706should_update_fallback_mesh = false;707}708}709} break;710case NOTIFICATION_VISIBILITY_CHANGED: {711if (is_natively_supported() && openxr_session_running && is_inside_tree()) {712if (is_visible()) {713_setup_composition_layer();714update_transform();715} else {716_clear_composition_layer();717}718}719update_configuration_warnings();720} break;721case NOTIFICATION_LOCAL_TRANSFORM_CHANGED: {722update_transform();723update_configuration_warnings();724} break;725case NOTIFICATION_ENTER_TREE: {726if (layer_viewport && is_viewport_in_use(layer_viewport)) {727_clear_composition_layer();728} else if (openxr_session_running && is_visible()) {729_setup_composition_layer();730}731update_transform();732} break;733case NOTIFICATION_PARENTED: {734update_transform();735} break;736case NOTIFICATION_EXIT_TREE: {737// This will clean up existing resources.738_clear_composition_layer();739} break;740}741}742743void OpenXRCompositionLayer::_get_property_list(List<PropertyInfo> *p_property_list) const {744List<PropertyInfo> extension_properties;745for (OpenXRExtensionWrapper *extension : OpenXRAPI::get_registered_extension_wrappers()) {746extension->get_viewport_composition_layer_extension_properties(&extension_properties);747}748749for (const PropertyInfo &pinfo : extension_properties) {750StringName prop_name = pinfo.name;751if (!String(prop_name).contains_char('/')) {752WARN_PRINT_ONCE(vformat("Discarding OpenXRCompositionLayer property name '%s' from extension because it doesn't contain a '/'."));753continue;754}755p_property_list->push_back(pinfo);756}757}758759bool OpenXRCompositionLayer::_get(const StringName &p_property, Variant &r_value) const {760if (extension_property_values.has(p_property)) {761r_value = extension_property_values[p_property];762return true;763}764765return false;766}767768bool OpenXRCompositionLayer::_set(const StringName &p_property, const Variant &p_value) {769extension_property_values[p_property] = p_value;770771if (composition_layer_extension) {772composition_layer_extension->composition_layer_set_extension_property_values(composition_layer, extension_property_values);773}774775return true;776}777778void OpenXRCompositionLayer::_validate_property(PropertyInfo &p_property) const {779if (!Engine::get_singleton()->is_editor_hint()) {780return;781}782if (p_property.name == "layer_viewport") {783if (use_android_surface) {784p_property.usage &= ~PROPERTY_USAGE_EDITOR;785} else {786p_property.usage |= PROPERTY_USAGE_EDITOR;787}788} else if (p_property.name == "android_surface_size") {789if (use_android_surface) {790p_property.usage |= PROPERTY_USAGE_EDITOR;791} else {792p_property.usage &= ~PROPERTY_USAGE_EDITOR;793}794}795}796797PackedStringArray OpenXRCompositionLayer::get_configuration_warnings() const {798PackedStringArray warnings = Node3D::get_configuration_warnings();799800if (is_visible() && is_inside_tree()) {801XROrigin3D *xr_origin = Object::cast_to<XROrigin3D>(get_parent());802XRCamera3D *xr_camera = Object::cast_to<XRCamera3D>(get_parent());803804if (xr_origin == nullptr && xr_camera == nullptr) {805warnings.push_back(RTR("OpenXR composition layers must have have either an XROrigin3D or XRCamera3D node as their parent."));806}807}808809if (!get_transform().basis.is_orthonormal()) {810warnings.push_back(RTR("OpenXR composition layers must have orthonormalized transforms (ie. no scale or shearing)."));811}812813if (enable_hole_punch && get_sort_order() >= 0) {814warnings.push_back(RTR("Hole punching won't work as expected unless the sort order is less than zero."));815}816817return warnings;818}819820821