483071716e
We will be progressively moving most code to C#.
The plan is to only use Mono's embedding APIs to set things at launch.
This will make it much easier to later support CoreCLR too which
doesn't have rich embedding APIs.
Additionally the code in C# is more maintainable and makes it easier
to implement new features, e.g.: runtime codegen which we could use to
avoid using reflection for marshaling everytime a field, property or
method is accessed.
SOME NOTES ON INTEROP
We make the same assumptions as GDNative about the size of the Godot
structures we use. We take it a bit further by also assuming the layout
of fields in some cases, which is riskier but let's us squeeze out some
performance by avoiding unnecessary managed to native calls.
Code that deals with native structs is less safe than before as there's
no RAII and copy constructors in C#. It's like using the GDNative C API
directly. One has to take special care to free values they own.
Perhaps we could use roslyn analyzers to check this, but I don't know
any that uses attributes to determine what's owned or borrowed.
As to why we maily use pointers for native structs instead of ref/out:
- AFAIK (and confirmed with a benchmark) ref/out are pinned
during P/Invoke calls and that has a cost.
- Native struct fields can't be ref/out in the first place.
- A `using` local can't be passed as ref/out, only `in`. Calling a
method or property on an `in` value makes a silent copy, so we want
to avoid `in`.
REGARDING THE BUILD SYSTEM
There's no longer a `mono_glue=yes/no` SCons options. We no longer
need to build with `mono_glue=no`, generate the glue and then build
again with `mono_glue=yes`. We build only once and generate the glue
(which is in C# now).
However, SCons no longer builds the C# projects for us. Instead one
must run `build_assemblies.py`, e.g.:
```sh
%godot_src_root%/modules/mono/build_scripts/build_assemblies.py \
--godot-output-dir=%godot_src_root%/bin \
--godot-target=release_debug`
```
We could turn this into a custom build target, but I don't know how
to do that with SCons (it's possible with Meson).
OTHER NOTES
Most of the moved code doesn't follow the C# naming convention and
still has the word Mono in the names despite no longer dealing with
Mono's embedding APIs. This is just temporary while transitioning,
to make it easier to understand what was moved where.
3513 lines
122 KiB
C++
3513 lines
122 KiB
C++
/*************************************************************************/
|
|
/* bindings_generator.cpp */
|
|
/*************************************************************************/
|
|
/* This file is part of: */
|
|
/* GODOT ENGINE */
|
|
/* https://godotengine.org */
|
|
/*************************************************************************/
|
|
/* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
|
|
/* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md). */
|
|
/* */
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
/* a copy of this software and associated documentation files (the */
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
/* the following conditions: */
|
|
/* */
|
|
/* The above copyright notice and this permission notice shall be */
|
|
/* included in all copies or substantial portions of the Software. */
|
|
/* */
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
/*************************************************************************/
|
|
|
|
#include "bindings_generator.h"
|
|
|
|
#if defined(DEBUG_METHODS_ENABLED) && defined(TOOLS_ENABLED)
|
|
|
|
#include "core/config/engine.h"
|
|
#include "core/core_constants.h"
|
|
#include "core/io/compression.h"
|
|
#include "core/io/dir_access.h"
|
|
#include "core/io/file_access.h"
|
|
#include "core/os/os.h"
|
|
#include "core/string/ucaps.h"
|
|
#include "main/main.h"
|
|
|
|
#include "../godotsharp_defs.h"
|
|
#include "../utils/path_utils.h"
|
|
#include "../utils/string_utils.h"
|
|
|
|
StringBuilder &operator<<(StringBuilder &r_sb, const String &p_string) {
|
|
r_sb.append(p_string);
|
|
return r_sb;
|
|
}
|
|
|
|
StringBuilder &operator<<(StringBuilder &r_sb, const char *p_cstring) {
|
|
r_sb.append(p_cstring);
|
|
return r_sb;
|
|
}
|
|
|
|
#define CS_INDENT " " // 4 whitespaces
|
|
|
|
#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_L1 INDENT1 OPEN_BLOCK
|
|
#define OPEN_BLOCK_L2 INDENT2 OPEN_BLOCK
|
|
#define OPEN_BLOCK_L3 INDENT3 OPEN_BLOCK
|
|
#define CLOSE_BLOCK_L2 INDENT2 CLOSE_BLOCK
|
|
#define CLOSE_BLOCK_L3 INDENT3 CLOSE_BLOCK
|
|
#define CLOSE_BLOCK_L4 INDENT4 CLOSE_BLOCK
|
|
|
|
#define CS_PARAM_MEMORYOWN "memoryOwn"
|
|
#define CS_PARAM_METHODBIND "method"
|
|
#define CS_PARAM_INSTANCE "ptr"
|
|
#define CS_STATIC_METHOD_GETINSTANCE "GetPtr"
|
|
#define CS_METHOD_CALL "Call"
|
|
#define CS_PROPERTY_SINGLETON "Singleton"
|
|
|
|
#define CS_STATIC_FIELD_NATIVE_CTOR "NativeCtor"
|
|
#define CS_STATIC_FIELD_METHOD_BIND_PREFIX "MethodBind"
|
|
#define CS_STATIC_FIELD_SIGNAL_NAME_PREFIX "SignalName_"
|
|
|
|
#define ICALL_PREFIX "godot_icall_"
|
|
#define ICALL_CLASSDB_GET_METHOD "ClassDB_get_method"
|
|
#define ICALL_CLASSDB_GET_CONSTRUCTOR "ClassDB_get_constructor"
|
|
|
|
#define C_LOCAL_RET "ret"
|
|
#define C_LOCAL_VARARG_RET "vararg_ret"
|
|
#define C_LOCAL_PTRCALL_ARGS "call_args"
|
|
|
|
#define C_CLASS_NATIVE_FUNCS "NativeFuncs"
|
|
#define C_NS_MONOUTILS "InteropUtils"
|
|
#define C_METHOD_TIE_MANAGED_TO_UNMANAGED "NativeInterop." C_NS_MONOUTILS ".TieManagedToUnmanaged"
|
|
#define C_METHOD_UNMANAGED_GET_MANAGED C_NS_MONOUTILS ".UnmanagedGetManaged"
|
|
#define C_METHOD_ENGINE_GET_SINGLETON "NativeInterop." C_NS_MONOUTILS ".EngineGetSingleton"
|
|
|
|
#define C_NS_MONOMARSHAL "Marshaling"
|
|
#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_CALLABLE C_NS_MONOMARSHAL ".ConvertCallableToNative"
|
|
#define C_METHOD_MANAGED_FROM_CALLABLE C_NS_MONOMARSHAL ".ConvertCallableToManaged"
|
|
#define C_METHOD_MANAGED_TO_SIGNAL C_NS_MONOMARSHAL ".ConvertSignalToNative"
|
|
#define C_METHOD_MANAGED_FROM_SIGNAL C_NS_MONOMARSHAL ".ConvertSignalToManaged"
|
|
|
|
typedef String string;
|
|
void BindingsGenerator::TypeInterface::postsetup_enum_type(BindingsGenerator::TypeInterface &r_enum_itype) {
|
|
// C interface for enums is the same as that of 'uint32_t'. Remember to apply
|
|
// any of the changes done here to the 'uint32_t' type interface as well.
|
|
|
|
r_enum_itype.cs_type = r_enum_itype.proxy_name;
|
|
r_enum_itype.cs_in = "(int)%s";
|
|
r_enum_itype.cs_out = "%5return (%2)%0(%1);";
|
|
|
|
{
|
|
// The expected types for parameters and return value in ptrcall are 'int64_t' or 'uint64_t'.
|
|
r_enum_itype.c_in = "%5%0 %1_in = %1;\n";
|
|
r_enum_itype.c_out = "%5return (%0)%1;\n";
|
|
r_enum_itype.c_type = "long";
|
|
r_enum_itype.c_arg_in = "&%s_in";
|
|
}
|
|
r_enum_itype.c_type_in = "int";
|
|
r_enum_itype.c_type_out = r_enum_itype.c_type_in;
|
|
r_enum_itype.class_doc = &EditorHelp::get_doc_data()->class_list[r_enum_itype.proxy_name];
|
|
}
|
|
|
|
static String fix_doc_description(const String &p_bbcode) {
|
|
// This seems to be the correct way to do this. It's the same EditorHelp does.
|
|
|
|
return p_bbcode.dedent()
|
|
.replace("\t", "")
|
|
.replace("\r", "")
|
|
.strip_edges();
|
|
}
|
|
|
|
static String snake_to_pascal_case(const String &p_identifier, bool p_input_is_upper = false) {
|
|
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]);
|
|
if (p_input_is_upper) {
|
|
for (int j = 1; j < part.length(); j++) {
|
|
part[j] = _find_lower(part[j]);
|
|
}
|
|
}
|
|
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;
|
|
}
|
|
|
|
static String snake_to_camel_case(const String &p_identifier, bool p_input_is_upper = false) {
|
|
String ret;
|
|
Vector<String> parts = p_identifier.split("_", true);
|
|
|
|
for (int i = 0; i < parts.size(); i++) {
|
|
String part = parts[i];
|
|
|
|
if (part.length()) {
|
|
if (i != 0) {
|
|
part[0] = _find_upper(part[0]);
|
|
}
|
|
if (p_input_is_upper) {
|
|
for (int j = i != 0 ? 1 : 0; j < part.length(); j++) {
|
|
part[j] = _find_lower(part[j]);
|
|
}
|
|
}
|
|
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;
|
|
}
|
|
|
|
String BindingsGenerator::bbcode_to_xml(const String &p_bbcode, const TypeInterface *p_itype) {
|
|
// Based on the version in EditorHelp
|
|
|
|
if (p_bbcode.is_empty()) {
|
|
return String();
|
|
}
|
|
|
|
DocTools *doc = EditorHelp::get_doc_data();
|
|
|
|
String bbcode = p_bbcode;
|
|
|
|
StringBuilder xml_output;
|
|
|
|
xml_output.append("<para>");
|
|
|
|
List<String> tag_stack;
|
|
bool code_tag = false;
|
|
|
|
int pos = 0;
|
|
while (pos < bbcode.length()) {
|
|
int brk_pos = bbcode.find("[", pos);
|
|
|
|
if (brk_pos < 0) {
|
|
brk_pos = bbcode.length();
|
|
}
|
|
|
|
if (brk_pos > pos) {
|
|
String text = bbcode.substr(pos, brk_pos - pos);
|
|
if (code_tag || tag_stack.size() > 0) {
|
|
xml_output.append(text.xml_escape());
|
|
} else {
|
|
Vector<String> lines = text.split("\n");
|
|
for (int i = 0; i < lines.size(); i++) {
|
|
if (i != 0) {
|
|
xml_output.append("<para>");
|
|
}
|
|
|
|
xml_output.append(lines[i].xml_escape());
|
|
|
|
if (i != lines.size() - 1) {
|
|
xml_output.append("</para>\n");
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
if (brk_pos == bbcode.length()) {
|
|
break; // nothing else to add
|
|
}
|
|
|
|
int brk_end = bbcode.find("]", brk_pos + 1);
|
|
|
|
if (brk_end == -1) {
|
|
String text = bbcode.substr(brk_pos, bbcode.length() - brk_pos);
|
|
if (code_tag || tag_stack.size() > 0) {
|
|
xml_output.append(text.xml_escape());
|
|
} else {
|
|
Vector<String> lines = text.split("\n");
|
|
for (int i = 0; i < lines.size(); i++) {
|
|
if (i != 0) {
|
|
xml_output.append("<para>");
|
|
}
|
|
|
|
xml_output.append(lines[i].xml_escape());
|
|
|
|
if (i != lines.size() - 1) {
|
|
xml_output.append("</para>\n");
|
|
}
|
|
}
|
|
}
|
|
|
|
break;
|
|
}
|
|
|
|
String tag = bbcode.substr(brk_pos + 1, brk_end - brk_pos - 1);
|
|
|
|
if (tag.begins_with("/")) {
|
|
bool tag_ok = tag_stack.size() && tag_stack.front()->get() == tag.substr(1, tag.length());
|
|
|
|
if (!tag_ok) {
|
|
xml_output.append("[");
|
|
pos = brk_pos + 1;
|
|
continue;
|
|
}
|
|
|
|
tag_stack.pop_front();
|
|
pos = brk_end + 1;
|
|
code_tag = false;
|
|
|
|
if (tag == "/url") {
|
|
xml_output.append("</a>");
|
|
} else if (tag == "/code") {
|
|
xml_output.append("</c>");
|
|
} else if (tag == "/codeblock") {
|
|
xml_output.append("</code>");
|
|
}
|
|
} else if (code_tag) {
|
|
xml_output.append("[");
|
|
pos = brk_pos + 1;
|
|
} else if (tag.begins_with("method ") || tag.begins_with("member ") || tag.begins_with("signal ") || tag.begins_with("enum ") || tag.begins_with("constant ")) {
|
|
String link_target = tag.substr(tag.find(" ") + 1, tag.length());
|
|
String link_tag = tag.substr(0, tag.find(" "));
|
|
|
|
Vector<String> link_target_parts = link_target.split(".");
|
|
|
|
if (link_target_parts.size() <= 0 || link_target_parts.size() > 2) {
|
|
ERR_PRINT("Invalid reference format: '" + tag + "'.");
|
|
|
|
xml_output.append("<c>");
|
|
xml_output.append(tag);
|
|
xml_output.append("</c>");
|
|
|
|
pos = brk_end + 1;
|
|
continue;
|
|
}
|
|
|
|
const TypeInterface *target_itype;
|
|
StringName target_cname;
|
|
|
|
if (link_target_parts.size() == 2) {
|
|
target_itype = _get_type_or_null(TypeReference(link_target_parts[0]));
|
|
if (!target_itype) {
|
|
target_itype = _get_type_or_null(TypeReference("_" + link_target_parts[0]));
|
|
}
|
|
target_cname = link_target_parts[1];
|
|
} else {
|
|
target_itype = p_itype;
|
|
target_cname = link_target_parts[0];
|
|
}
|
|
|
|
if (link_tag == "method") {
|
|
if (!target_itype || !target_itype->is_object_type) {
|
|
if (OS::get_singleton()->is_stdout_verbose()) {
|
|
if (target_itype) {
|
|
OS::get_singleton()->print("Cannot resolve method reference for non-Godot.Object type in documentation: %s\n", link_target.utf8().get_data());
|
|
} else {
|
|
OS::get_singleton()->print("Cannot resolve type from method reference in documentation: %s\n", link_target.utf8().get_data());
|
|
}
|
|
}
|
|
|
|
// TODO Map what we can
|
|
xml_output.append("<c>");
|
|
xml_output.append(link_target);
|
|
xml_output.append("</c>");
|
|
} else {
|
|
const MethodInterface *target_imethod = target_itype->find_method_by_name(target_cname);
|
|
|
|
if (target_imethod) {
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE ".");
|
|
xml_output.append(target_itype->proxy_name);
|
|
xml_output.append(".");
|
|
xml_output.append(target_imethod->proxy_name);
|
|
xml_output.append("\"/>");
|
|
}
|
|
}
|
|
} else if (link_tag == "member") {
|
|
if (!target_itype || !target_itype->is_object_type) {
|
|
if (OS::get_singleton()->is_stdout_verbose()) {
|
|
if (target_itype) {
|
|
OS::get_singleton()->print("Cannot resolve member reference for non-Godot.Object type in documentation: %s\n", link_target.utf8().get_data());
|
|
} else {
|
|
OS::get_singleton()->print("Cannot resolve type from member reference in documentation: %s\n", link_target.utf8().get_data());
|
|
}
|
|
}
|
|
|
|
// TODO Map what we can
|
|
xml_output.append("<c>");
|
|
xml_output.append(link_target);
|
|
xml_output.append("</c>");
|
|
} else {
|
|
const PropertyInterface *target_iprop = target_itype->find_property_by_name(target_cname);
|
|
|
|
if (target_iprop) {
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE ".");
|
|
xml_output.append(target_itype->proxy_name);
|
|
xml_output.append(".");
|
|
xml_output.append(target_iprop->proxy_name);
|
|
xml_output.append("\"/>");
|
|
}
|
|
}
|
|
} else if (link_tag == "signal") {
|
|
// We do not declare signals in any way in C#, so there is nothing to reference
|
|
xml_output.append("<c>");
|
|
xml_output.append(link_target);
|
|
xml_output.append("</c>");
|
|
} else if (link_tag == "enum") {
|
|
StringName search_cname = !target_itype ? target_cname :
|
|
StringName(target_itype->name + "." + (String)target_cname);
|
|
|
|
const Map<StringName, TypeInterface>::Element *enum_match = enum_types.find(search_cname);
|
|
|
|
if (!enum_match && search_cname != target_cname) {
|
|
enum_match = enum_types.find(target_cname);
|
|
}
|
|
|
|
if (enum_match) {
|
|
const TypeInterface &target_enum_itype = enum_match->value();
|
|
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE ".");
|
|
xml_output.append(target_enum_itype.proxy_name); // Includes nesting class if any
|
|
xml_output.append("\"/>");
|
|
} else {
|
|
ERR_PRINT("Cannot resolve enum reference in documentation: '" + link_target + "'.");
|
|
|
|
xml_output.append("<c>");
|
|
xml_output.append(link_target);
|
|
xml_output.append("</c>");
|
|
}
|
|
} else if (link_tag == "const") {
|
|
if (!target_itype || !target_itype->is_object_type) {
|
|
if (OS::get_singleton()->is_stdout_verbose()) {
|
|
if (target_itype) {
|
|
OS::get_singleton()->print("Cannot resolve constant reference for non-Godot.Object type in documentation: %s\n", link_target.utf8().get_data());
|
|
} else {
|
|
OS::get_singleton()->print("Cannot resolve type from constant reference in documentation: %s\n", link_target.utf8().get_data());
|
|
}
|
|
}
|
|
|
|
// TODO Map what we can
|
|
xml_output.append("<c>");
|
|
xml_output.append(link_target);
|
|
xml_output.append("</c>");
|
|
} else if (!target_itype && target_cname == name_cache.type_at_GlobalScope) {
|
|
String target_name = (String)target_cname;
|
|
|
|
// Try to find as a global constant
|
|
const ConstantInterface *target_iconst = find_constant_by_name(target_name, global_constants);
|
|
|
|
if (target_iconst) {
|
|
// Found global constant
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE "." BINDINGS_GLOBAL_SCOPE_CLASS ".");
|
|
xml_output.append(target_iconst->proxy_name);
|
|
xml_output.append("\"/>");
|
|
} else {
|
|
// Try to find as global enum constant
|
|
const EnumInterface *target_ienum = nullptr;
|
|
|
|
for (const EnumInterface &ienum : global_enums) {
|
|
target_ienum = &ienum;
|
|
target_iconst = find_constant_by_name(target_name, target_ienum->constants);
|
|
if (target_iconst) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (target_iconst) {
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE ".");
|
|
xml_output.append(target_ienum->cname);
|
|
xml_output.append(".");
|
|
xml_output.append(target_iconst->proxy_name);
|
|
xml_output.append("\"/>");
|
|
} else {
|
|
ERR_PRINT("Cannot resolve global constant reference in documentation: '" + link_target + "'.");
|
|
|
|
xml_output.append("<c>");
|
|
xml_output.append(link_target);
|
|
xml_output.append("</c>");
|
|
}
|
|
}
|
|
} else {
|
|
String target_name = (String)target_cname;
|
|
|
|
// Try to find the constant in the current class
|
|
const ConstantInterface *target_iconst = find_constant_by_name(target_name, target_itype->constants);
|
|
|
|
if (target_iconst) {
|
|
// Found constant in current class
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE ".");
|
|
xml_output.append(target_itype->proxy_name);
|
|
xml_output.append(".");
|
|
xml_output.append(target_iconst->proxy_name);
|
|
xml_output.append("\"/>");
|
|
} else {
|
|
// Try to find as enum constant in the current class
|
|
const EnumInterface *target_ienum = nullptr;
|
|
|
|
for (const EnumInterface &ienum : target_itype->enums) {
|
|
target_ienum = &ienum;
|
|
target_iconst = find_constant_by_name(target_name, target_ienum->constants);
|
|
if (target_iconst) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
if (target_iconst) {
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE ".");
|
|
xml_output.append(target_itype->proxy_name);
|
|
xml_output.append(".");
|
|
xml_output.append(target_ienum->cname);
|
|
xml_output.append(".");
|
|
xml_output.append(target_iconst->proxy_name);
|
|
xml_output.append("\"/>");
|
|
} else {
|
|
ERR_PRINT("Cannot resolve constant reference in documentation: '" + link_target + "'.");
|
|
|
|
xml_output.append("<c>");
|
|
xml_output.append(link_target);
|
|
xml_output.append("</c>");
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
pos = brk_end + 1;
|
|
} else if (doc->class_list.has(tag)) {
|
|
if (tag == "Array" || tag == "Dictionary") {
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE_COLLECTIONS ".");
|
|
xml_output.append(tag);
|
|
xml_output.append("\"/>");
|
|
} else if (tag == "bool" || tag == "int") {
|
|
xml_output.append("<see cref=\"");
|
|
xml_output.append(tag);
|
|
xml_output.append("\"/>");
|
|
} else if (tag == "float") {
|
|
xml_output.append("<see cref=\""
|
|
#ifdef REAL_T_IS_DOUBLE
|
|
"double"
|
|
#else
|
|
"float"
|
|
#endif
|
|
"\"/>");
|
|
} else if (tag == "Variant") {
|
|
// We use System.Object for Variant, so there is no Variant type in C#
|
|
xml_output.append("<c>Variant</c>");
|
|
} else if (tag == "String") {
|
|
xml_output.append("<see cref=\"string\"/>");
|
|
} else if (tag == "Nil") {
|
|
xml_output.append("<see langword=\"null\"/>");
|
|
} else if (tag.begins_with("@")) {
|
|
// @GlobalScope, @GDScript, etc
|
|
xml_output.append("<c>");
|
|
xml_output.append(tag);
|
|
xml_output.append("</c>");
|
|
} else if (tag == "PackedByteArray") {
|
|
xml_output.append("<see cref=\"T:byte[]\"/>");
|
|
} else if (tag == "PackedInt32Array") {
|
|
xml_output.append("<see cref=\"T:int[]\"/>");
|
|
} else if (tag == "PackedInt64Array") {
|
|
xml_output.append("<see cref=\"T:long[]\"/>");
|
|
} else if (tag == "PackedFloat32Array") {
|
|
xml_output.append("<see cref=\"T:float[]\"/>");
|
|
} else if (tag == "PackedFloat64Array") {
|
|
xml_output.append("<see cref=\"T:double[]\"/>");
|
|
} else if (tag == "PackedStringArray") {
|
|
xml_output.append("<see cref=\"T:string[]\"/>");
|
|
} else if (tag == "PackedVector2Array") {
|
|
xml_output.append("<see cref=\"T:" BINDINGS_NAMESPACE ".Vector2[]\"/>");
|
|
} else if (tag == "PackedVector3Array") {
|
|
xml_output.append("<see cref=\"T:" BINDINGS_NAMESPACE ".Vector3[]\"/>");
|
|
} else if (tag == "PackedColorArray") {
|
|
xml_output.append("<see cref=\"T:" BINDINGS_NAMESPACE ".Color[]\"/>");
|
|
} else {
|
|
const TypeInterface *target_itype = _get_type_or_null(TypeReference(tag));
|
|
|
|
if (!target_itype) {
|
|
target_itype = _get_type_or_null(TypeReference("_" + tag));
|
|
}
|
|
|
|
if (target_itype) {
|
|
xml_output.append("<see cref=\"" BINDINGS_NAMESPACE ".");
|
|
xml_output.append(target_itype->proxy_name);
|
|
xml_output.append("\"/>");
|
|
} else {
|
|
ERR_PRINT("Cannot resolve type reference in documentation: '" + tag + "'.");
|
|
|
|
xml_output.append("<c>");
|
|
xml_output.append(tag);
|
|
xml_output.append("</c>");
|
|
}
|
|
}
|
|
|
|
pos = brk_end + 1;
|
|
} else if (tag == "b") {
|
|
// bold is not supported in xml comments
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag == "i") {
|
|
// italics is not supported in xml comments
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag == "code") {
|
|
xml_output.append("<c>");
|
|
|
|
code_tag = true;
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag == "codeblock") {
|
|
xml_output.append("<code>");
|
|
|
|
code_tag = true;
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag == "kbd") {
|
|
// keyboard combinations are not supported in xml comments
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag == "center") {
|
|
// center alignment is not supported in xml comments
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag == "br") {
|
|
xml_output.append("\n"); // FIXME: Should use <para> instead. Luckily this tag isn't used for now.
|
|
pos = brk_end + 1;
|
|
} else if (tag == "u") {
|
|
// underline is not supported in xml comments
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag == "s") {
|
|
// strikethrough is not supported in xml comments
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag == "url") {
|
|
int end = bbcode.find("[", brk_end);
|
|
if (end == -1) {
|
|
end = bbcode.length();
|
|
}
|
|
String url = bbcode.substr(brk_end + 1, end - brk_end - 1);
|
|
xml_output.append("<a href=\"");
|
|
xml_output.append(url);
|
|
xml_output.append("\">");
|
|
xml_output.append(url);
|
|
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag.begins_with("url=")) {
|
|
String url = tag.substr(4, tag.length());
|
|
xml_output.append("<a href=\"");
|
|
xml_output.append(url);
|
|
xml_output.append("\">");
|
|
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front("url");
|
|
} else if (tag == "img") {
|
|
int end = bbcode.find("[", brk_end);
|
|
if (end == -1) {
|
|
end = bbcode.length();
|
|
}
|
|
String image = bbcode.substr(brk_end + 1, end - brk_end - 1);
|
|
|
|
// Not supported. Just append the bbcode.
|
|
xml_output.append("[img]");
|
|
xml_output.append(image);
|
|
xml_output.append("[/img]");
|
|
|
|
pos = end;
|
|
tag_stack.push_front(tag);
|
|
} else if (tag.begins_with("color=")) {
|
|
// Not supported.
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front("color");
|
|
} else if (tag.begins_with("font=")) {
|
|
// Not supported.
|
|
pos = brk_end + 1;
|
|
tag_stack.push_front("font");
|
|
} else {
|
|
xml_output.append("["); // ignore
|
|
pos = brk_pos + 1;
|
|
}
|
|
}
|
|
|
|
xml_output.append("</para>");
|
|
|
|
return xml_output.as_string();
|
|
}
|
|
|
|
int BindingsGenerator::_determine_enum_prefix(const EnumInterface &p_ienum) {
|
|
CRASH_COND(p_ienum.constants.is_empty());
|
|
|
|
const ConstantInterface &front_iconstant = p_ienum.constants.front()->get();
|
|
Vector<String> front_parts = front_iconstant.name.split("_", /* p_allow_empty: */ true);
|
|
int candidate_len = front_parts.size() - 1;
|
|
|
|
if (candidate_len == 0) {
|
|
return 0;
|
|
}
|
|
|
|
for (const ConstantInterface &iconstant : p_ienum.constants) {
|
|
Vector<String> parts = iconstant.name.split("_", /* p_allow_empty: */ true);
|
|
|
|
int i;
|
|
for (i = 0; i < candidate_len && i < parts.size(); i++) {
|
|
if (front_parts[i] != parts[i]) {
|
|
// HARDCODED: Some Flag enums have the prefix 'FLAG_' for everything except 'FLAGS_DEFAULT' (same for 'METHOD_FLAG_' and'METHOD_FLAGS_DEFAULT').
|
|
bool hardcoded_exc = (i == candidate_len - 1 && ((front_parts[i] == "FLAGS" && parts[i] == "FLAG") || (front_parts[i] == "FLAG" && parts[i] == "FLAGS")));
|
|
if (!hardcoded_exc) {
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
candidate_len = i;
|
|
|
|
if (candidate_len == 0) {
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
return candidate_len;
|
|
}
|
|
|
|
void BindingsGenerator::_apply_prefix_to_enum_constants(BindingsGenerator::EnumInterface &p_ienum, int p_prefix_length) {
|
|
if (p_prefix_length > 0) {
|
|
for (ConstantInterface &iconstant : p_ienum.constants) {
|
|
int curr_prefix_length = p_prefix_length;
|
|
|
|
String constant_name = iconstant.name;
|
|
|
|
Vector<String> parts = constant_name.split("_", /* p_allow_empty: */ true);
|
|
|
|
if (parts.size() <= curr_prefix_length) {
|
|
continue;
|
|
}
|
|
|
|
if (parts[curr_prefix_length][0] >= '0' && parts[curr_prefix_length][0] <= '9') {
|
|
// The name of enum constants may begin with a numeric digit when strip from the enum prefix,
|
|
// so we make the prefix for this constant one word shorter in those cases.
|
|
for (curr_prefix_length = curr_prefix_length - 1; curr_prefix_length > 0; curr_prefix_length--) {
|
|
if (parts[curr_prefix_length][0] < '0' || parts[curr_prefix_length][0] > '9') {
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
constant_name = "";
|
|
for (int i = curr_prefix_length; i < parts.size(); i++) {
|
|
if (i > curr_prefix_length) {
|
|
constant_name += "_";
|
|
}
|
|
constant_name += parts[i];
|
|
}
|
|
|
|
iconstant.proxy_name = snake_to_pascal_case(constant_name, true);
|
|
}
|
|
}
|
|
}
|
|
|
|
Error BindingsGenerator::_populate_method_icalls_table(const TypeInterface &p_itype) {
|
|
for (const MethodInterface &imethod : p_itype.methods) {
|
|
if (imethod.is_virtual) {
|
|
continue;
|
|
}
|
|
|
|
const TypeInterface *return_type = _get_type_or_null(imethod.return_type);
|
|
ERR_FAIL_NULL_V(return_type, ERR_BUG); // Return type not found
|
|
|
|
String im_unique_sig = get_ret_unique_sig(return_type) + ",CallMethodBind,CallInstance";
|
|
|
|
// Get arguments information
|
|
int i = 0;
|
|
for (const ArgumentInterface &iarg : imethod.arguments) {
|
|
const TypeInterface *arg_type = _get_type_or_null(iarg.type);
|
|
ERR_FAIL_NULL_V(arg_type, ERR_BUG); // Argument type not found
|
|
|
|
im_unique_sig += ",";
|
|
im_unique_sig += get_arg_unique_sig(*arg_type);
|
|
|
|
i++;
|
|
}
|
|
|
|
// godot_icall_{argc}_{icallcount}
|
|
String icall_method = ICALL_PREFIX;
|
|
icall_method += itos(imethod.arguments.size());
|
|
icall_method += "_";
|
|
icall_method += itos(method_icalls.size());
|
|
|
|
InternalCall im_icall = InternalCall(p_itype.api_type, icall_method, im_unique_sig);
|
|
|
|
im_icall.is_vararg = imethod.is_vararg;
|
|
im_icall.return_type = imethod.return_type;
|
|
|
|
for (const List<ArgumentInterface>::Element *F = imethod.arguments.front(); F; F = F->next()) {
|
|
im_icall.argument_types.push_back(F->get().type);
|
|
}
|
|
|
|
List<InternalCall>::Element *match = method_icalls.find(im_icall);
|
|
|
|
if (match) {
|
|
if (p_itype.api_type != ClassDB::API_EDITOR) {
|
|
match->get().editor_only = false;
|
|
}
|
|
method_icalls_map.insert(&imethod, &match->get());
|
|
} else {
|
|
List<InternalCall>::Element *added = method_icalls.push_back(im_icall);
|
|
method_icalls_map.insert(&imethod, &added->get());
|
|
}
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
void BindingsGenerator::_generate_array_extensions(StringBuilder &p_output) {
|
|
p_output.append("using System;\n\n");
|
|
p_output.append("namespace " BINDINGS_NAMESPACE "\n" OPEN_BLOCK);
|
|
// The class where we put the extensions doesn't matter, so just use "GD".
|
|
p_output.append(INDENT1 "public static partial class " BINDINGS_GLOBAL_SCOPE_CLASS "\n" INDENT1 "{");
|
|
|
|
#define ARRAY_IS_EMPTY(m_type) \
|
|
p_output.append("\n" INDENT2 "/// <summary>\n"); \
|
|
p_output.append(INDENT2 "/// Returns true if this " #m_type " array is empty or doesn't exist.\n"); \
|
|
p_output.append(INDENT2 "/// </summary>\n"); \
|
|
p_output.append(INDENT2 "/// <param name=\"instance\">The " #m_type " array check.</param>\n"); \
|
|
p_output.append(INDENT2 "/// <returns>Whether or not the array is empty.</returns>\n"); \
|
|
p_output.append(INDENT2 "public static bool IsEmpty(this " #m_type "[] instance)\n"); \
|
|
p_output.append(OPEN_BLOCK_L2); \
|
|
p_output.append(INDENT3 "return instance == null || instance.Length == 0;\n"); \
|
|
p_output.append(INDENT2 CLOSE_BLOCK);
|
|
|
|
#define ARRAY_JOIN(m_type) \
|
|
p_output.append("\n" INDENT2 "/// <summary>\n"); \
|
|
p_output.append(INDENT2 "/// Converts this " #m_type " array to a string delimited by the given string.\n"); \
|
|
p_output.append(INDENT2 "/// </summary>\n"); \
|
|
p_output.append(INDENT2 "/// <param name=\"instance\">The " #m_type " array to convert.</param>\n"); \
|
|
p_output.append(INDENT2 "/// <param name=\"delimiter\">The delimiter to use between items.</param>\n"); \
|
|
p_output.append(INDENT2 "/// <returns>A single string with all items.</returns>\n"); \
|
|
p_output.append(INDENT2 "public static string Join(this " #m_type "[] instance, string delimiter = \", \")\n"); \
|
|
p_output.append(OPEN_BLOCK_L2); \
|
|
p_output.append(INDENT3 "return String.Join(delimiter, instance);\n"); \
|
|
p_output.append(INDENT2 CLOSE_BLOCK);
|
|
|
|
#define ARRAY_STRINGIFY(m_type) \
|
|
p_output.append("\n" INDENT2 "/// <summary>\n"); \
|
|
p_output.append(INDENT2 "/// Converts this " #m_type " array to a string with brackets.\n"); \
|
|
p_output.append(INDENT2 "/// </summary>\n"); \
|
|
p_output.append(INDENT2 "/// <param name=\"instance\">The " #m_type " array to convert.</param>\n"); \
|
|
p_output.append(INDENT2 "/// <returns>A single string with all items.</returns>\n"); \
|
|
p_output.append(INDENT2 "public static string Stringify(this " #m_type "[] instance)\n"); \
|
|
p_output.append(OPEN_BLOCK_L2); \
|
|
p_output.append(INDENT3 "return \"[\" + instance.Join() + \"]\";\n"); \
|
|
p_output.append(INDENT2 CLOSE_BLOCK);
|
|
|
|
#define ARRAY_ALL(m_type) \
|
|
ARRAY_IS_EMPTY(m_type) \
|
|
ARRAY_JOIN(m_type) \
|
|
ARRAY_STRINGIFY(m_type)
|
|
|
|
ARRAY_ALL(byte);
|
|
ARRAY_ALL(int);
|
|
ARRAY_ALL(long);
|
|
ARRAY_ALL(float);
|
|
ARRAY_ALL(double);
|
|
ARRAY_ALL(string);
|
|
ARRAY_ALL(Color);
|
|
ARRAY_ALL(Vector2);
|
|
ARRAY_ALL(Vector2i);
|
|
ARRAY_ALL(Vector3);
|
|
ARRAY_ALL(Vector3i);
|
|
|
|
#undef ARRAY_ALL
|
|
#undef ARRAY_IS_EMPTY
|
|
#undef ARRAY_JOIN
|
|
#undef ARRAY_STRINGIFY
|
|
|
|
p_output.append(INDENT1 CLOSE_BLOCK); // End of GD class.
|
|
p_output.append(CLOSE_BLOCK); // End of namespace.
|
|
}
|
|
|
|
void BindingsGenerator::_generate_global_constants(StringBuilder &p_output) {
|
|
// Constants (in partial GD class)
|
|
|
|
p_output.append("\n#pragma warning disable CS1591 // Disable warning: "
|
|
"'Missing XML comment for publicly visible type or member'\n");
|
|
|
|
p_output.append("namespace " BINDINGS_NAMESPACE "\n" OPEN_BLOCK);
|
|
p_output.append(INDENT1 "public static partial class " BINDINGS_GLOBAL_SCOPE_CLASS "\n" INDENT1 "{");
|
|
|
|
for (const ConstantInterface &iconstant : global_constants) {
|
|
if (iconstant.const_doc && iconstant.const_doc->description.size()) {
|
|
String xml_summary = bbcode_to_xml(fix_doc_description(iconstant.const_doc->description), nullptr);
|
|
Vector<String> summary_lines = xml_summary.length() ? xml_summary.split("\n") : Vector<String>();
|
|
|
|
if (summary_lines.size()) {
|
|
p_output.append(MEMBER_BEGIN "/// <summary>\n");
|
|
|
|
for (int i = 0; i < summary_lines.size(); i++) {
|
|
p_output.append(INDENT2 "/// ");
|
|
p_output.append(summary_lines[i]);
|
|
p_output.append("\n");
|
|
}
|
|
|
|
p_output.append(INDENT2 "/// </summary>");
|
|
}
|
|
}
|
|
|
|
p_output.append(MEMBER_BEGIN "public const int ");
|
|
p_output.append(iconstant.proxy_name);
|
|
p_output.append(" = ");
|
|
p_output.append(itos(iconstant.value));
|
|
p_output.append(";");
|
|
}
|
|
|
|
if (!global_constants.is_empty()) {
|
|
p_output.append("\n");
|
|
}
|
|
|
|
p_output.append(INDENT1 CLOSE_BLOCK); // end of GD class
|
|
|
|
// Enums
|
|
|
|
for (const EnumInterface &ienum : global_enums) {
|
|
CRASH_COND(ienum.constants.is_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...
|
|
|
|
_log("Declaring global enum '%s' inside static class '%s'\n", enum_proxy_name.utf8().get_data(), enum_class_name.utf8().get_data());
|
|
|
|
p_output.append("\n" INDENT1 "public static partial class ");
|
|
p_output.append(enum_class_name);
|
|
p_output.append("\n" OPEN_BLOCK_L1);
|
|
}
|
|
|
|
p_output.append("\n" INDENT1 "public enum ");
|
|
p_output.append(enum_proxy_name);
|
|
p_output.append("\n" OPEN_BLOCK_L1);
|
|
|
|
const ConstantInterface &last = ienum.constants.back()->get();
|
|
for (const ConstantInterface &iconstant : ienum.constants) {
|
|
if (iconstant.const_doc && iconstant.const_doc->description.size()) {
|
|
String xml_summary = bbcode_to_xml(fix_doc_description(iconstant.const_doc->description), nullptr);
|
|
Vector<String> summary_lines = xml_summary.length() ? xml_summary.split("\n") : Vector<String>();
|
|
|
|
if (summary_lines.size()) {
|
|
p_output.append(INDENT2 "/// <summary>\n");
|
|
|
|
for (int i = 0; i < summary_lines.size(); i++) {
|
|
p_output.append(INDENT2 "/// ");
|
|
p_output.append(summary_lines[i]);
|
|
p_output.append("\n");
|
|
}
|
|
|
|
p_output.append(INDENT2 "/// </summary>\n");
|
|
}
|
|
}
|
|
|
|
p_output.append(INDENT2);
|
|
p_output.append(iconstant.proxy_name);
|
|
p_output.append(" = ");
|
|
p_output.append(itos(iconstant.value));
|
|
p_output.append(&iconstant != &last ? ",\n" : "\n");
|
|
}
|
|
|
|
p_output.append(INDENT1 CLOSE_BLOCK);
|
|
|
|
if (enum_in_static_class) {
|
|
p_output.append(INDENT1 CLOSE_BLOCK);
|
|
}
|
|
}
|
|
|
|
p_output.append(CLOSE_BLOCK); // end of namespace
|
|
|
|
p_output.append("\n#pragma warning restore CS1591\n");
|
|
}
|
|
|
|
Error BindingsGenerator::generate_cs_core_project(const String &p_proj_dir) {
|
|
ERR_FAIL_COND_V(!initialized, ERR_UNCONFIGURED);
|
|
|
|
DirAccessRef da = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
|
|
ERR_FAIL_COND_V(!da, ERR_CANT_CREATE);
|
|
|
|
if (!DirAccess::exists(p_proj_dir)) {
|
|
Error err = da->make_dir_recursive(p_proj_dir);
|
|
ERR_FAIL_COND_V_MSG(err != OK, ERR_CANT_CREATE, "Cannot create directory '" + p_proj_dir + "'.");
|
|
}
|
|
|
|
da->change_dir(p_proj_dir);
|
|
da->make_dir("Generated");
|
|
da->make_dir("Generated/GodotObjects");
|
|
|
|
String base_gen_dir = path::join(p_proj_dir, "Generated");
|
|
String godot_objects_gen_dir = path::join(base_gen_dir, "GodotObjects");
|
|
|
|
Vector<String> compile_items;
|
|
|
|
// Generate source file for global scope constants and enums
|
|
{
|
|
StringBuilder constants_source;
|
|
_generate_global_constants(constants_source);
|
|
String output_file = path::join(base_gen_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);
|
|
}
|
|
|
|
// Generate source file for array extensions
|
|
{
|
|
StringBuilder extensions_source;
|
|
_generate_array_extensions(extensions_source);
|
|
String output_file = path::join(base_gen_dir, BINDINGS_GLOBAL_SCOPE_CLASS "_extensions.cs");
|
|
Error save_err = _save_file(output_file, extensions_source);
|
|
if (save_err != OK) {
|
|
return save_err;
|
|
}
|
|
|
|
compile_items.push_back(output_file);
|
|
}
|
|
|
|
for (OrderedHashMap<StringName, TypeInterface>::Element E = obj_types.front(); E; E = E.next()) {
|
|
const TypeInterface &itype = E.get();
|
|
|
|
if (itype.api_type == ClassDB::API_EDITOR) {
|
|
continue;
|
|
}
|
|
|
|
String output_file = path::join(godot_objects_gen_dir, itype.proxy_name + ".cs");
|
|
Error err = _generate_cs_type(itype, output_file);
|
|
|
|
if (err == ERR_SKIP) {
|
|
continue;
|
|
}
|
|
|
|
if (err != OK) {
|
|
return err;
|
|
}
|
|
|
|
compile_items.push_back(output_file);
|
|
}
|
|
|
|
// Generate native calls
|
|
|
|
StringBuilder cs_icalls_content;
|
|
|
|
cs_icalls_content.append("using System;\n"
|
|
"using System.Diagnostics.CodeAnalysis;\n"
|
|
"using System.Runtime.InteropServices;\n"
|
|
"using Godot.NativeInterop;\n"
|
|
"\n");
|
|
cs_icalls_content.append("namespace " BINDINGS_NAMESPACE "\n" OPEN_BLOCK);
|
|
cs_icalls_content.append(INDENT1 "[SuppressMessage(\"ReSharper\", \"InconsistentNaming\")]\n");
|
|
cs_icalls_content.append(INDENT1 "[SuppressMessage(\"ReSharper\", \"RedundantUnsafeContext\")]\n");
|
|
cs_icalls_content.append(INDENT1 "[SuppressMessage(\"ReSharper\", \"RedundantNameQualifier\")]\n");
|
|
cs_icalls_content.append("#if NET\n");
|
|
cs_icalls_content.append(INDENT1 "[System.Runtime.CompilerServices.SkipLocalsInit]\n");
|
|
cs_icalls_content.append("#endif\n");
|
|
cs_icalls_content.append(INDENT1 "internal static class " BINDINGS_CLASS_NATIVECALLS "\n" INDENT1 "{");
|
|
|
|
cs_icalls_content.append(MEMBER_BEGIN "internal static ulong godot_api_hash = ");
|
|
cs_icalls_content.append(String::num_uint64(ClassDB::get_api_hash(ClassDB::API_CORE)) + ";\n");
|
|
|
|
for (const InternalCall &icall : method_icalls) {
|
|
if (icall.editor_only) {
|
|
continue;
|
|
}
|
|
Error err = _generate_cs_native_calls(icall, cs_icalls_content);
|
|
if (err != OK) {
|
|
return err;
|
|
}
|
|
}
|
|
|
|
cs_icalls_content.append(INDENT1 CLOSE_BLOCK CLOSE_BLOCK);
|
|
|
|
String internal_methods_file = path::join(base_gen_dir, BINDINGS_CLASS_NATIVECALLS ".cs");
|
|
|
|
Error err = _save_file(internal_methods_file, cs_icalls_content);
|
|
if (err != OK) {
|
|
return err;
|
|
}
|
|
|
|
compile_items.push_back(internal_methods_file);
|
|
|
|
// Generate GeneratedIncludes.props
|
|
|
|
StringBuilder includes_props_content;
|
|
includes_props_content.append("<Project>\n"
|
|
" <ItemGroup>\n");
|
|
|
|
for (int i = 0; i < compile_items.size(); i++) {
|
|
String include = path::relative_to(compile_items[i], p_proj_dir).replace("/", "\\");
|
|
includes_props_content.append(" <Compile Include=\"" + include + "\" />\n");
|
|
}
|
|
|
|
includes_props_content.append(" </ItemGroup>\n"
|
|
"</Project>\n");
|
|
|
|
String includes_props_file = path::join(base_gen_dir, "GeneratedIncludes.props");
|
|
|
|
err = _save_file(includes_props_file, includes_props_content);
|
|
if (err != OK) {
|
|
return err;
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
Error BindingsGenerator::generate_cs_editor_project(const String &p_proj_dir) {
|
|
ERR_FAIL_COND_V(!initialized, ERR_UNCONFIGURED);
|
|
|
|
DirAccessRef da = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
|
|
ERR_FAIL_COND_V(!da, ERR_CANT_CREATE);
|
|
|
|
if (!DirAccess::exists(p_proj_dir)) {
|
|
Error err = da->make_dir_recursive(p_proj_dir);
|
|
ERR_FAIL_COND_V(err != OK, ERR_CANT_CREATE);
|
|
}
|
|
|
|
da->change_dir(p_proj_dir);
|
|
da->make_dir("Generated");
|
|
da->make_dir("Generated/GodotObjects");
|
|
|
|
String base_gen_dir = path::join(p_proj_dir, "Generated");
|
|
String godot_objects_gen_dir = path::join(base_gen_dir, "GodotObjects");
|
|
|
|
Vector<String> compile_items;
|
|
|
|
for (OrderedHashMap<StringName, TypeInterface>::Element E = obj_types.front(); E; E = E.next()) {
|
|
const TypeInterface &itype = E.get();
|
|
|
|
if (itype.api_type != ClassDB::API_EDITOR) {
|
|
continue;
|
|
}
|
|
|
|
String output_file = path::join(godot_objects_gen_dir, itype.proxy_name + ".cs");
|
|
Error err = _generate_cs_type(itype, output_file);
|
|
|
|
if (err == ERR_SKIP) {
|
|
continue;
|
|
}
|
|
|
|
if (err != OK) {
|
|
return err;
|
|
}
|
|
|
|
compile_items.push_back(output_file);
|
|
}
|
|
|
|
// Generate native calls
|
|
|
|
StringBuilder cs_icalls_content;
|
|
|
|
cs_icalls_content.append("using System;\n"
|
|
"using System.Diagnostics.CodeAnalysis;\n"
|
|
"using System.Runtime.InteropServices;\n"
|
|
"using Godot.NativeInterop;\n"
|
|
"\n");
|
|
cs_icalls_content.append("namespace " BINDINGS_NAMESPACE "\n" OPEN_BLOCK);
|
|
cs_icalls_content.append(INDENT1 "[SuppressMessage(\"ReSharper\", \"InconsistentNaming\")]\n");
|
|
cs_icalls_content.append(INDENT1 "[SuppressMessage(\"ReSharper\", \"RedundantUnsafeContext\")]\n");
|
|
cs_icalls_content.append(INDENT1 "[SuppressMessage(\"ReSharper\", \"RedundantNameQualifier\")]\n");
|
|
cs_icalls_content.append("#if NET\n");
|
|
cs_icalls_content.append(INDENT1 "[System.Runtime.CompilerServices.SkipLocalsInit]\n");
|
|
cs_icalls_content.append("#endif\n");
|
|
cs_icalls_content.append(INDENT1 "internal static class " BINDINGS_CLASS_NATIVECALLS_EDITOR "\n" OPEN_BLOCK_L1);
|
|
|
|
cs_icalls_content.append(INDENT2 "internal static ulong godot_api_hash = ");
|
|
cs_icalls_content.append(String::num_uint64(ClassDB::get_api_hash(ClassDB::API_EDITOR)) + ";\n");
|
|
cs_icalls_content.append("\n");
|
|
|
|
for (const InternalCall &icall : method_icalls) {
|
|
if (!icall.editor_only) {
|
|
continue;
|
|
}
|
|
Error err = _generate_cs_native_calls(icall, cs_icalls_content);
|
|
if (err != OK) {
|
|
return err;
|
|
}
|
|
}
|
|
|
|
cs_icalls_content.append(INDENT1 CLOSE_BLOCK CLOSE_BLOCK);
|
|
|
|
String internal_methods_file = path::join(base_gen_dir, BINDINGS_CLASS_NATIVECALLS_EDITOR ".cs");
|
|
|
|
Error err = _save_file(internal_methods_file, cs_icalls_content);
|
|
if (err != OK) {
|
|
return err;
|
|
}
|
|
|
|
compile_items.push_back(internal_methods_file);
|
|
|
|
// Generate GeneratedIncludes.props
|
|
|
|
StringBuilder includes_props_content;
|
|
includes_props_content.append("<Project>\n"
|
|
" <ItemGroup>\n");
|
|
|
|
for (int i = 0; i < compile_items.size(); i++) {
|
|
String include = path::relative_to(compile_items[i], p_proj_dir).replace("/", "\\");
|
|
includes_props_content.append(" <Compile Include=\"" + include + "\" />\n");
|
|
}
|
|
|
|
includes_props_content.append(" </ItemGroup>\n"
|
|
"</Project>\n");
|
|
|
|
String includes_props_file = path::join(base_gen_dir, "GeneratedIncludes.props");
|
|
|
|
err = _save_file(includes_props_file, includes_props_content);
|
|
if (err != OK) {
|
|
return err;
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
Error BindingsGenerator::generate_cs_api(const String &p_output_dir) {
|
|
ERR_FAIL_COND_V(!initialized, ERR_UNCONFIGURED);
|
|
|
|
String output_dir = path::abspath(path::realpath(p_output_dir));
|
|
|
|
DirAccessRef da = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
|
|
ERR_FAIL_COND_V(!da, ERR_CANT_CREATE);
|
|
|
|
if (!DirAccess::exists(output_dir)) {
|
|
Error err = da->make_dir_recursive(output_dir);
|
|
ERR_FAIL_COND_V(err != OK, ERR_CANT_CREATE);
|
|
}
|
|
|
|
Error proj_err;
|
|
|
|
// Generate GodotSharp source files
|
|
|
|
String core_proj_dir = output_dir.plus_file(CORE_API_ASSEMBLY_NAME);
|
|
|
|
proj_err = generate_cs_core_project(core_proj_dir);
|
|
if (proj_err != OK) {
|
|
ERR_PRINT("Generation of the Core API C# project failed.");
|
|
return proj_err;
|
|
}
|
|
|
|
// Generate GodotSharpEditor source files
|
|
|
|
String editor_proj_dir = output_dir.plus_file(EDITOR_API_ASSEMBLY_NAME);
|
|
|
|
proj_err = generate_cs_editor_project(editor_proj_dir);
|
|
if (proj_err != OK) {
|
|
ERR_PRINT("Generation of the Editor API C# project failed.");
|
|
return proj_err;
|
|
}
|
|
|
|
_log("The Godot API sources were successfully generated\n");
|
|
|
|
return OK;
|
|
}
|
|
|
|
// FIXME: There are some members that hide other inherited members.
|
|
// - In the case of both members being the same kind, the new one must be declared
|
|
// explicitly as 'new' to avoid the warning (and we must print a message about it).
|
|
// - In the case of both members being of a different kind, then the new one must
|
|
// be renamed to avoid the name collision (and we must print a warning about it).
|
|
// - Csc warning e.g.:
|
|
// ObjectType/LineEdit.cs(140,38): warning CS0108: 'LineEdit.FocusMode' hides inherited member 'Control.FocusMode'. Use the new keyword if hiding was intended.
|
|
Error BindingsGenerator::_generate_cs_type(const TypeInterface &itype, const String &p_output_file) {
|
|
CRASH_COND(!itype.is_object_type);
|
|
|
|
bool is_derived_type = itype.base_name != StringName();
|
|
|
|
if (!is_derived_type) {
|
|
// Some Godot.Object assertions
|
|
CRASH_COND(itype.cname != name_cache.type_Object);
|
|
CRASH_COND(!itype.is_instantiable);
|
|
CRASH_COND(itype.api_type != ClassDB::API_CORE);
|
|
CRASH_COND(itype.is_ref_counted);
|
|
CRASH_COND(itype.is_singleton);
|
|
}
|
|
|
|
_log("Generating %s.cs...\n", itype.proxy_name.utf8().get_data());
|
|
|
|
StringBuilder output;
|
|
|
|
output.append("using System;\n"); // IntPtr
|
|
output.append("using System.Diagnostics;\n"); // DebuggerBrowsable
|
|
|
|
output.append("\n"
|
|
"#pragma warning disable CS1591 // Disable warning: "
|
|
"'Missing XML comment for publicly visible type or member'\n"
|
|
"#pragma warning disable CS1573 // Disable warning: "
|
|
"'Parameter has no matching param tag in the XML comment'\n");
|
|
|
|
output.append("\nnamespace " BINDINGS_NAMESPACE "\n" OPEN_BLOCK);
|
|
|
|
const DocData::ClassDoc *class_doc = itype.class_doc;
|
|
|
|
if (class_doc && class_doc->description.size()) {
|
|
String xml_summary = bbcode_to_xml(fix_doc_description(class_doc->description), &itype);
|
|
Vector<String> summary_lines = xml_summary.length() ? xml_summary.split("\n") : Vector<String>();
|
|
|
|
if (summary_lines.size()) {
|
|
output.append(INDENT1 "/// <summary>\n");
|
|
|
|
for (int i = 0; i < summary_lines.size(); i++) {
|
|
output.append(INDENT1 "/// ");
|
|
output.append(summary_lines[i]);
|
|
output.append("\n");
|
|
}
|
|
|
|
output.append(INDENT1 "/// </summary>\n");
|
|
}
|
|
}
|
|
|
|
output.append(INDENT1 "public ");
|
|
if (itype.is_singleton) {
|
|
output.append("static partial class ");
|
|
} else {
|
|
output.append(itype.is_instantiable ? "partial class " : "abstract partial class ");
|
|
}
|
|
output.append(itype.proxy_name);
|
|
|
|
if (itype.is_singleton) {
|
|
output.append("\n");
|
|
} else if (is_derived_type) {
|
|
if (obj_types.has(itype.base_name)) {
|
|
output.append(" : ");
|
|
output.append(obj_types[itype.base_name].proxy_name);
|
|
output.append("\n");
|
|
} else {
|
|
ERR_PRINT("Base type '" + itype.base_name.operator String() + "' does not exist, for class '" + itype.name + "'.");
|
|
return ERR_INVALID_DATA;
|
|
}
|
|
}
|
|
|
|
output.append(INDENT1 "{");
|
|
|
|
// Add constants
|
|
|
|
for (const ConstantInterface &iconstant : itype.constants) {
|
|
if (iconstant.const_doc && iconstant.const_doc->description.size()) {
|
|
String xml_summary = bbcode_to_xml(fix_doc_description(iconstant.const_doc->description), &itype);
|
|
Vector<String> summary_lines = xml_summary.length() ? xml_summary.split("\n") : Vector<String>();
|
|
|
|
if (summary_lines.size()) {
|
|
output.append(MEMBER_BEGIN "/// <summary>\n");
|
|
|
|
for (int i = 0; i < summary_lines.size(); i++) {
|
|
output.append(INDENT2 "/// ");
|
|
output.append(summary_lines[i]);
|
|
output.append("\n");
|
|
}
|
|
|
|
output.append(INDENT2 "/// </summary>");
|
|
}
|
|
}
|
|
|
|
output.append(MEMBER_BEGIN "public const int ");
|
|
output.append(iconstant.proxy_name);
|
|
output.append(" = ");
|
|
output.append(itos(iconstant.value));
|
|
output.append(";");
|
|
}
|
|
|
|
if (itype.constants.size()) {
|
|
output.append("\n");
|
|
}
|
|
|
|
// Add enums
|
|
|
|
for (const EnumInterface &ienum : itype.enums) {
|
|
ERR_FAIL_COND_V(ienum.constants.is_empty(), ERR_BUG);
|
|
|
|
output.append(MEMBER_BEGIN "public enum ");
|
|
output.append(ienum.cname.operator String());
|
|
output.append(MEMBER_BEGIN OPEN_BLOCK);
|
|
|
|
const ConstantInterface &last = ienum.constants.back()->get();
|
|
for (const ConstantInterface &iconstant : ienum.constants) {
|
|
if (iconstant.const_doc && iconstant.const_doc->description.size()) {
|
|
String xml_summary = bbcode_to_xml(fix_doc_description(iconstant.const_doc->description), &itype);
|
|
Vector<String> summary_lines = xml_summary.length() ? xml_summary.split("\n") : Vector<String>();
|
|
|
|
if (summary_lines.size()) {
|
|
output.append(INDENT3 "/// <summary>\n");
|
|
|
|
for (int i = 0; i < summary_lines.size(); i++) {
|
|
output.append(INDENT3 "/// ");
|
|
output.append(summary_lines[i]);
|
|
output.append("\n");
|
|
}
|
|
|
|
output.append(INDENT3 "/// </summary>\n");
|
|
}
|
|
}
|
|
|
|
output.append(INDENT3);
|
|
output.append(iconstant.proxy_name);
|
|
output.append(" = ");
|
|
output.append(itos(iconstant.value));
|
|
output.append(&iconstant != &last ? ",\n" : "\n");
|
|
}
|
|
|
|
output.append(INDENT2 CLOSE_BLOCK);
|
|
}
|
|
|
|
// Add properties
|
|
|
|
for (const PropertyInterface &iprop : itype.properties) {
|
|
Error prop_err = _generate_cs_property(itype, iprop, output);
|
|
ERR_FAIL_COND_V_MSG(prop_err != OK, prop_err,
|
|
"Failed to generate property '" + iprop.cname.operator String() +
|
|
"' for class '" + itype.name + "'.");
|
|
}
|
|
|
|
if (itype.is_singleton) {
|
|
// Add the type name and the singleton pointer as static fields
|
|
|
|
output.append(MEMBER_BEGIN "private static Godot.Object singleton;\n");
|
|
|
|
output << MEMBER_BEGIN "public static Godot.Object " CS_PROPERTY_SINGLETON "\n" INDENT2 "{\n"
|
|
<< INDENT3 "get\n" INDENT3 "{\n" INDENT4 "if (singleton == null)\n"
|
|
<< INDENT5 "singleton = " C_METHOD_ENGINE_GET_SINGLETON "(typeof("
|
|
<< itype.proxy_name
|
|
<< ").Name);\n" INDENT4 "return singleton;\n" INDENT3 "}\n" INDENT2 "}\n";
|
|
|
|
output.append(MEMBER_BEGIN "private static readonly StringName " BINDINGS_NATIVE_NAME_FIELD " = \"");
|
|
output.append(itype.name);
|
|
output.append("\";\n");
|
|
} else {
|
|
// IMPORTANT: We also generate the static fields for Godot.Object instead of declaring
|
|
// them manually in the `Object.base.cs` partial class declaration, because they're
|
|
// required by other static fields in this generated partial class declaration.
|
|
// Static fields are initialized in order of declaration, but when they're in different
|
|
// partial class declarations then it becomes harder to tell (Rider warns about this).
|
|
|
|
// Add native name static field
|
|
|
|
output.append(MEMBER_BEGIN "private static readonly StringName " BINDINGS_NATIVE_NAME_FIELD " = \"");
|
|
output.append(itype.name);
|
|
output.append("\";\n");
|
|
|
|
if (itype.is_instantiable) {
|
|
// Add native constructor static field
|
|
|
|
String get_constructor_method = ICALL_CLASSDB_GET_CONSTRUCTOR;
|
|
|
|
if (itype.is_singleton) {
|
|
// Singletons are static classes. They don't derive Godot.Object,
|
|
// so we need to specify the type to call the static method.
|
|
get_constructor_method = "Object." + get_constructor_method;
|
|
}
|
|
|
|
output << MEMBER_BEGIN << "[DebuggerBrowsable(DebuggerBrowsableState.Never)]\n"
|
|
|
|
<< "#if NET\n"
|
|
|
|
<< INDENT2 "private static unsafe readonly delegate* unmanaged<IntPtr> "
|
|
<< CS_STATIC_FIELD_NATIVE_CTOR " = " << get_constructor_method
|
|
<< "(" BINDINGS_NATIVE_NAME_FIELD ");\n"
|
|
|
|
<< "#else\n"
|
|
|
|
// Get rid of this one once we switch to .NET 5/6
|
|
<< INDENT2 "private static readonly IntPtr " CS_STATIC_FIELD_NATIVE_CTOR
|
|
<< " = " << get_constructor_method << "(" BINDINGS_NATIVE_NAME_FIELD ");\n"
|
|
|
|
<< "#endif\n";
|
|
}
|
|
|
|
if (is_derived_type) {
|
|
// Add default constructor
|
|
if (itype.is_instantiable) {
|
|
output << MEMBER_BEGIN "public " << itype.proxy_name << "() : this("
|
|
<< (itype.memory_own ? "true" : "false") << ")\n" OPEN_BLOCK_L2;
|
|
|
|
// 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
|
|
output << INDENT3 "if (" BINDINGS_PTR_FIELD " == IntPtr.Zero)\n" OPEN_BLOCK_L3
|
|
|
|
<< "#if NET\n"
|
|
|
|
<< INDENT4 "unsafe\n" INDENT4 OPEN_BLOCK
|
|
<< INDENT5 BINDINGS_PTR_FIELD " = " CS_STATIC_FIELD_NATIVE_CTOR "();\n"
|
|
<< CLOSE_BLOCK_L4
|
|
|
|
<< "#else\n"
|
|
|
|
// Get rid of this one once we switch to .NET 5/6
|
|
<< INDENT4 BINDINGS_PTR_FIELD " = _gd__invoke_class_constructor(" CS_STATIC_FIELD_NATIVE_CTOR ");\n"
|
|
|
|
<< "#endif\n"
|
|
|
|
<< INDENT4 C_METHOD_TIE_MANAGED_TO_UNMANAGED "(this, " BINDINGS_PTR_FIELD ");\n"
|
|
<< CLOSE_BLOCK_L3
|
|
<< INDENT3 "_InitializeGodotScriptInstanceInternals();\n" CLOSE_BLOCK_L2;
|
|
} else {
|
|
// Hide the constructor
|
|
output.append(MEMBER_BEGIN "internal ");
|
|
output.append(itype.proxy_name);
|
|
output.append("() {}\n");
|
|
}
|
|
|
|
// Add.. em.. trick constructor. Sort of.
|
|
output.append(MEMBER_BEGIN "internal ");
|
|
output.append(itype.proxy_name);
|
|
output.append("(bool " CS_PARAM_MEMORYOWN ") : base(" CS_PARAM_MEMORYOWN ") {}\n");
|
|
}
|
|
}
|
|
|
|
int method_bind_count = 0;
|
|
for (const MethodInterface &imethod : itype.methods) {
|
|
Error method_err = _generate_cs_method(itype, imethod, method_bind_count, output);
|
|
ERR_FAIL_COND_V_MSG(method_err != OK, method_err,
|
|
"Failed to generate method '" + imethod.name + "' for class '" + itype.name + "'.");
|
|
}
|
|
|
|
for (const SignalInterface &isignal : itype.signals_) {
|
|
Error method_err = _generate_cs_signal(itype, isignal, output);
|
|
ERR_FAIL_COND_V_MSG(method_err != OK, method_err,
|
|
"Failed to generate signal '" + isignal.name + "' for class '" + itype.name + "'.");
|
|
}
|
|
|
|
output.append(INDENT1 CLOSE_BLOCK /* class */
|
|
CLOSE_BLOCK /* namespace */);
|
|
|
|
output.append("\n"
|
|
"#pragma warning restore CS1591\n"
|
|
"#pragma warning restore CS1573\n");
|
|
|
|
return _save_file(p_output_file, output);
|
|
}
|
|
|
|
Error BindingsGenerator::_generate_cs_property(const BindingsGenerator::TypeInterface &p_itype, const PropertyInterface &p_iprop, StringBuilder &p_output) {
|
|
const MethodInterface *setter = p_itype.find_method_by_name(p_iprop.setter);
|
|
|
|
// Search it in base types too
|
|
const TypeInterface *current_type = &p_itype;
|
|
while (!setter && current_type->base_name != StringName()) {
|
|
OrderedHashMap<StringName, TypeInterface>::Element base_match = obj_types.find(current_type->base_name);
|
|
ERR_FAIL_COND_V_MSG(!base_match, ERR_BUG, "Type not found '" + current_type->base_name + "'. Inherited by '" + current_type->name + "'.");
|
|
current_type = &base_match.get();
|
|
setter = current_type->find_method_by_name(p_iprop.setter);
|
|
}
|
|
|
|
const MethodInterface *getter = p_itype.find_method_by_name(p_iprop.getter);
|
|
|
|
// Search it in base types too
|
|
current_type = &p_itype;
|
|
while (!getter && current_type->base_name != StringName()) {
|
|
OrderedHashMap<StringName, TypeInterface>::Element base_match = obj_types.find(current_type->base_name);
|
|
ERR_FAIL_COND_V_MSG(!base_match, ERR_BUG, "Type not found '" + current_type->base_name + "'. Inherited by '" + current_type->name + "'.");
|
|
current_type = &base_match.get();
|
|
getter = current_type->find_method_by_name(p_iprop.getter);
|
|
}
|
|
|
|
ERR_FAIL_COND_V(!setter && !getter, ERR_BUG);
|
|
|
|
if (setter) {
|
|
int setter_argc = p_iprop.index != -1 ? 2 : 1;
|
|
ERR_FAIL_COND_V(setter->arguments.size() != setter_argc, ERR_BUG);
|
|
}
|
|
|
|
if (getter) {
|
|
int getter_argc = p_iprop.index != -1 ? 1 : 0;
|
|
ERR_FAIL_COND_V(getter->arguments.size() != getter_argc, ERR_BUG);
|
|
}
|
|
|
|
if (getter && setter) {
|
|
const ArgumentInterface &setter_first_arg = setter->arguments.back()->get();
|
|
if (getter->return_type.cname != setter_first_arg.type.cname) {
|
|
// Special case for Node::set_name
|
|
bool whitelisted = getter->return_type.cname == name_cache.type_StringName &&
|
|
setter_first_arg.type.cname == name_cache.type_String;
|
|
|
|
ERR_FAIL_COND_V_MSG(!whitelisted, ERR_BUG,
|
|
"Return type from getter doesn't match first argument of setter for property: '" +
|
|
p_itype.name + "." + String(p_iprop.cname) + "'.");
|
|
}
|
|
}
|
|
|
|
const TypeReference &proptype_name = getter ? getter->return_type : setter->arguments.back()->get().type;
|
|
|
|
const TypeInterface *prop_itype = _get_type_or_null(proptype_name);
|
|
ERR_FAIL_NULL_V(prop_itype, ERR_BUG); // Property type not found
|
|
|
|
ERR_FAIL_COND_V_MSG(prop_itype->is_singleton, ERR_BUG,
|
|
"Property type is a singleton: '" + p_itype.name + "." + String(p_iprop.cname) + "'.");
|
|
|
|
if (p_itype.api_type == ClassDB::API_CORE) {
|
|
ERR_FAIL_COND_V_MSG(prop_itype->api_type == ClassDB::API_EDITOR, ERR_BUG,
|
|
"Property '" + p_itype.name + "." + String(p_iprop.cname) + "' has type '" + prop_itype->name +
|
|
"' from the editor API. Core API cannot have dependencies on the editor API.");
|
|
}
|
|
|
|
if (p_iprop.prop_doc && p_iprop.prop_doc->description.size()) {
|
|
String xml_summary = bbcode_to_xml(fix_doc_description(p_iprop.prop_doc->description), &p_itype);
|
|
Vector<String> summary_lines = xml_summary.length() ? xml_summary.split("\n") : Vector<String>();
|
|
|
|
if (summary_lines.size()) {
|
|
p_output.append(MEMBER_BEGIN "/// <summary>\n");
|
|
|
|
for (int i = 0; i < summary_lines.size(); i++) {
|
|
p_output.append(INDENT2 "/// ");
|
|
p_output.append(summary_lines[i]);
|
|
p_output.append("\n");
|
|
}
|
|
|
|
p_output.append(INDENT2 "/// </summary>");
|
|
}
|
|
}
|
|
|
|
p_output.append(MEMBER_BEGIN "public ");
|
|
|
|
if (p_itype.is_singleton) {
|
|
p_output.append("static ");
|
|
}
|
|
|
|
p_output.append(prop_itype->cs_type);
|
|
p_output.append(" ");
|
|
p_output.append(p_iprop.proxy_name);
|
|
p_output.append("\n" OPEN_BLOCK_L2);
|
|
|
|
if (getter) {
|
|
p_output.append(INDENT3 "get\n"
|
|
|
|
// TODO Remove this once we make accessor methods private/internal (they will no longer be marked as obsolete after that)
|
|
"#pragma warning disable CS0618 // Disable warning about obsolete method\n"
|
|
|
|
OPEN_BLOCK_L3 INDENT4);
|
|
|
|
p_output.append("return ");
|
|
p_output.append(getter->proxy_name + "(");
|
|
if (p_iprop.index != -1) {
|
|
const ArgumentInterface &idx_arg = getter->arguments.front()->get();
|
|
if (idx_arg.type.cname != name_cache.type_int) {
|
|
// Assume the index parameter is an enum
|
|
const TypeInterface *idx_arg_type = _get_type_or_null(idx_arg.type);
|
|
CRASH_COND(idx_arg_type == nullptr);
|
|
p_output.append("(" + idx_arg_type->proxy_name + ")" + itos(p_iprop.index));
|
|
} else {
|
|
p_output.append(itos(p_iprop.index));
|
|
}
|
|
}
|
|
p_output.append(");\n"
|
|
|
|
CLOSE_BLOCK_L3
|
|
|
|
// TODO Remove this once we make accessor methods private/internal (they will no longer be marked as obsolete after that)
|
|
"#pragma warning restore CS0618\n");
|
|
}
|
|
|
|
if (setter) {
|
|
p_output.append(INDENT3 "set\n"
|
|
|
|
// TODO Remove this once we make accessor methods private/internal (they will no longer be marked as obsolete after that)
|
|
"#pragma warning disable CS0618 // Disable warning about obsolete method\n"
|
|
|
|
OPEN_BLOCK_L3 INDENT4);
|
|
|
|
p_output.append(setter->proxy_name + "(");
|
|
if (p_iprop.index != -1) {
|
|
const ArgumentInterface &idx_arg = setter->arguments.front()->get();
|
|
if (idx_arg.type.cname != name_cache.type_int) {
|
|
// Assume the index parameter is an enum
|
|
const TypeInterface *idx_arg_type = _get_type_or_null(idx_arg.type);
|
|
CRASH_COND(idx_arg_type == nullptr);
|
|
p_output.append("(" + idx_arg_type->proxy_name + ")" + itos(p_iprop.index) + ", ");
|
|
} else {
|
|
p_output.append(itos(p_iprop.index) + ", ");
|
|
}
|
|
}
|
|
p_output.append("value);\n"
|
|
|
|
CLOSE_BLOCK_L3
|
|
|
|
// TODO Remove this once we make accessor methods private/internal (they will no longer be marked as obsolete after that)
|
|
"#pragma warning restore CS0618\n");
|
|
}
|
|
|
|
p_output.append(CLOSE_BLOCK_L2);
|
|
|
|
return OK;
|
|
}
|
|
|
|
Error BindingsGenerator::_generate_cs_method(const BindingsGenerator::TypeInterface &p_itype, const BindingsGenerator::MethodInterface &p_imethod, int &p_method_bind_count, StringBuilder &p_output) {
|
|
const TypeInterface *return_type = _get_type_or_null(p_imethod.return_type);
|
|
ERR_FAIL_NULL_V(return_type, ERR_BUG); // Return type not found
|
|
|
|
ERR_FAIL_COND_V_MSG(return_type->is_singleton, ERR_BUG,
|
|
"Method return type is a singleton: '" + p_itype.name + "." + p_imethod.name + "'.");
|
|
|
|
if (p_itype.api_type == ClassDB::API_CORE) {
|
|
ERR_FAIL_COND_V_MSG(return_type->api_type == ClassDB::API_EDITOR, ERR_BUG,
|
|
"Method '" + p_itype.name + "." + p_imethod.name + "' has return type '" + return_type->name +
|
|
"' from the editor API. Core API cannot have dependencies on the editor API.");
|
|
}
|
|
|
|
String method_bind_field = CS_STATIC_FIELD_METHOD_BIND_PREFIX + itos(p_method_bind_count);
|
|
|
|
String arguments_sig;
|
|
StringBuilder cs_in_statements;
|
|
bool cs_in_is_unsafe = false;
|
|
|
|
String icall_params = method_bind_field + ", ";
|
|
icall_params += sformat(p_itype.cs_in, "this");
|
|
|
|
StringBuilder default_args_doc;
|
|
|
|
// Retrieve information from the arguments
|
|
const ArgumentInterface &first = p_imethod.arguments.front()->get();
|
|
for (const ArgumentInterface &iarg : p_imethod.arguments) {
|
|
const TypeInterface *arg_type = _get_type_or_null(iarg.type);
|
|
ERR_FAIL_NULL_V(arg_type, ERR_BUG); // Argument type not found
|
|
|
|
ERR_FAIL_COND_V_MSG(arg_type->is_singleton, ERR_BUG,
|
|
"Argument type is a singleton: '" + iarg.name + "' of method '" + p_itype.name + "." + p_imethod.name + "'.");
|
|
|
|
if (p_itype.api_type == ClassDB::API_CORE) {
|
|
ERR_FAIL_COND_V_MSG(arg_type->api_type == ClassDB::API_EDITOR, ERR_BUG,
|
|
"Argument '" + iarg.name + "' of method '" + p_itype.name + "." + p_imethod.name + "' has type '" +
|
|
arg_type->name + "' from the editor API. Core API cannot have dependencies on the editor API.");
|
|
}
|
|
|
|
if (iarg.default_argument.size()) {
|
|
CRASH_COND_MSG(!_arg_default_value_is_assignable_to_type(iarg.def_param_value, *arg_type),
|
|
"Invalid default value for parameter '" + iarg.name + "' of method '" + p_itype.name + "." + p_imethod.name + "'.");
|
|
}
|
|
|
|
// 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 (&iarg != &first) {
|
|
arguments_sig += ", ";
|
|
}
|
|
|
|
if (iarg.def_param_mode == ArgumentInterface::NULLABLE_VAL) {
|
|
arguments_sig += "Nullable<";
|
|
}
|
|
|
|
arguments_sig += arg_type->cs_type;
|
|
|
|
if (iarg.def_param_mode == ArgumentInterface::NULLABLE_VAL) {
|
|
arguments_sig += "> ";
|
|
} else {
|
|
arguments_sig += " ";
|
|
}
|
|
|
|
arguments_sig += iarg.name;
|
|
|
|
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);
|
|
}
|
|
}
|
|
}
|
|
|
|
icall_params += ", ";
|
|
|
|
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";
|
|
|
|
cs_in_statements << INDENT3 << arg_type->cs_type << " " << arg_in << " = " << iarg.name;
|
|
|
|
if (iarg.def_param_mode == ArgumentInterface::NULLABLE_VAL) {
|
|
cs_in_statements << ".HasValue ? ";
|
|
} else {
|
|
cs_in_statements << " != null ? ";
|
|
}
|
|
|
|
cs_in_statements << iarg.name;
|
|
|
|
if (iarg.def_param_mode == ArgumentInterface::NULLABLE_VAL) {
|
|
cs_in_statements << ".Value : ";
|
|
} else {
|
|
cs_in_statements << " : ";
|
|
}
|
|
|
|
String cs_type = arg_type->cs_type;
|
|
if (cs_type.ends_with("[]")) {
|
|
cs_type = cs_type.substr(0, cs_type.length() - 2);
|
|
}
|
|
|
|
String def_arg = sformat(iarg.default_argument, cs_type);
|
|
|
|
cs_in_statements << def_arg << ";\n";
|
|
|
|
icall_params += arg_type->cs_in.is_empty() ? arg_in : sformat(arg_type->cs_in, arg_in);
|
|
|
|
// Apparently the name attribute must not include the @
|
|
String param_tag_name = iarg.name.begins_with("@") ? iarg.name.substr(1, iarg.name.length()) : iarg.name;
|
|
// Escape < and > in the attribute default value
|
|
String param_def_arg = def_arg.replacen("<", "<").replacen(">", ">");
|
|
|
|
default_args_doc.append(MEMBER_BEGIN "/// <param name=\"" + param_tag_name + "\">If the parameter is null, then the default value is " + param_def_arg + "</param>");
|
|
} else {
|
|
icall_params += arg_type->cs_in.is_empty() ? iarg.name : sformat(arg_type->cs_in, iarg.name);
|
|
}
|
|
|
|
cs_in_is_unsafe |= arg_type->cs_in_is_unsafe;
|
|
}
|
|
|
|
// Generate method
|
|
{
|
|
if (!p_imethod.is_virtual && !p_imethod.requires_object_call) {
|
|
p_output << MEMBER_BEGIN "[DebuggerBrowsable(DebuggerBrowsableState.Never)]" MEMBER_BEGIN "private static readonly IntPtr "
|
|
<< method_bind_field << " = ";
|
|
|
|
if (p_itype.is_singleton) {
|
|
// Singletons are static classes. They don't derive Godot.Object,
|
|
// so we need to specify the type to call the static method.
|
|
p_output << "Object.";
|
|
}
|
|
|
|
p_output << ICALL_CLASSDB_GET_METHOD "(" BINDINGS_NATIVE_NAME_FIELD ", \""
|
|
<< p_imethod.name
|
|
<< "\");\n";
|
|
}
|
|
|
|
if (p_imethod.method_doc && p_imethod.method_doc->description.size()) {
|
|
String xml_summary = bbcode_to_xml(fix_doc_description(p_imethod.method_doc->description), &p_itype);
|
|
Vector<String> summary_lines = xml_summary.length() ? xml_summary.split("\n") : Vector<String>();
|
|
|
|
if (summary_lines.size()) {
|
|
p_output.append(MEMBER_BEGIN "/// <summary>\n");
|
|
|
|
for (int i = 0; i < summary_lines.size(); i++) {
|
|
p_output.append(INDENT2 "/// ");
|
|
p_output.append(summary_lines[i]);
|
|
p_output.append("\n");
|
|
}
|
|
|
|
p_output.append(INDENT2 "/// </summary>");
|
|
}
|
|
}
|
|
|
|
if (default_args_doc.get_string_length()) {
|
|
p_output.append(default_args_doc.as_string());
|
|
}
|
|
|
|
if (!p_imethod.is_internal) {
|
|
// TODO: This alone adds ~0.2 MB of bloat to the core API assembly. It would be
|
|
// better to generate a table in the C++ glue instead. That way the strings wouldn't
|
|
// add that much extra bloat as they're already used in engine code. Also, it would
|
|
// probably be much faster than looking up the attributes when fetching methods.
|
|
p_output.append(MEMBER_BEGIN "[GodotMethod(\"");
|
|
p_output.append(p_imethod.name);
|
|
p_output.append("\")]");
|
|
}
|
|
|
|
if (p_imethod.is_deprecated) {
|
|
if (p_imethod.deprecation_message.is_empty()) {
|
|
WARN_PRINT("An empty deprecation message is discouraged. Method: '" + p_imethod.proxy_name + "'.");
|
|
}
|
|
|
|
p_output.append(MEMBER_BEGIN "[Obsolete(\"");
|
|
p_output.append(p_imethod.deprecation_message);
|
|
p_output.append("\")]");
|
|
}
|
|
|
|
p_output.append(MEMBER_BEGIN);
|
|
p_output.append(p_imethod.is_internal ? "internal " : "public ");
|
|
|
|
if (p_itype.is_singleton) {
|
|
p_output.append("static ");
|
|
} else if (p_imethod.is_virtual) {
|
|
p_output.append("virtual ");
|
|
}
|
|
|
|
if (cs_in_is_unsafe) {
|
|
p_output.append("unsafe ");
|
|
}
|
|
|
|
p_output.append(return_type->cs_type + " ");
|
|
p_output.append(p_imethod.proxy_name + "(");
|
|
p_output.append(arguments_sig + ")\n" OPEN_BLOCK_L2);
|
|
|
|
if (p_imethod.is_virtual) {
|
|
// Godot virtual method must be overridden, therefore we return a default value by default.
|
|
|
|
if (return_type->cname == name_cache.type_void) {
|
|
p_output.append(CLOSE_BLOCK_L2);
|
|
} else {
|
|
p_output.append(INDENT3 "return default;\n" CLOSE_BLOCK_L2);
|
|
}
|
|
|
|
return OK; // Won't increment method bind count
|
|
}
|
|
|
|
if (p_imethod.requires_object_call) {
|
|
// Fallback to Godot's object.Call(string, params)
|
|
|
|
p_output.append(INDENT3 CS_METHOD_CALL "(\"");
|
|
p_output.append(p_imethod.name);
|
|
p_output.append("\"");
|
|
|
|
for (const ArgumentInterface &iarg : p_imethod.arguments) {
|
|
p_output.append(", ");
|
|
p_output.append(iarg.name);
|
|
}
|
|
|
|
p_output.append(");\n" CLOSE_BLOCK_L2);
|
|
|
|
return OK; // Won't increment method bind count
|
|
}
|
|
|
|
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 im_call = im_icall->editor_only ? BINDINGS_CLASS_NATIVECALLS_EDITOR : BINDINGS_CLASS_NATIVECALLS;
|
|
im_call += ".";
|
|
im_call += im_icall->name;
|
|
|
|
if (p_imethod.arguments.size()) {
|
|
p_output.append(cs_in_statements.as_string());
|
|
}
|
|
|
|
if (return_type->cname == name_cache.type_void) {
|
|
p_output << INDENT3 << im_call << "(" << icall_params << ");\n";
|
|
} else if (return_type->cs_out.is_empty()) {
|
|
p_output << INDENT3 "return " << im_call << "(" << icall_params << ");\n";
|
|
} else {
|
|
p_output.append(sformat(return_type->cs_out, im_call, icall_params,
|
|
return_type->cs_type, return_type->c_type_out, String(), INDENT3));
|
|
p_output.append("\n");
|
|
}
|
|
|
|
p_output.append(CLOSE_BLOCK_L2);
|
|
}
|
|
|
|
p_method_bind_count++;
|
|
|
|
return OK;
|
|
}
|
|
|
|
Error BindingsGenerator::_generate_cs_signal(const BindingsGenerator::TypeInterface &p_itype, const BindingsGenerator::SignalInterface &p_isignal, StringBuilder &p_output) {
|
|
String arguments_sig;
|
|
|
|
// Retrieve information from the arguments
|
|
const ArgumentInterface &first = p_isignal.arguments.front()->get();
|
|
for (const ArgumentInterface &iarg : p_isignal.arguments) {
|
|
const TypeInterface *arg_type = _get_type_or_null(iarg.type);
|
|
ERR_FAIL_NULL_V(arg_type, ERR_BUG); // Argument type not found
|
|
|
|
ERR_FAIL_COND_V_MSG(arg_type->is_singleton, ERR_BUG,
|
|
"Argument type is a singleton: '" + iarg.name + "' of signal '" + p_itype.name + "." + p_isignal.name + "'.");
|
|
|
|
if (p_itype.api_type == ClassDB::API_CORE) {
|
|
ERR_FAIL_COND_V_MSG(arg_type->api_type == ClassDB::API_EDITOR, ERR_BUG,
|
|
"Argument '" + iarg.name + "' of signal '" + p_itype.name + "." + p_isignal.name + "' has type '" +
|
|
arg_type->name + "' from the editor API. Core API cannot have dependencies on the editor API.");
|
|
}
|
|
|
|
// Add the current arguments to the signature
|
|
|
|
if (&iarg != &first) {
|
|
arguments_sig += ", ";
|
|
}
|
|
|
|
arguments_sig += arg_type->cs_type;
|
|
arguments_sig += " ";
|
|
arguments_sig += iarg.name;
|
|
}
|
|
|
|
// Generate signal
|
|
{
|
|
if (p_isignal.method_doc && p_isignal.method_doc->description.size()) {
|
|
String xml_summary = bbcode_to_xml(fix_doc_description(p_isignal.method_doc->description), &p_itype);
|
|
Vector<String> summary_lines = xml_summary.length() ? xml_summary.split("\n") : Vector<String>();
|
|
|
|
if (summary_lines.size()) {
|
|
p_output.append(MEMBER_BEGIN "/// <summary>\n");
|
|
|
|
for (int i = 0; i < summary_lines.size(); i++) {
|
|
p_output.append(INDENT2 "/// ");
|
|
p_output.append(summary_lines[i]);
|
|
p_output.append("\n");
|
|
}
|
|
|
|
p_output.append(INDENT2 "/// </summary>");
|
|
}
|
|
}
|
|
|
|
if (p_isignal.is_deprecated) {
|
|
if (p_isignal.deprecation_message.is_empty()) {
|
|
WARN_PRINT("An empty deprecation message is discouraged. Signal: '" + p_isignal.proxy_name + "'.");
|
|
}
|
|
|
|
p_output.append(MEMBER_BEGIN "[Obsolete(\"");
|
|
p_output.append(p_isignal.deprecation_message);
|
|
p_output.append("\")]");
|
|
}
|
|
|
|
String delegate_name = p_isignal.proxy_name;
|
|
delegate_name += "Handler"; // Delegate name is [SignalName]Handler
|
|
|
|
// Generate delegate
|
|
p_output.append(MEMBER_BEGIN "public delegate void ");
|
|
p_output.append(delegate_name);
|
|
p_output.append("(");
|
|
p_output.append(arguments_sig);
|
|
p_output.append(");\n");
|
|
|
|
// TODO:
|
|
// Could we assume the StringName instance of signal name will never be freed (it's stored in ClassDB) before the managed world is unloaded?
|
|
// If so, we could store the pointer we get from `data_unique_pointer()` instead of allocating StringName here.
|
|
|
|
// Cached signal name (StringName)
|
|
p_output.append(MEMBER_BEGIN "[DebuggerBrowsable(DebuggerBrowsableState.Never)]" MEMBER_BEGIN
|
|
"private static readonly StringName " CS_STATIC_FIELD_SIGNAL_NAME_PREFIX);
|
|
p_output.append(p_isignal.name);
|
|
p_output.append(" = \"");
|
|
p_output.append(p_isignal.name);
|
|
p_output.append("\";\n");
|
|
|
|
// Generate event
|
|
p_output.append(MEMBER_BEGIN "[Signal]" MEMBER_BEGIN "public ");
|
|
|
|
if (p_itype.is_singleton) {
|
|
p_output.append("static ");
|
|
}
|
|
|
|
p_output.append("event ");
|
|
p_output.append(delegate_name);
|
|
p_output.append(" ");
|
|
p_output.append(p_isignal.proxy_name);
|
|
p_output.append("\n" OPEN_BLOCK_L2 INDENT3);
|
|
|
|
if (p_itype.is_singleton) {
|
|
p_output.append("add => " CS_PROPERTY_SINGLETON ".Connect(" CS_STATIC_FIELD_SIGNAL_NAME_PREFIX);
|
|
} else {
|
|
p_output.append("add => Connect(" CS_STATIC_FIELD_SIGNAL_NAME_PREFIX);
|
|
}
|
|
|
|
p_output.append(p_isignal.name);
|
|
p_output.append(", new Callable(value));\n");
|
|
|
|
if (p_itype.is_singleton) {
|
|
p_output.append(INDENT3 "remove => " CS_PROPERTY_SINGLETON ".Disconnect(" CS_STATIC_FIELD_SIGNAL_NAME_PREFIX);
|
|
} else {
|
|
p_output.append(INDENT3 "remove => Disconnect(" CS_STATIC_FIELD_SIGNAL_NAME_PREFIX);
|
|
}
|
|
|
|
p_output.append(p_isignal.name);
|
|
p_output.append(", new Callable(value));\n");
|
|
p_output.append(CLOSE_BLOCK_L2);
|
|
}
|
|
|
|
return OK;
|
|
}
|
|
|
|
Error BindingsGenerator::_generate_cs_native_calls(const InternalCall &p_icall, StringBuilder &r_output) {
|
|
bool ret_void = p_icall.return_type.cname == name_cache.type_void;
|
|
|
|
const TypeInterface *return_type = _get_type_or_null(p_icall.return_type);
|
|
ERR_FAIL_NULL_V(return_type, ERR_BUG); // Return type not found
|
|
|
|
StringBuilder c_func_sig;
|
|
StringBuilder c_in_statements;
|
|
StringBuilder c_args_var_content;
|
|
|
|
c_func_sig << "IntPtr " CS_PARAM_METHODBIND ", IntPtr " CS_PARAM_INSTANCE;
|
|
|
|
// Get arguments information
|
|
int i = 0;
|
|
for (const TypeReference &arg_type_ref : p_icall.argument_types) {
|
|
const TypeInterface *arg_type = _get_type_or_null(arg_type_ref);
|
|
ERR_FAIL_NULL_V(arg_type, ERR_BUG); // Return type not found
|
|
|
|
String c_param_name = "arg" + itos(i + 1);
|
|
|
|
if (p_icall.is_vararg) {
|
|
if (i < p_icall.get_arguments_count() - 1) {
|
|
string c_in_vararg = arg_type->c_in_vararg;
|
|
|
|
if (arg_type->is_object_type) {
|
|
c_in_vararg = "%5using godot_variant %1_in = VariantUtils.CreateFromGodotObject(%1);\n";
|
|
}
|
|
|
|
ERR_FAIL_COND_V_MSG(c_in_vararg.is_empty(), ERR_BUG,
|
|
"VarArg support not implemented for parameter type: " + arg_type->name);
|
|
|
|
c_in_statements
|
|
<< sformat(c_in_vararg, return_type->c_type, c_param_name,
|
|
String(), String(), String(), INDENT4)
|
|
<< INDENT4 C_LOCAL_PTRCALL_ARGS "[" << itos(i)
|
|
<< "] = new IntPtr(&" << c_param_name << "_in);\n";
|
|
}
|
|
} 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,
|
|
String(), String(), String(), INDENT3);
|
|
}
|
|
c_args_var_content << sformat(arg_type->c_arg_in, c_param_name);
|
|
}
|
|
|
|
c_func_sig << ", " << arg_type->c_type_in << " " << c_param_name;
|
|
|
|
i++;
|
|
}
|
|
|
|
String icall_method = p_icall.name;
|
|
|
|
// Generate icall function
|
|
|
|
r_output << MEMBER_BEGIN "internal static unsafe " << (ret_void ? "void" : return_type->c_type_out) << " "
|
|
<< icall_method << "(" << c_func_sig.as_string() << ") " OPEN_BLOCK;
|
|
|
|
if (!ret_void && (!p_icall.is_vararg || return_type->cname != name_cache.type_Variant)) {
|
|
String ptrcall_return_type;
|
|
String initialization;
|
|
|
|
if (return_type->is_object_type) {
|
|
ptrcall_return_type = return_type->is_ref_counted ? "godot_ref" : return_type->c_type;
|
|
initialization = return_type->is_ref_counted ? " = default" : " = IntPtr.Zero";
|
|
} else {
|
|
ptrcall_return_type = return_type->c_type;
|
|
}
|
|
|
|
r_output << INDENT3;
|
|
|
|
if (return_type->is_ref_counted || return_type->c_type_is_disposable_struct) {
|
|
r_output << "using ";
|
|
|
|
if (initialization.is_empty()) {
|
|
initialization = " = default";
|
|
}
|
|
}
|
|
|
|
r_output << ptrcall_return_type << " " C_LOCAL_RET << initialization << ";\n";
|
|
}
|
|
|
|
r_output << INDENT3 "if (" CS_PARAM_INSTANCE " == IntPtr.Zero)\n"
|
|
<< INDENT4 "throw new ArgumentNullException(nameof(" CS_PARAM_INSTANCE "));\n";
|
|
|
|
String argc_str = itos(p_icall.get_arguments_count());
|
|
|
|
auto generate_call_and_return_stmts = [&](const char *base_indent) {
|
|
if (p_icall.is_vararg) {
|
|
r_output << base_indent << "godot_variant_call_error vcall_error;\n";
|
|
|
|
// MethodBind Call
|
|
r_output << base_indent;
|
|
|
|
// VarArg methods always return Variant, but there are some cases in which MethodInfo provides
|
|
// a specific return type. We trust this information is valid. We need a temporary local to keep
|
|
// the Variant alive until the method returns. Otherwise, if the returned Variant holds a RefPtr,
|
|
// it could be deleted too early. This is the case with GDScript.new() which returns OBJECT.
|
|
// Alternatively, we could just return Variant, but that would result in a worse API.
|
|
|
|
if (!ret_void) {
|
|
if (return_type->cname != name_cache.type_Variant) {
|
|
r_output << "using godot_variant " << C_LOCAL_VARARG_RET " = ";
|
|
} else {
|
|
r_output << "using godot_variant " << C_LOCAL_RET " = ";
|
|
}
|
|
}
|
|
|
|
r_output << C_CLASS_NATIVE_FUNCS ".godotsharp_method_bind_call("
|
|
<< CS_PARAM_METHODBIND ", " CS_PARAM_INSTANCE ", "
|
|
<< (p_icall.get_arguments_count() ? "(godot_variant**)" C_LOCAL_PTRCALL_ARGS : "null")
|
|
<< ", total_length, &vcall_error);\n";
|
|
|
|
if (!ret_void) {
|
|
if (return_type->cname != name_cache.type_Variant) {
|
|
// TODO: Use something similar to c_in_vararg (see usage above, with error if not implemented)
|
|
CRASH_NOW_MSG("Custom VarArg return type not implemented: " + return_type->name);
|
|
r_output << base_indent << C_LOCAL_RET " = " C_LOCAL_VARARG_RET ";\n";
|
|
}
|
|
}
|
|
} else {
|
|
// MethodBind PtrCall
|
|
r_output << base_indent << C_CLASS_NATIVE_FUNCS ".godotsharp_method_bind_ptrcall("
|
|
<< CS_PARAM_METHODBIND ", " CS_PARAM_INSTANCE ", "
|
|
<< (p_icall.get_arguments_count() ? C_LOCAL_PTRCALL_ARGS : "null")
|
|
<< ", " << (!ret_void ? "&" C_LOCAL_RET ");\n" : "null);\n");
|
|
}
|
|
|
|
// Return statement
|
|
|
|
if (!ret_void) {
|
|
if (return_type->c_out.is_empty()) {
|
|
r_output << base_indent << "return " C_LOCAL_RET ";\n";
|
|
} else {
|
|
r_output << sformat(return_type->c_out, return_type->c_type_out, C_LOCAL_RET,
|
|
return_type->name, String(), String(), base_indent);
|
|
}
|
|
}
|
|
};
|
|
|
|
if (p_icall.get_arguments_count()) {
|
|
if (p_icall.is_vararg) {
|
|
String vararg_arg = "arg" + argc_str;
|
|
String real_argc_str = itos(p_icall.get_arguments_count() - 1); // Arguments count without vararg
|
|
|
|
p_icall.get_arguments_count();
|
|
|
|
r_output << INDENT3 "int vararg_length = " << vararg_arg << ".Length;\n"
|
|
<< INDENT3 "int total_length = " << real_argc_str << " + vararg_length;\n";
|
|
|
|
r_output << INDENT3 "Span<godot_variant> varargs_span = vararg_length <= 5 ?\n"
|
|
<< INDENT4 "stackalloc godot_variant[vararg_length].Cleared() :\n"
|
|
<< INDENT4 "new godot_variant[vararg_length];\n";
|
|
|
|
r_output << INDENT3 "Span<IntPtr> " C_LOCAL_PTRCALL_ARGS "_span = total_length <= 10 ?\n"
|
|
<< INDENT4 "stackalloc IntPtr[total_length] :\n"
|
|
<< INDENT4 "new IntPtr[total_length];\n";
|
|
|
|
r_output << INDENT3 "using var variantSpanDisposer = new VariantSpanDisposer(varargs_span);\n";
|
|
|
|
r_output << INDENT3 "fixed (godot_variant* varargs = &MemoryMarshal.GetReference(varargs_span))\n"
|
|
<< INDENT3 "fixed (IntPtr* " C_LOCAL_PTRCALL_ARGS " = "
|
|
"&MemoryMarshal.GetReference(" C_LOCAL_PTRCALL_ARGS "_span))\n"
|
|
<< OPEN_BLOCK_L3;
|
|
|
|
r_output << c_in_statements.as_string();
|
|
|
|
r_output << INDENT4 "for (int i = 0; i < vararg_length; i++) " OPEN_BLOCK
|
|
<< INDENT5 "varargs[i] = " C_METHOD_MANAGED_TO_VARIANT "(" << vararg_arg << "[i]);\n"
|
|
<< INDENT5 C_LOCAL_PTRCALL_ARGS "[" << real_argc_str << " + i] = new IntPtr(&varargs[i]);\n"
|
|
<< CLOSE_BLOCK_L4;
|
|
|
|
generate_call_and_return_stmts(INDENT4);
|
|
|
|
r_output << CLOSE_BLOCK_L3;
|
|
} else {
|
|
r_output << c_in_statements.as_string();
|
|
|
|
r_output << INDENT3 "void** " C_LOCAL_PTRCALL_ARGS " = stackalloc void*["
|
|
<< argc_str << "] { " << c_args_var_content.as_string() << " };\n";
|
|
|
|
generate_call_and_return_stmts(INDENT3);
|
|
}
|
|
} else {
|
|
generate_call_and_return_stmts(INDENT3);
|
|
}
|
|
|
|
r_output << CLOSE_BLOCK_L2;
|
|
|
|
return OK;
|
|
}
|
|
|
|
Error BindingsGenerator::_save_file(const String &p_path, const StringBuilder &p_content) {
|
|
FileAccessRef file = FileAccess::open(p_path, FileAccess::WRITE);
|
|
|
|
ERR_FAIL_COND_V_MSG(!file, ERR_FILE_CANT_WRITE, "Cannot open file: '" + p_path + "'.");
|
|
|
|
file->store_string(p_content.as_string());
|
|
file->close();
|
|
|
|
return OK;
|
|
}
|
|
|
|
const BindingsGenerator::TypeInterface *BindingsGenerator::_get_type_or_null(const TypeReference &p_typeref) {
|
|
const Map<StringName, TypeInterface>::Element *builtin_type_match = builtin_types.find(p_typeref.cname);
|
|
|
|
if (builtin_type_match) {
|
|
return &builtin_type_match->get();
|
|
}
|
|
|
|
const OrderedHashMap<StringName, TypeInterface>::Element obj_type_match = obj_types.find(p_typeref.cname);
|
|
|
|
if (obj_type_match) {
|
|
return &obj_type_match.get();
|
|
}
|
|
|
|
if (p_typeref.is_enum) {
|
|
const Map<StringName, TypeInterface>::Element *enum_match = enum_types.find(p_typeref.cname);
|
|
|
|
if (enum_match) {
|
|
return &enum_match->get();
|
|
}
|
|
|
|
// Enum not found. Most likely because none of its constants were bound, so it's empty. That's fine. Use int instead.
|
|
const Map<StringName, TypeInterface>::Element *int_match = builtin_types.find(name_cache.type_int);
|
|
ERR_FAIL_NULL_V(int_match, nullptr);
|
|
return &int_match->get();
|
|
}
|
|
|
|
return nullptr;
|
|
}
|
|
|
|
StringName BindingsGenerator::_get_int_type_name_from_meta(GodotTypeInfo::Metadata p_meta) {
|
|
switch (p_meta) {
|
|
case GodotTypeInfo::METADATA_INT_IS_INT8:
|
|
return "sbyte";
|
|
break;
|
|
case GodotTypeInfo::METADATA_INT_IS_INT16:
|
|
return "short";
|
|
break;
|
|
case GodotTypeInfo::METADATA_INT_IS_INT32:
|
|
return "int";
|
|
break;
|
|
case GodotTypeInfo::METADATA_INT_IS_INT64:
|
|
return "long";
|
|
break;
|
|
case GodotTypeInfo::METADATA_INT_IS_UINT8:
|
|
return "byte";
|
|
break;
|
|
case GodotTypeInfo::METADATA_INT_IS_UINT16:
|
|
return "ushort";
|
|
break;
|
|
case GodotTypeInfo::METADATA_INT_IS_UINT32:
|
|
return "uint";
|
|
break;
|
|
case GodotTypeInfo::METADATA_INT_IS_UINT64:
|
|
return "ulong";
|
|
break;
|
|
default:
|
|
// Assume INT32
|
|
return "int";
|
|
}
|
|
}
|
|
|
|
StringName BindingsGenerator::_get_float_type_name_from_meta(GodotTypeInfo::Metadata p_meta) {
|
|
switch (p_meta) {
|
|
case GodotTypeInfo::METADATA_REAL_IS_FLOAT:
|
|
return "float";
|
|
break;
|
|
case GodotTypeInfo::METADATA_REAL_IS_DOUBLE:
|
|
return "double";
|
|
break;
|
|
default:
|
|
// Assume real_t (float or double depending of REAL_T_IS_DOUBLE)
|
|
#ifdef REAL_T_IS_DOUBLE
|
|
return "double";
|
|
#else
|
|
return "float";
|
|
#endif
|
|
}
|
|
}
|
|
|
|
bool BindingsGenerator::_arg_default_value_is_assignable_to_type(const Variant &p_val, const TypeInterface &p_arg_type) {
|
|
if (p_arg_type.name == name_cache.type_Variant) {
|
|
// Variant can take anything
|
|
return true;
|
|
}
|
|
|
|
switch (p_val.get_type()) {
|
|
case Variant::NIL:
|
|
return p_arg_type.is_object_type ||
|
|
name_cache.is_nullable_type(p_arg_type.name);
|
|
case Variant::BOOL:
|
|
return p_arg_type.name == name_cache.type_bool;
|
|
case Variant::INT:
|
|
return p_arg_type.name == name_cache.type_sbyte ||
|
|
p_arg_type.name == name_cache.type_short ||
|
|
p_arg_type.name == name_cache.type_int ||
|
|
p_arg_type.name == name_cache.type_byte ||
|
|
p_arg_type.name == name_cache.type_ushort ||
|
|
p_arg_type.name == name_cache.type_uint ||
|
|
p_arg_type.name == name_cache.type_long ||
|
|
p_arg_type.name == name_cache.type_ulong ||
|
|
p_arg_type.name == name_cache.type_float ||
|
|
p_arg_type.name == name_cache.type_double ||
|
|
p_arg_type.is_enum;
|
|
case Variant::FLOAT:
|
|
return p_arg_type.name == name_cache.type_float ||
|
|
p_arg_type.name == name_cache.type_double;
|
|
case Variant::STRING:
|
|
case Variant::STRING_NAME:
|
|
return p_arg_type.name == name_cache.type_String ||
|
|
p_arg_type.name == name_cache.type_StringName ||
|
|
p_arg_type.name == name_cache.type_NodePath;
|
|
case Variant::NODE_PATH:
|
|
return p_arg_type.name == name_cache.type_NodePath;
|
|
case Variant::TRANSFORM2D:
|
|
case Variant::TRANSFORM3D:
|
|
case Variant::BASIS:
|
|
case Variant::QUATERNION:
|
|
case Variant::PLANE:
|
|
case Variant::AABB:
|
|
case Variant::COLOR:
|
|
case Variant::VECTOR2:
|
|
case Variant::RECT2:
|
|
case Variant::VECTOR3:
|
|
case Variant::RID:
|
|
case Variant::ARRAY:
|
|
case Variant::DICTIONARY:
|
|
case Variant::PACKED_BYTE_ARRAY:
|
|
case Variant::PACKED_INT32_ARRAY:
|
|
case Variant::PACKED_INT64_ARRAY:
|
|
case Variant::PACKED_FLOAT32_ARRAY:
|
|
case Variant::PACKED_FLOAT64_ARRAY:
|
|
case Variant::PACKED_STRING_ARRAY:
|
|
case Variant::PACKED_VECTOR2_ARRAY:
|
|
case Variant::PACKED_VECTOR3_ARRAY:
|
|
case Variant::PACKED_COLOR_ARRAY:
|
|
case Variant::CALLABLE:
|
|
case Variant::SIGNAL:
|
|
return p_arg_type.name == Variant::get_type_name(p_val.get_type());
|
|
case Variant::OBJECT:
|
|
return p_arg_type.is_object_type;
|
|
case Variant::VECTOR2I:
|
|
return p_arg_type.name == name_cache.type_Vector2 ||
|
|
p_arg_type.name == Variant::get_type_name(p_val.get_type());
|
|
case Variant::RECT2I:
|
|
return p_arg_type.name == name_cache.type_Rect2 ||
|
|
p_arg_type.name == Variant::get_type_name(p_val.get_type());
|
|
case Variant::VECTOR3I:
|
|
return p_arg_type.name == name_cache.type_Vector3 ||
|
|
p_arg_type.name == Variant::get_type_name(p_val.get_type());
|
|
default:
|
|
CRASH_NOW_MSG("Unexpected Variant type: " + itos(p_val.get_type()));
|
|
break;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
bool 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;
|
|
}
|
|
|
|
if (!ClassDB::is_class_exposed(type_cname)) {
|
|
_log("Ignoring type '%s' because it's not exposed\n", String(type_cname).utf8().get_data());
|
|
class_list.pop_front();
|
|
continue;
|
|
}
|
|
|
|
if (!ClassDB::is_class_enabled(type_cname)) {
|
|
_log("Ignoring type '%s' because it's not enabled\n", String(type_cname).utf8().get_data());
|
|
class_list.pop_front();
|
|
continue;
|
|
}
|
|
|
|
ClassDB::ClassInfo *class_info = ClassDB::classes.getptr(type_cname);
|
|
|
|
TypeInterface itype = TypeInterface::create_object_type(type_cname, api_type);
|
|
|
|
itype.base_name = ClassDB::get_parent_class(type_cname);
|
|
itype.is_singleton = Engine::get_singleton()->has_singleton(itype.proxy_name);
|
|
itype.is_instantiable = class_info->creation_func && !itype.is_singleton;
|
|
itype.is_ref_counted = ClassDB::is_parent_class(type_cname, name_cache.type_RefCounted);
|
|
itype.memory_own = itype.is_ref_counted;
|
|
|
|
itype.c_out = "%5return ";
|
|
itype.c_out += C_METHOD_UNMANAGED_GET_MANAGED;
|
|
itype.c_out += itype.is_ref_counted ? "(%1._reference);\n" : "(%1);\n";
|
|
|
|
itype.cs_type = itype.proxy_name;
|
|
|
|
if (itype.is_singleton) {
|
|
itype.cs_in = "Object." CS_STATIC_METHOD_GETINSTANCE "(" CS_PROPERTY_SINGLETON ")";
|
|
} else {
|
|
itype.cs_in = "Object." CS_STATIC_METHOD_GETINSTANCE "(%0)";
|
|
}
|
|
|
|
itype.cs_out = "%5return (%2)%0(%1);";
|
|
|
|
itype.c_arg_in = "(void*)%s";
|
|
itype.c_type = "IntPtr";
|
|
itype.c_type_in = itype.c_type;
|
|
itype.c_type_out = "Object";
|
|
|
|
// Populate properties
|
|
|
|
List<PropertyInfo> property_list;
|
|
ClassDB::get_property_list(type_cname, &property_list, true);
|
|
|
|
Map<StringName, StringName> accessor_methods;
|
|
|
|
for (const PropertyInfo &property : property_list) {
|
|
if (property.usage & PROPERTY_USAGE_GROUP || property.usage & PROPERTY_USAGE_SUBGROUP || property.usage & PROPERTY_USAGE_CATEGORY) {
|
|
continue;
|
|
}
|
|
|
|
if (property.name.find("/") >= 0) {
|
|
// Ignore properties with '/' (slash) in the name. These are only meant for use in the inspector.
|
|
continue;
|
|
}
|
|
|
|
PropertyInterface iprop;
|
|
iprop.cname = property.name;
|
|
iprop.setter = ClassDB::get_property_setter(type_cname, iprop.cname);
|
|
iprop.getter = ClassDB::get_property_getter(type_cname, iprop.cname);
|
|
|
|
if (iprop.setter != StringName()) {
|
|
accessor_methods[iprop.setter] = iprop.cname;
|
|
}
|
|
if (iprop.getter != StringName()) {
|
|
accessor_methods[iprop.getter] = iprop.cname;
|
|
}
|
|
|
|
bool valid = false;
|
|
iprop.index = ClassDB::get_property_index(type_cname, iprop.cname, &valid);
|
|
ERR_FAIL_COND_V_MSG(!valid, false, "Invalid property: '" + itype.name + "." + String(iprop.cname) + "'.");
|
|
|
|
iprop.proxy_name = escape_csharp_keyword(snake_to_pascal_case(iprop.cname));
|
|
|
|
// Prevent the property and its enclosing type from sharing the same name
|
|
if (iprop.proxy_name == itype.proxy_name) {
|
|
_log("Name of property '%s' is ambiguous with the name of its enclosing class '%s'. Renaming property to '%s_'\n",
|
|
iprop.proxy_name.utf8().get_data(), itype.proxy_name.utf8().get_data(), iprop.proxy_name.utf8().get_data());
|
|
|
|
iprop.proxy_name += "_";
|
|
}
|
|
|
|
iprop.prop_doc = nullptr;
|
|
|
|
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);
|
|
}
|
|
|
|
// Populate methods
|
|
|
|
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 (const MethodInfo &method_info : method_list) {
|
|
int argc = method_info.arguments.size();
|
|
|
|
if (method_info.name.is_empty()) {
|
|
continue;
|
|
}
|
|
|
|
String cname = method_info.name;
|
|
|
|
if (blacklisted_methods.find(itype.cname) && blacklisted_methods[itype.cname].find(cname)) {
|
|
continue;
|
|
}
|
|
|
|
MethodInterface imethod;
|
|
imethod.name = method_info.name;
|
|
imethod.cname = cname;
|
|
|
|
if (method_info.flags & METHOD_FLAG_VIRTUAL) {
|
|
imethod.is_virtual = true;
|
|
}
|
|
|
|
PropertyInfo return_info = method_info.return_val;
|
|
|
|
MethodBind *m = imethod.is_virtual ? nullptr : ClassDB::get_method(type_cname, method_info.name);
|
|
|
|
imethod.is_vararg = m && m->is_vararg();
|
|
|
|
if (!m && !imethod.is_virtual) {
|
|
ERR_FAIL_COND_V_MSG(!virtual_method_list.find(method_info), false,
|
|
"Missing MethodBind for non-virtual method: '" + itype.name + "." + imethod.name + "'.");
|
|
|
|
// A virtual method without the virtual flag. This is a special case.
|
|
|
|
// 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.
|
|
imethod.return_type.cname = name_cache.type_void;
|
|
|
|
// Actually, more methods like this may be added in the future, which could return
|
|
// something different. Let's put this check to notify us if that ever happens.
|
|
if (itype.cname != name_cache.type_Object || imethod.name != "free") {
|
|
WARN_PRINT("Notification: New unexpected virtual non-overridable method found."
|
|
" We only expected Object.free, but found '" +
|
|
itype.name + "." + imethod.name + "'.");
|
|
}
|
|
} else if (return_info.type == Variant::INT && return_info.usage & PROPERTY_USAGE_CLASS_IS_ENUM) {
|
|
imethod.return_type.cname = return_info.class_name;
|
|
imethod.return_type.is_enum = true;
|
|
} else if (return_info.class_name != StringName()) {
|
|
imethod.return_type.cname = return_info.class_name;
|
|
|
|
bool bad_reference_hint = !imethod.is_virtual && return_info.hint != PROPERTY_HINT_RESOURCE_TYPE &&
|
|
ClassDB::is_parent_class(return_info.class_name, name_cache.type_RefCounted);
|
|
ERR_FAIL_COND_V_MSG(bad_reference_hint, false,
|
|
String() + "Return type is reference but hint is not '" _STR(PROPERTY_HINT_RESOURCE_TYPE) "'." +
|
|
" Are you returning a reference type by pointer? Method: '" + itype.name + "." + imethod.name + "'.");
|
|
} else if (return_info.hint == PROPERTY_HINT_RESOURCE_TYPE) {
|
|
imethod.return_type.cname = return_info.hint_string;
|
|
} else if (return_info.type == Variant::NIL && return_info.usage & PROPERTY_USAGE_NIL_IS_VARIANT) {
|
|
imethod.return_type.cname = name_cache.type_Variant;
|
|
} else if (return_info.type == Variant::NIL) {
|
|
imethod.return_type.cname = name_cache.type_void;
|
|
} else {
|
|
if (return_info.type == Variant::INT) {
|
|
imethod.return_type.cname = _get_int_type_name_from_meta(m ? m->get_argument_meta(-1) : GodotTypeInfo::METADATA_NONE);
|
|
} else if (return_info.type == Variant::FLOAT) {
|
|
imethod.return_type.cname = _get_float_type_name_from_meta(m ? m->get_argument_meta(-1) : GodotTypeInfo::METADATA_NONE);
|
|
} else {
|
|
imethod.return_type.cname = Variant::get_type_name(return_info.type);
|
|
}
|
|
}
|
|
|
|
for (int i = 0; i < argc; i++) {
|
|
PropertyInfo arginfo = method_info.arguments[i];
|
|
|
|
String orig_arg_name = arginfo.name;
|
|
|
|
ArgumentInterface iarg;
|
|
iarg.name = orig_arg_name;
|
|
|
|
if (arginfo.type == Variant::INT && arginfo.usage & PROPERTY_USAGE_CLASS_IS_ENUM) {
|
|
iarg.type.cname = arginfo.class_name;
|
|
iarg.type.is_enum = true;
|
|
} else if (arginfo.class_name != StringName()) {
|
|
iarg.type.cname = arginfo.class_name;
|
|
} else if (arginfo.hint == PROPERTY_HINT_RESOURCE_TYPE) {
|
|
iarg.type.cname = arginfo.hint_string;
|
|
} else if (arginfo.type == Variant::NIL) {
|
|
iarg.type.cname = name_cache.type_Variant;
|
|
} else {
|
|
if (arginfo.type == Variant::INT) {
|
|
iarg.type.cname = _get_int_type_name_from_meta(m ? m->get_argument_meta(i) : GodotTypeInfo::METADATA_NONE);
|
|
} else if (arginfo.type == Variant::FLOAT) {
|
|
iarg.type.cname = _get_float_type_name_from_meta(m ? m->get_argument_meta(i) : GodotTypeInfo::METADATA_NONE);
|
|
} else {
|
|
iarg.type.cname = Variant::get_type_name(arginfo.type);
|
|
}
|
|
}
|
|
|
|
iarg.name = escape_csharp_keyword(snake_to_camel_case(iarg.name));
|
|
|
|
if (m && m->has_default_argument(i)) {
|
|
bool defval_ok = _arg_default_value_from_variant(m->get_default_argument(i), iarg);
|
|
ERR_FAIL_COND_V_MSG(!defval_ok, false,
|
|
"Cannot determine default value for argument '" + orig_arg_name + "' of method '" + itype.name + "." + imethod.name + "'.");
|
|
}
|
|
|
|
imethod.add_argument(iarg);
|
|
}
|
|
|
|
if (imethod.is_vararg) {
|
|
ArgumentInterface ivararg;
|
|
ivararg.type.cname = name_cache.type_VarArg;
|
|
ivararg.name = "@args";
|
|
imethod.add_argument(ivararg);
|
|
}
|
|
|
|
imethod.proxy_name = escape_csharp_keyword(snake_to_pascal_case(imethod.name));
|
|
|
|
// Prevent the method and its enclosing type from sharing the same name
|
|
if (imethod.proxy_name == itype.proxy_name) {
|
|
_log("Name of method '%s' is ambiguous with the name of its enclosing class '%s'. Renaming method to '%s_'\n",
|
|
imethod.proxy_name.utf8().get_data(), itype.proxy_name.utf8().get_data(), imethod.proxy_name.utf8().get_data());
|
|
|
|
imethod.proxy_name += "_";
|
|
}
|
|
|
|
Map<StringName, StringName>::Element *accessor = accessor_methods.find(imethod.cname);
|
|
if (accessor) {
|
|
const PropertyInterface *accessor_property = itype.find_property_by_name(accessor->value());
|
|
|
|
// We only deprecate an accessor method if it's in the same class as the property. It's easier this way, but also
|
|
// we don't know if an accessor method in a different class could have other purposes, so better leave those untouched.
|
|
imethod.is_deprecated = true;
|
|
imethod.deprecation_message = imethod.proxy_name + " is deprecated. Use the " + accessor_property->proxy_name + " property instead.";
|
|
}
|
|
|
|
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;
|
|
}
|
|
}
|
|
}
|
|
|
|
ERR_FAIL_COND_V_MSG(itype.find_property_by_name(imethod.cname), false,
|
|
"Method name conflicts with property: '" + itype.name + "." + imethod.name + "'.");
|
|
|
|
// Classes starting with an underscore are ignored unless they're used as a property setter or getter
|
|
if (!imethod.is_virtual && imethod.name[0] == '_') {
|
|
for (const PropertyInterface &iprop : itype.properties) {
|
|
if (iprop.setter == imethod.name || iprop.getter == imethod.name) {
|
|
imethod.is_internal = true;
|
|
itype.methods.push_back(imethod);
|
|
break;
|
|
}
|
|
}
|
|
} else {
|
|
itype.methods.push_back(imethod);
|
|
}
|
|
}
|
|
|
|
// Populate signals
|
|
|
|
const HashMap<StringName, MethodInfo> &signal_map = class_info->signal_map;
|
|
const StringName *k = nullptr;
|
|
|
|
while ((k = signal_map.next(k))) {
|
|
SignalInterface isignal;
|
|
|
|
const MethodInfo &method_info = signal_map.get(*k);
|
|
|
|
isignal.name = method_info.name;
|
|
isignal.cname = method_info.name;
|
|
|
|
int argc = method_info.arguments.size();
|
|
|
|
for (int i = 0; i < argc; i++) {
|
|
PropertyInfo arginfo = method_info.arguments[i];
|
|
|
|
String orig_arg_name = arginfo.name;
|
|
|
|
ArgumentInterface iarg;
|
|
iarg.name = orig_arg_name;
|
|
|
|
if (arginfo.type == Variant::INT && arginfo.usage & PROPERTY_USAGE_CLASS_IS_ENUM) {
|
|
iarg.type.cname = arginfo.class_name;
|
|
iarg.type.is_enum = true;
|
|
} else if (arginfo.class_name != StringName()) {
|
|
iarg.type.cname = arginfo.class_name;
|
|
} else if (arginfo.hint == PROPERTY_HINT_RESOURCE_TYPE) {
|
|
iarg.type.cname = arginfo.hint_string;
|
|
} else if (arginfo.type == Variant::NIL) {
|
|
iarg.type.cname = name_cache.type_Variant;
|
|
} else {
|
|
if (arginfo.type == Variant::INT) {
|
|
iarg.type.cname = _get_int_type_name_from_meta(GodotTypeInfo::METADATA_NONE);
|
|
} else if (arginfo.type == Variant::FLOAT) {
|
|
iarg.type.cname = _get_float_type_name_from_meta(GodotTypeInfo::METADATA_NONE);
|
|
} else {
|
|
iarg.type.cname = Variant::get_type_name(arginfo.type);
|
|
}
|
|
}
|
|
|
|
iarg.name = escape_csharp_keyword(snake_to_camel_case(iarg.name));
|
|
|
|
isignal.add_argument(iarg);
|
|
}
|
|
|
|
isignal.proxy_name = escape_csharp_keyword(snake_to_pascal_case(isignal.name));
|
|
|
|
// Prevent the signal and its enclosing type from sharing the same name
|
|
if (isignal.proxy_name == itype.proxy_name) {
|
|
_log("Name of signal '%s' is ambiguous with the name of its enclosing class '%s'. Renaming signal to '%s_'\n",
|
|
isignal.proxy_name.utf8().get_data(), itype.proxy_name.utf8().get_data(), isignal.proxy_name.utf8().get_data());
|
|
|
|
isignal.proxy_name += "_";
|
|
}
|
|
|
|
if (itype.find_property_by_proxy_name(isignal.proxy_name) || itype.find_method_by_proxy_name(isignal.proxy_name)) {
|
|
// ClassDB allows signal names that conflict with method or property names.
|
|
// While registering a signal with a conflicting name is considered wrong,
|
|
// it may still happen and it may take some time until someone fixes the name.
|
|
// We can't allow the bindings to be in a broken state while we wait for a fix;
|
|
// that's why we must handle this possibility by renaming the signal.
|
|
isignal.proxy_name += "Signal";
|
|
}
|
|
|
|
if (itype.class_doc) {
|
|
for (int i = 0; i < itype.class_doc->signals.size(); i++) {
|
|
const DocData::MethodDoc &signal_doc = itype.class_doc->signals[i];
|
|
if (signal_doc.name == isignal.name) {
|
|
isignal.method_doc = &signal_doc;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
itype.signals_.push_back(isignal);
|
|
}
|
|
|
|
// Populate enums and constants
|
|
|
|
List<String> constants;
|
|
ClassDB::get_integer_constant_list(type_cname, &constants, true);
|
|
|
|
const HashMap<StringName, List<StringName>> &enum_map = class_info->enum_map;
|
|
k = nullptr;
|
|
|
|
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> &enum_constants = enum_map.get(*k);
|
|
for (const StringName &constant_cname : enum_constants) {
|
|
String constant_name = constant_cname.operator String();
|
|
int *value = class_info->constant_map.getptr(constant_cname);
|
|
ERR_FAIL_NULL_V(value, false);
|
|
constants.erase(constant_name);
|
|
|
|
ConstantInterface iconstant(constant_name, snake_to_pascal_case(constant_name, true), *value);
|
|
|
|
iconstant.const_doc = nullptr;
|
|
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);
|
|
}
|
|
|
|
int prefix_length = _determine_enum_prefix(ienum);
|
|
|
|
_apply_prefix_to_enum_constants(ienum, prefix_length);
|
|
|
|
itype.enums.push_back(ienum);
|
|
|
|
TypeInterface enum_itype;
|
|
enum_itype.is_enum = true;
|
|
enum_itype.name = itype.name + "." + String(*k);
|
|
enum_itype.cname = StringName(enum_itype.name);
|
|
enum_itype.proxy_name = itype.proxy_name + "." + enum_proxy_name;
|
|
TypeInterface::postsetup_enum_type(enum_itype);
|
|
enum_types.insert(enum_itype.cname, enum_itype);
|
|
}
|
|
|
|
for (const String &constant_name : constants) {
|
|
int *value = class_info->constant_map.getptr(StringName(constant_name));
|
|
ERR_FAIL_NULL_V(value, false);
|
|
|
|
ConstantInterface iconstant(constant_name, snake_to_pascal_case(constant_name, true), *value);
|
|
|
|
iconstant.const_doc = nullptr;
|
|
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);
|
|
|
|
class_list.pop_front();
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
bool BindingsGenerator::_arg_default_value_from_variant(const Variant &p_val, ArgumentInterface &r_iarg) {
|
|
r_iarg.def_param_value = p_val;
|
|
r_iarg.default_argument = p_val.operator String();
|
|
|
|
switch (p_val.get_type()) {
|
|
case Variant::NIL:
|
|
// Either Object type or 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:
|
|
if (r_iarg.type.cname != name_cache.type_int) {
|
|
r_iarg.default_argument = "(%s)" + r_iarg.default_argument;
|
|
}
|
|
break;
|
|
case Variant::FLOAT:
|
|
if (r_iarg.type.cname == name_cache.type_float) {
|
|
r_iarg.default_argument += "f";
|
|
}
|
|
break;
|
|
case Variant::STRING:
|
|
case Variant::STRING_NAME:
|
|
case Variant::NODE_PATH:
|
|
if (r_iarg.type.cname == name_cache.type_StringName || r_iarg.type.cname == name_cache.type_NodePath) {
|
|
r_iarg.default_argument = "(%s)\"" + r_iarg.default_argument + "\"";
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_REF;
|
|
} else {
|
|
CRASH_COND(r_iarg.type.cname != name_cache.type_String);
|
|
r_iarg.default_argument = "\"" + r_iarg.default_argument + "\"";
|
|
}
|
|
break;
|
|
case Variant::PLANE: {
|
|
Plane plane = p_val.operator Plane();
|
|
r_iarg.default_argument = "new Plane(new Vector3" + plane.normal.operator String() + ", " + rtos(plane.d) + ")";
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
} break;
|
|
case Variant::AABB: {
|
|
AABB aabb = p_val.operator ::AABB();
|
|
r_iarg.default_argument = "new AABB(new Vector3" + aabb.position.operator String() + ", new Vector3" + aabb.size.operator String() + ")";
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
} break;
|
|
case Variant::RECT2: {
|
|
Rect2 rect = p_val.operator Rect2();
|
|
r_iarg.default_argument = "new Rect2(new Vector2" + rect.position.operator String() + ", new Vector2" + rect.size.operator String() + ")";
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
} break;
|
|
case Variant::RECT2I: {
|
|
Rect2i rect = p_val.operator Rect2i();
|
|
r_iarg.default_argument = "new Rect2i(new Vector2i" + rect.position.operator String() + ", new Vector2i" + rect.size.operator String() + ")";
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
} break;
|
|
case Variant::COLOR:
|
|
case Variant::VECTOR2:
|
|
case Variant::VECTOR2I:
|
|
case Variant::VECTOR3:
|
|
case Variant::VECTOR3I:
|
|
r_iarg.default_argument = "new %s" + r_iarg.default_argument;
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
break;
|
|
case Variant::OBJECT:
|
|
ERR_FAIL_COND_V_MSG(!p_val.is_zero(), false,
|
|
"Parameter of type '" + String(r_iarg.type.cname) + "' can only have null/zero as the default value.");
|
|
|
|
r_iarg.default_argument = "null";
|
|
break;
|
|
case Variant::DICTIONARY:
|
|
r_iarg.default_argument = "new %s()";
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_REF;
|
|
break;
|
|
case Variant::RID:
|
|
ERR_FAIL_COND_V_MSG(r_iarg.type.cname != name_cache.type_RID, false,
|
|
"Parameter of type '" + String(r_iarg.type.cname) + "' cannot have a default value of type '" + String(name_cache.type_RID) + "'.");
|
|
|
|
ERR_FAIL_COND_V_MSG(!p_val.is_zero(), false,
|
|
"Parameter of type '" + String(r_iarg.type.cname) + "' can only have null/zero as the default value.");
|
|
|
|
r_iarg.default_argument = "default";
|
|
break;
|
|
case Variant::ARRAY:
|
|
r_iarg.default_argument = "new %s { }";
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_REF;
|
|
break;
|
|
case Variant::PACKED_BYTE_ARRAY:
|
|
case Variant::PACKED_INT32_ARRAY:
|
|
case Variant::PACKED_INT64_ARRAY:
|
|
case Variant::PACKED_FLOAT32_ARRAY:
|
|
case Variant::PACKED_FLOAT64_ARRAY:
|
|
case Variant::PACKED_STRING_ARRAY:
|
|
case Variant::PACKED_VECTOR2_ARRAY:
|
|
case Variant::PACKED_VECTOR3_ARRAY:
|
|
case Variant::PACKED_COLOR_ARRAY:
|
|
r_iarg.default_argument = "Array.Empty<%s>()";
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_REF;
|
|
break;
|
|
case Variant::TRANSFORM2D: {
|
|
Transform2D transform = p_val.operator Transform2D();
|
|
if (transform == Transform2D()) {
|
|
r_iarg.default_argument = "Transform2D.Identity";
|
|
} else {
|
|
r_iarg.default_argument = "new Transform2D(new Vector2" + transform.elements[0].operator String() + ", new Vector2" + transform.elements[1].operator String() + ", new Vector2" + transform.elements[2].operator String() + ")";
|
|
}
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
} break;
|
|
case Variant::TRANSFORM3D: {
|
|
Transform3D transform = p_val.operator Transform3D();
|
|
if (transform == Transform3D()) {
|
|
r_iarg.default_argument = "Transform3D.Identity";
|
|
} else {
|
|
Basis basis = transform.basis;
|
|
r_iarg.default_argument = "new Transform3D(new Vector3" + basis.get_column(0).operator String() + ", new Vector3" + basis.get_column(1).operator String() + ", new Vector3" + basis.get_column(2).operator String() + ", new Vector3" + transform.origin.operator String() + ")";
|
|
}
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
} break;
|
|
case Variant::BASIS: {
|
|
Basis basis = p_val.operator Basis();
|
|
if (basis == Basis()) {
|
|
r_iarg.default_argument = "Basis.Identity";
|
|
} else {
|
|
r_iarg.default_argument = "new Basis(new Vector3" + basis.get_column(0).operator String() + ", new Vector3" + basis.get_column(1).operator String() + ", new Vector3" + basis.get_column(2).operator String() + ")";
|
|
}
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
} break;
|
|
case Variant::QUATERNION: {
|
|
Quaternion quaternion = p_val.operator Quaternion();
|
|
if (quaternion == Quaternion()) {
|
|
r_iarg.default_argument = "Quaternion.Identity";
|
|
} else {
|
|
r_iarg.default_argument = "new Quaternion" + quaternion.operator String();
|
|
}
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_VAL;
|
|
} break;
|
|
case Variant::CALLABLE:
|
|
ERR_FAIL_COND_V_MSG(r_iarg.type.cname != name_cache.type_Callable, false,
|
|
"Parameter of type '" + String(r_iarg.type.cname) + "' cannot have a default value of type '" + String(name_cache.type_Callable) + "'.");
|
|
ERR_FAIL_COND_V_MSG(!p_val.is_zero(), false,
|
|
"Parameter of type '" + String(r_iarg.type.cname) + "' can only have null/zero as the default value.");
|
|
r_iarg.default_argument = "default";
|
|
break;
|
|
case Variant::SIGNAL:
|
|
ERR_FAIL_COND_V_MSG(r_iarg.type.cname != name_cache.type_Signal, false,
|
|
"Parameter of type '" + String(r_iarg.type.cname) + "' cannot have a default value of type '" + String(name_cache.type_Signal) + "'.");
|
|
ERR_FAIL_COND_V_MSG(!p_val.is_zero(), false,
|
|
"Parameter of type '" + String(r_iarg.type.cname) + "' can only have null/zero as the default value.");
|
|
r_iarg.default_argument = "default";
|
|
break;
|
|
default:
|
|
ERR_FAIL_V_MSG(false, "Unexpected Variant type: " + itos(p_val.get_type()));
|
|
break;
|
|
}
|
|
|
|
if (r_iarg.def_param_mode == ArgumentInterface::CONSTANT && r_iarg.type.cname == name_cache.type_Variant && r_iarg.default_argument != "null") {
|
|
r_iarg.def_param_mode = ArgumentInterface::NULLABLE_REF;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
void BindingsGenerator::_populate_builtin_type_interfaces() {
|
|
builtin_types.clear();
|
|
|
|
TypeInterface itype;
|
|
|
|
#define INSERT_STRUCT_TYPE(m_type) \
|
|
{ \
|
|
itype = TypeInterface::create_value_type(String(#m_type)); \
|
|
itype.c_type_in = #m_type "*"; \
|
|
itype.c_type_out = itype.cs_type; \
|
|
itype.cs_in = "&%s"; \
|
|
itype.cs_in_is_unsafe = true; \
|
|
builtin_types.insert(itype.cname, itype); \
|
|
}
|
|
|
|
INSERT_STRUCT_TYPE(Vector2)
|
|
INSERT_STRUCT_TYPE(Vector2i)
|
|
INSERT_STRUCT_TYPE(Rect2)
|
|
INSERT_STRUCT_TYPE(Rect2i)
|
|
INSERT_STRUCT_TYPE(Transform2D)
|
|
INSERT_STRUCT_TYPE(Vector3)
|
|
INSERT_STRUCT_TYPE(Vector3i)
|
|
INSERT_STRUCT_TYPE(Basis)
|
|
INSERT_STRUCT_TYPE(Quaternion)
|
|
INSERT_STRUCT_TYPE(Transform3D)
|
|
INSERT_STRUCT_TYPE(AABB)
|
|
INSERT_STRUCT_TYPE(Color)
|
|
INSERT_STRUCT_TYPE(Plane)
|
|
|
|
#undef INSERT_STRUCT_TYPE
|
|
|
|
// bool
|
|
itype = TypeInterface::create_value_type(String("bool"));
|
|
itype.c_type = "godot_bool";
|
|
itype.c_type_in = itype.c_type;
|
|
itype.c_type_out = itype.c_type;
|
|
itype.c_arg_in = "&%s";
|
|
itype.c_in_vararg = "%5using godot_variant %1_in = VariantUtils.CreateFromBool(%1);\n";
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// Integer types
|
|
{
|
|
// C interface for 'uint32_t' is the same as that of enums. Remember to apply
|
|
// any of the changes done here to 'TypeInterface::postsetup_enum_type' as well.
|
|
#define INSERT_INT_TYPE(m_name) \
|
|
{ \
|
|
itype = TypeInterface::create_value_type(String(m_name)); \
|
|
if (itype.name != "long" && itype.name != "ulong") { \
|
|
itype.c_in = "%5%0 %1_in = %1;\n"; \
|
|
itype.c_out = "%5return (%0)%1;\n"; \
|
|
itype.c_type = "long"; \
|
|
itype.c_arg_in = "&%s_in"; \
|
|
} else { \
|
|
itype.c_arg_in = "&%s"; \
|
|
} \
|
|
itype.c_type_in = itype.name; \
|
|
itype.c_type_out = itype.name; \
|
|
itype.c_in_vararg = "%5using godot_variant %1_in = VariantUtils.CreateFromInt(%1);\n"; \
|
|
builtin_types.insert(itype.cname, itype); \
|
|
}
|
|
|
|
// The expected type for all integers in ptrcall is 'int64_t', so that's what we use for 'c_type'
|
|
|
|
INSERT_INT_TYPE("sbyte");
|
|
INSERT_INT_TYPE("short");
|
|
INSERT_INT_TYPE("int");
|
|
INSERT_INT_TYPE("long");
|
|
INSERT_INT_TYPE("byte");
|
|
INSERT_INT_TYPE("ushort");
|
|
INSERT_INT_TYPE("uint");
|
|
INSERT_INT_TYPE("ulong");
|
|
}
|
|
|
|
#undef INSERT_INT_TYPE
|
|
|
|
// Floating point types
|
|
{
|
|
// float
|
|
itype = TypeInterface();
|
|
itype.name = "float";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "float";
|
|
itype.cs_type = itype.proxy_name;
|
|
{
|
|
// The expected type for 'float' in ptrcall is 'double'
|
|
itype.c_in = "%5%0 %1_in = %1;\n";
|
|
itype.c_out = "%5return (%0)%1;\n";
|
|
itype.c_type = "double";
|
|
itype.c_arg_in = "&%s_in";
|
|
}
|
|
itype.c_type_in = itype.proxy_name;
|
|
itype.c_type_out = itype.proxy_name;
|
|
itype.c_in_vararg = "%5using godot_variant %1_in = VariantUtils.CreateFromFloat(%1);\n";
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// double
|
|
itype = TypeInterface();
|
|
itype.name = "double";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "double";
|
|
itype.cs_type = itype.proxy_name;
|
|
itype.c_type = "double";
|
|
itype.c_arg_in = "&%s";
|
|
itype.c_type_in = itype.proxy_name;
|
|
itype.c_type_out = itype.proxy_name;
|
|
itype.c_in_vararg = "%5using godot_variant %1_in = VariantUtils.CreateFromFloat(%1);\n";
|
|
builtin_types.insert(itype.cname, itype);
|
|
}
|
|
|
|
// String
|
|
itype = TypeInterface();
|
|
itype.name = "String";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "string";
|
|
itype.cs_type = itype.proxy_name;
|
|
itype.c_in = "%5using %0 %1_in = " C_METHOD_MONOSTR_TO_GODOT "(%1);\n";
|
|
itype.c_out = "%5return " C_METHOD_MONOSTR_FROM_GODOT "(&%1);\n";
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type = "godot_string";
|
|
itype.c_type_in = itype.cs_type;
|
|
itype.c_type_out = itype.cs_type;
|
|
itype.c_type_is_disposable_struct = true;
|
|
itype.c_in_vararg = "%5using godot_variant %1_in = VariantUtils.CreateFromStringTakingOwnershipOfDisposableValue(" C_METHOD_MONOSTR_TO_GODOT "(%1));\n";
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// StringName
|
|
itype = TypeInterface();
|
|
itype.name = "StringName";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "StringName";
|
|
itype.cs_type = itype.proxy_name;
|
|
itype.cs_in = "ref %0.NativeValue";
|
|
// Cannot pass null StringName to ptrcall
|
|
itype.c_in = "%5using %0 %1_in = " C_CLASS_NATIVE_FUNCS ".godotsharp_string_name_new_copy(%1);\n";
|
|
itype.c_out = "%5return %0.CreateTakingOwnershipOfDisposableValue(%1);\n";
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type = "godot_string_name";
|
|
itype.c_type_in = "ref " + itype.c_type;
|
|
itype.c_type_out = itype.cs_type;
|
|
itype.c_in_vararg = "%5using godot_variant %1_in = VariantUtils.CreateFromStringName(ref %1);\n";
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// NodePath
|
|
itype = TypeInterface();
|
|
itype.name = "NodePath";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "NodePath";
|
|
itype.cs_type = itype.proxy_name;
|
|
itype.cs_in = "ref %0.NativeValue";
|
|
// Cannot pass null NodePath to ptrcall
|
|
itype.c_in = "%5using %0 %1_in = " C_CLASS_NATIVE_FUNCS ".godotsharp_node_path_new_copy(%1);\n";
|
|
itype.c_out = "%5return %0.CreateTakingOwnershipOfDisposableValue(%1);\n";
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type = "godot_node_path";
|
|
itype.c_type_in = "ref " + itype.c_type;
|
|
itype.c_type_out = itype.cs_type;
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// RID
|
|
itype = TypeInterface();
|
|
itype.name = "RID";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "RID";
|
|
itype.cs_type = itype.proxy_name;
|
|
itype.c_arg_in = "&%s";
|
|
itype.c_type = itype.cs_type;
|
|
itype.c_type_in = itype.c_type;
|
|
itype.c_type_out = itype.c_type;
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// Variant
|
|
itype = TypeInterface();
|
|
itype.name = "Variant";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "object";
|
|
itype.cs_type = itype.proxy_name;
|
|
itype.c_in = "%5using %0 %1_in = " C_METHOD_MANAGED_TO_VARIANT "(%1);\n";
|
|
itype.c_out = "%5return " C_METHOD_MANAGED_FROM_VARIANT "(&%1);\n";
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type = "godot_variant";
|
|
itype.c_type_in = itype.cs_type;
|
|
itype.c_type_out = itype.cs_type;
|
|
itype.c_type_is_disposable_struct = true;
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// Callable
|
|
itype = TypeInterface::create_value_type(String("Callable"));
|
|
itype.cs_in = "ref %s";
|
|
itype.c_in = "%5using %0 %1_in = " C_METHOD_MANAGED_TO_CALLABLE "(ref %1);\n";
|
|
itype.c_out = "%5return " C_METHOD_MANAGED_FROM_CALLABLE "(&%1);\n";
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type = "godot_callable";
|
|
itype.c_type_in = "ref " + itype.cs_type;
|
|
itype.c_type_out = itype.cs_type;
|
|
itype.c_type_is_disposable_struct = true;
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// Signal
|
|
itype = TypeInterface();
|
|
itype.name = "Signal";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "SignalInfo";
|
|
itype.cs_type = itype.proxy_name;
|
|
itype.cs_in = "ref %s";
|
|
itype.c_in = "%5using %0 %1_in = " C_METHOD_MANAGED_TO_SIGNAL "(ref %1);\n";
|
|
itype.c_out = "%5return " C_METHOD_MANAGED_FROM_SIGNAL "(&%1);\n";
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type = "godot_signal";
|
|
itype.c_type_in = "ref " + itype.cs_type;
|
|
itype.c_type_out = itype.cs_type;
|
|
itype.c_type_is_disposable_struct = true;
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// VarArg (fictitious type to represent variable arguments)
|
|
itype = TypeInterface();
|
|
itype.name = "VarArg";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = "object[]";
|
|
itype.cs_type = "params object[]";
|
|
// c_type, c_in and c_arg_in are hard-coded in the generator.
|
|
// c_out and c_type_out are not applicable to VarArg.
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type_in = "object[]";
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
#define INSERT_ARRAY_FULL(m_name, m_type, m_managed_type, m_proxy_t) \
|
|
{ \
|
|
itype = TypeInterface(); \
|
|
itype.name = #m_name; \
|
|
itype.cname = itype.name; \
|
|
itype.proxy_name = #m_proxy_t "[]"; \
|
|
itype.cs_type = itype.proxy_name; \
|
|
itype.c_in = "%5using %0 %1_in = " C_METHOD_MONOARRAY_TO(m_type) "(%1);\n"; \
|
|
itype.c_out = "%5return " C_METHOD_MONOARRAY_FROM(m_type) "(&%1);\n"; \
|
|
itype.c_arg_in = "&%s_in"; \
|
|
itype.c_type = #m_managed_type; \
|
|
itype.c_type_in = itype.proxy_name; \
|
|
itype.c_type_out = itype.proxy_name; \
|
|
itype.c_type_is_disposable_struct = true; \
|
|
builtin_types.insert(itype.name, itype); \
|
|
}
|
|
|
|
#define INSERT_ARRAY(m_type, m_managed_type, m_proxy_t) INSERT_ARRAY_FULL(m_type, m_type, m_managed_type, m_proxy_t)
|
|
|
|
INSERT_ARRAY(PackedInt32Array, godot_packed_int32_array, int);
|
|
INSERT_ARRAY(PackedInt64Array, godot_packed_int64_array, long);
|
|
INSERT_ARRAY_FULL(PackedByteArray, PackedByteArray, godot_packed_byte_array, byte);
|
|
|
|
INSERT_ARRAY(PackedFloat32Array, godot_packed_float32_array, float);
|
|
INSERT_ARRAY(PackedFloat64Array, godot_packed_float64_array, double);
|
|
|
|
INSERT_ARRAY(PackedStringArray, godot_packed_string_array, string);
|
|
|
|
INSERT_ARRAY(PackedColorArray, godot_packed_color_array, Color);
|
|
INSERT_ARRAY(PackedVector2Array, godot_packed_vector2_array, Vector2);
|
|
INSERT_ARRAY(PackedVector3Array, godot_packed_vector3_array, Vector3);
|
|
|
|
#undef INSERT_ARRAY
|
|
|
|
// Array
|
|
itype = TypeInterface();
|
|
itype.name = "Array";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = itype.name;
|
|
itype.cs_type = BINDINGS_NAMESPACE_COLLECTIONS "." + itype.proxy_name;
|
|
itype.cs_in = "ref %0.NativeValue";
|
|
itype.c_in = "%5using %0 %1_in = " C_CLASS_NATIVE_FUNCS ".godotsharp_array_new_copy(%1);\n";
|
|
itype.c_out = "%5return %0.CreateTakingOwnershipOfDisposableValue(%1);\n";
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type = "godot_array";
|
|
itype.c_type_in = "ref " + itype.c_type;
|
|
itype.c_type_out = itype.cs_type;
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// Dictionary
|
|
itype = TypeInterface();
|
|
itype.name = "Dictionary";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = itype.name;
|
|
itype.cs_type = BINDINGS_NAMESPACE_COLLECTIONS "." + itype.proxy_name;
|
|
itype.cs_in = "ref %0.NativeValue";
|
|
itype.c_in = "%5using %0 %1_in = " C_CLASS_NATIVE_FUNCS ".godotsharp_dictionary_new_copy(%1);\n";
|
|
itype.c_out = "%5return %0.CreateTakingOwnershipOfDisposableValue(%1);\n";
|
|
itype.c_arg_in = "&%s_in";
|
|
itype.c_type = "godot_dictionary";
|
|
itype.c_type_in = "ref " + itype.c_type;
|
|
itype.c_type_out = itype.cs_type;
|
|
builtin_types.insert(itype.cname, itype);
|
|
|
|
// void (fictitious type to represent the return type of methods that do not return anything)
|
|
itype = TypeInterface();
|
|
itype.name = "void";
|
|
itype.cname = itype.name;
|
|
itype.proxy_name = itype.name;
|
|
itype.cs_type = itype.proxy_name;
|
|
itype.c_type = itype.proxy_name;
|
|
itype.c_type_in = itype.c_type;
|
|
itype.c_type_out = itype.c_type;
|
|
builtin_types.insert(itype.cname, itype);
|
|
}
|
|
|
|
void BindingsGenerator::_populate_global_constants() {
|
|
int global_constants_count = CoreConstants::get_global_constant_count();
|
|
|
|
if (global_constants_count > 0) {
|
|
Map<String, DocData::ClassDoc>::Element *match = EditorHelp::get_doc_data()->class_list.find("@GlobalScope");
|
|
|
|
CRASH_COND_MSG(!match, "Could not find '@GlobalScope' in DocData.");
|
|
|
|
const DocData::ClassDoc &global_scope_doc = match->value();
|
|
|
|
for (int i = 0; i < global_constants_count; i++) {
|
|
String constant_name = CoreConstants::get_global_constant_name(i);
|
|
|
|
const DocData::ConstantDoc *const_doc = nullptr;
|
|
for (int j = 0; j < global_scope_doc.constants.size(); j++) {
|
|
const DocData::ConstantDoc &curr_const_doc = global_scope_doc.constants[j];
|
|
|
|
if (curr_const_doc.name == constant_name) {
|
|
const_doc = &curr_const_doc;
|
|
break;
|
|
}
|
|
}
|
|
|
|
int constant_value = CoreConstants::get_global_constant_value(i);
|
|
StringName enum_name = CoreConstants::get_global_constant_enum(i);
|
|
|
|
ConstantInterface iconstant(constant_name, 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 *enum_match = global_enums.find(ienum);
|
|
if (enum_match) {
|
|
enum_match->get().constants.push_back(iconstant);
|
|
} else {
|
|
ienum.constants.push_back(iconstant);
|
|
global_enums.push_back(ienum);
|
|
}
|
|
} else {
|
|
global_constants.push_back(iconstant);
|
|
}
|
|
}
|
|
|
|
for (EnumInterface &ienum : global_enums) {
|
|
TypeInterface enum_itype;
|
|
enum_itype.is_enum = true;
|
|
enum_itype.name = ienum.cname.operator String();
|
|
enum_itype.cname = ienum.cname;
|
|
enum_itype.proxy_name = enum_itype.name;
|
|
TypeInterface::postsetup_enum_type(enum_itype);
|
|
enum_types.insert(enum_itype.cname, enum_itype);
|
|
|
|
int prefix_length = _determine_enum_prefix(ienum);
|
|
|
|
// HARDCODED: The Error enum have the prefix 'ERR_' for everything except 'OK' and 'FAILED'.
|
|
if (ienum.cname == name_cache.enum_Error) {
|
|
if (prefix_length > 0) { // Just in case it ever changes
|
|
ERR_PRINT("Prefix for enum '" _STR(Error) "' is not empty.");
|
|
}
|
|
|
|
prefix_length = 1; // 'ERR_'
|
|
}
|
|
|
|
_apply_prefix_to_enum_constants(ienum, prefix_length);
|
|
}
|
|
}
|
|
|
|
// HARDCODED
|
|
List<StringName> hardcoded_enums;
|
|
hardcoded_enums.push_back("Vector2.Axis");
|
|
hardcoded_enums.push_back("Vector2i.Axis");
|
|
hardcoded_enums.push_back("Vector3.Axis");
|
|
hardcoded_enums.push_back("Vector3i.Axis");
|
|
for (const StringName &enum_cname : hardcoded_enums) {
|
|
// These enums are not generated and must be written manually (e.g.: Vector3.Axis)
|
|
// Here, we assume core types do not begin with underscore
|
|
TypeInterface enum_itype;
|
|
enum_itype.is_enum = true;
|
|
enum_itype.name = enum_cname.operator String();
|
|
enum_itype.cname = enum_cname;
|
|
enum_itype.proxy_name = enum_itype.name;
|
|
TypeInterface::postsetup_enum_type(enum_itype);
|
|
enum_types.insert(enum_itype.cname, enum_itype);
|
|
}
|
|
}
|
|
|
|
void BindingsGenerator::_initialize_blacklisted_methods() {
|
|
blacklisted_methods["Object"].push_back("to_string"); // there is already ToString
|
|
blacklisted_methods["Object"].push_back("_to_string"); // override ToString instead
|
|
blacklisted_methods["Object"].push_back("_init"); // never called in C# (TODO: implement it)
|
|
}
|
|
|
|
void BindingsGenerator::_log(const char *p_format, ...) {
|
|
if (log_print_enabled) {
|
|
va_list list;
|
|
|
|
va_start(list, p_format);
|
|
OS::get_singleton()->print("%s", str_format(p_format, list).utf8().get_data());
|
|
va_end(list);
|
|
}
|
|
}
|
|
|
|
void BindingsGenerator::_initialize() {
|
|
initialized = false;
|
|
|
|
EditorHelp::generate_doc();
|
|
|
|
enum_types.clear();
|
|
|
|
_initialize_blacklisted_methods();
|
|
|
|
bool obj_type_ok = _populate_object_type_interfaces();
|
|
ERR_FAIL_COND_MSG(!obj_type_ok, "Failed to generate object type interfaces");
|
|
|
|
_populate_builtin_type_interfaces();
|
|
|
|
_populate_global_constants();
|
|
|
|
// Generate internal calls (after populating type interfaces and global constants)
|
|
|
|
for (OrderedHashMap<StringName, TypeInterface>::Element E = obj_types.front(); E; E = E.next()) {
|
|
const TypeInterface &itype = E.get();
|
|
Error err = _populate_method_icalls_table(itype);
|
|
ERR_FAIL_COND_MSG(err != OK, "Failed to generate icalls table for type: " + itype.name);
|
|
}
|
|
|
|
initialized = true;
|
|
}
|
|
|
|
static String generate_all_glue_option = "--generate-mono-glue";
|
|
|
|
static void handle_cmdline_options(String glue_dir_path) {
|
|
BindingsGenerator bindings_generator;
|
|
bindings_generator.set_log_print_enabled(true);
|
|
|
|
if (!bindings_generator.is_initialized()) {
|
|
ERR_PRINT("Failed to initialize the bindings generator");
|
|
return;
|
|
}
|
|
|
|
CRASH_COND(glue_dir_path.is_empty());
|
|
|
|
if (bindings_generator.generate_cs_api(glue_dir_path.plus_file(API_SOLUTION_NAME)) != OK) {
|
|
ERR_PRINT(generate_all_glue_option + ": Failed to generate the C# API.");
|
|
}
|
|
}
|
|
|
|
static void cleanup_and_exit_godot() {
|
|
// Exit once done
|
|
Main::cleanup(true);
|
|
::exit(0);
|
|
}
|
|
|
|
void BindingsGenerator::handle_cmdline_args(const List<String> &p_cmdline_args) {
|
|
String glue_dir_path;
|
|
|
|
const List<String>::Element *elem = p_cmdline_args.front();
|
|
|
|
while (elem) {
|
|
if (elem->get() == generate_all_glue_option) {
|
|
const List<String>::Element *path_elem = elem->next();
|
|
|
|
if (path_elem) {
|
|
glue_dir_path = path_elem->get();
|
|
elem = elem->next();
|
|
} else {
|
|
ERR_PRINT(generate_all_glue_option + ": No output directory specified (expected path to '{GODOT_ROOT}/modules/mono/glue').");
|
|
// Exit once done with invalid command line arguments
|
|
cleanup_and_exit_godot();
|
|
}
|
|
|
|
break;
|
|
}
|
|
|
|
elem = elem->next();
|
|
}
|
|
|
|
if (glue_dir_path.length()) {
|
|
handle_cmdline_options(glue_dir_path);
|
|
// Exit once done
|
|
cleanup_and_exit_godot();
|
|
}
|
|
}
|
|
|
|
#endif
|