2014-02-10 09:10:30 +08:00
|
|
|
/*************************************************************************/
|
|
|
|
/* os.cpp */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
2017-08-27 20:16:55 +08:00
|
|
|
/* https://godotengine.org */
|
2014-02-10 09:10:30 +08:00
|
|
|
/*************************************************************************/
|
2020-01-01 18:16:22 +08:00
|
|
|
/* Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md). */
|
2014-02-10 09:10:30 +08:00
|
|
|
/* */
|
|
|
|
/* 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. */
|
|
|
|
/*************************************************************************/
|
2018-01-05 07:50:27 +08:00
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
#include "os.h"
|
2017-01-14 01:25:43 +08:00
|
|
|
|
2018-09-12 00:13:45 +08:00
|
|
|
#include "core/os/dir_access.h"
|
|
|
|
#include "core/os/file_access.h"
|
|
|
|
#include "core/os/input.h"
|
|
|
|
#include "core/os/midi_driver.h"
|
|
|
|
#include "core/project_settings.h"
|
|
|
|
#include "core/version_generated.gen.h"
|
2018-03-05 01:18:05 +08:00
|
|
|
#include "servers/audio_server.h"
|
2017-01-14 01:25:43 +08:00
|
|
|
|
|
|
|
#include <stdarg.h>
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
OS *OS::singleton = NULL;
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
OS *OS::get_singleton() {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
return singleton;
|
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
uint32_t OS::get_ticks_msec() const {
|
|
|
|
return get_ticks_usec() / 1000;
|
|
|
|
}
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2019-03-29 21:53:11 +08:00
|
|
|
String OS::get_iso_date_time(bool local) const {
|
|
|
|
OS::Date date = get_date(local);
|
|
|
|
OS::Time time = get_time(local);
|
|
|
|
|
|
|
|
String timezone;
|
|
|
|
if (!local) {
|
|
|
|
TimeZoneInfo zone = get_time_zone_info();
|
|
|
|
if (zone.bias >= 0) {
|
|
|
|
timezone = "+";
|
|
|
|
}
|
|
|
|
timezone = timezone + itos(zone.bias / 60).pad_zeros(2) + itos(zone.bias % 60).pad_zeros(2);
|
|
|
|
} else {
|
|
|
|
timezone = "Z";
|
|
|
|
}
|
|
|
|
|
|
|
|
return itos(date.year).pad_zeros(2) +
|
|
|
|
"-" +
|
|
|
|
itos(date.month).pad_zeros(2) +
|
|
|
|
"-" +
|
|
|
|
itos(date.day).pad_zeros(2) +
|
|
|
|
"T" +
|
|
|
|
itos(time.hour).pad_zeros(2) +
|
|
|
|
":" +
|
|
|
|
itos(time.min).pad_zeros(2) +
|
|
|
|
":" +
|
|
|
|
itos(time.sec).pad_zeros(2) +
|
|
|
|
timezone;
|
|
|
|
}
|
|
|
|
|
2015-04-13 04:55:01 +08:00
|
|
|
uint64_t OS::get_splash_tick_msec() const {
|
|
|
|
return _msec_splash;
|
|
|
|
}
|
2014-02-10 09:10:30 +08:00
|
|
|
uint64_t OS::get_unix_time() const {
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
};
|
2016-01-11 05:24:55 +08:00
|
|
|
uint64_t OS::get_system_time_secs() const {
|
2015-08-07 01:29:33 +08:00
|
|
|
return 0;
|
|
|
|
}
|
2018-12-20 05:18:52 +08:00
|
|
|
uint64_t OS::get_system_time_msecs() const {
|
|
|
|
return 0;
|
|
|
|
}
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::debug_break(){
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
// something
|
|
|
|
};
|
|
|
|
|
2017-11-21 17:35:01 +08:00
|
|
|
void OS::_set_logger(CompositeLogger *p_logger) {
|
2017-09-22 13:56:02 +08:00
|
|
|
if (_logger) {
|
|
|
|
memdelete(_logger);
|
2015-11-06 03:13:05 +08:00
|
|
|
}
|
2017-09-22 13:56:02 +08:00
|
|
|
_logger = p_logger;
|
|
|
|
}
|
|
|
|
|
2017-11-21 17:35:01 +08:00
|
|
|
void OS::add_logger(Logger *p_logger) {
|
|
|
|
if (!_logger) {
|
|
|
|
Vector<Logger *> loggers;
|
|
|
|
loggers.push_back(p_logger);
|
|
|
|
_logger = memnew(CompositeLogger(loggers));
|
|
|
|
} else {
|
|
|
|
_logger->add_logger(p_logger);
|
|
|
|
}
|
2017-09-22 13:56:02 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
void OS::print_error(const char *p_function, const char *p_file, int p_line, const char *p_code, const char *p_rationale, Logger::ErrorType p_type) {
|
2015-11-06 03:13:05 +08:00
|
|
|
|
2017-09-22 13:56:02 +08:00
|
|
|
_logger->log_error(p_function, p_file, p_line, p_code, p_rationale, p_type);
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::print(const char *p_format, ...) {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
va_list argp;
|
|
|
|
va_start(argp, p_format);
|
|
|
|
|
2017-09-22 13:56:02 +08:00
|
|
|
_logger->logv(p_format, argp, false);
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
va_end(argp);
|
|
|
|
};
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::printerr(const char *p_format, ...) {
|
2014-02-10 09:10:30 +08:00
|
|
|
va_list argp;
|
|
|
|
va_start(argp, p_format);
|
|
|
|
|
2017-09-22 13:56:02 +08:00
|
|
|
_logger->logv(p_format, argp, true);
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
va_end(argp);
|
|
|
|
};
|
|
|
|
|
2015-11-27 22:40:04 +08:00
|
|
|
void OS::set_keep_screen_on(bool p_enabled) {
|
2017-03-05 23:44:50 +08:00
|
|
|
_keep_screen_on = p_enabled;
|
2015-11-27 22:40:04 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
bool OS::is_keep_screen_on() const {
|
|
|
|
return _keep_screen_on;
|
|
|
|
}
|
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
void OS::set_low_processor_usage_mode(bool p_enabled) {
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
low_processor_usage_mode = p_enabled;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
bool OS::is_in_low_processor_usage_mode() const {
|
|
|
|
|
|
|
|
return low_processor_usage_mode;
|
|
|
|
}
|
|
|
|
|
2017-11-23 01:40:43 +08:00
|
|
|
void OS::set_low_processor_usage_mode_sleep_usec(int p_usec) {
|
|
|
|
|
|
|
|
low_processor_usage_mode_sleep_usec = p_usec;
|
|
|
|
}
|
|
|
|
|
|
|
|
int OS::get_low_processor_usage_mode_sleep_usec() const {
|
|
|
|
|
|
|
|
return low_processor_usage_mode_sleep_usec;
|
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::set_clipboard(const String &p_text) {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
_local_clipboard = p_text;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
String OS::get_clipboard() const {
|
|
|
|
|
|
|
|
return _local_clipboard;
|
|
|
|
}
|
|
|
|
|
|
|
|
String OS::get_executable_path() const {
|
|
|
|
|
|
|
|
return _execpath;
|
|
|
|
}
|
|
|
|
|
2017-08-07 18:17:31 +08:00
|
|
|
int OS::get_process_id() const {
|
2014-04-05 23:39:30 +08:00
|
|
|
|
|
|
|
return -1;
|
|
|
|
};
|
|
|
|
|
2019-08-17 23:27:29 +08:00
|
|
|
void OS::vibrate_handheld(int p_duration_ms) {
|
|
|
|
|
2019-11-07 16:44:15 +08:00
|
|
|
WARN_PRINT("vibrate_handheld() only works with Android and iOS");
|
2019-08-17 23:27:29 +08:00
|
|
|
}
|
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
bool OS::is_stdout_verbose() const {
|
|
|
|
|
|
|
|
return _verbose_stdout;
|
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::dump_memory_to_file(const char *p_file) {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-01-14 19:26:56 +08:00
|
|
|
//Memory::dump_static_mem_to_file(p_file);
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
static FileAccess *_OSPRF = NULL;
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
static void _OS_printres(Object *p_obj) {
|
|
|
|
|
2017-08-25 04:58:51 +08:00
|
|
|
Resource *res = Object::cast_to<Resource>(p_obj);
|
2014-02-10 09:10:30 +08:00
|
|
|
if (!res)
|
|
|
|
return;
|
|
|
|
|
2017-08-07 18:17:31 +08:00
|
|
|
String str = itos(res->get_instance_id()) + String(res->get_class()) + ":" + String(res->get_name()) + " - " + res->get_path();
|
2014-02-10 09:10:30 +08:00
|
|
|
if (_OSPRF)
|
|
|
|
_OSPRF->store_line(str);
|
|
|
|
else
|
|
|
|
print_line(str);
|
|
|
|
}
|
|
|
|
|
|
|
|
bool OS::has_virtual_keyboard() const {
|
|
|
|
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2020-01-22 23:13:36 +08:00
|
|
|
void OS::show_virtual_keyboard(const String &p_existing_text, const Rect2 &p_screen_rect, int p_max_input_length) {
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::hide_virtual_keyboard() {
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2017-10-04 16:39:31 +08:00
|
|
|
int OS::get_virtual_keyboard_height() const {
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2019-04-15 23:30:20 +08:00
|
|
|
void OS::set_cursor_shape(CursorShape p_shape) {
|
|
|
|
}
|
|
|
|
|
|
|
|
OS::CursorShape OS::get_cursor_shape() const {
|
|
|
|
return CURSOR_ARROW;
|
|
|
|
}
|
|
|
|
|
|
|
|
void OS::set_custom_mouse_cursor(const RES &p_cursor, CursorShape p_shape, const Vector2 &p_hotspot) {
|
|
|
|
}
|
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
void OS::print_all_resources(String p_to_file) {
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
ERR_FAIL_COND(p_to_file != "" && _OSPRF);
|
|
|
|
if (p_to_file != "") {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
Error err;
|
2017-03-05 23:44:50 +08:00
|
|
|
_OSPRF = FileAccess::open(p_to_file, FileAccess::WRITE, &err);
|
|
|
|
if (err != OK) {
|
|
|
|
_OSPRF = NULL;
|
2019-08-15 10:57:49 +08:00
|
|
|
ERR_FAIL_MSG("Can't print all resources to file: " + String(p_to_file) + ".");
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
ObjectDB::debug_objects(_OS_printres);
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
if (p_to_file != "") {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
if (_OSPRF)
|
|
|
|
memdelete(_OSPRF);
|
2017-03-05 23:44:50 +08:00
|
|
|
_OSPRF = NULL;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void OS::print_resources_in_use(bool p_short) {
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
ResourceCache::dump(NULL, p_short);
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::dump_resources_to_file(const char *p_file) {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
ResourceCache::dump(p_file);
|
|
|
|
}
|
|
|
|
|
|
|
|
void OS::set_no_window_mode(bool p_enable) {
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
_no_window = p_enable;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
bool OS::is_no_window_mode_enabled() const {
|
|
|
|
|
|
|
|
return _no_window;
|
|
|
|
}
|
|
|
|
|
|
|
|
int OS::get_exit_code() const {
|
|
|
|
|
|
|
|
return _exit_code;
|
|
|
|
}
|
|
|
|
void OS::set_exit_code(int p_code) {
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
_exit_code = p_code;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
String OS::get_locale() const {
|
|
|
|
|
|
|
|
return "en";
|
|
|
|
}
|
|
|
|
|
2017-11-27 02:00:53 +08:00
|
|
|
// Helper function to ensure that a dir name/path will be valid on the OS
|
|
|
|
String OS::get_safe_dir_name(const String &p_dir_name, bool p_allow_dir_separator) const {
|
|
|
|
|
|
|
|
Vector<String> invalid_chars = String(": * ? \" < > |").split(" ");
|
|
|
|
if (p_allow_dir_separator) {
|
|
|
|
// Dir separators are allowed, but disallow ".." to avoid going up the filesystem
|
|
|
|
invalid_chars.push_back("..");
|
|
|
|
} else {
|
|
|
|
invalid_chars.push_back("/");
|
|
|
|
}
|
|
|
|
|
|
|
|
String safe_dir_name = p_dir_name.replace("\\", "/").strip_edges();
|
|
|
|
for (int i = 0; i < invalid_chars.size(); i++) {
|
|
|
|
safe_dir_name = safe_dir_name.replace(invalid_chars[i], "-");
|
2016-06-03 02:39:37 +08:00
|
|
|
}
|
2017-11-27 02:00:53 +08:00
|
|
|
return safe_dir_name;
|
2016-06-03 02:39:37 +08:00
|
|
|
}
|
|
|
|
|
Add initial support for the XDG Base Directory spec
Spec version 0.7 from https://standards.freedesktop.org/basedir-spec/basedir-spec-0.7.html
(latest as of this commit).
Three virtual methods are added to OS for the various XDG paths we will use:
- OS::get_data_path gives XDG_DATA_HOME, or if missing:
~/.local/share on X11, ~/Library/Application Support/ on macOS and %APPDATA% on Windows
- OS::get_config_path gives XDG_CONFIG_HOME, or if missing:
~/.config on X11, ~/Library/Application Support/ on macOS and %APPDATA% on Windows
- OS::get_cache_path gives XDG_CACHE_HOME, or if missing:
~/.cache on X11, ~/Library/Caches on macOS and %APPDATA% on Windows
So for Windows there are no changes, for Linux we follow the full split spec
and for macOS stuff will move from ~/.godot to ~/Library/Application Support/Godot.
Support for system-wide installation of templates on Unix was removed for now,
as it's a bit hackish and I don't think anyone uses it.
user:// will still be OS::get_data_path() + "/godot/app_userdata/$name" by
default, but when using the application/config/use_shared_user_dir option
it will now use XDG_DATA_HOME/$name, e.g. ~/.local/share/MyGame.
For now everything still goes in EditorSettings::get_settings_dir(), but
this will be changed in a later commit to make use of the new splitting
where relevant.
Part of #3513.
2017-11-18 00:11:41 +08:00
|
|
|
// Path to data, config, cache, etc. OS-specific folders
|
|
|
|
|
|
|
|
// Get properly capitalized engine name for system paths
|
|
|
|
String OS::get_godot_dir_name() const {
|
|
|
|
|
|
|
|
// Default to lowercase, so only override when different case is needed
|
2017-11-20 04:18:01 +08:00
|
|
|
return String(VERSION_SHORT_NAME).to_lower();
|
Add initial support for the XDG Base Directory spec
Spec version 0.7 from https://standards.freedesktop.org/basedir-spec/basedir-spec-0.7.html
(latest as of this commit).
Three virtual methods are added to OS for the various XDG paths we will use:
- OS::get_data_path gives XDG_DATA_HOME, or if missing:
~/.local/share on X11, ~/Library/Application Support/ on macOS and %APPDATA% on Windows
- OS::get_config_path gives XDG_CONFIG_HOME, or if missing:
~/.config on X11, ~/Library/Application Support/ on macOS and %APPDATA% on Windows
- OS::get_cache_path gives XDG_CACHE_HOME, or if missing:
~/.cache on X11, ~/Library/Caches on macOS and %APPDATA% on Windows
So for Windows there are no changes, for Linux we follow the full split spec
and for macOS stuff will move from ~/.godot to ~/Library/Application Support/Godot.
Support for system-wide installation of templates on Unix was removed for now,
as it's a bit hackish and I don't think anyone uses it.
user:// will still be OS::get_data_path() + "/godot/app_userdata/$name" by
default, but when using the application/config/use_shared_user_dir option
it will now use XDG_DATA_HOME/$name, e.g. ~/.local/share/MyGame.
For now everything still goes in EditorSettings::get_settings_dir(), but
this will be changed in a later commit to make use of the new splitting
where relevant.
Part of #3513.
2017-11-18 00:11:41 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
// OS equivalent of XDG_DATA_HOME
|
|
|
|
String OS::get_data_path() const {
|
|
|
|
|
|
|
|
return ".";
|
|
|
|
}
|
|
|
|
|
|
|
|
// OS equivalent of XDG_CONFIG_HOME
|
|
|
|
String OS::get_config_path() const {
|
|
|
|
|
|
|
|
return ".";
|
|
|
|
}
|
|
|
|
|
|
|
|
// OS equivalent of XDG_CACHE_HOME
|
|
|
|
String OS::get_cache_path() const {
|
|
|
|
|
|
|
|
return ".";
|
|
|
|
}
|
|
|
|
|
2020-01-11 00:02:29 +08:00
|
|
|
// Path to macOS .app bundle resources
|
|
|
|
String OS::get_bundle_resource_dir() const {
|
|
|
|
|
|
|
|
return ".";
|
|
|
|
};
|
|
|
|
|
Add initial support for the XDG Base Directory spec
Spec version 0.7 from https://standards.freedesktop.org/basedir-spec/basedir-spec-0.7.html
(latest as of this commit).
Three virtual methods are added to OS for the various XDG paths we will use:
- OS::get_data_path gives XDG_DATA_HOME, or if missing:
~/.local/share on X11, ~/Library/Application Support/ on macOS and %APPDATA% on Windows
- OS::get_config_path gives XDG_CONFIG_HOME, or if missing:
~/.config on X11, ~/Library/Application Support/ on macOS and %APPDATA% on Windows
- OS::get_cache_path gives XDG_CACHE_HOME, or if missing:
~/.cache on X11, ~/Library/Caches on macOS and %APPDATA% on Windows
So for Windows there are no changes, for Linux we follow the full split spec
and for macOS stuff will move from ~/.godot to ~/Library/Application Support/Godot.
Support for system-wide installation of templates on Unix was removed for now,
as it's a bit hackish and I don't think anyone uses it.
user:// will still be OS::get_data_path() + "/godot/app_userdata/$name" by
default, but when using the application/config/use_shared_user_dir option
it will now use XDG_DATA_HOME/$name, e.g. ~/.local/share/MyGame.
For now everything still goes in EditorSettings::get_settings_dir(), but
this will be changed in a later commit to make use of the new splitting
where relevant.
Part of #3513.
2017-11-18 00:11:41 +08:00
|
|
|
// OS specific path for user://
|
2017-11-17 22:25:22 +08:00
|
|
|
String OS::get_user_data_dir() const {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
return ".";
|
|
|
|
};
|
|
|
|
|
Add initial support for the XDG Base Directory spec
Spec version 0.7 from https://standards.freedesktop.org/basedir-spec/basedir-spec-0.7.html
(latest as of this commit).
Three virtual methods are added to OS for the various XDG paths we will use:
- OS::get_data_path gives XDG_DATA_HOME, or if missing:
~/.local/share on X11, ~/Library/Application Support/ on macOS and %APPDATA% on Windows
- OS::get_config_path gives XDG_CONFIG_HOME, or if missing:
~/.config on X11, ~/Library/Application Support/ on macOS and %APPDATA% on Windows
- OS::get_cache_path gives XDG_CACHE_HOME, or if missing:
~/.cache on X11, ~/Library/Caches on macOS and %APPDATA% on Windows
So for Windows there are no changes, for Linux we follow the full split spec
and for macOS stuff will move from ~/.godot to ~/Library/Application Support/Godot.
Support for system-wide installation of templates on Unix was removed for now,
as it's a bit hackish and I don't think anyone uses it.
user:// will still be OS::get_data_path() + "/godot/app_userdata/$name" by
default, but when using the application/config/use_shared_user_dir option
it will now use XDG_DATA_HOME/$name, e.g. ~/.local/share/MyGame.
For now everything still goes in EditorSettings::get_settings_dir(), but
this will be changed in a later commit to make use of the new splitting
where relevant.
Part of #3513.
2017-11-18 00:11:41 +08:00
|
|
|
// Absolute path to res://
|
|
|
|
String OS::get_resource_dir() const {
|
|
|
|
|
|
|
|
return ProjectSettings::get_singleton()->get_resource_path();
|
|
|
|
}
|
|
|
|
|
|
|
|
// Access system-specific dirs like Documents, Downloads, etc.
|
|
|
|
String OS::get_system_dir(SystemDir p_dir) const {
|
|
|
|
|
|
|
|
return ".";
|
|
|
|
}
|
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
Error OS::shell_open(String p_uri) {
|
|
|
|
return ERR_UNAVAILABLE;
|
|
|
|
};
|
|
|
|
|
|
|
|
// implement these with the canvas?
|
2017-03-05 23:44:50 +08:00
|
|
|
Error OS::dialog_show(String p_title, String p_description, Vector<String> p_buttons, Object *p_obj, String p_callback) {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
while (true) {
|
|
|
|
|
|
|
|
print("%ls\n--------\n%ls\n", p_title.c_str(), p_description.c_str());
|
2017-03-05 23:44:50 +08:00
|
|
|
for (int i = 0; i < p_buttons.size(); i++) {
|
|
|
|
if (i > 0) print(", ");
|
|
|
|
print("%i=%ls", i + 1, p_buttons[i].c_str());
|
2014-02-10 09:10:30 +08:00
|
|
|
};
|
|
|
|
print("\n");
|
|
|
|
String res = get_stdin_string().strip_edges();
|
|
|
|
if (!res.is_numeric())
|
|
|
|
continue;
|
|
|
|
int n = res.to_int();
|
|
|
|
if (n < 0 || n >= p_buttons.size())
|
|
|
|
continue;
|
|
|
|
if (p_obj && p_callback != "")
|
|
|
|
p_obj->call_deferred(p_callback, n);
|
|
|
|
break;
|
|
|
|
};
|
|
|
|
return OK;
|
|
|
|
};
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
Error OS::dialog_input_text(String p_title, String p_description, String p_partial, Object *p_obj, String p_callback) {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
ERR_FAIL_COND_V(!p_obj, FAILED);
|
|
|
|
ERR_FAIL_COND_V(p_callback == "", FAILED);
|
|
|
|
print("%ls\n---------\n%ls\n[%ls]:\n", p_title.c_str(), p_description.c_str(), p_partial.c_str());
|
|
|
|
|
|
|
|
String res = get_stdin_string().strip_edges();
|
|
|
|
bool success = true;
|
|
|
|
if (res == "") {
|
|
|
|
res = p_partial;
|
|
|
|
};
|
|
|
|
|
|
|
|
p_obj->call_deferred(p_callback, success, res);
|
|
|
|
|
|
|
|
return OK;
|
|
|
|
};
|
|
|
|
|
2019-01-31 02:07:46 +08:00
|
|
|
uint64_t OS::get_static_memory_usage() const {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-01-06 21:15:44 +08:00
|
|
|
return Memory::get_mem_usage();
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
2019-01-31 02:07:46 +08:00
|
|
|
uint64_t OS::get_dynamic_memory_usage() const {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-01-08 05:25:37 +08:00
|
|
|
return MemoryPool::total_memory;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2019-01-31 02:07:46 +08:00
|
|
|
uint64_t OS::get_static_memory_peak_usage() const {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-01-06 21:15:44 +08:00
|
|
|
return Memory::get_mem_max_usage();
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
Error OS::set_cwd(const String &p_cwd) {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
return ERR_CANT_OPEN;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool OS::has_touchscreen_ui_hint() const {
|
|
|
|
|
|
|
|
//return false;
|
2018-02-24 10:04:30 +08:00
|
|
|
return Input::get_singleton() && Input::get_singleton()->is_emulating_touch_from_mouse();
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2019-01-31 02:07:46 +08:00
|
|
|
uint64_t OS::get_free_static_memory() const {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-01-06 21:15:44 +08:00
|
|
|
return Memory::get_mem_available();
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
void OS::yield() {
|
|
|
|
}
|
|
|
|
|
|
|
|
void OS::set_screen_orientation(ScreenOrientation p_orientation) {
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
_orientation = p_orientation;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
OS::ScreenOrientation OS::get_screen_orientation() const {
|
|
|
|
|
|
|
|
return (OS::ScreenOrientation)_orientation;
|
|
|
|
}
|
|
|
|
|
2017-11-17 22:25:22 +08:00
|
|
|
void OS::_ensure_user_data_dir() {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-11-17 22:25:22 +08:00
|
|
|
String dd = get_user_data_dir();
|
2014-02-10 09:10:30 +08:00
|
|
|
DirAccess *da = DirAccess::open(dd);
|
|
|
|
if (da) {
|
|
|
|
memdelete(da);
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
da = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
|
2014-09-20 05:39:50 +08:00
|
|
|
Error err = da->make_dir_recursive(dd);
|
2019-08-15 10:57:49 +08:00
|
|
|
ERR_FAIL_COND_MSG(err != OK, "Error attempting to create data dir: " + dd + ".");
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
memdelete(da);
|
|
|
|
}
|
|
|
|
|
2019-05-17 21:43:56 +08:00
|
|
|
void OS::set_native_icon(const String &p_filename) {
|
|
|
|
}
|
|
|
|
|
2017-05-17 18:36:47 +08:00
|
|
|
void OS::set_icon(const Ref<Image> &p_icon) {
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
String OS::get_model_name() const {
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
return "GenericDevice";
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::set_cmdline(const char *p_execpath, const List<String> &p_args) {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
_execpath = p_execpath;
|
|
|
|
_cmdline = p_args;
|
|
|
|
};
|
|
|
|
|
|
|
|
void OS::release_rendering_thread() {
|
|
|
|
}
|
|
|
|
|
|
|
|
void OS::make_rendering_thread() {
|
|
|
|
}
|
|
|
|
|
|
|
|
void OS::swap_buffers() {
|
|
|
|
}
|
|
|
|
|
2017-08-07 18:17:31 +08:00
|
|
|
String OS::get_unique_id() const {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
ERR_FAIL_V("");
|
|
|
|
}
|
|
|
|
|
|
|
|
int OS::get_processor_count() const {
|
|
|
|
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
2014-11-17 18:46:11 +08:00
|
|
|
Error OS::native_video_play(String p_path, float p_volume, String p_audio_track, String p_subtitle_track) {
|
2014-02-14 05:03:28 +08:00
|
|
|
|
|
|
|
return FAILED;
|
|
|
|
};
|
|
|
|
|
2014-03-14 09:57:24 +08:00
|
|
|
bool OS::native_video_is_playing() const {
|
2014-02-14 05:03:28 +08:00
|
|
|
|
|
|
|
return false;
|
|
|
|
};
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::native_video_pause(){
|
2014-02-14 05:03:28 +08:00
|
|
|
|
|
|
|
};
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::native_video_unpause(){
|
2016-02-19 12:09:06 +08:00
|
|
|
|
|
|
|
};
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
void OS::native_video_stop(){
|
2014-02-14 05:03:28 +08:00
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
void OS::set_mouse_mode(MouseMode p_mode) {
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2014-03-14 09:57:24 +08:00
|
|
|
bool OS::can_use_threads() const {
|
|
|
|
|
|
|
|
#ifdef NO_THREADS
|
|
|
|
return false;
|
|
|
|
#else
|
|
|
|
return true;
|
|
|
|
#endif
|
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
OS::MouseMode OS::get_mouse_mode() const {
|
2014-02-10 09:10:30 +08:00
|
|
|
|
|
|
|
return MOUSE_MODE_VISIBLE;
|
|
|
|
}
|
|
|
|
|
2015-01-05 08:16:40 +08:00
|
|
|
OS::LatinKeyboardVariant OS::get_latin_keyboard_variant() const {
|
|
|
|
|
|
|
|
return LATIN_KEYBOARD_QWERTY;
|
|
|
|
}
|
|
|
|
|
2016-01-08 07:40:41 +08:00
|
|
|
bool OS::is_joy_known(int p_device) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
String OS::get_joy_guid(int p_device) const {
|
2017-01-09 04:05:51 +08:00
|
|
|
return "Default Joypad";
|
2016-01-08 07:40:41 +08:00
|
|
|
}
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2016-01-28 04:53:37 +08:00
|
|
|
void OS::set_context(int p_context) {
|
|
|
|
}
|
2017-12-17 04:09:25 +08:00
|
|
|
|
|
|
|
OS::SwitchVSyncCallbackInThread OS::switch_vsync_function = NULL;
|
|
|
|
|
2016-06-06 06:14:33 +08:00
|
|
|
void OS::set_use_vsync(bool p_enable) {
|
2017-12-17 04:09:25 +08:00
|
|
|
_use_vsync = p_enable;
|
|
|
|
if (switch_vsync_function) { //if a function was set, use function
|
|
|
|
switch_vsync_function(p_enable);
|
|
|
|
} else { //otherwise just call here
|
|
|
|
_set_use_vsync(p_enable);
|
|
|
|
}
|
2016-06-06 06:14:33 +08:00
|
|
|
}
|
|
|
|
|
2017-03-05 23:44:50 +08:00
|
|
|
bool OS::is_vsync_enabled() const {
|
2016-06-06 06:14:33 +08:00
|
|
|
|
2017-12-17 04:09:25 +08:00
|
|
|
return _use_vsync;
|
2016-06-06 06:14:33 +08:00
|
|
|
}
|
2016-01-28 04:53:37 +08:00
|
|
|
|
2019-11-07 10:18:55 +08:00
|
|
|
void OS::set_vsync_via_compositor(bool p_enable) {
|
|
|
|
_vsync_via_compositor = p_enable;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool OS::is_vsync_via_compositor_enabled() const {
|
|
|
|
return _vsync_via_compositor;
|
|
|
|
}
|
|
|
|
|
2017-09-13 03:09:06 +08:00
|
|
|
OS::PowerState OS::get_power_state() {
|
2016-07-23 19:15:55 +08:00
|
|
|
return POWERSTATE_UNKNOWN;
|
|
|
|
}
|
|
|
|
int OS::get_power_seconds_left() {
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
int OS::get_power_percent_left() {
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
|
2019-02-26 22:58:47 +08:00
|
|
|
void OS::set_has_server_feature_callback(HasServerFeatureCallback p_callback) {
|
|
|
|
|
|
|
|
has_server_feature_callback = p_callback;
|
|
|
|
}
|
|
|
|
|
2017-10-03 03:38:39 +08:00
|
|
|
bool OS::has_feature(const String &p_feature) {
|
2017-07-20 04:00:46 +08:00
|
|
|
|
|
|
|
if (p_feature == get_name())
|
|
|
|
return true;
|
|
|
|
#ifdef DEBUG_ENABLED
|
|
|
|
if (p_feature == "debug")
|
|
|
|
return true;
|
|
|
|
#else
|
|
|
|
if (p_feature == "release")
|
|
|
|
return true;
|
|
|
|
#endif
|
2018-07-26 05:20:54 +08:00
|
|
|
#ifdef TOOLS_ENABLED
|
|
|
|
if (p_feature == "editor")
|
|
|
|
return true;
|
|
|
|
#else
|
|
|
|
if (p_feature == "standalone")
|
|
|
|
return true;
|
|
|
|
#endif
|
2017-07-20 04:00:46 +08:00
|
|
|
|
2017-10-03 03:38:39 +08:00
|
|
|
if (sizeof(void *) == 8 && p_feature == "64") {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
if (sizeof(void *) == 4 && p_feature == "32") {
|
|
|
|
return true;
|
|
|
|
}
|
2017-11-21 02:12:36 +08:00
|
|
|
#if defined(__x86_64) || defined(__x86_64__) || defined(__amd64__)
|
2017-10-02 23:01:43 +08:00
|
|
|
if (p_feature == "x86_64") {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
#elif (defined(__i386) || defined(__i386__))
|
|
|
|
if (p_feature == "x86") {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
#elif defined(__aarch64__)
|
|
|
|
if (p_feature == "arm64") {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
#elif defined(__arm__)
|
|
|
|
#if defined(__ARM_ARCH_7A__)
|
|
|
|
if (p_feature == "armv7a" || p_feature == "armv7") {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
#if defined(__ARM_ARCH_7S__)
|
|
|
|
if (p_feature == "armv7s" || p_feature == "armv7") {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
if (p_feature == "arm") {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
#endif
|
2017-10-03 03:38:39 +08:00
|
|
|
|
2017-07-20 04:00:46 +08:00
|
|
|
if (_check_internal_feature_support(p_feature))
|
|
|
|
return true;
|
|
|
|
|
2019-02-26 22:58:47 +08:00
|
|
|
if (has_server_feature_callback && has_server_feature_callback(p_feature)) {
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2018-07-18 16:22:59 +08:00
|
|
|
if (ProjectSettings::get_singleton()->has_custom_feature(p_feature))
|
|
|
|
return true;
|
|
|
|
|
2017-07-20 04:00:46 +08:00
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2018-02-13 01:17:29 +08:00
|
|
|
void OS::center_window() {
|
|
|
|
|
|
|
|
if (is_window_fullscreen()) return;
|
|
|
|
|
2018-09-03 10:13:04 +08:00
|
|
|
Point2 sp = get_screen_position(get_current_screen());
|
2018-02-13 01:17:29 +08:00
|
|
|
Size2 scr = get_screen_size(get_current_screen());
|
|
|
|
Size2 wnd = get_real_window_size();
|
2018-09-03 10:13:04 +08:00
|
|
|
|
|
|
|
int x = sp.width + (scr.width - wnd.width) / 2;
|
|
|
|
int y = sp.height + (scr.height - wnd.height) / 2;
|
|
|
|
|
2018-02-13 01:17:29 +08:00
|
|
|
set_window_position(Vector2(x, y));
|
|
|
|
}
|
|
|
|
|
2018-03-05 01:18:05 +08:00
|
|
|
int OS::get_video_driver_count() const {
|
|
|
|
|
|
|
|
return 2;
|
|
|
|
}
|
|
|
|
|
|
|
|
const char *OS::get_video_driver_name(int p_driver) const {
|
|
|
|
|
|
|
|
switch (p_driver) {
|
|
|
|
case VIDEO_DRIVER_GLES2:
|
|
|
|
return "GLES2";
|
|
|
|
case VIDEO_DRIVER_GLES3:
|
|
|
|
default:
|
|
|
|
return "GLES3";
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
int OS::get_audio_driver_count() const {
|
|
|
|
|
|
|
|
return AudioDriverManager::get_driver_count();
|
|
|
|
}
|
|
|
|
|
|
|
|
const char *OS::get_audio_driver_name(int p_driver) const {
|
|
|
|
|
|
|
|
AudioDriver *driver = AudioDriverManager::get_driver(p_driver);
|
2019-09-25 16:28:50 +08:00
|
|
|
ERR_FAIL_COND_V_MSG(!driver, "", "Cannot get audio driver at index '" + itos(p_driver) + "'.");
|
2018-03-05 01:18:05 +08:00
|
|
|
return AudioDriverManager::get_driver(p_driver)->get_name();
|
|
|
|
}
|
|
|
|
|
2018-07-20 05:58:15 +08:00
|
|
|
void OS::set_restart_on_exit(bool p_restart, const List<String> &p_restart_arguments) {
|
|
|
|
restart_on_exit = p_restart;
|
|
|
|
restart_commandline = p_restart_arguments;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool OS::is_restart_on_exit_set() const {
|
|
|
|
return restart_on_exit;
|
|
|
|
}
|
2018-07-20 14:37:10 +08:00
|
|
|
|
|
|
|
List<String> OS::get_restart_on_exit_arguments() const {
|
2018-07-20 05:58:15 +08:00
|
|
|
return restart_commandline;
|
|
|
|
}
|
|
|
|
|
2018-07-14 20:11:28 +08:00
|
|
|
PoolStringArray OS::get_connected_midi_inputs() {
|
|
|
|
|
|
|
|
if (MIDIDriver::get_singleton())
|
|
|
|
return MIDIDriver::get_singleton()->get_connected_inputs();
|
|
|
|
|
|
|
|
PoolStringArray list;
|
|
|
|
return list;
|
|
|
|
}
|
|
|
|
|
2018-08-04 08:17:33 +08:00
|
|
|
void OS::open_midi_inputs() {
|
|
|
|
|
|
|
|
if (MIDIDriver::get_singleton())
|
|
|
|
MIDIDriver::get_singleton()->open();
|
|
|
|
}
|
|
|
|
|
|
|
|
void OS::close_midi_inputs() {
|
|
|
|
|
|
|
|
if (MIDIDriver::get_singleton())
|
|
|
|
MIDIDriver::get_singleton()->close();
|
|
|
|
}
|
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
OS::OS() {
|
2017-07-19 19:49:19 +08:00
|
|
|
void *volatile stack_bottom;
|
|
|
|
|
2018-07-20 09:41:32 +08:00
|
|
|
restart_on_exit = false;
|
2017-03-05 23:44:50 +08:00
|
|
|
singleton = this;
|
|
|
|
_keep_screen_on = true; // set default value to true, because this had been true before godot 2.0.
|
|
|
|
low_processor_usage_mode = false;
|
2017-11-23 01:40:43 +08:00
|
|
|
low_processor_usage_mode_sleep_usec = 10000;
|
2017-03-05 23:44:50 +08:00
|
|
|
_verbose_stdout = false;
|
|
|
|
_no_window = false;
|
|
|
|
_exit_code = 0;
|
|
|
|
_orientation = SCREEN_LANDSCAPE;
|
|
|
|
|
|
|
|
_render_thread_mode = RENDER_THREAD_SAFE;
|
|
|
|
|
2017-10-06 03:41:42 +08:00
|
|
|
_allow_hidpi = false;
|
2017-12-11 02:38:26 +08:00
|
|
|
_allow_layered = false;
|
2017-07-19 19:49:19 +08:00
|
|
|
_stack_bottom = (void *)(&stack_bottom);
|
2017-09-22 13:56:02 +08:00
|
|
|
|
|
|
|
_logger = NULL;
|
2017-11-21 17:35:01 +08:00
|
|
|
|
2019-02-26 22:58:47 +08:00
|
|
|
has_server_feature_callback = NULL;
|
|
|
|
|
2017-11-21 17:35:01 +08:00
|
|
|
Vector<Logger *> loggers;
|
|
|
|
loggers.push_back(memnew(StdLogger));
|
|
|
|
_set_logger(memnew(CompositeLogger(loggers)));
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
OS::~OS() {
|
2017-09-22 13:56:02 +08:00
|
|
|
memdelete(_logger);
|
2017-03-05 23:44:50 +08:00
|
|
|
singleton = NULL;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|