/**************************************************************************/ /* ref.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 #include #include #include #include #include namespace godot { // Helper class for RefCounted objects, same as Godot one. template class Ref { T *reference = nullptr; _FORCE_INLINE_ void ref(const Ref &p_from) { ref_pointer(p_from.reference); } template _FORCE_INLINE_ void ref_pointer(T *p_refcounted) { if (p_refcounted == reference) { return; } // This will go out of scope and get unref'd. Ref cleanup_ref; cleanup_ref.reference = reference; reference = p_refcounted; if (reference) { if constexpr (Init) { if (!reference->init_ref()) { reference = nullptr; } } else { if (!reference->reference()) { reference = nullptr; } } } } public: static _FORCE_INLINE_ String get_class_static() { return T::get_class_static(); } _FORCE_INLINE_ bool operator==(const T *p_ptr) const { return reference == p_ptr; } _FORCE_INLINE_ bool operator!=(const T *p_ptr) const { return reference != p_ptr; } _FORCE_INLINE_ bool operator<(const Ref &p_r) const { return reference < p_r.reference; } _FORCE_INLINE_ bool operator==(const Ref &p_r) const { return reference == p_r.reference; } _FORCE_INLINE_ bool operator!=(const Ref &p_r) const { return reference != p_r.reference; } _FORCE_INLINE_ T *operator*() const { return reference; } _FORCE_INLINE_ T *operator->() const { return reference; } _FORCE_INLINE_ T *ptr() const { return reference; } operator Variant() const { return Variant(reference); } void operator=(const Ref &p_from) { ref(p_from); } void operator=(Ref &&p_from) { if (reference == p_from.reference) { return; } unref(); reference = p_from.reference; p_from.reference = nullptr; } template void operator=(const Ref &p_from) { ref_pointer(Object::cast_to(p_from.ptr())); } void operator=(T *p_from) { ref_pointer(p_from); } void operator=(const Variant &p_variant) { Object *object = p_variant.get_validated_object(); if (object == reference) { return; } ref_pointer(Object::cast_to(object)); } template void reference_ptr(T_Other *p_ptr) { if (reference == p_ptr) { return; } ref_pointer(Object::cast_to(p_ptr)); } Ref(const Ref &p_from) { this->operator=(p_from); } Ref(Ref &&p_from) { reference = p_from.reference; p_from.reference = nullptr; } template Ref(const Ref &p_from) { this->operator=(p_from); } Ref(T *p_from) { this->operator=(p_from); } Ref(const Variant &p_from) { this->operator=(p_from); } inline bool is_valid() const { return reference != nullptr; } inline bool is_null() const { return reference == nullptr; } void unref() { if (reference) { // NOTE: `reinterpret_cast` is "safe" here because we know `T` has simple linear // inheritance to `RefCounted`. This guarantees that `T * == `RefCounted *`, which // allows us to declare `Ref` with forward declared `T` types. if (reinterpret_cast(reference)->unreference()) { memdelete(reinterpret_cast(reference)); } reference = nullptr; } } template void instantiate(VarArgs... p_params) { ref(memnew(T(p_params...))); } uint32_t hash() const { return HashMapHasherDefault::hash(reference); } Ref() = default; ~Ref() { unref(); } // Used exclusively in the bindings to recreate the Ref Godot encapsulates in return values, // without adding to the refcount. inline static Ref _gde_internal_constructor(Object *obj) { Ref r; r.reference = reinterpret_cast(obj); return r; } }; template struct PtrToArg> { _FORCE_INLINE_ static Ref convert(const void *p_ptr) { GDExtensionRefPtr ref = (GDExtensionRefPtr)p_ptr; if (unlikely(!p_ptr)) { return Ref(); } return Ref(reinterpret_cast(::godot::internal::get_object_instance_binding(::godot::gdextension_interface::ref_get_object(ref)))); } typedef Ref EncodeT; _FORCE_INLINE_ static void encode(Ref p_val, void *p_ptr) { GDExtensionRefPtr ref = (GDExtensionRefPtr)p_ptr; ERR_FAIL_NULL(ref); // This code assumes that p_ptr points to an unset Ref variable on the Godot side // so we only set it if we have an object to set. if (p_val.is_valid()) { ::godot::gdextension_interface::ref_set_object(ref, p_val->_owner); } } }; template struct PtrToArg &> { typedef Ref EncodeT; _FORCE_INLINE_ static Ref convert(const void *p_ptr) { GDExtensionRefPtr ref = const_cast(p_ptr); if (unlikely(!p_ptr)) { return Ref(); } return Ref(reinterpret_cast(::godot::internal::get_object_instance_binding(::godot::gdextension_interface::ref_get_object(ref)))); } }; template struct GetTypeInfo, typename EnableIf::value>::type> { static constexpr GDExtensionVariantType VARIANT_TYPE = GDEXTENSION_VARIANT_TYPE_OBJECT; static constexpr GDExtensionClassMethodArgumentMetadata METADATA = GDEXTENSION_METHOD_ARGUMENT_METADATA_NONE; static inline PropertyInfo get_class_info() { return make_property_info(Variant::Type::OBJECT, "", PROPERTY_HINT_RESOURCE_TYPE, T::get_class_static()); } }; template struct GetTypeInfo &, typename EnableIf::value>::type> { static constexpr GDExtensionVariantType VARIANT_TYPE = GDEXTENSION_VARIANT_TYPE_OBJECT; static constexpr GDExtensionClassMethodArgumentMetadata METADATA = GDEXTENSION_METHOD_ARGUMENT_METADATA_NONE; static inline PropertyInfo get_class_info() { return make_property_info(Variant::Type::OBJECT, "", PROPERTY_HINT_RESOURCE_TYPE, T::get_class_static()); } }; } // namespace godot