2014-02-10 09:10:30 +08:00
|
|
|
/**************************************************************************/
|
|
|
|
/* thread.cpp */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* */
|
|
|
|
/* 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
|
|
|
|
2022-03-14 19:36:06 +08:00
|
|
|
#include "platform_config.h"
|
2021-09-25 08:23:36 +08:00
|
|
|
#ifndef PLATFORM_THREAD_OVERRIDE // See details in thread.h
|
2021-09-16 08:48:04 +08:00
|
|
|
|
2014-02-10 09:10:30 +08:00
|
|
|
#include "thread.h"
|
|
|
|
|
2023-12-02 02:39:09 +08:00
|
|
|
#ifdef THREADS_ENABLED
|
2021-01-19 20:29:41 +08:00
|
|
|
#include "core/object/script_language.h"
|
2021-02-11 02:22:13 +08:00
|
|
|
#include "core/templates/safe_refcount.h"
|
|
|
|
|
2023-04-22 21:34:16 +08:00
|
|
|
SafeNumeric<uint64_t> Thread::id_counter(1); // The first value after .increment() is 2, hence by default the main thread ID should be 1.
|
2021-03-07 06:17:20 +08:00
|
|
|
|
2023-04-22 21:34:16 +08:00
|
|
|
thread_local Thread::ID Thread::caller_id = Thread::UNASSIGNED_ID;
|
2023-12-02 02:39:09 +08:00
|
|
|
#endif
|
|
|
|
|
|
|
|
Thread::PlatformFunctions Thread::platform_functions;
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2022-08-24 17:33:52 +08:00
|
|
|
void Thread::_set_platform_functions(const PlatformFunctions &p_functions) {
|
|
|
|
platform_functions = p_functions;
|
2021-01-19 20:29:41 +08:00
|
|
|
}
|
2014-02-10 09:10:30 +08:00
|
|
|
|
2023-12-02 02:39:09 +08:00
|
|
|
#ifdef THREADS_ENABLED
|
2023-02-23 05:49:48 +08:00
|
|
|
void Thread::callback(ID p_caller_id, const Settings &p_settings, Callback p_callback, void *p_userdata) {
|
|
|
|
Thread::caller_id = p_caller_id;
|
2022-08-24 17:33:52 +08:00
|
|
|
if (platform_functions.set_priority) {
|
|
|
|
platform_functions.set_priority(p_settings.priority);
|
2021-01-19 20:29:41 +08:00
|
|
|
}
|
2022-08-24 17:33:52 +08:00
|
|
|
if (platform_functions.init) {
|
|
|
|
platform_functions.init();
|
|
|
|
}
|
|
|
|
ScriptServer::thread_enter(); // Scripts may need to attach a stack.
|
|
|
|
if (platform_functions.wrapper) {
|
|
|
|
platform_functions.wrapper(p_callback, p_userdata);
|
|
|
|
} else {
|
|
|
|
p_callback(p_userdata);
|
2021-01-19 20:29:41 +08:00
|
|
|
}
|
|
|
|
ScriptServer::thread_exit();
|
2022-08-24 17:33:52 +08:00
|
|
|
if (platform_functions.term) {
|
|
|
|
platform_functions.term();
|
2020-05-14 22:41:43 +08:00
|
|
|
}
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2023-03-05 08:09:18 +08:00
|
|
|
Thread::ID Thread::start(Thread::Callback p_callback, void *p_user, const Settings &p_settings) {
|
|
|
|
ERR_FAIL_COND_V_MSG(id != UNASSIGNED_ID, UNASSIGNED_ID, "A Thread object has been re-started without wait_to_finish() having been called on it.");
|
2023-04-22 21:34:16 +08:00
|
|
|
id = id_counter.increment();
|
2023-11-18 03:44:38 +08:00
|
|
|
thread = THREADING_NAMESPACE::thread(&Thread::callback, id, p_settings, p_callback, p_user);
|
2023-03-05 08:09:18 +08:00
|
|
|
return id;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2021-01-19 20:29:41 +08:00
|
|
|
bool Thread::is_started() const {
|
2023-04-22 21:34:16 +08:00
|
|
|
return id != UNASSIGNED_ID;
|
2021-01-19 20:29:41 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
void Thread::wait_to_finish() {
|
2023-04-22 21:34:16 +08:00
|
|
|
ERR_FAIL_COND_MSG(id == UNASSIGNED_ID, "Attempt of waiting to finish on a thread that was never started.");
|
|
|
|
ERR_FAIL_COND_MSG(id == get_caller_id(), "Threads can't wait to finish on themselves, another thread must wait.");
|
|
|
|
thread.join();
|
2023-11-18 03:44:38 +08:00
|
|
|
thread = THREADING_NAMESPACE::thread();
|
2023-04-22 21:34:16 +08:00
|
|
|
id = UNASSIGNED_ID;
|
2014-02-10 09:10:30 +08:00
|
|
|
}
|
|
|
|
|
2015-12-17 17:24:27 +08:00
|
|
|
Error Thread::set_name(const String &p_name) {
|
2022-08-24 17:33:52 +08:00
|
|
|
if (platform_functions.set_name) {
|
|
|
|
return platform_functions.set_name(p_name);
|
2020-05-14 22:41:43 +08:00
|
|
|
}
|
2016-02-01 07:22:38 +08:00
|
|
|
|
2015-12-17 17:24:27 +08:00
|
|
|
return ERR_UNAVAILABLE;
|
2020-05-19 21:46:49 +08:00
|
|
|
}
|
2021-01-19 20:29:41 +08:00
|
|
|
|
2021-03-09 14:40:30 +08:00
|
|
|
Thread::Thread() {
|
|
|
|
}
|
|
|
|
|
2021-01-19 20:29:41 +08:00
|
|
|
Thread::~Thread() {
|
2023-04-22 21:34:16 +08:00
|
|
|
if (id != UNASSIGNED_ID) {
|
2021-01-19 20:29:41 +08:00
|
|
|
#ifdef DEBUG_ENABLED
|
2023-01-28 20:34:06 +08:00
|
|
|
WARN_PRINT(
|
|
|
|
"A Thread object is being destroyed without its completion having been realized.\n"
|
|
|
|
"Please call wait_to_finish() on it to ensure correct cleanup.");
|
2021-01-19 20:29:41 +08:00
|
|
|
#endif
|
|
|
|
thread.detach();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2023-12-02 02:39:09 +08:00
|
|
|
#endif // THREADS_ENABLED
|
|
|
|
|
2021-09-25 08:23:36 +08:00
|
|
|
#endif // PLATFORM_THREAD_OVERRIDE
|