2021-06-19 15:58:49 +00:00
/**************************************************************************/
2022-12-07 11:11:28 +00:00
/* gdextension.cpp */
2021-06-19 15:58:49 +00:00
/**************************************************************************/
/* 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. */
/**************************************************************************/
2022-12-07 11:11:28 +00:00
# include "gdextension.h"
2024-05-03 06:38:45 +00:00
# include "gdextension.compat.inc"
2021-07-29 13:53:05 +00:00
# include "core/config/project_settings.h"
2021-06-19 15:58:49 +00:00
# include "core/object/class_db.h"
# include "core/object/method_bind.h"
2024-04-23 23:32:25 +00:00
# include "gdextension_library_loader.h"
2023-10-13 17:54:21 +00:00
# include "gdextension_manager.h"
2023-04-24 15:15:27 +00:00
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 ) ;
2021-06-19 15:58:49 +00:00
2022-12-07 11:11:28 +00:00
String GDExtension : : get_extension_list_config_file ( ) {
2022-08-30 00:34:01 +00:00
return ProjectSettings : : get_singleton ( ) - > get_project_data_path ( ) . path_join ( " extension_list.cfg " ) ;
2021-09-10 15:32:29 +00:00
}
2021-08-20 18:32:56 +00:00
2022-12-07 11:11:28 +00:00
class GDExtensionMethodBind : public MethodBind {
GDExtensionClassMethodCall call_func ;
2023-04-24 22:21:32 +00:00
GDExtensionClassMethodValidatedCall validated_call_func ;
2022-12-07 11:11:28 +00:00
GDExtensionClassMethodPtrCall ptrcall_func ;
2021-06-19 15:58:49 +00:00
void * method_userdata ;
bool vararg ;
2023-04-24 22:21:32 +00:00
uint32_t argument_count ;
2022-10-23 08:43:09 +00:00
PropertyInfo return_value_info ;
GodotTypeInfo : : Metadata return_value_metadata ;
List < PropertyInfo > arguments_info ;
List < GodotTypeInfo : : Metadata > arguments_metadata ;
2021-06-19 15:58:49 +00:00
2023-08-05 01:34:14 +00:00
# ifdef TOOLS_ENABLED
friend class GDExtension ;
StringName name ;
bool is_reloading = false ;
bool valid = true ;
# endif
2021-06-19 15:58:49 +00:00
protected :
2022-04-07 10:23:40 +00:00
virtual Variant : : Type _gen_argument_type ( int p_arg ) const override {
2022-10-23 08:43:09 +00:00
if ( p_arg < 0 ) {
return return_value_info . type ;
} else {
2024-04-15 13:18:34 +00:00
return arguments_info . get ( p_arg ) . type ;
2022-10-23 08:43:09 +00:00
}
2021-06-19 15:58:49 +00:00
}
2022-04-07 10:23:40 +00:00
virtual PropertyInfo _gen_argument_type_info ( int p_arg ) const override {
2022-10-23 08:43:09 +00:00
if ( p_arg < 0 ) {
return return_value_info ;
} else {
2024-04-15 13:18:34 +00:00
return arguments_info . get ( p_arg ) ;
2022-10-23 08:43:09 +00:00
}
2021-06-19 15:58:49 +00:00
}
public :
2023-08-05 01:34:14 +00:00
# ifdef TOOLS_ENABLED
virtual bool is_valid ( ) const override { return valid ; }
# endif
2022-04-07 10:23:40 +00:00
# ifdef DEBUG_METHODS_ENABLED
virtual GodotTypeInfo : : Metadata get_argument_meta ( int p_arg ) const override {
2022-10-23 08:43:09 +00:00
if ( p_arg < 0 ) {
return return_value_metadata ;
} else {
2024-04-15 13:18:34 +00:00
return arguments_metadata . get ( p_arg ) ;
2022-10-23 08:43:09 +00:00
}
2021-06-19 15:58:49 +00:00
}
2022-04-07 10:23:40 +00:00
# endif
2021-06-19 15:58:49 +00:00
2022-10-22 13:18:33 +00:00
virtual Variant call ( Object * p_object , const Variant * * p_args , int p_arg_count , Callable : : CallError & r_error ) const override {
2023-08-05 01:34:14 +00:00
# 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 ) ) ;
2024-01-02 20:10:54 +00:00
ERR_FAIL_COND_V_MSG ( p_object & & p_object - > is_extension_placeholder ( ) , Variant ( ) , vformat ( " Cannot call GDExtension method bind '%s' on placeholder instance. " , name ) ) ;
2023-08-05 01:34:14 +00:00
# endif
2021-06-19 15:58:49 +00:00
Variant ret ;
2022-05-06 06:44:13 +00:00
GDExtensionClassInstancePtr extension_instance = is_static ( ) ? nullptr : p_object - > _get_extension_instance ( ) ;
2022-12-07 11:11:28 +00:00
GDExtensionCallError ce { GDEXTENSION_CALL_OK , 0 , 0 } ;
call_func ( method_userdata , extension_instance , reinterpret_cast < GDExtensionConstVariantPtr * > ( p_args ) , p_arg_count , ( GDExtensionVariantPtr ) & ret , & ce ) ;
2021-06-19 15:58:49 +00:00
r_error . error = Callable : : CallError : : Error ( ce . error ) ;
r_error . argument = ce . argument ;
r_error . expected = ce . expected ;
return ret ;
}
2023-04-24 22:21:32 +00:00
virtual void validated_call ( Object * p_object , const Variant * * p_args , Variant * r_ret ) const override {
2023-08-05 01:34:14 +00:00
# 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 ) ) ;
2024-01-02 20:10:54 +00:00
ERR_FAIL_COND_MSG ( p_object & & p_object - > is_extension_placeholder ( ) , vformat ( " Cannot call GDExtension method bind '%s' on placeholder instance. " , name ) ) ;
2023-08-05 01:34:14 +00:00
# endif
2023-10-10 13:39:35 +00:00
ERR_FAIL_COND_MSG ( vararg , " Vararg methods don't have validated call support. This is most likely an engine bug. " ) ;
2023-04-24 22:21:32 +00:00
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 ] ) ;
}
2023-10-04 15:00:52 +00:00
void * ret_opaque = nullptr ;
if ( r_ret ) {
VariantInternal : : initialize ( r_ret , return_value_info . type ) ;
2023-10-09 15:59:45 +00:00
ret_opaque = r_ret - > get_type ( ) = = Variant : : NIL ? r_ret : VariantInternal : : get_opaque_pointer ( r_ret ) ;
2023-04-24 22:21:32 +00:00
}
2024-04-25 12:37:38 +00:00
ptrcall_func ( method_userdata , extension_instance , reinterpret_cast < GDExtensionConstTypePtr * > ( argptrs ) , ( GDExtensionTypePtr ) ret_opaque ) ;
2023-10-04 15:00:52 +00:00
if ( r_ret & & r_ret - > get_type ( ) = = Variant : : OBJECT ) {
VariantInternal : : update_object_id ( r_ret ) ;
}
2023-04-24 22:21:32 +00:00
}
}
2022-10-22 13:18:33 +00:00
virtual void ptrcall ( Object * p_object , const void * * p_args , void * r_ret ) const override {
2023-08-05 01:34:14 +00:00
# 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 ) ) ;
2024-01-02 20:10:54 +00:00
ERR_FAIL_COND_MSG ( p_object & & p_object - > is_extension_placeholder ( ) , vformat ( " Cannot call GDExtension method bind '%s' on placeholder instance. " , name ) ) ;
2023-08-05 01:34:14 +00:00
# endif
2021-06-19 15:58:49 +00:00
ERR_FAIL_COND_MSG ( vararg , " Vararg methods don't have ptrcall support. This is most likely an engine bug. " ) ;
2024-04-25 12:37:38 +00:00
GDExtensionClassInstancePtr extension_instance = is_static ( ) ? nullptr : p_object - > _get_extension_instance ( ) ;
2022-12-07 11:11:28 +00:00
ptrcall_func ( method_userdata , extension_instance , reinterpret_cast < GDExtensionConstTypePtr * > ( p_args ) , ( GDExtensionTypePtr ) r_ret ) ;
2021-06-19 15:58:49 +00:00
}
2022-04-07 10:23:40 +00:00
virtual bool is_vararg ( ) const override {
2021-06-19 15:58:49 +00:00
return false ;
}
2022-05-06 06:44:13 +00:00
2023-08-05 01:34:14 +00:00
# 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 ;
}
2024-04-15 13:18:34 +00:00
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 ) {
2023-08-05 01:34:14 +00:00
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
2021-06-19 15:58:49 +00:00
method_userdata = p_method_info - > method_userdata ;
call_func = p_method_info - > call_func ;
2023-04-24 22:21:32 +00:00
validated_call_func = nullptr ;
2021-06-19 15:58:49 +00:00
ptrcall_func = p_method_info - > ptrcall_func ;
2022-10-23 08:43:09 +00:00
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 ) ;
}
2023-08-05 01:34:14 +00:00
arguments_info . clear ( ) ;
arguments_metadata . clear ( ) ;
2022-10-23 08:43:09 +00:00
for ( uint32_t i = 0 ; i < p_method_info - > argument_count ; i + + ) {
2022-11-15 23:51:48 +00:00
arguments_info . push_back ( PropertyInfo ( p_method_info - > arguments_info [ i ] ) ) ;
arguments_metadata . push_back ( GodotTypeInfo : : Metadata ( p_method_info - > arguments_metadata [ i ] ) ) ;
2022-10-23 08:43:09 +00:00
}
2021-06-19 15:58:49 +00:00
2022-05-06 06:44:13 +00:00
set_hint_flags ( p_method_info - > method_flags ) ;
2023-04-24 22:21:32 +00:00
argument_count = p_method_info - > argument_count ;
2022-12-07 11:11:28 +00:00
vararg = p_method_info - > method_flags & GDEXTENSION_METHOD_FLAG_VARARG ;
2021-06-19 15:58:49 +00:00
_set_returns ( p_method_info - > has_return_value ) ;
2022-12-07 11:11:28 +00:00
_set_const ( p_method_info - > method_flags & GDEXTENSION_METHOD_FLAG_CONST ) ;
_set_static ( p_method_info - > method_flags & GDEXTENSION_METHOD_FLAG_STATIC ) ;
2021-06-19 15:58:49 +00:00
# ifdef DEBUG_METHODS_ENABLED
_generate_argument_types ( p_method_info - > argument_count ) ;
# endif
set_argument_count ( p_method_info - > argument_count ) ;
2022-05-06 06:44:13 +00:00
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 ) ;
2021-06-19 15:58:49 +00:00
}
2023-08-05 01:34:14 +00:00
explicit GDExtensionMethodBind ( const GDExtensionClassMethodInfo * p_method_info ) {
update ( p_method_info ) ;
}
2021-06-19 15:58:49 +00:00
} ;
2023-06-24 01:07:22 +00:00
# ifndef DISABLE_DEPRECATED
2022-12-07 11:11:28 +00:00
void GDExtension : : _register_extension_class ( GDExtensionClassLibraryPtr p_library , GDExtensionConstStringNamePtr p_class_name , GDExtensionConstStringNamePtr p_parent_class_name , const GDExtensionClassCreationInfo * p_extension_funcs ) {
2024-04-22 14:34:44 +00:00
const GDExtensionClassCreationInfo4 class_info4 = {
2023-06-24 01:07:22 +00:00
p_extension_funcs - > is_virtual , // GDExtensionBool is_virtual;
p_extension_funcs - > is_abstract , // GDExtensionBool is_abstract;
2022-12-20 03:36:25 +00:00
true , // GDExtensionBool is_exposed;
2024-01-02 20:10:54 +00:00
false , // GDExtensionBool is_runtime;
2023-06-24 01:07:22 +00:00
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;
2024-04-25 20:19:19 +00:00
nullptr , // GDExtensionClassFreePropertyList2 free_property_list_func;
2023-06-24 01:07:22 +00:00
p_extension_funcs - > property_can_revert_func , // GDExtensionClassPropertyCanRevert property_can_revert_func;
p_extension_funcs - > property_get_revert_func , // GDExtensionClassPropertyGetRevert property_get_revert_func;
2023-09-09 18:05:16 +00:00
nullptr , // GDExtensionClassValidateProperty validate_property_func;
2023-06-24 01:07:22 +00:00
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;
2024-04-22 14:34:44 +00:00
nullptr , // GDExtensionClassCreateInstance2 create_instance_func; /* this one is mandatory */
2023-06-24 01:07:22 +00:00
p_extension_funcs - > free_instance_func , // GDExtensionClassFreeInstance free_instance_func; /* this one is mandatory */
2023-08-05 01:34:14 +00:00
nullptr , // GDExtensionClassRecreateInstance recreate_instance_func;
2023-06-24 01:07:22 +00:00
p_extension_funcs - > get_virtual_func , // GDExtensionClassGetVirtual get_virtual_func;
2023-08-16 00:03:49 +00:00
nullptr , // GDExtensionClassGetVirtualCallData get_virtual_call_data_func;
nullptr , // GDExtensionClassCallVirtualWithData call_virtual_func;
2023-06-24 01:07:22 +00:00
p_extension_funcs - > get_rid_func , // GDExtensionClassGetRID get_rid;
p_extension_funcs - > class_userdata , // void *class_userdata;
} ;
const ClassCreationDeprecatedInfo legacy = {
2024-04-25 20:19:19 +00:00
p_extension_funcs - > notification_func , // GDExtensionClassNotification notification_func;
p_extension_funcs - > free_property_list_func , // GDExtensionClassFreePropertyList free_property_list_func;
2024-04-22 14:34:44 +00:00
p_extension_funcs - > create_instance_func , // GDExtensionClassCreateInstance create_instance_func;
2023-06-24 01:07:22 +00:00
} ;
2024-04-22 14:34:44 +00:00
_register_extension_class_internal ( p_library , p_class_name , p_parent_class_name , & class_info4 , & legacy ) ;
2023-06-24 01:07:22 +00:00
}
void GDExtension : : _register_extension_class2 ( GDExtensionClassLibraryPtr p_library , GDExtensionConstStringNamePtr p_class_name , GDExtensionConstStringNamePtr p_parent_class_name , const GDExtensionClassCreationInfo2 * p_extension_funcs ) {
2024-04-22 14:34:44 +00:00
const GDExtensionClassCreationInfo4 class_info4 = {
2024-01-02 20:10:54 +00:00
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;
2024-04-25 20:19:19 +00:00
nullptr , // GDExtensionClassFreePropertyList2 free_property_list_func;
2024-01-02 20:10:54 +00:00
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;
2024-04-22 14:34:44 +00:00
nullptr , // GDExtensionClassCreateInstance2 create_instance_func; /* this one is mandatory */
2024-01-02 20:10:54 +00:00
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;
} ;
2024-04-25 20:19:19 +00:00
const ClassCreationDeprecatedInfo legacy = {
nullptr , // GDExtensionClassNotification notification_func;
p_extension_funcs - > free_property_list_func , // GDExtensionClassFreePropertyList free_property_list_func;
2024-04-22 14:34:44 +00:00
p_extension_funcs - > create_instance_func , // GDExtensionClassCreateInstance create_instance_func;
2024-04-25 20:19:19 +00:00
} ;
2024-04-22 14:34:44 +00:00
_register_extension_class_internal ( p_library , p_class_name , p_parent_class_name , & class_info4 , & legacy ) ;
2024-01-02 20:10:54 +00:00
}
void GDExtension : : _register_extension_class3 ( GDExtensionClassLibraryPtr p_library , GDExtensionConstStringNamePtr p_class_name , GDExtensionConstStringNamePtr p_parent_class_name , const GDExtensionClassCreationInfo3 * p_extension_funcs ) {
2024-04-22 14:34:44 +00:00
const GDExtensionClassCreationInfo4 class_info4 = {
p_extension_funcs - > is_virtual , // GDExtensionBool is_virtual;
p_extension_funcs - > is_abstract , // GDExtensionBool is_abstract;
p_extension_funcs - > is_exposed , // GDExtensionBool is_exposed;
p_extension_funcs - > is_runtime , // 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;
p_extension_funcs - > free_property_list_func , // GDExtensionClassFreePropertyList 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;
nullptr , // GDExtensionClassCreateInstance2 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;
nullptr , // GDExtensionClassFreePropertyList free_property_list_func;
p_extension_funcs - > create_instance_func , // GDExtensionClassCreateInstance2 create_instance_func;
} ;
_register_extension_class_internal ( p_library , p_class_name , p_parent_class_name , & class_info4 , & legacy ) ;
}
# endif // DISABLE_DEPRECATED
void GDExtension : : _register_extension_class4 ( GDExtensionClassLibraryPtr p_library , GDExtensionConstStringNamePtr p_class_name , GDExtensionConstStringNamePtr p_parent_class_name , const GDExtensionClassCreationInfo4 * p_extension_funcs ) {
2023-06-24 01:07:22 +00:00
_register_extension_class_internal ( p_library , p_class_name , p_parent_class_name , p_extension_funcs ) ;
}
2024-04-22 14:34:44 +00:00
void GDExtension : : _register_extension_class_internal ( GDExtensionClassLibraryPtr p_library , GDExtensionConstStringNamePtr p_class_name , GDExtensionConstStringNamePtr p_parent_class_name , const GDExtensionClassCreationInfo4 * p_extension_funcs , const ClassCreationDeprecatedInfo * p_deprecated_funcs ) {
2022-12-07 11:11:28 +00:00
GDExtension * self = reinterpret_cast < GDExtension * > ( p_library ) ;
2021-06-19 15:58:49 +00:00
2022-10-22 13:18:33 +00:00
StringName class_name = * reinterpret_cast < const StringName * > ( p_class_name ) ;
StringName parent_class_name = * reinterpret_cast < const StringName * > ( p_parent_class_name ) ;
2024-08-23 06:30:51 +00:00
ERR_FAIL_COND_MSG ( ! String ( class_name ) . is_valid_ascii_identifier ( ) , " Attempt to register extension class ' " + class_name + " ', which is not a valid class identifier. " ) ;
2021-06-19 15:58:49 +00:00
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 {
2024-02-23 19:49:13 +00:00
ERR_FAIL_MSG ( " Attempt to register an extension class ' " + String ( class_name ) + " ' using non-existing parent class ' " + String ( parent_class_name ) + " '. " ) ;
2021-06-19 15:58:49 +00:00
}
2023-08-05 01:34:14 +00:00
# ifdef TOOLS_ENABLED
Extension * extension = nullptr ;
2024-01-02 20:10:54 +00:00
bool is_runtime = ( bool ) p_extension_funcs - > is_runtime ;
2023-08-05 01:34:14 +00:00
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 ) {
2024-01-02 20:10:54 +00:00
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 ;
2023-08-05 01:34:14 +00:00
}
extension - > is_reloading = false ;
} else {
self - > extension_classes [ class_name ] = Extension ( ) ;
extension = & self - > extension_classes [ class_name ] ;
}
# else
2021-06-19 15:58:49 +00:00
self - > extension_classes [ class_name ] = Extension ( ) ;
Extension * extension = & self - > extension_classes [ class_name ] ;
2023-08-05 01:34:14 +00:00
# endif
2021-06-19 15:58:49 +00:00
if ( parent_extension ) {
2022-12-07 11:11:28 +00:00
extension - > gdextension . parent = & parent_extension - > gdextension ;
parent_extension - > gdextension . children . push_back ( & extension - > gdextension ) ;
2021-06-19 15:58:49 +00:00
}
2023-08-05 01:34:14 +00:00
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 ;
}
2023-02-16 15:38:57 +00:00
extension - > gdextension . library = self ;
2022-12-07 11:11:28 +00:00
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 ;
2022-12-20 03:36:25 +00:00
extension - > gdextension . is_exposed = p_extension_funcs - > is_exposed ;
2024-01-02 20:10:54 +00:00
# ifdef TOOLS_ENABLED
extension - > gdextension . is_runtime = is_runtime ;
# endif
2022-12-07 11:11:28 +00:00
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 ;
2024-04-25 20:19:19 +00:00
extension - > gdextension . free_property_list2 = p_extension_funcs - > free_property_list_func ;
2022-12-07 11:11:28 +00:00
extension - > gdextension . property_can_revert = p_extension_funcs - > property_can_revert_func ;
extension - > gdextension . property_get_revert = p_extension_funcs - > property_get_revert_func ;
2023-09-09 18:05:16 +00:00
extension - > gdextension . validate_property = p_extension_funcs - > validate_property_func ;
2023-06-24 01:07:22 +00:00
# ifndef DISABLE_DEPRECATED
if ( p_deprecated_funcs ) {
extension - > gdextension . notification = p_deprecated_funcs - > notification_func ;
2024-04-25 20:19:19 +00:00
extension - > gdextension . free_property_list = p_deprecated_funcs - > free_property_list_func ;
2024-04-22 14:34:44 +00:00
extension - > gdextension . create_instance = p_deprecated_funcs - > create_instance_func ;
2023-06-24 01:07:22 +00:00
}
# endif // DISABLE_DEPRECATED
extension - > gdextension . notification2 = p_extension_funcs - > notification_func ;
2022-12-07 11:11:28 +00:00
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 ;
2024-04-22 14:34:44 +00:00
extension - > gdextension . create_instance2 = p_extension_funcs - > create_instance_func ;
2022-12-07 11:11:28 +00:00
extension - > gdextension . free_instance = p_extension_funcs - > free_instance_func ;
2023-08-05 01:34:14 +00:00
extension - > gdextension . recreate_instance = p_extension_funcs - > recreate_instance_func ;
2022-12-07 11:11:28 +00:00
extension - > gdextension . get_virtual = p_extension_funcs - > get_virtual_func ;
2023-08-16 00:03:49 +00:00
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 ;
2022-12-07 11:11:28 +00:00
extension - > gdextension . get_rid = p_extension_funcs - > get_rid_func ;
2023-08-05 01:34:14 +00:00
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
2022-12-07 11:11:28 +00:00
ClassDB : : register_extension_class ( & extension - > gdextension ) ;
2021-06-19 15:58:49 +00:00
}
2023-06-24 01:07:22 +00:00
2022-12-07 11:11:28 +00:00
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 ) ;
2021-06-19 15:58:49 +00:00
2022-10-23 08:43:09 +00:00
StringName class_name = * reinterpret_cast < const StringName * > ( p_class_name ) ;
StringName method_name = * reinterpret_cast < const StringName * > ( p_method_info - > name ) ;
2021-07-29 13:53:05 +00:00
ERR_FAIL_COND_MSG ( ! self - > extension_classes . has ( class_name ) , " Attempt to register extension method ' " + String ( method_name ) + " ' for unexisting class ' " + class_name + " '. " ) ;
2021-06-19 15:58:49 +00:00
2023-08-05 01:34:14 +00:00
# ifdef TOOLS_ENABLED
Extension * extension = & self - > extension_classes [ class_name ] ;
GDExtensionMethodBind * method = nullptr ;
2021-06-19 15:58:49 +00:00
2023-08-05 01:34:14 +00:00
// 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
2022-12-07 11:11:28 +00:00
GDExtensionMethodBind * method = memnew ( GDExtensionMethodBind ( p_method_info ) ) ;
2021-07-29 13:53:05 +00:00
method - > set_instance_class ( class_name ) ;
2023-08-05 01:34:14 +00:00
# endif
2021-06-19 15:58:49 +00:00
ClassDB : : bind_method_custom ( class_name , method ) ;
}
2024-01-21 01:40:43 +00:00
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 ) ;
}
2022-12-07 11:11:28 +00:00
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 ) ;
2021-06-19 15:58:49 +00:00
2022-10-23 08:43:09 +00:00
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 + " '. " ) ;
2021-06-19 15:58:49 +00:00
2023-08-05 01:34:14 +00:00
# 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
2022-10-23 08:43:09 +00:00
ClassDB : : bind_integer_constant ( class_name , enum_name , constant_name , p_constant_value , p_is_bitfield ) ;
2021-06-19 15:58:49 +00:00
}
2021-09-16 02:37:43 +00:00
2022-12-07 11:11:28 +00:00
void GDExtension : : _register_extension_class_property ( GDExtensionClassLibraryPtr p_library , GDExtensionConstStringNamePtr p_class_name , const GDExtensionPropertyInfo * p_info , GDExtensionConstStringNamePtr p_setter , GDExtensionConstStringNamePtr p_getter ) {
2023-07-21 20:59:24 +00:00
_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 ) {
2022-12-07 11:11:28 +00:00
GDExtension * self = reinterpret_cast < GDExtension * > ( p_library ) ;
2021-06-19 15:58:49 +00:00
2022-10-23 08:43:09 +00:00
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 ) ;
2022-06-06 20:24:13 +00:00
ERR_FAIL_COND_MSG ( ! self - > extension_classes . has ( class_name ) , " Attempt to register extension class property ' " + property_name + " ' for unexisting class ' " + class_name + " '. " ) ;
2021-06-19 15:58:49 +00:00
2023-08-05 01:34:14 +00:00
# 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
2022-06-06 20:24:13 +00:00
PropertyInfo pinfo ( * p_info ) ;
2021-06-19 15:58:49 +00:00
2023-07-21 20:59:24 +00:00
ClassDB : : add_property ( class_name , pinfo , setter , getter , p_index ) ;
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
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 ) ;
2021-09-16 02:37:43 +00:00
2022-10-23 08:43:09 +00:00
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 + " '. " ) ;
2021-09-16 02:37:43 +00:00
2023-08-05 01:34:14 +00:00
# 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
2022-10-23 08:43:09 +00:00
ClassDB : : add_property_group ( class_name , group_name , prefix ) ;
2021-09-16 02:37:43 +00:00
}
2022-12-07 11:11:28 +00:00
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 ) ;
2021-09-16 02:37:43 +00:00
2022-10-23 08:43:09 +00:00
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 + " '. " ) ;
2021-09-16 02:37:43 +00:00
2023-08-05 01:34:14 +00:00
# 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
2022-10-23 08:43:09 +00:00
ClassDB : : add_property_subgroup ( class_name , subgroup_name , prefix ) ;
2021-09-16 02:37:43 +00:00
}
2022-12-07 11:11:28 +00:00
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 ) ;
2021-06-19 15:58:49 +00:00
2022-10-23 08:43:09 +00:00
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 + " '. " ) ;
2021-06-19 15:58:49 +00:00
2023-08-05 01:34:14 +00:00
# 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
2021-06-19 15:58:49 +00:00
MethodInfo s ;
2022-10-23 08:43:09 +00:00
s . name = signal_name ;
2021-06-19 15:58:49 +00:00
for ( int i = 0 ; i < p_argument_count ; i + + ) {
2022-06-06 20:24:13 +00:00
PropertyInfo arg ( p_argument_info [ i ] ) ;
2021-06-19 15:58:49 +00:00
s . arguments . push_back ( arg ) ;
}
ClassDB : : add_signal ( class_name , s ) ;
}
2022-12-07 11:11:28 +00:00
void GDExtension : : _unregister_extension_class ( GDExtensionClassLibraryPtr p_library , GDExtensionConstStringNamePtr p_class_name ) {
GDExtension * self = reinterpret_cast < GDExtension * > ( p_library ) ;
2021-06-19 15:58:49 +00:00
2022-10-23 08:43:09 +00:00
StringName class_name = * reinterpret_cast < const StringName * > ( p_class_name ) ;
2021-07-29 13:53:05 +00:00
ERR_FAIL_COND_MSG ( ! self - > extension_classes . has ( class_name ) , " Attempt to unregister unexisting extension class ' " + class_name + " '. " ) ;
2023-08-05 01:34:14 +00:00
2021-06-19 15:58:49 +00:00
Extension * ext = & self - > extension_classes [ class_name ] ;
2023-08-05 01:34:14 +00:00
# ifdef TOOLS_ENABLED
if ( ext - > is_reloading ) {
self - > _clear_extension ( ext ) ;
}
# endif
2022-12-07 11:11:28 +00:00
ERR_FAIL_COND_MSG ( ext - > gdextension . children . size ( ) , " Attempt to unregister class ' " + class_name + " ' while other extension classes inherit from it. " ) ;
2021-06-19 15:58:49 +00:00
2023-08-05 01:34:14 +00:00
# ifdef TOOLS_ENABLED
ClassDB : : unregister_extension_class ( class_name , ! ext - > is_reloading ) ;
# else
2021-06-19 15:58:49 +00:00
ClassDB : : unregister_extension_class ( class_name ) ;
2023-08-05 01:34:14 +00:00
# endif
2022-12-07 11:11:28 +00:00
if ( ext - > gdextension . parent ! = nullptr ) {
ext - > gdextension . parent - > children . erase ( & ext - > gdextension ) ;
2021-06-19 15:58:49 +00:00
}
2023-08-05 01:34:14 +00:00
# ifdef TOOLS_ENABLED
if ( ! ext - > is_reloading ) {
self - > extension_classes . erase ( class_name ) ;
}
2023-10-18 22:50:30 +00:00
GDExtensionEditorHelp : : remove_class ( class_name ) ;
2023-08-05 01:34:14 +00:00
# else
2021-06-19 15:58:49 +00:00
self - > extension_classes . erase ( class_name ) ;
2023-08-05 01:34:14 +00:00
# endif
2021-06-19 15:58:49 +00:00
}
2023-05-13 17:05:54 +00:00
void GDExtension : : _get_library_path ( GDExtensionClassLibraryPtr p_library , GDExtensionUninitializedStringPtr r_path ) {
2022-12-07 11:11:28 +00:00
GDExtension * self = reinterpret_cast < GDExtension * > ( p_library ) ;
2022-04-28 22:51:04 +00:00
2024-04-23 23:32:25 +00:00
Ref < GDExtensionLibraryLoader > library_loader = self - > loader ;
String library_path ;
if ( library_loader . is_valid ( ) ) {
library_path = library_loader - > library_path ;
}
memnew_placement ( r_path , String ( library_path ) ) ;
2022-04-28 22:51:04 +00:00
}
2023-10-18 15:36:20 +00:00
HashMap < StringName , GDExtensionInterfaceFunctionPtr > GDExtension : : gdextension_interface_functions ;
2023-04-24 15:15:27 +00:00
2021-08-01 19:47:20 +00:00
void GDExtension : : register_interface_function ( const StringName & p_function_name , GDExtensionInterfaceFunctionPtr p_function_pointer ) {
2023-04-24 15:15:27 +00:00
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 ) ;
}
2021-08-01 19:47:20 +00:00
GDExtensionInterfaceFunctionPtr GDExtension : : get_interface_function ( const StringName & p_function_name ) {
2023-04-24 15:15:27 +00:00
GDExtensionInterfaceFunctionPtr * function = gdextension_interface_functions . getptr ( p_function_name ) ;
2023-09-09 14:11:33 +00:00
ERR_FAIL_NULL_V_MSG ( function , nullptr , " Attempt to get non-existent interface function: " + String ( p_function_name ) + " . " ) ;
2023-04-24 15:15:27 +00:00
return * function ;
}
2024-04-23 23:32:25 +00:00
Error GDExtension : : open_library ( const String & p_path , const Ref < GDExtensionLoader > & p_loader ) {
ERR_FAIL_NULL_V_MSG ( p_loader , FAILED , " Can't open GDExtension without a loader. " ) ;
loader = p_loader ;
2023-10-01 01:20:12 +00:00
String abs_path = ProjectSettings : : get_singleton ( ) - > globalize_path ( p_path ) ;
2024-02-13 22:26:05 +00:00
2024-04-23 23:32:25 +00:00
Error err = loader - > open_library ( abs_path ) ;
2023-10-01 01:20:12 +00:00
2024-01-01 11:48:28 +00:00
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 ) ;
2021-06-19 15:58:49 +00:00
2024-04-23 23:32:25 +00:00
err = loader - > initialize ( & gdextension_get_proc_address , this , & initialization ) ;
2021-06-19 15:58:49 +00:00
if ( err ! = OK ) {
2024-04-23 23:32:25 +00:00
// Errors already logged in initialize().
loader - > close_library ( ) ;
2021-06-19 15:58:49 +00:00
return err ;
}
2024-04-23 23:32:25 +00:00
level_initialized = - 1 ;
2021-06-19 15:58:49 +00:00
2024-04-23 23:32:25 +00:00
return OK ;
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
void GDExtension : : close_library ( ) {
2024-04-23 23:32:25 +00:00
ERR_FAIL_COND ( ! is_library_open ( ) ) ;
loader - > close_library ( ) ;
2021-06-19 15:58:49 +00:00
2023-08-05 01:34:14 +00:00
class_icon_paths . clear ( ) ;
# ifdef TOOLS_ENABLED
instance_bindings . clear ( ) ;
# endif
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
bool GDExtension : : is_library_open ( ) const {
2024-04-23 23:32:25 +00:00
return loader . is_valid ( ) & & loader - > is_library_open ( ) ;
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
GDExtension : : InitializationLevel GDExtension : : get_minimum_library_initialization_level ( ) const {
2024-04-23 23:32:25 +00:00
ERR_FAIL_COND_V ( ! is_library_open ( ) , INITIALIZATION_LEVEL_CORE ) ;
2021-06-19 15:58:49 +00:00
return InitializationLevel ( initialization . minimum_initialization_level ) ;
}
2022-02-16 17:02:38 +00:00
2022-12-07 11:11:28 +00:00
void GDExtension : : initialize_library ( InitializationLevel p_level ) {
2024-04-23 23:32:25 +00:00
ERR_FAIL_COND ( ! is_library_open ( ) ) ;
2022-02-16 17:02:38 +00:00
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 ) ) ;
2021-06-19 15:58:49 +00:00
level_initialized = int32_t ( p_level ) ;
2023-09-28 09:40:18 +00:00
ERR_FAIL_NULL ( initialization . initialize ) ;
2021-06-19 15:58:49 +00:00
2022-12-07 11:11:28 +00:00
initialization . initialize ( initialization . userdata , GDExtensionInitializationLevel ( p_level ) ) ;
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
void GDExtension : : deinitialize_library ( InitializationLevel p_level ) {
2024-04-23 23:32:25 +00:00
ERR_FAIL_COND ( ! is_library_open ( ) ) ;
2021-06-19 15:58:49 +00:00
ERR_FAIL_COND ( p_level > int32_t ( level_initialized ) ) ;
level_initialized = int32_t ( p_level ) - 1 ;
2024-02-04 11:41:23 +00:00
ERR_FAIL_NULL ( initialization . deinitialize ) ;
2022-12-07 11:11:28 +00:00
initialization . deinitialize ( initialization . userdata , GDExtensionInitializationLevel ( p_level ) ) ;
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
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 ) ;
2021-06-19 15:58:49 +00:00
BIND_ENUM_CONSTANT ( INITIALIZATION_LEVEL_CORE ) ;
BIND_ENUM_CONSTANT ( INITIALIZATION_LEVEL_SERVERS ) ;
BIND_ENUM_CONSTANT ( INITIALIZATION_LEVEL_SCENE ) ;
BIND_ENUM_CONSTANT ( INITIALIZATION_LEVEL_EDITOR ) ;
}
2022-12-07 11:11:28 +00:00
GDExtension : : GDExtension ( ) {
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
GDExtension : : ~ GDExtension ( ) {
2024-04-23 23:32:25 +00:00
if ( is_library_open ( ) ) {
2021-06-19 15:58:49 +00:00
close_library ( ) ;
}
2023-08-05 01:34:14 +00:00
# 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
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
void GDExtension : : initialize_gdextensions ( ) {
2023-04-24 15:15:27 +00:00
gdextension_setup_interface ( ) ;
2023-06-24 01:07:22 +00:00
# ifndef DISABLE_DEPRECATED
2023-04-24 15:15:27 +00:00
register_interface_function ( " classdb_register_extension_class " , ( GDExtensionInterfaceFunctionPtr ) & GDExtension : : _register_extension_class ) ;
2023-06-24 01:07:22 +00:00
register_interface_function ( " classdb_register_extension_class2 " , ( GDExtensionInterfaceFunctionPtr ) & GDExtension : : _register_extension_class2 ) ;
2024-01-02 20:10:54 +00:00
register_interface_function ( " classdb_register_extension_class3 " , ( GDExtensionInterfaceFunctionPtr ) & GDExtension : : _register_extension_class3 ) ;
2024-04-22 14:34:44 +00:00
# endif // DISABLE_DEPRECATED
register_interface_function ( " classdb_register_extension_class4 " , ( GDExtensionInterfaceFunctionPtr ) & GDExtension : : _register_extension_class4 ) ;
2023-04-24 15:15:27 +00:00
register_interface_function ( " classdb_register_extension_class_method " , ( GDExtensionInterfaceFunctionPtr ) & GDExtension : : _register_extension_class_method ) ;
2024-01-21 01:40:43 +00:00
register_interface_function ( " classdb_register_extension_class_virtual_method " , ( GDExtensionInterfaceFunctionPtr ) & GDExtension : : _register_extension_class_virtual_method ) ;
2023-04-24 15:15:27 +00:00
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 ) ;
2023-07-21 20:59:24 +00:00
register_interface_function ( " classdb_register_extension_class_property_indexed " , ( GDExtensionInterfaceFunctionPtr ) & GDExtension : : _register_extension_class_property_indexed ) ;
2023-04-24 15:15:27 +00:00
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 ) ;
2021-06-19 15:58:49 +00:00
}
2023-10-18 15:36:20 +00:00
void GDExtension : : finalize_gdextensions ( ) {
gdextension_interface_functions . clear ( ) ;
}
2023-08-05 01:34:14 +00:00
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. " ) ;
2024-04-23 23:32:25 +00:00
GDExtensionManager * extension_manager = GDExtensionManager : : get_singleton ( ) ;
2021-06-19 15:58:49 +00:00
2024-04-23 23:32:25 +00:00
GDExtensionManager : : LoadStatus status = extension_manager - > load_extension ( p_path ) ;
if ( status ! = GDExtensionManager : : LOAD_STATUS_OK & & status ! = GDExtensionManager : : LOAD_STATUS_ALREADY_LOADED ) {
// Errors already logged in load_extension().
return FAILED ;
2023-03-31 19:17:59 +00:00
}
2024-04-23 23:32:25 +00:00
p_extension = extension_manager - > get_extension ( p_path ) ;
2023-08-05 01:34:14 +00:00
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 ) {
2023-10-13 17:54:21 +00:00
// 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 ( ) ;
2023-10-21 15:00:18 +00:00
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 ;
2023-08-05 01:34:14 +00:00
}
2021-06-19 15:58:49 +00:00
return lib ;
}
2022-12-07 11:11:28 +00:00
void GDExtensionResourceLoader : : get_recognized_extensions ( List < String > * p_extensions ) const {
2021-06-19 15:58:49 +00:00
p_extensions - > push_back ( " gdextension " ) ;
}
2022-12-07 11:11:28 +00:00
bool GDExtensionResourceLoader : : handles_type ( const String & p_type ) const {
return p_type = = " GDExtension " ;
2021-06-19 15:58:49 +00:00
}
2022-12-07 11:11:28 +00:00
String GDExtensionResourceLoader : : get_resource_type ( const String & p_path ) const {
2021-06-19 15:58:49 +00:00
String el = p_path . get_extension ( ) . to_lower ( ) ;
if ( el = = " gdextension " ) {
2022-12-07 11:11:28 +00:00
return " GDExtension " ;
2021-06-19 15:58:49 +00:00
}
return " " ;
}
2023-05-11 21:46:53 +00:00
# ifdef TOOLS_ENABLED
2023-08-05 01:34:14 +00:00
bool GDExtension : : has_library_changed ( ) const {
2024-04-23 23:32:25 +00:00
return loader - > has_library_changed ( ) ;
2023-08-05 01:34:14 +00:00
}
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 ) ) ;
}
2024-01-02 20:10:54 +00:00
E . value . instance_state [ obj_id ] = {
state , // List<Pair<String, Variant>> properties;
obj - > is_extension_placeholder ( ) , // bool is_placeholder;
} ;
2023-08-05 01:34:14 +00:00
}
}
}
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.
2024-01-02 20:10:54 +00:00
for ( const KeyValue < ObjectID , Extension : : InstanceState > & S : E . value . instance_state ) {
2023-08-05 01:34:14 +00:00
Object * obj = ObjectDB : : get_instance ( S . key ) ;
if ( ! obj ) {
continue ;
}
2024-01-02 20:10:54 +00:00
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 ) ;
}
2023-08-05 01:34:14 +00:00
}
}
// Now that all the classes are back, restore the state.
for ( KeyValue < StringName , Extension > & E : extension_classes ) {
2024-01-02 20:10:54 +00:00
for ( const KeyValue < ObjectID , Extension : : InstanceState > & S : E . value . instance_state ) {
2023-08-05 01:34:14 +00:00
Object * obj = ObjectDB : : get_instance ( S . key ) ;
if ( ! obj ) {
continue ;
}
2024-01-02 20:10:54 +00:00
for ( const Pair < String , Variant > & state : S . value . properties ) {
2023-08-05 01:34:14 +00:00
obj - > set ( state . first , state . second ) ;
}
}
}
// Finally, let the objects know that we are done reloading them.
for ( KeyValue < StringName , Extension > & E : extension_classes ) {
2024-01-02 20:10:54 +00:00
for ( const KeyValue < ObjectID , Extension : : InstanceState > & S : E . value . instance_state ) {
2023-08-05 01:34:14 +00:00
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 ( ) ) ;
}
2023-05-11 21:46:53 +00:00
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 ) ;
}
}
2023-10-18 22:50:30 +00:00
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 ) ;
}
2023-05-11 21:46:53 +00:00
# endif // TOOLS_ENABLED