2017-10-02 21:24:00 +00:00
/*************************************************************************/
/* bindings_generator.cpp */
/*************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/*************************************************************************/
2018-01-01 13:40:08 +00:00
/* Copyright (c) 2007-2018 Juan Linietsky, Ariel Manzur. */
/* Copyright (c) 2014-2018 Godot Engine contributors (cf. AUTHORS.md) */
2017-10-02 21:24:00 +00:00
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/*************************************************************************/
2018-01-04 23:50:27 +00:00
2017-10-02 21:24:00 +00:00
# include "bindings_generator.h"
# ifdef DEBUG_METHODS_ENABLED
2017-11-13 20:46:57 +00:00
# include "engine.h"
2017-10-02 21:24:00 +00:00
# include "global_constants.h"
# include "io/compression.h"
# include "os/dir_access.h"
# include "os/file_access.h"
# include "os/os.h"
# include "ucaps.h"
# include "../glue/cs_compressed.gen.h"
# include "../godotsharp_defs.h"
# include "../mono_gd/gd_mono_marshal.h"
# include "../utils/path_utils.h"
# include "../utils/string_utils.h"
# include "csharp_project.h"
# include "net_solution.h"
# define CS_INDENT " "
# define INDENT1 CS_INDENT
# define INDENT2 INDENT1 INDENT1
# define INDENT3 INDENT2 INDENT1
# define INDENT4 INDENT3 INDENT1
# define INDENT5 INDENT4 INDENT1
# define MEMBER_BEGIN "\n" INDENT2
# define OPEN_BLOCK "{\n"
# define CLOSE_BLOCK "}\n"
# define OPEN_BLOCK_L2 INDENT2 OPEN_BLOCK INDENT3
# define OPEN_BLOCK_L3 INDENT3 OPEN_BLOCK INDENT4
# define OPEN_BLOCK_L4 INDENT4 OPEN_BLOCK INDENT5
# define CLOSE_BLOCK_L2 INDENT2 CLOSE_BLOCK
# define CLOSE_BLOCK_L3 INDENT3 CLOSE_BLOCK
# define CLOSE_BLOCK_L4 INDENT4 CLOSE_BLOCK
# define LOCAL_RET "ret"
# define CS_FIELD_MEMORYOWN "memoryOwn"
# define CS_PARAM_METHODBIND "method"
# define CS_PARAM_INSTANCE "ptr"
# define CS_SMETHOD_GETINSTANCE "GetPtr"
# define CS_FIELD_SINGLETON "instance"
# define CS_PROP_SINGLETON "Instance"
# define CS_CLASS_SIGNALAWAITER "SignalAwaiter"
# define CS_METHOD_CALL "Call"
# define GLUE_HEADER_FILE "glue_header.h"
# define ICALL_PREFIX "godot_icall_"
# define SINGLETON_ICALL_SUFFIX "_get_singleton"
# define ICALL_GET_METHODBIND ICALL_PREFIX "ClassDB_get_method"
# define ICALL_CONNECT_SIGNAL_AWAITER ICALL_PREFIX "Object_connect_signal_awaiter"
# define ICALL_OBJECT_DTOR ICALL_PREFIX "Object_Dtor"
# define C_LOCAL_PTRCALL_ARGS "call_args"
# define C_MACRO_OBJECT_CONSTRUCT "GODOTSHARP_INSTANCE_OBJECT"
# define C_NS_MONOUTILS "GDMonoUtils"
# define C_NS_MONOINTERNALS "GDMonoInternals"
# define C_METHOD_TIE_MANAGED_TO_UNMANAGED C_NS_MONOINTERNALS "::tie_managed_to_unmanaged"
# define C_METHOD_UNMANAGED_GET_MANAGED C_NS_MONOUTILS "::unmanaged_get_managed"
# define C_NS_MONOMARSHAL "GDMonoMarshal"
# define C_METHOD_MANAGED_TO_VARIANT C_NS_MONOMARSHAL "::mono_object_to_variant"
# define C_METHOD_MANAGED_FROM_VARIANT C_NS_MONOMARSHAL "::variant_to_mono_object"
# define C_METHOD_MONOSTR_TO_GODOT C_NS_MONOMARSHAL "::mono_string_to_godot"
# define C_METHOD_MONOSTR_FROM_GODOT C_NS_MONOMARSHAL "::mono_string_from_godot"
# define C_METHOD_MONOARRAY_TO(m_type) C_NS_MONOMARSHAL "::mono_array_to_" #m_type
# define C_METHOD_MONOARRAY_FROM(m_type) C_NS_MONOMARSHAL "::" #m_type "_to_mono_array"
# define C_METHOD_MANAGED_TO_DICT C_NS_MONOMARSHAL "::mono_object_to_Dictionary"
# define C_METHOD_MANAGED_FROM_DICT C_NS_MONOMARSHAL "::Dictionary_to_mono_object"
2018-03-03 19:25:21 +00:00
# define BINDINGS_GENERATOR_VERSION UINT32_C(2)
2018-02-22 12:13:51 +00:00
2017-10-02 21:24:00 +00:00
const char * BindingsGenerator : : TypeInterface : : DEFAULT_VARARG_C_IN = " \t %0 %1_in = %1; \n " ;
bool BindingsGenerator : : verbose_output = false ;
2018-01-01 02:04:49 +00:00
BindingsGenerator * BindingsGenerator : : singleton = NULL ;
2017-12-24 02:17:48 +00:00
static String snake_to_pascal_case ( const String & p_identifier , bool p_input_is_upper = false ) {
2017-10-02 21:24:00 +00:00
String ret ;
Vector < String > parts = p_identifier . split ( " _ " , true ) ;
for ( int i = 0 ; i < parts . size ( ) ; i + + ) {
String part = parts [ i ] ;
if ( part . length ( ) ) {
part [ 0 ] = _find_upper ( part [ 0 ] ) ;
2017-12-24 02:17:48 +00:00
if ( p_input_is_upper ) {
for ( int j = 1 ; j < part . length ( ) ; j + + )
part [ j ] = _find_lower ( part [ j ] ) ;
}
2017-10-02 21:24:00 +00:00
ret + = part ;
} else {
if ( i = = 0 | | i = = ( parts . size ( ) - 1 ) ) {
// Preserve underscores at the beginning and end
ret + = " _ " ;
} else {
// Preserve contiguous underscores
if ( parts [ i - 1 ] . length ( ) ) {
ret + = " __ " ;
} else {
ret + = " _ " ;
}
}
}
}
return ret ;
}
2017-12-24 02:17:48 +00:00
static String snake_to_camel_case ( const String & p_identifier , bool p_input_is_upper = false ) {
2017-10-02 21:24:00 +00:00
String ret ;
Vector < String > parts = p_identifier . split ( " _ " , true ) ;
for ( int i = 0 ; i < parts . size ( ) ; i + + ) {
String part = parts [ i ] ;
if ( part . length ( ) ) {
2017-12-24 02:17:48 +00:00
if ( i ! = 0 ) {
2017-10-02 21:24:00 +00:00
part [ 0 ] = _find_upper ( part [ 0 ] ) ;
2017-12-24 02:17:48 +00:00
}
if ( p_input_is_upper ) {
for ( int j = i ! = 0 ? 1 : 0 ; j < part . length ( ) ; j + + )
part [ j ] = _find_lower ( part [ j ] ) ;
}
2017-10-02 21:24:00 +00:00
ret + = part ;
} else {
if ( i = = 0 | | i = = ( parts . size ( ) - 1 ) ) {
// Preserve underscores at the beginning and end
ret + = " _ " ;
} else {
// Preserve contiguous underscores
if ( parts [ i - 1 ] . length ( ) ) {
ret + = " __ " ;
} else {
ret + = " _ " ;
}
}
}
}
return ret ;
}
2017-12-24 02:17:48 +00:00
String BindingsGenerator : : _determine_enum_prefix ( const EnumInterface & p_ienum ) {
CRASH_COND ( p_ienum . constants . empty ( ) ) ;
const List < ConstantInterface > : : Element * front = p_ienum . constants . front ( ) ;
int candidate_len = front - > get ( ) . name . length ( ) ;
for ( const List < ConstantInterface > : : Element * E = front - > next ( ) ; E ; E = E - > next ( ) ) {
int j = 0 ;
for ( j = 0 ; j < candidate_len & & j < E - > get ( ) . name . length ( ) ; j + + ) {
if ( front - > get ( ) . name [ j ] ! = E - > get ( ) . name [ j ] )
break ;
}
candidate_len = j ;
}
return front - > get ( ) . name . substr ( 0 , candidate_len ) ;
}
2017-10-02 21:24:00 +00:00
void BindingsGenerator : : _generate_header_icalls ( ) {
core_custom_icalls . clear ( ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_GET_METHODBIND , " IntPtr " , " string type, string method " ) ) ;
2017-12-31 21:37:57 +00:00
core_custom_icalls . push_back ( InternalCall ( ICALL_OBJECT_DTOR , " void " , " object obj, IntPtr ptr " ) ) ;
2017-10-02 21:24:00 +00:00
core_custom_icalls . push_back ( InternalCall ( ICALL_CONNECT_SIGNAL_AWAITER , " Error " ,
" IntPtr source, string signal, IntPtr target, " CS_CLASS_SIGNALAWAITER " awaiter " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " NodePath_Ctor " , " IntPtr " , " string path " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " NodePath_Dtor " , " void " , " IntPtr ptr " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " NodePath_operator_String " , " string " , " IntPtr ptr " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " RID_Ctor " , " IntPtr " , " IntPtr from " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " RID_Dtor " , " void " , " IntPtr ptr " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " String_md5_buffer " , " byte[] " , " string str " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " String_md5_text " , " string " , " string str " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " String_rfind " , " int " , " string str, string what, int from " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " String_rfindn " , " int " , " string str, string what, int from " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " String_sha256_buffer " , " byte[] " , " string str " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " String_sha256_text " , " string " , " string str " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_bytes2var " , " object " , " byte[] bytes " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_convert " , " object " , " object what, int type " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_hash " , " int " , " object var " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_instance_from_id " , " Object " , " int instance_id " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_print " , " void " , " object[] what " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_printerr " , " void " , " object[] what " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_printraw " , " void " , " object[] what " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_prints " , " void " , " object[] what " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_printt " , " void " , " object[] what " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_seed " , " void " , " int seed " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_str " , " string " , " object[] what " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_str2var " , " object " , " string str " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_type_exists " , " bool " , " string type " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_var2bytes " , " byte[] " , " object what " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_var2str " , " string " , " object var " ) ) ;
core_custom_icalls . push_back ( InternalCall ( ICALL_PREFIX " Godot_weakref " , " WeakRef " , " IntPtr obj " ) ) ;
}
void BindingsGenerator : : _generate_method_icalls ( const TypeInterface & p_itype ) {
for ( const List < MethodInterface > : : Element * E = p_itype . methods . front ( ) ; E ; E = E - > next ( ) ) {
const MethodInterface & imethod = E - > get ( ) ;
if ( imethod . is_virtual )
continue ;
const TypeInterface * return_type = _get_type_by_name_or_placeholder ( imethod . return_type ) ;
2018-01-25 22:44:37 +00:00
String im_sig ;
String im_unique_sig ;
if ( p_itype . is_object_type ) {
im_sig + = " IntPtr " CS_PARAM_METHODBIND " , " ;
im_unique_sig + = imethod . return_type . operator String ( ) + " ,IntPtr,IntPtr " ;
}
im_sig + = " IntPtr " CS_PARAM_INSTANCE ;
2017-10-02 21:24:00 +00:00
// Get arguments information
int i = 0 ;
for ( const List < ArgumentInterface > : : Element * F = imethod . arguments . front ( ) ; F ; F = F - > next ( ) ) {
const TypeInterface * arg_type = _get_type_by_name_or_placeholder ( F - > get ( ) . type ) ;
im_sig + = " , " ;
im_sig + = arg_type - > im_type_in ;
im_sig + = " arg " ;
im_sig + = itos ( i + 1 ) ;
2018-01-25 22:44:37 +00:00
if ( p_itype . is_object_type ) {
im_unique_sig + = " , " ;
im_unique_sig + = get_unique_sig ( * arg_type ) ;
}
2017-10-02 21:24:00 +00:00
i + + ;
}
2018-01-25 22:44:37 +00:00
String icall_method = ICALL_PREFIX ;
if ( p_itype . is_object_type ) {
icall_method + = itos ( imethod . arguments . size ( ) ) + " _ " + itos ( method_icalls . size ( ) ) ; // godot_icall_{argc}_{icallcount}
} else {
icall_method + = p_itype . name + " _ " + imethod . name ; // godot_icall_{Type}_{method}
}
2017-10-02 21:24:00 +00:00
InternalCall im_icall = InternalCall ( p_itype . api_type , icall_method , return_type - > im_type_out , im_sig , im_unique_sig ) ;
2018-01-25 22:44:37 +00:00
if ( p_itype . is_object_type ) {
List < InternalCall > : : Element * match = method_icalls . find ( im_icall ) ;
2017-10-02 21:24:00 +00:00
2018-01-25 22:44:37 +00:00
if ( match ) {
if ( p_itype . api_type ! = ClassDB : : API_EDITOR )
match - > get ( ) . editor_only = false ;
method_icalls_map . insert ( & E - > get ( ) , & match - > get ( ) ) ;
} else {
List < InternalCall > : : Element * added = method_icalls . push_back ( im_icall ) ;
method_icalls_map . insert ( & E - > get ( ) , & added - > get ( ) ) ;
}
2017-10-02 21:24:00 +00:00
} else {
2018-01-25 22:44:37 +00:00
List < InternalCall > : : Element * added = builtin_method_icalls . push_back ( im_icall ) ;
2017-10-02 21:24:00 +00:00
method_icalls_map . insert ( & E - > get ( ) , & added - > get ( ) ) ;
}
}
}
2017-12-24 02:17:48 +00:00
void BindingsGenerator : : _generate_global_constants ( List < String > & p_output ) {
// Constants (in partial GD class)
p_output . push_back ( " namespace " BINDINGS_NAMESPACE " \n " OPEN_BLOCK ) ;
p_output . push_back ( INDENT1 " public static partial class " BINDINGS_GLOBAL_SCOPE_CLASS " \n " INDENT1 " { " ) ;
for ( const List < ConstantInterface > : : Element * E = global_constants . front ( ) ; E ; E = E - > next ( ) ) {
const ConstantInterface & iconstant = E - > get ( ) ;
if ( iconstant . const_doc & & iconstant . const_doc - > description . size ( ) ) {
p_output . push_back ( MEMBER_BEGIN " /// <summary> \n " ) ;
Vector < String > description_lines = iconstant . const_doc - > description . split ( " \n " ) ;
for ( int i = 0 ; i < description_lines . size ( ) ; i + + ) {
String description_line = description_lines [ i ] . strip_edges ( ) ;
if ( description_line . size ( ) ) {
p_output . push_back ( INDENT2 " /// " ) ;
p_output . push_back ( description_line . xml_escape ( ) ) ;
p_output . push_back ( " \n " ) ;
}
}
p_output . push_back ( INDENT2 " /// </summary> " ) ;
}
p_output . push_back ( MEMBER_BEGIN " public const int " ) ;
p_output . push_back ( iconstant . name ) ;
p_output . push_back ( " = " ) ;
p_output . push_back ( itos ( iconstant . value ) ) ;
p_output . push_back ( " ; " ) ;
}
if ( ! global_constants . empty ( ) )
p_output . push_back ( " \n " ) ;
p_output . push_back ( INDENT1 CLOSE_BLOCK ) ; // end of GD class
// Enums
for ( List < EnumInterface > : : Element * E = global_enums . front ( ) ; E ; E = E - > next ( ) ) {
const EnumInterface & ienum = E - > get ( ) ;
CRASH_COND ( ienum . constants . empty ( ) ) ;
String enum_proxy_name = ienum . cname . operator String ( ) ;
bool enum_in_static_class = false ;
if ( enum_proxy_name . find ( " . " ) > 0 ) {
enum_in_static_class = true ;
String enum_class_name = enum_proxy_name . get_slicec ( ' . ' , 0 ) ;
enum_proxy_name = enum_proxy_name . get_slicec ( ' . ' , 1 ) ;
CRASH_COND ( enum_class_name ! = " Variant " ) ; // Hard-coded...
if ( verbose_output ) {
WARN_PRINTS ( " Declaring global enum ` " + enum_proxy_name + " ` inside static class ` " + enum_class_name + " ` " ) ;
}
p_output . push_back ( " \n " INDENT1 " public static partial class " ) ;
p_output . push_back ( enum_class_name ) ;
p_output . push_back ( " \n " INDENT1 OPEN_BLOCK ) ;
}
p_output . push_back ( " \n " INDENT1 " public enum " ) ;
p_output . push_back ( enum_proxy_name ) ;
p_output . push_back ( " \n " INDENT1 OPEN_BLOCK ) ;
for ( const List < ConstantInterface > : : Element * E = ienum . constants . front ( ) ; E ; E = E - > next ( ) ) {
const ConstantInterface & iconstant = E - > get ( ) ;
if ( iconstant . const_doc & & iconstant . const_doc - > description . size ( ) ) {
p_output . push_back ( INDENT2 " /// <summary> \n " ) ;
Vector < String > description_lines = iconstant . const_doc - > description . split ( " \n " ) ;
for ( int i = 0 ; i < description_lines . size ( ) ; i + + ) {
String description_line = description_lines [ i ] . strip_edges ( ) ;
if ( description_line . size ( ) ) {
p_output . push_back ( INDENT2 " /// " ) ;
p_output . push_back ( description_line . xml_escape ( ) ) ;
p_output . push_back ( " \n " ) ;
}
}
p_output . push_back ( INDENT2 " /// </summary> \n " ) ;
}
String constant_name = iconstant . name ;
if ( ! ienum . prefix . empty ( ) & & constant_name . begins_with ( ienum . prefix ) ) {
constant_name = constant_name . substr ( ienum . prefix . length ( ) , constant_name . length ( ) ) ;
}
if ( constant_name [ 0 ] > = ' 0 ' & & constant_name [ 0 ] < = ' 9 ' ) {
// The name of enum constants may begin with a numeric digit when strip from the enum prefix,
// so we make the prefix one word shorter in those cases.
int i = 0 ;
for ( i = ienum . prefix . length ( ) - 1 ; i > = 0 ; i - - ) {
if ( ienum . prefix [ i ] > = ' A ' & & ienum . prefix [ i ] < = ' Z ' )
break ;
}
constant_name = ienum . prefix . substr ( i , ienum . prefix . length ( ) ) + constant_name ;
}
p_output . push_back ( INDENT2 ) ;
p_output . push_back ( constant_name ) ;
p_output . push_back ( " = " ) ;
p_output . push_back ( itos ( iconstant . value ) ) ;
p_output . push_back ( E ! = ienum . constants . back ( ) ? " , \n " : " \n " ) ;
}
p_output . push_back ( INDENT1 CLOSE_BLOCK ) ;
if ( enum_in_static_class )
p_output . push_back ( INDENT1 CLOSE_BLOCK ) ;
}
p_output . push_back ( CLOSE_BLOCK ) ; // end of namespace
}
2017-10-02 21:24:00 +00:00
Error BindingsGenerator : : generate_cs_core_project ( const String & p_output_dir , bool p_verbose_output ) {
verbose_output = p_verbose_output ;
DirAccessRef da = DirAccess : : create ( DirAccess : : ACCESS_FILESYSTEM ) ;
ERR_FAIL_COND_V ( ! da , ERR_CANT_CREATE ) ;
if ( ! DirAccess : : exists ( p_output_dir ) ) {
Error err = da - > make_dir_recursive ( p_output_dir ) ;
ERR_FAIL_COND_V ( err ! = OK , ERR_CANT_CREATE ) ;
}
da - > change_dir ( p_output_dir ) ;
da - > make_dir ( " Core " ) ;
da - > make_dir ( " ObjectType " ) ;
String core_dir = path_join ( p_output_dir , " Core " ) ;
String obj_type_dir = path_join ( p_output_dir , " ObjectType " ) ;
Vector < String > compile_items ;
NETSolution solution ( API_ASSEMBLY_NAME ) ;
if ( ! solution . set_path ( p_output_dir ) )
return ERR_FILE_NOT_FOUND ;
2017-12-24 02:17:48 +00:00
// Generate source file for global scope constants and enums
{
List < String > constants_source ;
_generate_global_constants ( constants_source ) ;
String output_file = path_join ( core_dir , BINDINGS_GLOBAL_SCOPE_CLASS " _constants.cs " ) ;
Error save_err = _save_file ( output_file , constants_source ) ;
if ( save_err ! = OK )
return save_err ;
compile_items . push_back ( output_file ) ;
}
2018-01-09 18:06:59 +00:00
for ( OrderedHashMap < StringName , TypeInterface > : : Element E = obj_types . front ( ) ; E ; E = E . next ( ) ) {
const TypeInterface & itype = E . get ( ) ;
2017-10-02 21:24:00 +00:00
if ( itype . api_type = = ClassDB : : API_EDITOR )
continue ;
2018-01-09 18:06:59 +00:00
String output_file = path_join ( obj_type_dir , itype . proxy_name + " .cs " ) ;
Error err = _generate_cs_type ( itype , output_file ) ;
2017-10-02 21:24:00 +00:00
if ( err = = ERR_SKIP )
continue ;
if ( err ! = OK )
return err ;
compile_items . push_back ( output_file ) ;
}
# define GENERATE_BUILTIN_TYPE(m_name) \
{ \
String output_file = path_join ( core_dir , # m_name " .cs " ) ; \
Error err = _generate_cs_type ( builtin_types [ # m_name ] , output_file ) ; \
if ( err ! = OK ) \
return err ; \
compile_items . push_back ( output_file ) ; \
}
GENERATE_BUILTIN_TYPE ( NodePath ) ;
GENERATE_BUILTIN_TYPE ( RID ) ;
# undef GENERATE_BUILTIN_TYPE
// Generate sources from compressed files
Map < String , CompressedFile > compressed_files ;
get_compressed_files ( compressed_files ) ;
for ( Map < String , CompressedFile > : : Element * E = compressed_files . front ( ) ; E ; E = E - > next ( ) ) {
const String & file_name = E - > key ( ) ;
const CompressedFile & file_data = E - > value ( ) ;
String output_file = path_join ( core_dir , file_name ) ;
Vector < uint8_t > data ;
data . resize ( file_data . uncompressed_size ) ;
2017-11-25 11:16:58 +00:00
Compression : : decompress ( data . ptrw ( ) , file_data . uncompressed_size , file_data . data , file_data . compressed_size , Compression : : MODE_DEFLATE ) ;
2017-10-02 21:24:00 +00:00
FileAccessRef file = FileAccess : : open ( output_file , FileAccess : : WRITE ) ;
ERR_FAIL_COND_V ( ! file , ERR_FILE_CANT_WRITE ) ;
file - > store_buffer ( data . ptr ( ) , data . size ( ) ) ;
file - > close ( ) ;
compile_items . push_back ( output_file ) ;
}
List < String > cs_icalls_content ;
cs_icalls_content . push_back ( " using System; \n "
" using System.Runtime.CompilerServices; \n "
" using System.Collections.Generic; \n "
" \n " ) ;
cs_icalls_content . push_back ( " namespace " BINDINGS_NAMESPACE " \n " OPEN_BLOCK ) ;
2018-02-22 12:13:51 +00:00
cs_icalls_content . push_back ( INDENT1 " internal static class " BINDINGS_CLASS_NATIVECALLS " \n " INDENT1 OPEN_BLOCK ) ;
cs_icalls_content . push_back ( INDENT2 " internal static ulong godot_api_hash = " ) ;
cs_icalls_content . push_back ( String : : num_uint64 ( GDMono : : get_singleton ( ) - > get_api_core_hash ( ) ) + " ; \n " ) ;
cs_icalls_content . push_back ( INDENT2 " internal static uint bindings_version = " ) ;
cs_icalls_content . push_back ( String : : num_uint64 ( BINDINGS_GENERATOR_VERSION ) + " ; \n " ) ;
cs_icalls_content . push_back ( INDENT2 " internal static uint cs_glue_version = " ) ;
cs_icalls_content . push_back ( String : : num_uint64 ( CS_GLUE_VERSION ) + " ; \n " ) ;
cs_icalls_content . push_back ( " \n " ) ;
2017-10-02 21:24:00 +00:00
# define ADD_INTERNAL_CALL(m_icall) \
if ( ! m_icall . editor_only ) { \
cs_icalls_content . push_back ( INDENT2 " [MethodImpl(MethodImplOptions.InternalCall)] \n " ) ; \
cs_icalls_content . push_back ( INDENT2 " internal extern static " ) ; \
cs_icalls_content . push_back ( m_icall . im_type_out + " " ) ; \
cs_icalls_content . push_back ( m_icall . name + " ( " ) ; \
cs_icalls_content . push_back ( m_icall . im_sig + " ); \n " ) ; \
}
for ( const List < InternalCall > : : Element * E = core_custom_icalls . front ( ) ; E ; E = E - > next ( ) )
ADD_INTERNAL_CALL ( E - > get ( ) ) ;
for ( const List < InternalCall > : : Element * E = method_icalls . front ( ) ; E ; E = E - > next ( ) )
ADD_INTERNAL_CALL ( E - > get ( ) ) ;
2018-01-25 22:44:37 +00:00
for ( const List < InternalCall > : : Element * E = builtin_method_icalls . front ( ) ; E ; E = E - > next ( ) )
ADD_INTERNAL_CALL ( E - > get ( ) ) ;
2017-10-02 21:24:00 +00:00
# undef ADD_INTERNAL_CALL
cs_icalls_content . push_back ( INDENT1 CLOSE_BLOCK CLOSE_BLOCK ) ;
2018-02-22 12:13:51 +00:00
String internal_methods_file = path_join ( core_dir , BINDINGS_CLASS_NATIVECALLS " .cs " ) ;
2017-10-02 21:24:00 +00:00
Error err = _save_file ( internal_methods_file , cs_icalls_content ) ;
if ( err ! = OK )
return err ;
compile_items . push_back ( internal_methods_file ) ;
String guid = CSharpProject : : generate_core_api_project ( p_output_dir , compile_items ) ;
solution . add_new_project ( API_ASSEMBLY_NAME , guid ) ;
Error sln_error = solution . save ( ) ;
if ( sln_error ! = OK ) {
ERR_PRINT ( " Could not to save .NET solution. " ) ;
return sln_error ;
}
2017-10-24 14:18:47 +00:00
if ( verbose_output )
2017-10-29 01:37:13 +00:00
OS : : get_singleton ( ) - > print ( " The solution and C# project for the Core API was generated successfully \n " ) ;
2017-10-24 14:18:47 +00:00
2017-10-02 21:24:00 +00:00
return OK ;
}
Error BindingsGenerator : : generate_cs_editor_project ( const String & p_output_dir , const String & p_core_dll_path , bool p_verbose_output ) {
verbose_output = p_verbose_output ;
DirAccessRef da = DirAccess : : create ( DirAccess : : ACCESS_FILESYSTEM ) ;
ERR_FAIL_COND_V ( ! da , ERR_CANT_CREATE ) ;
if ( ! DirAccess : : exists ( p_output_dir ) ) {
Error err = da - > make_dir_recursive ( p_output_dir ) ;
ERR_FAIL_COND_V ( err ! = OK , ERR_CANT_CREATE ) ;
}
da - > change_dir ( p_output_dir ) ;
da - > make_dir ( " Core " ) ;
da - > make_dir ( " ObjectType " ) ;
String core_dir = path_join ( p_output_dir , " Core " ) ;
String obj_type_dir = path_join ( p_output_dir , " ObjectType " ) ;
Vector < String > compile_items ;
NETSolution solution ( EDITOR_API_ASSEMBLY_NAME ) ;
if ( ! solution . set_path ( p_output_dir ) )
return ERR_FILE_NOT_FOUND ;
2018-01-09 18:06:59 +00:00
for ( OrderedHashMap < StringName , TypeInterface > : : Element E = obj_types . front ( ) ; E ; E = E . next ( ) ) {
const TypeInterface & itype = E . get ( ) ;
2017-10-02 21:24:00 +00:00
if ( itype . api_type ! = ClassDB : : API_EDITOR )
continue ;
2018-01-09 18:06:59 +00:00
String output_file = path_join ( obj_type_dir , itype . proxy_name + " .cs " ) ;
Error err = _generate_cs_type ( itype , output_file ) ;
2017-10-02 21:24:00 +00:00
if ( err = = ERR_SKIP )
continue ;
if ( err ! = OK )
return err ;
compile_items . push_back ( output_file ) ;
}
List < String > cs_icalls_content ;
cs_icalls_content . push_back ( " using System; \n "
" using System.Runtime.CompilerServices; \n "
" using System.Collections.Generic; \n "
" \n " ) ;
cs_icalls_content . push_back ( " namespace " BINDINGS_NAMESPACE " \n " OPEN_BLOCK ) ;
2018-02-22 12:13:51 +00:00
cs_icalls_content . push_back ( INDENT1 " internal static class " BINDINGS_CLASS_NATIVECALLS_EDITOR " \n " INDENT1 OPEN_BLOCK ) ;
cs_icalls_content . push_back ( INDENT2 " internal static ulong godot_api_hash = " ) ;
cs_icalls_content . push_back ( String : : num_uint64 ( GDMono : : get_singleton ( ) - > get_api_editor_hash ( ) ) + " ; \n " ) ;
cs_icalls_content . push_back ( INDENT2 " internal static uint bindings_version = " ) ;
cs_icalls_content . push_back ( String : : num_uint64 ( BINDINGS_GENERATOR_VERSION ) + " ; \n " ) ;
cs_icalls_content . push_back ( INDENT2 " internal static uint cs_glue_version = " ) ;
cs_icalls_content . push_back ( String : : num_uint64 ( CS_GLUE_VERSION ) + " ; \n " ) ;
cs_icalls_content . push_back ( " \n " ) ;
2017-10-02 21:24:00 +00:00
# define ADD_INTERNAL_CALL(m_icall) \
if ( m_icall . editor_only ) { \
cs_icalls_content . push_back ( INDENT2 " [MethodImpl(MethodImplOptions.InternalCall)] \n " ) ; \
cs_icalls_content . push_back ( INDENT2 " internal extern static " ) ; \
cs_icalls_content . push_back ( m_icall . im_type_out + " " ) ; \
cs_icalls_content . push_back ( m_icall . name + " ( " ) ; \
cs_icalls_content . push_back ( m_icall . im_sig + " ); \n " ) ; \
}
2018-01-25 22:44:37 +00:00
// No need to add builtin_method_icalls. Builtin types are core only
2017-10-02 21:24:00 +00:00
for ( const List < InternalCall > : : Element * E = editor_custom_icalls . front ( ) ; E ; E = E - > next ( ) )
ADD_INTERNAL_CALL ( E - > get ( ) ) ;
for ( const List < InternalCall > : : Element * E = method_icalls . front ( ) ; E ; E = E - > next ( ) )
ADD_INTERNAL_CALL ( E - > get ( ) ) ;
# undef ADD_INTERNAL_CALL
cs_icalls_content . push_back ( INDENT1 CLOSE_BLOCK CLOSE_BLOCK ) ;
2018-02-22 12:13:51 +00:00
String internal_methods_file = path_join ( core_dir , BINDINGS_CLASS_NATIVECALLS_EDITOR " .cs " ) ;
2017-10-02 21:24:00 +00:00
Error err = _save_file ( internal_methods_file , cs_icalls_content ) ;
if ( err ! = OK )
return err ;
compile_items . push_back ( internal_methods_file ) ;
String guid = CSharpProject : : generate_editor_api_project ( p_output_dir , p_core_dll_path , compile_items ) ;
solution . add_new_project ( EDITOR_API_ASSEMBLY_NAME , guid ) ;
Error sln_error = solution . save ( ) ;
if ( sln_error ! = OK ) {
ERR_PRINT ( " Could not to save .NET solution. " ) ;
return sln_error ;
}
2017-10-24 14:18:47 +00:00
if ( verbose_output )
2017-10-29 01:37:13 +00:00
OS : : get_singleton ( ) - > print ( " The solution and C# project for the Editor API was generated successfully \n " ) ;
2017-10-24 14:18:47 +00:00
2017-10-02 21:24:00 +00:00
return OK ;
}
// TODO: there are constants that hide inherited members. must explicitly use `new` to avoid warnings
// e.g.: warning CS0108: 'SpriteBase3D.FLAG_MAX' hides inherited member 'GeometryInstance.FLAG_MAX'. Use the new keyword if hiding was intended.
Error BindingsGenerator : : _generate_cs_type ( const TypeInterface & itype , const String & p_output_file ) {
2017-12-24 02:17:48 +00:00
bool is_derived_type = itype . base_name ! = StringName ( ) ;
2017-10-02 21:24:00 +00:00
List < InternalCall > & custom_icalls = itype . api_type = = ClassDB : : API_EDITOR ? editor_custom_icalls : core_custom_icalls ;
if ( verbose_output )
OS : : get_singleton ( ) - > print ( String ( " Generating " + itype . proxy_name + " .cs... \n " ) . utf8 ( ) ) ;
String ctor_method ( ICALL_PREFIX + itype . proxy_name + " _Ctor " ) ;
2017-10-29 01:37:13 +00:00
List < String > output ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( " using System; \n " ) ; // IntPtr
2017-10-02 21:24:00 +00:00
if ( itype . requires_collections )
2017-10-29 01:37:13 +00:00
output . push_back ( " using System.Collections.Generic; \n " ) ; // Dictionary
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( " \n namespace " BINDINGS_NAMESPACE " \n " OPEN_BLOCK ) ;
2017-10-02 21:24:00 +00:00
const DocData : : ClassDoc * class_doc = itype . class_doc ;
if ( class_doc & & class_doc - > description . size ( ) ) {
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT1 " /// <summary> \n " ) ;
2017-10-02 21:24:00 +00:00
Vector < String > description_lines = class_doc - > description . split ( " \n " ) ;
for ( int i = 0 ; i < description_lines . size ( ) ; i + + ) {
2017-12-24 02:17:48 +00:00
String description_line = description_lines [ i ] . strip_edges ( ) ;
if ( description_line . size ( ) ) {
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT1 " /// " ) ;
2017-12-24 02:17:48 +00:00
output . push_back ( description_line . xml_escape ( ) ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " \n " ) ;
2017-10-02 21:24:00 +00:00
}
}
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT1 " /// </summary> \n " ) ;
2017-10-02 21:24:00 +00:00
}
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT1 " public " ) ;
2018-03-03 19:25:21 +00:00
bool is_abstract = ! ClassDB : : can_instance ( itype . name ) & & ClassDB : : is_class_enabled ( itype . name ) ; // can_instance returns true if there's a constructor and the class is not 'disabled'
output . push_back ( itype . is_singleton ? " static class " : ( is_abstract ? " abstract class " : " class " ) ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( itype . proxy_name ) ;
2017-10-02 21:24:00 +00:00
2018-01-25 22:44:37 +00:00
if ( itype . is_singleton ) {
2017-10-29 01:37:13 +00:00
output . push_back ( " \n " ) ;
2018-01-25 22:44:37 +00:00
} else if ( ! is_derived_type | | ! itype . is_object_type /* assuming only object types inherit */ ) {
2017-10-29 01:37:13 +00:00
output . push_back ( " : IDisposable \n " ) ;
2017-10-02 21:24:00 +00:00
} else if ( obj_types . has ( itype . base_name ) ) {
2017-10-29 01:37:13 +00:00
output . push_back ( " : " ) ;
output . push_back ( obj_types [ itype . base_name ] . proxy_name ) ;
output . push_back ( " \n " ) ;
2017-10-02 21:24:00 +00:00
} else {
2017-12-24 02:17:48 +00:00
ERR_PRINTS ( " Base type ' " + itype . base_name . operator String ( ) + " ' does not exist, for class " + itype . name ) ;
2017-10-02 21:24:00 +00:00
return ERR_INVALID_DATA ;
}
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT1 " { " ) ;
2017-10-02 21:24:00 +00:00
if ( class_doc ) {
// Add constants
2017-12-24 02:17:48 +00:00
for ( const List < ConstantInterface > : : Element * E = itype . constants . front ( ) ; E ; E = E - > next ( ) ) {
const ConstantInterface & iconstant = E - > get ( ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
if ( iconstant . const_doc & & iconstant . const_doc - > description . size ( ) ) {
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " /// <summary> \n " ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
Vector < String > description_lines = iconstant . const_doc - > description . split ( " \n " ) ;
2017-10-02 21:24:00 +00:00
for ( int i = 0 ; i < description_lines . size ( ) ; i + + ) {
2017-12-24 02:17:48 +00:00
String description_line = description_lines [ i ] . strip_edges ( ) ;
if ( description_line . size ( ) ) {
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT2 " /// " ) ;
2017-12-24 02:17:48 +00:00
output . push_back ( description_line . xml_escape ( ) ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " \n " ) ;
2017-10-02 21:24:00 +00:00
}
}
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT2 " /// </summary> " ) ;
2017-10-02 21:24:00 +00:00
}
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " public const int " ) ;
2017-12-24 02:17:48 +00:00
output . push_back ( iconstant . name ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " = " ) ;
2017-12-24 02:17:48 +00:00
output . push_back ( itos ( iconstant . value ) ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " ; " ) ;
2017-10-02 21:24:00 +00:00
}
2017-12-24 02:17:48 +00:00
if ( itype . constants . size ( ) )
2017-10-29 01:37:13 +00:00
output . push_back ( " \n " ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
// Add enums
for ( const List < EnumInterface > : : Element * E = itype . enums . front ( ) ; E ; E = E - > next ( ) ) {
const EnumInterface & ienum = E - > get ( ) ;
ERR_FAIL_COND_V ( ienum . constants . empty ( ) , ERR_BUG ) ;
output . push_back ( MEMBER_BEGIN " public enum " ) ;
output . push_back ( ienum . cname . operator String ( ) ) ;
output . push_back ( MEMBER_BEGIN OPEN_BLOCK ) ;
for ( const List < ConstantInterface > : : Element * E = ienum . constants . front ( ) ; E ; E = E - > next ( ) ) {
const ConstantInterface & iconstant = E - > get ( ) ;
if ( iconstant . const_doc & & iconstant . const_doc - > description . size ( ) ) {
output . push_back ( INDENT3 " /// <summary> \n " ) ;
Vector < String > description_lines = iconstant . const_doc - > description . split ( " \n " ) ;
for ( int i = 0 ; i < description_lines . size ( ) ; i + + ) {
String description_line = description_lines [ i ] . strip_edges ( ) ;
if ( description_line . size ( ) ) {
output . push_back ( INDENT3 " /// " ) ;
output . push_back ( description_line . xml_escape ( ) ) ;
output . push_back ( " \n " ) ;
}
}
output . push_back ( INDENT3 " /// </summary> \n " ) ;
}
String constant_name = iconstant . name ;
if ( ! ienum . prefix . empty ( ) & & constant_name . begins_with ( ienum . prefix ) ) {
constant_name = constant_name . substr ( ienum . prefix . length ( ) , constant_name . length ( ) ) ;
}
if ( constant_name [ 0 ] > = ' 0 ' & & constant_name [ 0 ] < = ' 9 ' ) {
// The name of enum constants may begin with a numeric digit when strip from the enum prefix,
// so we make the prefix one word shorter in those cases.
int i = 0 ;
for ( i = ienum . prefix . length ( ) - 1 ; i > = 0 ; i - - ) {
if ( ienum . prefix [ i ] > = ' A ' & & ienum . prefix [ i ] < = ' Z ' )
break ;
}
constant_name = ienum . prefix . substr ( i , ienum . prefix . length ( ) ) + constant_name ;
}
output . push_back ( INDENT3 ) ;
output . push_back ( constant_name ) ;
output . push_back ( " = " ) ;
output . push_back ( itos ( iconstant . value ) ) ;
output . push_back ( E ! = ienum . constants . back ( ) ? " , \n " : " \n " ) ;
}
output . push_back ( INDENT2 CLOSE_BLOCK ) ;
}
if ( itype . enums . size ( ) )
output . push_back ( " \n " ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
// Add properties
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
for ( const List < PropertyInterface > : : Element * E = itype . properties . front ( ) ; E ; E = E - > next ( ) ) {
const PropertyInterface & iprop = E - > get ( ) ;
Error prop_err = _generate_cs_property ( itype , iprop , output ) ;
2017-10-29 01:37:13 +00:00
if ( prop_err ! = OK ) {
2017-12-24 02:17:48 +00:00
ERR_EXPLAIN ( " Failed to generate property ' " + iprop . cname . operator String ( ) +
" ' for class ' " + itype . name + " ' " ) ;
2017-10-29 01:37:13 +00:00
ERR_FAIL_V ( prop_err ) ;
2017-10-02 21:24:00 +00:00
}
}
if ( class_doc - > properties . size ( ) )
2017-10-29 01:37:13 +00:00
output . push_back ( " \n " ) ;
2017-10-02 21:24:00 +00:00
}
if ( ! itype . is_object_type ) {
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " private const string " BINDINGS_NATIVE_NAME_FIELD " = \" " + itype . name + " \" ; \n " ) ;
output . push_back ( MEMBER_BEGIN " private bool disposed = false; \n " ) ;
output . push_back ( MEMBER_BEGIN " internal IntPtr " BINDINGS_PTR_FIELD " ; \n " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " internal static IntPtr " CS_SMETHOD_GETINSTANCE " ( " ) ;
output . push_back ( itype . proxy_name ) ;
output . push_back ( " instance) \n " OPEN_BLOCK_L2 " return instance == null ? IntPtr.Zero : instance. " BINDINGS_PTR_FIELD " ; \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
// Add Destructor
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " ~ " ) ;
output . push_back ( itype . proxy_name ) ;
output . push_back ( " () \n " OPEN_BLOCK_L2 " Dispose(false); \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
// Add the Dispose from IDisposable
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " public void Dispose() \n " OPEN_BLOCK_L2 " Dispose(true); \n " INDENT3 " GC.SuppressFinalize(this); \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
// Add the virtual Dispose
2018-01-25 22:44:37 +00:00
output . push_back ( MEMBER_BEGIN " protected virtual void Dispose(bool disposing) \n " OPEN_BLOCK_L2
2017-10-29 09:11:20 +00:00
" if (disposed) return; \n " INDENT3
" if ( " BINDINGS_PTR_FIELD " != IntPtr.Zero) \n " OPEN_BLOCK_L3 " NativeCalls.godot_icall_ " ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( itype . proxy_name ) ;
output . push_back ( " _Dtor( " BINDINGS_PTR_FIELD " ); \n " INDENT5 BINDINGS_PTR_FIELD " = IntPtr.Zero; \n " CLOSE_BLOCK_L3 INDENT3
2017-10-29 09:11:20 +00:00
" GC.SuppressFinalize(this); \n " INDENT3 " disposed = true; \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " internal " ) ;
output . push_back ( itype . proxy_name ) ;
output . push_back ( " (IntPtr " BINDINGS_PTR_FIELD " ) \n " OPEN_BLOCK_L2 " this. " BINDINGS_PTR_FIELD " = " BINDINGS_PTR_FIELD " ; \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " public IntPtr NativeInstance \n " OPEN_BLOCK_L2
2017-10-29 09:11:20 +00:00
" get { return " BINDINGS_PTR_FIELD " ; } \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
} else if ( itype . is_singleton ) {
// Add the type name and the singleton pointer as static fields
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " private const string " BINDINGS_NATIVE_NAME_FIELD " = \" " ) ;
output . push_back ( itype . name ) ;
output . push_back ( " \" ; \n " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT2 " internal static IntPtr " BINDINGS_PTR_FIELD " = " ) ;
2018-02-22 12:13:51 +00:00
output . push_back ( itype . api_type = = ClassDB : : API_EDITOR ? BINDINGS_CLASS_NATIVECALLS_EDITOR : BINDINGS_CLASS_NATIVECALLS ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " . " ICALL_PREFIX ) ;
output . push_back ( itype . name ) ;
output . push_back ( SINGLETON_ICALL_SUFFIX " (); \n " ) ;
2017-10-02 21:24:00 +00:00
} else {
// Add member fields
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " private const string " BINDINGS_NATIVE_NAME_FIELD " = \" " ) ;
output . push_back ( itype . name ) ;
output . push_back ( " \" ; \n " ) ;
2017-10-02 21:24:00 +00:00
// Only the base class stores the pointer to the native object
// This pointer is expected to be and must be of type Object*
if ( ! is_derived_type ) {
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " private bool disposed = false; \n " ) ;
output . push_back ( INDENT2 " internal IntPtr " BINDINGS_PTR_FIELD " ; \n " ) ;
output . push_back ( INDENT2 " internal bool " CS_FIELD_MEMORYOWN " ; \n " ) ;
2017-10-02 21:24:00 +00:00
}
// Add default constructor
if ( itype . is_instantiable ) {
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " public " ) ;
output . push_back ( itype . proxy_name ) ;
output . push_back ( " () : this( " ) ;
output . push_back ( itype . memory_own ? " true " : " false " ) ;
2017-10-02 21:24:00 +00:00
// The default constructor may also be called by the engine when instancing existing native objects
// The engine will initialize the pointer field of the managed side before calling the constructor
// This is why we only allocate a new native object from the constructor if the pointer field is not set
2017-10-29 01:37:13 +00:00
output . push_back ( " ) \n " OPEN_BLOCK_L2 " if ( " BINDINGS_PTR_FIELD " == IntPtr.Zero) \n " INDENT4 BINDINGS_PTR_FIELD " = " ) ;
2018-02-22 12:13:51 +00:00
output . push_back ( itype . api_type = = ClassDB : : API_EDITOR ? BINDINGS_CLASS_NATIVECALLS_EDITOR : BINDINGS_CLASS_NATIVECALLS ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " . " + ctor_method ) ;
output . push_back ( " (this); \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
} else {
// Hide the constructor
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " internal " ) ;
output . push_back ( itype . proxy_name ) ;
output . push_back ( " () {} \n " ) ;
2017-10-02 21:24:00 +00:00
}
// Add.. em.. trick constructor. Sort of.
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " internal " ) ;
output . push_back ( itype . proxy_name ) ;
2017-10-02 21:24:00 +00:00
if ( is_derived_type ) {
2017-10-29 01:37:13 +00:00
output . push_back ( " (bool " CS_FIELD_MEMORYOWN " ) : base( " CS_FIELD_MEMORYOWN " ) {} \n " ) ;
2017-10-02 21:24:00 +00:00
} else {
2017-10-29 01:37:13 +00:00
output . push_back ( " (bool " CS_FIELD_MEMORYOWN " ) \n " OPEN_BLOCK_L2
2017-10-29 09:11:20 +00:00
" this. " CS_FIELD_MEMORYOWN " = " CS_FIELD_MEMORYOWN " ; \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
}
// Add methods
if ( ! is_derived_type ) {
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " public IntPtr NativeInstance \n " OPEN_BLOCK_L2
2017-10-29 09:11:20 +00:00
" get { return " BINDINGS_PTR_FIELD " ; } \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " internal static IntPtr " CS_SMETHOD_GETINSTANCE " (Object instance) \n " OPEN_BLOCK_L2
2017-10-29 09:11:20 +00:00
" return instance == null ? IntPtr.Zero : instance. " BINDINGS_PTR_FIELD " ; \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
}
if ( ! is_derived_type ) {
// Add destructor
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " ~ " ) ;
output . push_back ( itype . proxy_name ) ;
output . push_back ( " () \n " OPEN_BLOCK_L2 " Dispose(false); \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
// Add the Dispose from IDisposable
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " public void Dispose() \n " OPEN_BLOCK_L2 " Dispose(true); \n " INDENT3 " GC.SuppressFinalize(this); \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
// Add the virtual Dispose
2018-01-25 22:44:37 +00:00
output . push_back ( MEMBER_BEGIN " protected virtual void Dispose(bool disposing) \n " OPEN_BLOCK_L2
2017-10-29 09:11:20 +00:00
" if (disposed) return; \n " INDENT3
" if ( " BINDINGS_PTR_FIELD " != IntPtr.Zero) \n " OPEN_BLOCK_L3
" if ( " CS_FIELD_MEMORYOWN " ) \n " OPEN_BLOCK_L4 CS_FIELD_MEMORYOWN
2018-02-22 12:13:51 +00:00
" = false; \n " INDENT5 BINDINGS_CLASS_NATIVECALLS " . " ICALL_OBJECT_DTOR
2017-12-31 21:37:57 +00:00
" (this, " BINDINGS_PTR_FIELD " ); \n " CLOSE_BLOCK_L4 CLOSE_BLOCK_L3 INDENT3
" this. " BINDINGS_PTR_FIELD " = IntPtr.Zero; \n " INDENT3
2017-10-29 09:11:20 +00:00
" GC.SuppressFinalize(this); \n " INDENT3 " disposed = true; \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
Map < StringName , TypeInterface > : : Element * array_itype = builtin_types . find ( name_cache . type_Array ) ;
2017-10-02 21:24:00 +00:00
if ( ! array_itype ) {
ERR_PRINT ( " BUG: Array type interface not found! " ) ;
return ERR_BUG ;
}
2018-01-09 18:06:59 +00:00
OrderedHashMap < StringName , TypeInterface > : : Element object_itype = obj_types . find ( " Object " ) ;
2017-10-02 21:24:00 +00:00
if ( ! object_itype ) {
2017-10-29 01:37:13 +00:00
ERR_PRINT ( " BUG: Object type interface not found! " ) ;
2017-10-02 21:24:00 +00:00
return ERR_BUG ;
}
2017-10-29 01:37:13 +00:00
output . push_back ( MEMBER_BEGIN " public " CS_CLASS_SIGNALAWAITER " ToSignal( " ) ;
2018-01-09 18:06:59 +00:00
output . push_back ( object_itype . get ( ) . cs_type ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " source, string signal) \n " OPEN_BLOCK_L2
2017-10-29 09:11:20 +00:00
" return new " CS_CLASS_SIGNALAWAITER " (source, signal, this); \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
}
}
2017-12-24 02:17:48 +00:00
Map < StringName , String > : : Element * extra_member = extra_members . find ( itype . cname ) ;
2017-10-02 21:24:00 +00:00
if ( extra_member )
2017-10-29 01:37:13 +00:00
output . push_back ( extra_member - > get ( ) ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
int method_bind_count = 0 ;
2017-10-02 21:24:00 +00:00
for ( const List < MethodInterface > : : Element * E = itype . methods . front ( ) ; E ; E = E - > next ( ) ) {
const MethodInterface & imethod = E - > get ( ) ;
2017-10-29 01:37:13 +00:00
Error method_err = _generate_cs_method ( itype , imethod , method_bind_count , output ) ;
if ( method_err ! = OK ) {
ERR_EXPLAIN ( " Failed to generate method ' " + imethod . name + " ' for class ' " + itype . name + " ' " ) ;
ERR_FAIL_V ( method_err ) ;
}
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( itype . is_singleton ) {
InternalCall singleton_icall = InternalCall ( itype . api_type , ICALL_PREFIX + itype . name + SINGLETON_ICALL_SUFFIX , " IntPtr " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( ! find_icall_by_name ( singleton_icall . name , custom_icalls ) )
custom_icalls . push_back ( singleton_icall ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( itype . is_instantiable ) {
InternalCall ctor_icall = InternalCall ( itype . api_type , ctor_method , " IntPtr " , itype . proxy_name + " obj " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( ! find_icall_by_name ( ctor_icall . name , custom_icalls ) )
custom_icalls . push_back ( ctor_icall ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( INDENT1 CLOSE_BLOCK CLOSE_BLOCK ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
return _save_file ( p_output_file , output ) ;
}
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
Error BindingsGenerator : : _generate_cs_property ( const BindingsGenerator : : TypeInterface & p_itype , const PropertyInterface & p_iprop , List < String > & p_output ) {
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
const MethodInterface * setter = p_itype . find_method_by_name ( p_iprop . setter ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
// Search it in base types too
const TypeInterface * current_type = & p_itype ;
2017-12-24 02:17:48 +00:00
while ( ! setter & & current_type - > base_name ! = StringName ( ) ) {
2018-01-09 18:06:59 +00:00
OrderedHashMap < StringName , TypeInterface > : : Element base_match = obj_types . find ( current_type - > base_name ) ;
ERR_FAIL_COND_V ( ! base_match , ERR_BUG ) ;
current_type = & base_match . get ( ) ;
2017-12-24 02:17:48 +00:00
setter = current_type - > find_method_by_name ( p_iprop . setter ) ;
2017-10-29 01:37:13 +00:00
}
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
const MethodInterface * getter = p_itype . find_method_by_name ( p_iprop . getter ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
// Search it in base types too
current_type = & p_itype ;
2017-12-24 02:17:48 +00:00
while ( ! getter & & current_type - > base_name ! = StringName ( ) ) {
2018-01-09 18:06:59 +00:00
OrderedHashMap < StringName , TypeInterface > : : Element base_match = obj_types . find ( current_type - > base_name ) ;
ERR_FAIL_COND_V ( ! base_match , ERR_BUG ) ;
current_type = & base_match . get ( ) ;
2017-12-24 02:17:48 +00:00
getter = current_type - > find_method_by_name ( p_iprop . getter ) ;
2017-10-29 01:37:13 +00:00
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
ERR_FAIL_COND_V ( ! setter & & ! getter , ERR_BUG ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( setter ) {
2017-12-24 02:17:48 +00:00
int setter_argc = p_iprop . index ! = - 1 ? 2 : 1 ;
2017-10-29 01:37:13 +00:00
ERR_FAIL_COND_V ( setter - > arguments . size ( ) ! = setter_argc , ERR_BUG ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( getter ) {
2017-12-24 02:17:48 +00:00
int getter_argc = p_iprop . index ! = - 1 ? 1 : 0 ;
2017-10-29 01:37:13 +00:00
ERR_FAIL_COND_V ( getter - > arguments . size ( ) ! = getter_argc , ERR_BUG ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( getter & & setter ) {
ERR_FAIL_COND_V ( getter - > return_type ! = setter - > arguments . back ( ) - > get ( ) . type , ERR_BUG ) ;
}
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
StringName proptype_name = getter ? getter - > return_type : setter - > arguments . back ( ) - > get ( ) . type ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
const TypeInterface * prop_itype = _get_type_by_name_or_null ( proptype_name ) ;
2017-12-24 02:17:48 +00:00
ERR_FAIL_NULL_V ( prop_itype , ERR_BUG ) ; // Property type not found
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
String prop_proxy_name = escape_csharp_keyword ( snake_to_pascal_case ( p_iprop . cname ) ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
// Prevent property and enclosing type from sharing the same name
if ( prop_proxy_name = = p_itype . proxy_name ) {
if ( verbose_output ) {
WARN_PRINTS ( " Name of property ` " + prop_proxy_name + " ` is ambiguous with the name of its class ` " +
p_itype . proxy_name + " `. Renaming property to ` " + prop_proxy_name + " _` " ) ;
2017-10-02 21:24:00 +00:00
}
2017-10-29 01:37:13 +00:00
prop_proxy_name + = " _ " ;
}
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
if ( p_iprop . prop_doc & & p_iprop . prop_doc - > description . size ( ) ) {
2017-10-29 01:37:13 +00:00
p_output . push_back ( MEMBER_BEGIN " /// <summary> \n " ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
Vector < String > description_lines = p_iprop . prop_doc - > description . split ( " \n " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
for ( int i = 0 ; i < description_lines . size ( ) ; i + + ) {
2017-12-24 02:17:48 +00:00
String description_line = description_lines [ i ] . strip_edges ( ) ;
if ( description_line . size ( ) ) {
2017-10-29 01:37:13 +00:00
p_output . push_back ( INDENT2 " /// " ) ;
2017-12-24 02:17:48 +00:00
p_output . push_back ( description_line . xml_escape ( ) ) ;
2017-10-29 01:37:13 +00:00
p_output . push_back ( " \n " ) ;
}
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( INDENT2 " /// </summary> " ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( MEMBER_BEGIN " public " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( p_itype . is_singleton )
p_output . push_back ( " static " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( prop_itype - > cs_type ) ;
p_output . push_back ( " " ) ;
p_output . push_back ( prop_proxy_name . replace ( " / " , " __ " ) ) ;
p_output . push_back ( " \n " INDENT2 OPEN_BLOCK ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( getter ) {
p_output . push_back ( INDENT3 " get \n " OPEN_BLOCK_L3 ) ;
p_output . push_back ( " return " ) ;
p_output . push_back ( getter - > proxy_name + " ( " ) ;
2017-12-24 02:17:48 +00:00
if ( p_iprop . index ! = - 1 ) {
const ArgumentInterface & idx_arg = getter - > arguments . front ( ) - > get ( ) ;
if ( idx_arg . type ! = name_cache . type_int ) {
// Assume the index parameter is an enum
const TypeInterface * idx_arg_type = _get_type_by_name_or_null ( idx_arg . type ) ;
CRASH_COND ( idx_arg_type = = NULL ) ;
p_output . push_back ( " ( " + idx_arg_type - > proxy_name + " ) " + itos ( p_iprop . index ) ) ;
} else {
p_output . push_back ( itos ( p_iprop . index ) ) ;
}
}
2017-10-29 01:37:13 +00:00
p_output . push_back ( " ); \n " CLOSE_BLOCK_L3 ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( setter ) {
p_output . push_back ( INDENT3 " set \n " OPEN_BLOCK_L3 ) ;
p_output . push_back ( setter - > proxy_name + " ( " ) ;
2017-12-24 02:17:48 +00:00
if ( p_iprop . index ! = - 1 ) {
const ArgumentInterface & idx_arg = setter - > arguments . front ( ) - > get ( ) ;
if ( idx_arg . type ! = name_cache . type_int ) {
// Assume the index parameter is an enum
const TypeInterface * idx_arg_type = _get_type_by_name_or_null ( idx_arg . type ) ;
CRASH_COND ( idx_arg_type = = NULL ) ;
p_output . push_back ( " ( " + idx_arg_type - > proxy_name + " ) " + itos ( p_iprop . index ) + " , " ) ;
} else {
p_output . push_back ( itos ( p_iprop . index ) + " , " ) ;
}
}
2017-10-29 01:37:13 +00:00
p_output . push_back ( " value); \n " CLOSE_BLOCK_L3 ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
return OK ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
Error BindingsGenerator : : _generate_cs_method ( const BindingsGenerator : : TypeInterface & p_itype , const BindingsGenerator : : MethodInterface & p_imethod , int & p_method_bind_count , List < String > & p_output ) {
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
const TypeInterface * return_type = _get_type_by_name_or_placeholder ( p_imethod . return_type ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
String method_bind_field = " method_bind_ " + itos ( p_method_bind_count ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
String arguments_sig ;
String cs_in_statements ;
2017-10-02 21:24:00 +00:00
2018-01-25 22:44:37 +00:00
String icall_params ;
if ( p_itype . is_object_type )
icall_params + = method_bind_field + " , " ;
icall_params + = sformat ( p_itype . cs_in , " this " ) ;
2017-10-29 01:37:13 +00:00
List < String > default_args_doc ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
// Retrieve information from the arguments
for ( const List < ArgumentInterface > : : Element * F = p_imethod . arguments . front ( ) ; F ; F = F - > next ( ) ) {
const ArgumentInterface & iarg = F - > get ( ) ;
const TypeInterface * arg_type = _get_type_by_name_or_placeholder ( iarg . type ) ;
// Add the current arguments to the signature
// If the argument has a default value which is not a constant, we will make it Nullable
{
if ( F ! = p_imethod . arguments . front ( ) )
arguments_sig + = " , " ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( iarg . def_param_mode = = ArgumentInterface : : NULLABLE_VAL )
arguments_sig + = " Nullable< " ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
arguments_sig + = arg_type - > cs_type ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( iarg . def_param_mode = = ArgumentInterface : : NULLABLE_VAL )
arguments_sig + = " > " ;
else
arguments_sig + = " " ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
arguments_sig + = iarg . name ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( iarg . default_argument . size ( ) ) {
if ( iarg . def_param_mode ! = ArgumentInterface : : CONSTANT )
arguments_sig + = " = null " ;
else
arguments_sig + = " = " + sformat ( iarg . default_argument , arg_type - > cs_type ) ;
2017-10-02 21:24:00 +00:00
}
}
2017-10-29 01:37:13 +00:00
icall_params + = " , " ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( iarg . default_argument . size ( ) & & iarg . def_param_mode ! = ArgumentInterface : : CONSTANT ) {
// The default value of an argument must be constant. Otherwise we make it Nullable and do the following:
// Type arg_in = arg.HasValue ? arg.Value : <non-const default value>;
String arg_in = iarg . name ;
arg_in + = " _in " ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
cs_in_statements + = arg_type - > cs_type ;
cs_in_statements + = " " ;
cs_in_statements + = arg_in ;
cs_in_statements + = " = " ;
cs_in_statements + = iarg . name ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( iarg . def_param_mode = = ArgumentInterface : : NULLABLE_VAL )
cs_in_statements + = " .HasValue ? " ;
else
cs_in_statements + = " != null ? " ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
cs_in_statements + = iarg . name ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( iarg . def_param_mode = = ArgumentInterface : : NULLABLE_VAL )
cs_in_statements + = " .Value : " ;
else
cs_in_statements + = " : " ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
String def_arg = sformat ( iarg . default_argument , arg_type - > cs_type ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
cs_in_statements + = def_arg ;
cs_in_statements + = " ; \n " INDENT3 ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
icall_params + = arg_type - > cs_in . empty ( ) ? arg_in : sformat ( arg_type - > cs_in , arg_in ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
default_args_doc . push_back ( INDENT2 " /// <param name= \" " + iarg . name + " \" >If the param is null, then the default value is " + def_arg + " </param> \n " ) ;
} else {
icall_params + = arg_type - > cs_in . empty ( ) ? iarg . name : sformat ( arg_type - > cs_in , iarg . name ) ;
}
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
// Generate method
{
2018-01-25 22:44:37 +00:00
if ( p_itype . is_object_type & & ! p_imethod . is_virtual & & ! p_imethod . requires_object_call ) {
2018-01-27 21:45:57 +00:00
p_output . push_back ( MEMBER_BEGIN " private static IntPtr " ) ;
2018-02-22 12:13:51 +00:00
p_output . push_back ( method_bind_field + " = " BINDINGS_CLASS_NATIVECALLS " . " ICALL_GET_METHODBIND " ( " BINDINGS_NATIVE_NAME_FIELD " , \" " ) ;
2017-10-29 01:37:13 +00:00
p_output . push_back ( p_imethod . name ) ;
p_output . push_back ( " \" ); \n " ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( p_imethod . method_doc & & p_imethod . method_doc - > description . size ( ) ) {
p_output . push_back ( MEMBER_BEGIN " /// <summary> \n " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
Vector < String > description_lines = p_imethod . method_doc - > description . split ( " \n " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
for ( int i = 0 ; i < description_lines . size ( ) ; i + + ) {
2017-12-24 02:17:48 +00:00
String description_line = description_lines [ i ] . strip_edges ( ) ;
if ( description_line . size ( ) ) {
2017-10-29 01:37:13 +00:00
p_output . push_back ( INDENT2 " /// " ) ;
2017-12-24 02:17:48 +00:00
p_output . push_back ( description_line . xml_escape ( ) ) ;
2017-10-29 01:37:13 +00:00
p_output . push_back ( " \n " ) ;
}
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
for ( List < String > : : Element * E = default_args_doc . front ( ) ; E ; E = E - > next ( ) ) {
p_output . push_back ( E - > get ( ) . xml_escape ( ) ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( INDENT2 " /// </summary> " ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( ! p_imethod . is_internal ) {
p_output . push_back ( MEMBER_BEGIN " [GodotMethod( \" " ) ;
p_output . push_back ( p_imethod . name ) ;
p_output . push_back ( " \" )] " ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( MEMBER_BEGIN ) ;
p_output . push_back ( p_imethod . is_internal ? " internal " : " public " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( p_itype . is_singleton ) {
p_output . push_back ( " static " ) ;
} else if ( p_imethod . is_virtual ) {
p_output . push_back ( " virtual " ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( return_type - > cs_type + " " ) ;
p_output . push_back ( p_imethod . proxy_name + " ( " ) ;
p_output . push_back ( arguments_sig + " ) \n " OPEN_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( p_imethod . is_virtual ) {
// Godot virtual method must be overridden, therefore we return a default value by default.
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
if ( return_type - > cname = = name_cache . type_void ) {
2017-10-29 01:37:13 +00:00
p_output . push_back ( " return; \n " CLOSE_BLOCK_L2 ) ;
} else {
p_output . push_back ( " return default( " ) ;
p_output . push_back ( return_type - > cs_type ) ;
p_output . push_back ( " ); \n " CLOSE_BLOCK_L2 ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
return OK ; // Won't increment method bind count
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( p_imethod . requires_object_call ) {
// Fallback to Godot's object.Call(string, params)
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( CS_METHOD_CALL " ( \" " ) ;
p_output . push_back ( p_imethod . name ) ;
p_output . push_back ( " \" " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
for ( const List < ArgumentInterface > : : Element * F = p_imethod . arguments . front ( ) ; F ; F = F - > next ( ) ) {
p_output . push_back ( " , " ) ;
p_output . push_back ( F - > get ( ) . name ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( " ); \n " CLOSE_BLOCK_L2 ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
return OK ; // Won't increment method bind count
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
const Map < const MethodInterface * , const InternalCall * > : : Element * match = method_icalls_map . find ( & p_imethod ) ;
ERR_FAIL_NULL_V ( match , ERR_BUG ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
const InternalCall * im_icall = match - > value ( ) ;
2017-10-02 21:24:00 +00:00
2018-02-22 12:13:51 +00:00
String im_call = im_icall - > editor_only ? BINDINGS_CLASS_NATIVECALLS_EDITOR : BINDINGS_CLASS_NATIVECALLS ;
2017-10-29 01:37:13 +00:00
im_call + = " . " + im_icall - > name + " ( " + icall_params + " ); \n " ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
if ( p_imethod . arguments . size ( ) )
p_output . push_back ( cs_in_statements ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
if ( return_type - > cname = = name_cache . type_void ) {
2017-10-29 01:37:13 +00:00
p_output . push_back ( im_call ) ;
} else if ( return_type - > cs_out . empty ( ) ) {
p_output . push_back ( " return " + im_call ) ;
} else {
p_output . push_back ( return_type - > im_type_out ) ;
p_output . push_back ( " " LOCAL_RET " = " ) ;
p_output . push_back ( im_call ) ;
p_output . push_back ( INDENT3 ) ;
p_output . push_back ( sformat ( return_type - > cs_out , LOCAL_RET ) + " \n " ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_output . push_back ( CLOSE_BLOCK_L2 ) ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
p_method_bind_count + + ;
return OK ;
}
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
Error BindingsGenerator : : generate_glue ( const String & p_output_dir ) {
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
verbose_output = true ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
bool dir_exists = DirAccess : : exists ( p_output_dir ) ;
ERR_EXPLAIN ( " The output directory does not exist. " ) ;
ERR_FAIL_COND_V ( ! dir_exists , ERR_FILE_BAD_PATH ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
List < String > output ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( " #include \" " GLUE_HEADER_FILE " \" \n "
2017-10-29 09:11:20 +00:00
" \n " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
generated_icall_funcs . clear ( ) ;
2017-10-02 21:24:00 +00:00
2018-01-09 18:06:59 +00:00
for ( OrderedHashMap < StringName , TypeInterface > : : Element type_elem = obj_types . front ( ) ; type_elem ; type_elem = type_elem . next ( ) ) {
const TypeInterface & itype = type_elem . get ( ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
List < InternalCall > & custom_icalls = itype . api_type = = ClassDB : : API_EDITOR ? editor_custom_icalls : core_custom_icalls ;
OS : : get_singleton ( ) - > print ( String ( " Generating " + itype . name + " ... \n " ) . utf8 ( ) ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
String ctor_method ( ICALL_PREFIX + itype . proxy_name + " _Ctor " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
for ( const List < MethodInterface > : : Element * E = itype . methods . front ( ) ; E ; E = E - > next ( ) ) {
const MethodInterface & imethod = E - > get ( ) ;
Error method_err = _generate_glue_method ( itype , imethod , output ) ;
if ( method_err ! = OK ) {
ERR_EXPLAIN ( " Failed to generate method ' " + imethod . name + " ' for class ' " + itype . name + " ' " ) ;
ERR_FAIL_V ( method_err ) ;
2017-10-02 21:24:00 +00:00
}
}
if ( itype . is_singleton ) {
String singleton_icall_name = ICALL_PREFIX + itype . name + SINGLETON_ICALL_SUFFIX ;
InternalCall singleton_icall = InternalCall ( itype . api_type , singleton_icall_name , " IntPtr " ) ;
if ( ! find_icall_by_name ( singleton_icall . name , custom_icalls ) )
custom_icalls . push_back ( singleton_icall ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " Object* " ) ;
output . push_back ( singleton_icall_name ) ;
2017-11-13 20:46:57 +00:00
output . push_back ( " () " OPEN_BLOCK " \t return Engine::get_singleton()->get_singleton_object( \" " ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( itype . proxy_name ) ;
output . push_back ( " \" ); \n " CLOSE_BLOCK " \n " ) ;
2017-10-02 21:24:00 +00:00
}
if ( itype . is_instantiable ) {
InternalCall ctor_icall = InternalCall ( itype . api_type , ctor_method , " IntPtr " , itype . proxy_name + " obj " ) ;
if ( ! find_icall_by_name ( ctor_icall . name , custom_icalls ) )
custom_icalls . push_back ( ctor_icall ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " Object* " ) ;
output . push_back ( ctor_method ) ;
output . push_back ( " (MonoObject* obj) " OPEN_BLOCK
2017-10-29 09:11:20 +00:00
" \t " C_MACRO_OBJECT_CONSTRUCT " (instance, \" " ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( itype . name ) ;
output . push_back ( " \" ); \n "
2017-10-29 09:11:20 +00:00
" \t " C_METHOD_TIE_MANAGED_TO_UNMANAGED " (obj, instance); \n "
" \t return instance; \n " CLOSE_BLOCK " \n " ) ;
2017-10-02 21:24:00 +00:00
}
}
2017-10-29 01:37:13 +00:00
output . push_back ( " namespace GodotSharpBindings \n " OPEN_BLOCK ) ;
2018-02-22 12:13:51 +00:00
2017-10-29 01:37:13 +00:00
output . push_back ( " uint64_t get_core_api_hash() { return " ) ;
2018-02-22 12:13:51 +00:00
output . push_back ( String : : num_uint64 ( GDMono : : get_singleton ( ) - > get_api_core_hash ( ) ) + " ; } \n " ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " #ifdef TOOLS_ENABLED \n "
2017-10-29 09:11:20 +00:00
" uint64_t get_editor_api_hash() { return " ) ;
2018-02-22 12:13:51 +00:00
output . push_back ( String : : num_uint64 ( GDMono : : get_singleton ( ) - > get_api_editor_hash ( ) ) +
2017-10-29 09:11:20 +00:00
" ; } \n #endif // TOOLS_ENABLED \n " ) ;
2018-02-22 12:13:51 +00:00
output . push_back ( " uint32_t get_bindings_version() { return " ) ;
output . push_back ( String : : num_uint64 ( BINDINGS_GENERATOR_VERSION ) + " ; } \n " ) ;
output . push_back ( " uint32_t get_cs_glue_version() { return " ) ;
output . push_back ( String : : num_uint64 ( CS_GLUE_VERSION ) + " ; } \n " ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " void register_generated_icalls() " OPEN_BLOCK ) ;
2018-01-25 22:44:37 +00:00
output . push_back ( " \t godot_register_header_icalls(); " ) ;
2017-10-02 21:24:00 +00:00
2018-02-22 12:13:51 +00:00
# define ADD_INTERNAL_CALL_REGISTRATION(m_icall) \
{ \
output . push_back ( " \t mono_add_internal_call( " ) ; \
output . push_back ( " \" " BINDINGS_NAMESPACE " . " ) ; \
output . push_back ( m_icall . editor_only ? BINDINGS_CLASS_NATIVECALLS_EDITOR : BINDINGS_CLASS_NATIVECALLS ) ; \
output . push_back ( " :: " ) ; \
output . push_back ( m_icall . name ) ; \
output . push_back ( " \" , (void*) " ) ; \
output . push_back ( m_icall . name ) ; \
output . push_back ( " ); \n " ) ; \
2017-10-02 21:24:00 +00:00
}
bool tools_sequence = false ;
for ( const List < InternalCall > : : Element * E = core_custom_icalls . front ( ) ; E ; E = E - > next ( ) ) {
if ( tools_sequence ) {
if ( ! E - > get ( ) . editor_only ) {
tools_sequence = false ;
2017-10-29 01:37:13 +00:00
output . push_back ( " #endif \n " ) ;
2017-10-02 21:24:00 +00:00
}
} else {
if ( E - > get ( ) . editor_only ) {
2017-10-29 01:37:13 +00:00
output . push_back ( " #ifdef TOOLS_ENABLED \n " ) ;
2017-10-02 21:24:00 +00:00
tools_sequence = true ;
}
}
ADD_INTERNAL_CALL_REGISTRATION ( E - > get ( ) ) ;
}
if ( tools_sequence ) {
tools_sequence = false ;
2017-10-29 01:37:13 +00:00
output . push_back ( " #endif \n " ) ;
2017-10-02 21:24:00 +00:00
}
2017-10-29 01:37:13 +00:00
output . push_back ( " #ifdef TOOLS_ENABLED \n " ) ;
2017-10-02 21:24:00 +00:00
for ( const List < InternalCall > : : Element * E = editor_custom_icalls . front ( ) ; E ; E = E - > next ( ) )
ADD_INTERNAL_CALL_REGISTRATION ( E - > get ( ) ) ;
2017-10-29 01:37:13 +00:00
output . push_back ( " #endif // TOOLS_ENABLED \n " ) ;
2017-10-02 21:24:00 +00:00
for ( const List < InternalCall > : : Element * E = method_icalls . front ( ) ; E ; E = E - > next ( ) ) {
if ( tools_sequence ) {
if ( ! E - > get ( ) . editor_only ) {
tools_sequence = false ;
2017-10-29 01:37:13 +00:00
output . push_back ( " #endif \n " ) ;
2017-10-02 21:24:00 +00:00
}
} else {
if ( E - > get ( ) . editor_only ) {
2017-10-29 01:37:13 +00:00
output . push_back ( " #ifdef TOOLS_ENABLED \n " ) ;
2017-10-02 21:24:00 +00:00
tools_sequence = true ;
}
}
ADD_INTERNAL_CALL_REGISTRATION ( E - > get ( ) ) ;
}
if ( tools_sequence ) {
tools_sequence = false ;
2017-10-29 01:37:13 +00:00
output . push_back ( " #endif \n " ) ;
2017-10-02 21:24:00 +00:00
}
2018-01-25 22:44:37 +00:00
for ( const List < InternalCall > : : Element * E = builtin_method_icalls . front ( ) ; E ; E = E - > next ( ) )
ADD_INTERNAL_CALL_REGISTRATION ( E - > get ( ) ) ;
2017-10-02 21:24:00 +00:00
# undef ADD_INTERNAL_CALL_REGISTRATION
2017-10-29 01:37:13 +00:00
output . push_back ( CLOSE_BLOCK " } \n " ) ;
2017-10-02 21:24:00 +00:00
2017-10-29 01:37:13 +00:00
Error save_err = _save_file ( path_join ( p_output_dir , " mono_glue.gen.cpp " ) , output ) ;
2017-10-24 14:18:47 +00:00
if ( save_err ! = OK )
return save_err ;
2017-10-29 01:37:13 +00:00
OS : : get_singleton ( ) - > print ( " Mono glue generated successfully \n " ) ;
2017-10-24 14:18:47 +00:00
return OK ;
2017-10-02 21:24:00 +00:00
}
2018-02-22 12:13:51 +00:00
uint32_t BindingsGenerator : : get_version ( ) {
return BINDINGS_GENERATOR_VERSION ;
}
uint32_t BindingsGenerator : : get_cs_glue_version ( ) {
return CS_GLUE_VERSION ;
}
2017-10-02 21:24:00 +00:00
Error BindingsGenerator : : _save_file ( const String & p_path , const List < String > & p_content ) {
FileAccessRef file = FileAccess : : open ( p_path , FileAccess : : WRITE ) ;
2017-10-24 14:18:47 +00:00
ERR_EXPLAIN ( " Cannot open file: " + p_path ) ;
2017-10-02 21:24:00 +00:00
ERR_FAIL_COND_V ( ! file , ERR_FILE_CANT_WRITE ) ;
for ( const List < String > : : Element * E = p_content . front ( ) ; E ; E = E - > next ( ) ) {
file - > store_string ( E - > get ( ) ) ;
}
file - > close ( ) ;
return OK ;
}
2017-10-29 01:37:13 +00:00
Error BindingsGenerator : : _generate_glue_method ( const BindingsGenerator : : TypeInterface & p_itype , const BindingsGenerator : : MethodInterface & p_imethod , List < String > & p_output ) {
if ( p_imethod . is_virtual )
return OK ; // Ignore
2017-12-24 02:17:48 +00:00
bool ret_void = p_imethod . return_type = = name_cache . type_void ;
2017-10-29 01:37:13 +00:00
const TypeInterface * return_type = _get_type_by_name_or_placeholder ( p_imethod . return_type ) ;
String argc_str = itos ( p_imethod . arguments . size ( ) ) ;
String c_func_sig = " MethodBind* " CS_PARAM_METHODBIND " , " + p_itype . c_type_in + " " CS_PARAM_INSTANCE ;
String c_in_statements ;
String c_args_var_content ;
// Get arguments information
int i = 0 ;
for ( const List < ArgumentInterface > : : Element * F = p_imethod . arguments . front ( ) ; F ; F = F - > next ( ) ) {
const ArgumentInterface & iarg = F - > get ( ) ;
const TypeInterface * arg_type = _get_type_by_name_or_placeholder ( iarg . type ) ;
String c_param_name = " arg " + itos ( i + 1 ) ;
if ( p_imethod . is_vararg ) {
if ( i < p_imethod . arguments . size ( ) - 1 ) {
c_in_statements + = sformat ( arg_type - > c_in . size ( ) ? arg_type - > c_in : TypeInterface : : DEFAULT_VARARG_C_IN , " Variant " , c_param_name ) ;
2018-02-24 19:03:16 +00:00
c_in_statements + = " \t " C_LOCAL_PTRCALL_ARGS " .set( " ;
c_in_statements + = itos ( i ) ;
c_in_statements + = sformat ( " , &%s_in); \n " , c_param_name ) ;
2017-10-29 01:37:13 +00:00
}
} else {
if ( i > 0 )
c_args_var_content + = " , " ;
if ( arg_type - > c_in . size ( ) )
c_in_statements + = sformat ( arg_type - > c_in , arg_type - > c_type , c_param_name ) ;
c_args_var_content + = sformat ( arg_type - > c_arg_in , c_param_name ) ;
}
c_func_sig + = " , " ;
c_func_sig + = arg_type - > c_type_in ;
c_func_sig + = " " ;
c_func_sig + = c_param_name ;
i + + ;
}
2018-01-25 22:44:37 +00:00
if ( ! p_itype . is_object_type )
return OK ; // no auto-generated icall functions for builtin types
2017-10-29 01:37:13 +00:00
const Map < const MethodInterface * , const InternalCall * > : : Element * match = method_icalls_map . find ( & p_imethod ) ;
ERR_FAIL_NULL_V ( match , ERR_BUG ) ;
const InternalCall * im_icall = match - > value ( ) ;
String icall_method = im_icall - > name ;
if ( ! generated_icall_funcs . find ( im_icall ) ) {
generated_icall_funcs . push_back ( im_icall ) ;
if ( im_icall - > editor_only )
p_output . push_back ( " #ifdef TOOLS_ENABLED \n " ) ;
// Generate icall function
p_output . push_back ( ret_void ? " void " : return_type - > c_type_out + " " ) ;
p_output . push_back ( icall_method ) ;
p_output . push_back ( " ( " ) ;
p_output . push_back ( c_func_sig ) ;
p_output . push_back ( " ) " OPEN_BLOCK ) ;
String fail_ret = ret_void ? " " : " , " + ( return_type - > c_type_out . ends_with ( " * " ) ? " NULL " : return_type - > c_type_out + " () " ) ;
if ( ! ret_void ) {
String ptrcall_return_type ;
String initialization ;
if ( return_type - > is_object_type ) {
ptrcall_return_type = return_type - > is_reference ? " Ref<Reference> " : return_type - > c_type ;
initialization = return_type - > is_reference ? " " : " = NULL " ;
} else {
ptrcall_return_type = return_type - > c_type ;
}
p_output . push_back ( " \t " + ptrcall_return_type ) ;
p_output . push_back ( " " LOCAL_RET ) ;
p_output . push_back ( initialization + " ; \n " ) ;
p_output . push_back ( " \t ERR_FAIL_NULL_V( " CS_PARAM_INSTANCE ) ;
p_output . push_back ( fail_ret ) ;
p_output . push_back ( " ); \n " ) ;
} else {
p_output . push_back ( " \t ERR_FAIL_NULL( " CS_PARAM_INSTANCE " ); \n " ) ;
}
if ( p_imethod . arguments . size ( ) ) {
if ( p_imethod . is_vararg ) {
String err_fail_macro = ret_void ? " ERR_FAIL_COND " : " ERR_FAIL_COND_V " ;
String vararg_arg = " arg " + argc_str ;
String real_argc_str = itos ( p_imethod . arguments . size ( ) - 1 ) ; // Arguments count without vararg
p_output . push_back ( " \t Vector<Variant> varargs; \n "
2017-10-29 09:11:20 +00:00
" \t int vararg_length = mono_array_length( " ) ;
2017-10-29 01:37:13 +00:00
p_output . push_back ( vararg_arg ) ;
p_output . push_back ( " ); \n \t int total_length = " ) ;
p_output . push_back ( real_argc_str ) ;
p_output . push_back ( " + vararg_length; \n \t " ) ;
p_output . push_back ( err_fail_macro ) ;
p_output . push_back ( " (varargs.resize(vararg_length) != OK " ) ;
p_output . push_back ( fail_ret ) ;
p_output . push_back ( " ); \n \t Vector<Variant*> " C_LOCAL_PTRCALL_ARGS " ; \n \t " ) ;
p_output . push_back ( err_fail_macro ) ;
p_output . push_back ( " (call_args.resize(total_length) != OK " ) ;
p_output . push_back ( fail_ret ) ;
p_output . push_back ( " ); \n " ) ;
p_output . push_back ( c_in_statements ) ;
p_output . push_back ( " \t for (int i = 0; i < vararg_length; i++) " OPEN_BLOCK
2017-10-29 09:11:20 +00:00
" \t \t MonoObject* elem = mono_array_get( " ) ;
2017-10-29 01:37:13 +00:00
p_output . push_back ( vararg_arg ) ;
p_output . push_back ( " , MonoObject*, i); \n "
2017-10-29 09:11:20 +00:00
" \t \t varargs.set(i, GDMonoMarshal::mono_object_to_variant(elem)); \n "
" \t \t " C_LOCAL_PTRCALL_ARGS " .set( " ) ;
2017-10-29 01:37:13 +00:00
p_output . push_back ( real_argc_str ) ;
p_output . push_back ( " + i, &varargs[i]); \n \t " CLOSE_BLOCK ) ;
} else {
p_output . push_back ( c_in_statements ) ;
p_output . push_back ( " \t const void* " C_LOCAL_PTRCALL_ARGS " [ " ) ;
p_output . push_back ( argc_str + " ] = { " ) ;
p_output . push_back ( c_args_var_content + " }; \n " ) ;
}
}
if ( p_imethod . is_vararg ) {
p_output . push_back ( " \t Variant::CallError vcall_error; \n \t " ) ;
if ( ! ret_void )
p_output . push_back ( LOCAL_RET " = " ) ;
p_output . push_back ( CS_PARAM_METHODBIND " ->call( " CS_PARAM_INSTANCE " , " ) ;
p_output . push_back ( p_imethod . arguments . size ( ) ? " (const Variant**) " C_LOCAL_PTRCALL_ARGS " .ptr() " : " NULL " ) ;
p_output . push_back ( " , total_length, vcall_error); \n " ) ;
} else {
p_output . push_back ( " \t " CS_PARAM_METHODBIND " ->ptrcall( " CS_PARAM_INSTANCE " , " ) ;
p_output . push_back ( p_imethod . arguments . size ( ) ? C_LOCAL_PTRCALL_ARGS " , " : " NULL, " ) ;
p_output . push_back ( ! ret_void ? " & " LOCAL_RET " ); \n " : " NULL); \n " ) ;
}
if ( ! ret_void ) {
if ( return_type - > c_out . empty ( ) )
p_output . push_back ( " \t return " LOCAL_RET " ; \n " ) ;
else
p_output . push_back ( sformat ( return_type - > c_out , return_type - > c_type_out , LOCAL_RET , return_type - > name ) ) ;
}
p_output . push_back ( CLOSE_BLOCK " \n " ) ;
if ( im_icall - > editor_only )
p_output . push_back ( " #endif // TOOLS_ENABLED \n " ) ;
}
return OK ;
}
2017-12-24 02:17:48 +00:00
const BindingsGenerator : : TypeInterface * BindingsGenerator : : _get_type_by_name_or_null ( const StringName & p_cname ) {
2018-01-09 18:06:59 +00:00
const Map < StringName , TypeInterface > : : Element * builtin_type_match = builtin_types . find ( p_cname ) ;
2017-10-02 21:24:00 +00:00
2018-01-09 18:06:59 +00:00
if ( builtin_type_match )
return & builtin_type_match - > get ( ) ;
2017-12-24 02:17:48 +00:00
2018-01-09 18:06:59 +00:00
const OrderedHashMap < StringName , TypeInterface > : : Element obj_type_match = obj_types . find ( p_cname ) ;
2017-10-02 21:24:00 +00:00
2018-01-09 18:06:59 +00:00
if ( obj_type_match )
return & obj_type_match . get ( ) ;
2017-10-02 21:24:00 +00:00
2018-01-09 18:06:59 +00:00
const Map < StringName , TypeInterface > : : Element * enum_match = enum_types . find ( p_cname ) ;
2017-10-02 21:24:00 +00:00
2018-01-09 18:06:59 +00:00
if ( enum_match )
return & enum_match - > get ( ) ;
2017-10-02 21:24:00 +00:00
return NULL ;
}
2017-12-24 02:17:48 +00:00
const BindingsGenerator : : TypeInterface * BindingsGenerator : : _get_type_by_name_or_placeholder ( const StringName & p_cname ) {
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
const TypeInterface * found = _get_type_by_name_or_null ( p_cname ) ;
2017-10-02 21:24:00 +00:00
if ( found )
return found ;
2017-12-24 02:17:48 +00:00
ERR_PRINTS ( String ( ) + " Type not found. Creating placeholder: " + p_cname . operator String ( ) ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
const Map < StringName , TypeInterface > : : Element * match = placeholder_types . find ( p_cname ) ;
2017-10-02 21:24:00 +00:00
if ( match )
return & match - > get ( ) ;
TypeInterface placeholder ;
2017-12-24 02:17:48 +00:00
TypeInterface : : create_placeholder_type ( placeholder , p_cname ) ;
2017-10-02 21:24:00 +00:00
2017-12-24 02:17:48 +00:00
return & placeholder_types . insert ( placeholder . cname , placeholder ) - > get ( ) ;
}
static void _create_constant_interface_from ( const StringName & p_constant , const DocData : : ClassDoc & p_classdoc ) {
2017-10-02 21:24:00 +00:00
}
void BindingsGenerator : : _populate_object_type_interfaces ( ) {
obj_types . clear ( ) ;
List < StringName > class_list ;
ClassDB : : get_class_list ( & class_list ) ;
class_list . sort_custom < StringName : : AlphCompare > ( ) ;
while ( class_list . size ( ) ) {
StringName type_cname = class_list . front ( ) - > get ( ) ;
ClassDB : : APIType api_type = ClassDB : : get_api_type ( type_cname ) ;
if ( api_type = = ClassDB : : API_NONE ) {
class_list . pop_front ( ) ;
continue ;
}
2017-12-24 02:17:48 +00:00
if ( ! ClassDB : : is_class_exposed ( type_cname ) ) {
if ( verbose_output )
WARN_PRINTS ( " Ignoring type " + type_cname . operator String ( ) + " because it's not exposed " ) ;
class_list . pop_front ( ) ;
continue ;
}
ClassDB : : ClassInfo * class_info = ClassDB : : classes . getptr ( type_cname ) ;
2017-10-02 21:24:00 +00:00
TypeInterface itype = TypeInterface : : create_object_type ( type_cname , api_type ) ;
itype . base_name = ClassDB : : get_parent_class ( type_cname ) ;
2017-11-13 20:46:57 +00:00
itype . is_singleton = Engine : : get_singleton ( ) - > has_singleton ( itype . proxy_name ) ;
2017-10-02 21:24:00 +00:00
itype . is_instantiable = ClassDB : : can_instance ( type_cname ) & & ! itype . is_singleton ;
2017-12-24 02:17:48 +00:00
itype . is_reference = ClassDB : : is_parent_class ( type_cname , name_cache . type_Reference ) ;
2017-10-02 21:24:00 +00:00
itype . memory_own = itype . is_reference ;
itype . c_out = " \t return " ;
itype . c_out + = C_METHOD_UNMANAGED_GET_MANAGED ;
itype . c_out + = itype . is_reference ? " (%1.ptr()); \n " : " (%1); \n " ;
itype . cs_in = itype . is_singleton ? BINDINGS_PTR_FIELD : " Object. " CS_SMETHOD_GETINSTANCE " (%0) " ;
itype . c_type = " Object* " ;
itype . c_type_in = itype . c_type ;
itype . c_type_out = " MonoObject* " ;
itype . cs_type = itype . proxy_name ;
itype . im_type_in = " IntPtr " ;
itype . im_type_out = itype . proxy_name ;
2017-12-29 01:18:46 +00:00
List < PropertyInfo > property_list ;
ClassDB : : get_property_list ( type_cname , & property_list , true ) ;
// Populate properties
for ( const List < PropertyInfo > : : Element * E = property_list . front ( ) ; E ; E = E - > next ( ) ) {
const PropertyInfo & property = E - > get ( ) ;
if ( property . usage & PROPERTY_USAGE_GROUP | | property . usage & PROPERTY_USAGE_CATEGORY )
continue ;
PropertyInterface iprop ;
iprop . cname = property . name ;
iprop . proxy_name = escape_csharp_keyword ( snake_to_pascal_case ( iprop . cname ) ) ;
iprop . setter = ClassDB : : get_property_setter ( type_cname , iprop . cname ) ;
iprop . getter = ClassDB : : get_property_getter ( type_cname , iprop . cname ) ;
bool valid = false ;
iprop . index = ClassDB : : get_property_index ( type_cname , iprop . cname , & valid ) ;
ERR_FAIL_COND ( ! valid ) ;
// Prevent property and enclosing type from sharing the same name
if ( iprop . proxy_name = = itype . proxy_name ) {
if ( verbose_output ) {
WARN_PRINTS ( " Name of property ` " + iprop . proxy_name + " ` is ambiguous with the name of its class ` " +
itype . proxy_name + " `. Renaming property to ` " + iprop . proxy_name + " _` " ) ;
}
iprop . proxy_name + = " _ " ;
}
iprop . prop_doc = NULL ;
for ( int i = 0 ; i < itype . class_doc - > properties . size ( ) ; i + + ) {
const DocData : : PropertyDoc & prop_doc = itype . class_doc - > properties [ i ] ;
if ( prop_doc . name = = iprop . cname ) {
iprop . prop_doc = & prop_doc ;
break ;
}
}
itype . properties . push_back ( iprop ) ;
}
2017-12-24 02:17:48 +00:00
// Populate methods
2017-10-02 21:24:00 +00:00
List < MethodInfo > virtual_method_list ;
ClassDB : : get_virtual_methods ( type_cname , & virtual_method_list , true ) ;
List < MethodInfo > method_list ;
ClassDB : : get_method_list ( type_cname , & method_list , true ) ;
method_list . sort ( ) ;
for ( List < MethodInfo > : : Element * E = method_list . front ( ) ; E ; E = E - > next ( ) ) {
const MethodInfo & method_info = E - > get ( ) ;
int argc = method_info . arguments . size ( ) ;
if ( method_info . name . empty ( ) )
continue ;
MethodInterface imethod ;
imethod . name = method_info . name ;
2017-12-24 02:17:48 +00:00
imethod . cname = imethod . name ;
2017-10-02 21:24:00 +00:00
if ( method_info . flags & METHOD_FLAG_VIRTUAL )
imethod . is_virtual = true ;
PropertyInfo return_info = method_info . return_val ;
MethodBind * m = imethod . is_virtual ? NULL : ClassDB : : get_method ( type_cname , method_info . name ) ;
imethod . is_vararg = m & & m - > is_vararg ( ) ;
if ( ! m & & ! imethod . is_virtual ) {
if ( virtual_method_list . find ( method_info ) ) {
// A virtual method without the virtual flag. This is a special case.
// This type of method can only be found in Object derived types.
ERR_FAIL_COND ( ! itype . is_object_type ) ;
// There is no method bind, so let's fallback to Godot's object.Call(string, params)
imethod . requires_object_call = true ;
// The method Object.free is registered as a virtual method, but without the virtual flag.
// This is because this method is not supposed to be overridden, but called.
// We assume the return type is void.
2017-12-24 02:17:48 +00:00
imethod . return_type = name_cache . type_void ;
2017-10-02 21:24:00 +00:00
// Actually, more methods like this may be added in the future,
2018-01-18 20:37:17 +00:00
// which could actually will return something different.
2017-10-02 21:24:00 +00:00
// Let's put this to notify us if that ever happens.
2017-12-24 02:17:48 +00:00
if ( itype . cname ! = name_cache . type_Object | | imethod . name ! = " free " ) {
2017-10-24 14:18:47 +00:00
if ( verbose_output ) {
WARN_PRINTS ( " Notification: New unexpected virtual non-overridable method found. \n "
" We only expected Object.free, but found " +
itype . name + " . " + imethod . name ) ;
}
2017-10-02 21:24:00 +00:00
}
} else {
ERR_PRINTS ( " Missing MethodBind for non-virtual method: " + itype . name + " . " + imethod . name ) ;
}
2017-12-24 02:17:48 +00:00
} else if ( return_info . type = = Variant : : INT & & return_info . usage & PROPERTY_USAGE_CLASS_IS_ENUM ) { // TODO redundant?
imethod . return_type = return_info . class_name ;
2017-10-02 21:24:00 +00:00
} else if ( return_info . class_name ! = StringName ( ) ) {
imethod . return_type = return_info . class_name ;
} else if ( return_info . hint = = PROPERTY_HINT_RESOURCE_TYPE ) {
imethod . return_type = return_info . hint_string ;
} else if ( return_info . type = = Variant : : NIL & & return_info . usage & PROPERTY_USAGE_NIL_IS_VARIANT ) {
2017-12-24 02:17:48 +00:00
imethod . return_type = name_cache . type_Variant ;
2017-10-02 21:24:00 +00:00
} else if ( return_info . type = = Variant : : NIL ) {
2017-12-24 02:17:48 +00:00
imethod . return_type = name_cache . type_void ;
2017-10-02 21:24:00 +00:00
} else {
imethod . return_type = Variant : : get_type_name ( return_info . type ) ;
}
2017-12-24 02:17:48 +00:00
if ( ! itype . requires_collections & & imethod . return_type = = name_cache . type_Dictionary )
2017-10-02 21:24:00 +00:00
itype . requires_collections = true ;
for ( int i = 0 ; i < argc ; i + + ) {
PropertyInfo arginfo = method_info . arguments [ i ] ;
ArgumentInterface iarg ;
iarg . name = arginfo . name ;
2017-12-24 02:17:48 +00:00
if ( arginfo . type = = Variant : : INT & & arginfo . usage & PROPERTY_USAGE_CLASS_IS_ENUM ) { // TODO redundant?
iarg . type = arginfo . class_name ;
2017-10-02 21:24:00 +00:00
} else if ( arginfo . class_name ! = StringName ( ) ) {
iarg . type = arginfo . class_name ;
} else if ( arginfo . hint = = PROPERTY_HINT_RESOURCE_TYPE ) {
iarg . type = arginfo . hint_string ;
} else if ( arginfo . type = = Variant : : NIL ) {
2017-12-24 02:17:48 +00:00
iarg . type = name_cache . type_Variant ;
2017-10-02 21:24:00 +00:00
} else {
iarg . type = Variant : : get_type_name ( arginfo . type ) ;
}
iarg . name = escape_csharp_keyword ( snake_to_camel_case ( iarg . name ) ) ;
2017-12-24 02:17:48 +00:00
if ( ! itype . requires_collections & & iarg . type = = name_cache . type_Dictionary )
2017-10-02 21:24:00 +00:00
itype . requires_collections = true ;
if ( m & & m - > has_default_argument ( i ) ) {
_default_argument_from_variant ( m - > get_default_argument ( i ) , iarg ) ;
}
imethod . add_argument ( iarg ) ;
}
if ( imethod . is_vararg ) {
ArgumentInterface ivararg ;
2017-12-24 02:17:48 +00:00
ivararg . type = name_cache . type_VarArg ;
2017-10-02 21:24:00 +00:00
ivararg . name = " @args " ;
imethod . add_argument ( ivararg ) ;
}
imethod . proxy_name = escape_csharp_keyword ( snake_to_pascal_case ( imethod . name ) ) ;
// Prevent naming the property and its enclosing type from sharing the same name
if ( imethod . proxy_name = = itype . proxy_name ) {
if ( verbose_output ) {
WARN_PRINTS ( " Name of method ` " + imethod . proxy_name + " ` is ambiguous with the name of its class ` " +
itype . proxy_name + " `. Renaming method to ` " + imethod . proxy_name + " _` " ) ;
}
imethod . proxy_name + = " _ " ;
}
if ( itype . class_doc ) {
for ( int i = 0 ; i < itype . class_doc - > methods . size ( ) ; i + + ) {
if ( itype . class_doc - > methods [ i ] . name = = imethod . name ) {
imethod . method_doc = & itype . class_doc - > methods [ i ] ;
break ;
}
}
}
if ( ! imethod . is_virtual & & imethod . name [ 0 ] = = ' _ ' ) {
2017-12-29 01:18:46 +00:00
for ( const List < PropertyInterface > : : Element * E = itype . properties . front ( ) ; E ; E = E - > next ( ) ) {
const PropertyInterface & iprop = E - > get ( ) ;
2017-10-02 21:24:00 +00:00
2017-12-29 01:18:46 +00:00
if ( iprop . setter = = imethod . name | | iprop . getter = = imethod . name ) {
2017-10-02 21:24:00 +00:00
imethod . is_internal = true ;
itype . methods . push_back ( imethod ) ;
break ;
}
}
} else {
itype . methods . push_back ( imethod ) ;
}
}
2017-12-24 02:17:48 +00:00
// Populate enums and constants
List < String > constant_list ;
ClassDB : : get_integer_constant_list ( type_cname , & constant_list , true ) ;
const HashMap < StringName , List < StringName > > & enum_map = class_info - > enum_map ;
const StringName * k = NULL ;
while ( ( k = enum_map . next ( k ) ) ) {
StringName enum_proxy_cname = * k ;
String enum_proxy_name = enum_proxy_cname . operator String ( ) ;
if ( itype . find_property_by_proxy_name ( enum_proxy_cname ) ) {
// We have several conflicts between enums and PascalCase properties,
// so we append 'Enum' to the enum name in those cases.
enum_proxy_name + = " Enum " ;
enum_proxy_cname = StringName ( enum_proxy_name ) ;
}
EnumInterface ienum ( enum_proxy_cname ) ;
const List < StringName > & constants = enum_map . get ( * k ) ;
for ( const List < StringName > : : Element * E = constants . front ( ) ; E ; E = E - > next ( ) ) {
int * value = class_info - > constant_map . getptr ( E - > get ( ) ) ;
ERR_FAIL_NULL ( value ) ;
constant_list . erase ( E - > get ( ) . operator String ( ) ) ;
ConstantInterface iconstant ( snake_to_pascal_case ( E - > get ( ) , true ) , * value ) ;
iconstant . const_doc = NULL ;
for ( int i = 0 ; i < itype . class_doc - > constants . size ( ) ; i + + ) {
const DocData : : ConstantDoc & const_doc = itype . class_doc - > constants [ i ] ;
if ( const_doc . name = = iconstant . name ) {
iconstant . const_doc = & const_doc ;
break ;
}
}
ienum . constants . push_back ( iconstant ) ;
}
ienum . prefix = _determine_enum_prefix ( ienum ) ;
itype . enums . push_back ( ienum ) ;
TypeInterface enum_itype ;
enum_itype . name = itype . name + " . " + String ( * k ) ;
enum_itype . cname = StringName ( enum_itype . name ) ;
enum_itype . proxy_name = itype . proxy_name + " . " + enum_proxy_name ;
enum_itype . c_arg_in = " &%s " ;
enum_itype . c_type = " int " ;
enum_itype . c_type_in = " int " ;
enum_itype . c_type_out = " int " ;
enum_itype . cs_type = enum_itype . proxy_name ;
enum_itype . im_type_in = enum_itype . proxy_name ;
enum_itype . im_type_out = enum_itype . proxy_name ;
enum_itype . class_doc = & EditorHelp : : get_doc_data ( ) - > class_list [ enum_itype . proxy_name ] ;
enum_types . insert ( enum_itype . cname , enum_itype ) ;
}
for ( const List < String > : : Element * E = constant_list . front ( ) ; E ; E = E - > next ( ) ) {
int * value = class_info - > constant_map . getptr ( E - > get ( ) ) ;
ERR_FAIL_NULL ( value ) ;
ConstantInterface iconstant ( snake_to_pascal_case ( E - > get ( ) , true ) , * value ) ;
iconstant . const_doc = NULL ;
for ( int i = 0 ; i < itype . class_doc - > constants . size ( ) ; i + + ) {
const DocData : : ConstantDoc & const_doc = itype . class_doc - > constants [ i ] ;
if ( const_doc . name = = iconstant . name ) {
iconstant . const_doc = & const_doc ;
break ;
}
}
itype . constants . push_back ( iconstant ) ;
}
obj_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
class_list . pop_front ( ) ;
}
}
void BindingsGenerator : : _default_argument_from_variant ( const Variant & p_val , ArgumentInterface & r_iarg ) {
r_iarg . default_argument = p_val ;
switch ( p_val . get_type ( ) ) {
case Variant : : NIL :
if ( ClassDB : : class_exists ( r_iarg . type ) ) {
// Object type
r_iarg . default_argument = " null " ;
} else {
// Variant
r_iarg . default_argument = " null " ;
}
break ;
// Atomic types
case Variant : : BOOL :
r_iarg . default_argument = bool ( p_val ) ? " true " : " false " ;
break ;
case Variant : : INT :
2017-12-24 02:17:48 +00:00
if ( r_iarg . type ! = name_cache . type_int ) {
r_iarg . default_argument = " (%s) " + r_iarg . default_argument ;
}
break ;
2017-10-02 21:24:00 +00:00
case Variant : : REAL :
# ifndef REAL_T_IS_DOUBLE
r_iarg . default_argument + = " f " ;
# endif
break ;
case Variant : : STRING :
case Variant : : NODE_PATH :
r_iarg . default_argument = " \" " + r_iarg . default_argument + " \" " ;
break ;
case Variant : : TRANSFORM :
if ( p_val . operator Transform ( ) = = Transform ( ) )
r_iarg . default_argument . clear ( ) ;
r_iarg . default_argument = " new %s( " + r_iarg . default_argument + " ) " ;
r_iarg . def_param_mode = ArgumentInterface : : NULLABLE_VAL ;
break ;
case Variant : : PLANE :
2017-11-17 02:09:00 +00:00
case Variant : : AABB :
2017-10-02 21:24:00 +00:00
case Variant : : COLOR :
r_iarg . default_argument = " new Color(1, 1, 1, 1) " ;
r_iarg . def_param_mode = ArgumentInterface : : NULLABLE_VAL ;
break ;
case Variant : : VECTOR2 :
case Variant : : RECT2 :
case Variant : : VECTOR3 :
r_iarg . default_argument = " new %s " + r_iarg . default_argument ;
r_iarg . def_param_mode = ArgumentInterface : : NULLABLE_VAL ;
break ;
case Variant : : OBJECT :
if ( p_val . is_zero ( ) ) {
r_iarg . default_argument = " null " ;
break ;
}
case Variant : : DICTIONARY :
case Variant : : _RID :
r_iarg . default_argument = " new %s() " ;
r_iarg . def_param_mode = ArgumentInterface : : NULLABLE_REF ;
break ;
case Variant : : ARRAY :
case Variant : : POOL_BYTE_ARRAY :
case Variant : : POOL_INT_ARRAY :
case Variant : : POOL_REAL_ARRAY :
case Variant : : POOL_STRING_ARRAY :
case Variant : : POOL_VECTOR2_ARRAY :
case Variant : : POOL_VECTOR3_ARRAY :
case Variant : : POOL_COLOR_ARRAY :
r_iarg . default_argument = " new %s {} " ;
r_iarg . def_param_mode = ArgumentInterface : : NULLABLE_REF ;
break ;
case Variant : : TRANSFORM2D :
case Variant : : BASIS :
case Variant : : QUAT :
r_iarg . default_argument = Variant : : get_type_name ( p_val . get_type ( ) ) + " .Identity " ;
r_iarg . def_param_mode = ArgumentInterface : : NULLABLE_VAL ;
break ;
default : { }
}
2017-12-24 02:17:48 +00:00
if ( r_iarg . def_param_mode = = ArgumentInterface : : CONSTANT & & r_iarg . type = = name_cache . type_Variant & & r_iarg . default_argument ! = " null " )
2017-10-02 21:24:00 +00:00
r_iarg . def_param_mode = ArgumentInterface : : NULLABLE_REF ;
}
void BindingsGenerator : : _populate_builtin_type_interfaces ( ) {
builtin_types . clear ( ) ;
TypeInterface itype ;
# define INSERT_STRUCT_TYPE(m_type, m_type_in) \
{ \
2017-12-24 02:17:48 +00:00
itype = TypeInterface : : create_value_type ( String ( # m_type ) ) ; \
2017-10-02 21:24:00 +00:00
itype . c_in = " \t MARSHALLED_IN( " # m_type " , %1, %1_in); \n " ; \
itype . c_out = " \t MARSHALLED_OUT( " # m_type " , %1, ret_out) \n " \
" \t return mono_value_box(mono_domain_get(), CACHED_CLASS_RAW(%2), ret_out); \n " ; \
itype . c_arg_in = " &%s_in " ; \
itype . c_type_in = m_type_in ; \
itype . cs_in = " ref %s " ; \
itype . cs_out = " return ( " # m_type " )%0; " ; \
itype . im_type_out = " object " ; \
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ; \
2017-10-02 21:24:00 +00:00
}
INSERT_STRUCT_TYPE ( Vector2 , " real_t* " )
INSERT_STRUCT_TYPE ( Rect2 , " real_t* " )
INSERT_STRUCT_TYPE ( Transform2D , " real_t* " )
INSERT_STRUCT_TYPE ( Vector3 , " real_t* " )
INSERT_STRUCT_TYPE ( Basis , " real_t* " )
INSERT_STRUCT_TYPE ( Quat , " real_t* " )
INSERT_STRUCT_TYPE ( Transform , " real_t* " )
2017-11-17 02:09:00 +00:00
INSERT_STRUCT_TYPE ( AABB , " real_t* " )
2017-10-02 21:24:00 +00:00
INSERT_STRUCT_TYPE ( Color , " real_t* " )
INSERT_STRUCT_TYPE ( Plane , " real_t* " )
# undef INSERT_STRUCT_TYPE
2018-01-25 22:44:37 +00:00
// bool
itype = TypeInterface : : create_value_type ( String ( " bool " ) ) ;
itype . c_arg_in = " &%s " ;
// /* MonoBoolean <---> bool
itype . c_in = " \t %0 %1_in = (%0)%1; \n " ;
itype . c_out = " \t return (%0)%1; \n " ;
itype . c_type = " bool " ;
// */
itype . c_type_in = " MonoBoolean " ;
itype . c_type_out = itype . c_type_in ;
itype . im_type_in = itype . name ;
itype . im_type_out = itype . name ;
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
// int
2017-12-24 02:17:48 +00:00
itype = TypeInterface : : create_value_type ( String ( " int " ) ) ;
2017-10-02 21:24:00 +00:00
itype . c_arg_in = " &%s_in " ;
2018-01-25 22:44:37 +00:00
// /* ptrcall only supports int64_t and uint64_t
2017-10-02 21:24:00 +00:00
itype . c_in = " \t %0 %1_in = (%0)%1; \n " ;
itype . c_out = " \t return (%0)%1; \n " ;
itype . c_type = " int64_t " ;
2018-01-25 22:44:37 +00:00
// */
itype . c_type_in = " int32_t " ;
itype . c_type_out = itype . c_type_in ;
2017-10-02 21:24:00 +00:00
itype . im_type_in = itype . name ;
itype . im_type_out = itype . name ;
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
// real_t
itype = TypeInterface ( ) ;
# ifdef REAL_T_IS_DOUBLE
itype . name = " double " ;
# else
itype . name = " float " ;
# endif
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ;
2017-10-02 21:24:00 +00:00
itype . proxy_name = itype . name ;
itype . c_arg_in = " &%s_in " ;
//* ptrcall only supports double
itype . c_in = " \t %0 %1_in = (%0)%1; \n " ;
itype . c_out = " \t return (%0)%1; \n " ;
itype . c_type = " double " ;
//*/
itype . c_type_in = " real_t " ;
itype . c_type_out = " real_t " ;
itype . cs_type = itype . proxy_name ;
itype . im_type_in = itype . proxy_name ;
itype . im_type_out = itype . proxy_name ;
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
// String
itype = TypeInterface ( ) ;
itype . name = " String " ;
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ;
2017-10-02 21:24:00 +00:00
itype . proxy_name = " string " ;
itype . c_in = " \t %0 %1_in = " C_METHOD_MONOSTR_TO_GODOT " (%1); \n " ;
itype . c_out = " \t return " C_METHOD_MONOSTR_FROM_GODOT " (%1); \n " ;
itype . c_arg_in = " &%s_in " ;
itype . c_type = itype . name ;
itype . c_type_in = " MonoString* " ;
itype . c_type_out = " MonoString* " ;
itype . cs_type = itype . proxy_name ;
itype . im_type_in = itype . proxy_name ;
itype . im_type_out = itype . proxy_name ;
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
// NodePath
itype = TypeInterface ( ) ;
itype . name = " NodePath " ;
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ;
2017-10-02 21:24:00 +00:00
itype . proxy_name = " NodePath " ;
itype . c_out = " \t return memnew(NodePath(%1)); \n " ;
itype . c_type = itype . name ;
itype . c_type_in = itype . c_type + " * " ;
itype . c_type_out = itype . c_type + " * " ;
itype . cs_type = itype . proxy_name ;
itype . cs_in = " NodePath. " CS_SMETHOD_GETINSTANCE " (%0) " ;
itype . cs_out = " return new NodePath(%0); " ;
itype . im_type_in = " IntPtr " ;
itype . im_type_out = " IntPtr " ;
_populate_builtin_type ( itype , Variant : : NODE_PATH ) ;
2017-12-24 02:17:48 +00:00
extra_members . insert ( itype . cname , MEMBER_BEGIN " public NodePath() : this(string.Empty) {} \n " MEMBER_BEGIN " public NodePath(string path) \n " OPEN_BLOCK_L2
" this. " BINDINGS_PTR_FIELD " = NativeCalls.godot_icall_NodePath_Ctor(path); \n " CLOSE_BLOCK_L2
MEMBER_BEGIN " public static implicit operator NodePath(string from) \n " OPEN_BLOCK_L2 " return new NodePath(from); \n " CLOSE_BLOCK_L2
MEMBER_BEGIN " public static implicit operator string(NodePath from) \n " OPEN_BLOCK_L2
2018-02-16 13:07:19 +00:00
" return NativeCalls. " ICALL_PREFIX " NodePath_operator_String(NodePath. " CS_SMETHOD_GETINSTANCE " (from)); \n " CLOSE_BLOCK_L2
MEMBER_BEGIN " public override string ToString() \n " OPEN_BLOCK_L2 " return (string)this; \n " CLOSE_BLOCK_L2 ) ;
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
// RID
itype = TypeInterface ( ) ;
itype . name = " RID " ;
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ;
2017-10-02 21:24:00 +00:00
itype . proxy_name = " RID " ;
itype . c_out = " \t return memnew(RID(%1)); \n " ;
itype . c_type = itype . name ;
itype . c_type_in = itype . c_type + " * " ;
itype . c_type_out = itype . c_type + " * " ;
itype . cs_type = itype . proxy_name ;
itype . cs_in = " RID. " CS_SMETHOD_GETINSTANCE " (%0) " ;
itype . cs_out = " return new RID(%0); " ;
itype . im_type_in = " IntPtr " ;
itype . im_type_out = " IntPtr " ;
_populate_builtin_type ( itype , Variant : : _RID ) ;
2017-12-24 02:17:48 +00:00
extra_members . insert ( itype . cname , MEMBER_BEGIN " internal RID() \n " OPEN_BLOCK_L2
" this. " BINDINGS_PTR_FIELD " = IntPtr.Zero; \n " CLOSE_BLOCK_L2 ) ;
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
// Variant
itype = TypeInterface ( ) ;
itype . name = " Variant " ;
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ;
2017-10-02 21:24:00 +00:00
itype . proxy_name = " object " ;
itype . c_in = " \t %0 %1_in = " C_METHOD_MANAGED_TO_VARIANT " (%1); \n " ;
itype . c_out = " \t return " C_METHOD_MANAGED_FROM_VARIANT " (%1); \n " ;
itype . c_arg_in = " &%s_in " ;
itype . c_type = itype . name ;
itype . c_type_in = " MonoObject* " ;
itype . c_type_out = " MonoObject* " ;
itype . cs_type = itype . proxy_name ;
itype . im_type_in = " object " ;
itype . im_type_out = itype . proxy_name ;
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
// VarArg (fictitious type to represent variable arguments)
itype = TypeInterface ( ) ;
itype . name = " VarArg " ;
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ;
2017-10-02 21:24:00 +00:00
itype . proxy_name = " object[] " ;
itype . c_in = " \t %0 %1_in = " C_METHOD_MONOARRAY_TO ( Array ) " (%1); \n " ;
itype . c_arg_in = " &%s_in " ;
itype . c_type = " Array " ;
itype . c_type_in = " MonoArray* " ;
itype . cs_type = " params object[] " ;
itype . im_type_in = " object[] " ;
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
# define INSERT_ARRAY_FULL(m_name, m_type, m_proxy_t) \
{ \
itype = TypeInterface ( ) ; \
itype . name = # m_name ; \
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ; \
2017-10-02 21:24:00 +00:00
itype . proxy_name = # m_proxy_t " [] " ; \
itype . c_in = " \t %0 %1_in = " C_METHOD_MONOARRAY_TO ( m_type ) " (%1); \n " ; \
itype . c_out = " \t return " C_METHOD_MONOARRAY_FROM ( m_type ) " (%1); \n " ; \
itype . c_arg_in = " &%s_in " ; \
itype . c_type = # m_type ; \
itype . c_type_in = " MonoArray* " ; \
itype . c_type_out = " MonoArray* " ; \
itype . cs_type = itype . proxy_name ; \
itype . im_type_in = itype . proxy_name ; \
itype . im_type_out = itype . proxy_name ; \
builtin_types . insert ( itype . name , itype ) ; \
}
# define INSERT_ARRAY(m_type, m_proxy_t) INSERT_ARRAY_FULL(m_type, m_type, m_proxy_t)
INSERT_ARRAY ( Array , object ) ;
INSERT_ARRAY ( PoolIntArray , int ) ;
INSERT_ARRAY_FULL ( PoolByteArray , PoolByteArray , byte ) ;
# ifdef REAL_T_IS_DOUBLE
INSERT_ARRAY ( PoolRealArray , double ) ;
# else
INSERT_ARRAY ( PoolRealArray , float ) ;
# endif
INSERT_ARRAY ( PoolStringArray , string ) ;
INSERT_ARRAY ( PoolColorArray , Color ) ;
INSERT_ARRAY ( PoolVector2Array , Vector2 ) ;
INSERT_ARRAY ( PoolVector3Array , Vector3 ) ;
# undef INSERT_ARRAY
// Dictionary
itype = TypeInterface ( ) ;
itype . name = " Dictionary " ;
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ;
2017-10-02 21:24:00 +00:00
itype . proxy_name = " Dictionary<object, object> " ;
itype . c_in = " \t %0 %1_in = " C_METHOD_MANAGED_TO_DICT " (%1); \n " ;
itype . c_out = " \t return " C_METHOD_MANAGED_FROM_DICT " (%1); \n " ;
itype . c_arg_in = " &%s_in " ;
itype . c_type = itype . name ;
itype . c_type_in = " MonoObject* " ;
itype . c_type_out = " MonoObject* " ;
itype . cs_type = itype . proxy_name ;
itype . im_type_in = itype . proxy_name ;
itype . im_type_out = itype . proxy_name ;
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
// void (fictitious type to represent the return type of methods that do not return anything)
itype = TypeInterface ( ) ;
itype . name = " void " ;
2017-12-24 02:17:48 +00:00
itype . cname = itype . name ;
2017-10-02 21:24:00 +00:00
itype . proxy_name = itype . name ;
itype . c_type = itype . name ;
itype . c_type_in = itype . c_type ;
itype . c_type_out = itype . c_type ;
itype . cs_type = itype . proxy_name ;
itype . im_type_in = itype . proxy_name ;
itype . im_type_out = itype . proxy_name ;
2017-12-24 02:17:48 +00:00
builtin_types . insert ( itype . cname , itype ) ;
2017-10-02 21:24:00 +00:00
}
void BindingsGenerator : : _populate_builtin_type ( TypeInterface & r_itype , Variant : : Type vtype ) {
Variant : : CallError cerror ;
Variant v = Variant : : construct ( vtype , NULL , 0 , cerror ) ;
List < MethodInfo > method_list ;
v . get_method_list ( & method_list ) ;
method_list . sort ( ) ;
for ( List < MethodInfo > : : Element * E = method_list . front ( ) ; E ; E = E - > next ( ) ) {
MethodInfo & mi = E - > get ( ) ;
MethodInterface imethod ;
imethod . name = mi . name ;
2017-12-24 02:17:48 +00:00
imethod . cname = imethod . name ;
2018-02-16 12:44:48 +00:00
imethod . proxy_name = escape_csharp_keyword ( snake_to_pascal_case ( mi . name ) ) ;
2017-10-02 21:24:00 +00:00
for ( int i = 0 ; i < mi . arguments . size ( ) ; i + + ) {
ArgumentInterface iarg ;
PropertyInfo pi = mi . arguments [ i ] ;
iarg . name = pi . name ;
if ( pi . type = = Variant : : NIL )
2017-12-24 02:17:48 +00:00
iarg . type = name_cache . type_Variant ;
2017-10-02 21:24:00 +00:00
else
iarg . type = Variant : : get_type_name ( pi . type ) ;
2017-12-24 02:17:48 +00:00
if ( ! r_itype . requires_collections & & iarg . type = = name_cache . type_Dictionary )
2017-10-02 21:24:00 +00:00
r_itype . requires_collections = true ;
if ( ( mi . default_arguments . size ( ) - mi . arguments . size ( ) + i ) > = 0 )
_default_argument_from_variant ( Variant : : construct ( pi . type , NULL , 0 , cerror ) , iarg ) ;
imethod . add_argument ( iarg ) ;
}
if ( mi . return_val . type = = Variant : : NIL ) {
if ( mi . return_val . name ! = " " )
2017-12-24 02:17:48 +00:00
imethod . return_type = name_cache . type_Variant ;
2017-10-02 21:24:00 +00:00
} else {
imethod . return_type = Variant : : get_type_name ( mi . return_val . type ) ;
}
2017-12-24 02:17:48 +00:00
if ( ! r_itype . requires_collections & & imethod . return_type = = name_cache . type_Dictionary )
2017-10-02 21:24:00 +00:00
r_itype . requires_collections = true ;
if ( r_itype . class_doc ) {
for ( int i = 0 ; i < r_itype . class_doc - > methods . size ( ) ; i + + ) {
if ( r_itype . class_doc - > methods [ i ] . name = = imethod . name ) {
imethod . method_doc = & r_itype . class_doc - > methods [ i ] ;
break ;
}
}
}
r_itype . methods . push_back ( imethod ) ;
}
}
2017-12-24 02:17:48 +00:00
void BindingsGenerator : : _populate_global_constants ( ) {
int global_constants_count = GlobalConstants : : get_global_constant_count ( ) ;
if ( global_constants_count > 0 ) {
Map < String , DocData : : ClassDoc > : : Element * match = EditorHelp : : get_doc_data ( ) - > class_list . find ( " @GlobalScope " ) ;
ERR_EXPLAIN ( " Could not find `@GlobalScope` in DocData " ) ;
CRASH_COND ( ! match ) ;
const DocData : : ClassDoc & global_scope_doc = match - > value ( ) ;
for ( int i = 0 ; i < global_constants_count ; i + + ) {
String constant_name = GlobalConstants : : get_global_constant_name ( i ) ;
const DocData : : ConstantDoc * const_doc = NULL ;
for ( int i = 0 ; i < global_scope_doc . constants . size ( ) ; i + + ) {
const DocData : : ConstantDoc & curr_const_doc = global_scope_doc . constants [ i ] ;
if ( curr_const_doc . name = = constant_name ) {
const_doc = & curr_const_doc ;
break ;
}
}
int constant_value = GlobalConstants : : get_global_constant_value ( i ) ;
StringName enum_name = GlobalConstants : : get_global_constant_enum ( i ) ;
ConstantInterface iconstant ( snake_to_pascal_case ( constant_name , true ) , constant_value ) ;
iconstant . const_doc = const_doc ;
if ( enum_name ! = StringName ( ) ) {
EnumInterface ienum ( enum_name ) ;
List < EnumInterface > : : Element * match = global_enums . find ( ienum ) ;
if ( match ) {
match - > get ( ) . constants . push_back ( iconstant ) ;
} else {
ienum . constants . push_back ( iconstant ) ;
global_enums . push_back ( ienum ) ;
}
} else {
global_constants . push_back ( iconstant ) ;
}
}
for ( List < EnumInterface > : : Element * E = global_enums . front ( ) ; E ; E = E - > next ( ) ) {
EnumInterface & ienum = E - > get ( ) ;
TypeInterface enum_itype ;
enum_itype = TypeInterface : : create_value_type ( ienum . cname ) ;
enum_itype . c_arg_in = " &%s " ;
enum_itype . c_type = " int " ;
enum_itype . c_type_in = " int " ;
enum_itype . c_type_out = " int " ;
enum_itype . im_type_in = enum_itype . name ;
enum_itype . im_type_out = enum_itype . name ;
enum_types . insert ( enum_itype . cname , enum_itype ) ;
ienum . prefix = _determine_enum_prefix ( ienum ) ;
// HARDCODED
if ( ienum . cname = = name_cache . enum_Error ) {
if ( ! ienum . prefix . empty ( ) ) { // Just in case it ever changes
ERR_PRINTS ( " Prefix for enum 'Error' is not empty " ) ;
}
ienum . prefix = " Err " ;
}
}
}
// HARDCODED
List < StringName > hardcoded_enums ;
hardcoded_enums . push_back ( " Vector3.Axis " ) ;
for ( List < StringName > : : Element * E = hardcoded_enums . front ( ) ; E ; E = E - > next ( ) ) {
// These enums are not generated and must be written manually (e.g.: Vector3.Axis)
// Here, we are assuming core types do not begin with underscore
TypeInterface enum_itype ;
enum_itype = TypeInterface : : create_value_type ( E - > get ( ) ) ;
enum_itype . c_arg_in = " &%s " ;
enum_itype . c_type = " int " ;
enum_itype . c_type_in = " int " ;
enum_itype . c_type_out = " int " ;
enum_itype . im_type_in = enum_itype . name ;
enum_itype . im_type_out = enum_itype . name ;
enum_types . insert ( enum_itype . cname , enum_itype ) ;
}
}
2018-01-01 02:04:49 +00:00
void BindingsGenerator : : initialize ( ) {
2017-10-02 21:24:00 +00:00
EditorHelp : : generate_doc ( ) ;
2017-12-24 02:17:48 +00:00
enum_types . clear ( ) ;
2017-10-02 21:24:00 +00:00
_populate_object_type_interfaces ( ) ;
_populate_builtin_type_interfaces ( ) ;
2017-12-24 02:17:48 +00:00
_populate_global_constants ( ) ;
// Populate internal calls (after populating type interfaces and global constants)
2017-10-02 21:24:00 +00:00
_generate_header_icalls ( ) ;
2018-01-09 18:06:59 +00:00
for ( OrderedHashMap < StringName , TypeInterface > : : Element E = obj_types . front ( ) ; E ; E = E . next ( ) )
_generate_method_icalls ( E . get ( ) ) ;
2017-10-02 21:24:00 +00:00
_generate_method_icalls ( builtin_types [ " NodePath " ] ) ;
_generate_method_icalls ( builtin_types [ " RID " ] ) ;
}
void BindingsGenerator : : handle_cmdline_args ( const List < String > & p_cmdline_args ) {
2017-10-24 14:18:47 +00:00
const int NUM_OPTIONS = 3 ;
int options_left = NUM_OPTIONS ;
2017-10-02 21:24:00 +00:00
String mono_glue_option = " --generate-mono-glue " ;
String cs_core_api_option = " --generate-cs-core-api " ;
String cs_editor_api_option = " --generate-cs-editor-api " ;
verbose_output = true ;
const List < String > : : Element * elem = p_cmdline_args . front ( ) ;
2017-10-24 14:18:47 +00:00
while ( elem & & options_left ) {
2017-10-02 21:24:00 +00:00
if ( elem - > get ( ) = = mono_glue_option ) {
const List < String > : : Element * path_elem = elem - > next ( ) ;
if ( path_elem ) {
2018-01-01 02:04:49 +00:00
if ( get_singleton ( ) - > generate_glue ( path_elem - > get ( ) ) ! = OK )
2017-10-29 01:37:13 +00:00
ERR_PRINT ( " Mono glue generation failed " ) ;
2017-10-02 21:24:00 +00:00
elem = elem - > next ( ) ;
} else {
ERR_PRINTS ( " --generate-mono-glue: No output directory specified " ) ;
}
2017-10-24 14:18:47 +00:00
- - options_left ;
2017-10-02 21:24:00 +00:00
} else if ( elem - > get ( ) = = cs_core_api_option ) {
const List < String > : : Element * path_elem = elem - > next ( ) ;
if ( path_elem ) {
2018-01-01 02:04:49 +00:00
if ( get_singleton ( ) - > generate_cs_core_project ( path_elem - > get ( ) ) ! = OK )
2017-10-29 01:37:13 +00:00
ERR_PRINT ( " Generation of solution and C# project for the Core API failed " ) ;
2017-10-02 21:24:00 +00:00
elem = elem - > next ( ) ;
} else {
ERR_PRINTS ( cs_core_api_option + " : No output directory specified " ) ;
}
2017-10-24 14:18:47 +00:00
- - options_left ;
2017-10-02 21:24:00 +00:00
} else if ( elem - > get ( ) = = cs_editor_api_option ) {
const List < String > : : Element * path_elem = elem - > next ( ) ;
if ( path_elem ) {
if ( path_elem - > next ( ) ) {
2018-01-01 02:04:49 +00:00
if ( get_singleton ( ) - > generate_cs_editor_project ( path_elem - > get ( ) , path_elem - > next ( ) - > get ( ) ) ! = OK )
2017-10-29 01:37:13 +00:00
ERR_PRINT ( " Generation of solution and C# project for the Editor API failed " ) ;
2017-10-02 21:24:00 +00:00
elem = path_elem - > next ( ) ;
} else {
ERR_PRINTS ( cs_editor_api_option + " : No hint path for the Core API dll specified " ) ;
}
} else {
ERR_PRINTS ( cs_editor_api_option + " : No output directory specified " ) ;
}
2017-10-24 14:18:47 +00:00
- - options_left ;
2017-10-02 21:24:00 +00:00
}
elem = elem - > next ( ) ;
}
verbose_output = false ;
2017-10-24 14:18:47 +00:00
if ( options_left ! = NUM_OPTIONS )
exit ( 0 ) ;
2017-10-02 21:24:00 +00:00
}
# endif