Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
godotengine
GitHub Repository: godotengine/godot
Path: blob/master/platform/android/display_server_android.h
10277 views
1
/**************************************************************************/
2
/* display_server_android.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
#pragma once
32
33
#include "servers/display_server.h"
34
35
#if defined(RD_ENABLED)
36
class RenderingContextDriver;
37
class RenderingDevice;
38
#endif
39
40
class DisplayServerAndroid : public DisplayServer {
41
GDSOFTCLASS(DisplayServerAndroid, DisplayServer);
42
43
String rendering_driver;
44
45
// https://developer.android.com/reference/android/view/PointerIcon
46
// mapping between Godot's cursor shape to Android's'
47
int android_cursors[CURSOR_MAX] = {
48
1000, //CURSOR_ARROW
49
1008, //CURSOR_IBEAM
50
1002, //CURSOR_POINTIN
51
1007, //CURSOR_CROSS
52
1004, //CURSOR_WAIT
53
1004, //CURSOR_BUSY
54
1021, //CURSOR_DRAG
55
1021, //CURSOR_CAN_DRO
56
1000, //CURSOR_FORBIDD (no corresponding icon in Android's icon so fallback to default)
57
1015, //CURSOR_VSIZE
58
1014, //CURSOR_HSIZE
59
1017, //CURSOR_BDIAGSI
60
1016, //CURSOR_FDIAGSI
61
1020, //CURSOR_MOVE
62
1015, //CURSOR_VSPLIT
63
1014, //CURSOR_HSPLIT
64
1003, //CURSOR_HELP
65
};
66
const int CURSOR_TYPE_NULL = 0;
67
MouseMode mouse_mode = MouseMode::MOUSE_MODE_VISIBLE;
68
MouseMode mouse_mode_base = MouseMode::MOUSE_MODE_VISIBLE;
69
MouseMode mouse_mode_override = MouseMode::MOUSE_MODE_VISIBLE;
70
bool mouse_mode_override_enabled = false;
71
void _mouse_update_mode();
72
73
bool keep_screen_on;
74
bool swap_buffers_flag;
75
76
CursorShape cursor_shape = CursorShape::CURSOR_ARROW;
77
78
#if defined(RD_ENABLED)
79
RenderingContextDriver *rendering_context = nullptr;
80
RenderingDevice *rendering_device = nullptr;
81
#endif
82
NativeMenu *native_menu = nullptr;
83
84
ObjectID window_attached_instance_id;
85
86
Callable window_event_callback;
87
Callable input_event_callback;
88
Callable input_text_callback;
89
Callable rect_changed_callback;
90
91
Callable system_theme_changed;
92
Callable hardware_keyboard_connection_changed;
93
94
Callable dialog_callback;
95
Callable input_dialog_callback;
96
97
Callable file_picker_callback;
98
99
void _window_callback(const Callable &p_callable, const Variant &p_arg, bool p_deferred = false) const;
100
101
static void _dispatch_input_events(const Ref<InputEvent> &p_event);
102
103
public:
104
static DisplayServerAndroid *get_singleton();
105
106
virtual bool has_feature(Feature p_feature) const override;
107
virtual String get_name() const override;
108
109
virtual bool tts_is_speaking() const override;
110
virtual bool tts_is_paused() const override;
111
virtual TypedArray<Dictionary> tts_get_voices() const override;
112
113
virtual void tts_speak(const String &p_text, const String &p_voice, int p_volume = 50, float p_pitch = 1.f, float p_rate = 1.f, int p_utterance_id = 0, bool p_interrupt = false) override;
114
virtual void tts_pause() override;
115
virtual void tts_resume() override;
116
virtual void tts_stop() override;
117
118
virtual bool is_dark_mode_supported() const override;
119
virtual bool is_dark_mode() const override;
120
virtual void set_system_theme_change_callback(const Callable &p_callable) override;
121
void emit_system_theme_changed();
122
123
virtual void clipboard_set(const String &p_text) override;
124
virtual String clipboard_get() const override;
125
virtual bool clipboard_has() const override;
126
127
virtual Error dialog_show(String p_title, String p_description, Vector<String> p_buttons, const Callable &p_callback) override;
128
void emit_dialog_callback(int p_button_index);
129
130
virtual Error dialog_input_text(String p_title, String p_description, String p_partial, const Callable &p_callback) override;
131
void emit_input_dialog_callback(String p_text);
132
133
virtual Error file_dialog_show(const String &p_title, const String &p_current_directory, const String &p_filename, bool p_show_hidden, const FileDialogMode p_mode, const Vector<String> &p_filters, const Callable &p_callback, WindowID p_window_id) override;
134
void emit_file_picker_callback(bool p_ok, const Vector<String> &p_selected_paths);
135
136
virtual Color get_accent_color() const override;
137
virtual Color get_base_color() const override;
138
139
virtual TypedArray<Rect2> get_display_cutouts() const override;
140
virtual Rect2i get_display_safe_area() const override;
141
142
virtual void screen_set_keep_on(bool p_enable) override;
143
virtual bool screen_is_kept_on() const override;
144
145
virtual void screen_set_orientation(ScreenOrientation p_orientation, int p_screen = SCREEN_OF_MAIN_WINDOW) override;
146
virtual ScreenOrientation screen_get_orientation(int p_screen = SCREEN_OF_MAIN_WINDOW) const override;
147
int get_display_rotation() const;
148
149
virtual int get_screen_count() const override;
150
virtual int get_primary_screen() const override;
151
virtual Point2i screen_get_position(int p_screen = SCREEN_OF_MAIN_WINDOW) const override;
152
virtual Size2i screen_get_size(int p_screen = SCREEN_OF_MAIN_WINDOW) const override;
153
virtual Rect2i screen_get_usable_rect(int p_screen = SCREEN_OF_MAIN_WINDOW) const override;
154
virtual int screen_get_dpi(int p_screen = SCREEN_OF_MAIN_WINDOW) const override;
155
virtual float screen_get_scale(int p_screen = SCREEN_OF_MAIN_WINDOW) const override;
156
virtual float screen_get_refresh_rate(int p_screen = SCREEN_OF_MAIN_WINDOW) const override;
157
virtual bool is_touchscreen_available() const override;
158
159
virtual void virtual_keyboard_show(const String &p_existing_text, const Rect2 &p_screen_rect = Rect2(), VirtualKeyboardType p_type = KEYBOARD_TYPE_DEFAULT, int p_max_length = -1, int p_cursor_start = -1, int p_cursor_end = -1) override;
160
virtual void virtual_keyboard_hide() override;
161
virtual int virtual_keyboard_get_height() const override;
162
virtual bool has_hardware_keyboard() const override;
163
virtual void set_hardware_keyboard_connection_change_callback(const Callable &p_callable) override;
164
void emit_hardware_keyboard_connection_changed(bool p_connected);
165
166
virtual void window_set_window_event_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override;
167
virtual void window_set_input_event_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override;
168
virtual void window_set_input_text_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override;
169
virtual void window_set_rect_changed_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override;
170
virtual void window_set_drop_files_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override;
171
172
void send_window_event(WindowEvent p_event, bool p_deferred = false) const;
173
void send_input_event(const Ref<InputEvent> &p_event) const;
174
void send_input_text(const String &p_text) const;
175
176
virtual Vector<WindowID> get_window_list() const override;
177
virtual WindowID get_window_at_screen_position(const Point2i &p_position) const override;
178
179
virtual int64_t window_get_native_handle(HandleType p_handle_type, WindowID p_window = MAIN_WINDOW_ID) const override;
180
181
virtual void window_attach_instance_id(ObjectID p_instance, WindowID p_window = MAIN_WINDOW_ID) override;
182
virtual ObjectID window_get_attached_instance_id(WindowID p_window = MAIN_WINDOW_ID) const override;
183
virtual void window_set_title(const String &p_title, WindowID p_window = MAIN_WINDOW_ID) override;
184
185
virtual int window_get_current_screen(WindowID p_window = MAIN_WINDOW_ID) const override;
186
virtual void window_set_current_screen(int p_screen, WindowID p_window = MAIN_WINDOW_ID) override;
187
188
virtual Point2i window_get_position(WindowID p_window = MAIN_WINDOW_ID) const override;
189
virtual Point2i window_get_position_with_decorations(WindowID p_window = MAIN_WINDOW_ID) const override;
190
virtual void window_set_position(const Point2i &p_position, WindowID p_window = MAIN_WINDOW_ID) override;
191
192
virtual void window_set_transient(WindowID p_window, WindowID p_parent) override;
193
194
virtual void window_set_max_size(const Size2i p_size, WindowID p_window = MAIN_WINDOW_ID) override;
195
virtual Size2i window_get_max_size(WindowID p_window = MAIN_WINDOW_ID) const override;
196
197
virtual void window_set_min_size(const Size2i p_size, WindowID p_window = MAIN_WINDOW_ID) override;
198
virtual Size2i window_get_min_size(WindowID p_window = MAIN_WINDOW_ID) const override;
199
200
virtual void window_set_size(const Size2i p_size, WindowID p_window = MAIN_WINDOW_ID) override;
201
virtual Size2i window_get_size(WindowID p_window = MAIN_WINDOW_ID) const override;
202
virtual Size2i window_get_size_with_decorations(WindowID p_window = MAIN_WINDOW_ID) const override;
203
204
virtual void window_set_mode(WindowMode p_mode, WindowID p_window = MAIN_WINDOW_ID) override;
205
virtual WindowMode window_get_mode(WindowID p_window = MAIN_WINDOW_ID) const override;
206
207
virtual bool window_is_maximize_allowed(WindowID p_window = MAIN_WINDOW_ID) const override;
208
209
virtual void window_set_flag(WindowFlags p_flag, bool p_enabled, WindowID p_window = MAIN_WINDOW_ID) override;
210
virtual bool window_get_flag(WindowFlags p_flag, WindowID p_window = MAIN_WINDOW_ID) const override;
211
212
virtual void window_request_attention(WindowID p_window = MAIN_WINDOW_ID) override;
213
virtual void window_move_to_foreground(WindowID p_window = MAIN_WINDOW_ID) override;
214
virtual bool window_is_focused(WindowID p_window = MAIN_WINDOW_ID) const override;
215
216
virtual bool window_can_draw(WindowID p_window = MAIN_WINDOW_ID) const override;
217
218
virtual bool can_any_window_draw() const override;
219
220
virtual void window_set_vsync_mode(DisplayServer::VSyncMode p_vsync_mode, WindowID p_window = MAIN_WINDOW_ID) override;
221
virtual DisplayServer::VSyncMode window_get_vsync_mode(WindowID p_vsync_mode) const override;
222
223
virtual void process_events() override;
224
225
void process_accelerometer(const Vector3 &p_accelerometer);
226
void process_gravity(const Vector3 &p_gravity);
227
void process_magnetometer(const Vector3 &p_magnetometer);
228
void process_gyroscope(const Vector3 &p_gyroscope);
229
230
void _cursor_set_shape_helper(CursorShape p_shape, bool force = false);
231
virtual void cursor_set_shape(CursorShape p_shape) override;
232
virtual CursorShape cursor_get_shape() const override;
233
virtual void cursor_set_custom_image(const Ref<Resource> &p_cursor, CursorShape p_shape = CURSOR_ARROW, const Vector2 &p_hotspot = Vector2()) override;
234
235
virtual void mouse_set_mode(MouseMode p_mode) override;
236
virtual MouseMode mouse_get_mode() const override;
237
virtual void mouse_set_mode_override(MouseMode p_mode) override;
238
virtual MouseMode mouse_get_mode_override() const override;
239
virtual void mouse_set_mode_override_enabled(bool p_override_enabled) override;
240
virtual bool mouse_is_mode_override_enabled() const override;
241
242
static DisplayServer *create_func(const String &p_rendering_driver, WindowMode p_mode, DisplayServer::VSyncMode p_vsync_mode, uint32_t p_flags, const Vector2i *p_position, const Vector2i &p_resolution, int p_screen, Context p_context, int64_t p_parent_window, Error &r_error);
243
static Vector<String> get_rendering_drivers_func();
244
static void register_android_driver();
245
246
void reset_window();
247
void notify_surface_changed(int p_width, int p_height);
248
249
virtual Point2i mouse_get_position() const override;
250
virtual BitField<MouseButtonMask> mouse_get_button_state() const override;
251
252
void reset_swap_buffers_flag();
253
bool should_swap_buffers() const;
254
virtual void swap_buffers() override;
255
256
virtual void set_native_icon(const String &p_filename) override;
257
virtual void set_icon(const Ref<Image> &p_icon) override;
258
259
virtual bool is_window_transparency_available() const override;
260
261
DisplayServerAndroid(const String &p_rendering_driver, WindowMode p_mode, DisplayServer::VSyncMode p_vsync_mode, uint32_t p_flags, const Vector2i *p_position, const Vector2i &p_resolution, int p_screen, Context p_context, int64_t p_parent_window, Error &r_error);
262
~DisplayServerAndroid();
263
};
264
265