2017-01-13 18:25:43 +01:00
|
|
|
/*************************************************************************/
|
|
|
|
/* engine.cpp */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
2017-08-27 14:16:55 +02:00
|
|
|
/* https://godotengine.org */
|
2017-01-13 18:25:43 +01:00
|
|
|
/*************************************************************************/
|
2020-01-01 11:16:22 +01:00
|
|
|
/* Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md). */
|
2017-01-13 18:25:43 +01: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 00:50:27 +01:00
|
|
|
|
2017-01-13 16:51:14 +01:00
|
|
|
#include "engine.h"
|
2017-01-16 08:04:19 +01:00
|
|
|
|
2018-09-11 18:13:45 +02:00
|
|
|
#include "core/authors.gen.h"
|
|
|
|
#include "core/donors.gen.h"
|
|
|
|
#include "core/license.gen.h"
|
|
|
|
#include "core/version.h"
|
|
|
|
#include "core/version_hash.gen.h"
|
2017-01-13 16:51:14 +01:00
|
|
|
|
|
|
|
void Engine::set_iterations_per_second(int p_ips) {
|
|
|
|
|
2019-09-25 10:28:50 +02:00
|
|
|
ERR_FAIL_COND_MSG(p_ips <= 0, "Engine iterations per second must be greater than 0.");
|
2017-03-05 16:44:50 +01:00
|
|
|
ips = p_ips;
|
2017-01-13 16:51:14 +01:00
|
|
|
}
|
|
|
|
int Engine::get_iterations_per_second() const {
|
|
|
|
|
|
|
|
return ips;
|
|
|
|
}
|
|
|
|
|
Add hysteresis to physics timestep count per frame
Add new class _TimerSync to manage timestep calculations.
The new class handles the decisions about simulation progression
previously handled by main::iteration(). It is fed the current timer
ticks and determines how many physics updates are to be run and what
the delta argument to the _process() functions should be.
The new class tries to keep the number of physics updates per frame as
constant as possible from frame to frame. Ideally, it would be N steps
every render frame, but even with perfectly regular rendering, the
general case is that N or N+1 steps are required per frame, for some
fixed N. The best guess for N is stored in typical_physics_steps.
When determining the number of steps to take, no restrictions are
imposed between the choice of typical_physics_steps and
typical_physics_steps+1 steps. Should more or less steps than that be
required, the accumulated remaining time (as before, stored in
time_accum) needs to surpass its boundaries by some minimal threshold.
Once surpassed, typical_physics_steps is updated to allow the new step
count for future updates.
Care is taken that the modified calculation of the number of physics
steps is not observable from game code that only checks the delta
parameters to the _process and _physics_process functions; in addition
to modifying the number of steps, the _process argument is modified as
well to stay in expected bounds. Extra care is taken that the accumulated
steps still sum up to roughly the real elapsed time, up to a maximum
tolerated difference.
To allow the hysteresis code to work correctly on higher refresh
monitors, the number of typical physics steps is not only recorded and
kept consistent for single render frames, but for groups of them.
Currently, up to 12 frames are grouped that way.
The engine parameter physics_jitter_fix controls both the maximum
tolerated difference between wall clock time and summed up _process
arguments and the threshold for changing typical_physics_steps. It is
given in units of the real physics frame slice 1/physics_fps. Set
physics_jitter_fix to 0 to disable the effects of the new code here.
It starts to be effective against the random physics jitter at around
0.02 to 0.05. at values greater than 1 it starts having ill effects on
the engine's ability to react sensibly to dropped frames and framerate
changes.
2018-02-11 00:03:31 +01:00
|
|
|
void Engine::set_physics_jitter_fix(float p_threshold) {
|
|
|
|
if (p_threshold < 0)
|
|
|
|
p_threshold = 0;
|
|
|
|
physics_jitter_fix = p_threshold;
|
|
|
|
}
|
|
|
|
|
|
|
|
float Engine::get_physics_jitter_fix() const {
|
|
|
|
return physics_jitter_fix;
|
|
|
|
}
|
|
|
|
|
2017-01-13 16:51:14 +01:00
|
|
|
void Engine::set_target_fps(int p_fps) {
|
2017-03-05 16:44:50 +01:00
|
|
|
_target_fps = p_fps > 0 ? p_fps : 0;
|
2017-01-13 16:51:14 +01:00
|
|
|
}
|
|
|
|
|
2020-04-10 07:48:22 +02:00
|
|
|
int Engine::get_target_fps() const {
|
2017-01-13 16:51:14 +01:00
|
|
|
return _target_fps;
|
|
|
|
}
|
|
|
|
|
|
|
|
uint64_t Engine::get_frames_drawn() {
|
|
|
|
|
|
|
|
return frames_drawn;
|
|
|
|
}
|
|
|
|
|
|
|
|
void Engine::set_frame_delay(uint32_t p_msec) {
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
_frame_delay = p_msec;
|
2017-01-13 16:51:14 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
uint32_t Engine::get_frame_delay() const {
|
|
|
|
|
|
|
|
return _frame_delay;
|
|
|
|
}
|
|
|
|
|
|
|
|
void Engine::set_time_scale(float p_scale) {
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
_time_scale = p_scale;
|
2017-01-13 16:51:14 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
float Engine::get_time_scale() const {
|
|
|
|
|
|
|
|
return _time_scale;
|
|
|
|
}
|
|
|
|
|
2017-01-13 18:25:43 +01:00
|
|
|
Dictionary Engine::get_version_info() const {
|
2017-01-13 16:51:14 +01:00
|
|
|
|
2017-01-13 18:25:43 +01:00
|
|
|
Dictionary dict;
|
|
|
|
dict["major"] = VERSION_MAJOR;
|
|
|
|
dict["minor"] = VERSION_MINOR;
|
|
|
|
dict["patch"] = VERSION_PATCH;
|
2019-02-17 13:38:52 +01:00
|
|
|
dict["hex"] = VERSION_HEX;
|
2017-11-19 21:18:01 +01:00
|
|
|
dict["status"] = VERSION_STATUS;
|
2017-11-19 21:26:05 +01:00
|
|
|
dict["build"] = VERSION_BUILD;
|
2017-01-13 18:25:43 +01:00
|
|
|
dict["year"] = VERSION_YEAR;
|
2017-01-13 16:51:14 +01:00
|
|
|
|
2017-11-19 21:18:01 +01:00
|
|
|
String hash = VERSION_HASH;
|
2017-07-10 10:47:38 +02:00
|
|
|
dict["hash"] = hash.length() == 0 ? String("unknown") : hash;
|
|
|
|
|
2017-01-13 18:25:43 +01:00
|
|
|
String stringver = String(dict["major"]) + "." + String(dict["minor"]);
|
|
|
|
if ((int)dict["patch"] != 0)
|
|
|
|
stringver += "." + String(dict["patch"]);
|
2017-11-19 21:26:05 +01:00
|
|
|
stringver += "-" + String(dict["status"]) + " (" + String(dict["build"]) + ")";
|
2017-01-13 18:25:43 +01:00
|
|
|
dict["string"] = stringver;
|
2017-01-13 16:51:14 +01:00
|
|
|
|
2017-01-13 18:25:43 +01:00
|
|
|
return dict;
|
2017-01-13 16:51:14 +01:00
|
|
|
}
|
|
|
|
|
2018-05-16 06:54:22 +02:00
|
|
|
static Array array_from_info(const char *const *info_list) {
|
|
|
|
Array arr;
|
2020-04-02 01:20:12 +02:00
|
|
|
for (int i = 0; info_list[i] != nullptr; i++) {
|
2018-05-16 06:54:22 +02:00
|
|
|
arr.push_back(info_list[i]);
|
|
|
|
}
|
|
|
|
return arr;
|
|
|
|
}
|
|
|
|
|
|
|
|
static Array array_from_info_count(const char *const *info_list, int info_count) {
|
|
|
|
Array arr;
|
|
|
|
for (int i = 0; i < info_count; i++) {
|
|
|
|
arr.push_back(info_list[i]);
|
|
|
|
}
|
|
|
|
return arr;
|
|
|
|
}
|
|
|
|
|
|
|
|
Dictionary Engine::get_author_info() const {
|
|
|
|
Dictionary dict;
|
|
|
|
|
|
|
|
dict["lead_developers"] = array_from_info(AUTHORS_LEAD_DEVELOPERS);
|
|
|
|
dict["project_managers"] = array_from_info(AUTHORS_PROJECT_MANAGERS);
|
|
|
|
dict["founders"] = array_from_info(AUTHORS_FOUNDERS);
|
|
|
|
dict["developers"] = array_from_info(AUTHORS_DEVELOPERS);
|
|
|
|
|
|
|
|
return dict;
|
|
|
|
}
|
|
|
|
|
|
|
|
Array Engine::get_copyright_info() const {
|
|
|
|
Array components;
|
|
|
|
for (int component_index = 0; component_index < COPYRIGHT_INFO_COUNT; component_index++) {
|
|
|
|
const ComponentCopyright &cp_info = COPYRIGHT_INFO[component_index];
|
|
|
|
Dictionary component_dict;
|
|
|
|
component_dict["name"] = cp_info.name;
|
|
|
|
Array parts;
|
|
|
|
for (int i = 0; i < cp_info.part_count; i++) {
|
|
|
|
const ComponentCopyrightPart &cp_part = cp_info.parts[i];
|
|
|
|
Dictionary part_dict;
|
|
|
|
part_dict["files"] = array_from_info_count(cp_part.files, cp_part.file_count);
|
|
|
|
part_dict["copyright"] = array_from_info_count(cp_part.copyright_statements, cp_part.copyright_count);
|
|
|
|
part_dict["license"] = cp_part.license;
|
|
|
|
parts.push_back(part_dict);
|
|
|
|
}
|
|
|
|
component_dict["parts"] = parts;
|
|
|
|
|
|
|
|
components.push_back(component_dict);
|
|
|
|
}
|
|
|
|
return components;
|
|
|
|
}
|
|
|
|
|
|
|
|
Dictionary Engine::get_donor_info() const {
|
|
|
|
Dictionary donors;
|
|
|
|
donors["platinum_sponsors"] = array_from_info(DONORS_SPONSOR_PLAT);
|
|
|
|
donors["gold_sponsors"] = array_from_info(DONORS_SPONSOR_GOLD);
|
|
|
|
donors["mini_sponsors"] = array_from_info(DONORS_SPONSOR_MINI);
|
|
|
|
donors["gold_donors"] = array_from_info(DONORS_GOLD);
|
|
|
|
donors["silver_donors"] = array_from_info(DONORS_SILVER);
|
|
|
|
donors["bronze_donors"] = array_from_info(DONORS_BRONZE);
|
|
|
|
return donors;
|
|
|
|
}
|
|
|
|
|
|
|
|
Dictionary Engine::get_license_info() const {
|
|
|
|
Dictionary licenses;
|
|
|
|
for (int i = 0; i < LICENSE_COUNT; i++) {
|
|
|
|
licenses[LICENSE_NAMES[i]] = LICENSE_BODIES[i];
|
|
|
|
}
|
|
|
|
return licenses;
|
|
|
|
}
|
|
|
|
|
|
|
|
String Engine::get_license_text() const {
|
|
|
|
return String(GODOT_LICENSE_TEXT);
|
|
|
|
}
|
|
|
|
|
2017-11-13 21:46:57 +01:00
|
|
|
void Engine::add_singleton(const Singleton &p_singleton) {
|
|
|
|
|
|
|
|
singletons.push_back(p_singleton);
|
|
|
|
singleton_ptrs[p_singleton.name] = p_singleton.ptr;
|
|
|
|
}
|
|
|
|
|
|
|
|
Object *Engine::get_singleton_object(const String &p_name) const {
|
|
|
|
|
|
|
|
const Map<StringName, Object *>::Element *E = singleton_ptrs.find(p_name);
|
2020-04-02 01:20:12 +02:00
|
|
|
ERR_FAIL_COND_V_MSG(!E, nullptr, "Failed to retrieve non-existent singleton '" + p_name + "'.");
|
2017-11-14 14:52:24 +01:00
|
|
|
return E->get();
|
2017-11-13 21:46:57 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
bool Engine::has_singleton(const String &p_name) const {
|
|
|
|
|
2017-11-14 14:52:24 +01:00
|
|
|
return singleton_ptrs.has(p_name);
|
2017-11-13 21:46:57 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
void Engine::get_singletons(List<Singleton> *p_singletons) {
|
|
|
|
|
|
|
|
for (List<Singleton>::Element *E = singletons.front(); E; E = E->next())
|
|
|
|
p_singletons->push_back(E->get());
|
|
|
|
}
|
|
|
|
|
2020-04-02 01:20:12 +02:00
|
|
|
Engine *Engine::singleton = nullptr;
|
2017-01-13 16:51:14 +01:00
|
|
|
|
|
|
|
Engine *Engine::get_singleton() {
|
|
|
|
return singleton;
|
|
|
|
}
|
|
|
|
|
2019-10-05 15:27:43 +02:00
|
|
|
bool Engine::is_abort_on_gpu_errors_enabled() const {
|
|
|
|
return abort_on_gpu_errors;
|
|
|
|
}
|
2017-03-05 16:44:50 +01:00
|
|
|
Engine::Engine() {
|
|
|
|
|
|
|
|
singleton = this;
|
|
|
|
frames_drawn = 0;
|
|
|
|
ips = 60;
|
Add hysteresis to physics timestep count per frame
Add new class _TimerSync to manage timestep calculations.
The new class handles the decisions about simulation progression
previously handled by main::iteration(). It is fed the current timer
ticks and determines how many physics updates are to be run and what
the delta argument to the _process() functions should be.
The new class tries to keep the number of physics updates per frame as
constant as possible from frame to frame. Ideally, it would be N steps
every render frame, but even with perfectly regular rendering, the
general case is that N or N+1 steps are required per frame, for some
fixed N. The best guess for N is stored in typical_physics_steps.
When determining the number of steps to take, no restrictions are
imposed between the choice of typical_physics_steps and
typical_physics_steps+1 steps. Should more or less steps than that be
required, the accumulated remaining time (as before, stored in
time_accum) needs to surpass its boundaries by some minimal threshold.
Once surpassed, typical_physics_steps is updated to allow the new step
count for future updates.
Care is taken that the modified calculation of the number of physics
steps is not observable from game code that only checks the delta
parameters to the _process and _physics_process functions; in addition
to modifying the number of steps, the _process argument is modified as
well to stay in expected bounds. Extra care is taken that the accumulated
steps still sum up to roughly the real elapsed time, up to a maximum
tolerated difference.
To allow the hysteresis code to work correctly on higher refresh
monitors, the number of typical physics steps is not only recorded and
kept consistent for single render frames, but for groups of them.
Currently, up to 12 frames are grouped that way.
The engine parameter physics_jitter_fix controls both the maximum
tolerated difference between wall clock time and summed up _process
arguments and the threshold for changing typical_physics_steps. It is
given in units of the real physics frame slice 1/physics_fps. Set
physics_jitter_fix to 0 to disable the effects of the new code here.
It starts to be effective against the random physics jitter at around
0.02 to 0.05. at values greater than 1 it starts having ill effects on
the engine's ability to react sensibly to dropped frames and framerate
changes.
2018-02-11 00:03:31 +01:00
|
|
|
physics_jitter_fix = 0.5;
|
2019-07-01 18:42:02 +02:00
|
|
|
_physics_interpolation_fraction = 0.0f;
|
2017-03-05 16:44:50 +01:00
|
|
|
_frame_delay = 0;
|
|
|
|
_fps = 1;
|
|
|
|
_target_fps = 0;
|
|
|
|
_time_scale = 1.0;
|
|
|
|
_pixel_snap = false;
|
2017-09-30 16:19:07 +02:00
|
|
|
_physics_frames = 0;
|
2017-03-05 16:44:50 +01:00
|
|
|
_idle_frames = 0;
|
2017-09-30 16:19:07 +02:00
|
|
|
_in_physics = false;
|
2017-07-15 06:23:10 +02:00
|
|
|
_frame_ticks = 0;
|
|
|
|
_frame_step = 0;
|
2017-08-13 16:21:45 +02:00
|
|
|
editor_hint = false;
|
2019-10-05 15:27:43 +02:00
|
|
|
abort_on_gpu_errors = false;
|
2017-01-13 16:51:14 +01:00
|
|
|
}
|