/*************************************************************************/ /* xr_interface_extension.cpp */ /*************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /*************************************************************************/ /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */ /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */ /* */ /* Permission is hereby granted, free of charge, to any person obtaining */ /* a copy of this software and associated documentation files (the */ /* "Software"), to deal in the Software without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of the Software, and to */ /* permit persons to whom the Software is furnished to do so, subject to */ /* the following conditions: */ /* */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /*************************************************************************/ #include "xr_interface_extension.h" #include "servers/rendering/renderer_rd/storage_rd/texture_storage.h" #include "servers/rendering/rendering_server_globals.h" void XRInterfaceExtension::_bind_methods() { GDVIRTUAL_BIND(_get_name); GDVIRTUAL_BIND(_get_capabilities); GDVIRTUAL_BIND(_is_initialized); GDVIRTUAL_BIND(_initialize); GDVIRTUAL_BIND(_uninitialize); GDVIRTUAL_BIND(_supports_play_area_mode, "mode"); GDVIRTUAL_BIND(_get_play_area_mode); GDVIRTUAL_BIND(_set_play_area_mode, "mode"); GDVIRTUAL_BIND(_get_play_area); GDVIRTUAL_BIND(_get_render_target_size); GDVIRTUAL_BIND(_get_view_count); GDVIRTUAL_BIND(_get_camera_transform); GDVIRTUAL_BIND(_get_transform_for_view, "view", "cam_transform"); GDVIRTUAL_BIND(_get_projection_for_view, "view", "aspect", "z_near", "z_far"); GDVIRTUAL_BIND(_get_vrs_texture); GDVIRTUAL_BIND(_process); GDVIRTUAL_BIND(_pre_render); GDVIRTUAL_BIND(_pre_draw_viewport, "render_target"); GDVIRTUAL_BIND(_post_draw_viewport, "render_target", "screen_rect"); GDVIRTUAL_BIND(_end_frame); GDVIRTUAL_BIND(_notification, "what"); /** input and output **/ GDVIRTUAL_BIND(_get_suggested_tracker_names); GDVIRTUAL_BIND(_get_suggested_pose_names, "tracker_name"); GDVIRTUAL_BIND(_get_tracking_status); GDVIRTUAL_BIND(_trigger_haptic_pulse, "action_name", "tracker_name", "frequency", "amplitude", "duration_sec", "delay_sec"); // we don't have any properties specific to VR yet.... // but we do have properties specific to AR.... GDVIRTUAL_BIND(_get_anchor_detection_is_enabled); GDVIRTUAL_BIND(_set_anchor_detection_is_enabled, "enabled"); GDVIRTUAL_BIND(_get_camera_feed_id); // override output methods GDVIRTUAL_BIND(_get_color_texture); GDVIRTUAL_BIND(_get_depth_texture); GDVIRTUAL_BIND(_get_velocity_texture); ClassDB::bind_method(D_METHOD("get_color_texture"), &XRInterfaceExtension::get_color_texture); ClassDB::bind_method(D_METHOD("get_depth_texture"), &XRInterfaceExtension::get_depth_texture); ClassDB::bind_method(D_METHOD("get_velocity_texture"), &XRInterfaceExtension::get_velocity_texture); // helper methods ClassDB::bind_method(D_METHOD("add_blit", "render_target", "src_rect", "dst_rect", "use_layer", "layer", "apply_lens_distortion", "eye_center", "k1", "k2", "upscale", "aspect_ratio"), &XRInterfaceExtension::add_blit); ClassDB::bind_method(D_METHOD("get_render_target_texture", "render_target"), &XRInterfaceExtension::get_render_target_texture); // ClassDB::bind_method(D_METHOD("get_render_target_depth", "render_target"), &XRInterfaceExtension::get_render_target_depth); } StringName XRInterfaceExtension::get_name() const { StringName name; if (GDVIRTUAL_CALL(_get_name, name)) { return name; } return "Unknown"; } uint32_t XRInterfaceExtension::get_capabilities() const { uint32_t capabilities = 0; GDVIRTUAL_CALL(_get_capabilities, capabilities); return capabilities; } bool XRInterfaceExtension::is_initialized() const { bool initialised = false; GDVIRTUAL_CALL(_is_initialized, initialised); return initialised; } bool XRInterfaceExtension::initialize() { bool initialised = false; GDVIRTUAL_CALL(_initialize, initialised); return initialised; } void XRInterfaceExtension::uninitialize() { GDVIRTUAL_CALL(_uninitialize); } PackedStringArray XRInterfaceExtension::get_suggested_tracker_names() const { PackedStringArray arr; GDVIRTUAL_CALL(_get_suggested_tracker_names, arr); return arr; } PackedStringArray XRInterfaceExtension::get_suggested_pose_names(const StringName &p_tracker_name) const { PackedStringArray arr; GDVIRTUAL_CALL(_get_suggested_pose_names, p_tracker_name, arr); return arr; } XRInterface::TrackingStatus XRInterfaceExtension::get_tracking_status() const { uint32_t status = XR_UNKNOWN_TRACKING; GDVIRTUAL_CALL(_get_tracking_status, status); return TrackingStatus(status); } void XRInterfaceExtension::trigger_haptic_pulse(const String &p_action_name, const StringName &p_tracker_name, double p_frequency, double p_amplitude, double p_duration_sec, double p_delay_sec) { GDVIRTUAL_CALL(_trigger_haptic_pulse, p_action_name, p_tracker_name, p_frequency, p_amplitude, p_duration_sec, p_delay_sec); } bool XRInterfaceExtension::supports_play_area_mode(XRInterface::PlayAreaMode p_mode) { bool is_supported = false; GDVIRTUAL_CALL(_supports_play_area_mode, p_mode, is_supported); return is_supported; } XRInterface::PlayAreaMode XRInterfaceExtension::get_play_area_mode() const { uint32_t mode = XR_PLAY_AREA_UNKNOWN; GDVIRTUAL_CALL(_get_play_area_mode, mode); return XRInterface::PlayAreaMode(mode); } bool XRInterfaceExtension::set_play_area_mode(XRInterface::PlayAreaMode p_mode) { bool success = false; GDVIRTUAL_CALL(_set_play_area_mode, p_mode, success); return success; } PackedVector3Array XRInterfaceExtension::get_play_area() const { PackedVector3Array arr; GDVIRTUAL_CALL(_get_play_area, arr); return arr; } /** these will only be implemented on AR interfaces, so we want dummies for VR **/ bool XRInterfaceExtension::get_anchor_detection_is_enabled() const { bool enabled = false; GDVIRTUAL_CALL(_get_anchor_detection_is_enabled, enabled); return enabled; } void XRInterfaceExtension::set_anchor_detection_is_enabled(bool p_enable) { // don't do anything here, this needs to be implemented on AR interface to enable/disable things like plane detection etc. GDVIRTUAL_CALL(_set_anchor_detection_is_enabled, p_enable); } int XRInterfaceExtension::get_camera_feed_id() { int feed_id = 0; GDVIRTUAL_CALL(_get_camera_feed_id, feed_id); return feed_id; } Size2 XRInterfaceExtension::get_render_target_size() { Size2 size; GDVIRTUAL_CALL(_get_render_target_size, size); return size; } uint32_t XRInterfaceExtension::get_view_count() { uint32_t view_count = 1; GDVIRTUAL_CALL(_get_view_count, view_count); return view_count; } Transform3D XRInterfaceExtension::get_camera_transform() { Transform3D transform; GDVIRTUAL_CALL(_get_camera_transform, transform); return transform; } Transform3D XRInterfaceExtension::get_transform_for_view(uint32_t p_view, const Transform3D &p_cam_transform) { Transform3D transform; GDVIRTUAL_CALL(_get_transform_for_view, p_view, p_cam_transform, transform); return transform; } Projection XRInterfaceExtension::get_projection_for_view(uint32_t p_view, double p_aspect, double p_z_near, double p_z_far) { Projection cm; PackedFloat64Array arr; if (GDVIRTUAL_CALL(_get_projection_for_view, p_view, p_aspect, p_z_near, p_z_far, arr)) { ERR_FAIL_COND_V_MSG(arr.size() != 16, Projection(), "Projection matrix must contain 16 floats"); real_t *m = (real_t *)cm.columns; for (int i = 0; i < 16; i++) { m[i] = arr[i]; } return cm; } return Projection(); } RID XRInterfaceExtension::get_vrs_texture() { RID vrs_texture; if (GDVIRTUAL_CALL(_get_vrs_texture, vrs_texture)) { return vrs_texture; } else { return XRInterface::get_vrs_texture(); } } RID XRInterfaceExtension::get_color_texture() { RID texture; GDVIRTUAL_CALL(_get_color_texture, texture); return texture; } RID XRInterfaceExtension::get_depth_texture() { RID texture; GDVIRTUAL_CALL(_get_depth_texture, texture); return texture; } RID XRInterfaceExtension::get_velocity_texture() { RID texture; GDVIRTUAL_CALL(_get_velocity_texture, texture); return texture; } void XRInterfaceExtension::add_blit(RID p_render_target, Rect2 p_src_rect, Rect2i p_dst_rect, bool p_use_layer, uint32_t p_layer, bool p_apply_lens_distortion, Vector2 p_eye_center, double p_k1, double p_k2, double p_upscale, double p_aspect_ratio) { BlitToScreen blit; ERR_FAIL_COND_MSG(!can_add_blits, "add_blit can only be called from an XR plugin from within _post_draw_viewport!"); blit.render_target = p_render_target; blit.src_rect = p_src_rect; blit.dst_rect = p_dst_rect; blit.multi_view.use_layer = p_use_layer; blit.multi_view.layer = p_layer; blit.lens_distortion.apply = p_apply_lens_distortion; blit.lens_distortion.eye_center = p_eye_center; blit.lens_distortion.k1 = p_k1; blit.lens_distortion.k2 = p_k2; blit.lens_distortion.upscale = p_upscale; blit.lens_distortion.aspect_ratio = p_aspect_ratio; blits.push_back(blit); } void XRInterfaceExtension::process() { GDVIRTUAL_CALL(_process); } void XRInterfaceExtension::pre_render() { GDVIRTUAL_CALL(_pre_render); } bool XRInterfaceExtension::pre_draw_viewport(RID p_render_target) { bool do_render = true; GDVIRTUAL_CALL(_pre_draw_viewport, p_render_target, do_render); return do_render; // If not implemented we're returning true. } Vector XRInterfaceExtension::post_draw_viewport(RID p_render_target, const Rect2 &p_screen_rect) { // This is just so our XR plugin can add blits... blits.clear(); can_add_blits = true; if (GDVIRTUAL_CALL(_post_draw_viewport, p_render_target, p_screen_rect)) { return blits; } can_add_blits = false; return blits; } void XRInterfaceExtension::end_frame() { GDVIRTUAL_CALL(_end_frame); } void XRInterfaceExtension::notification(int p_what) { GDVIRTUAL_CALL(_notification, p_what); } RID XRInterfaceExtension::get_render_target_texture(RID p_render_target) { // In due time this will need to be enhance to return the correct INTERNAL RID for the chosen rendering engine. // So once a GLES driver is implemented we'll return that and the implemented plugin needs to handle this correctly too. RendererRD::TextureStorage *texture_storage = RendererRD::TextureStorage::get_singleton(); ERR_FAIL_NULL_V_MSG(texture_storage, RID(), "Texture storage not setup"); return texture_storage->render_target_get_rd_texture(p_render_target); } /* RID XRInterfaceExtension::get_render_target_depth(RID p_render_target) { // TODO implement this, the problem is that our depth texture isn't part of our render target as it is used for 3D rendering only // but we don't have access to our render buffers from here.... } */