mirror of
https://github.com/godotengine/godot.git
synced 2024-12-21 10:25:24 +08:00
f44d6a235f
`GDExtension::open_library` has a check in it to see if the library was loaded from a temp file, and if it was to restore the original name as that is the one we actually care about. This check is breaking extension reloading on Mac when the library path is to a framework folder, as the file inside the framework will not generally be the same name as the folder. This check also shouldn't be necessary even on Windows, which is the only platform that uses `generate_temp_files`, since disposal of the created temp file is handled within `OS_Windows::open_dynamic_library`, and `GDExtension::open_library` (which is the only function to call `open_dynamic_library` with a `p_data` argument) only cares about the original library file path and has to do extra work to remove the name of the temp file. Instead, I have removed that check and set `OS_Windows::open_dynamic_library` to return the name of the original file and not the name of the copy. This fixes GDExtension reloading on macOS. I do not have a Windows machine available to test that it still works properly on Windows, so someone should check that before merging this.
1307 lines
55 KiB
C++
1307 lines
55 KiB
C++
/**************************************************************************/
|
|
/* gdextension.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. */
|
|
/**************************************************************************/
|
|
|
|
#include "gdextension.h"
|
|
#include "gdextension.compat.inc"
|
|
|
|
#include "core/config/project_settings.h"
|
|
#include "core/io/dir_access.h"
|
|
#include "core/object/class_db.h"
|
|
#include "core/object/method_bind.h"
|
|
#include "core/os/os.h"
|
|
#include "core/version.h"
|
|
#include "gdextension_manager.h"
|
|
|
|
extern void gdextension_setup_interface();
|
|
extern GDExtensionInterfaceFunctionPtr gdextension_get_proc_address(const char *p_name);
|
|
|
|
typedef GDExtensionBool (*GDExtensionLegacyInitializationFunction)(void *p_interface, GDExtensionClassLibraryPtr p_library, GDExtensionInitialization *r_initialization);
|
|
|
|
String GDExtension::get_extension_list_config_file() {
|
|
return ProjectSettings::get_singleton()->get_project_data_path().path_join("extension_list.cfg");
|
|
}
|
|
|
|
Vector<SharedObject> GDExtension::find_extension_dependencies(const String &p_path, Ref<ConfigFile> p_config, std::function<bool(String)> p_has_feature) {
|
|
Vector<SharedObject> dependencies_shared_objects;
|
|
if (p_config->has_section("dependencies")) {
|
|
List<String> config_dependencies;
|
|
p_config->get_section_keys("dependencies", &config_dependencies);
|
|
|
|
for (const String &dependency : config_dependencies) {
|
|
Vector<String> dependency_tags = dependency.split(".");
|
|
bool all_tags_met = true;
|
|
for (int i = 0; i < dependency_tags.size(); i++) {
|
|
String tag = dependency_tags[i].strip_edges();
|
|
if (!p_has_feature(tag)) {
|
|
all_tags_met = false;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (all_tags_met) {
|
|
Dictionary dependency_value = p_config->get_value("dependencies", dependency);
|
|
for (const Variant *key = dependency_value.next(nullptr); key; key = dependency_value.next(key)) {
|
|
String dependency_path = *key;
|
|
String target_path = dependency_value[*key];
|
|
if (dependency_path.is_relative_path()) {
|
|
dependency_path = p_path.get_base_dir().path_join(dependency_path);
|
|
}
|
|
dependencies_shared_objects.push_back(SharedObject(dependency_path, dependency_tags, target_path));
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
return dependencies_shared_objects;
|
|
}
|
|
|
|
String GDExtension::find_extension_library(const String &p_path, Ref<ConfigFile> p_config, std::function<bool(String)> p_has_feature, PackedStringArray *r_tags) {
|
|
// First, check the explicit libraries.
|
|
if (p_config->has_section("libraries")) {
|
|
List<String> libraries;
|
|
p_config->get_section_keys("libraries", &libraries);
|
|
|
|
// Iterate the libraries, finding the best matching tags.
|
|
String best_library_path;
|
|
Vector<String> best_library_tags;
|
|
for (const String &E : libraries) {
|
|
Vector<String> tags = E.split(".");
|
|
bool all_tags_met = true;
|
|
for (int i = 0; i < tags.size(); i++) {
|
|
String tag = tags[i].strip_edges();
|
|
if (!p_has_feature(tag)) {
|
|
all_tags_met = false;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (all_tags_met && tags.size() > best_library_tags.size()) {
|
|
best_library_path = p_config->get_value("libraries", E);
|
|
best_library_tags = tags;
|
|
}
|
|
}
|
|
|
|
if (!best_library_path.is_empty()) {
|
|
if (best_library_path.is_relative_path()) {
|
|
best_library_path = p_path.get_base_dir().path_join(best_library_path);
|
|
}
|
|
if (r_tags != nullptr) {
|
|
r_tags->append_array(best_library_tags);
|
|
}
|
|
return best_library_path;
|
|
}
|
|
}
|
|
|
|
// Second, try to autodetect
|
|
String autodetect_library_prefix;
|
|
if (p_config->has_section_key("configuration", "autodetect_library_prefix")) {
|
|
autodetect_library_prefix = p_config->get_value("configuration", "autodetect_library_prefix");
|
|
}
|
|
if (!autodetect_library_prefix.is_empty()) {
|
|
String autodetect_path = autodetect_library_prefix;
|
|
if (autodetect_path.is_relative_path()) {
|
|
autodetect_path = p_path.get_base_dir().path_join(autodetect_path);
|
|
}
|
|
|
|
// Find the folder and file parts of the prefix.
|
|
String folder;
|
|
String file_prefix;
|
|
if (DirAccess::dir_exists_absolute(autodetect_path)) {
|
|
folder = autodetect_path;
|
|
} else if (DirAccess::dir_exists_absolute(autodetect_path.get_base_dir())) {
|
|
folder = autodetect_path.get_base_dir();
|
|
file_prefix = autodetect_path.get_file();
|
|
} else {
|
|
ERR_FAIL_V_MSG(String(), vformat("Error in extension: %s. Could not find folder for automatic detection of libraries files. autodetect_library_prefix=\"%s\"", p_path, autodetect_library_prefix));
|
|
}
|
|
|
|
// Open the folder.
|
|
Ref<DirAccess> dir = DirAccess::open(folder);
|
|
ERR_FAIL_COND_V_MSG(!dir.is_valid(), String(), vformat("Error in extension: %s. Could not open folder for automatic detection of libraries files. autodetect_library_prefix=\"%s\"", p_path, autodetect_library_prefix));
|
|
|
|
// Iterate the files and check the prefixes, finding the best matching file.
|
|
String best_file;
|
|
Vector<String> best_file_tags;
|
|
dir->list_dir_begin();
|
|
String file_name = dir->_get_next();
|
|
while (file_name != "") {
|
|
if (!dir->current_is_dir() && file_name.begins_with(file_prefix)) {
|
|
// Check if the files matches all requested feature tags.
|
|
String tags_str = file_name.trim_prefix(file_prefix);
|
|
tags_str = tags_str.trim_suffix(tags_str.get_extension());
|
|
|
|
Vector<String> tags = tags_str.split(".", false);
|
|
bool all_tags_met = true;
|
|
for (int i = 0; i < tags.size(); i++) {
|
|
String tag = tags[i].strip_edges();
|
|
if (!p_has_feature(tag)) {
|
|
all_tags_met = false;
|
|
break;
|
|
}
|
|
}
|
|
|
|
// If all tags are found in the feature list, and we found more tags than before, use this file.
|
|
if (all_tags_met && tags.size() > best_file_tags.size()) {
|
|
best_file_tags = tags;
|
|
best_file = file_name;
|
|
}
|
|
}
|
|
file_name = dir->_get_next();
|
|
}
|
|
|
|
if (!best_file.is_empty()) {
|
|
String library_path = folder.path_join(best_file);
|
|
if (r_tags != nullptr) {
|
|
r_tags->append_array(best_file_tags);
|
|
}
|
|
return library_path;
|
|
}
|
|
}
|
|
return String();
|
|
}
|
|
|
|
class GDExtensionMethodBind : public MethodBind {
|
|
GDExtensionClassMethodCall call_func;
|
|
GDExtensionClassMethodValidatedCall validated_call_func;
|
|
GDExtensionClassMethodPtrCall ptrcall_func;
|
|
void *method_userdata;
|
|
bool vararg;
|
|
uint32_t argument_count;
|
|
PropertyInfo return_value_info;
|
|
GodotTypeInfo::Metadata return_value_metadata;
|
|
List<PropertyInfo> arguments_info;
|
|
List<GodotTypeInfo::Metadata> arguments_metadata;
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
friend class GDExtension;
|
|
|
|
StringName name;
|
|
bool is_reloading = false;
|
|
bool valid = true;
|
|
#endif
|
|
|
|
protected:
|
|
virtual Variant::Type _gen_argument_type(int p_arg) const override {
|
|
if (p_arg < 0) {
|
|
return return_value_info.type;
|
|
} else {
|
|
return arguments_info.get(p_arg).type;
|
|
}
|
|
}
|
|
virtual PropertyInfo _gen_argument_type_info(int p_arg) const override {
|
|
if (p_arg < 0) {
|
|
return return_value_info;
|
|
} else {
|
|
return arguments_info.get(p_arg);
|
|
}
|
|
}
|
|
|
|
public:
|
|
#ifdef TOOLS_ENABLED
|
|
virtual bool is_valid() const override { return valid; }
|
|
#endif
|
|
|
|
#ifdef DEBUG_METHODS_ENABLED
|
|
virtual GodotTypeInfo::Metadata get_argument_meta(int p_arg) const override {
|
|
if (p_arg < 0) {
|
|
return return_value_metadata;
|
|
} else {
|
|
return arguments_metadata.get(p_arg);
|
|
}
|
|
}
|
|
#endif
|
|
|
|
virtual Variant call(Object *p_object, const Variant **p_args, int p_arg_count, Callable::CallError &r_error) const override {
|
|
#ifdef TOOLS_ENABLED
|
|
ERR_FAIL_COND_V_MSG(!valid, Variant(), vformat("Cannot call invalid GDExtension method bind '%s'. It's probably cached - you may need to restart Godot.", name));
|
|
ERR_FAIL_COND_V_MSG(p_object && p_object->is_extension_placeholder(), Variant(), vformat("Cannot call GDExtension method bind '%s' on placeholder instance.", name));
|
|
#endif
|
|
Variant ret;
|
|
GDExtensionClassInstancePtr extension_instance = is_static() ? nullptr : p_object->_get_extension_instance();
|
|
GDExtensionCallError ce{ GDEXTENSION_CALL_OK, 0, 0 };
|
|
call_func(method_userdata, extension_instance, reinterpret_cast<GDExtensionConstVariantPtr *>(p_args), p_arg_count, (GDExtensionVariantPtr)&ret, &ce);
|
|
r_error.error = Callable::CallError::Error(ce.error);
|
|
r_error.argument = ce.argument;
|
|
r_error.expected = ce.expected;
|
|
return ret;
|
|
}
|
|
virtual void validated_call(Object *p_object, const Variant **p_args, Variant *r_ret) const override {
|
|
#ifdef TOOLS_ENABLED
|
|
ERR_FAIL_COND_MSG(!valid, vformat("Cannot call invalid GDExtension method bind '%s'. It's probably cached - you may need to restart Godot.", name));
|
|
ERR_FAIL_COND_MSG(p_object && p_object->is_extension_placeholder(), vformat("Cannot call GDExtension method bind '%s' on placeholder instance.", name));
|
|
#endif
|
|
ERR_FAIL_COND_MSG(vararg, "Vararg methods don't have validated call support. This is most likely an engine bug.");
|
|
GDExtensionClassInstancePtr extension_instance = is_static() ? nullptr : p_object->_get_extension_instance();
|
|
|
|
if (validated_call_func) {
|
|
// This is added here, but it's unlikely to be provided by most extensions.
|
|
validated_call_func(method_userdata, extension_instance, reinterpret_cast<GDExtensionConstVariantPtr *>(p_args), (GDExtensionVariantPtr)r_ret);
|
|
} else {
|
|
// If not provided, go via ptrcall, which is faster than resorting to regular call.
|
|
const void **argptrs = (const void **)alloca(argument_count * sizeof(void *));
|
|
for (uint32_t i = 0; i < argument_count; i++) {
|
|
argptrs[i] = VariantInternal::get_opaque_pointer(p_args[i]);
|
|
}
|
|
|
|
void *ret_opaque = nullptr;
|
|
if (r_ret) {
|
|
VariantInternal::initialize(r_ret, return_value_info.type);
|
|
ret_opaque = r_ret->get_type() == Variant::NIL ? r_ret : VariantInternal::get_opaque_pointer(r_ret);
|
|
}
|
|
|
|
ptrcall_func(method_userdata, extension_instance, reinterpret_cast<GDExtensionConstTypePtr *>(argptrs), (GDExtensionTypePtr)ret_opaque);
|
|
|
|
if (r_ret && r_ret->get_type() == Variant::OBJECT) {
|
|
VariantInternal::update_object_id(r_ret);
|
|
}
|
|
}
|
|
}
|
|
|
|
virtual void ptrcall(Object *p_object, const void **p_args, void *r_ret) const override {
|
|
#ifdef TOOLS_ENABLED
|
|
ERR_FAIL_COND_MSG(!valid, vformat("Cannot call invalid GDExtension method bind '%s'. It's probably cached - you may need to restart Godot.", name));
|
|
ERR_FAIL_COND_MSG(p_object && p_object->is_extension_placeholder(), vformat("Cannot call GDExtension method bind '%s' on placeholder instance.", name));
|
|
#endif
|
|
ERR_FAIL_COND_MSG(vararg, "Vararg methods don't have ptrcall support. This is most likely an engine bug.");
|
|
GDExtensionClassInstancePtr extension_instance = is_static() ? nullptr : p_object->_get_extension_instance();
|
|
ptrcall_func(method_userdata, extension_instance, reinterpret_cast<GDExtensionConstTypePtr *>(p_args), (GDExtensionTypePtr)r_ret);
|
|
}
|
|
|
|
virtual bool is_vararg() const override {
|
|
return false;
|
|
}
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
bool try_update(const GDExtensionClassMethodInfo *p_method_info) {
|
|
if (is_static() != (bool)(p_method_info->method_flags & GDEXTENSION_METHOD_FLAG_STATIC)) {
|
|
return false;
|
|
}
|
|
|
|
if (vararg != (bool)(p_method_info->method_flags & GDEXTENSION_METHOD_FLAG_VARARG)) {
|
|
return false;
|
|
}
|
|
|
|
if (has_return() != (bool)p_method_info->has_return_value) {
|
|
return false;
|
|
}
|
|
|
|
if (has_return() && return_value_info.type != (Variant::Type)p_method_info->return_value_info->type) {
|
|
return false;
|
|
}
|
|
|
|
if (argument_count != p_method_info->argument_count) {
|
|
return false;
|
|
}
|
|
|
|
List<PropertyInfo>::ConstIterator itr = arguments_info.begin();
|
|
for (uint32_t i = 0; i < p_method_info->argument_count; ++itr, ++i) {
|
|
if (itr->type != (Variant::Type)p_method_info->arguments_info[i].type) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
update(p_method_info);
|
|
return true;
|
|
}
|
|
#endif
|
|
|
|
void update(const GDExtensionClassMethodInfo *p_method_info) {
|
|
#ifdef TOOLS_ENABLED
|
|
name = *reinterpret_cast<StringName *>(p_method_info->name);
|
|
#endif
|
|
method_userdata = p_method_info->method_userdata;
|
|
call_func = p_method_info->call_func;
|
|
validated_call_func = nullptr;
|
|
ptrcall_func = p_method_info->ptrcall_func;
|
|
set_name(*reinterpret_cast<StringName *>(p_method_info->name));
|
|
|
|
if (p_method_info->has_return_value) {
|
|
return_value_info = PropertyInfo(*p_method_info->return_value_info);
|
|
return_value_metadata = GodotTypeInfo::Metadata(p_method_info->return_value_metadata);
|
|
}
|
|
|
|
arguments_info.clear();
|
|
arguments_metadata.clear();
|
|
for (uint32_t i = 0; i < p_method_info->argument_count; i++) {
|
|
arguments_info.push_back(PropertyInfo(p_method_info->arguments_info[i]));
|
|
arguments_metadata.push_back(GodotTypeInfo::Metadata(p_method_info->arguments_metadata[i]));
|
|
}
|
|
|
|
set_hint_flags(p_method_info->method_flags);
|
|
argument_count = p_method_info->argument_count;
|
|
vararg = p_method_info->method_flags & GDEXTENSION_METHOD_FLAG_VARARG;
|
|
_set_returns(p_method_info->has_return_value);
|
|
_set_const(p_method_info->method_flags & GDEXTENSION_METHOD_FLAG_CONST);
|
|
_set_static(p_method_info->method_flags & GDEXTENSION_METHOD_FLAG_STATIC);
|
|
#ifdef DEBUG_METHODS_ENABLED
|
|
_generate_argument_types(p_method_info->argument_count);
|
|
#endif
|
|
set_argument_count(p_method_info->argument_count);
|
|
|
|
Vector<Variant> defargs;
|
|
defargs.resize(p_method_info->default_argument_count);
|
|
for (uint32_t i = 0; i < p_method_info->default_argument_count; i++) {
|
|
defargs.write[i] = *static_cast<Variant *>(p_method_info->default_arguments[i]);
|
|
}
|
|
|
|
set_default_arguments(defargs);
|
|
}
|
|
|
|
explicit GDExtensionMethodBind(const GDExtensionClassMethodInfo *p_method_info) {
|
|
update(p_method_info);
|
|
}
|
|
};
|
|
|
|
#ifndef DISABLE_DEPRECATED
|
|
void GDExtension::_register_extension_class(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, GDExtensionConstStringNamePtr p_parent_class_name, const GDExtensionClassCreationInfo *p_extension_funcs) {
|
|
const GDExtensionClassCreationInfo3 class_info3 = {
|
|
p_extension_funcs->is_virtual, // GDExtensionBool is_virtual;
|
|
p_extension_funcs->is_abstract, // GDExtensionBool is_abstract;
|
|
true, // GDExtensionBool is_exposed;
|
|
false, // GDExtensionBool is_runtime;
|
|
p_extension_funcs->set_func, // GDExtensionClassSet set_func;
|
|
p_extension_funcs->get_func, // GDExtensionClassGet get_func;
|
|
p_extension_funcs->get_property_list_func, // GDExtensionClassGetPropertyList get_property_list_func;
|
|
nullptr, // GDExtensionClassFreePropertyList2 free_property_list_func;
|
|
p_extension_funcs->property_can_revert_func, // GDExtensionClassPropertyCanRevert property_can_revert_func;
|
|
p_extension_funcs->property_get_revert_func, // GDExtensionClassPropertyGetRevert property_get_revert_func;
|
|
nullptr, // GDExtensionClassValidateProperty validate_property_func;
|
|
nullptr, // GDExtensionClassNotification2 notification_func;
|
|
p_extension_funcs->to_string_func, // GDExtensionClassToString to_string_func;
|
|
p_extension_funcs->reference_func, // GDExtensionClassReference reference_func;
|
|
p_extension_funcs->unreference_func, // GDExtensionClassUnreference unreference_func;
|
|
p_extension_funcs->create_instance_func, // GDExtensionClassCreateInstance create_instance_func; /* this one is mandatory */
|
|
p_extension_funcs->free_instance_func, // GDExtensionClassFreeInstance free_instance_func; /* this one is mandatory */
|
|
nullptr, // GDExtensionClassRecreateInstance recreate_instance_func;
|
|
p_extension_funcs->get_virtual_func, // GDExtensionClassGetVirtual get_virtual_func;
|
|
nullptr, // GDExtensionClassGetVirtualCallData get_virtual_call_data_func;
|
|
nullptr, // GDExtensionClassCallVirtualWithData call_virtual_func;
|
|
p_extension_funcs->get_rid_func, // GDExtensionClassGetRID get_rid;
|
|
p_extension_funcs->class_userdata, // void *class_userdata;
|
|
};
|
|
|
|
const ClassCreationDeprecatedInfo legacy = {
|
|
p_extension_funcs->notification_func, // GDExtensionClassNotification notification_func;
|
|
p_extension_funcs->free_property_list_func, // GDExtensionClassFreePropertyList free_property_list_func;
|
|
};
|
|
_register_extension_class_internal(p_library, p_class_name, p_parent_class_name, &class_info3, &legacy);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class2(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, GDExtensionConstStringNamePtr p_parent_class_name, const GDExtensionClassCreationInfo2 *p_extension_funcs) {
|
|
const GDExtensionClassCreationInfo3 class_info3 = {
|
|
p_extension_funcs->is_virtual, // GDExtensionBool is_virtual;
|
|
p_extension_funcs->is_abstract, // GDExtensionBool is_abstract;
|
|
p_extension_funcs->is_exposed, // GDExtensionBool is_exposed;
|
|
false, // GDExtensionBool is_runtime;
|
|
p_extension_funcs->set_func, // GDExtensionClassSet set_func;
|
|
p_extension_funcs->get_func, // GDExtensionClassGet get_func;
|
|
p_extension_funcs->get_property_list_func, // GDExtensionClassGetPropertyList get_property_list_func;
|
|
nullptr, // GDExtensionClassFreePropertyList2 free_property_list_func;
|
|
p_extension_funcs->property_can_revert_func, // GDExtensionClassPropertyCanRevert property_can_revert_func;
|
|
p_extension_funcs->property_get_revert_func, // GDExtensionClassPropertyGetRevert property_get_revert_func;
|
|
p_extension_funcs->validate_property_func, // GDExtensionClassValidateProperty validate_property_func;
|
|
p_extension_funcs->notification_func, // GDExtensionClassNotification2 notification_func;
|
|
p_extension_funcs->to_string_func, // GDExtensionClassToString to_string_func;
|
|
p_extension_funcs->reference_func, // GDExtensionClassReference reference_func;
|
|
p_extension_funcs->unreference_func, // GDExtensionClassUnreference unreference_func;
|
|
p_extension_funcs->create_instance_func, // GDExtensionClassCreateInstance create_instance_func; /* this one is mandatory */
|
|
p_extension_funcs->free_instance_func, // GDExtensionClassFreeInstance free_instance_func; /* this one is mandatory */
|
|
p_extension_funcs->recreate_instance_func, // GDExtensionClassRecreateInstance recreate_instance_func;
|
|
p_extension_funcs->get_virtual_func, // GDExtensionClassGetVirtual get_virtual_func;
|
|
p_extension_funcs->get_virtual_call_data_func, // GDExtensionClassGetVirtualCallData get_virtual_call_data_func;
|
|
p_extension_funcs->call_virtual_with_data_func, // GDExtensionClassCallVirtualWithData call_virtual_func;
|
|
p_extension_funcs->get_rid_func, // GDExtensionClassGetRID get_rid;
|
|
p_extension_funcs->class_userdata, // void *class_userdata;
|
|
};
|
|
|
|
const ClassCreationDeprecatedInfo legacy = {
|
|
nullptr, // GDExtensionClassNotification notification_func;
|
|
p_extension_funcs->free_property_list_func, // GDExtensionClassFreePropertyList free_property_list_func;
|
|
};
|
|
_register_extension_class_internal(p_library, p_class_name, p_parent_class_name, &class_info3, &legacy);
|
|
}
|
|
#endif // DISABLE_DEPRECATED
|
|
|
|
void GDExtension::_register_extension_class3(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, GDExtensionConstStringNamePtr p_parent_class_name, const GDExtensionClassCreationInfo3 *p_extension_funcs) {
|
|
_register_extension_class_internal(p_library, p_class_name, p_parent_class_name, p_extension_funcs);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_internal(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, GDExtensionConstStringNamePtr p_parent_class_name, const GDExtensionClassCreationInfo3 *p_extension_funcs, const ClassCreationDeprecatedInfo *p_deprecated_funcs) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
StringName parent_class_name = *reinterpret_cast<const StringName *>(p_parent_class_name);
|
|
ERR_FAIL_COND_MSG(!String(class_name).is_valid_identifier(), "Attempt to register extension class '" + class_name + "', which is not a valid class identifier.");
|
|
ERR_FAIL_COND_MSG(ClassDB::class_exists(class_name), "Attempt to register extension class '" + class_name + "', which appears to be already registered.");
|
|
|
|
Extension *parent_extension = nullptr;
|
|
|
|
if (self->extension_classes.has(parent_class_name)) {
|
|
parent_extension = &self->extension_classes[parent_class_name];
|
|
} else if (ClassDB::class_exists(parent_class_name)) {
|
|
if (ClassDB::get_api_type(parent_class_name) == ClassDB::API_EXTENSION || ClassDB::get_api_type(parent_class_name) == ClassDB::API_EDITOR_EXTENSION) {
|
|
ERR_PRINT("Unimplemented yet");
|
|
//inheriting from another extension
|
|
} else {
|
|
//inheriting from engine class
|
|
}
|
|
} else {
|
|
ERR_FAIL_MSG("Attempt to register an extension class '" + String(class_name) + "' using non-existing parent class '" + String(parent_class_name) + "'.");
|
|
}
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
Extension *extension = nullptr;
|
|
bool is_runtime = (bool)p_extension_funcs->is_runtime;
|
|
if (self->is_reloading && self->extension_classes.has(class_name)) {
|
|
extension = &self->extension_classes[class_name];
|
|
if (!parent_extension && parent_class_name != extension->gdextension.parent_class_name) {
|
|
ERR_FAIL_MSG(vformat("GDExtension class '%s' cannot change parent type from '%s' to '%s' on hot reload. Restart Godot for this change to take effect.", class_name, extension->gdextension.parent_class_name, parent_class_name));
|
|
}
|
|
if (extension->gdextension.is_runtime != is_runtime) {
|
|
ERR_PRINT(vformat("GDExtension class '%s' cannot change to/from runtime class on hot reload. Restart Godot for this change to take effect.", class_name));
|
|
is_runtime = extension->gdextension.is_runtime;
|
|
}
|
|
extension->is_reloading = false;
|
|
} else {
|
|
self->extension_classes[class_name] = Extension();
|
|
extension = &self->extension_classes[class_name];
|
|
}
|
|
#else
|
|
self->extension_classes[class_name] = Extension();
|
|
Extension *extension = &self->extension_classes[class_name];
|
|
#endif
|
|
|
|
if (parent_extension) {
|
|
extension->gdextension.parent = &parent_extension->gdextension;
|
|
parent_extension->gdextension.children.push_back(&extension->gdextension);
|
|
}
|
|
|
|
if (self->reloadable && p_extension_funcs->recreate_instance_func == nullptr) {
|
|
ERR_PRINT(vformat("Extension marked as reloadable, but attempted to register class '%s' which doesn't support reloading. Perhaps your language binding don't support it? Reloading disabled for this extension.", class_name));
|
|
self->reloadable = false;
|
|
}
|
|
|
|
extension->gdextension.library = self;
|
|
extension->gdextension.parent_class_name = parent_class_name;
|
|
extension->gdextension.class_name = class_name;
|
|
extension->gdextension.editor_class = self->level_initialized == INITIALIZATION_LEVEL_EDITOR;
|
|
extension->gdextension.is_virtual = p_extension_funcs->is_virtual;
|
|
extension->gdextension.is_abstract = p_extension_funcs->is_abstract;
|
|
extension->gdextension.is_exposed = p_extension_funcs->is_exposed;
|
|
#ifdef TOOLS_ENABLED
|
|
extension->gdextension.is_runtime = is_runtime;
|
|
#endif
|
|
extension->gdextension.set = p_extension_funcs->set_func;
|
|
extension->gdextension.get = p_extension_funcs->get_func;
|
|
extension->gdextension.get_property_list = p_extension_funcs->get_property_list_func;
|
|
extension->gdextension.free_property_list2 = p_extension_funcs->free_property_list_func;
|
|
extension->gdextension.property_can_revert = p_extension_funcs->property_can_revert_func;
|
|
extension->gdextension.property_get_revert = p_extension_funcs->property_get_revert_func;
|
|
extension->gdextension.validate_property = p_extension_funcs->validate_property_func;
|
|
#ifndef DISABLE_DEPRECATED
|
|
if (p_deprecated_funcs) {
|
|
extension->gdextension.notification = p_deprecated_funcs->notification_func;
|
|
extension->gdextension.free_property_list = p_deprecated_funcs->free_property_list_func;
|
|
}
|
|
#endif // DISABLE_DEPRECATED
|
|
extension->gdextension.notification2 = p_extension_funcs->notification_func;
|
|
extension->gdextension.to_string = p_extension_funcs->to_string_func;
|
|
extension->gdextension.reference = p_extension_funcs->reference_func;
|
|
extension->gdextension.unreference = p_extension_funcs->unreference_func;
|
|
extension->gdextension.class_userdata = p_extension_funcs->class_userdata;
|
|
extension->gdextension.create_instance = p_extension_funcs->create_instance_func;
|
|
extension->gdextension.free_instance = p_extension_funcs->free_instance_func;
|
|
extension->gdextension.recreate_instance = p_extension_funcs->recreate_instance_func;
|
|
extension->gdextension.get_virtual = p_extension_funcs->get_virtual_func;
|
|
extension->gdextension.get_virtual_call_data = p_extension_funcs->get_virtual_call_data_func;
|
|
extension->gdextension.call_virtual_with_data = p_extension_funcs->call_virtual_with_data_func;
|
|
extension->gdextension.get_rid = p_extension_funcs->get_rid_func;
|
|
|
|
extension->gdextension.reloadable = self->reloadable;
|
|
#ifdef TOOLS_ENABLED
|
|
if (extension->gdextension.reloadable) {
|
|
extension->gdextension.tracking_userdata = extension;
|
|
extension->gdextension.track_instance = &GDExtension::_track_instance;
|
|
extension->gdextension.untrack_instance = &GDExtension::_untrack_instance;
|
|
} else {
|
|
extension->gdextension.tracking_userdata = nullptr;
|
|
extension->gdextension.track_instance = nullptr;
|
|
extension->gdextension.untrack_instance = nullptr;
|
|
}
|
|
#endif
|
|
|
|
ClassDB::register_extension_class(&extension->gdextension);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_method(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, const GDExtensionClassMethodInfo *p_method_info) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
StringName method_name = *reinterpret_cast<const StringName *>(p_method_info->name);
|
|
ERR_FAIL_COND_MSG(!self->extension_classes.has(class_name), "Attempt to register extension method '" + String(method_name) + "' for unexisting class '" + class_name + "'.");
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
Extension *extension = &self->extension_classes[class_name];
|
|
GDExtensionMethodBind *method = nullptr;
|
|
|
|
// If the extension is still marked as reloading, that means it failed to register again.
|
|
if (extension->is_reloading) {
|
|
return;
|
|
}
|
|
|
|
if (self->is_reloading && extension->methods.has(method_name)) {
|
|
method = extension->methods[method_name];
|
|
|
|
// Try to update the method bind. If it doesn't work (because it's incompatible) then
|
|
// mark as invalid and create a new one.
|
|
if (!method->is_reloading || !method->try_update(p_method_info)) {
|
|
method->valid = false;
|
|
self->invalid_methods.push_back(method);
|
|
|
|
method = nullptr;
|
|
}
|
|
}
|
|
|
|
if (method == nullptr) {
|
|
method = memnew(GDExtensionMethodBind(p_method_info));
|
|
method->set_instance_class(class_name);
|
|
extension->methods[method_name] = method;
|
|
} else {
|
|
method->is_reloading = false;
|
|
}
|
|
#else
|
|
GDExtensionMethodBind *method = memnew(GDExtensionMethodBind(p_method_info));
|
|
method->set_instance_class(class_name);
|
|
#endif
|
|
|
|
ClassDB::bind_method_custom(class_name, method);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_virtual_method(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, const GDExtensionClassVirtualMethodInfo *p_method_info) {
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
ClassDB::add_extension_class_virtual_method(class_name, p_method_info);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_integer_constant(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, GDExtensionConstStringNamePtr p_enum_name, GDExtensionConstStringNamePtr p_constant_name, GDExtensionInt p_constant_value, GDExtensionBool p_is_bitfield) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
StringName enum_name = *reinterpret_cast<const StringName *>(p_enum_name);
|
|
StringName constant_name = *reinterpret_cast<const StringName *>(p_constant_name);
|
|
ERR_FAIL_COND_MSG(!self->extension_classes.has(class_name), "Attempt to register extension constant '" + constant_name + "' for unexisting class '" + class_name + "'.");
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
// If the extension is still marked as reloading, that means it failed to register again.
|
|
Extension *extension = &self->extension_classes[class_name];
|
|
if (extension->is_reloading) {
|
|
return;
|
|
}
|
|
#endif
|
|
|
|
ClassDB::bind_integer_constant(class_name, enum_name, constant_name, p_constant_value, p_is_bitfield);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_property(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, const GDExtensionPropertyInfo *p_info, GDExtensionConstStringNamePtr p_setter, GDExtensionConstStringNamePtr p_getter) {
|
|
_register_extension_class_property_indexed(p_library, p_class_name, p_info, p_setter, p_getter, -1);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_property_indexed(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, const GDExtensionPropertyInfo *p_info, GDExtensionConstStringNamePtr p_setter, GDExtensionConstStringNamePtr p_getter, GDExtensionInt p_index) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
StringName setter = *reinterpret_cast<const StringName *>(p_setter);
|
|
StringName getter = *reinterpret_cast<const StringName *>(p_getter);
|
|
String property_name = *reinterpret_cast<const StringName *>(p_info->name);
|
|
ERR_FAIL_COND_MSG(!self->extension_classes.has(class_name), "Attempt to register extension class property '" + property_name + "' for unexisting class '" + class_name + "'.");
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
// If the extension is still marked as reloading, that means it failed to register again.
|
|
Extension *extension = &self->extension_classes[class_name];
|
|
if (extension->is_reloading) {
|
|
return;
|
|
}
|
|
#endif
|
|
|
|
PropertyInfo pinfo(*p_info);
|
|
|
|
ClassDB::add_property(class_name, pinfo, setter, getter, p_index);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_property_group(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, GDExtensionConstStringPtr p_group_name, GDExtensionConstStringPtr p_prefix) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
String group_name = *reinterpret_cast<const String *>(p_group_name);
|
|
String prefix = *reinterpret_cast<const String *>(p_prefix);
|
|
ERR_FAIL_COND_MSG(!self->extension_classes.has(class_name), "Attempt to register extension class property group '" + group_name + "' for unexisting class '" + class_name + "'.");
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
// If the extension is still marked as reloading, that means it failed to register again.
|
|
Extension *extension = &self->extension_classes[class_name];
|
|
if (extension->is_reloading) {
|
|
return;
|
|
}
|
|
#endif
|
|
|
|
ClassDB::add_property_group(class_name, group_name, prefix);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_property_subgroup(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, GDExtensionConstStringPtr p_subgroup_name, GDExtensionConstStringPtr p_prefix) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
String subgroup_name = *reinterpret_cast<const String *>(p_subgroup_name);
|
|
String prefix = *reinterpret_cast<const String *>(p_prefix);
|
|
ERR_FAIL_COND_MSG(!self->extension_classes.has(class_name), "Attempt to register extension class property subgroup '" + subgroup_name + "' for unexisting class '" + class_name + "'.");
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
// If the extension is still marked as reloading, that means it failed to register again.
|
|
Extension *extension = &self->extension_classes[class_name];
|
|
if (extension->is_reloading) {
|
|
return;
|
|
}
|
|
#endif
|
|
|
|
ClassDB::add_property_subgroup(class_name, subgroup_name, prefix);
|
|
}
|
|
|
|
void GDExtension::_register_extension_class_signal(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name, GDExtensionConstStringNamePtr p_signal_name, const GDExtensionPropertyInfo *p_argument_info, GDExtensionInt p_argument_count) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
StringName signal_name = *reinterpret_cast<const StringName *>(p_signal_name);
|
|
ERR_FAIL_COND_MSG(!self->extension_classes.has(class_name), "Attempt to register extension class signal '" + signal_name + "' for unexisting class '" + class_name + "'.");
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
// If the extension is still marked as reloading, that means it failed to register again.
|
|
Extension *extension = &self->extension_classes[class_name];
|
|
if (extension->is_reloading) {
|
|
return;
|
|
}
|
|
#endif
|
|
|
|
MethodInfo s;
|
|
s.name = signal_name;
|
|
for (int i = 0; i < p_argument_count; i++) {
|
|
PropertyInfo arg(p_argument_info[i]);
|
|
s.arguments.push_back(arg);
|
|
}
|
|
ClassDB::add_signal(class_name, s);
|
|
}
|
|
|
|
void GDExtension::_unregister_extension_class(GDExtensionClassLibraryPtr p_library, GDExtensionConstStringNamePtr p_class_name) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
StringName class_name = *reinterpret_cast<const StringName *>(p_class_name);
|
|
ERR_FAIL_COND_MSG(!self->extension_classes.has(class_name), "Attempt to unregister unexisting extension class '" + class_name + "'.");
|
|
|
|
Extension *ext = &self->extension_classes[class_name];
|
|
#ifdef TOOLS_ENABLED
|
|
if (ext->is_reloading) {
|
|
self->_clear_extension(ext);
|
|
}
|
|
#endif
|
|
ERR_FAIL_COND_MSG(ext->gdextension.children.size(), "Attempt to unregister class '" + class_name + "' while other extension classes inherit from it.");
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
ClassDB::unregister_extension_class(class_name, !ext->is_reloading);
|
|
#else
|
|
ClassDB::unregister_extension_class(class_name);
|
|
#endif
|
|
|
|
if (ext->gdextension.parent != nullptr) {
|
|
ext->gdextension.parent->children.erase(&ext->gdextension);
|
|
}
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
if (!ext->is_reloading) {
|
|
self->extension_classes.erase(class_name);
|
|
}
|
|
|
|
GDExtensionEditorHelp::remove_class(class_name);
|
|
#else
|
|
self->extension_classes.erase(class_name);
|
|
#endif
|
|
}
|
|
|
|
void GDExtension::_get_library_path(GDExtensionClassLibraryPtr p_library, GDExtensionUninitializedStringPtr r_path) {
|
|
GDExtension *self = reinterpret_cast<GDExtension *>(p_library);
|
|
|
|
memnew_placement(r_path, String(self->library_path));
|
|
}
|
|
|
|
HashMap<StringName, GDExtensionInterfaceFunctionPtr> GDExtension::gdextension_interface_functions;
|
|
|
|
void GDExtension::register_interface_function(const StringName &p_function_name, GDExtensionInterfaceFunctionPtr p_function_pointer) {
|
|
ERR_FAIL_COND_MSG(gdextension_interface_functions.has(p_function_name), "Attempt to register interface function '" + p_function_name + "', which appears to be already registered.");
|
|
gdextension_interface_functions.insert(p_function_name, p_function_pointer);
|
|
}
|
|
|
|
GDExtensionInterfaceFunctionPtr GDExtension::get_interface_function(const StringName &p_function_name) {
|
|
GDExtensionInterfaceFunctionPtr *function = gdextension_interface_functions.getptr(p_function_name);
|
|
ERR_FAIL_NULL_V_MSG(function, nullptr, "Attempt to get non-existent interface function: " + String(p_function_name) + ".");
|
|
return *function;
|
|
}
|
|
|
|
Error GDExtension::open_library(const String &p_path, const String &p_entry_symbol, Vector<SharedObject> *p_dependencies) {
|
|
String abs_path = ProjectSettings::get_singleton()->globalize_path(p_path);
|
|
|
|
Vector<String> abs_dependencies_paths;
|
|
if (p_dependencies != nullptr && !p_dependencies->is_empty()) {
|
|
for (const SharedObject &dependency : *p_dependencies) {
|
|
abs_dependencies_paths.push_back(ProjectSettings::get_singleton()->globalize_path(dependency.path));
|
|
}
|
|
}
|
|
|
|
OS::GDExtensionData data = {
|
|
true, // also_set_library_path
|
|
&library_path, // r_resolved_path
|
|
Engine::get_singleton()->is_editor_hint(), // generate_temp_files
|
|
&abs_dependencies_paths, // library_dependencies
|
|
};
|
|
Error err = OS::get_singleton()->open_dynamic_library(abs_path, library, &data);
|
|
|
|
ERR_FAIL_COND_V_MSG(err == ERR_FILE_NOT_FOUND, err, "GDExtension dynamic library not found: " + abs_path);
|
|
ERR_FAIL_COND_V_MSG(err != OK, err, "Can't open GDExtension dynamic library: " + abs_path);
|
|
|
|
void *entry_funcptr = nullptr;
|
|
|
|
err = OS::get_singleton()->get_dynamic_library_symbol_handle(library, p_entry_symbol, entry_funcptr, false);
|
|
|
|
if (err != OK) {
|
|
ERR_PRINT("GDExtension entry point '" + p_entry_symbol + "' not found in library " + abs_path);
|
|
OS::get_singleton()->close_dynamic_library(library);
|
|
return err;
|
|
}
|
|
|
|
GDExtensionInitializationFunction initialization_function = (GDExtensionInitializationFunction)entry_funcptr;
|
|
GDExtensionBool ret = initialization_function(&gdextension_get_proc_address, this, &initialization);
|
|
|
|
if (ret) {
|
|
level_initialized = -1;
|
|
return OK;
|
|
} else {
|
|
ERR_PRINT("GDExtension initialization function '" + p_entry_symbol + "' returned an error.");
|
|
OS::get_singleton()->close_dynamic_library(library);
|
|
return FAILED;
|
|
}
|
|
}
|
|
|
|
void GDExtension::close_library() {
|
|
ERR_FAIL_NULL(library);
|
|
OS::get_singleton()->close_dynamic_library(library);
|
|
|
|
library = nullptr;
|
|
class_icon_paths.clear();
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
instance_bindings.clear();
|
|
#endif
|
|
}
|
|
|
|
bool GDExtension::is_library_open() const {
|
|
return library != nullptr;
|
|
}
|
|
|
|
GDExtension::InitializationLevel GDExtension::get_minimum_library_initialization_level() const {
|
|
ERR_FAIL_NULL_V(library, INITIALIZATION_LEVEL_CORE);
|
|
return InitializationLevel(initialization.minimum_initialization_level);
|
|
}
|
|
|
|
void GDExtension::initialize_library(InitializationLevel p_level) {
|
|
ERR_FAIL_NULL(library);
|
|
ERR_FAIL_COND_MSG(p_level <= int32_t(level_initialized), vformat("Level '%d' must be higher than the current level '%d'", p_level, level_initialized));
|
|
|
|
level_initialized = int32_t(p_level);
|
|
|
|
ERR_FAIL_NULL(initialization.initialize);
|
|
|
|
initialization.initialize(initialization.userdata, GDExtensionInitializationLevel(p_level));
|
|
}
|
|
void GDExtension::deinitialize_library(InitializationLevel p_level) {
|
|
ERR_FAIL_NULL(library);
|
|
ERR_FAIL_COND(p_level > int32_t(level_initialized));
|
|
|
|
level_initialized = int32_t(p_level) - 1;
|
|
|
|
ERR_FAIL_NULL(initialization.deinitialize);
|
|
|
|
initialization.deinitialize(initialization.userdata, GDExtensionInitializationLevel(p_level));
|
|
}
|
|
|
|
void GDExtension::_bind_methods() {
|
|
ClassDB::bind_method(D_METHOD("is_library_open"), &GDExtension::is_library_open);
|
|
ClassDB::bind_method(D_METHOD("get_minimum_library_initialization_level"), &GDExtension::get_minimum_library_initialization_level);
|
|
|
|
BIND_ENUM_CONSTANT(INITIALIZATION_LEVEL_CORE);
|
|
BIND_ENUM_CONSTANT(INITIALIZATION_LEVEL_SERVERS);
|
|
BIND_ENUM_CONSTANT(INITIALIZATION_LEVEL_SCENE);
|
|
BIND_ENUM_CONSTANT(INITIALIZATION_LEVEL_EDITOR);
|
|
}
|
|
|
|
GDExtension::GDExtension() {
|
|
}
|
|
|
|
GDExtension::~GDExtension() {
|
|
if (library != nullptr) {
|
|
close_library();
|
|
}
|
|
#ifdef TOOLS_ENABLED
|
|
// If we have any invalid method binds still laying around, we can finally free them!
|
|
for (GDExtensionMethodBind *E : invalid_methods) {
|
|
memdelete(E);
|
|
}
|
|
#endif
|
|
}
|
|
|
|
void GDExtension::initialize_gdextensions() {
|
|
gdextension_setup_interface();
|
|
|
|
#ifndef DISABLE_DEPRECATED
|
|
register_interface_function("classdb_register_extension_class", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class);
|
|
register_interface_function("classdb_register_extension_class2", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class2);
|
|
#endif // DISABLE_DEPRECATED
|
|
register_interface_function("classdb_register_extension_class3", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class3);
|
|
register_interface_function("classdb_register_extension_class_method", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class_method);
|
|
register_interface_function("classdb_register_extension_class_virtual_method", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class_virtual_method);
|
|
register_interface_function("classdb_register_extension_class_integer_constant", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class_integer_constant);
|
|
register_interface_function("classdb_register_extension_class_property", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class_property);
|
|
register_interface_function("classdb_register_extension_class_property_indexed", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class_property_indexed);
|
|
register_interface_function("classdb_register_extension_class_property_group", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class_property_group);
|
|
register_interface_function("classdb_register_extension_class_property_subgroup", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class_property_subgroup);
|
|
register_interface_function("classdb_register_extension_class_signal", (GDExtensionInterfaceFunctionPtr)&GDExtension::_register_extension_class_signal);
|
|
register_interface_function("classdb_unregister_extension_class", (GDExtensionInterfaceFunctionPtr)&GDExtension::_unregister_extension_class);
|
|
register_interface_function("get_library_path", (GDExtensionInterfaceFunctionPtr)&GDExtension::_get_library_path);
|
|
}
|
|
|
|
void GDExtension::finalize_gdextensions() {
|
|
gdextension_interface_functions.clear();
|
|
}
|
|
|
|
Error GDExtensionResourceLoader::load_gdextension_resource(const String &p_path, Ref<GDExtension> &p_extension) {
|
|
ERR_FAIL_COND_V_MSG(p_extension.is_valid() && p_extension->is_library_open(), ERR_ALREADY_IN_USE, "Cannot load GDExtension resource into already opened library.");
|
|
|
|
Ref<ConfigFile> config;
|
|
config.instantiate();
|
|
|
|
Error err = config->load(p_path);
|
|
|
|
if (err != OK) {
|
|
ERR_PRINT("Error loading GDExtension configuration file: " + p_path);
|
|
return err;
|
|
}
|
|
|
|
if (!config->has_section_key("configuration", "entry_symbol")) {
|
|
ERR_PRINT("GDExtension configuration file must contain a \"configuration/entry_symbol\" key: " + p_path);
|
|
return ERR_INVALID_DATA;
|
|
}
|
|
|
|
String entry_symbol = config->get_value("configuration", "entry_symbol");
|
|
|
|
uint32_t compatibility_minimum[3] = { 0, 0, 0 };
|
|
if (config->has_section_key("configuration", "compatibility_minimum")) {
|
|
String compat_string = config->get_value("configuration", "compatibility_minimum");
|
|
Vector<int> parts = compat_string.split_ints(".");
|
|
for (int i = 0; i < parts.size(); i++) {
|
|
if (i >= 3) {
|
|
break;
|
|
}
|
|
if (parts[i] >= 0) {
|
|
compatibility_minimum[i] = parts[i];
|
|
}
|
|
}
|
|
} else {
|
|
ERR_PRINT("GDExtension configuration file must contain a \"configuration/compatibility_minimum\" key: " + p_path);
|
|
return ERR_INVALID_DATA;
|
|
}
|
|
|
|
if (compatibility_minimum[0] < 4 || (compatibility_minimum[0] == 4 && compatibility_minimum[1] == 0)) {
|
|
ERR_PRINT(vformat("GDExtension's compatibility_minimum (%d.%d.%d) must be at least 4.1.0: %s", compatibility_minimum[0], compatibility_minimum[1], compatibility_minimum[2], p_path));
|
|
return ERR_INVALID_DATA;
|
|
}
|
|
|
|
bool compatible = true;
|
|
// Check version lexicographically.
|
|
if (VERSION_MAJOR != compatibility_minimum[0]) {
|
|
compatible = VERSION_MAJOR > compatibility_minimum[0];
|
|
} else if (VERSION_MINOR != compatibility_minimum[1]) {
|
|
compatible = VERSION_MINOR > compatibility_minimum[1];
|
|
} else {
|
|
compatible = VERSION_PATCH >= compatibility_minimum[2];
|
|
}
|
|
if (!compatible) {
|
|
ERR_PRINT(vformat("GDExtension only compatible with Godot version %d.%d.%d or later: %s", compatibility_minimum[0], compatibility_minimum[1], compatibility_minimum[2], p_path));
|
|
return ERR_INVALID_DATA;
|
|
}
|
|
|
|
// Optionally check maximum compatibility.
|
|
if (config->has_section_key("configuration", "compatibility_maximum")) {
|
|
uint32_t compatibility_maximum[3] = { 0, 0, 0 };
|
|
String compat_string = config->get_value("configuration", "compatibility_maximum");
|
|
Vector<int> parts = compat_string.split_ints(".");
|
|
for (int i = 0; i < 3; i++) {
|
|
if (i < parts.size() && parts[i] >= 0) {
|
|
compatibility_maximum[i] = parts[i];
|
|
} else {
|
|
// If a version part is missing, set the maximum to an arbitrary high value.
|
|
compatibility_maximum[i] = 9999;
|
|
}
|
|
}
|
|
|
|
compatible = true;
|
|
if (VERSION_MAJOR != compatibility_maximum[0]) {
|
|
compatible = VERSION_MAJOR < compatibility_maximum[0];
|
|
} else if (VERSION_MINOR != compatibility_maximum[1]) {
|
|
compatible = VERSION_MINOR < compatibility_maximum[1];
|
|
}
|
|
#if VERSION_PATCH
|
|
// #if check to avoid -Wtype-limits warning when 0.
|
|
else {
|
|
compatible = VERSION_PATCH <= compatibility_maximum[2];
|
|
}
|
|
#endif
|
|
|
|
if (!compatible) {
|
|
ERR_PRINT(vformat("GDExtension only compatible with Godot version %s or earlier: %s", compat_string, p_path));
|
|
return ERR_INVALID_DATA;
|
|
}
|
|
}
|
|
|
|
String library_path = GDExtension::find_extension_library(p_path, config, [](const String &p_feature) { return OS::get_singleton()->has_feature(p_feature); });
|
|
|
|
if (library_path.is_empty()) {
|
|
const String os_arch = OS::get_singleton()->get_name().to_lower() + "." + Engine::get_singleton()->get_architecture_name();
|
|
ERR_PRINT(vformat("No GDExtension library found for current OS and architecture (%s) in configuration file: %s", os_arch, p_path));
|
|
return ERR_FILE_NOT_FOUND;
|
|
}
|
|
|
|
bool is_static_library = library_path.ends_with(".a") || library_path.ends_with(".xcframework");
|
|
|
|
if (!library_path.is_resource_file() && !library_path.is_absolute_path()) {
|
|
library_path = p_path.get_base_dir().path_join(library_path);
|
|
}
|
|
|
|
if (p_extension.is_null()) {
|
|
p_extension.instantiate();
|
|
}
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
p_extension->set_reloadable(config->get_value("configuration", "reloadable", false) && Engine::get_singleton()->is_extension_reloading_enabled());
|
|
|
|
p_extension->update_last_modified_time(
|
|
FileAccess::get_modified_time(p_path),
|
|
FileAccess::get_modified_time(library_path));
|
|
#endif
|
|
|
|
Vector<SharedObject> library_dependencies = GDExtension::find_extension_dependencies(p_path, config, [](const String &p_feature) { return OS::get_singleton()->has_feature(p_feature); });
|
|
err = p_extension->open_library(is_static_library ? String() : library_path, entry_symbol, &library_dependencies);
|
|
if (err != OK) {
|
|
// Unreference the extension so that this loading can be considered a failure.
|
|
p_extension.unref();
|
|
|
|
// Errors already logged in open_library()
|
|
return err;
|
|
}
|
|
|
|
// Handle icons if any are specified.
|
|
if (config->has_section("icons")) {
|
|
List<String> keys;
|
|
config->get_section_keys("icons", &keys);
|
|
for (const String &key : keys) {
|
|
String icon_path = config->get_value("icons", key);
|
|
if (icon_path.is_relative_path()) {
|
|
icon_path = p_path.get_base_dir().path_join(icon_path);
|
|
}
|
|
|
|
p_extension->class_icon_paths[key] = icon_path;
|
|
}
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
Ref<Resource> GDExtensionResourceLoader::load(const String &p_path, const String &p_original_path, Error *r_error, bool p_use_sub_threads, float *r_progress, CacheMode p_cache_mode) {
|
|
// We can't have two GDExtension resource object representing the same library, because
|
|
// loading (or unloading) a GDExtension affects global data. So, we need reuse the same
|
|
// object if one has already been loaded (even if caching is disabled at the resource
|
|
// loader level).
|
|
GDExtensionManager *manager = GDExtensionManager::get_singleton();
|
|
if (manager->is_extension_loaded(p_path)) {
|
|
return manager->get_extension(p_path);
|
|
}
|
|
|
|
Ref<GDExtension> lib;
|
|
Error err = load_gdextension_resource(p_path, lib);
|
|
if (err != OK && r_error) {
|
|
// Errors already logged in load_gdextension_resource().
|
|
*r_error = err;
|
|
}
|
|
return lib;
|
|
}
|
|
|
|
void GDExtensionResourceLoader::get_recognized_extensions(List<String> *p_extensions) const {
|
|
p_extensions->push_back("gdextension");
|
|
}
|
|
|
|
bool GDExtensionResourceLoader::handles_type(const String &p_type) const {
|
|
return p_type == "GDExtension";
|
|
}
|
|
|
|
String GDExtensionResourceLoader::get_resource_type(const String &p_path) const {
|
|
String el = p_path.get_extension().to_lower();
|
|
if (el == "gdextension") {
|
|
return "GDExtension";
|
|
}
|
|
return "";
|
|
}
|
|
|
|
#ifdef TOOLS_ENABLED
|
|
bool GDExtension::has_library_changed() const {
|
|
// Check only that the last modified time is different (rather than checking
|
|
// that it's newer) since some OS's (namely Windows) will preserve the modified
|
|
// time by default when copying files.
|
|
if (FileAccess::get_modified_time(get_path()) != resource_last_modified_time) {
|
|
return true;
|
|
}
|
|
if (FileAccess::get_modified_time(library_path) != library_last_modified_time) {
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
void GDExtension::prepare_reload() {
|
|
is_reloading = true;
|
|
|
|
for (KeyValue<StringName, Extension> &E : extension_classes) {
|
|
E.value.is_reloading = true;
|
|
|
|
for (KeyValue<StringName, GDExtensionMethodBind *> &M : E.value.methods) {
|
|
M.value->is_reloading = true;
|
|
}
|
|
|
|
for (const ObjectID &obj_id : E.value.instances) {
|
|
Object *obj = ObjectDB::get_instance(obj_id);
|
|
if (!obj) {
|
|
continue;
|
|
}
|
|
|
|
// Store instance state so it can be restored after reload.
|
|
List<Pair<String, Variant>> state;
|
|
List<PropertyInfo> prop_list;
|
|
obj->get_property_list(&prop_list);
|
|
for (const PropertyInfo &P : prop_list) {
|
|
if (!(P.usage & PROPERTY_USAGE_STORAGE)) {
|
|
continue;
|
|
}
|
|
|
|
Variant value = obj->get(P.name);
|
|
Variant default_value = ClassDB::class_get_default_property_value(obj->get_class_name(), P.name);
|
|
|
|
if (default_value.get_type() != Variant::NIL && bool(Variant::evaluate(Variant::OP_EQUAL, value, default_value))) {
|
|
continue;
|
|
}
|
|
|
|
if (P.type == Variant::OBJECT && value.is_zero() && !(P.usage & PROPERTY_USAGE_STORE_IF_NULL)) {
|
|
continue;
|
|
}
|
|
|
|
state.push_back(Pair<String, Variant>(P.name, value));
|
|
}
|
|
E.value.instance_state[obj_id] = {
|
|
state, // List<Pair<String, Variant>> properties;
|
|
obj->is_extension_placeholder(), // bool is_placeholder;
|
|
};
|
|
}
|
|
}
|
|
}
|
|
|
|
void GDExtension::_clear_extension(Extension *p_extension) {
|
|
// Clear out hierarchy information because it may change.
|
|
p_extension->gdextension.parent = nullptr;
|
|
p_extension->gdextension.children.clear();
|
|
|
|
// Clear all objects of any GDExtension data. It will become its native parent class
|
|
// until the reload can reset the object with the new GDExtension data.
|
|
for (const ObjectID &obj_id : p_extension->instances) {
|
|
Object *obj = ObjectDB::get_instance(obj_id);
|
|
if (!obj) {
|
|
continue;
|
|
}
|
|
|
|
obj->clear_internal_extension();
|
|
}
|
|
}
|
|
|
|
void GDExtension::track_instance_binding(Object *p_object) {
|
|
instance_bindings.push_back(p_object->get_instance_id());
|
|
}
|
|
|
|
void GDExtension::untrack_instance_binding(Object *p_object) {
|
|
instance_bindings.erase(p_object->get_instance_id());
|
|
}
|
|
|
|
void GDExtension::clear_instance_bindings() {
|
|
for (ObjectID obj_id : instance_bindings) {
|
|
Object *obj = ObjectDB::get_instance(obj_id);
|
|
if (!obj) {
|
|
continue;
|
|
}
|
|
|
|
obj->free_instance_binding(this);
|
|
}
|
|
instance_bindings.clear();
|
|
}
|
|
|
|
void GDExtension::finish_reload() {
|
|
is_reloading = false;
|
|
|
|
// Clean up any classes or methods that didn't get re-added.
|
|
Vector<StringName> classes_to_remove;
|
|
for (KeyValue<StringName, Extension> &E : extension_classes) {
|
|
if (E.value.is_reloading) {
|
|
E.value.is_reloading = false;
|
|
classes_to_remove.push_back(E.key);
|
|
}
|
|
|
|
Vector<StringName> methods_to_remove;
|
|
for (KeyValue<StringName, GDExtensionMethodBind *> &M : E.value.methods) {
|
|
if (M.value->is_reloading) {
|
|
M.value->valid = false;
|
|
invalid_methods.push_back(M.value);
|
|
|
|
M.value->is_reloading = false;
|
|
methods_to_remove.push_back(M.key);
|
|
}
|
|
}
|
|
for (const StringName &method_name : methods_to_remove) {
|
|
E.value.methods.erase(method_name);
|
|
}
|
|
}
|
|
for (const StringName &class_name : classes_to_remove) {
|
|
extension_classes.erase(class_name);
|
|
}
|
|
|
|
// Reset any the extension on instances made from the classes that remain.
|
|
for (KeyValue<StringName, Extension> &E : extension_classes) {
|
|
// Loop over 'instance_state' rather than 'instance' because new instances
|
|
// may have been created when re-initializing the extension.
|
|
for (const KeyValue<ObjectID, Extension::InstanceState> &S : E.value.instance_state) {
|
|
Object *obj = ObjectDB::get_instance(S.key);
|
|
if (!obj) {
|
|
continue;
|
|
}
|
|
|
|
if (S.value.is_placeholder) {
|
|
obj->reset_internal_extension(ClassDB::get_placeholder_extension(E.value.gdextension.class_name));
|
|
} else {
|
|
obj->reset_internal_extension(&E.value.gdextension);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Now that all the classes are back, restore the state.
|
|
for (KeyValue<StringName, Extension> &E : extension_classes) {
|
|
for (const KeyValue<ObjectID, Extension::InstanceState> &S : E.value.instance_state) {
|
|
Object *obj = ObjectDB::get_instance(S.key);
|
|
if (!obj) {
|
|
continue;
|
|
}
|
|
|
|
for (const Pair<String, Variant> &state : S.value.properties) {
|
|
obj->set(state.first, state.second);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Finally, let the objects know that we are done reloading them.
|
|
for (KeyValue<StringName, Extension> &E : extension_classes) {
|
|
for (const KeyValue<ObjectID, Extension::InstanceState> &S : E.value.instance_state) {
|
|
Object *obj = ObjectDB::get_instance(S.key);
|
|
if (!obj) {
|
|
continue;
|
|
}
|
|
|
|
obj->notification(NOTIFICATION_EXTENSION_RELOADED);
|
|
}
|
|
|
|
// Clear the instance state, we're done looping.
|
|
E.value.instance_state.clear();
|
|
}
|
|
}
|
|
|
|
void GDExtension::_track_instance(void *p_user_data, void *p_instance) {
|
|
Extension *extension = reinterpret_cast<Extension *>(p_user_data);
|
|
Object *obj = reinterpret_cast<Object *>(p_instance);
|
|
|
|
extension->instances.insert(obj->get_instance_id());
|
|
}
|
|
|
|
void GDExtension::_untrack_instance(void *p_user_data, void *p_instance) {
|
|
Extension *extension = reinterpret_cast<Extension *>(p_user_data);
|
|
Object *obj = reinterpret_cast<Object *>(p_instance);
|
|
|
|
extension->instances.erase(obj->get_instance_id());
|
|
}
|
|
|
|
Vector<StringName> GDExtensionEditorPlugins::extension_classes;
|
|
GDExtensionEditorPlugins::EditorPluginRegisterFunc GDExtensionEditorPlugins::editor_node_add_plugin = nullptr;
|
|
GDExtensionEditorPlugins::EditorPluginRegisterFunc GDExtensionEditorPlugins::editor_node_remove_plugin = nullptr;
|
|
|
|
void GDExtensionEditorPlugins::add_extension_class(const StringName &p_class_name) {
|
|
if (editor_node_add_plugin) {
|
|
editor_node_add_plugin(p_class_name);
|
|
} else {
|
|
extension_classes.push_back(p_class_name);
|
|
}
|
|
}
|
|
|
|
void GDExtensionEditorPlugins::remove_extension_class(const StringName &p_class_name) {
|
|
if (editor_node_remove_plugin) {
|
|
editor_node_remove_plugin(p_class_name);
|
|
} else {
|
|
extension_classes.erase(p_class_name);
|
|
}
|
|
}
|
|
|
|
GDExtensionEditorHelp::EditorHelpLoadXmlBufferFunc GDExtensionEditorHelp::editor_help_load_xml_buffer = nullptr;
|
|
GDExtensionEditorHelp::EditorHelpRemoveClassFunc GDExtensionEditorHelp::editor_help_remove_class = nullptr;
|
|
|
|
void GDExtensionEditorHelp::load_xml_buffer(const uint8_t *p_buffer, int p_size) {
|
|
ERR_FAIL_NULL(editor_help_load_xml_buffer);
|
|
editor_help_load_xml_buffer(p_buffer, p_size);
|
|
}
|
|
|
|
void GDExtensionEditorHelp::remove_class(const String &p_class) {
|
|
ERR_FAIL_NULL(editor_help_remove_class);
|
|
editor_help_remove_class(p_class);
|
|
}
|
|
#endif // TOOLS_ENABLED
|