1/**************************************************************************/
2/* mobile_vr_interface.h */
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#ifndef MOBILE_VR_INTERFACE_H
32#define MOBILE_VR_INTERFACE_H
33
34#include "servers/xr/xr_interface.h"
35#include "servers/xr/xr_positional_tracker.h"
36
37/**
38 The mobile interface is a native VR interface that can be used on Android and iOS phones.
39 It contains a basic implementation supporting 3DOF tracking if a gyroscope and accelerometer are
40 present and sets up the proper projection matrices based on the values provided.
41
42 We're planning to eventually do separate interfaces towards mobile SDKs that have far more capabilities and
43 do not rely on the user providing most of these settings (though enhancing this with auto detection features
44 based on the device we're running on would be cool). I'm mostly adding this as an example or base plate for
45 more advanced interfaces.
46*/
47
48class MobileVRInterface : public XRInterface {
49 GDCLASS(MobileVRInterface, XRInterface);
50
51private:
52 bool initialized = false;
53 XRInterface::TrackingStatus tracking_state;
54 XRPose::TrackingConfidence tracking_confidence = XRPose::XR_TRACKING_CONFIDENCE_NONE;
55
56 // Just set some defaults for these. At some point we need to look at adding a lookup table for common device + headset combos and/or support reading cardboard QR codes
57 double eye_height = 1.85;
58 uint64_t last_ticks = 0;
59
60 double intraocular_dist = 6.0;
61 double display_width = 14.5;
62 double display_to_lens = 4.0;
63 double oversample = 1.5;
64
65 double k1 = 0.215;
66 double k2 = 0.215;
67 double aspect = 1.0;
68
69 // at a minimum we need a tracker for our head
70 Ref<XRPositionalTracker> head;
71 Transform3D head_transform;
72
73 /*
74 logic for processing our sensor data, this was originally in our positional tracker logic but I think
75 that doesn't make sense in hindsight. It only makes marginally more sense to park it here for now,
76 this probably deserves an object of its own
77 */
78 Vector3 scale_magneto(const Vector3 &p_magnetometer);
79 Basis combine_acc_mag(const Vector3 &p_grav, const Vector3 &p_magneto);
80
81 int mag_count = 0;
82 bool has_gyro = false;
83 bool sensor_first = false;
84 Vector3 last_accerometer_data;
85 Vector3 last_magnetometer_data;
86 Vector3 mag_current_min;
87 Vector3 mag_current_max;
88 Vector3 mag_next_min;
89 Vector3 mag_next_max;
90
91 ///@TODO a few support functions for trackers, most are math related and should likely be moved elsewhere
92 float floor_decimals(const float p_value, const float p_decimals) {
93 float power_of_10 = pow(10.0f, p_decimals);
94 return floor(p_value * power_of_10) / power_of_10;
95 };
96
97 Vector3 floor_decimals(const Vector3 &p_vector, const float p_decimals) {
98 return Vector3(floor_decimals(p_vector.x, p_decimals), floor_decimals(p_vector.y, p_decimals), floor_decimals(p_vector.z, p_decimals));
99 };
100
101 Vector3 low_pass(const Vector3 &p_vector, const Vector3 &p_last_vector, const float p_factor) {
102 return p_vector + (p_factor * (p_last_vector - p_vector));
103 };
104
105 Vector3 scrub(const Vector3 &p_vector, const Vector3 &p_last_vector, const float p_decimals, const float p_factor) {
106 return low_pass(floor_decimals(p_vector, p_decimals), p_last_vector, p_factor);
107 };
108
109 void set_position_from_sensors();
110
111protected:
112 static void _bind_methods();
113
114public:
115 void set_eye_height(const double p_eye_height);
116 double get_eye_height() const;
117
118 void set_iod(const double p_iod);
119 double get_iod() const;
120
121 void set_display_width(const double p_display_width);
122 double get_display_width() const;
123
124 void set_display_to_lens(const double p_display_to_lens);
125 double get_display_to_lens() const;
126
127 void set_oversample(const double p_oversample);
128 double get_oversample() const;
129
130 void set_k1(const double p_k1);
131 double get_k1() const;
132
133 void set_k2(const double p_k2);
134 double get_k2() const;
135
136 virtual StringName get_name() const override;
137 virtual uint32_t get_capabilities() const override;
138
139 virtual TrackingStatus get_tracking_status() const override;
140
141 virtual bool is_initialized() const override;
142 virtual bool initialize() override;
143 virtual void uninitialize() override;
144 virtual Dictionary get_system_info() override;
145
146 virtual bool supports_play_area_mode(XRInterface::PlayAreaMode p_mode) override;
147 virtual XRInterface::PlayAreaMode get_play_area_mode() const override;
148 virtual bool set_play_area_mode(XRInterface::PlayAreaMode p_mode) override;
149
150 virtual Size2 get_render_target_size() override;
151 virtual uint32_t get_view_count() override;
152 virtual Transform3D get_camera_transform() override;
153 virtual Transform3D get_transform_for_view(uint32_t p_view, const Transform3D &p_cam_transform) override;
154 virtual Projection get_projection_for_view(uint32_t p_view, double p_aspect, double p_z_near, double p_z_far) override;
155 virtual Vector<BlitToScreen> post_draw_viewport(RID p_render_target, const Rect2 &p_screen_rect) override;
156
157 virtual void process() override;
158
159 MobileVRInterface();
160 ~MobileVRInterface();
161};
162
163#endif // MOBILE_VR_INTERFACE_H
164