2017-10-03 05:24:00 +08:00
/**************************************************************************/
/* csharp_script.cpp */
/**************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/**************************************************************************/
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/**************************************************************************/
2018-01-05 07:50:27 +08:00
2017-10-03 05:24:00 +08:00
# include "csharp_script.h"
2023-06-13 22:56:21 +08:00
# include "godotsharp_dirs.h"
# include "managed_callable.h"
# include "mono_gd/gd_mono_cache.h"
# include "signal_awaiter_utils.h"
# include "utils/macros.h"
# include "utils/naming_utils.h"
# include "utils/path_utils.h"
# include "utils/string_utils.h"
# ifdef DEBUG_METHODS_ENABLED
# include "class_db_api_json.h"
# endif
# ifdef TOOLS_ENABLED
# include "editor/editor_internal_calls.h"
# include "editor/script_templates/templates.gen.h"
# endif
2017-10-03 05:24:00 +08:00
2020-11-08 06:33:38 +08:00
# include "core/config/project_settings.h"
2020-02-27 10:30:20 +08:00
# include "core/debugger/engine_debugger.h"
# include "core/debugger/script_debugger.h"
2021-06-11 20:51:48 +08:00
# include "core/io/file_access.h"
2020-02-26 18:28:13 +08:00
# include "core/os/mutex.h"
2018-09-12 00:13:45 +08:00
# include "core/os/os.h"
# include "core/os/thread.h"
2023-06-13 22:56:21 +08:00
# include "servers/text_server.h"
2017-10-03 05:24:00 +08:00
# ifdef TOOLS_ENABLED
2021-09-13 21:33:56 +08:00
# include "core/os/keyboard.h"
2023-02-02 07:54:16 +08:00
# include "editor/editor_file_system.h"
2017-10-03 05:24:00 +08:00
# include "editor/editor_node.h"
2021-09-13 21:33:56 +08:00
# include "editor/editor_settings.h"
2022-11-19 19:45:49 +08:00
# include "editor/inspector_dock.h"
2019-12-24 15:17:23 +08:00
# include "editor/node_dock.h"
2017-10-03 05:24:00 +08:00
# endif
2023-06-13 22:56:21 +08:00
# include <stdint.h>
2017-10-03 05:24:00 +08:00
2023-04-12 06:35:10 +08:00
// Types that will be skipped over (in favor of their base types) when setting up instance bindings.
// This must be a superset of `ignored_types` in bindings_generator.cpp.
2023-07-14 22:05:48 +08:00
const Vector < String > ignored_types = { } ;
2023-04-12 06:35:10 +08:00
2017-10-18 14:27:18 +08:00
# ifdef TOOLS_ENABLED
2017-10-05 06:10:51 +08:00
static bool _create_project_solution_if_needed ( ) {
2022-07-28 23:41:51 +08:00
CRASH_COND ( CSharpLanguage : : get_singleton ( ) - > get_godotsharp_editor ( ) = = nullptr ) ;
return CSharpLanguage : : get_singleton ( ) - > get_godotsharp_editor ( ) - > call ( " CreateProjectSolutionIfNeeded " ) ;
2017-10-05 06:10:51 +08:00
}
2017-10-18 14:27:18 +08:00
# endif
2017-10-05 06:10:51 +08:00
2020-03-15 02:20:17 +08:00
CSharpLanguage * CSharpLanguage : : singleton = nullptr ;
2017-10-03 05:24:00 +08:00
2022-12-07 19:11:28 +08:00
GDExtensionInstanceBindingCallbacks CSharpLanguage : : _instance_binding_callbacks = {
2021-08-16 23:16:36 +08:00
& _instance_binding_create_callback ,
& _instance_binding_free_callback ,
& _instance_binding_reference_callback
} ;
2017-10-03 05:24:00 +08:00
String CSharpLanguage : : get_name ( ) const {
return " C# " ;
}
String CSharpLanguage : : get_type ( ) const {
return " CSharpScript " ;
}
String CSharpLanguage : : get_extension ( ) const {
return " cs " ;
}
void CSharpLanguage : : init ( ) {
2023-05-02 04:53:23 +08:00
# ifdef TOOLS_ENABLED
if ( OS : : get_singleton ( ) - > get_cmdline_args ( ) . find ( " --generate-mono-glue " ) ) {
print_verbose ( " .NET: Skipping runtime initialization because glue generation is enabled. " ) ;
return ;
}
# endif
2019-07-10 05:33:29 +08:00
# ifdef DEBUG_METHODS_ENABLED
2020-01-20 03:02:40 +08:00
if ( OS : : get_singleton ( ) - > get_cmdline_args ( ) . find ( " --class-db-json " ) ) {
2019-07-10 05:33:29 +08:00
class_db_api_to_json ( " user://class_db_api.json " , ClassDB : : API_CORE ) ;
# ifdef TOOLS_ENABLED
class_db_api_to_json ( " user://class_db_api_editor.json " , ClassDB : : API_EDITOR ) ;
# endif
}
# endif
2023-01-19 02:43:53 +08:00
GLOBAL_DEF ( " dotnet/project/assembly_name " , " " ) ;
# ifdef TOOLS_ENABLED
GLOBAL_DEF ( " dotnet/project/solution_directory " , " " ) ;
2023-03-31 17:53:16 +08:00
GLOBAL_DEF ( PropertyInfo ( Variant : : INT , " dotnet/project/assembly_reload_attempts " , PROPERTY_HINT_RANGE , " 1,16,1,or_greater " ) , 3 ) ;
2023-01-19 02:43:53 +08:00
# endif
2021-12-29 06:25:16 +08:00
# ifdef TOOLS_ENABLED
2019-07-03 15:44:53 +08:00
EditorNode : : add_init_callback ( & _editor_init_callback ) ;
2017-10-03 05:24:00 +08:00
# endif
2023-10-16 08:55:52 +08:00
gdmono = memnew ( GDMono ) ;
// Initialize only if the project uses C#.
if ( gdmono - > should_initialize ( ) ) {
gdmono - > initialize ( ) ;
}
2017-10-03 05:24:00 +08:00
}
void CSharpLanguage : : finish ( ) {
2020-07-06 01:19:36 +08:00
finalize ( ) ;
}
void CSharpLanguage : : finalize ( ) {
if ( finalized ) {
2020-03-15 02:20:17 +08:00
return ;
2020-07-06 01:19:36 +08:00
}
2020-03-15 02:20:17 +08:00
2023-06-13 03:59:48 +08:00
if ( gdmono & & gdmono - > is_runtime_initialized ( ) & & GDMonoCache : : godot_api_cache_updated ) {
GDMonoCache : : managed_callbacks . DisposablesTracker_OnGodotShuttingDown ( ) ;
}
2018-01-01 05:37:57 +08:00
finalizing = true ;
2024-06-15 02:10:03 +08:00
// Make sure all script binding gchandles are released before finalizing GDMono.
2021-07-27 03:31:17 +08:00
for ( KeyValue < Object * , CSharpScriptBinding > & E : script_bindings ) {
CSharpScriptBinding & script_binding = E . value ;
2019-02-03 13:35:22 +08:00
2019-12-12 00:08:40 +08:00
if ( ! script_binding . gchandle . is_released ( ) ) {
script_binding . gchandle . release ( ) ;
2019-02-03 13:35:22 +08:00
script_binding . inited = false ;
}
2024-06-15 02:10:03 +08:00
// Make sure we clear all the instance binding callbacks so they don't get called
// after finalizing the C# language.
script_binding . owner - > free_instance_binding ( this ) ;
2019-02-03 13:35:22 +08:00
}
2017-11-01 08:48:47 +08:00
2017-10-03 05:24:00 +08:00
if ( gdmono ) {
memdelete ( gdmono ) ;
2020-04-02 07:20:12 +08:00
gdmono = nullptr ;
2017-10-03 05:24:00 +08:00
}
2018-01-01 05:37:57 +08:00
2019-02-03 13:35:22 +08:00
// Clear here, after finalizing all domains to make sure there is nothing else referencing the elements.
script_bindings . clear ( ) ;
2020-01-14 04:00:07 +08:00
# ifdef DEBUG_ENABLED
2021-07-27 03:31:17 +08:00
for ( const KeyValue < ObjectID , int > & E : unsafe_object_references ) {
const ObjectID & id = E . key ;
2020-01-14 04:00:07 +08:00
Object * obj = ObjectDB : : get_instance ( id ) ;
if ( obj ) {
2020-02-13 03:06:30 +08:00
ERR_PRINT ( " Leaked unsafe reference to object: " + obj - > to_string ( ) ) ;
2020-01-14 04:00:07 +08:00
} else {
2019-11-07 00:03:04 +08:00
ERR_PRINT ( " Leaked unsafe reference to deleted object: " + itos ( id ) ) ;
2020-01-14 04:00:07 +08:00
}
}
# endif
2020-03-15 02:20:17 +08:00
memdelete ( managed_callable_middleman ) ;
2018-01-01 05:37:57 +08:00
finalizing = false ;
2020-03-15 02:20:17 +08:00
finalized = true ;
2017-10-03 05:24:00 +08:00
}
void CSharpLanguage : : get_reserved_words ( List < String > * p_words ) const {
static const char * _reserved_words [ ] = {
// Reserved keywords
" abstract " ,
" as " ,
" base " ,
" bool " ,
" break " ,
" byte " ,
" case " ,
" catch " ,
" char " ,
" checked " ,
" class " ,
" const " ,
" continue " ,
" decimal " ,
" default " ,
" delegate " ,
" do " ,
" double " ,
" else " ,
" enum " ,
" event " ,
" explicit " ,
" extern " ,
" false " ,
" finally " ,
" fixed " ,
" float " ,
" for " ,
2018-01-31 10:18:48 +08:00
" foreach " ,
2017-10-03 05:24:00 +08:00
" goto " ,
" if " ,
" implicit " ,
" in " ,
" int " ,
" interface " ,
" internal " ,
" is " ,
" lock " ,
" long " ,
" namespace " ,
" new " ,
" null " ,
" object " ,
" operator " ,
" out " ,
" override " ,
" params " ,
" private " ,
" protected " ,
" public " ,
" readonly " ,
" ref " ,
" return " ,
" sbyte " ,
" sealed " ,
" short " ,
" sizeof " ,
" stackalloc " ,
" static " ,
" string " ,
" struct " ,
" switch " ,
" this " ,
" throw " ,
" true " ,
" try " ,
" typeof " ,
" uint " ,
" ulong " ,
" unchecked " ,
" unsafe " ,
" ushort " ,
" using " ,
" virtual " ,
" void " ,
2018-01-31 10:18:48 +08:00
" volatile " ,
2017-10-03 05:24:00 +08:00
" while " ,
// Contextual keywords. Not reserved words, but I guess we should include
// them because this seems to be used only for syntax highlighting.
" add " ,
2018-01-31 10:18:48 +08:00
" alias " ,
2017-10-03 05:24:00 +08:00
" ascending " ,
2018-01-31 10:18:48 +08:00
" async " ,
" await " ,
2017-10-03 05:24:00 +08:00
" by " ,
" descending " ,
" dynamic " ,
" equals " ,
" from " ,
" get " ,
" global " ,
" group " ,
" into " ,
" join " ,
" let " ,
2018-01-31 10:18:48 +08:00
" nameof " ,
2017-10-03 05:24:00 +08:00
" on " ,
" orderby " ,
" partial " ,
" remove " ,
" select " ,
" set " ,
" value " ,
" var " ,
2018-01-31 10:18:48 +08:00
" when " ,
2017-10-03 05:24:00 +08:00
" where " ,
" yield " ,
2020-05-14 16:15:48 +08:00
nullptr
2017-10-03 05:24:00 +08:00
} ;
const char * * w = _reserved_words ;
while ( * w ) {
p_words - > push_back ( * w ) ;
w + + ;
}
}
2024-01-09 09:36:19 +08:00
bool CSharpLanguage : : is_control_flow_keyword ( const String & p_keyword ) const {
2021-04-08 22:12:22 +08:00
return p_keyword = = " break " | |
2021-10-28 21:19:35 +08:00
p_keyword = = " case " | |
p_keyword = = " catch " | |
p_keyword = = " continue " | |
p_keyword = = " default " | |
p_keyword = = " do " | |
p_keyword = = " else " | |
p_keyword = = " finally " | |
p_keyword = = " for " | |
p_keyword = = " foreach " | |
p_keyword = = " goto " | |
p_keyword = = " if " | |
p_keyword = = " return " | |
p_keyword = = " switch " | |
p_keyword = = " throw " | |
p_keyword = = " try " | |
p_keyword = = " while " ;
2021-04-08 22:12:22 +08:00
}
2017-10-03 05:24:00 +08:00
void CSharpLanguage : : get_comment_delimiters ( List < String > * p_delimiters ) const {
p_delimiters - > push_back ( " // " ) ; // single-line comment
p_delimiters - > push_back ( " /* */ " ) ; // delimited comment
}
2023-02-05 17:01:01 +08:00
void CSharpLanguage : : get_doc_comment_delimiters ( List < String > * p_delimiters ) const {
p_delimiters - > push_back ( " /// " ) ; // single-line doc comment
p_delimiters - > push_back ( " /** */ " ) ; // delimited doc comment
}
2017-10-03 05:24:00 +08:00
void CSharpLanguage : : get_string_delimiters ( List < String > * p_delimiters ) const {
p_delimiters - > push_back ( " ' ' " ) ; // character literal
p_delimiters - > push_back ( " \" \" " ) ; // regular string literal
2021-08-30 18:38:03 +08:00
p_delimiters - > push_back ( " @ \" \" " ) ; // verbatim string literal
2020-04-01 15:12:47 +08:00
// Generic string highlighting suffices as a workaround for now.
2017-10-03 05:24:00 +08:00
}
2018-03-10 06:34:32 +08:00
static String get_base_class_name ( const String & p_base_class_name , const String p_class_name ) {
2022-12-07 23:11:39 +08:00
String base_class = pascal_to_pascal_case ( p_base_class_name ) ;
2018-03-10 06:34:32 +08:00
if ( p_class_name = = base_class ) {
base_class = " Godot. " + base_class ;
}
return base_class ;
}
2021-10-11 17:30:59 +08:00
bool CSharpLanguage : : is_using_templates ( ) {
return true ;
}
2017-10-03 05:24:00 +08:00
2021-10-11 17:30:59 +08:00
Ref < Script > CSharpLanguage : : make_template ( const String & p_template , const String & p_class_name , const String & p_base_class_name ) const {
2023-03-24 19:38:00 +08:00
Ref < CSharpScript > scr ;
scr . instantiate ( ) ;
2017-10-03 05:24:00 +08:00
2021-10-11 17:30:59 +08:00
String class_name_no_spaces = p_class_name . replace ( " " , " _ " ) ;
String base_class_name = get_base_class_name ( p_base_class_name , class_name_no_spaces ) ;
String processed_template = p_template ;
processed_template = processed_template . replace ( " _BINDINGS_NAMESPACE_ " , BINDINGS_NAMESPACE )
. replace ( " _BASE_ " , base_class_name )
. replace ( " _CLASS_ " , class_name_no_spaces )
. replace ( " _TS_ " , _get_indentation ( ) ) ;
2023-03-24 19:38:00 +08:00
scr - > set_source_code ( processed_template ) ;
return scr ;
2017-10-03 05:24:00 +08:00
}
2021-08-02 03:47:20 +08:00
Vector < ScriptLanguage : : ScriptTemplate > CSharpLanguage : : get_built_in_templates ( const StringName & p_object ) {
2021-10-11 17:30:59 +08:00
Vector < ScriptLanguage : : ScriptTemplate > templates ;
2022-03-28 21:48:38 +08:00
# ifdef TOOLS_ENABLED
2021-10-11 17:30:59 +08:00
for ( int i = 0 ; i < TEMPLATES_ARRAY_SIZE ; i + + ) {
if ( TEMPLATES [ i ] . inherit = = p_object ) {
templates . append ( TEMPLATES [ i ] ) ;
}
}
2022-03-28 21:48:38 +08:00
# endif
2021-10-11 17:30:59 +08:00
return templates ;
2017-10-31 05:17:20 +08:00
}
2018-03-10 06:34:32 +08:00
String CSharpLanguage : : validate_path ( const String & p_path ) const {
String class_name = p_path . get_file ( ) . get_basename ( ) ;
List < String > keywords ;
get_reserved_words ( & keywords ) ;
if ( keywords . find ( class_name ) ) {
2022-03-28 21:24:14 +08:00
return RTR ( " Class name can't be a reserved keyword " ) ;
2018-03-10 06:34:32 +08:00
}
2023-03-04 07:25:15 +08:00
if ( ! TS - > is_valid_identifier ( class_name ) ) {
return RTR ( " Class name must be a valid identifier " ) ;
}
2018-03-10 06:34:32 +08:00
return " " ;
}
2017-10-03 05:24:00 +08:00
Script * CSharpLanguage : : create_script ( ) const {
return memnew ( CSharpScript ) ;
}
2017-10-24 07:54:47 +08:00
bool CSharpLanguage : : supports_builtin_mode ( ) const {
return false ;
2017-10-03 05:24:00 +08:00
}
2023-06-12 00:23:48 +08:00
ScriptLanguage : : ScriptNameCasing CSharpLanguage : : preferred_file_name_casing ( ) const {
return SCRIPT_NAME_CASING_PASCAL_CASE ;
}
2018-10-23 01:43:19 +08:00
# ifdef TOOLS_ENABLED
2020-02-18 05:06:54 +08:00
String CSharpLanguage : : make_function ( const String & , const String & p_name , const PackedStringArray & p_args ) const {
2024-02-05 02:08:41 +08:00
// The make_function() API does not work for C# scripts.
// It will always append the generated function at the very end of the script. In C#, it will break compilation by
// appending code after the final closing bracket (either the class' or the namespace's).
// To prevent issues, we have can_make_function() returning false, and make_function() is never implemented.
return String ( ) ;
2018-10-23 01:43:19 +08:00
}
2017-10-16 10:17:06 +08:00
# else
2020-02-18 05:06:54 +08:00
String CSharpLanguage : : make_function ( const String & , const String & , const PackedStringArray & ) const {
2017-10-16 10:17:06 +08:00
return String ( ) ;
2017-10-03 05:24:00 +08:00
}
2018-10-23 01:43:19 +08:00
# endif
2017-10-03 05:24:00 +08:00
2017-10-31 05:17:20 +08:00
String CSharpLanguage : : _get_indentation ( ) const {
# ifdef TOOLS_ENABLED
if ( Engine : : get_singleton ( ) - > is_editor_hint ( ) ) {
2022-03-07 04:39:19 +08:00
bool use_space_indentation = EDITOR_GET ( " text_editor/behavior/indent/type " ) ;
2017-10-31 05:17:20 +08:00
if ( use_space_indentation ) {
2022-03-07 04:39:19 +08:00
int indent_size = EDITOR_GET ( " text_editor/behavior/indent/size " ) ;
2023-01-29 07:52:05 +08:00
return String ( " " ) . repeat ( indent_size ) ;
2017-10-31 05:17:20 +08:00
}
}
# endif
return " \t " ;
}
2023-02-02 07:54:16 +08:00
bool CSharpLanguage : : handles_global_class_type ( const String & p_type ) const {
return p_type = = get_type ( ) ;
}
String CSharpLanguage : : get_global_class_name ( const String & p_path , String * r_base_type , String * r_icon_path ) const {
2024-02-05 09:49:57 +08:00
String class_name ;
GDMonoCache : : managed_callbacks . ScriptManagerBridge_GetGlobalClassName ( & p_path , r_base_type , r_icon_path , & class_name ) ;
return class_name ;
2023-02-02 07:54:16 +08:00
}
2019-03-08 03:47:13 +08:00
String CSharpLanguage : : debug_get_error ( ) const {
return _debug_error ;
}
int CSharpLanguage : : debug_get_stack_level_count ( ) const {
2020-07-06 01:19:36 +08:00
if ( _debug_parse_err_line > = 0 ) {
2019-03-08 03:47:13 +08:00
return 1 ;
2020-07-06 01:19:36 +08:00
}
2019-03-08 03:47:13 +08:00
// TODO: StackTrace
return 1 ;
}
int CSharpLanguage : : debug_get_stack_level_line ( int p_level ) const {
2020-07-06 01:19:36 +08:00
if ( _debug_parse_err_line > = 0 ) {
2019-03-08 03:47:13 +08:00
return _debug_parse_err_line ;
2020-07-06 01:19:36 +08:00
}
2019-03-08 03:47:13 +08:00
// TODO: StackTrace
return 1 ;
}
String CSharpLanguage : : debug_get_stack_level_function ( int p_level ) const {
2020-07-06 01:19:36 +08:00
if ( _debug_parse_err_line > = 0 ) {
2019-03-08 03:47:13 +08:00
return String ( ) ;
2020-07-06 01:19:36 +08:00
}
2019-03-08 03:47:13 +08:00
// TODO: StackTrace
return String ( ) ;
}
String CSharpLanguage : : debug_get_stack_level_source ( int p_level ) const {
2020-07-06 01:19:36 +08:00
if ( _debug_parse_err_line > = 0 ) {
2019-03-08 03:47:13 +08:00
return _debug_parse_err_file ;
2020-07-06 01:19:36 +08:00
}
2019-03-08 03:47:13 +08:00
// TODO: StackTrace
return String ( ) ;
}
2018-01-10 00:19:03 +08:00
Vector < ScriptLanguage : : StackInfo > CSharpLanguage : : debug_get_current_stack_info ( ) {
2018-01-28 01:44:04 +08:00
# ifdef DEBUG_ENABLED
2020-03-15 02:20:17 +08:00
// Printing an error here will result in endless recursion, so we must be careful
static thread_local bool _recursion_flag_ = false ;
2020-07-06 01:19:36 +08:00
if ( _recursion_flag_ ) {
2020-03-15 02:20:17 +08:00
return Vector < StackInfo > ( ) ;
2020-07-06 01:19:36 +08:00
}
2020-03-15 02:20:17 +08:00
_recursion_flag_ = true ;
C#: Move marshaling logic and generated glue to C#
We will be progressively moving most code to C#.
The plan is to only use Mono's embedding APIs to set things at launch.
This will make it much easier to later support CoreCLR too which
doesn't have rich embedding APIs.
Additionally the code in C# is more maintainable and makes it easier
to implement new features, e.g.: runtime codegen which we could use to
avoid using reflection for marshaling everytime a field, property or
method is accessed.
SOME NOTES ON INTEROP
We make the same assumptions as GDNative about the size of the Godot
structures we use. We take it a bit further by also assuming the layout
of fields in some cases, which is riskier but let's us squeeze out some
performance by avoiding unnecessary managed to native calls.
Code that deals with native structs is less safe than before as there's
no RAII and copy constructors in C#. It's like using the GDNative C API
directly. One has to take special care to free values they own.
Perhaps we could use roslyn analyzers to check this, but I don't know
any that uses attributes to determine what's owned or borrowed.
As to why we maily use pointers for native structs instead of ref/out:
- AFAIK (and confirmed with a benchmark) ref/out are pinned
during P/Invoke calls and that has a cost.
- Native struct fields can't be ref/out in the first place.
- A `using` local can't be passed as ref/out, only `in`. Calling a
method or property on an `in` value makes a silent copy, so we want
to avoid `in`.
REGARDING THE BUILD SYSTEM
There's no longer a `mono_glue=yes/no` SCons options. We no longer
need to build with `mono_glue=no`, generate the glue and then build
again with `mono_glue=yes`. We build only once and generate the glue
(which is in C# now).
However, SCons no longer builds the C# projects for us. Instead one
must run `build_assemblies.py`, e.g.:
```sh
%godot_src_root%/modules/mono/build_scripts/build_assemblies.py \
--godot-output-dir=%godot_src_root%/bin \
--godot-target=release_debug`
```
We could turn this into a custom build target, but I don't know how
to do that with SCons (it's possible with Meson).
OTHER NOTES
Most of the moved code doesn't follow the C# naming convention and
still has the word Mono in the names despite no longer dealing with
Mono's embedding APIs. This is just temporary while transitioning,
to make it easier to understand what was moved where.
2021-05-03 21:21:06 +08:00
SCOPE_EXIT {
_recursion_flag_ = false ;
} ;
2020-03-15 02:20:17 +08:00
2023-03-01 05:08:19 +08:00
if ( ! gdmono | | ! gdmono - > is_runtime_initialized ( ) ) {
2018-01-10 00:19:03 +08:00
return Vector < StackInfo > ( ) ;
2020-07-06 01:19:36 +08:00
}
2018-01-10 00:19:03 +08:00
Vector < StackInfo > si ;
2022-02-28 04:57:39 +08:00
if ( GDMonoCache : : godot_api_cache_updated ) {
GDMonoCache : : managed_callbacks . DebuggingUtils_GetCurrentStackInfo ( & si ) ;
2018-01-10 00:19:03 +08:00
}
return si ;
2021-09-13 02:21:15 +08:00
# else
return Vector < StackInfo > ( ) ;
# endif
2022-02-28 04:57:39 +08:00
}
2018-01-10 00:19:03 +08:00
2020-01-14 04:00:07 +08:00
void CSharpLanguage : : post_unsafe_reference ( Object * p_obj ) {
# ifdef DEBUG_ENABLED
2020-02-26 18:28:13 +08:00
MutexLock lock ( unsafe_object_references_lock ) ;
2020-01-14 04:00:07 +08:00
ObjectID id = p_obj - > get_instance_id ( ) ;
2020-01-24 04:23:32 +08:00
unsafe_object_references [ id ] + + ;
2020-01-14 04:00:07 +08:00
# endif
}
void CSharpLanguage : : pre_unsafe_unreference ( Object * p_obj ) {
# ifdef DEBUG_ENABLED
2020-02-26 18:28:13 +08:00
MutexLock lock ( unsafe_object_references_lock ) ;
2020-01-14 04:00:07 +08:00
ObjectID id = p_obj - > get_instance_id ( ) ;
2022-05-13 21:04:37 +08:00
HashMap < ObjectID , int > : : Iterator elem = unsafe_object_references . find ( id ) ;
2020-01-14 04:00:07 +08:00
ERR_FAIL_NULL ( elem ) ;
2022-05-13 21:04:37 +08:00
if ( - - elem - > value = = 0 ) {
unsafe_object_references . remove ( elem ) ;
2020-07-06 01:19:36 +08:00
}
2020-01-14 04:00:07 +08:00
# endif
}
2017-10-03 05:24:00 +08:00
void CSharpLanguage : : frame ( ) {
2021-09-13 02:23:05 +08:00
if ( gdmono & & gdmono - > is_runtime_initialized ( ) & & GDMonoCache : : godot_api_cache_updated ) {
GDMonoCache : : managed_callbacks . ScriptManagerBridge_FrameCallback ( ) ;
2017-10-03 05:24:00 +08:00
}
}
2022-05-28 10:56:46 +08:00
struct CSharpScriptDepSort {
// Must support sorting so inheritance works properly (parent must be reloaded first)
bool operator ( ) ( const Ref < CSharpScript > & A , const Ref < CSharpScript > & B ) const {
if ( A = = B ) {
// Shouldn't happen but just in case...
return false ;
}
2024-02-05 09:49:57 +08:00
const Script * I = B - > get_base_script ( ) . ptr ( ) ;
2022-05-28 10:56:46 +08:00
while ( I ) {
if ( I = = A . ptr ( ) ) {
// A is a base of B
return true ;
}
2024-02-05 09:49:57 +08:00
I = I - > get_base_script ( ) . ptr ( ) ;
2022-05-28 10:56:46 +08:00
}
// A isn't a base of B
return false ;
}
} ;
2017-10-03 05:24:00 +08:00
void CSharpLanguage : : reload_all_scripts ( ) {
2019-01-23 01:33:36 +08:00
# ifdef GD_MONO_HOT_RELOAD
2019-01-22 05:44:05 +08:00
if ( is_assembly_reloading_needed ( ) ) {
reload_assemblies ( false ) ;
2017-10-03 05:24:00 +08:00
}
# endif
}
2023-12-30 15:06:54 +08:00
void CSharpLanguage : : reload_scripts ( const Array & p_scripts , bool p_soft_reload ) {
2024-02-07 13:33:51 +08:00
# ifdef GD_MONO_HOT_RELOAD
if ( is_assembly_reloading_needed ( ) ) {
reload_assemblies ( p_soft_reload ) ;
2023-12-30 15:06:54 +08:00
}
2024-02-07 13:33:51 +08:00
# endif
}
2023-12-30 15:06:54 +08:00
2024-02-07 13:33:51 +08:00
void CSharpLanguage : : reload_tool_script ( const Ref < Script > & p_script , bool p_soft_reload ) {
CRASH_COND ( ! Engine : : get_singleton ( ) - > is_editor_hint ( ) ) ;
2023-12-30 15:06:54 +08:00
2017-10-03 05:24:00 +08:00
# ifdef TOOLS_ENABLED
2019-07-03 15:44:53 +08:00
get_godotsharp_editor ( ) - > get_node ( NodePath ( " HotReloadAssemblyWatcher " ) ) - > call ( " RestartTimer " ) ;
2019-01-23 01:33:36 +08:00
# endif
# ifdef GD_MONO_HOT_RELOAD
2018-12-01 03:43:06 +08:00
if ( is_assembly_reloading_needed ( ) ) {
reload_assemblies ( p_soft_reload ) ;
}
2017-10-03 05:24:00 +08:00
# endif
}
2019-01-23 01:33:36 +08:00
# ifdef GD_MONO_HOT_RELOAD
2018-12-01 03:43:06 +08:00
bool CSharpLanguage : : is_assembly_reloading_needed ( ) {
2023-03-01 05:08:19 +08:00
ERR_FAIL_NULL_V ( gdmono , false ) ;
2020-07-06 01:19:36 +08:00
if ( ! gdmono - > is_runtime_initialized ( ) ) {
2018-12-01 03:43:06 +08:00
return false ;
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
2022-05-28 10:56:46 +08:00
String assembly_path = gdmono - > get_project_assembly_path ( ) ;
2017-10-03 05:24:00 +08:00
2022-05-28 10:56:46 +08:00
if ( ! assembly_path . is_empty ( ) ) {
if ( ! FileAccess : : exists ( assembly_path ) ) {
return false ; // No assembly to load
2017-10-03 05:24:00 +08:00
}
2018-07-26 03:54:21 +08:00
2022-05-28 10:56:46 +08:00
if ( FileAccess : : get_modified_time ( assembly_path ) < = gdmono - > get_project_assembly_modified_time ( ) ) {
2018-12-01 03:43:06 +08:00
return false ; // Already up to date
2020-07-06 01:19:36 +08:00
}
2018-07-26 03:54:21 +08:00
} else {
2023-03-07 04:39:24 +08:00
String assembly_name = path : : get_csharp_project_name ( ) ;
2022-05-28 10:56:46 +08:00
assembly_path = GodotSharpDirs : : get_res_temp_assemblies_dir ( )
2022-08-30 08:34:01 +08:00
. path_join ( assembly_name + " .dll " ) ;
2022-05-28 10:56:46 +08:00
assembly_path = ProjectSettings : : get_singleton ( ) - > globalize_path ( assembly_path ) ;
if ( ! FileAccess : : exists ( assembly_path ) ) {
2018-12-01 03:43:06 +08:00
return false ; // No assembly to load
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
}
2018-12-01 03:43:06 +08:00
return true ;
}
void CSharpLanguage : : reload_assemblies ( bool p_soft_reload ) {
2023-03-01 05:08:19 +08:00
ERR_FAIL_NULL ( gdmono ) ;
2020-07-06 01:19:36 +08:00
if ( ! gdmono - > is_runtime_initialized ( ) ) {
2018-12-01 03:43:06 +08:00
return ;
2020-07-06 01:19:36 +08:00
}
2018-12-01 03:43:06 +08:00
2022-10-17 05:55:54 +08:00
if ( ! Engine : : get_singleton ( ) - > is_editor_hint ( ) ) {
// We disable collectible assemblies in the game player, because the limitations cause
// issues with mocking libraries. As such, we can only reload assemblies in the editor.
return ;
}
2022-05-28 10:56:46 +08:00
print_verbose ( " .NET: Reloading assemblies... " ) ;
2021-12-29 06:25:16 +08:00
2018-12-01 03:43:06 +08:00
// There is no soft reloading with Mono. It's always hard reloading.
2017-10-03 05:24:00 +08:00
2020-03-17 14:33:00 +08:00
List < Ref < CSharpScript > > scripts ;
2017-10-03 05:24:00 +08:00
2018-12-01 03:43:06 +08:00
{
2020-02-26 18:28:13 +08:00
MutexLock lock ( script_instances_mutex ) ;
2017-10-03 05:24:00 +08:00
2018-12-01 03:43:06 +08:00
for ( SelfList < CSharpScript > * elem = script_list . first ( ) ; elem ; elem = elem - > next ( ) ) {
2023-06-28 17:46:43 +08:00
// Do not reload scripts with only non-collectible instances to avoid disrupting event subscriptions and such.
bool is_reloadable = elem - > self ( ) - > instances . size ( ) = = 0 ;
2023-03-31 17:53:16 +08:00
for ( Object * obj : elem - > self ( ) - > instances ) {
ERR_CONTINUE ( ! obj - > get_script_instance ( ) ) ;
CSharpInstance * csi = static_cast < CSharpInstance * > ( obj - > get_script_instance ( ) ) ;
if ( GDMonoCache : : managed_callbacks . GCHandleBridge_GCHandleIsTargetCollectible ( csi - > get_gchandle_intptr ( ) ) ) {
is_reloadable = true ;
break ;
}
}
if ( is_reloadable ) {
// Cast to CSharpScript to avoid being erased by accident.
scripts . push_back ( Ref < CSharpScript > ( elem - > self ( ) ) ) ;
}
2017-10-03 05:24:00 +08:00
}
}
2020-03-15 02:20:17 +08:00
scripts . sort_custom < CSharpScriptDepSort > ( ) ; // Update in inheritance dependency order
// Serialize managed callables
{
MutexLock lock ( ManagedCallable : : instances_mutex ) ;
for ( SelfList < ManagedCallable > * elem = ManagedCallable : : instances . first ( ) ; elem ; elem = elem - > next ( ) ) {
ManagedCallable * managed_callable = elem - > self ( ) ;
2022-05-28 10:56:46 +08:00
ERR_CONTINUE ( managed_callable - > delegate_handle . value = = nullptr ) ;
2020-03-15 02:20:17 +08:00
2023-03-31 17:53:16 +08:00
if ( ! GDMonoCache : : managed_callbacks . GCHandleBridge_GCHandleIsTargetCollectible ( managed_callable - > delegate_handle ) ) {
continue ;
}
2022-05-28 10:56:46 +08:00
Array serialized_data ;
2020-03-15 02:20:17 +08:00
2022-05-28 10:56:46 +08:00
bool success = GDMonoCache : : managed_callbacks . DelegateUtils_TrySerializeDelegateWithGCHandle (
managed_callable - > delegate_handle , & serialized_data ) ;
2020-03-15 02:20:17 +08:00
if ( success ) {
ManagedCallable : : instances_pending_reload . insert ( managed_callable , serialized_data ) ;
} else if ( OS : : get_singleton ( ) - > is_stdout_verbose ( ) ) {
OS : : get_singleton ( ) - > print ( " Failed to serialize delegate \n " ) ;
}
}
}
2020-03-17 14:33:00 +08:00
List < Ref < CSharpScript > > to_reload ;
2017-10-03 05:24:00 +08:00
2019-07-03 15:44:53 +08:00
// We need to keep reference instances alive during reloading
2021-06-05 00:03:15 +08:00
List < Ref < RefCounted > > rc_instances ;
2019-07-03 15:44:53 +08:00
2021-07-27 03:31:17 +08:00
for ( const KeyValue < Object * , CSharpScriptBinding > & E : script_bindings ) {
const CSharpScriptBinding & script_binding = E . value ;
2021-06-05 00:03:15 +08:00
RefCounted * rc = Object : : cast_to < RefCounted > ( script_binding . owner ) ;
if ( rc ) {
rc_instances . push_back ( Ref < RefCounted > ( rc ) ) ;
2019-07-03 15:44:53 +08:00
}
}
2018-12-01 03:43:06 +08:00
// As scripts are going to be reloaded, must proceed without locking here
2017-10-03 05:24:00 +08:00
2023-03-24 19:38:00 +08:00
for ( Ref < CSharpScript > & scr : scripts ) {
2021-04-07 13:56:38 +08:00
// If someone removes a script from a node, deletes the script, builds, adds a script to the
// same node, then builds again, the script might have no path and also no script_class. In
// that case, we can't (and don't need to) reload it.
2023-03-24 19:38:00 +08:00
if ( scr - > get_path ( ) . is_empty ( ) & & ! scr - > valid ) {
2021-04-07 13:56:38 +08:00
continue ;
}
2023-03-24 19:38:00 +08:00
to_reload . push_back ( scr ) ;
2017-10-03 05:24:00 +08:00
2018-12-01 03:43:06 +08:00
// Script::instances are deleted during managed object disposal, which happens on domain finalize.
// Only placeholders are kept. Therefore we need to keep a copy before that happens.
2017-10-03 05:24:00 +08:00
2023-03-24 19:38:00 +08:00
for ( Object * obj : scr - > instances ) {
scr - > pending_reload_instances . insert ( obj - > get_instance_id ( ) ) ;
2019-07-03 15:44:53 +08:00
2022-09-03 04:31:56 +08:00
// Since this script instance wasn't a placeholder, add it to the list of placeholders
// that will have to be eventually replaced with a script instance in case it turns into one.
// This list is not cleared after the reload and the collected instances only leave
// the list if the script is instantiated or if it was a tool script but becomes a
// non-tool script in a rebuild.
2023-03-24 19:38:00 +08:00
scr - > pending_replace_placeholders . insert ( obj - > get_instance_id ( ) ) ;
2022-09-03 04:31:56 +08:00
2021-06-05 00:03:15 +08:00
RefCounted * rc = Object : : cast_to < RefCounted > ( obj ) ;
if ( rc ) {
rc_instances . push_back ( Ref < RefCounted > ( rc ) ) ;
2019-07-03 15:44:53 +08:00
}
2018-12-01 03:43:06 +08:00
}
2017-10-03 05:24:00 +08:00
2018-12-01 03:43:06 +08:00
# ifdef TOOLS_ENABLED
2023-03-24 19:38:00 +08:00
for ( PlaceHolderScriptInstance * instance : scr - > placeholders ) {
Object * obj = instance - > get_owner ( ) ;
scr - > pending_reload_instances . insert ( obj - > get_instance_id ( ) ) ;
2019-07-03 15:44:53 +08:00
2021-06-05 00:03:15 +08:00
RefCounted * rc = Object : : cast_to < RefCounted > ( obj ) ;
if ( rc ) {
rc_instances . push_back ( Ref < RefCounted > ( rc ) ) ;
2019-07-03 15:44:53 +08:00
}
2018-12-01 03:43:06 +08:00
}
# endif
2017-10-03 05:24:00 +08:00
2018-12-01 03:43:06 +08:00
// Save state and remove script from instances
2023-03-24 19:38:00 +08:00
RBMap < ObjectID , CSharpScript : : StateBackup > & owners_map = scr - > pending_reload_state ;
2017-10-03 05:24:00 +08:00
2023-03-24 19:38:00 +08:00
for ( Object * obj : scr - > instances ) {
2018-12-01 03:43:06 +08:00
ERR_CONTINUE ( ! obj - > get_script_instance ( ) ) ;
2017-10-03 05:24:00 +08:00
2019-07-03 15:44:53 +08:00
CSharpInstance * csi = static_cast < CSharpInstance * > ( obj - > get_script_instance ( ) ) ;
2017-10-03 05:24:00 +08:00
2022-05-28 10:56:46 +08:00
// Call OnBeforeSerialize and save instance info
2019-07-03 15:44:53 +08:00
CSharpScript : : StateBackup state ;
2022-05-28 10:56:46 +08:00
Dictionary properties ;
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_SerializeState (
csi - > get_gchandle_intptr ( ) , & properties , & state . event_signals ) ;
for ( const Variant * s = properties . next ( nullptr ) ; s ! = nullptr ; s = properties . next ( s ) ) {
StringName name = * s ;
Variant value = properties [ * s ] ;
state . properties . push_back ( Pair < StringName , Variant > ( name , value ) ) ;
}
2017-10-03 05:24:00 +08:00
2018-12-01 03:43:06 +08:00
owners_map [ obj - > get_instance_id ( ) ] = state ;
2019-07-03 15:44:53 +08:00
}
}
// After the state of all instances is saved, clear scripts and script instances
2023-03-24 19:38:00 +08:00
for ( Ref < CSharpScript > & scr : scripts ) {
while ( scr - > instances . begin ( ) ) {
Object * obj = * scr - > instances . begin ( ) ;
2022-05-03 07:43:50 +08:00
obj - > set_script ( Ref < RefCounted > ( ) ) ; // Remove script and existing script instances (placeholder are not removed before domain reload)
2017-10-03 05:24:00 +08:00
}
2018-12-01 03:43:06 +08:00
2024-02-05 09:49:57 +08:00
scr - > was_tool_before_reload = scr - > type_info . is_tool ;
2023-03-24 19:38:00 +08:00
scr - > _clear ( ) ;
2017-10-03 05:24:00 +08:00
}
2023-03-31 17:53:16 +08:00
// Release the delegates that were serialized earlier.
{
MutexLock lock ( ManagedCallable : : instances_mutex ) ;
for ( KeyValue < ManagedCallable * , Array > & kv : ManagedCallable : : instances_pending_reload ) {
kv . key - > release_delegate_handle ( ) ;
}
}
2018-12-01 03:43:06 +08:00
// Do domain reload
2022-05-28 10:56:46 +08:00
if ( gdmono - > reload_project_assemblies ( ) ! = OK ) {
2018-07-30 04:40:09 +08:00
// Failed to reload the scripts domain
// Make sure to add the scripts back to their owners before returning
2021-07-26 23:50:35 +08:00
for ( Ref < CSharpScript > & scr : to_reload ) {
2021-07-27 03:31:17 +08:00
for ( const KeyValue < ObjectID , CSharpScript : : StateBackup > & F : scr - > pending_reload_state ) {
Object * obj = ObjectDB : : get_instance ( F . key ) ;
2018-12-01 03:43:06 +08:00
2020-07-06 01:19:36 +08:00
if ( ! obj ) {
2018-07-30 04:40:09 +08:00
continue ;
2020-07-06 01:19:36 +08:00
}
2018-12-01 03:43:06 +08:00
ObjectID obj_id = obj - > get_instance_id ( ) ;
// Use a placeholder for now to avoid losing the state when saving a scene
PlaceHolderScriptInstance * placeholder = scr - > placeholder_instance_create ( obj ) ;
obj - > set_script_instance ( placeholder ) ;
2019-01-23 01:33:36 +08:00
# ifdef TOOLS_ENABLED
2018-12-01 03:43:06 +08:00
// Even though build didn't fail, this tells the placeholder to keep properties and
// it allows using property_set_fallback for restoring the state without a valid script.
2019-01-10 07:26:00 +08:00
scr - > placeholder_fallback_enabled = true ;
2019-01-23 01:33:36 +08:00
# endif
2018-12-01 03:43:06 +08:00
// Restore Variant properties state, it will be kept by the placeholder until the next script reloading
2021-07-27 03:31:17 +08:00
for ( const Pair < StringName , Variant > & G : scr - > pending_reload_state [ obj_id ] . properties ) {
placeholder - > property_set_fallback ( G . first , G . second , nullptr ) ;
2018-07-30 04:40:09 +08:00
}
2018-12-01 03:43:06 +08:00
scr - > pending_reload_state . erase ( obj_id ) ;
2018-07-30 04:40:09 +08:00
}
2022-05-28 10:56:46 +08:00
scr - > pending_reload_instances . clear ( ) ;
scr - > pending_reload_state . clear ( ) ;
2018-07-30 04:40:09 +08:00
}
2019-07-03 15:44:53 +08:00
2017-10-03 05:24:00 +08:00
return ;
2018-07-30 04:40:09 +08:00
}
2017-10-03 05:24:00 +08:00
2020-03-17 14:33:00 +08:00
List < Ref < CSharpScript > > to_reload_state ;
2019-07-03 15:44:53 +08:00
2023-03-24 19:38:00 +08:00
for ( Ref < CSharpScript > & scr : to_reload ) {
2019-01-23 01:33:36 +08:00
# ifdef TOOLS_ENABLED
2023-03-24 19:38:00 +08:00
scr - > exports_invalidated = true ;
2019-01-23 01:33:36 +08:00
# endif
2019-07-03 15:44:53 +08:00
2024-02-05 09:49:57 +08:00
if ( ! scr - > get_path ( ) . is_empty ( ) & & ! scr - > get_path ( ) . begins_with ( " csharp:// " ) ) {
2023-03-24 19:38:00 +08:00
scr - > reload ( p_soft_reload ) ;
2019-07-08 21:18:38 +08:00
2023-03-24 19:38:00 +08:00
if ( ! scr - > valid ) {
scr - > pending_reload_instances . clear ( ) ;
scr - > pending_reload_state . clear ( ) ;
2019-07-08 21:18:38 +08:00
continue ;
}
2019-07-03 15:44:53 +08:00
} else {
2023-03-24 19:38:00 +08:00
bool success = GDMonoCache : : managed_callbacks . ScriptManagerBridge_TryReloadRegisteredScriptWithClass ( scr . ptr ( ) ) ;
2019-07-08 21:22:51 +08:00
2022-05-28 10:56:46 +08:00
if ( ! success ) {
// Couldn't reload
2023-03-24 19:38:00 +08:00
scr - > pending_reload_instances . clear ( ) ;
scr - > pending_reload_state . clear ( ) ;
2019-07-03 15:44:53 +08:00
continue ;
}
}
2023-03-24 19:38:00 +08:00
StringName native_name = scr - > get_instance_base_type ( ) ;
2017-10-03 05:24:00 +08:00
2018-12-01 03:43:06 +08:00
{
2023-03-24 19:38:00 +08:00
for ( const ObjectID & obj_id : scr - > pending_reload_instances ) {
2018-12-01 03:43:06 +08:00
Object * obj = ObjectDB : : get_instance ( obj_id ) ;
if ( ! obj ) {
2023-03-24 19:38:00 +08:00
scr - > pending_reload_state . erase ( obj_id ) ;
2019-07-03 15:44:53 +08:00
continue ;
}
if ( ! ClassDB : : is_parent_class ( obj - > get_class_name ( ) , native_name ) ) {
// No longer inherits the same compatible type, can't reload
2023-03-24 19:38:00 +08:00
scr - > pending_reload_state . erase ( obj_id ) ;
2018-12-01 03:43:06 +08:00
continue ;
}
2017-10-03 05:24:00 +08:00
2018-12-01 03:43:06 +08:00
ScriptInstance * si = obj - > get_script_instance ( ) ;
2017-10-03 05:24:00 +08:00
2022-09-03 04:31:56 +08:00
// Check if the script must be instantiated or kept as a placeholder
// when the script may not be a tool (see #65266)
2023-03-24 19:38:00 +08:00
bool replace_placeholder = scr - > pending_replace_placeholders . has ( obj - > get_instance_id ( ) ) ;
if ( ! scr - > is_tool ( ) & & scr - > was_tool_before_reload ) {
2022-09-03 04:31:56 +08:00
// The script was a tool before the rebuild so the removal was intentional.
replace_placeholder = false ;
2023-03-24 19:38:00 +08:00
scr - > pending_replace_placeholders . erase ( obj - > get_instance_id ( ) ) ;
2022-09-03 04:31:56 +08:00
}
2018-12-01 03:43:06 +08:00
# ifdef TOOLS_ENABLED
if ( si ) {
// If the script instance is not null, then it must be a placeholder.
// Non-placeholder script instances are removed in godot_icall_Object_Disposed.
CRASH_COND ( ! si - > is_placeholder ( ) ) ;
2023-03-24 19:38:00 +08:00
if ( replace_placeholder | | scr - > is_tool ( ) | | ScriptServer : : is_scripting_enabled ( ) ) {
2022-09-03 04:31:56 +08:00
// Replace placeholder with a script instance.
2018-12-01 03:43:06 +08:00
2023-03-24 19:38:00 +08:00
CSharpScript : : StateBackup & state_backup = scr - > pending_reload_state [ obj_id ] ;
2018-12-01 03:43:06 +08:00
2022-09-03 04:31:56 +08:00
// Backup placeholder script instance state before replacing it with a script instance.
2019-01-22 05:44:05 +08:00
si - > get_property_state ( state_backup . properties ) ;
2018-12-01 03:43:06 +08:00
2023-03-24 19:38:00 +08:00
ScriptInstance * instance = scr - > instance_create ( obj ) ;
2018-12-01 03:43:06 +08:00
2023-03-24 19:38:00 +08:00
if ( instance ) {
scr - > placeholders . erase ( static_cast < PlaceHolderScriptInstance * > ( si ) ) ;
scr - > pending_replace_placeholders . erase ( obj - > get_instance_id ( ) ) ;
obj - > set_script_instance ( instance ) ;
2018-12-01 03:43:06 +08:00
}
}
continue ;
2017-10-03 05:24:00 +08:00
}
2018-12-01 03:43:06 +08:00
# else
2020-04-02 07:20:12 +08:00
CRASH_COND ( si ! = nullptr ) ;
2018-12-01 03:43:06 +08:00
# endif
2022-09-03 04:31:56 +08:00
// Re-create the script instance.
2023-03-24 19:38:00 +08:00
if ( replace_placeholder | | scr - > is_tool ( ) | | ScriptServer : : is_scripting_enabled ( ) ) {
2022-09-03 04:31:56 +08:00
// Create script instance or replace placeholder with a script instance.
2023-03-24 19:38:00 +08:00
ScriptInstance * instance = scr - > instance_create ( obj ) ;
2022-09-03 04:31:56 +08:00
2023-03-24 19:38:00 +08:00
if ( instance ) {
scr - > pending_replace_placeholders . erase ( obj - > get_instance_id ( ) ) ;
obj - > set_script_instance ( instance ) ;
2022-09-03 04:31:56 +08:00
continue ;
}
}
// The script instance could not be instantiated or wasn't in the list of placeholders to replace.
2023-03-24 19:38:00 +08:00
obj - > set_script ( scr ) ;
2024-01-17 17:12:44 +08:00
# ifdef DEBUG_ENABLED
2022-09-03 04:31:56 +08:00
// If we reached here, the instantiated script must be a placeholder.
CRASH_COND ( ! obj - > get_script_instance ( ) - > is_placeholder ( ) ) ;
# endif
2019-07-03 15:44:53 +08:00
}
}
2018-12-01 03:43:06 +08:00
2023-03-24 19:38:00 +08:00
to_reload_state . push_back ( scr ) ;
2019-07-03 15:44:53 +08:00
}
2018-12-01 03:43:06 +08:00
2024-04-18 15:38:10 +08:00
// Deserialize managed callables.
// This is done before reloading script's internal state, so potential callables invoked in properties work.
{
MutexLock lock ( ManagedCallable : : instances_mutex ) ;
for ( const KeyValue < ManagedCallable * , Array > & elem : ManagedCallable : : instances_pending_reload ) {
ManagedCallable * managed_callable = elem . key ;
const Array & serialized_data = elem . value ;
GCHandleIntPtr delegate = { nullptr } ;
bool success = GDMonoCache : : managed_callbacks . DelegateUtils_TryDeserializeDelegateWithGCHandle (
& serialized_data , & delegate ) ;
if ( success ) {
ERR_CONTINUE ( delegate . value = = nullptr ) ;
managed_callable - > delegate_handle = delegate ;
} else if ( OS : : get_singleton ( ) - > is_stdout_verbose ( ) ) {
OS : : get_singleton ( ) - > print ( " Failed to deserialize delegate \n " ) ;
}
}
ManagedCallable : : instances_pending_reload . clear ( ) ;
}
2023-03-24 19:38:00 +08:00
for ( Ref < CSharpScript > & scr : to_reload_state ) {
for ( const ObjectID & obj_id : scr - > pending_reload_instances ) {
2019-07-03 15:44:53 +08:00
Object * obj = ObjectDB : : get_instance ( obj_id ) ;
if ( ! obj ) {
2023-03-24 19:38:00 +08:00
scr - > pending_reload_state . erase ( obj_id ) ;
2019-07-03 15:44:53 +08:00
continue ;
2017-10-03 05:24:00 +08:00
}
2019-07-03 15:44:53 +08:00
ERR_CONTINUE ( ! obj - > get_script_instance ( ) ) ;
2023-03-24 19:38:00 +08:00
CSharpScript : : StateBackup & state_backup = scr - > pending_reload_state [ obj_id ] ;
2019-07-03 15:44:53 +08:00
CSharpInstance * csi = CAST_CSHARP_INSTANCE ( obj - > get_script_instance ( ) ) ;
2020-03-15 02:20:17 +08:00
if ( csi ) {
2022-05-28 10:56:46 +08:00
Dictionary properties ;
2020-03-15 02:20:17 +08:00
2022-05-28 10:56:46 +08:00
for ( const Pair < StringName , Variant > & G : state_backup . properties ) {
properties [ G . first ] = G . second ;
2020-03-15 02:20:17 +08:00
}
2024-04-18 15:38:10 +08:00
// Restore serialized state and call OnAfterDeserialize.
2022-05-28 10:56:46 +08:00
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_DeserializeState (
csi - > get_gchandle_intptr ( ) , & properties , & state_backup . event_signals ) ;
2020-03-15 02:20:17 +08:00
}
2017-10-03 05:24:00 +08:00
}
2019-07-03 15:44:53 +08:00
2023-03-24 19:38:00 +08:00
scr - > pending_reload_instances . clear ( ) ;
scr - > pending_reload_state . clear ( ) ;
2017-10-03 05:24:00 +08:00
}
2017-10-29 12:57:20 +08:00
2019-01-23 01:33:36 +08:00
# ifdef TOOLS_ENABLED
2018-12-01 03:43:06 +08:00
// FIXME: Hack to refresh editor in order to display new properties and signals. See if there is a better alternative.
2018-01-19 01:17:29 +08:00
if ( Engine : : get_singleton ( ) - > is_editor_hint ( ) ) {
2021-11-18 04:08:55 +08:00
InspectorDock : : get_inspector_singleton ( ) - > update_tree ( ) ;
NodeDock : : get_singleton ( ) - > update_lists ( ) ;
2018-01-19 01:17:29 +08:00
}
2019-01-23 01:33:36 +08:00
# endif
2018-10-23 01:43:19 +08:00
}
2021-09-13 02:21:15 +08:00
# endif
2018-10-23 01:43:19 +08:00
2017-10-03 05:24:00 +08:00
void CSharpLanguage : : get_recognized_extensions ( List < String > * p_extensions ) const {
p_extensions - > push_back ( " cs " ) ;
}
# ifdef TOOLS_ENABLED
Error CSharpLanguage : : open_in_external_editor ( const Ref < Script > & p_script , int p_line , int p_col ) {
2019-07-03 15:44:53 +08:00
return ( Error ) ( int ) get_godotsharp_editor ( ) - > call ( " OpenInExternalEditor " , p_script , p_line , p_col ) ;
2017-10-03 05:24:00 +08:00
}
bool CSharpLanguage : : overrides_external_editor ( ) {
2019-07-03 15:44:53 +08:00
return get_godotsharp_editor ( ) - > call ( " OverridesExternalEditor " ) ;
2017-10-03 05:24:00 +08:00
}
# endif
bool CSharpLanguage : : debug_break_parse ( const String & p_file , int p_line , const String & p_error ) {
2019-03-08 03:47:13 +08:00
// Not a parser error in our case, but it's still used for other type of errors
2020-02-27 10:30:20 +08:00
if ( EngineDebugger : : is_active ( ) & & Thread : : get_caller_id ( ) = = Thread : : get_main_id ( ) ) {
2019-03-08 03:47:13 +08:00
_debug_parse_err_line = p_line ;
_debug_parse_err_file = p_file ;
_debug_error = p_error ;
2020-02-27 10:30:20 +08:00
EngineDebugger : : get_script_debugger ( ) - > debug ( this , false , true ) ;
2017-10-03 05:24:00 +08:00
return true ;
} else {
return false ;
}
}
bool CSharpLanguage : : debug_break ( const String & p_error , bool p_allow_continue ) {
2020-02-27 10:30:20 +08:00
if ( EngineDebugger : : is_active ( ) & & Thread : : get_caller_id ( ) = = Thread : : get_main_id ( ) ) {
2019-03-08 03:47:13 +08:00
_debug_parse_err_line = - 1 ;
_debug_parse_err_file = " " ;
_debug_error = p_error ;
2020-02-27 10:30:20 +08:00
EngineDebugger : : get_script_debugger ( ) - > debug ( this , p_allow_continue ) ;
2017-10-03 05:24:00 +08:00
return true ;
} else {
return false ;
}
}
2019-07-03 15:44:53 +08:00
# ifdef TOOLS_ENABLED
void CSharpLanguage : : _editor_init_callback ( ) {
2021-09-13 02:23:05 +08:00
// Load GodotTools and initialize GodotSharpEditor
2019-07-03 15:44:53 +08:00
2022-08-05 09:32:59 +08:00
int32_t interop_funcs_size = 0 ;
const void * * interop_funcs = godotsharp : : get_editor_interop_funcs ( interop_funcs_size ) ;
2021-12-29 06:25:16 +08:00
Object * editor_plugin_obj = GDMono : : get_singleton ( ) - > get_plugin_callbacks ( ) . LoadToolsAssemblyCallback (
2022-08-30 08:34:01 +08:00
GodotSharpDirs : : get_data_editor_tools_dir ( ) . path_join ( " GodotTools.dll " ) . utf16 ( ) ,
2022-08-05 09:32:59 +08:00
interop_funcs , interop_funcs_size ) ;
2021-09-13 02:23:05 +08:00
CRASH_COND ( editor_plugin_obj = = nullptr ) ;
2021-09-13 02:21:15 +08:00
2021-09-13 02:23:05 +08:00
EditorPlugin * godotsharp_editor = Object : : cast_to < EditorPlugin > ( editor_plugin_obj ) ;
2020-04-02 07:20:12 +08:00
CRASH_COND ( godotsharp_editor = = nullptr ) ;
2019-07-03 15:44:53 +08:00
2021-09-13 02:23:05 +08:00
// Add plugin to EditorNode and enable it
2019-07-03 15:44:53 +08:00
EditorNode : : add_editor_plugin ( godotsharp_editor ) ;
godotsharp_editor - > enable_plugin ( ) ;
get_singleton ( ) - > godotsharp_editor = godotsharp_editor ;
}
# endif
2017-10-03 05:24:00 +08:00
void CSharpLanguage : : set_language_index ( int p_idx ) {
ERR_FAIL_COND ( lang_idx ! = - 1 ) ;
lang_idx = p_idx ;
}
2019-12-12 00:08:40 +08:00
void CSharpLanguage : : release_script_gchandle ( MonoGCHandleData & p_gchandle ) {
if ( ! p_gchandle . is_released ( ) ) { // Do not lock unnecessarily
2020-02-26 18:28:13 +08:00
MutexLock lock ( get_singleton ( ) - > script_gchandle_release_mutex ) ;
2019-12-12 00:08:40 +08:00
p_gchandle . release ( ) ;
2018-09-12 08:41:54 +08:00
}
}
2022-02-28 04:57:30 +08:00
void CSharpLanguage : : release_script_gchandle_thread_safe ( GCHandleIntPtr p_gchandle_to_free , MonoGCHandleData & r_gchandle ) {
if ( ! r_gchandle . is_released ( ) & & r_gchandle . get_intptr ( ) = = p_gchandle_to_free ) { // Do not lock unnecessarily
MutexLock lock ( get_singleton ( ) - > script_gchandle_release_mutex ) ;
if ( ! r_gchandle . is_released ( ) & & r_gchandle . get_intptr ( ) = = p_gchandle_to_free ) {
r_gchandle . release ( ) ;
}
}
}
2018-09-12 08:41:54 +08:00
2022-02-28 04:57:30 +08:00
void CSharpLanguage : : release_binding_gchandle_thread_safe ( GCHandleIntPtr p_gchandle_to_free , CSharpScriptBinding & r_script_binding ) {
MonoGCHandleData & gchandle = r_script_binding . gchandle ;
if ( ! gchandle . is_released ( ) & & gchandle . get_intptr ( ) = = p_gchandle_to_free ) { // Do not lock unnecessarily
MutexLock lock ( get_singleton ( ) - > script_gchandle_release_mutex ) ;
if ( ! gchandle . is_released ( ) & & gchandle . get_intptr ( ) = = p_gchandle_to_free ) {
gchandle . release ( ) ;
r_script_binding . inited = false ; // Here too, to be thread safe
}
}
2018-09-12 08:41:54 +08:00
}
2017-10-03 05:24:00 +08:00
CSharpLanguage : : CSharpLanguage ( ) {
2019-09-25 16:28:50 +08:00
ERR_FAIL_COND_MSG ( singleton , " C# singleton already exist. " ) ;
2017-10-03 05:24:00 +08:00
singleton = this ;
}
CSharpLanguage : : ~ CSharpLanguage ( ) {
2020-07-06 01:19:36 +08:00
finalize ( ) ;
2020-03-15 02:20:17 +08:00
singleton = nullptr ;
2017-10-03 05:24:00 +08:00
}
2019-02-03 13:35:22 +08:00
bool CSharpLanguage : : setup_csharp_script_binding ( CSharpScriptBinding & r_script_binding , Object * p_object ) {
2017-10-03 05:24:00 +08:00
# ifdef DEBUG_ENABLED
// I don't trust you
2019-02-03 13:35:22 +08:00
if ( p_object - > get_script_instance ( ) ) {
CSharpInstance * csharp_instance = CAST_CSHARP_INSTANCE ( p_object - > get_script_instance ( ) ) ;
2020-04-02 07:20:12 +08:00
CRASH_COND ( csharp_instance ! = nullptr & & ! csharp_instance - > is_destructing_script_instance ( ) ) ;
2019-02-03 13:35:22 +08:00
}
2017-10-03 05:24:00 +08:00
# endif
StringName type_name = p_object - > get_class_name ( ) ;
2017-10-10 05:50:06 +08:00
const ClassDB : : ClassInfo * classinfo = ClassDB : : classes . getptr ( type_name ) ;
2023-04-12 06:35:10 +08:00
// This skipping of GDExtension classes, as well as whatever classes are in this list of ignored types, is a
// workaround to allow GDExtension classes to be used from C# so long as they're only used through base classes that
// are registered from the engine. This will likely need to be removed whenever proper support for GDExtension
// classes is added to C#. See #75955 for more details.
while ( classinfo & & ( ! classinfo - > exposed | | classinfo - > gdextension | | ignored_types . has ( classinfo - > name ) ) ) {
2017-10-10 05:50:06 +08:00
classinfo = classinfo - > inherits_ptr ;
2020-07-06 01:19:36 +08:00
}
2023-04-12 06:35:10 +08:00
2019-02-03 13:35:22 +08:00
ERR_FAIL_NULL_V ( classinfo , false ) ;
2017-10-10 05:50:06 +08:00
type_name = classinfo - > name ;
2021-09-13 02:21:15 +08:00
bool parent_is_object_class = ClassDB : : is_parent_class ( p_object - > get_class_name ( ) , type_name ) ;
ERR_FAIL_COND_V_MSG ( ! parent_is_object_class , false ,
" Type inherits from native type ' " + type_name + " ', so it can't be instantiated in object of type: ' " + p_object - > get_class ( ) + " '. " ) ;
2017-10-03 05:24:00 +08:00
2022-02-28 04:57:30 +08:00
# ifdef DEBUG_ENABLED
CRASH_COND ( ! r_script_binding . gchandle . is_released ( ) ) ;
# endif
2021-09-13 02:21:15 +08:00
GCHandleIntPtr strong_gchandle =
2022-05-28 10:56:46 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_CreateManagedForGodotObjectBinding (
& type_name , p_object ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
ERR_FAIL_NULL_V ( strong_gchandle . value , false ) ;
2017-10-03 05:24:00 +08:00
2019-02-03 13:35:22 +08:00
r_script_binding . inited = true ;
r_script_binding . type_name = type_name ;
2021-09-13 02:21:15 +08:00
r_script_binding . gchandle = MonoGCHandleData ( strong_gchandle , gdmono : : GCHandleType : : STRONG_HANDLE ) ;
2019-07-03 15:44:53 +08:00
r_script_binding . owner = p_object ;
2017-10-03 05:24:00 +08:00
2018-09-12 08:41:54 +08:00
// Tie managed to unmanaged
2021-06-05 00:03:15 +08:00
RefCounted * rc = Object : : cast_to < RefCounted > ( p_object ) ;
2018-09-12 08:41:54 +08:00
2021-06-05 00:03:15 +08:00
if ( rc ) {
2018-09-12 08:41:54 +08:00
// Unsafe refcount increment. The managed instance also counts as a reference.
// This way if the unmanaged world has no references to our owner
// but the managed instance is alive, the refcount will be 1 instead of 0.
2021-06-13 17:15:44 +08:00
// See: godot_icall_RefCounted_Dtor(MonoObject *p_obj, Object *p_ptr)
2018-09-12 08:41:54 +08:00
2021-06-05 00:03:15 +08:00
rc - > reference ( ) ;
CSharpLanguage : : get_singleton ( ) - > post_unsafe_reference ( rc ) ;
2018-09-12 08:41:54 +08:00
}
2019-02-03 13:35:22 +08:00
return true ;
}
2022-05-13 21:04:37 +08:00
RBMap < Object * , CSharpScriptBinding > : : Element * CSharpLanguage : : insert_script_binding ( Object * p_object , const CSharpScriptBinding & p_script_binding ) {
2021-08-16 23:16:36 +08:00
return script_bindings . insert ( p_object , p_script_binding ) ;
}
void * CSharpLanguage : : _instance_binding_create_callback ( void * , void * p_instance ) {
CSharpLanguage * csharp_lang = CSharpLanguage : : get_singleton ( ) ;
2019-02-05 03:39:02 +08:00
2021-08-16 23:16:36 +08:00
MutexLock lock ( csharp_lang - > language_bind_mutex ) ;
2022-05-13 21:04:37 +08:00
RBMap < Object * , CSharpScriptBinding > : : Element * match = csharp_lang - > script_bindings . find ( ( Object * ) p_instance ) ;
2020-07-06 01:19:36 +08:00
if ( match ) {
2019-02-05 03:39:02 +08:00
return ( void * ) match ;
2020-07-06 01:19:36 +08:00
}
2019-02-05 03:39:02 +08:00
2019-02-03 13:35:22 +08:00
CSharpScriptBinding script_binding ;
2021-08-16 23:16:36 +08:00
return ( void * ) csharp_lang - > insert_script_binding ( ( Object * ) p_instance , script_binding ) ;
2019-02-05 03:39:02 +08:00
}
2019-02-03 13:35:22 +08:00
2021-08-16 23:16:36 +08:00
void CSharpLanguage : : _instance_binding_free_callback ( void * , void * , void * p_binding ) {
CSharpLanguage * csharp_lang = CSharpLanguage : : get_singleton ( ) ;
2017-10-03 05:24:00 +08:00
2020-04-02 07:20:12 +08:00
if ( GDMono : : get_singleton ( ) = = nullptr ) {
2017-11-01 08:48:47 +08:00
# ifdef DEBUG_ENABLED
C#: Move marshaling logic and generated glue to C#
We will be progressively moving most code to C#.
The plan is to only use Mono's embedding APIs to set things at launch.
This will make it much easier to later support CoreCLR too which
doesn't have rich embedding APIs.
Additionally the code in C# is more maintainable and makes it easier
to implement new features, e.g.: runtime codegen which we could use to
avoid using reflection for marshaling everytime a field, property or
method is accessed.
SOME NOTES ON INTEROP
We make the same assumptions as GDNative about the size of the Godot
structures we use. We take it a bit further by also assuming the layout
of fields in some cases, which is riskier but let's us squeeze out some
performance by avoiding unnecessary managed to native calls.
Code that deals with native structs is less safe than before as there's
no RAII and copy constructors in C#. It's like using the GDNative C API
directly. One has to take special care to free values they own.
Perhaps we could use roslyn analyzers to check this, but I don't know
any that uses attributes to determine what's owned or borrowed.
As to why we maily use pointers for native structs instead of ref/out:
- AFAIK (and confirmed with a benchmark) ref/out are pinned
during P/Invoke calls and that has a cost.
- Native struct fields can't be ref/out in the first place.
- A `using` local can't be passed as ref/out, only `in`. Calling a
method or property on an `in` value makes a silent copy, so we want
to avoid `in`.
REGARDING THE BUILD SYSTEM
There's no longer a `mono_glue=yes/no` SCons options. We no longer
need to build with `mono_glue=no`, generate the glue and then build
again with `mono_glue=yes`. We build only once and generate the glue
(which is in C# now).
However, SCons no longer builds the C# projects for us. Instead one
must run `build_assemblies.py`, e.g.:
```sh
%godot_src_root%/modules/mono/build_scripts/build_assemblies.py \
--godot-output-dir=%godot_src_root%/bin \
--godot-target=release_debug`
```
We could turn this into a custom build target, but I don't know how
to do that with SCons (it's possible with Meson).
OTHER NOTES
Most of the moved code doesn't follow the C# naming convention and
still has the word Mono in the names despite no longer dealing with
Mono's embedding APIs. This is just temporary while transitioning,
to make it easier to understand what was moved where.
2021-05-03 21:21:06 +08:00
CRASH_COND ( csharp_lang & & ! csharp_lang - > script_bindings . is_empty ( ) ) ;
2017-11-01 08:48:47 +08:00
# endif
// Mono runtime finalized, all the gchandle bindings were already released
return ;
}
2021-08-16 23:16:36 +08:00
if ( csharp_lang - > finalizing ) {
2018-01-01 05:37:57 +08:00
return ; // inside CSharpLanguage::finish(), all the gchandle bindings are released there
2020-07-06 01:19:36 +08:00
}
2018-01-01 05:37:57 +08:00
2018-12-01 03:43:06 +08:00
{
2021-08-16 23:16:36 +08:00
MutexLock lock ( csharp_lang - > language_bind_mutex ) ;
2018-01-01 05:37:57 +08:00
2022-05-13 21:04:37 +08:00
RBMap < Object * , CSharpScriptBinding > : : Element * data = ( RBMap < Object * , CSharpScriptBinding > : : Element * ) p_binding ;
2018-01-01 05:37:57 +08:00
2019-02-03 13:35:22 +08:00
CSharpScriptBinding & script_binding = data - > value ( ) ;
if ( script_binding . inited ) {
// Set the native instance field to IntPtr.Zero, if not yet garbage collected.
// This is done to avoid trying to dispose the native instance from Dispose(bool).
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_SetGodotObjectPtr (
script_binding . gchandle . get_intptr ( ) , nullptr ) ;
2021-09-13 02:21:15 +08:00
2019-12-12 00:08:40 +08:00
script_binding . gchandle . release ( ) ;
2021-09-13 02:21:15 +08:00
script_binding . inited = false ;
2018-12-01 03:43:06 +08:00
}
2017-10-03 05:24:00 +08:00
2021-08-16 23:16:36 +08:00
csharp_lang - > script_bindings . erase ( data ) ;
2018-12-01 03:43:06 +08:00
}
2017-10-03 05:24:00 +08:00
}
2022-12-07 19:11:28 +08:00
GDExtensionBool CSharpLanguage : : _instance_binding_reference_callback ( void * p_token , void * p_binding , GDExtensionBool p_reference ) {
2024-06-15 02:10:03 +08:00
// Instance bindings callbacks can only be called if the C# language is available.
// Failing this assert usually means that we didn't clear the instance binding in some Object
// and the C# language has already been finalized.
DEV_ASSERT ( CSharpLanguage : : get_singleton ( ) ! = nullptr ) ;
2021-08-16 23:16:36 +08:00
CRASH_COND ( ! p_binding ) ;
2022-05-13 21:04:37 +08:00
CSharpScriptBinding & script_binding = ( ( RBMap < Object * , CSharpScriptBinding > : : Element * ) p_binding ) - > get ( ) ;
2021-08-16 23:16:36 +08:00
RefCounted * rc_owner = Object : : cast_to < RefCounted > ( script_binding . owner ) ;
2018-02-22 22:34:08 +08:00
# ifdef DEBUG_ENABLED
2021-06-05 00:03:15 +08:00
CRASH_COND ( ! rc_owner ) ;
2018-02-22 22:34:08 +08:00
# endif
2019-12-12 00:08:40 +08:00
MonoGCHandleData & gchandle = script_binding . gchandle ;
2018-02-22 22:34:08 +08:00
2022-09-19 22:45:45 +08:00
int refcount = rc_owner - > get_reference_count ( ) ;
2021-08-16 23:16:36 +08:00
2020-07-06 01:19:36 +08:00
if ( ! script_binding . inited ) {
2021-08-16 23:16:36 +08:00
return refcount = = 0 ;
2020-07-06 01:19:36 +08:00
}
2019-07-03 15:44:53 +08:00
2021-08-16 23:16:36 +08:00
if ( p_reference ) {
// Refcount incremented
if ( refcount > 1 & & gchandle . is_weak ( ) ) { // The managed side also holds a reference, hence 1 instead of 0
// The reference count was increased after the managed side was the only one referencing our owner.
// This means the owner is being referenced again by the unmanaged side,
// so the owner must hold the managed side alive again to avoid it from being GCed.
2021-09-13 02:21:15 +08:00
// Release the current weak handle and replace it with a strong handle.
GCHandleIntPtr old_gchandle = gchandle . get_intptr ( ) ;
2022-02-28 04:57:30 +08:00
gchandle . handle = { nullptr } ; // No longer owns the handle (released by swap function)
2021-09-13 02:21:15 +08:00
2022-02-28 04:57:30 +08:00
GCHandleIntPtr new_gchandle = { nullptr } ;
2021-09-13 02:21:15 +08:00
bool create_weak = false ;
2021-09-13 02:23:05 +08:00
bool target_alive = GDMonoCache : : managed_callbacks . ScriptManagerBridge_SwapGCHandleForType (
old_gchandle , & new_gchandle , create_weak ) ;
2021-09-13 02:21:15 +08:00
if ( ! target_alive ) {
2021-08-16 23:16:36 +08:00
return false ; // Called after the managed side was collected, so nothing to do here
}
2018-02-22 22:34:08 +08:00
2021-09-13 02:21:15 +08:00
gchandle = MonoGCHandleData ( new_gchandle , gdmono : : GCHandleType : : STRONG_HANDLE ) ;
2020-07-06 01:19:36 +08:00
}
2018-02-22 22:34:08 +08:00
2021-08-16 23:16:36 +08:00
return false ;
} else {
// Refcount decremented
if ( refcount = = 1 & & ! gchandle . is_released ( ) & & ! gchandle . is_weak ( ) ) { // The managed side also holds a reference, hence 1 instead of 0
// If owner owner is no longer referenced by the unmanaged side,
// the managed instance takes responsibility of deleting the owner when GCed.
2018-02-22 22:34:08 +08:00
2021-09-13 02:21:15 +08:00
// Release the current strong handle and replace it with a weak handle.
GCHandleIntPtr old_gchandle = gchandle . get_intptr ( ) ;
2022-02-28 04:57:30 +08:00
gchandle . handle = { nullptr } ; // No longer owns the handle (released by swap function)
2021-09-13 02:21:15 +08:00
2022-02-28 04:57:30 +08:00
GCHandleIntPtr new_gchandle = { nullptr } ;
2021-09-13 02:21:15 +08:00
bool create_weak = true ;
2021-09-13 02:23:05 +08:00
bool target_alive = GDMonoCache : : managed_callbacks . ScriptManagerBridge_SwapGCHandleForType (
old_gchandle , & new_gchandle , create_weak ) ;
2021-09-13 02:21:15 +08:00
if ( ! target_alive ) {
2021-08-16 23:16:36 +08:00
return refcount = = 0 ; // Called after the managed side was collected, so nothing to do here
}
2018-02-22 22:34:08 +08:00
2021-09-13 02:21:15 +08:00
gchandle = MonoGCHandleData ( new_gchandle , gdmono : : GCHandleType : : WEAK_HANDLE ) ;
2019-02-03 13:35:22 +08:00
2021-08-16 23:16:36 +08:00
return false ;
}
2019-07-03 15:44:53 +08:00
return refcount = = 0 ;
2020-07-06 01:19:36 +08:00
}
2021-08-16 23:16:36 +08:00
}
2019-07-03 15:44:53 +08:00
2021-08-16 23:16:36 +08:00
void * CSharpLanguage : : get_instance_binding ( Object * p_object ) {
2023-11-16 04:06:13 +08:00
return p_object - > get_instance_binding ( get_singleton ( ) , & _instance_binding_callbacks ) ;
}
void * CSharpLanguage : : get_instance_binding_with_setup ( Object * p_object ) {
void * binding = get_instance_binding ( p_object ) ;
2020-01-17 00:11:13 +08:00
2021-08-16 23:16:36 +08:00
// Initially this was in `_instance_binding_create_callback`. However, after the new instance
// binding re-write it was resulting in a deadlock in `_instance_binding_reference`, as
// `setup_csharp_script_binding` may call `reference()`. It was moved here outside to fix that.
2018-02-22 22:34:08 +08:00
2021-08-16 23:16:36 +08:00
if ( binding ) {
2022-05-13 21:04:37 +08:00
CSharpScriptBinding & script_binding = ( ( RBMap < Object * , CSharpScriptBinding > : : Element * ) binding ) - > value ( ) ;
2018-02-22 22:34:08 +08:00
2021-08-16 23:16:36 +08:00
if ( ! script_binding . inited ) {
MutexLock lock ( CSharpLanguage : : get_singleton ( ) - > get_language_bind_mutex ( ) ) ;
2018-02-22 22:34:08 +08:00
2021-08-16 23:16:36 +08:00
if ( ! script_binding . inited ) { // Another thread may have set it up
CSharpLanguage : : get_singleton ( ) - > setup_csharp_script_binding ( script_binding , p_object ) ;
}
}
2018-02-22 22:34:08 +08:00
}
2021-08-16 23:16:36 +08:00
return binding ;
}
void * CSharpLanguage : : get_existing_instance_binding ( Object * p_object ) {
# ifdef DEBUG_ENABLED
CRASH_COND ( p_object - > has_instance_binding ( p_object ) ) ;
2021-07-09 03:16:02 +08:00
# endif
2023-11-16 04:06:13 +08:00
return get_instance_binding ( p_object ) ;
2021-08-16 23:16:36 +08:00
}
bool CSharpLanguage : : has_instance_binding ( Object * p_object ) {
return p_object - > has_instance_binding ( get_singleton ( ) ) ;
2018-02-22 22:34:08 +08:00
}
2021-09-13 02:21:15 +08:00
void CSharpLanguage : : tie_native_managed_to_unmanaged ( GCHandleIntPtr p_gchandle_intptr , Object * p_unmanaged , const StringName * p_native_name , bool p_ref_counted ) {
// This method should not fail
2018-02-22 22:34:08 +08:00
2021-09-13 02:21:15 +08:00
CRASH_COND ( ! p_unmanaged ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
// All mono objects created from the managed world (e.g.: 'new Player()')
// need to have a CSharpScript in order for their methods to be callable from the unmanaged side
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
RefCounted * rc = Object : : cast_to < RefCounted > ( p_unmanaged ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
CRASH_COND ( p_ref_counted ! = ( bool ) rc ) ;
MonoGCHandleData gchandle = MonoGCHandleData ( p_gchandle_intptr ,
p_ref_counted ? gdmono : : GCHandleType : : WEAK_HANDLE : gdmono : : GCHandleType : : STRONG_HANDLE ) ;
// If it's just a wrapper Godot class and not a custom inheriting class, then attach a
// script binding instead. One of the advantages of this is that if a script is attached
// later and it's not a C# script, then the managed object won't have to be disposed.
// Another reason for doing this is that this instance could outlive CSharpLanguage, which would
// be problematic when using a script. See: https://github.com/godotengine/godot/issues/25621
if ( p_ref_counted ) {
// Unsafe refcount increment. The managed instance also counts as a reference.
// This way if the unmanaged world has no references to our owner
// but the managed instance is alive, the refcount will be 1 instead of 0.
// See: godot_icall_RefCounted_Dtor(MonoObject *p_obj, Object *p_ptr)
// May not me referenced yet, so we must use init_ref() instead of reference()
if ( rc - > init_ref ( ) ) {
CSharpLanguage : : get_singleton ( ) - > post_unsafe_reference ( rc ) ;
}
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
// The object was just created, no script instance binding should have been attached
CRASH_COND ( CSharpLanguage : : has_instance_binding ( p_unmanaged ) ) ;
2017-10-03 05:24:00 +08:00
2023-11-16 04:06:13 +08:00
void * binding = CSharpLanguage : : get_singleton ( ) - > get_instance_binding ( p_unmanaged ) ;
2017-10-03 05:24:00 +08:00
2023-11-16 04:06:13 +08:00
CSharpScriptBinding & script_binding = ( ( RBMap < Object * , CSharpScriptBinding > : : Element * ) binding ) - > value ( ) ;
script_binding . inited = true ;
script_binding . type_name = * p_native_name ;
script_binding . gchandle = gchandle ;
script_binding . owner = p_unmanaged ;
2017-10-03 05:24:00 +08:00
}
2022-02-28 04:57:36 +08:00
void CSharpLanguage : : tie_user_managed_to_unmanaged ( GCHandleIntPtr p_gchandle_intptr , Object * p_unmanaged , Ref < CSharpScript > * p_script , bool p_ref_counted ) {
2021-09-13 02:21:15 +08:00
// This method should not fail
2019-02-03 13:35:22 +08:00
2022-02-28 04:57:36 +08:00
Ref < CSharpScript > script = * p_script ;
// We take care of destructing this reference here, so the managed code won't need to do another P/Invoke call
p_script - > ~ Ref ( ) ;
2021-09-13 02:21:15 +08:00
CRASH_COND ( ! p_unmanaged ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
// All mono objects created from the managed world (e.g.: 'new Player()')
// need to have a CSharpScript in order for their methods to be callable from the unmanaged side
2020-01-17 00:11:13 +08:00
2021-09-13 02:21:15 +08:00
RefCounted * rc = Object : : cast_to < RefCounted > ( p_unmanaged ) ;
2018-01-05 04:05:46 +08:00
2021-09-13 02:21:15 +08:00
CRASH_COND ( p_ref_counted ! = ( bool ) rc ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
MonoGCHandleData gchandle = MonoGCHandleData ( p_gchandle_intptr ,
p_ref_counted ? gdmono : : GCHandleType : : WEAK_HANDLE : gdmono : : GCHandleType : : STRONG_HANDLE ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
CRASH_COND ( script . is_null ( ) ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
CSharpInstance * csharp_instance = CSharpInstance : : create_for_managed_type ( p_unmanaged , script . ptr ( ) , gchandle ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
p_unmanaged - > set_script_and_instance ( script , csharp_instance ) ;
2022-07-28 23:41:47 +08:00
csharp_instance - > connect_event_signals ( ) ;
2021-09-13 02:21:15 +08:00
}
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
void CSharpLanguage : : tie_managed_to_unmanaged_with_pre_setup ( GCHandleIntPtr p_gchandle_intptr , Object * p_unmanaged ) {
// This method should not fail
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
CRASH_COND ( ! p_unmanaged ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
CSharpInstance * instance = CAST_CSHARP_INSTANCE ( p_unmanaged - > get_script_instance ( ) ) ;
2018-01-05 04:05:46 +08:00
2021-09-13 02:21:15 +08:00
if ( ! instance ) {
2021-12-29 06:25:16 +08:00
// Native bindings don't need post-setup
2021-09-13 02:21:15 +08:00
return ;
}
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
CRASH_COND ( ! instance - > gchandle . is_released ( ) ) ;
2018-01-31 01:53:00 +08:00
2021-09-13 02:21:15 +08:00
// Tie managed to unmanaged
instance - > gchandle = MonoGCHandleData ( p_gchandle_intptr , gdmono : : GCHandleType : : STRONG_HANDLE ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
if ( instance - > base_ref_counted ) {
instance - > _reference_owner_unsafe ( ) ; // Here, after assigning the gchandle (for the refcount_incremented callback)
2017-10-03 05:24:00 +08:00
}
2021-09-13 02:21:15 +08:00
{
MutexLock lock ( CSharpLanguage : : get_singleton ( ) - > get_script_instances_mutex ( ) ) ;
// instances is a set, so it's safe to insert multiple times (e.g.: from _internal_new_managed)
instance - > script - > instances . insert ( instance - > owner ) ;
}
2022-07-28 23:41:47 +08:00
instance - > connect_event_signals ( ) ;
2017-10-03 05:24:00 +08:00
}
2021-09-13 02:21:15 +08:00
CSharpInstance * CSharpInstance : : create_for_managed_type ( Object * p_owner , CSharpScript * p_script , const MonoGCHandleData & p_gchandle ) {
CSharpInstance * instance = memnew ( CSharpInstance ( Ref < CSharpScript > ( p_script ) ) ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
RefCounted * rc = Object : : cast_to < RefCounted > ( p_owner ) ;
2020-01-17 00:11:13 +08:00
2021-09-13 02:21:15 +08:00
instance - > base_ref_counted = rc ! = nullptr ;
instance - > owner = p_owner ;
instance - > gchandle = p_gchandle ;
2018-01-05 04:05:46 +08:00
2021-09-13 02:21:15 +08:00
if ( instance - > base_ref_counted ) {
instance - > _reference_owner_unsafe ( ) ;
}
2017-10-03 05:24:00 +08:00
2023-03-22 00:14:29 +08:00
{
MutexLock lock ( CSharpLanguage : : get_singleton ( ) - > get_script_instances_mutex ( ) ) ;
p_script - > instances . insert ( p_owner ) ;
}
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
return instance ;
}
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
Object * CSharpInstance : : get_owner ( ) {
return owner ;
}
2018-01-05 04:05:46 +08:00
2021-09-13 02:21:15 +08:00
bool CSharpInstance : : set ( const StringName & p_name , const Variant & p_value ) {
ERR_FAIL_COND_V ( ! script . is_valid ( ) , false ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:23:05 +08:00
return GDMonoCache : : managed_callbacks . CSharpInstanceBridge_Set (
gchandle . get_intptr ( ) , & p_name , & p_value ) ;
2021-09-13 02:21:15 +08:00
}
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
bool CSharpInstance : : get ( const StringName & p_name , Variant & r_ret ) const {
ERR_FAIL_COND_V ( ! script . is_valid ( ) , false ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
Variant ret_value ;
2018-01-31 01:53:00 +08:00
2021-09-13 02:23:05 +08:00
bool ret = GDMonoCache : : managed_callbacks . CSharpInstanceBridge_Get (
gchandle . get_intptr ( ) , & p_name , & ret_value ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:23:05 +08:00
if ( ret ) {
2021-09-13 02:21:15 +08:00
r_ret = ret_value ;
return true ;
2017-10-03 05:24:00 +08:00
}
return false ;
}
void CSharpInstance : : get_property_list ( List < PropertyInfo > * p_properties ) const {
2021-10-30 22:55:21 +08:00
List < PropertyInfo > props ;
2024-09-15 03:54:40 +08:00
ERR_FAIL_COND ( ! script . is_valid ( ) ) ;
# ifdef TOOLS_ENABLED
for ( const PropertyInfo & prop : script - > exported_members_cache ) {
props . push_back ( prop ) ;
}
# else
for ( const KeyValue < StringName , PropertyInfo > & E : script - > member_info ) {
props . push_front ( E . value ) ;
}
# endif
2019-03-28 19:01:43 +08:00
2024-09-15 03:54:40 +08:00
for ( PropertyInfo & prop : props ) {
validate_property ( prop ) ;
p_properties - > push_back ( prop ) ;
}
2019-03-28 19:01:43 +08:00
2024-09-15 03:54:40 +08:00
// Call _get_property_list
2019-03-28 19:01:43 +08:00
2021-09-13 02:21:15 +08:00
StringName method = SNAME ( " _get_property_list " ) ;
2019-03-28 19:01:43 +08:00
2021-09-13 02:21:15 +08:00
Variant ret ;
Callable : : CallError call_error ;
2021-09-13 02:23:05 +08:00
bool ok = GDMonoCache : : managed_callbacks . CSharpInstanceBridge_Call (
gchandle . get_intptr ( ) , & method , nullptr , 0 , & call_error , & ret ) ;
// CALL_ERROR_INVALID_METHOD would simply mean it was not overridden
if ( call_error . error ! = Callable : : CallError : : CALL_ERROR_INVALID_METHOD ) {
if ( call_error . error ! = Callable : : CallError : : CALL_OK ) {
ERR_PRINT ( " Error calling '_get_property_list': " + Variant : : get_call_error_text ( method , nullptr , 0 , call_error ) ) ;
} else if ( ! ok ) {
ERR_PRINT ( " Unexpected error calling '_get_property_list' " ) ;
} else {
Array array = ret ;
for ( int i = 0 , size = array . size ( ) ; i < size ; i + + ) {
p_properties - > push_back ( PropertyInfo : : from_dict ( array . get ( i ) ) ) ;
}
}
2019-03-28 19:01:43 +08:00
}
2021-10-30 22:55:21 +08:00
2024-09-15 03:54:40 +08:00
CSharpScript * top = script . ptr ( ) - > base_script . ptr ( ) ;
while ( top ! = nullptr ) {
props . clear ( ) ;
# ifdef TOOLS_ENABLED
for ( const PropertyInfo & prop : top - > exported_members_cache ) {
props . push_back ( prop ) ;
}
# else
for ( const KeyValue < StringName , PropertyInfo > & E : top - > member_info ) {
props . push_front ( E . value ) ;
}
# endif
for ( PropertyInfo & prop : props ) {
validate_property ( prop ) ;
p_properties - > push_back ( prop ) ;
}
top = top - > base_script . ptr ( ) ;
2021-10-30 22:55:21 +08:00
}
2017-10-03 05:24:00 +08:00
}
Variant : : Type CSharpInstance : : get_property_type ( const StringName & p_name , bool * r_is_valid ) const {
if ( script - > member_info . has ( p_name ) ) {
2020-07-06 01:19:36 +08:00
if ( r_is_valid ) {
2017-10-03 05:24:00 +08:00
* r_is_valid = true ;
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
return script - > member_info [ p_name ] . type ;
}
2020-07-06 01:19:36 +08:00
if ( r_is_valid ) {
2017-10-03 05:24:00 +08:00
* r_is_valid = false ;
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
return Variant : : NIL ;
}
2022-08-13 02:43:14 +08:00
bool CSharpInstance : : property_can_revert ( const StringName & p_name ) const {
ERR_FAIL_COND_V ( ! script . is_valid ( ) , false ) ;
2021-09-13 02:21:15 +08:00
Variant name_arg = p_name ;
const Variant * args [ 1 ] = { & name_arg } ;
2022-08-13 02:43:14 +08:00
2021-09-13 02:21:15 +08:00
Variant ret ;
2021-09-13 02:23:05 +08:00
Callable : : CallError call_error ;
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_Call (
2023-08-28 19:55:15 +08:00
gchandle . get_intptr ( ) , & SNAME ( " _property_can_revert " ) , args , 1 , & call_error , & ret ) ;
2022-08-13 02:43:14 +08:00
2021-09-13 02:21:15 +08:00
if ( call_error . error ! = Callable : : CallError : : CALL_OK ) {
return false ;
2022-08-13 02:43:14 +08:00
}
2021-09-13 02:21:15 +08:00
return ( bool ) ret ;
2022-08-13 02:43:14 +08:00
}
2023-04-07 20:01:57 +08:00
void CSharpInstance : : validate_property ( PropertyInfo & p_property ) const {
ERR_FAIL_COND ( ! script . is_valid ( ) ) ;
Variant property_arg = ( Dictionary ) p_property ;
const Variant * args [ 1 ] = { & property_arg } ;
Variant ret ;
Callable : : CallError call_error ;
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_Call (
gchandle . get_intptr ( ) , & SNAME ( " _validate_property " ) , args , 1 , & call_error , & ret ) ;
if ( call_error . error ! = Callable : : CallError : : CALL_OK ) {
return ;
}
p_property = PropertyInfo : : from_dict ( property_arg ) ;
}
2022-08-13 02:43:14 +08:00
bool CSharpInstance : : property_get_revert ( const StringName & p_name , Variant & r_ret ) const {
ERR_FAIL_COND_V ( ! script . is_valid ( ) , false ) ;
2021-09-13 02:21:15 +08:00
Variant name_arg = p_name ;
const Variant * args [ 1 ] = { & name_arg } ;
2022-08-13 02:43:14 +08:00
2021-09-13 02:21:15 +08:00
Variant ret ;
2021-09-13 02:23:05 +08:00
Callable : : CallError call_error ;
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_Call (
2023-08-28 19:55:15 +08:00
gchandle . get_intptr ( ) , & SNAME ( " _property_get_revert " ) , args , 1 , & call_error , & ret ) ;
2022-08-13 02:43:14 +08:00
2021-09-13 02:21:15 +08:00
if ( call_error . error ! = Callable : : CallError : : CALL_OK ) {
return false ;
2022-08-13 02:43:14 +08:00
}
2021-09-13 02:21:15 +08:00
r_ret = ret ;
return true ;
2022-08-13 02:43:14 +08:00
}
2021-09-13 01:53:34 +08:00
void CSharpInstance : : get_method_list ( List < MethodInfo > * p_list ) const {
2022-07-28 23:41:48 +08:00
if ( ! script - > is_valid ( ) | | ! script - > valid ) {
2021-09-13 01:53:34 +08:00
return ;
2021-10-23 01:25:01 +08:00
}
2021-09-13 01:53:34 +08:00
2023-05-20 20:39:59 +08:00
script - > get_script_method_list ( p_list ) ;
2021-09-13 01:53:34 +08:00
}
2017-10-03 05:24:00 +08:00
bool CSharpInstance : : has_method ( const StringName & p_method ) const {
2020-07-06 01:19:36 +08:00
if ( ! script . is_valid ( ) ) {
2017-10-03 05:24:00 +08:00
return false ;
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
2021-09-13 02:23:05 +08:00
if ( ! GDMonoCache : : godot_api_cache_updated ) {
2021-09-13 02:21:15 +08:00
return false ;
}
2017-10-03 05:24:00 +08:00
2021-12-29 06:25:16 +08:00
return GDMonoCache : : managed_callbacks . CSharpInstanceBridge_HasMethodUnknownParams (
gchandle . get_intptr ( ) , & p_method ) ;
2017-10-03 05:24:00 +08:00
}
2024-01-28 22:16:09 +08:00
int CSharpInstance : : get_method_argument_count ( const StringName & p_method , bool * r_is_valid ) const {
if ( ! script - > is_valid ( ) | | ! script - > valid ) {
if ( r_is_valid ) {
* r_is_valid = false ;
}
return 0 ;
}
const CSharpScript * top = script . ptr ( ) ;
while ( top ! = nullptr ) {
for ( const CSharpScript : : CSharpMethodInfo & E : top - > methods ) {
if ( E . name = = p_method ) {
if ( r_is_valid ) {
* r_is_valid = true ;
}
return E . method_info . arguments . size ( ) ;
}
}
top = top - > base_script . ptr ( ) ;
}
if ( r_is_valid ) {
* r_is_valid = false ;
}
return 0 ;
}
2022-03-09 21:58:40 +08:00
Variant CSharpInstance : : callp ( const StringName & p_method , const Variant * * p_args , int p_argcount , Callable : : CallError & r_error ) {
2020-02-08 15:35:52 +08:00
ERR_FAIL_COND_V ( ! script . is_valid ( ) , Variant ( ) ) ;
2020-01-17 00:11:13 +08:00
2021-09-13 02:21:15 +08:00
Variant ret ;
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_Call (
gchandle . get_intptr ( ) , & p_method , p_args , p_argcount , & r_error , & ret ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
return ret ;
2017-10-03 05:24:00 +08:00
}
2018-09-12 08:41:54 +08:00
bool CSharpInstance : : _reference_owner_unsafe ( ) {
2017-10-03 05:24:00 +08:00
# ifdef DEBUG_ENABLED
2021-06-05 00:03:15 +08:00
CRASH_COND ( ! base_ref_counted ) ;
2020-04-02 07:20:12 +08:00
CRASH_COND ( owner = = nullptr ) ;
2018-09-12 08:41:54 +08:00
CRASH_COND ( unsafe_referenced ) ; // already referenced
2017-10-03 05:24:00 +08:00
# endif
// Unsafe refcount increment. The managed instance also counts as a reference.
// This way if the unmanaged world has no references to our owner
// but the managed instance is alive, the refcount will be 1 instead of 0.
// See: _unreference_owner_unsafe()
2024-06-15 02:10:03 +08:00
// May not be referenced yet, so we must use init_ref() instead of reference()
2021-06-05 00:03:15 +08:00
if ( static_cast < RefCounted * > ( owner ) - > init_ref ( ) ) {
2020-01-14 04:00:07 +08:00
CSharpLanguage : : get_singleton ( ) - > post_unsafe_reference ( owner ) ;
unsafe_referenced = true ;
}
return unsafe_referenced ;
2017-10-03 05:24:00 +08:00
}
2018-09-12 08:41:54 +08:00
bool CSharpInstance : : _unreference_owner_unsafe ( ) {
2017-10-03 05:24:00 +08:00
# ifdef DEBUG_ENABLED
2021-06-05 00:03:15 +08:00
CRASH_COND ( ! base_ref_counted ) ;
2020-04-02 07:20:12 +08:00
CRASH_COND ( owner = = nullptr ) ;
2017-10-03 05:24:00 +08:00
# endif
2020-07-06 01:19:36 +08:00
if ( ! unsafe_referenced ) {
2018-09-12 08:41:54 +08:00
return false ; // Already unreferenced
2020-07-06 01:19:36 +08:00
}
2018-09-12 08:41:54 +08:00
2018-10-25 23:21:42 +08:00
unsafe_referenced = false ;
2017-10-03 05:24:00 +08:00
// Called from CSharpInstance::mono_object_disposed() or ~CSharpInstance()
// Unsafe refcount decrement. The managed instance also counts as a reference.
// See: _reference_owner_unsafe()
2019-02-03 13:35:22 +08:00
// Destroying the owner here means self destructing, so we defer the owner destruction to the caller.
2020-01-14 04:00:07 +08:00
CSharpLanguage : : get_singleton ( ) - > pre_unsafe_unreference ( owner ) ;
2021-06-05 00:03:15 +08:00
return static_cast < RefCounted * > ( owner ) - > unreference ( ) ;
2017-10-03 05:24:00 +08:00
}
2021-09-13 02:21:15 +08:00
bool CSharpInstance : : _internal_new_managed ( ) {
2018-09-12 08:41:54 +08:00
CSharpLanguage : : get_singleton ( ) - > release_script_gchandle ( gchandle ) ;
2021-09-13 02:21:15 +08:00
ERR_FAIL_NULL_V ( owner , false ) ;
ERR_FAIL_COND_V ( script . is_null ( ) , false ) ;
2024-02-05 09:49:57 +08:00
ERR_FAIL_COND_V ( ! script - > can_instantiate ( ) , false ) ;
2021-09-13 02:21:15 +08:00
2021-09-13 02:23:05 +08:00
bool ok = GDMonoCache : : managed_callbacks . ScriptManagerBridge_CreateManagedForGodotObjectScriptInstance (
script . ptr ( ) , owner , nullptr , 0 ) ;
2018-09-12 08:41:54 +08:00
2021-09-13 02:23:05 +08:00
if ( ! ok ) {
2019-02-03 13:35:22 +08:00
// Important to clear this before destroying the script instance here
2018-09-12 08:41:54 +08:00
script = Ref < CSharpScript > ( ) ;
2020-04-02 07:20:12 +08:00
owner = nullptr ;
2019-07-03 15:44:53 +08:00
2021-09-13 02:21:15 +08:00
return false ;
2018-09-12 08:41:54 +08:00
}
2021-09-13 02:21:15 +08:00
CRASH_COND ( gchandle . is_released ( ) ) ;
2018-09-12 08:41:54 +08:00
2021-09-13 02:21:15 +08:00
return true ;
2018-09-12 08:41:54 +08:00
}
2022-02-28 04:57:30 +08:00
void CSharpInstance : : mono_object_disposed ( GCHandleIntPtr p_gchandle_to_free ) {
2020-10-26 13:59:08 +08:00
// Must make sure event signals are not left dangling
2020-03-15 02:20:17 +08:00
disconnect_event_signals ( ) ;
2018-09-12 08:41:54 +08:00
# ifdef DEBUG_ENABLED
2021-06-05 00:03:15 +08:00
CRASH_COND ( base_ref_counted ) ;
2019-12-12 00:08:40 +08:00
CRASH_COND ( gchandle . is_released ( ) ) ;
2018-09-12 08:41:54 +08:00
# endif
2022-02-28 04:57:30 +08:00
CSharpLanguage : : get_singleton ( ) - > release_script_gchandle_thread_safe ( p_gchandle_to_free , gchandle ) ;
2018-09-12 08:41:54 +08:00
}
2022-02-28 04:57:30 +08:00
void CSharpInstance : : mono_object_disposed_baseref ( GCHandleIntPtr p_gchandle_to_free , bool p_is_finalizer , bool & r_delete_owner , bool & r_remove_script_instance ) {
2018-09-12 08:41:54 +08:00
# ifdef DEBUG_ENABLED
2021-06-05 00:03:15 +08:00
CRASH_COND ( ! base_ref_counted ) ;
2019-12-12 00:08:40 +08:00
CRASH_COND ( gchandle . is_released ( ) ) ;
2018-09-12 08:41:54 +08:00
# endif
2019-02-03 13:35:22 +08:00
2020-10-26 13:59:08 +08:00
// Must make sure event signals are not left dangling
disconnect_event_signals ( ) ;
2019-02-03 13:35:22 +08:00
r_remove_script_instance = false ;
2018-09-12 08:41:54 +08:00
if ( _unreference_owner_unsafe ( ) ) {
2019-02-03 13:35:22 +08:00
// Safe to self destruct here with memdelete(owner), but it's deferred to the caller to prevent future mistakes.
r_delete_owner = true ;
2018-09-12 08:41:54 +08:00
} else {
2019-02-03 13:35:22 +08:00
r_delete_owner = false ;
2022-02-28 04:57:30 +08:00
CSharpLanguage : : get_singleton ( ) - > release_script_gchandle_thread_safe ( p_gchandle_to_free , gchandle ) ;
2019-02-03 13:35:22 +08:00
if ( ! p_is_finalizer ) {
// If the native instance is still alive and Dispose() was called
// (instead of the finalizer), then we remove the script instance.
r_remove_script_instance = true ;
2022-05-28 10:56:46 +08:00
// TODO: Last usage of 'is_finalizing_scripts_domain'. It should be replaced with a check to determine if the load context is being unloaded.
2019-02-03 13:35:22 +08:00
} else if ( ! GDMono : : get_singleton ( ) - > is_finalizing_scripts_domain ( ) ) {
// If the native instance is still alive and this is called from the finalizer,
// then it was referenced from another thread before the finalizer could
// unreference and delete it, so we want to keep it.
// GC.ReRegisterForFinalize(this) is not safe because the objects referenced by 'this'
// could have already been collected. Instead we will create a new managed instance here.
2021-09-13 02:21:15 +08:00
if ( ! _internal_new_managed ( ) ) {
2019-02-03 13:35:22 +08:00
r_remove_script_instance = true ;
}
2018-09-12 08:41:54 +08:00
}
}
2017-10-03 05:24:00 +08:00
}
2022-07-28 23:41:47 +08:00
void CSharpInstance : : connect_event_signals ( ) {
2024-05-09 19:46:25 +08:00
const CSharpScript * top = script . ptr ( ) ;
while ( top ! = nullptr & & top - > valid ) {
for ( const CSharpScript : : EventSignalInfo & signal : top - > event_signals ) {
String signal_name = signal . name ;
2020-03-15 02:20:17 +08:00
2024-05-09 19:46:25 +08:00
// TODO: Use pooling for ManagedCallable instances.
EventSignalCallable * event_signal_callable = memnew ( EventSignalCallable ( owner , signal_name ) ) ;
2022-07-28 23:41:47 +08:00
2024-05-09 19:46:25 +08:00
Callable callable ( event_signal_callable ) ;
connected_event_signals . push_back ( callable ) ;
owner - > connect ( signal_name , callable ) ;
}
top = top - > base_script . ptr ( ) ;
2022-07-28 23:41:47 +08:00
}
2020-03-15 02:20:17 +08:00
}
void CSharpInstance : : disconnect_event_signals ( ) {
2021-07-16 11:45:57 +08:00
for ( const Callable & callable : connected_event_signals ) {
2021-04-25 22:40:58 +08:00
const EventSignalCallable * event_signal_callable = static_cast < const EventSignalCallable * > ( callable . get_custom ( ) ) ;
2021-03-15 14:08:06 +08:00
owner - > disconnect ( event_signal_callable - > get_signal ( ) , callable ) ;
2020-03-15 02:20:17 +08:00
}
2021-03-15 14:08:06 +08:00
connected_event_signals . clear ( ) ;
2020-03-15 02:20:17 +08:00
}
2017-10-03 05:24:00 +08:00
void CSharpInstance : : refcount_incremented ( ) {
2018-02-22 22:34:08 +08:00
# ifdef DEBUG_ENABLED
2021-06-05 00:03:15 +08:00
CRASH_COND ( ! base_ref_counted ) ;
2020-04-02 07:20:12 +08:00
CRASH_COND ( owner = = nullptr ) ;
2018-02-22 22:34:08 +08:00
# endif
2017-10-03 05:24:00 +08:00
2021-06-05 00:03:15 +08:00
RefCounted * rc_owner = Object : : cast_to < RefCounted > ( owner ) ;
2017-10-03 05:24:00 +08:00
2022-09-19 22:45:45 +08:00
if ( rc_owner - > get_reference_count ( ) > 1 & & gchandle . is_weak ( ) ) { // The managed side also holds a reference, hence 1 instead of 0
2017-10-03 05:24:00 +08:00
// The reference count was increased after the managed side was the only one referencing our owner.
// This means the owner is being referenced again by the unmanaged side,
// so the owner must hold the managed side alive again to avoid it from being GCed.
// Release the current weak handle and replace it with a strong handle.
2021-09-13 02:21:15 +08:00
GCHandleIntPtr old_gchandle = gchandle . get_intptr ( ) ;
2022-02-28 04:57:30 +08:00
gchandle . handle = { nullptr } ; // No longer owns the handle (released by swap function)
2021-09-13 02:21:15 +08:00
2022-02-28 04:57:30 +08:00
GCHandleIntPtr new_gchandle = { nullptr } ;
2021-09-13 02:21:15 +08:00
bool create_weak = false ;
2021-09-13 02:23:05 +08:00
bool target_alive = GDMonoCache : : managed_callbacks . ScriptManagerBridge_SwapGCHandleForType (
old_gchandle , & new_gchandle , create_weak ) ;
2021-09-13 02:21:15 +08:00
if ( ! target_alive ) {
return ; // Called after the managed side was collected, so nothing to do here
}
gchandle = MonoGCHandleData ( new_gchandle , gdmono : : GCHandleType : : STRONG_HANDLE ) ;
2017-10-03 05:24:00 +08:00
}
}
bool CSharpInstance : : refcount_decremented ( ) {
2018-02-22 22:34:08 +08:00
# ifdef DEBUG_ENABLED
2021-06-05 00:03:15 +08:00
CRASH_COND ( ! base_ref_counted ) ;
2020-04-02 07:20:12 +08:00
CRASH_COND ( owner = = nullptr ) ;
2018-02-22 22:34:08 +08:00
# endif
2017-10-03 05:24:00 +08:00
2021-06-05 00:03:15 +08:00
RefCounted * rc_owner = Object : : cast_to < RefCounted > ( owner ) ;
2017-10-03 05:24:00 +08:00
2022-09-19 22:45:45 +08:00
int refcount = rc_owner - > get_reference_count ( ) ;
2017-10-03 05:24:00 +08:00
2019-12-12 00:08:40 +08:00
if ( refcount = = 1 & & ! gchandle . is_weak ( ) ) { // The managed side also holds a reference, hence 1 instead of 0
2017-10-03 05:24:00 +08:00
// If owner owner is no longer referenced by the unmanaged side,
// the managed instance takes responsibility of deleting the owner when GCed.
// Release the current strong handle and replace it with a weak handle.
2021-09-13 02:21:15 +08:00
GCHandleIntPtr old_gchandle = gchandle . get_intptr ( ) ;
2022-02-28 04:57:30 +08:00
gchandle . handle = { nullptr } ; // No longer owns the handle (released by swap function)
2021-09-13 02:21:15 +08:00
2022-02-28 04:57:30 +08:00
GCHandleIntPtr new_gchandle = { nullptr } ;
2021-09-13 02:21:15 +08:00
bool create_weak = true ;
2021-09-13 02:23:05 +08:00
bool target_alive = GDMonoCache : : managed_callbacks . ScriptManagerBridge_SwapGCHandleForType (
old_gchandle , & new_gchandle , create_weak ) ;
2021-09-13 02:21:15 +08:00
if ( ! target_alive ) {
return refcount = = 0 ; // Called after the managed side was collected, so nothing to do here
}
gchandle = MonoGCHandleData ( new_gchandle , gdmono : : GCHandleType : : WEAK_HANDLE ) ;
2017-10-03 05:24:00 +08:00
return false ;
}
ref_dying = ( refcount = = 0 ) ;
return ref_dying ;
}
2022-07-13 05:12:42 +08:00
const Variant CSharpInstance : : get_rpc_config ( ) const {
return script - > get_rpc_config ( ) ;
2020-02-12 18:51:50 +08:00
}
2018-01-05 04:05:46 +08:00
2023-06-24 09:07:22 +08:00
void CSharpInstance : : notification ( int p_notification , bool p_reversed ) {
2018-01-01 05:37:57 +08:00
if ( p_notification = = Object : : NOTIFICATION_PREDELETE ) {
2023-10-20 19:43:42 +08:00
if ( base_ref_counted ) {
// At this point, Dispose() was already called (manually or from the finalizer).
// The RefCounted wouldn't have reached 0 otherwise, since the managed side
// references it and Dispose() needs to be called to release it.
// However, this means C# RefCounted scripts can't receive NOTIFICATION_PREDELETE, but
// this is likely the case with GDScript as well: https://github.com/godotengine/godot/issues/6784
return ;
}
} else if ( p_notification = = Object : : NOTIFICATION_PREDELETE_CLEANUP ) {
// When NOTIFICATION_PREDELETE_CLEANUP is sent, we also take the chance to call Dispose().
// It's safe to call Dispose() multiple times and NOTIFICATION_PREDELETE_CLEANUP is guaranteed
2018-09-12 08:41:54 +08:00
// to be sent at least once, which happens right before the call to the destructor.
2018-12-01 03:43:06 +08:00
predelete_notified = true ;
2021-06-05 00:03:15 +08:00
if ( base_ref_counted ) {
2023-10-20 19:43:42 +08:00
// At this point, Dispose() was already called (manually or from the finalizer).
// The RefCounted wouldn't have reached 0 otherwise, since the managed side
// references it and Dispose() needs to be called to release it.
2018-09-12 08:41:54 +08:00
return ;
2018-01-01 05:37:57 +08:00
}
2018-09-12 08:41:54 +08:00
2023-10-20 19:43:42 +08:00
// NOTIFICATION_PREDELETE_CLEANUP is not sent to scripts.
// After calling Dispose() the C# instance can no longer be used,
// so it should be the last thing we do.
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_CallDispose (
gchandle . get_intptr ( ) , /* okIfNull */ false ) ;
2018-09-12 08:41:54 +08:00
2018-01-01 05:37:57 +08:00
return ;
}
2023-06-24 09:07:22 +08:00
_call_notification ( p_notification , p_reversed ) ;
2018-01-01 05:37:57 +08:00
}
2023-06-24 09:07:22 +08:00
void CSharpInstance : : _call_notification ( int p_notification , bool p_reversed ) {
2021-09-13 02:21:15 +08:00
Variant arg = p_notification ;
const Variant * args [ 1 ] = { & arg } ;
2018-09-12 08:41:54 +08:00
2021-09-13 02:21:15 +08:00
Variant ret ;
2023-08-28 19:55:15 +08:00
Callable : : CallError call_error ;
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_Call (
2023-08-28 19:55:15 +08:00
gchandle . get_intptr ( ) , & SNAME ( " _notification " ) , args , 1 , & call_error , & ret ) ;
2017-10-03 05:24:00 +08:00
}
2019-05-24 06:40:16 +08:00
String CSharpInstance : : to_string ( bool * r_valid ) {
2021-09-13 02:21:15 +08:00
String res ;
bool valid ;
2019-05-24 06:40:16 +08:00
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_CallToString (
gchandle . get_intptr ( ) , & res , & valid ) ;
2019-05-24 06:40:16 +08:00
2021-09-13 02:21:15 +08:00
if ( r_valid ) {
* r_valid = valid ;
2019-05-24 06:40:16 +08:00
}
2021-09-13 02:21:15 +08:00
return res ;
2019-05-24 06:40:16 +08:00
}
2017-10-03 05:24:00 +08:00
Ref < Script > CSharpInstance : : get_script ( ) const {
return script ;
}
ScriptLanguage * CSharpInstance : : get_language ( ) {
return CSharpLanguage : : get_singleton ( ) ;
}
2020-03-15 02:20:17 +08:00
CSharpInstance : : CSharpInstance ( const Ref < CSharpScript > & p_script ) :
script ( p_script ) {
2017-10-03 05:24:00 +08:00
}
CSharpInstance : : ~ CSharpInstance ( ) {
2019-02-03 13:35:22 +08:00
destructing_script_instance = true ;
2020-10-26 13:59:08 +08:00
// Must make sure event signals are not left dangling
disconnect_event_signals ( ) ;
2019-12-12 00:08:40 +08:00
if ( ! gchandle . is_released ( ) ) {
2018-12-01 03:43:06 +08:00
if ( ! predelete_notified & & ! ref_dying ) {
// This destructor is not called from the owners destructor.
// This could be being called from the owner's set_script_instance method,
// meaning this script is being replaced with another one. If this is the case,
2020-04-02 07:20:12 +08:00
// we must call Dispose here, because Dispose calls owner->set_script_instance(nullptr)
2018-12-01 03:43:06 +08:00
// and that would mess up with the new script instance if called later.
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_CallDispose (
gchandle . get_intptr ( ) , /* okIfNull */ true ) ;
2018-12-01 03:43:06 +08:00
}
2019-12-12 00:08:40 +08:00
gchandle . release ( ) ; // Make sure the gchandle is released
2017-10-03 05:24:00 +08:00
}
2019-02-03 13:35:22 +08:00
// If not being called from the owner's destructor, and we still hold a reference to the owner
2021-06-05 00:03:15 +08:00
if ( base_ref_counted & & ! ref_dying & & owner & & unsafe_referenced ) {
2019-02-03 13:35:22 +08:00
// The owner's script or script instance is being replaced (or removed)
// Transfer ownership to an "instance binding"
2021-06-05 00:03:15 +08:00
RefCounted * rc_owner = static_cast < RefCounted * > ( owner ) ;
2020-01-16 06:46:42 +08:00
// We will unreference the owner before referencing it again, so we need to keep it alive
2021-06-05 00:03:15 +08:00
Ref < RefCounted > scope_keep_owner_alive ( rc_owner ) ;
2020-01-16 06:46:42 +08:00
( void ) scope_keep_owner_alive ;
// Unreference the owner here, before the new "instance binding" references it.
// Otherwise, the unsafe reference debug checks will incorrectly detect a bug.
bool die = _unreference_owner_unsafe ( ) ;
2020-07-14 02:13:38 +08:00
CRASH_COND ( die ) ; // `owner_keep_alive` holds a reference, so it can't die
2021-07-09 03:16:02 +08:00
2023-11-16 04:06:13 +08:00
void * data = CSharpLanguage : : get_instance_binding_with_setup ( owner ) ;
2020-04-02 07:20:12 +08:00
CRASH_COND ( data = = nullptr ) ;
2022-05-13 21:04:37 +08:00
CSharpScriptBinding & script_binding = ( ( RBMap < Object * , CSharpScriptBinding > : : Element * ) data ) - > get ( ) ;
2021-08-16 23:16:36 +08:00
CRASH_COND ( ! script_binding . inited ) ;
2019-02-03 13:35:22 +08:00
2020-01-16 06:46:42 +08:00
# ifdef DEBUG_ENABLED
// The "instance binding" holds a reference so the refcount should be at least 2 before `scope_keep_owner_alive` goes out of scope
2022-09-19 22:45:45 +08:00
CRASH_COND ( rc_owner - > get_reference_count ( ) < = 1 ) ;
2020-01-16 06:46:42 +08:00
# endif
2017-10-03 05:24:00 +08:00
}
if ( script . is_valid ( ) & & owner ) {
2020-02-26 18:28:13 +08:00
MutexLock lock ( CSharpLanguage : : get_singleton ( ) - > script_instances_mutex ) ;
2017-10-03 05:24:00 +08:00
# ifdef DEBUG_ENABLED
// CSharpInstance must not be created unless it's going to be added to the list for sure
2022-05-19 23:00:06 +08:00
HashSet < Object * > : : Iterator match = script - > instances . find ( owner ) ;
2017-10-03 05:24:00 +08:00
CRASH_COND ( ! match ) ;
2022-05-19 23:00:06 +08:00
script - > instances . remove ( match ) ;
2017-10-03 05:24:00 +08:00
# else
script - > instances . erase ( owner ) ;
# endif
}
}
# ifdef TOOLS_ENABLED
void CSharpScript : : _placeholder_erased ( PlaceHolderScriptInstance * p_placeholder ) {
placeholders . erase ( p_placeholder ) ;
}
# endif
# ifdef TOOLS_ENABLED
2022-05-13 21:04:37 +08:00
void CSharpScript : : _update_exports_values ( HashMap < StringName , Variant > & values , List < PropertyInfo > & propnames ) {
2021-07-27 03:31:17 +08:00
for ( const KeyValue < StringName , Variant > & E : exported_members_defval_cache ) {
values [ E . key ] = E . value ;
2017-10-03 05:24:00 +08:00
}
2021-07-27 03:31:17 +08:00
for ( const PropertyInfo & prop_info : exported_members_cache ) {
propnames . push_back ( prop_info ) ;
2017-10-03 05:24:00 +08:00
}
2022-07-31 16:07:48 +08:00
2022-05-28 10:56:46 +08:00
if ( base_script . is_valid ( ) ) {
base_script - > _update_exports_values ( values , propnames ) ;
2022-07-31 16:07:48 +08:00
}
2017-10-03 05:24:00 +08:00
}
2019-07-08 21:22:51 +08:00
# endif
2019-07-03 15:44:53 +08:00
2022-09-09 02:13:49 +08:00
void GD_CLR_STDCALL CSharpScript : : _add_property_info_list_callback ( CSharpScript * p_script , const String * p_current_class_name , void * p_props , int32_t p_count ) {
GDMonoCache : : godotsharp_property_info * props = ( GDMonoCache : : godotsharp_property_info * ) p_props ;
# ifdef TOOLS_ENABLED
p_script - > exported_members_cache . push_back ( PropertyInfo (
2024-02-05 09:49:57 +08:00
Variant : : NIL , p_script - > type_info . class_name , PROPERTY_HINT_NONE ,
2022-09-09 02:13:49 +08:00
p_script - > get_path ( ) , PROPERTY_USAGE_CATEGORY ) ) ;
# endif
for ( int i = 0 ; i < p_count ; i + + ) {
const GDMonoCache : : godotsharp_property_info & prop = props [ i ] ;
StringName name = * reinterpret_cast < const StringName * > ( & prop . name ) ;
String hint_string = * reinterpret_cast < const String * > ( & prop . hint_string ) ;
PropertyInfo pinfo ( prop . type , name , prop . hint , hint_string , prop . usage ) ;
p_script - > member_info [ name ] = pinfo ;
if ( prop . exported ) {
# ifdef TOOLS_ENABLED
p_script - > exported_members_cache . push_back ( pinfo ) ;
# endif
# if defined(TOOLS_ENABLED) || defined(DEBUG_ENABLED)
p_script - > exported_members_names . insert ( name ) ;
# endif
}
}
}
# ifdef TOOLS_ENABLED
void GD_CLR_STDCALL CSharpScript : : _add_property_default_values_callback ( CSharpScript * p_script , void * p_def_vals , int32_t p_count ) {
GDMonoCache : : godotsharp_property_def_val_pair * def_vals = ( GDMonoCache : : godotsharp_property_def_val_pair * ) p_def_vals ;
for ( int i = 0 ; i < p_count ; i + + ) {
const GDMonoCache : : godotsharp_property_def_val_pair & def_val_pair = def_vals [ i ] ;
StringName name = * reinterpret_cast < const StringName * > ( & def_val_pair . name ) ;
Variant value = * reinterpret_cast < const Variant * > ( & def_val_pair . value ) ;
p_script - > exported_members_defval_cache [ name ] = value ;
}
}
# endif
2021-06-13 19:32:44 +08:00
bool CSharpScript : : _update_exports ( PlaceHolderScriptInstance * p_instance_to_update ) {
2017-10-03 05:24:00 +08:00
# ifdef TOOLS_ENABLED
2020-05-11 02:20:11 +08:00
bool is_editor = Engine : : get_singleton ( ) - > is_editor_hint ( ) ;
2020-07-06 01:19:36 +08:00
if ( is_editor ) {
2020-05-11 02:20:11 +08:00
placeholder_fallback_enabled = true ; // until proven otherwise
2020-07-06 01:19:36 +08:00
}
2020-05-11 02:20:11 +08:00
# endif
2020-07-06 01:19:36 +08:00
if ( ! valid ) {
2017-10-03 05:24:00 +08:00
return false ;
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
bool changed = false ;
2020-05-11 02:20:11 +08:00
# ifdef TOOLS_ENABLED
if ( exports_invalidated )
# endif
{
2022-02-28 04:57:52 +08:00
# ifdef TOOLS_ENABLED
2022-02-28 04:57:30 +08:00
exports_invalidated = false ;
2022-02-28 04:57:52 +08:00
# endif
2020-01-17 00:11:13 +08:00
2017-10-03 05:24:00 +08:00
changed = true ;
member_info . clear ( ) ;
2020-05-11 02:20:11 +08:00
# ifdef TOOLS_ENABLED
2022-02-28 04:57:30 +08:00
exported_members_cache . clear ( ) ;
exported_members_defval_cache . clear ( ) ;
2020-05-11 02:20:11 +08:00
# endif
2017-10-03 05:24:00 +08:00
2022-02-28 04:57:30 +08:00
if ( GDMonoCache : : godot_api_cache_updated ) {
2022-09-09 02:13:49 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_GetPropertyInfoList ( this , & _add_property_info_list_callback ) ;
2020-05-22 06:58:34 +08:00
2020-05-11 02:20:11 +08:00
# ifdef TOOLS_ENABLED
2022-09-09 02:13:49 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_GetPropertyDefaultValues ( this , & _add_property_default_values_callback ) ;
2022-02-28 04:57:52 +08:00
# endif
2020-01-14 03:58:46 +08:00
}
2017-10-03 05:24:00 +08:00
}
2020-05-11 02:20:11 +08:00
# ifdef TOOLS_ENABLED
if ( is_editor ) {
placeholder_fallback_enabled = false ;
2019-01-10 07:26:00 +08:00
2021-06-13 19:32:44 +08:00
if ( ( changed | | p_instance_to_update ) & & placeholders . size ( ) ) {
2020-05-11 02:20:11 +08:00
// Update placeholders if any
2022-05-13 21:04:37 +08:00
HashMap < StringName , Variant > values ;
2020-05-11 02:20:11 +08:00
List < PropertyInfo > propnames ;
_update_exports_values ( values , propnames ) ;
2017-10-03 05:24:00 +08:00
2021-06-13 19:32:44 +08:00
if ( changed ) {
2023-03-24 19:38:00 +08:00
for ( PlaceHolderScriptInstance * instance : placeholders ) {
instance - > update ( propnames , values ) ;
2021-06-13 19:32:44 +08:00
}
} else {
p_instance_to_update - > update ( propnames , values ) ;
2020-05-11 02:20:11 +08:00
}
2023-12-23 06:27:13 +08:00
} else if ( placeholders . size ( ) ) {
uint64_t script_modified_time = FileAccess : : get_modified_time ( get_path ( ) ) ;
uint64_t last_valid_build_time = GDMono : : get_singleton ( ) - > get_project_assembly_modified_time ( ) ;
if ( script_modified_time > last_valid_build_time ) {
for ( PlaceHolderScriptInstance * instance : placeholders ) {
Object * owner = instance - > get_owner ( ) ;
if ( owner - > get_script_instance ( ) = = instance ) {
owner - > notify_property_list_changed ( ) ;
}
}
}
2017-10-03 05:24:00 +08:00
}
}
2020-05-11 02:20:11 +08:00
# endif
2017-10-03 05:24:00 +08:00
return changed ;
}
2017-10-31 05:17:20 +08:00
bool CSharpScript : : _get ( const StringName & p_name , Variant & r_ret ) const {
2023-08-28 19:55:15 +08:00
if ( p_name = = SNAME ( " script/source " ) ) {
2017-10-31 05:17:20 +08:00
r_ret = get_source_code ( ) ;
return true ;
}
return false ;
}
bool CSharpScript : : _set ( const StringName & p_name , const Variant & p_value ) {
2023-08-28 19:55:15 +08:00
if ( p_name = = SNAME ( " script/source " ) ) {
2017-10-31 05:17:20 +08:00
set_source_code ( p_value ) ;
reload ( ) ;
return true ;
}
return false ;
}
void CSharpScript : : _get_property_list ( List < PropertyInfo > * p_properties ) const {
2023-08-28 19:55:15 +08:00
p_properties - > push_back ( PropertyInfo ( Variant : : STRING , SNAME ( " script/source " ) , PROPERTY_HINT_NONE , " " , PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL ) ) ;
2017-10-31 05:17:20 +08:00
}
2017-10-03 05:24:00 +08:00
void CSharpScript : : _bind_methods ( ) {
2019-08-27 00:36:51 +08:00
ClassDB : : bind_vararg_method ( METHOD_FLAGS_DEFAULT , " new " , & CSharpScript : : _new , MethodInfo ( " new " ) ) ;
2017-10-03 05:24:00 +08:00
}
2022-02-28 04:57:36 +08:00
void CSharpScript : : reload_registered_script ( Ref < CSharpScript > p_script ) {
2021-09-13 02:21:15 +08:00
// IMPORTANT:
// This method must be called only after the CSharpScript and its associated type
// have been added to the script bridge map in the ScriptManagerBridge C# class.
2022-02-28 04:57:36 +08:00
// Other than that, it's the same as `CSharpScript::reload`.
2019-07-08 21:18:38 +08:00
2022-02-28 04:57:36 +08:00
// This method should not fail, only assertions allowed.
// Unlike `reload`, we print an error rather than silently returning,
// as we can assert this won't be called a second time until invalidated.
ERR_FAIL_COND ( ! p_script - > reload_invalidated ) ;
2019-07-08 21:18:38 +08:00
2020-10-12 15:48:29 +08:00
p_script - > valid = true ;
2021-12-07 02:45:59 +08:00
p_script - > reload_invalidated = false ;
2020-10-12 15:48:29 +08:00
update_script_class_info ( p_script ) ;
2022-02-28 04:57:30 +08:00
p_script - > _update_exports ( ) ;
2023-02-02 07:54:16 +08:00
2024-01-17 17:12:44 +08:00
# ifdef TOOLS_ENABLED
2023-02-02 07:54:16 +08:00
// If the EditorFileSystem singleton is available, update the file;
// otherwise, the file will be updated when the singleton becomes available.
EditorFileSystem * efs = EditorFileSystem : : get_singleton ( ) ;
2023-07-08 02:51:46 +08:00
if ( efs & & ! p_script - > get_path ( ) . is_empty ( ) ) {
2023-02-02 07:54:16 +08:00
efs - > update_file ( p_script - > get_path ( ) ) ;
}
# endif
2020-10-12 15:48:29 +08:00
}
// Extract information about the script using the mono class.
void CSharpScript : : update_script_class_info ( Ref < CSharpScript > p_script ) {
2024-02-05 09:49:57 +08:00
TypeInfo type_info ;
2022-07-28 23:41:47 +08:00
2022-12-07 19:11:28 +08:00
// TODO: Use GDExtension godot_dictionary
2022-07-28 23:41:48 +08:00
Array methods_array ;
methods_array . ~ Array ( ) ;
2021-09-13 02:21:15 +08:00
Dictionary rpc_functions_dict ;
rpc_functions_dict . ~ Dictionary ( ) ;
2022-07-28 23:41:47 +08:00
Dictionary signals_dict ;
signals_dict . ~ Dictionary ( ) ;
2022-05-28 10:56:46 +08:00
Ref < CSharpScript > base_script ;
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_UpdateScriptClassInfo (
2024-02-05 09:49:57 +08:00
p_script . ptr ( ) , & type_info ,
2023-02-02 07:54:16 +08:00
& methods_array , & rpc_functions_dict , & signals_dict , & base_script ) ;
2017-10-03 05:24:00 +08:00
2024-02-05 09:49:57 +08:00
p_script - > type_info = type_info ;
2017-10-03 05:24:00 +08:00
2022-07-13 05:12:42 +08:00
p_script - > rpc_config . clear ( ) ;
2021-09-13 02:21:15 +08:00
p_script - > rpc_config = rpc_functions_dict ;
2022-05-28 10:56:46 +08:00
2022-07-28 23:41:48 +08:00
// Methods
p_script - > methods . clear ( ) ;
p_script - > methods . resize ( methods_array . size ( ) ) ;
int push_index = 0 ;
for ( int i = 0 ; i < methods_array . size ( ) ; i + + ) {
Dictionary method_info_dict = methods_array [ i ] ;
StringName name = method_info_dict [ " name " ] ;
MethodInfo mi ;
mi . name = name ;
2024-01-09 04:28:17 +08:00
mi . return_val = PropertyInfo : : from_dict ( method_info_dict [ " return_val " ] ) ;
2022-07-28 23:41:48 +08:00
Array params = method_info_dict [ " params " ] ;
for ( int j = 0 ; j < params . size ( ) ; j + + ) {
Dictionary param = params [ j ] ;
Variant : : Type param_type = ( Variant : : Type ) ( int ) param [ " type " ] ;
PropertyInfo arg_info = PropertyInfo ( param_type , ( String ) param [ " name " ] ) ;
arg_info . usage = ( uint32_t ) param [ " usage " ] ;
2023-06-17 05:05:11 +08:00
if ( param . has ( " class_name " ) ) {
arg_info . class_name = ( StringName ) param [ " class_name " ] ;
}
2022-07-28 23:41:48 +08:00
mi . arguments . push_back ( arg_info ) ;
}
2023-09-20 22:49:33 +08:00
mi . flags = ( uint32_t ) method_info_dict [ " flags " ] ;
2022-07-28 23:41:48 +08:00
p_script - > methods . set ( push_index + + , CSharpMethodInfo { name , mi } ) ;
}
2022-07-28 23:41:47 +08:00
// Event signals
// Performance is not critical here as this will be replaced with source generators.
p_script - > event_signals . clear ( ) ;
// Sigh... can't we just have capacity?
p_script - > event_signals . resize ( signals_dict . size ( ) ) ;
2022-07-28 23:41:48 +08:00
push_index = 0 ;
2022-07-28 23:41:47 +08:00
for ( const Variant * s = signals_dict . next ( nullptr ) ; s ! = nullptr ; s = signals_dict . next ( s ) ) {
StringName name = * s ;
MethodInfo mi ;
mi . name = name ;
Array params = signals_dict [ * s ] ;
for ( int i = 0 ; i < params . size ( ) ; i + + ) {
Dictionary param = params [ i ] ;
Variant : : Type param_type = ( Variant : : Type ) ( int ) param [ " type " ] ;
PropertyInfo arg_info = PropertyInfo ( param_type , ( String ) param [ " name " ] ) ;
arg_info . usage = ( uint32_t ) param [ " usage " ] ;
2023-06-17 05:05:11 +08:00
if ( param . has ( " class_name " ) ) {
arg_info . class_name = ( StringName ) param [ " class_name " ] ;
}
2022-07-28 23:41:47 +08:00
mi . arguments . push_back ( arg_info ) ;
}
p_script - > event_signals . set ( push_index + + , EventSignalInfo { name , mi } ) ;
}
2022-05-28 10:56:46 +08:00
p_script - > base_script = base_script ;
2017-10-03 05:24:00 +08:00
}
2021-06-18 06:03:09 +08:00
bool CSharpScript : : can_instantiate ( ) const {
2018-07-30 04:40:09 +08:00
# ifdef TOOLS_ENABLED
2024-02-05 09:49:57 +08:00
bool extra_cond = type_info . is_tool | | ScriptServer : : is_scripting_enabled ( ) ;
2018-07-30 04:40:09 +08:00
# else
2018-10-23 01:43:19 +08:00
bool extra_cond = true ;
2018-07-30 04:40:09 +08:00
# endif
2018-10-23 01:43:19 +08:00
// FIXME Need to think this through better.
// For tool scripts, this will never fire if the class is not found. That's because we
// don't know if it's a tool script if we can't find the class to access the attributes.
2021-09-13 02:21:15 +08:00
if ( extra_cond & & ! valid ) {
2024-02-05 09:49:57 +08:00
ERR_FAIL_V_MSG ( false , " Cannot instantiate C# script because the associated class could not be found. Script: ' " + get_path ( ) + " '. Make sure the script exists and contains a class definition with a name that matches the filename of the script exactly (it's case-sensitive). " ) ;
2018-10-23 01:43:19 +08:00
}
2024-02-05 09:49:57 +08:00
return valid & & type_info . can_instantiate ( ) & & extra_cond ;
2017-10-03 05:24:00 +08:00
}
StringName CSharpScript : : get_instance_base_type ( ) const {
2021-09-13 02:21:15 +08:00
StringName native_name ;
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_GetScriptNativeName ( this , & native_name ) ;
2021-09-13 02:21:15 +08:00
return native_name ;
2017-10-03 05:24:00 +08:00
}
2021-06-05 00:03:15 +08:00
CSharpInstance * CSharpScript : : _create_instance ( const Variant * * p_args , int p_argcount , Object * p_owner , bool p_is_ref_counted , Callable : : CallError & r_error ) {
2024-02-05 09:49:57 +08:00
ERR_FAIL_COND_V_MSG ( ! type_info . can_instantiate ( ) , nullptr , " Cannot instantiate C# script. Script: ' " + get_path ( ) + " '. " ) ;
2017-10-03 05:24:00 +08:00
/* STEP 1, CREATE */
2019-03-01 06:12:49 +08:00
2021-06-05 00:03:15 +08:00
Ref < RefCounted > ref ;
if ( p_is_ref_counted ) {
2019-02-03 13:35:22 +08:00
// Hold it alive. Important if we have to dispose a script instance binding before creating the CSharpInstance.
2021-06-05 00:03:15 +08:00
ref = Ref < RefCounted > ( static_cast < RefCounted * > ( p_owner ) ) ;
2019-02-03 13:35:22 +08:00
}
2021-08-16 23:16:36 +08:00
2019-02-03 13:35:22 +08:00
// If the object had a script instance binding, dispose it before adding the CSharpInstance
2021-08-16 23:16:36 +08:00
if ( CSharpLanguage : : has_instance_binding ( p_owner ) ) {
void * data = CSharpLanguage : : get_existing_instance_binding ( p_owner ) ;
2020-04-02 07:20:12 +08:00
CRASH_COND ( data = = nullptr ) ;
2019-02-03 13:35:22 +08:00
2022-05-13 21:04:37 +08:00
CSharpScriptBinding & script_binding = ( ( RBMap < Object * , CSharpScriptBinding > : : Element * ) data ) - > get ( ) ;
2019-12-12 00:08:40 +08:00
if ( script_binding . inited & & ! script_binding . gchandle . is_released ( ) ) {
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . CSharpInstanceBridge_CallDispose (
script_binding . gchandle . get_intptr ( ) , /* okIfNull */ true ) ;
2019-02-03 13:35:22 +08:00
2019-12-12 00:08:40 +08:00
script_binding . gchandle . release ( ) ; // Just in case
2019-02-03 13:35:22 +08:00
script_binding . inited = false ;
}
}
2021-08-16 23:16:36 +08:00
2020-03-15 02:20:17 +08:00
CSharpInstance * instance = memnew ( CSharpInstance ( Ref < CSharpScript > ( this ) ) ) ;
2021-06-05 00:03:15 +08:00
instance - > base_ref_counted = p_is_ref_counted ;
2017-10-03 05:24:00 +08:00
instance - > owner = p_owner ;
instance - > owner - > set_script_instance ( instance ) ;
/* STEP 2, INITIALIZE AND CONSTRUCT */
2021-09-13 02:23:05 +08:00
bool ok = GDMonoCache : : managed_callbacks . ScriptManagerBridge_CreateManagedForGodotObjectScriptInstance (
this , p_owner , p_args , p_argcount ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:23:05 +08:00
if ( ! ok ) {
2019-02-03 13:35:22 +08:00
// Important to clear this before destroying the script instance here
2017-10-03 05:24:00 +08:00
instance - > script = Ref < CSharpScript > ( ) ;
2020-04-02 07:20:12 +08:00
p_owner - > set_script_instance ( nullptr ) ;
2024-08-17 10:04:57 +08:00
instance - > owner = nullptr ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
return nullptr ;
2020-07-06 01:19:36 +08:00
}
2019-02-03 13:35:22 +08:00
2021-09-13 02:21:15 +08:00
CRASH_COND ( instance - > gchandle . is_released ( ) ) ;
2017-10-03 05:24:00 +08:00
/* STEP 3, PARTY */
//@TODO make thread safe
return instance ;
}
2020-02-20 03:27:19 +08:00
Variant CSharpScript : : _new ( const Variant * * p_args , int p_argcount , Callable : : CallError & r_error ) {
2017-10-03 05:24:00 +08:00
if ( ! valid ) {
2020-02-20 03:27:19 +08:00
r_error . error = Callable : : CallError : : CALL_ERROR_INVALID_METHOD ;
2017-10-03 05:24:00 +08:00
return Variant ( ) ;
}
2020-02-20 03:27:19 +08:00
r_error . error = Callable : : CallError : : CALL_OK ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
StringName native_name ;
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_GetScriptNativeName ( this , & native_name ) ;
2021-09-13 02:21:15 +08:00
ERR_FAIL_COND_V ( native_name = = StringName ( ) , Variant ( ) ) ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
Object * owner = ClassDB : : instantiate ( native_name ) ;
2017-10-03 05:24:00 +08:00
2022-05-03 07:43:50 +08:00
Ref < RefCounted > ref ;
2021-06-05 00:03:15 +08:00
RefCounted * r = Object : : cast_to < RefCounted > ( owner ) ;
2017-10-03 05:24:00 +08:00
if ( r ) {
2022-05-03 07:43:50 +08:00
ref = Ref < RefCounted > ( r ) ;
2017-10-03 05:24:00 +08:00
}
2020-04-02 07:20:12 +08:00
CSharpInstance * instance = _create_instance ( p_args , p_argcount , owner , r ! = nullptr , r_error ) ;
2017-10-03 05:24:00 +08:00
if ( ! instance ) {
if ( ref . is_null ( ) ) {
2021-08-16 23:16:36 +08:00
memdelete ( owner ) ; // no owner, sorry
2017-10-03 05:24:00 +08:00
}
return Variant ( ) ;
}
if ( ref . is_valid ( ) ) {
return ref ;
} else {
return owner ;
}
}
ScriptInstance * CSharpScript : : instance_create ( Object * p_this ) {
2018-07-30 04:40:09 +08:00
# ifdef DEBUG_ENABLED
CRASH_COND ( ! valid ) ;
2017-10-03 05:24:00 +08:00
# endif
2018-05-26 16:30:36 +08:00
2021-09-13 02:21:15 +08:00
StringName native_name ;
2021-09-13 02:23:05 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_GetScriptNativeName ( this , & native_name ) ;
2021-09-13 02:21:15 +08:00
ERR_FAIL_COND_V ( native_name = = StringName ( ) , nullptr ) ;
if ( ! ClassDB : : is_parent_class ( p_this - > get_class_name ( ) , native_name ) ) {
if ( EngineDebugger : : is_active ( ) ) {
CSharpLanguage : : get_singleton ( ) - > debug_break_parse ( get_path ( ) , 0 ,
" Script inherits from native type ' " + String ( native_name ) +
2022-10-04 18:56:49 +08:00
" ', so it can't be assigned to an object of type: ' " + p_this - > get_class ( ) + " ' " ) ;
2017-10-03 05:24:00 +08:00
}
2022-10-04 18:56:49 +08:00
ERR_FAIL_V_MSG ( nullptr , " Script inherits from native type ' " + String ( native_name ) + " ', so it can't be assigned to an object of type: ' " + p_this - > get_class ( ) + " '. " ) ;
2017-10-03 05:24:00 +08:00
}
2020-02-20 03:27:19 +08:00
Callable : : CallError unchecked_error ;
2021-06-05 00:03:15 +08:00
return _create_instance ( nullptr , 0 , p_this , Object : : cast_to < RefCounted > ( p_this ) ! = nullptr , unchecked_error ) ;
2017-10-03 05:24:00 +08:00
}
2018-07-30 04:40:09 +08:00
PlaceHolderScriptInstance * CSharpScript : : placeholder_instance_create ( Object * p_this ) {
# ifdef TOOLS_ENABLED
PlaceHolderScriptInstance * si = memnew ( PlaceHolderScriptInstance ( CSharpLanguage : : get_singleton ( ) , Ref < Script > ( this ) , p_this ) ) ;
placeholders . insert ( si ) ;
2021-06-13 19:32:44 +08:00
_update_exports ( si ) ;
2018-07-30 04:40:09 +08:00
return si ;
# else
2020-04-02 07:20:12 +08:00
return nullptr ;
2018-07-30 04:40:09 +08:00
# endif
}
2017-10-03 05:24:00 +08:00
bool CSharpScript : : instance_has ( const Object * p_this ) const {
2020-02-26 18:28:13 +08:00
MutexLock lock ( CSharpLanguage : : get_singleton ( ) - > script_instances_mutex ) ;
2018-12-01 03:43:06 +08:00
return instances . has ( ( Object * ) p_this ) ;
2017-10-03 05:24:00 +08:00
}
bool CSharpScript : : has_source_code ( ) const {
2020-12-15 20:04:21 +08:00
return ! source . is_empty ( ) ;
2017-10-03 05:24:00 +08:00
}
String CSharpScript : : get_source_code ( ) const {
return source ;
}
void CSharpScript : : set_source_code ( const String & p_code ) {
2020-07-06 01:19:36 +08:00
if ( source = = p_code ) {
2017-10-03 05:24:00 +08:00
return ;
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
source = p_code ;
# ifdef TOOLS_ENABLED
source_changed_cache = true ;
# endif
}
2018-11-01 23:35:16 +08:00
void CSharpScript : : get_script_method_list ( List < MethodInfo > * p_list ) const {
2021-09-13 02:21:15 +08:00
if ( ! valid ) {
2018-11-01 23:35:16 +08:00
return ;
2020-07-06 01:19:36 +08:00
}
2018-11-01 23:35:16 +08:00
2022-07-28 23:41:48 +08:00
const CSharpScript * top = this ;
while ( top ! = nullptr ) {
for ( const CSharpMethodInfo & E : top - > methods ) {
p_list - > push_back ( E . method_info ) ;
2021-09-13 01:53:34 +08:00
}
2022-07-28 23:41:48 +08:00
top = top - > base_script . ptr ( ) ;
2018-11-01 23:35:16 +08:00
}
}
2017-10-03 05:24:00 +08:00
bool CSharpScript : : has_method ( const StringName & p_method ) const {
2022-07-28 23:41:48 +08:00
if ( ! valid ) {
return false ;
}
for ( const CSharpMethodInfo & E : methods ) {
if ( E . name = = p_method ) {
return true ;
}
}
2021-12-29 06:25:16 +08:00
return false ;
2017-10-03 05:24:00 +08:00
}
2024-01-28 22:16:09 +08:00
int CSharpScript : : get_script_method_argument_count ( const StringName & p_method , bool * r_is_valid ) const {
if ( ! valid ) {
if ( r_is_valid ) {
* r_is_valid = false ;
}
return 0 ;
}
for ( const CSharpMethodInfo & E : methods ) {
if ( E . name = = p_method ) {
if ( r_is_valid ) {
* r_is_valid = true ;
}
return E . method_info . arguments . size ( ) ;
}
}
if ( r_is_valid ) {
* r_is_valid = false ;
}
return 0 ;
}
2018-11-01 23:35:16 +08:00
MethodInfo CSharpScript : : get_method_info ( const StringName & p_method ) const {
2021-09-13 02:21:15 +08:00
if ( ! valid ) {
2018-11-01 23:35:16 +08:00
return MethodInfo ( ) ;
2020-07-06 01:19:36 +08:00
}
2018-11-01 23:35:16 +08:00
2024-04-21 11:32:47 +08:00
MethodInfo mi ;
2022-07-28 23:41:48 +08:00
for ( const CSharpMethodInfo & E : methods ) {
if ( E . name = = p_method ) {
2024-04-21 11:32:47 +08:00
if ( mi . name = = p_method ) {
// We already found a method with the same name before so
// that means this method has overloads, the best we can do
// is return an empty MethodInfo.
return MethodInfo ( ) ;
}
mi = E . method_info ;
2018-11-01 23:35:16 +08:00
}
}
2024-04-21 11:32:47 +08:00
return mi ;
2018-11-01 23:35:16 +08:00
}
2023-09-20 22:49:33 +08:00
Variant CSharpScript : : callp ( const StringName & p_method , const Variant * * p_args , int p_argcount , Callable : : CallError & r_error ) {
2023-11-14 23:56:16 +08:00
if ( valid ) {
Variant ret ;
bool ok = GDMonoCache : : managed_callbacks . ScriptManagerBridge_CallStatic ( this , & p_method , p_args , p_argcount , & r_error , & ret ) ;
if ( ok ) {
return ret ;
}
2023-09-20 22:49:33 +08:00
}
return Script : : callp ( p_method , p_args , p_argcount , r_error ) ;
}
2017-10-03 05:24:00 +08:00
Error CSharpScript : : reload ( bool p_keep_state ) {
2021-12-07 02:45:59 +08:00
if ( ! reload_invalidated ) {
return OK ;
2018-12-01 03:43:06 +08:00
}
2017-10-03 05:24:00 +08:00
2021-12-07 02:45:59 +08:00
// In the case of C#, reload doesn't really do any script reloading.
// That's done separately via domain reloading.
reload_invalidated = false ;
2017-10-03 05:24:00 +08:00
2021-09-13 02:21:15 +08:00
String script_path = get_path ( ) ;
2017-10-05 06:10:51 +08:00
2021-09-13 02:23:05 +08:00
valid = GDMonoCache : : managed_callbacks . ScriptManagerBridge_AddScriptBridge ( this , & script_path ) ;
2018-04-25 02:42:31 +08:00
2021-09-13 02:21:15 +08:00
if ( valid ) {
2017-10-05 06:10:51 +08:00
# ifdef DEBUG_ENABLED
2021-09-13 02:21:15 +08:00
print_verbose ( " Found class for script " + get_path ( ) ) ;
2017-10-05 06:10:51 +08:00
# endif
2021-03-06 07:12:42 +08:00
update_script_class_info ( this ) ;
2017-10-03 05:24:00 +08:00
2021-03-06 07:12:42 +08:00
_update_exports ( ) ;
2023-02-02 07:54:16 +08:00
2024-01-17 17:12:44 +08:00
# ifdef TOOLS_ENABLED
2023-02-02 07:54:16 +08:00
// If the EditorFileSystem singleton is available, update the file;
// otherwise, the file will be updated when the singleton becomes available.
EditorFileSystem * efs = EditorFileSystem : : get_singleton ( ) ;
if ( efs ) {
efs - > update_file ( script_path ) ;
}
# endif
2017-10-03 05:24:00 +08:00
}
2021-03-06 07:12:42 +08:00
return OK ;
2017-10-03 05:24:00 +08:00
}
ScriptLanguage * CSharpScript : : get_language ( ) const {
return CSharpLanguage : : get_singleton ( ) ;
}
bool CSharpScript : : get_property_default_value ( const StringName & p_property , Variant & r_value ) const {
# ifdef TOOLS_ENABLED
2022-05-13 21:04:37 +08:00
HashMap < StringName , Variant > : : ConstIterator E = exported_members_defval_cache . find ( p_property ) ;
2017-10-03 05:24:00 +08:00
if ( E ) {
2022-05-13 21:04:37 +08:00
r_value = E - > value ;
2017-10-03 05:24:00 +08:00
return true ;
}
2022-05-28 10:56:46 +08:00
if ( base_script . is_valid ( ) ) {
return base_script - > get_property_default_value ( p_property , r_value ) ;
2017-10-03 05:24:00 +08:00
}
# endif
return false ;
}
void CSharpScript : : update_exports ( ) {
# ifdef TOOLS_ENABLED
_update_exports ( ) ;
# endif
}
2018-01-19 06:27:43 +08:00
bool CSharpScript : : has_script_signal ( const StringName & p_signal ) const {
2021-09-13 02:21:15 +08:00
if ( ! valid ) {
return false ;
}
2021-09-13 02:23:05 +08:00
if ( ! GDMonoCache : : godot_api_cache_updated ) {
2021-09-13 02:21:15 +08:00
return false ;
}
2022-07-28 23:41:47 +08:00
for ( const EventSignalInfo & signal : event_signals ) {
if ( signal . name = = p_signal ) {
return true ;
}
}
2021-09-13 02:21:15 +08:00
2024-05-09 19:46:25 +08:00
if ( base_script . is_valid ( ) ) {
return base_script - > has_script_signal ( p_signal ) ;
}
2022-07-28 23:41:47 +08:00
return false ;
2018-01-19 06:27:43 +08:00
}
2024-05-09 19:46:25 +08:00
void CSharpScript : : _get_script_signal_list ( List < MethodInfo > * r_signals , bool p_include_base ) const {
2021-09-13 02:21:15 +08:00
if ( ! valid ) {
return ;
}
2020-03-15 02:20:17 +08:00
2024-05-09 19:46:25 +08:00
for ( const EventSignalInfo & signal : event_signals ) {
2022-07-28 23:41:47 +08:00
r_signals - > push_back ( signal . method_info ) ;
2021-09-13 02:21:15 +08:00
}
2020-03-15 02:20:17 +08:00
2024-05-09 19:46:25 +08:00
if ( ! p_include_base ) {
return ;
}
if ( base_script . is_valid ( ) ) {
base_script - > get_script_signal_list ( r_signals ) ;
2018-01-19 06:27:43 +08:00
}
2024-05-09 19:46:25 +08:00
}
2022-07-28 23:41:47 +08:00
2024-05-09 19:46:25 +08:00
void CSharpScript : : get_script_signal_list ( List < MethodInfo > * r_signals ) const {
_get_script_signal_list ( r_signals , true ) ;
2018-01-19 06:27:43 +08:00
}
2020-04-21 06:06:00 +08:00
bool CSharpScript : : inherits_script ( const Ref < Script > & p_script ) const {
Ref < CSharpScript > cs = p_script ;
if ( cs . is_null ( ) ) {
return false ;
}
2021-09-13 02:21:15 +08:00
if ( ! valid | | ! cs - > valid ) {
2020-05-11 03:49:15 +08:00
return false ;
}
2021-09-13 02:23:05 +08:00
if ( ! GDMonoCache : : godot_api_cache_updated ) {
2021-09-13 02:21:15 +08:00
return false ;
2020-05-11 03:49:15 +08:00
}
2021-09-13 02:23:05 +08:00
return GDMonoCache : : managed_callbacks . ScriptManagerBridge_ScriptIsOrInherits ( this , cs . ptr ( ) ) ;
2020-04-21 06:06:00 +08:00
}
2017-10-03 05:24:00 +08:00
Ref < Script > CSharpScript : : get_base_script ( ) const {
2024-02-05 09:49:57 +08:00
return base_script ;
2017-10-03 05:24:00 +08:00
}
2023-01-20 02:12:25 +08:00
StringName CSharpScript : : get_global_name ( ) const {
2024-02-05 09:49:57 +08:00
return type_info . is_global_class ? StringName ( type_info . class_name ) : StringName ( ) ;
2023-01-20 02:12:25 +08:00
}
2021-10-23 01:25:01 +08:00
void CSharpScript : : get_script_property_list ( List < PropertyInfo > * r_list ) const {
2022-07-31 16:07:48 +08:00
# ifdef TOOLS_ENABLED
2022-05-28 10:56:46 +08:00
const CSharpScript * top = this ;
while ( top ! = nullptr ) {
for ( const PropertyInfo & E : top - > exported_members_cache ) {
r_list - > push_back ( E ) ;
}
top = top - > base_script . ptr ( ) ;
2022-07-31 16:07:48 +08:00
}
# else
2022-05-28 10:56:46 +08:00
const CSharpScript * top = this ;
while ( top ! = nullptr ) {
List < PropertyInfo > props ;
2021-10-30 22:55:21 +08:00
2022-05-28 10:56:46 +08:00
for ( const KeyValue < StringName , PropertyInfo > & E : top - > member_info ) {
props . push_front ( E . value ) ;
}
for ( const PropertyInfo & prop : props ) {
r_list - > push_back ( prop ) ;
}
top = top - > base_script . ptr ( ) ;
2017-10-03 05:24:00 +08:00
}
2022-05-28 10:56:46 +08:00
# endif
2017-10-03 05:24:00 +08:00
}
int CSharpScript : : get_member_line ( const StringName & p_member ) const {
// TODO omnisharp
return - 1 ;
}
2024-08-24 13:58:54 +08:00
Variant CSharpScript : : get_rpc_config ( ) const {
2022-07-13 05:12:42 +08:00
return rpc_config ;
2020-02-12 18:51:50 +08:00
}
2017-10-03 05:24:00 +08:00
Error CSharpScript : : load_source_code ( const String & p_path ) {
2018-10-23 01:43:19 +08:00
Error ferr = read_all_file_utf8 ( p_path , source ) ;
2019-08-09 09:39:45 +08:00
ERR_FAIL_COND_V_MSG ( ferr ! = OK , ferr ,
2021-10-28 21:57:41 +08:00
ferr = = ERR_INVALID_DATA
? " Script ' " + p_path + " ' contains invalid unicode (UTF-8), so it was not loaded. "
" Please ensure that scripts are saved in valid UTF-8 unicode. "
: " Failed to read file: ' " + p_path + " '. " ) ;
2017-10-03 05:24:00 +08:00
# ifdef TOOLS_ENABLED
source_changed_cache = true ;
# endif
return OK ;
}
2020-07-06 01:19:36 +08:00
void CSharpScript : : _clear ( ) {
2024-02-05 09:49:57 +08:00
type_info = TypeInfo ( ) ;
2020-07-06 01:19:36 +08:00
valid = false ;
2021-12-07 02:45:59 +08:00
reload_invalidated = true ;
2017-10-03 05:24:00 +08:00
}
2020-03-15 02:20:17 +08:00
CSharpScript : : CSharpScript ( ) {
2017-10-03 05:24:00 +08:00
_clear ( ) ;
# ifdef DEBUG_ENABLED
2018-12-01 03:43:06 +08:00
{
2020-02-26 18:28:13 +08:00
MutexLock lock ( CSharpLanguage : : get_singleton ( ) - > script_instances_mutex ) ;
2024-01-28 18:46:38 +08:00
CSharpLanguage : : get_singleton ( ) - > script_list . add ( & script_list ) ;
2018-12-01 03:43:06 +08:00
}
2017-10-03 05:24:00 +08:00
# endif
}
CSharpScript : : ~ CSharpScript ( ) {
# ifdef DEBUG_ENABLED
2024-01-28 18:46:38 +08:00
{
MutexLock lock ( CSharpLanguage : : get_singleton ( ) - > script_instances_mutex ) ;
CSharpLanguage : : get_singleton ( ) - > script_list . remove ( & script_list ) ;
}
2017-10-03 05:24:00 +08:00
# endif
2021-09-13 02:21:15 +08:00
2021-09-13 02:23:05 +08:00
if ( GDMonoCache : : godot_api_cache_updated ) {
GDMonoCache : : managed_callbacks . ScriptManagerBridge_RemoveScriptBridge ( this ) ;
2021-09-13 02:21:15 +08:00
}
2017-10-03 05:24:00 +08:00
}
2022-05-19 23:00:06 +08:00
void CSharpScript : : get_members ( HashSet < StringName > * p_members ) {
2020-05-22 06:58:34 +08:00
# if defined(TOOLS_ENABLED) || defined(DEBUG_ENABLED)
if ( p_members ) {
2021-07-27 03:31:17 +08:00
for ( const StringName & member_name : exported_members_names ) {
p_members - > insert ( member_name ) ;
2020-05-22 06:58:34 +08:00
}
}
# endif
}
2017-10-03 05:24:00 +08:00
/*************** RESOURCE ***************/
2022-05-03 07:43:50 +08:00
Ref < Resource > ResourceFormatLoaderCSharpScript : : 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 ) {
2020-07-06 01:19:36 +08:00
if ( r_error ) {
2017-10-03 05:24:00 +08:00
* r_error = ERR_FILE_CANT_OPEN ;
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
// TODO ignore anything inside bin/ and obj/ in tools builds?
2024-02-05 09:49:57 +08:00
String real_path = p_path ;
if ( p_path . begins_with ( " csharp:// " ) ) {
// This is a virtual path used by generic types, extract the real path.
real_path = " res:// " + p_path . trim_prefix ( " csharp:// " ) ;
real_path = real_path . substr ( 0 , real_path . rfind ( " : " ) ) ;
}
2023-03-24 19:38:00 +08:00
Ref < CSharpScript > scr ;
2017-10-03 05:24:00 +08:00
2022-02-28 04:57:36 +08:00
if ( GDMonoCache : : godot_api_cache_updated ) {
2023-03-24 19:38:00 +08:00
GDMonoCache : : managed_callbacks . ScriptManagerBridge_GetOrCreateScriptBridgeForPath ( & p_path , & scr ) ;
2024-07-26 17:52:26 +08:00
ERR_FAIL_COND_V_MSG ( scr . is_null ( ) , Ref < Resource > ( ) , " Could not create C# script ' " + real_path + " '. " ) ;
2022-02-28 04:57:36 +08:00
} else {
2023-03-24 19:38:00 +08:00
scr = Ref < CSharpScript > ( memnew ( CSharpScript ) ) ;
2022-02-28 04:57:36 +08:00
}
2017-10-03 05:24:00 +08:00
# if defined(DEBUG_ENABLED) || defined(TOOLS_ENABLED)
2024-02-05 09:49:57 +08:00
Error err = scr - > load_source_code ( real_path ) ;
ERR_FAIL_COND_V_MSG ( err ! = OK , Ref < Resource > ( ) , " Cannot load C# script file ' " + real_path + " '. " ) ;
2017-10-03 05:24:00 +08:00
# endif
2023-11-29 19:48:14 +08:00
// Only one instance of a C# script is allowed to exist.
ERR_FAIL_COND_V_MSG ( ! scr - > get_path ( ) . is_empty ( ) & & scr - > get_path ( ) ! = p_original_path , Ref < Resource > ( ) ,
" The C# script path is different from the path it was registered in the C# dictionary. " ) ;
2017-10-07 06:43:02 +08:00
2024-02-25 09:09:05 +08:00
Ref < Resource > existing = ResourceCache : : get_ref ( p_path ) ;
switch ( p_cache_mode ) {
case ResourceFormatLoader : : CACHE_MODE_IGNORE :
2024-02-22 19:53:19 +08:00
case ResourceFormatLoader : : CACHE_MODE_IGNORE_DEEP :
2024-02-25 09:09:05 +08:00
break ;
case ResourceFormatLoader : : CACHE_MODE_REUSE :
if ( existing . is_null ( ) ) {
scr - > set_path ( p_original_path ) ;
} else {
scr = existing ;
}
break ;
case ResourceFormatLoader : : CACHE_MODE_REPLACE :
2024-02-22 19:53:19 +08:00
case ResourceFormatLoader : : CACHE_MODE_REPLACE_DEEP :
2024-02-25 09:09:05 +08:00
scr - > set_path ( p_original_path , true ) ;
break ;
}
2023-03-24 19:38:00 +08:00
scr - > reload ( ) ;
2017-10-03 05:24:00 +08:00
2020-07-06 01:19:36 +08:00
if ( r_error ) {
2017-10-03 05:24:00 +08:00
* r_error = OK ;
2020-07-06 01:19:36 +08:00
}
2017-10-03 05:24:00 +08:00
2023-03-24 19:38:00 +08:00
return scr ;
2017-10-03 05:24:00 +08:00
}
void ResourceFormatLoaderCSharpScript : : get_recognized_extensions ( List < String > * p_extensions ) const {
p_extensions - > push_back ( " cs " ) ;
}
bool ResourceFormatLoaderCSharpScript : : handles_type ( const String & p_type ) const {
return p_type = = " Script " | | p_type = = CSharpLanguage : : get_singleton ( ) - > get_type ( ) ;
}
String ResourceFormatLoaderCSharpScript : : get_resource_type ( const String & p_path ) const {
return p_path . get_extension ( ) . to_lower ( ) = = " cs " ? CSharpLanguage : : get_singleton ( ) - > get_type ( ) : " " ;
}
2022-06-03 07:33:42 +08:00
Error ResourceFormatSaverCSharpScript : : save ( const Ref < Resource > & p_resource , const String & p_path , uint32_t p_flags ) {
2017-10-03 05:24:00 +08:00
Ref < CSharpScript > sqscr = p_resource ;
ERR_FAIL_COND_V ( sqscr . is_null ( ) , ERR_INVALID_PARAMETER ) ;
String source = sqscr - > get_source_code ( ) ;
# ifdef TOOLS_ENABLED
if ( ! FileAccess : : exists ( p_path ) ) {
2020-07-20 21:48:12 +08:00
// The file does not yet exist, let's assume the user just created this script. In such
// cases we need to check whether the solution and csproj were already created or not.
if ( ! _create_project_solution_if_needed ( ) ) {
2019-11-07 00:03:04 +08:00
ERR_PRINT ( " C# project could not be created; cannot add file: ' " + p_path + " '. " ) ;
2017-10-03 05:24:00 +08:00
}
}
# endif
2022-04-12 15:12:40 +08:00
{
Error err ;
Ref < FileAccess > file = FileAccess : : open ( p_path , FileAccess : : WRITE , & err ) ;
ERR_FAIL_COND_V_MSG ( err ! = OK , err , " Cannot save C# script file ' " + p_path + " '. " ) ;
2017-10-03 05:24:00 +08:00
2022-04-12 15:12:40 +08:00
file - > store_string ( source ) ;
2017-10-03 05:24:00 +08:00
2022-04-12 15:12:40 +08:00
if ( file - > get_error ( ) ! = OK & & file - > get_error ( ) ! = ERR_FILE_EOF ) {
return ERR_CANT_CREATE ;
}
2017-10-03 05:24:00 +08:00
}
2019-01-23 01:33:36 +08:00
# ifdef TOOLS_ENABLED
2017-10-03 05:24:00 +08:00
if ( ScriptServer : : is_reload_scripts_on_save_enabled ( ) ) {
CSharpLanguage : : get_singleton ( ) - > reload_tool_script ( p_resource , false ) ;
}
2019-01-23 01:33:36 +08:00
# endif
2017-10-03 05:24:00 +08:00
return OK ;
}
2022-05-03 07:43:50 +08:00
void ResourceFormatSaverCSharpScript : : get_recognized_extensions ( const Ref < Resource > & p_resource , List < String > * p_extensions ) const {
2017-10-03 05:24:00 +08:00
if ( Object : : cast_to < CSharpScript > ( p_resource . ptr ( ) ) ) {
p_extensions - > push_back ( " cs " ) ;
}
}
2022-05-03 07:43:50 +08:00
bool ResourceFormatSaverCSharpScript : : recognize ( const Ref < Resource > & p_resource ) const {
2020-04-02 07:20:12 +08:00
return Object : : cast_to < CSharpScript > ( p_resource . ptr ( ) ) ! = nullptr ;
2017-10-03 05:24:00 +08:00
}