Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
godotengine
GitHub Repository: godotengine/godot
Path: blob/master/servers/display/display_server_headless.h
21400 views
1
/**************************************************************************/
2
/* display_server_headless.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 "core/input/input.h"
34
#include "servers/display/display_server.h"
35
36
#include "servers/rendering/dummy/rasterizer_dummy.h"
37
38
class DisplayServerHeadless : public DisplayServer {
39
GDSOFTCLASS(DisplayServerHeadless, DisplayServer);
40
41
private:
42
friend class DisplayServer;
43
44
static Vector<String> get_rendering_drivers_func() {
45
Vector<String> drivers;
46
drivers.push_back("dummy");
47
return drivers;
48
}
49
50
static DisplayServer *create_func(const String &p_rendering_driver, DisplayServer::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) {
51
r_error = OK;
52
RasterizerDummy::make_current();
53
return memnew(DisplayServerHeadless());
54
}
55
56
static void _dispatch_input_events(const Ref<InputEvent> &p_event) {
57
static_cast<DisplayServerHeadless *>(get_singleton())->_dispatch_input_event(p_event);
58
}
59
60
void _dispatch_input_event(const Ref<InputEvent> &p_event) {
61
if (input_event_callback.is_valid()) {
62
input_event_callback.call(p_event);
63
}
64
}
65
66
NativeMenu *native_menu = nullptr;
67
Callable input_event_callback;
68
69
public:
70
bool has_feature(Feature p_feature) const override { return false; }
71
String get_name() const override { return "headless"; }
72
73
// Stub implementations to prevent warnings from being printed for methods
74
// that don't affect the project's behavior in headless mode.
75
76
int get_screen_count() const override { return 0; }
77
int get_primary_screen() const override { return 0; }
78
Point2i screen_get_position(int p_screen = SCREEN_OF_MAIN_WINDOW) const override { return Point2i(); }
79
Size2i screen_get_size(int p_screen = SCREEN_OF_MAIN_WINDOW) const override { return Size2i(); }
80
Rect2i screen_get_usable_rect(int p_screen = SCREEN_OF_MAIN_WINDOW) const override { return Rect2i(); }
81
int screen_get_dpi(int p_screen = SCREEN_OF_MAIN_WINDOW) const override { return 96; /* 0 might cause issues */ }
82
float screen_get_scale(int p_screen = SCREEN_OF_MAIN_WINDOW) const override { return 1; }
83
float screen_get_max_scale() const override { return 1; }
84
float screen_get_refresh_rate(int p_screen = SCREEN_OF_MAIN_WINDOW) const override { return SCREEN_REFRESH_RATE_FALLBACK; }
85
void screen_set_orientation(ScreenOrientation p_orientation, int p_screen = SCREEN_OF_MAIN_WINDOW) override {}
86
void screen_set_keep_on(bool p_enable) override {}
87
88
Vector<DisplayServer::WindowID> get_window_list() const override { return Vector<DisplayServer::WindowID>(); }
89
90
WindowID create_sub_window(WindowMode p_mode, VSyncMode p_vsync_mode, uint32_t p_flags, const Rect2i &p_rect = Rect2i(), bool p_exclusive = false, WindowID p_transient_parent = INVALID_WINDOW_ID) override { return 0; }
91
void show_window(WindowID p_id) override {}
92
void delete_sub_window(WindowID p_id) override {}
93
94
WindowID get_window_at_screen_position(const Point2i &p_position) const override { return 0; }
95
96
void window_attach_instance_id(ObjectID p_instance, WindowID p_window = MAIN_WINDOW_ID) override {}
97
ObjectID window_get_attached_instance_id(WindowID p_window = MAIN_WINDOW_ID) const override { return ObjectID(); }
98
99
void window_set_rect_changed_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override {}
100
101
void window_set_window_event_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override {}
102
103
void window_set_input_event_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override {
104
input_event_callback = p_callable;
105
}
106
107
void window_set_input_text_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override {}
108
void window_set_drop_files_callback(const Callable &p_callable, WindowID p_window = MAIN_WINDOW_ID) override {}
109
110
void window_set_title(const String &p_title, WindowID p_window = MAIN_WINDOW_ID) override {}
111
112
void window_set_mouse_passthrough(const Vector<Vector2> &p_region, WindowID p_window = MAIN_WINDOW_ID) override {}
113
114
int window_get_current_screen(WindowID p_window = MAIN_WINDOW_ID) const override { return INVALID_SCREEN; }
115
void window_set_current_screen(int p_screen, WindowID p_window = MAIN_WINDOW_ID) override {}
116
117
Point2i window_get_position(WindowID p_window = MAIN_WINDOW_ID) const override { return Point2i(); }
118
Point2i window_get_position_with_decorations(WindowID p_window = MAIN_WINDOW_ID) const override { return Point2i(); }
119
void window_set_position(const Point2i &p_position, WindowID p_window = MAIN_WINDOW_ID) override {}
120
121
void window_set_transient(WindowID p_window, WindowID p_parent) override {}
122
123
void window_set_max_size(const Size2i p_size, WindowID p_window = MAIN_WINDOW_ID) override {}
124
Size2i window_get_max_size(WindowID p_window = MAIN_WINDOW_ID) const override { return Size2i(); }
125
126
void window_set_min_size(const Size2i p_size, WindowID p_window = MAIN_WINDOW_ID) override {}
127
Size2i window_get_min_size(WindowID p_window = MAIN_WINDOW_ID) const override { return Size2i(); }
128
129
void window_set_size(const Size2i p_size, WindowID p_window = MAIN_WINDOW_ID) override {}
130
Size2i window_get_size(WindowID p_window = MAIN_WINDOW_ID) const override { return Size2i(); }
131
Size2i window_get_size_with_decorations(WindowID p_window = MAIN_WINDOW_ID) const override { return Size2i(); }
132
133
void window_set_mode(WindowMode p_mode, WindowID p_window = MAIN_WINDOW_ID) override {}
134
WindowMode window_get_mode(WindowID p_window = MAIN_WINDOW_ID) const override { return WINDOW_MODE_MINIMIZED; }
135
136
void window_set_vsync_mode(VSyncMode p_vsync_mode, WindowID p_window = MAIN_WINDOW_ID) override {}
137
VSyncMode window_get_vsync_mode(WindowID p_window) const override { return VSyncMode::VSYNC_ENABLED; }
138
139
bool window_is_maximize_allowed(WindowID p_window = MAIN_WINDOW_ID) const override { return false; }
140
141
void window_set_flag(WindowFlags p_flag, bool p_enabled, WindowID p_window = MAIN_WINDOW_ID) override {}
142
bool window_get_flag(WindowFlags p_flag, WindowID p_window = MAIN_WINDOW_ID) const override { return false; }
143
144
void window_request_attention(WindowID p_window = MAIN_WINDOW_ID) override {}
145
void window_move_to_foreground(WindowID p_window = MAIN_WINDOW_ID) override {}
146
bool window_is_focused(WindowID p_window = MAIN_WINDOW_ID) const override { return true; }
147
148
bool window_can_draw(WindowID p_window = MAIN_WINDOW_ID) const override { return false; }
149
150
bool can_any_window_draw() const override { return false; }
151
152
void window_set_ime_active(const bool p_active, WindowID p_window = MAIN_WINDOW_ID) override {}
153
void window_set_ime_position(const Point2i &p_pos, WindowID p_window = MAIN_WINDOW_ID) override {}
154
155
int64_t window_get_native_handle(HandleType p_handle_type, WindowID p_window = MAIN_WINDOW_ID) const override { return 0; }
156
157
void process_events() override {
158
Input::get_singleton()->flush_buffered_events();
159
}
160
161
void set_native_icon(const String &p_filename) override {}
162
void set_icon(const Ref<Image> &p_icon) override {}
163
164
void help_set_search_callbacks(const Callable &p_search_callback = Callable(), const Callable &p_action_callback = Callable()) override {}
165
166
bool tts_is_speaking() const override { return false; }
167
bool tts_is_paused() const override { return false; }
168
TypedArray<Dictionary> tts_get_voices() const override { return TypedArray<Dictionary>(); }
169
void tts_speak(const String &p_text, const String &p_voice, int p_volume = 50, float p_pitch = 1.0f, float p_rate = 1.0f, int64_t p_utterance_id = 0, bool p_interrupt = false) override {}
170
void tts_pause() override {}
171
void tts_resume() override {}
172
void tts_stop() override {}
173
174
void mouse_set_mode(MouseMode p_mode) override {}
175
void mouse_set_mode_override(MouseMode p_mode) override {}
176
void mouse_set_mode_override_enabled(bool p_override_enabled) override {}
177
Point2i mouse_get_position() const override { return Point2i(); }
178
void clipboard_set(const String &p_text) override {}
179
void clipboard_set_primary(const String &p_text) override {}
180
181
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 {}
182
void virtual_keyboard_hide() override {}
183
184
void cursor_set_shape(CursorShape p_shape) override {}
185
void cursor_set_custom_image(const Ref<Resource> &p_cursor, CursorShape p_shape = CURSOR_ARROW, const Vector2 &p_hotspot = Vector2()) override {}
186
187
Error dialog_show(String p_title, String p_description, Vector<String> p_buttons, const Callable &p_callback) override { return ERR_UNAVAILABLE; }
188
Error dialog_input_text(String p_title, String p_description, String p_partial, const Callable &p_callback) override { return ERR_UNAVAILABLE; }
189
Error file_dialog_show(const String &p_title, const String &p_current_directory, const String &p_filename, bool p_show_hidden, FileDialogMode p_mode, const Vector<String> &p_filters, const Callable &p_callback, WindowID p_window_id) override { return ERR_UNAVAILABLE; }
190
Error file_dialog_with_options_show(const String &p_title, const String &p_current_directory, const String &p_root, const String &p_filename, bool p_show_hidden, FileDialogMode p_mode, const Vector<String> &p_filters, const TypedArray<Dictionary> &p_options, const Callable &p_callback, WindowID p_window_id) override { return ERR_UNAVAILABLE; }
191
192
void release_rendering_thread() override {}
193
void swap_buffers() override {}
194
195
IndicatorID create_status_indicator(const Ref<Texture2D> &p_icon, const String &p_tooltip, const Callable &p_callback) override { return INVALID_INDICATOR_ID; }
196
void status_indicator_set_icon(IndicatorID p_id, const Ref<Texture2D> &p_icon) override {}
197
void status_indicator_set_tooltip(IndicatorID p_id, const String &p_tooltip) override {}
198
void status_indicator_set_callback(IndicatorID p_id, const Callable &p_callback) override {}
199
void delete_status_indicator(IndicatorID p_id) override {}
200
201
DisplayServerHeadless() {
202
native_menu = memnew(NativeMenu);
203
Input::get_singleton()->set_event_dispatch_function(_dispatch_input_events);
204
}
205
206
~DisplayServerHeadless() {
207
if (native_menu) {
208
memdelete(native_menu);
209
native_menu = nullptr;
210
}
211
}
212
};
213
214