123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514 |
- /**************************************************************************/
- /* 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. */
- /**************************************************************************/
- #pragma once
- #include <godot_cpp/core/memory.hpp>
- #include <godot_cpp/core/property_info.hpp>
- #include <godot_cpp/templates/list.hpp>
- #include <godot_cpp/templates/vector.hpp>
- #include <godot_cpp/godot.hpp>
- #if defined(MACOS_ENABLED) && defined(HOT_RELOAD_ENABLED)
- #include <mutex>
- #define _GODOT_CPP_AVOID_THREAD_LOCAL
- #define _GODOT_CPP_THREAD_LOCAL
- #else
- #define _GODOT_CPP_THREAD_LOCAL thread_local
- #endif
- namespace godot {
- class ClassDB;
- typedef void GodotObject;
- template <typename T, std::enable_if_t<std::is_base_of<::godot::Wrapped, T>::value, bool> = true>
- _ALWAYS_INLINE_ void _pre_initialize();
- // Base for all engine classes, to contain the pointer to the engine instance.
- class Wrapped {
- friend class GDExtensionBinding;
- friend class ClassDB;
- friend void postinitialize_handler(Wrapped *);
- template <typename T, std::enable_if_t<std::is_base_of<::godot::Wrapped, T>::value, bool>>
- friend _ALWAYS_INLINE_ void _pre_initialize();
- #ifdef _GODOT_CPP_AVOID_THREAD_LOCAL
- static std::recursive_mutex _constructing_mutex;
- #endif
- _GODOT_CPP_THREAD_LOCAL static const StringName *_constructing_extension_class_name;
- _GODOT_CPP_THREAD_LOCAL static const GDExtensionInstanceBindingCallbacks *_constructing_class_binding_callbacks;
- #ifdef HOT_RELOAD_ENABLED
- _GODOT_CPP_THREAD_LOCAL static GDExtensionObjectPtr _constructing_recreate_owner;
- #endif
- template <typename T>
- _ALWAYS_INLINE_ static void _set_construct_info() {
- _constructing_extension_class_name = T::_get_extension_class_name();
- _constructing_class_binding_callbacks = &T::_gde_binding_callbacks;
- }
- protected:
- virtual bool _is_extension_class() const { return false; }
- static const StringName *_get_extension_class_name(); // This is needed to retrieve the class name before the godot object has its _extension and _extension_instance members assigned.
- 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; }
- void _validate_property(PropertyInfo &p_property) const {}
- String _to_string() const { return "[" + String(get_class_static()) + ":" + itos(get_instance_id()) + "]"; }
- static void notification_bind(GDExtensionClassInstancePtr p_instance, int32_t p_what, GDExtensionBool p_reversed) {}
- 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, uint32_t p_count) {}
- 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 GDExtensionBool validate_property_bind(GDExtensionClassInstancePtr p_instance, GDExtensionPropertyInfo *p_property) { return false; }
- static void to_string_bind(GDExtensionClassInstancePtr p_instance, GDExtensionBool *r_is_valid, GDExtensionStringPtr r_out) {}
- // The only reason this has to be held here, is when we return results of `_get_property_list` to Godot, we pass
- // pointers to strings in this list. They have to remain valid to pass the bridge, until the list is freed by Godot...
- ::godot::List<::godot::PropertyInfo> plist_owned;
- void _postinitialize();
- Wrapped(const StringName p_godot_class);
- Wrapped(GodotObject *p_godot_object);
- virtual ~Wrapped() {}
- public:
- static const StringName &get_class_static() {
- static const StringName string_name = StringName("Wrapped");
- return string_name;
- }
- uint64_t get_instance_id() const {
- return 0;
- }
- // Must be public but you should not touch this.
- GodotObject *_owner = nullptr;
- };
- template <typename T, std::enable_if_t<std::is_base_of<::godot::Wrapped, T>::value, bool>>
- _ALWAYS_INLINE_ void _pre_initialize() {
- #ifdef _GODOT_CPP_AVOID_THREAD_LOCAL
- Wrapped::_constructing_mutex.lock();
- #endif
- Wrapped::_set_construct_info<T>();
- }
- _FORCE_INLINE_ void snarray_add_str(Vector<StringName> &arr) {
- }
- _FORCE_INLINE_ void snarray_add_str(Vector<StringName> &arr, const StringName &p_str) {
- arr.push_back(p_str);
- }
- template <typename... P>
- _FORCE_INLINE_ void snarray_add_str(Vector<StringName> &arr, const StringName &p_str, P... p_args) {
- arr.push_back(p_str);
- snarray_add_str(arr, p_args...);
- }
- template <typename... P>
- _FORCE_INLINE_ Vector<StringName> snarray(P... p_args) {
- Vector<StringName> arr;
- snarray_add_str(arr, p_args...);
- return arr;
- }
- namespace internal {
- GDExtensionPropertyInfo *create_c_property_list(const ::godot::List<::godot::PropertyInfo> &plist_cpp, uint32_t *r_size);
- void free_c_property_list(GDExtensionPropertyInfo *plist);
- 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();
- template <typename T>
- 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
- } // namespace godot
- // Use this on top of your own classes.
- // Note: the trail of `***` is to keep sane diffs in PRs, because clang-format otherwise moves every `\` which makes
- // every line of the macro different
- #define GDCLASS(m_class, m_inherits) /***********************************************************************************************************************************************/ \
- private: \
- void operator=(const m_class & /*p_rval*/) {} \
- friend class ::godot::ClassDB; \
- friend class ::godot::Wrapped; \
- \
- protected: \
- virtual bool _is_extension_class() const override { \
- return true; \
- } \
- \
- static const ::godot::StringName *_get_extension_class_name() { \
- const ::godot::StringName &string_name = get_class_static(); \
- return &string_name; \
- } \
- \
- 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; \
- } \
- \
- 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; \
- } \
- \
- 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; \
- } \
- \
- static void (::godot::Wrapped::*_get_validate_property())(::godot::PropertyInfo & p_property) const { \
- return (void (::godot::Wrapped::*)(::godot::PropertyInfo & p_property) const) & m_class::_validate_property; \
- } \
- \
- static ::godot::String (::godot::Wrapped::*_get_to_string())() const { \
- return (::godot::String (::godot::Wrapped::*)() const) & m_class::_to_string; \
- } \
- \
- template <typename T, typename B> \
- static void register_virtuals() { \
- m_inherits::register_virtuals<T, B>(); \
- } \
- \
- public: \
- typedef m_class self_type; \
- typedef m_inherits parent_type; \
- \
- 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; \
- } \
- \
- static const ::godot::StringName &get_class_static() { \
- static const ::godot::StringName string_name = ::godot::StringName(U## #m_class); \
- return string_name; \
- } \
- \
- static const ::godot::StringName &get_parent_class_static() { \
- return m_inherits::get_class_static(); \
- } \
- \
- static void notification_bind(GDExtensionClassInstancePtr p_instance, int32_t p_what, GDExtensionBool p_reversed) { \
- if (p_instance && m_class::_get_notification()) { \
- if (!p_reversed) { \
- m_inherits::notification_bind(p_instance, p_what, p_reversed); \
- } \
- if (m_class::_get_notification() != m_inherits::_get_notification()) { \
- m_class *cls = reinterpret_cast<m_class *>(p_instance); \
- cls->_notification(p_what); \
- } \
- if (p_reversed) { \
- m_inherits::notification_bind(p_instance, p_what, p_reversed); \
- } \
- } \
- } \
- \
- static GDExtensionBool set_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionConstVariantPtr p_value) { \
- if (p_instance) { \
- if (m_inherits::set_bind(p_instance, p_name, p_value)) { \
- return true; \
- } \
- 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 false; \
- } \
- \
- static GDExtensionBool get_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionVariantPtr r_ret) { \
- if (p_instance) { \
- if (m_inherits::get_bind(p_instance, p_name, r_ret)) { \
- return true; \
- } \
- 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 false; \
- } \
- \
- static inline bool has_get_property_list() { \
- return m_class::_get_get_property_list() && m_class::_get_get_property_list() != m_inherits::_get_get_property_list(); \
- } \
- \
- static const GDExtensionPropertyInfo *get_property_list_bind(GDExtensionClassInstancePtr p_instance, uint32_t *r_count) { \
- if (!p_instance) { \
- if (r_count) \
- *r_count = 0; \
- return nullptr; \
- } \
- m_class *cls = reinterpret_cast<m_class *>(p_instance); \
- ::godot::List<::godot::PropertyInfo> &plist_cpp = cls->plist_owned; \
- ERR_FAIL_COND_V_MSG(!plist_cpp.is_empty(), nullptr, "Internal error, property list was not freed by engine!"); \
- cls->_get_property_list(&plist_cpp); \
- return ::godot::internal::create_c_property_list(plist_cpp, r_count); \
- } \
- \
- static void free_property_list_bind(GDExtensionClassInstancePtr p_instance, const GDExtensionPropertyInfo *p_list, uint32_t /*p_count*/) { \
- if (p_instance) { \
- m_class *cls = reinterpret_cast<m_class *>(p_instance); \
- cls->plist_owned.clear(); \
- ::godot::internal::free_c_property_list(const_cast<GDExtensionPropertyInfo *>(p_list)); \
- } \
- } \
- \
- static GDExtensionBool property_can_revert_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name) { \
- 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; \
- } \
- \
- static GDExtensionBool property_get_revert_bind(GDExtensionClassInstancePtr p_instance, GDExtensionConstStringNamePtr p_name, GDExtensionVariantPtr r_ret) { \
- 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; \
- } \
- \
- static GDExtensionBool validate_property_bind(GDExtensionClassInstancePtr p_instance, GDExtensionPropertyInfo *p_property) { \
- bool ret = false; \
- if (p_instance && m_class::_get_validate_property()) { \
- ret = m_inherits::validate_property_bind(p_instance, p_property); \
- if (m_class::_get_validate_property() != m_inherits::_get_validate_property()) { \
- m_class *cls = reinterpret_cast<m_class *>(p_instance); \
- ::godot::PropertyInfo info(p_property); \
- cls->_validate_property(info); \
- info._update(p_property); \
- return true; \
- } \
- } \
- return ret; \
- } \
- \
- static void to_string_bind(GDExtensionClassInstancePtr p_instance, GDExtensionBool *r_is_valid, GDExtensionStringPtr r_out) { \
- 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); \
- } \
- } \
- \
- static void *_gde_binding_create_callback(void * /*p_token*/, void * /*p_instance*/) { \
- return nullptr; \
- } \
- \
- static void _gde_binding_free_callback(void * /*p_token*/, void * /*p_instance*/, void * /*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, \
- }; \
- \
- private:
- // Don't use this for your classes, use GDCLASS() instead.
- #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) {} \
- friend class ::godot::ClassDB; \
- friend class ::godot::Wrapped; \
- \
- protected: \
- m_class(const char *p_godot_class) : m_inherits(p_godot_class) {} \
- m_class(GodotObject *p_godot_object) : m_inherits(p_godot_object) {} \
- \
- static void _bind_methods() {} \
- \
- 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; \
- typedef m_inherits parent_type; \
- \
- static void initialize_class() {} \
- \
- static const ::godot::StringName &get_class_static() { \
- static const ::godot::StringName string_name = ::godot::StringName(#m_alias_for); \
- return string_name; \
- } \
- \
- static const ::godot::StringName &get_parent_class_static() { \
- return m_inherits::get_class_static(); \
- } \
- \
- 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:
- // 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)
- #define GDVIRTUAL_CALL(m_name, ...) _gdvirtual_##m_name##_call(__VA_ARGS__)
- #define GDVIRTUAL_CALL_PTR(m_obj, m_name, ...) m_obj->_gdvirtual_##m_name##_call(__VA_ARGS__)
- #define GDVIRTUAL_BIND(m_name, ...) ::godot::ClassDB::add_virtual_method(get_class_static(), _gdvirtual_##m_name##_get_method_info(), ::godot::snarray(__VA_ARGS__));
- #define GDVIRTUAL_IS_OVERRIDDEN(m_name) _gdvirtual_##m_name##_overridden()
- #define GDVIRTUAL_IS_OVERRIDDEN_PTR(m_obj, m_name) m_obj->_gdvirtual_##m_name##_overridden()
|