Sara.Sync
/
godot-cpp
mirror of https://github.com/godotengine/godot-cpp
0
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
godot-cpp/include/godot_cpp/classes/wrapped.hpp

443 lines
61 KiB
C++
Raw Normal View History

Sync license copyright with upstream GH-70885
2023-01-10 15:14:30 +00:00
/**************************************************************************/
/* wrapped.hpp */
/**************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/**************************************************************************/
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/**************************************************************************/
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
Run scripts to format and make headers consistent
2022-10-09 06:47:07 +00:00
#ifndef GODOT_WRAPPED_HPP
#define GODOT_WRAPPED_HPP
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
#include <godot_cpp/core/memory.hpp>
Add support for `_notification`, `_set`, `_get`, `_get_property_list`, `_property_can_revert`, `_property_get_revert`, and `_to_string` methods.
2022-08-19 07:30:06 +00:00
#include <godot_cpp/core/property_info.hpp>
#include <godot_cpp/templates/list.hpp>
Change constructor/destructor management of extension classes This makes sure custom constructors are always called on extension classes. However, note that constructors should not take any parameters, since Godot doesn't support that. Parameters are ignore in memnew macro. Use memnew(MyClass()) instead of memnew(MyClass) since it now needs a value instead of a class name. This macro calls MyClass::_new() (define in GDCLASS macro) which ultimately calls Godot to create the object, ensuring that both the Godot and the extension instances are created. Non Godot classes (that don't derive godot::Object) are constructed as usual an can have parameters. memdelete is also changed for the same reason, as it needs to destroy the Godot object as well, and that automatically frees the bound extension instance.
2021-09-09 23:40:40 +00:00
#include <godot_cpp/godot.hpp>
Make extension instances create the corresponding godot object in their constructor
2021-11-30 13:00:13 +00:00
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
namespace godot {
Fix GDCLASS needs explicit ClassDB fwd declaration
2022-12-16 12:49:10 +00:00
class ClassDB;
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
typedef void GodotObject;
// Base for all engine classes, to contain the pointer to the engine instance.
class Wrapped {
friend class GDExtensionBinding;
Make extension instances create the corresponding godot object in their constructor
2021-11-30 13:00:13 +00:00
friend void postinitialize_handler(Wrapped *);
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
protected:
Use StringName in the whole GDExtension API instead of const char *
2022-10-22 17:42:48 +00:00
virtual const StringName *_get_extension_class_name() const; // This is needed to retrieve the class name before the godot object has its _extension and _extension_instance members assigned.
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
virtual const GDExtensionInstanceBindingCallbacks *_get_bindings_callbacks() const = 0;
Make extension instances create the corresponding godot object in their constructor
2021-11-30 13:00:13 +00:00
Basic static analysis fixes - remove extraneous semicolons - use "nullptr" instead of "0" - remove "break" after "return" - use <cstdio> instead of <stdio.h>
2022-11-18 18:33:28 +00:00
void _notification(int p_what) {}
bool _set(const StringName &p_name, const Variant &p_property) { return false; }
bool _get(const StringName &p_name, Variant &r_property) const { return false; }
void _get_property_list(List<PropertyInfo> *p_list) const {}
bool _property_can_revert(const StringName &p_name) const { return false; }
bool _property_get_revert(const StringName &p_name, Variant &r_property) const { return false; }
Add support for `_notification`, `_set`, `_get`, `_get_property_list`, `_property_can_revert`, `_property_get_revert`, and `_to_string` methods.
2022-08-19 07:30:06 +00:00
String _to_string() const { return "[" + String(get_class_static()) + ":" + itos(get_instance_id()) + "]"; }
static void notification_bind(GDExtensionClassInstancePtr p_instance, int32_t p_what) {}
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static GDExtensionBool set_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionConstVariantPtr p_value) { return false; }
static GDExtensionBool get_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionVariantPtr r_ret) { return false; }
static const GDExtensionPropertyInfo *get_property_list_bind(GDExtensionClassInstancePtr p_instance, uint32_t *r_count) { return nullptr; }
static void free_property_list_bind(GDExtensionClassInstancePtr p_instance, const GDExtensionPropertyInfo *p_list) {}
static GDExtensionBool property_can_revert_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name) { return false; }
static GDExtensionBool property_get_revert_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionVariantPtr r_ret) { return false; }
static void to_string_bind(GDExtensionClassInstancePtr p_instance, GDExtensionBool *r_is_valid, GDExtensionStringPtr r_out) {}
Add support for `_notification`, `_set`, `_get`, `_get_property_list`, `_property_can_revert`, `_property_get_revert`, and `_to_string` methods.
2022-08-19 07:30:06 +00:00
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
::godot::List<::godot::PropertyInfo> plist_owned;
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
GDExtensionPropertyInfo *plist = nullptr;
Add support for `_notification`, `_set`, `_get`, `_get_property_list`, `_property_can_revert`, `_property_get_revert`, and `_to_string` methods.
2022-08-19 07:30:06 +00:00
uint32_t plist_size = 0;
Make extension instances create the corresponding godot object in their constructor
2021-11-30 13:00:13 +00:00
void _postinitialize();
Fix NOTIFICATION_POSTINITIALIZE sent twice to native parent class (cherry picked from commit 06373ce1cf737a33d6a7b2b14cfe25ed729b9c48)
2024-04-24 18:01:53 +00:00
virtual void _notificationv(int32_t p_what) {}
Make extension instances create the corresponding godot object in their constructor
2021-11-30 13:00:13 +00:00
Uses `StringName` in GDExtension perf critical instance creation & method/properties setter/getter
2022-10-22 11:46:59 +00:00
Wrapped(const StringName p_godot_class);
Make extension instances create the corresponding godot object in their constructor
2021-11-30 13:00:13 +00:00
Wrapped(GodotObject *p_godot_object);
"Wrapped" has virtual functions so it should have a virtual destructor. Deleting an object through a pointer to a base class is undefined behaviour unless the destructor in the base class is virtual.
2023-01-18 00:30:18 +00:00
virtual ~Wrapped() {}
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
public:
mark return value of `get_class_static` and `get_parent_class_static` as const (cherry picked from commit 3db8549e19641d49dfcdf3055da6917699c07d1f)
2024-05-16 18:06:59 +00:00
static const StringName &get_class_static() {
static const StringName string_name = StringName("Wrapped");
Uses `StringName` in GDExtension perf critical instance creation & method/properties setter/getter
2022-10-22 11:46:59 +00:00
return string_name;
Fix GDCLASS when inherited class is in another namespace
2022-02-20 19:23:14 +00:00
}
Add support for `_notification`, `_set`, `_get`, `_get_property_list`, `_property_can_revert`, `_property_get_revert`, and `_to_string` methods.
2022-08-19 07:30:06 +00:00
uint64_t get_instance_id() const {
return 0;
}
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
// Must be public but you should not touch this.
GodotObject *_owner = nullptr;
Change constructor/destructor management of extension classes This makes sure custom constructors are always called on extension classes. However, note that constructors should not take any parameters, since Godot doesn't support that. Parameters are ignore in memnew macro. Use memnew(MyClass()) instead of memnew(MyClass) since it now needs a value instead of a class name. This macro calls MyClass::_new() (define in GDCLASS macro) which ultimately calls Godot to create the object, ensuring that both the Godot and the extension instances are created. Non Godot classes (that don't derive godot::Object) are constructed as usual an can have parameters. memdelete is also changed for the same reason, as it needs to destroy the Godot object as well, and that automatically frees the bound extension instance.
2021-09-09 23:40:40 +00:00
};
Automatically register only engine classes whose header has been included (cherry picked from commit b507b3e5913344a97e90ba27b221e28924f555ab)
2023-10-12 03:59:59 +00:00
namespace internal {
typedef void (*EngineClassRegistrationCallback)();
void add_engine_class_registration_callback(EngineClassRegistrationCallback p_callback);
void register_engine_class(const StringName &p_name, const GDExtensionInstanceBindingCallbacks *p_callbacks);
void register_engine_classes();
Enforce template syntax `typename` over `class` (cherry picked from commit 87f5fb06912d19b3ff3ba80b747fcea3023a1ed5)
2024-03-10 21:02:43 +00:00
template <typename T>
Automatically register only engine classes whose header has been included (cherry picked from commit b507b3e5913344a97e90ba27b221e28924f555ab)
2023-10-12 03:59:59 +00:00
struct EngineClassRegistration {
EngineClassRegistration() {
add_engine_class_registration_callback(&EngineClassRegistration<T>::callback);
}
static void callback() {
register_engine_class(T::get_class_static(), &T::_gde_binding_callbacks);
}
};
} // namespace internal
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
} // namespace godot
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
#define GDCLASS(m_class, m_inherits) \
private: \
void operator=(const m_class &p_rval) {} \
friend class ::godot::ClassDB; \
\
protected: \
virtual const ::godot::StringName *_get_extension_class_name() const override { \
static ::godot::StringName string_name = get_class_static(); \
return &string_name; \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
virtual const GDExtensionInstanceBindingCallbacks *_get_bindings_callbacks() const override { \
Identifiers containing double underscore are reserved according to the C++ standard Rename __* to _gde_* https://timsong-cpp.github.io/cppwp/n3337/global.names https://en.cppreference.com/w/cpp/language/identifiers Identifiers appearing as a token or preprocessing token (i.e., not in user-defined-string-literal like operator ""id) (since C++11) of one of the following forms are reserved: - identifiers with a double underscore anywhere; - identifiers that begin with an underscore followed by an uppercase letter; - in the global namespace, identifiers that begin with an underscore.
2023-02-16 15:38:38 +00:00
return &_gde_binding_callbacks; \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
} \
\
static void (*_get_bind_methods())() { \
return &m_class::_bind_methods; \
} \
\
static void (::godot::Wrapped::*_get_notification())(int) { \
return (void(::godot::Wrapped::*)(int)) & m_class::_notification; \
} \
\
static bool (::godot::Wrapped::*_get_set())(const ::godot::StringName &p_name, const ::godot::Variant &p_property) { \
return (bool(::godot::Wrapped::*)(const ::godot::StringName &p_name, const ::godot::Variant &p_property)) & m_class::_set; \
} \
\
static bool (::godot::Wrapped::*_get_get())(const ::godot::StringName &p_name, ::godot::Variant &r_ret) const { \
return (bool(::godot::Wrapped::*)(const ::godot::StringName &p_name, ::godot::Variant &r_ret) const) & m_class::_get; \
} \
\
static void (::godot::Wrapped::*_get_get_property_list())(::godot::List<::godot::PropertyInfo> * p_list) const { \
return (void(::godot::Wrapped::*)(::godot::List<::godot::PropertyInfo> * p_list) const) & m_class::_get_property_list; \
} \
\
Ensure `const` correctness for wrappers (cherry picked from commit f651df5e7a74f4ee357b4db41880b31535e660a8)
2023-09-06 17:32:55 +00:00
static bool (::godot::Wrapped::*_get_property_can_revert())(const ::godot::StringName &p_name) const { \
return (bool(::godot::Wrapped::*)(const ::godot::StringName &p_name) const) & m_class::_property_can_revert; \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
} \
\
Ensure `const` correctness for wrappers (cherry picked from commit f651df5e7a74f4ee357b4db41880b31535e660a8)
2023-09-06 17:32:55 +00:00
static bool (::godot::Wrapped::*_get_property_get_revert())(const ::godot::StringName &p_name, ::godot::Variant &) const { \
return (bool(::godot::Wrapped::*)(const ::godot::StringName &p_name, ::godot::Variant &) const) & m_class::_property_get_revert; \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
} \
\
Ensure `const` correctness for wrappers (cherry picked from commit f651df5e7a74f4ee357b4db41880b31535e660a8)
2023-09-06 17:32:55 +00:00
static ::godot::String (::godot::Wrapped::*_get_to_string())() const { \
return (::godot::String(::godot::Wrapped::*)() const) & m_class::_to_string; \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
} \
\
Enforce template syntax `typename` over `class` (cherry picked from commit 87f5fb06912d19b3ff3ba80b747fcea3023a1ed5)
2024-03-10 21:02:43 +00:00
template <typename T, typename B> \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
static void register_virtuals() { \
m_inherits::register_virtuals<T, B>(); \
} \
\
public: \
Add protections against registering classes that didn't use GDCLASS() (cherry picked from commit a61cdc88606fbd0230555f1657d0cd635ba4bb5b)
2023-10-21 22:54:46 +00:00
typedef m_class self_type; \
Give compile-time error if registering a class without its own `_bind_methods()` function (cherry picked from commit ca46ef4d256c727a116366334b705ecda0a06c5d)
2024-04-24 19:26:06 +00:00
typedef m_inherits parent_type; \
Add protections against registering classes that didn't use GDCLASS() (cherry picked from commit a61cdc88606fbd0230555f1657d0cd635ba4bb5b)
2023-10-21 22:54:46 +00:00
\
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
static void initialize_class() { \
static bool initialized = false; \
if (initialized) { \
return; \
} \
m_inherits::initialize_class(); \
if (m_class::_get_bind_methods() != m_inherits::_get_bind_methods()) { \
_bind_methods(); \
m_inherits::register_virtuals<m_class, m_inherits>(); \
} \
initialized = true; \
} \
\
mark return value of `get_class_static` and `get_parent_class_static` as const (cherry picked from commit 3db8549e19641d49dfcdf3055da6917699c07d1f)
2024-05-16 18:06:59 +00:00
static const ::godot::StringName &get_class_static() { \
static const ::godot::StringName string_name = ::godot::StringName(#m_class); \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
return string_name; \
} \
\
mark return value of `get_class_static` and `get_parent_class_static` as const (cherry picked from commit 3db8549e19641d49dfcdf3055da6917699c07d1f)
2024-05-16 18:06:59 +00:00
static const ::godot::StringName &get_parent_class_static() { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
return m_inherits::get_class_static(); \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static GDExtensionObjectPtr create(void *data) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
m_class *new_object = memnew(m_class); \
return new_object->_owner; \
} \
\
static void notification_bind(GDExtensionClassInstancePtr p_instance, int32_t p_what) { \
if (p_instance && m_class::_get_notification()) { \
Fix _notification with parent and child classes (cherry picked from commit 23c010900c9a09c5c99bfbb0d465cd468aa74b6c)
2024-02-02 16:07:45 +00:00
m_inherits::notification_bind(p_instance, p_what); \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
if (m_class::_get_notification() != m_inherits::_get_notification()) { \
m_class *cls = reinterpret_cast<m_class *>(p_instance); \
Fix _notification with parent and child classes (cherry picked from commit 23c010900c9a09c5c99bfbb0d465cd468aa74b6c)
2024-02-02 16:07:45 +00:00
cls->_notification(p_what); \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
} \
} \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static GDExtensionBool set_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionConstVariantPtr p_value) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
if (p_instance && m_class::_get_set()) { \
if (m_class::_get_set() != m_inherits::_get_set()) { \
m_class *cls = reinterpret_cast<m_class *>(p_instance); \
return cls->_set(*reinterpret_cast<const ::godot::StringName *>(p_name), *reinterpret_cast<const ::godot::Variant *>(p_value)); \
} \
return m_inherits::set_bind(p_instance, p_name, p_value); \
} \
return false; \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static GDExtensionBool get_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionVariantPtr r_ret) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
if (p_instance && m_class::_get_get()) { \
if (m_class::_get_get() != m_inherits::_get_get()) { \
m_class *cls = reinterpret_cast<m_class *>(p_instance); \
return cls->_get(*reinterpret_cast<const ::godot::StringName *>(p_name), *reinterpret_cast<::godot::Variant *>(r_ret)); \
} \
return m_inherits::get_bind(p_instance, p_name, r_ret); \
} \
return false; \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static const GDExtensionPropertyInfo *get_property_list_bind(GDExtensionClassInstancePtr p_instance, uint32_t *r_count) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
if (p_instance && m_class::_get_get_property_list()) { \
if (m_class::_get_get_property_list() != m_inherits::_get_get_property_list()) { \
m_class *cls = reinterpret_cast<m_class *>(p_instance); \
ERR_FAIL_COND_V_MSG(!cls->plist_owned.is_empty() || cls->plist != nullptr || cls->plist_size != 0, nullptr, "Internal error, property list was not freed by engine!"); \
cls->_get_property_list(&cls->plist_owned); \
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
cls->plist = reinterpret_cast<GDExtensionPropertyInfo *>(memalloc(sizeof(GDExtensionPropertyInfo) * cls->plist_owned.size())); \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
cls->plist_size = 0; \
for (const ::godot::PropertyInfo &E : cls->plist_owned) { \
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
cls->plist[cls->plist_size].type = static_cast<GDExtensionVariantType>(E.type); \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
cls->plist[cls->plist_size].name = E.name._native_ptr(); \
cls->plist[cls->plist_size].hint = E.hint; \
cls->plist[cls->plist_size].hint_string = E.hint_string._native_ptr(); \
cls->plist[cls->plist_size].class_name = E.class_name._native_ptr(); \
cls->plist[cls->plist_size].usage = E.usage; \
cls->plist_size++; \
} \
if (r_count) \
*r_count = cls->plist_size; \
return cls->plist; \
} \
return m_inherits::get_property_list_bind(p_instance, r_count); \
} \
return nullptr; \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static void free_property_list_bind(GDExtensionClassInstancePtr p_instance, const GDExtensionPropertyInfo *p_list) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
if (p_instance) { \
m_class *cls = reinterpret_cast<m_class *>(p_instance); \
ERR_FAIL_COND_MSG(cls->plist == nullptr, "Internal error, property list double free!"); \
memfree(cls->plist); \
cls->plist = nullptr; \
cls->plist_size = 0; \
cls->plist_owned.clear(); \
} \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static GDExtensionBool property_can_revert_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
if (p_instance && m_class::_get_property_can_revert()) { \
if (m_class::_get_property_can_revert() != m_inherits::_get_property_can_revert()) { \
m_class *cls = reinterpret_cast<m_class *>(p_instance); \
return cls->_property_can_revert(*reinterpret_cast<const ::godot::StringName *>(p_name)); \
} \
return m_inherits::property_can_revert_bind(p_instance, p_name); \
} \
return false; \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static GDExtensionBool property_get_revert_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionVariantPtr r_ret) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
if (p_instance && m_class::_get_property_get_revert()) { \
if (m_class::_get_property_get_revert() != m_inherits::_get_property_get_revert()) { \
m_class *cls = reinterpret_cast<m_class *>(p_instance); \
return cls->_property_get_revert(*reinterpret_cast<const ::godot::StringName *>(p_name), *reinterpret_cast<::godot::Variant *>(r_ret)); \
} \
return m_inherits::property_get_revert_bind(p_instance, p_name, r_ret); \
} \
return false; \
} \
\
Rename GDNative to GDExtension Non-exhaustive list of case-sensitive renames: GDExtension -> GDNative GDNATIVE -> GDEXTENSION gdextension -> gdnative ExtensionExtension -> Extension (for where there was GDNativeExtension) EXTENSION_EXTENSION -> EXTENSION (for where there was GDNATIVE_EXTENSION) gdnlib -> gdextension gdn_interface -> gde_interface gdni -> gde_interface
2022-12-07 13:11:44 +00:00
static void to_string_bind(GDExtensionClassInstancePtr p_instance, GDExtensionBool *r_is_valid, GDExtensionStringPtr r_out) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
if (p_instance && m_class::_get_to_string()) { \
if (m_class::_get_to_string() != m_inherits::_get_to_string()) { \
m_class *cls = reinterpret_cast<m_class *>(p_instance); \
*reinterpret_cast<::godot::String *>(r_out) = cls->_to_string(); \
*r_is_valid = true; \
return; \
} \
m_inherits::to_string_bind(p_instance, r_is_valid, r_out); \
} \
} \
\
static void free(void *data, GDExtensionClassInstancePtr ptr) { \
if (ptr) { \
m_class *cls = reinterpret_cast<m_class *>(ptr); \
cls->~m_class(); \
::godot::Memory::free_static(cls); \
} \
} \
\
Identifiers containing double underscore are reserved according to the C++ standard Rename __* to _gde_* https://timsong-cpp.github.io/cppwp/n3337/global.names https://en.cppreference.com/w/cpp/language/identifiers Identifiers appearing as a token or preprocessing token (i.e., not in user-defined-string-literal like operator ""id) (since C++11) of one of the following forms are reserved: - identifiers with a double underscore anywhere; - identifiers that begin with an underscore followed by an uppercase letter; - in the global namespace, identifiers that begin with an underscore.
2023-02-16 15:38:38 +00:00
static void *_gde_binding_create_callback(void *p_token, void *p_instance) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
return nullptr; \
} \
\
Identifiers containing double underscore are reserved according to the C++ standard Rename __* to _gde_* https://timsong-cpp.github.io/cppwp/n3337/global.names https://en.cppreference.com/w/cpp/language/identifiers Identifiers appearing as a token or preprocessing token (i.e., not in user-defined-string-literal like operator ""id) (since C++11) of one of the following forms are reserved: - identifiers with a double underscore anywhere; - identifiers that begin with an underscore followed by an uppercase letter; - in the global namespace, identifiers that begin with an underscore.
2023-02-16 15:38:38 +00:00
static void _gde_binding_free_callback(void *p_token, void *p_instance, void *p_binding) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
} \
\
Identifiers containing double underscore are reserved according to the C++ standard Rename __* to _gde_* https://timsong-cpp.github.io/cppwp/n3337/global.names https://en.cppreference.com/w/cpp/language/identifiers Identifiers appearing as a token or preprocessing token (i.e., not in user-defined-string-literal like operator ""id) (since C++11) of one of the following forms are reserved: - identifiers with a double underscore anywhere; - identifiers that begin with an underscore followed by an uppercase letter; - in the global namespace, identifiers that begin with an underscore.
2023-02-16 15:38:38 +00:00
static GDExtensionBool _gde_binding_reference_callback(void *p_token, void *p_instance, GDExtensionBool p_reference) { \
Fix lifetime of StringName objects returned by Wrapped::_get_property_list
2022-11-29 17:12:47 +00:00
return true; \
} \
\
Identifiers containing double underscore are reserved according to the C++ standard Rename __* to _gde_* https://timsong-cpp.github.io/cppwp/n3337/global.names https://en.cppreference.com/w/cpp/language/identifiers Identifiers appearing as a token or preprocessing token (i.e., not in user-defined-string-literal like operator ""id) (since C++11) of one of the following forms are reserved: - identifiers with a double underscore anywhere; - identifiers that begin with an underscore followed by an uppercase letter; - in the global namespace, identifiers that begin with an underscore.
2023-02-16 15:38:38 +00:00
static constexpr GDExtensionInstanceBindingCallbacks _gde_binding_callbacks = { \
_gde_binding_create_callback, \
_gde_binding_free_callback, \
_gde_binding_reference_callback, \
GDCLASS synced by ending with "private:" • Matches implementation used by modules and godot itself • Apply same to GDEXTENSION_CLASS, setup with same diff-friendly spacers as GDCLASS (cherry picked from commit 6eb5d450bd28903f6a0fe45f8065fa70448e5793)
2023-11-01 17:44:14 +00:00
}; \
\
Fix NOTIFICATION_POSTINITIALIZE sent twice to native parent class (cherry picked from commit 06373ce1cf737a33d6a7b2b14cfe25ed729b9c48)
2024-04-24 18:01:53 +00:00
protected: \
virtual void _notificationv(int32_t p_what) override { \
m_class::notification_bind(this, p_what); \
} \
\
GDCLASS synced by ending with "private:" • Matches implementation used by modules and godot itself • Apply same to GDEXTENSION_CLASS, setup with same diff-friendly spacers as GDCLASS (cherry picked from commit 6eb5d450bd28903f6a0fe45f8065fa70448e5793)
2023-11-01 17:44:14 +00:00
private:
Add support for `_notification`, `_set`, `_get`, `_get_property_list`, `_property_can_revert`, `_property_get_revert`, and `_to_string` methods.
2022-08-19 07:30:06 +00:00
// Don't use this for your classes, use GDCLASS() instead.
GDCLASS synced by ending with "private:" • Matches implementation used by modules and godot itself • Apply same to GDEXTENSION_CLASS, setup with same diff-friendly spacers as GDCLASS (cherry picked from commit 6eb5d450bd28903f6a0fe45f8065fa70448e5793)
2023-11-01 17:44:14 +00:00
#define GDEXTENSION_CLASS_ALIAS(m_class, m_alias_for, m_inherits) /******************************************************************************************************************/ \
private: \
inline static ::godot::internal::EngineClassRegistration<m_class> _gde_engine_class_registration_helper; \
void operator=(const m_class &p_rval) {} \
Give compile-time error if registering a class without its own `_bind_methods()` function (cherry picked from commit ca46ef4d256c727a116366334b705ecda0a06c5d)
2024-04-24 19:26:06 +00:00
friend class ::godot::ClassDB; \
GDCLASS synced by ending with "private:" • Matches implementation used by modules and godot itself • Apply same to GDEXTENSION_CLASS, setup with same diff-friendly spacers as GDCLASS (cherry picked from commit 6eb5d450bd28903f6a0fe45f8065fa70448e5793)
2023-11-01 17:44:14 +00:00
\
protected: \
virtual const GDExtensionInstanceBindingCallbacks *_get_bindings_callbacks() const override { \
return &_gde_binding_callbacks; \
} \
\
m_class(const char *p_godot_class) : m_inherits(p_godot_class) {} \
m_class(GodotObject *p_godot_object) : m_inherits(p_godot_object) {} \
\
Give compile-time error if registering a class without its own `_bind_methods()` function (cherry picked from commit ca46ef4d256c727a116366334b705ecda0a06c5d)
2024-04-24 19:26:06 +00:00
static void _bind_methods() {} \
\
GDCLASS synced by ending with "private:" • Matches implementation used by modules and godot itself • Apply same to GDEXTENSION_CLASS, setup with same diff-friendly spacers as GDCLASS (cherry picked from commit 6eb5d450bd28903f6a0fe45f8065fa70448e5793)
2023-11-01 17:44:14 +00:00
static void (*_get_bind_methods())() { \
return nullptr; \
} \
\
static void (Wrapped::*_get_notification())(int) { \
return nullptr; \
} \
\
static bool (Wrapped::*_get_set())(const ::godot::StringName &p_name, const Variant &p_property) { \
return nullptr; \
} \
\
static bool (Wrapped::*_get_get())(const ::godot::StringName &p_name, Variant &r_ret) const { \
return nullptr; \
} \
\
static inline bool has_get_property_list() { \
return false; \
} \
\
static void (Wrapped::*_get_get_property_list())(List<PropertyInfo> * p_list) const { \
return nullptr; \
} \
\
static bool (Wrapped::*_get_property_can_revert())(const ::godot::StringName &p_name) const { \
return nullptr; \
} \
\
static bool (Wrapped::*_get_property_get_revert())(const ::godot::StringName &p_name, Variant &) const { \
return nullptr; \
} \
\
static void (Wrapped::*_get_validate_property())(::godot::PropertyInfo & p_property) const { \
return nullptr; \
} \
\
static String (Wrapped::*_get_to_string())() const { \
return nullptr; \
} \
\
public: \
typedef m_class self_type; \
Give compile-time error if registering a class without its own `_bind_methods()` function (cherry picked from commit ca46ef4d256c727a116366334b705ecda0a06c5d)
2024-04-24 19:26:06 +00:00
typedef m_inherits parent_type; \
GDCLASS synced by ending with "private:" • Matches implementation used by modules and godot itself • Apply same to GDEXTENSION_CLASS, setup with same diff-friendly spacers as GDCLASS (cherry picked from commit 6eb5d450bd28903f6a0fe45f8065fa70448e5793)
2023-11-01 17:44:14 +00:00
\
static void initialize_class() {} \
\
mark return value of `get_class_static` and `get_parent_class_static` as const (cherry picked from commit 3db8549e19641d49dfcdf3055da6917699c07d1f)
2024-05-16 18:06:59 +00:00
static const ::godot::StringName &get_class_static() { \
static const ::godot::StringName string_name = ::godot::StringName(#m_alias_for); \
GDCLASS synced by ending with "private:" • Matches implementation used by modules and godot itself • Apply same to GDEXTENSION_CLASS, setup with same diff-friendly spacers as GDCLASS (cherry picked from commit 6eb5d450bd28903f6a0fe45f8065fa70448e5793)
2023-11-01 17:44:14 +00:00
return string_name; \
} \
\
mark return value of `get_class_static` and `get_parent_class_static` as const (cherry picked from commit 3db8549e19641d49dfcdf3055da6917699c07d1f)
2024-05-16 18:06:59 +00:00
static const ::godot::StringName &get_parent_class_static() { \
GDCLASS synced by ending with "private:" • Matches implementation used by modules and godot itself • Apply same to GDEXTENSION_CLASS, setup with same diff-friendly spacers as GDCLASS (cherry picked from commit 6eb5d450bd28903f6a0fe45f8065fa70448e5793)
2023-11-01 17:44:14 +00:00
return m_inherits::get_class_static(); \
} \
\
static GDExtensionObjectPtr create(void *data) { \
return nullptr; \
} \
\
static void free(void *data, GDExtensionClassInstancePtr ptr) { \
} \
\
static void *_gde_binding_create_callback(void *p_token, void *p_instance) { \
/* Do not call memnew here, we don't want the post-initializer to be called */ \
return new ("") m_class((GodotObject *)p_instance); \
} \
static void _gde_binding_free_callback(void *p_token, void *p_instance, void *p_binding) { \
/* Explicitly call the deconstructor to ensure proper lifecycle for non-trivial members */ \
reinterpret_cast<m_class *>(p_binding)->~m_class(); \
Memory::free_static(reinterpret_cast<m_class *>(p_binding)); \
} \
static GDExtensionBool _gde_binding_reference_callback(void *p_token, void *p_instance, GDExtensionBool p_reference) { \
return true; \
} \
static constexpr GDExtensionInstanceBindingCallbacks _gde_binding_callbacks = { \
_gde_binding_create_callback, \
_gde_binding_free_callback, \
_gde_binding_reference_callback, \
}; \
m_class() : m_class(#m_alias_for) {} \
\
private:
Add static methods to `ClassDB` for the methods bound to the `ClassDB` singleton (cherry picked from commit 6f913563d88f6f3d51f50ed1f9432c909b621d5b)
2023-07-07 02:16:27 +00:00
// Don't use this for your classes, use GDCLASS() instead.
#define GDEXTENSION_CLASS(m_class, m_inherits) GDEXTENSION_CLASS_ALIAS(m_class, m_class, m_inherits)
Replace bindgins to work with extensions
2021-08-18 14:03:52 +00:00
Run scripts to format and make headers consistent
2022-10-09 06:47:07 +00:00
#endif // GODOT_WRAPPED_HPP