wrapped.hpp 43 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387
  1. /*************************************************************************/
  2. /* wrapped.hpp */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /*************************************************************************/
  30. #ifndef GODOT_CPP_WRAPPED_HPP
  31. #define GODOT_CPP_WRAPPED_HPP
  32. #include <godot_cpp/core/memory.hpp>
  33. #include <godot_cpp/core/property_info.hpp>
  34. #include <godot_cpp/templates/list.hpp>
  35. #include <godot_cpp/godot.hpp>
  36. namespace godot {
  37. typedef void GodotObject;
  38. // Base for all engine classes, to contain the pointer to the engine instance.
  39. class Wrapped {
  40. friend class GDExtensionBinding;
  41. friend void postinitialize_handler(Wrapped *);
  42. protected:
  43. virtual const char *_get_extension_class() const; // This is needed to retrieve the class name before the godot object has its _extension and _extension_instance members assigned.
  44. virtual const GDNativeInstanceBindingCallbacks *_get_bindings_callbacks() const = 0;
  45. void _notification(int p_what){};
  46. bool _set(const StringName &p_name, const Variant &p_property) { return false; };
  47. bool _get(const StringName &p_name, Variant &r_property) const { return false; };
  48. void _get_property_list(List<PropertyInfo> *p_list) const {};
  49. bool _property_can_revert(const StringName &p_name) const { return false; };
  50. bool _property_get_revert(const StringName &p_name, Variant &r_property) const { return false; };
  51. String _to_string() const { return "[" + String(get_class_static()) + ":" + itos(get_instance_id()) + "]"; }
  52. static void notification_bind(GDExtensionClassInstancePtr p_instance, int32_t p_what) {}
  53. static GDNativeBool set_bind(GDExtensionClassInstancePtr p_instance, const GDNativeStringNamePtr p_name, const GDNativeVariantPtr p_value) { return false; }
  54. static GDNativeBool get_bind(GDExtensionClassInstancePtr p_instance, const GDNativeStringNamePtr p_name, GDNativeVariantPtr r_ret) { return false; }
  55. static const GDNativePropertyInfo *get_property_list_bind(GDExtensionClassInstancePtr p_instance, uint32_t *r_count) { return nullptr; }
  56. static void free_property_list_bind(GDExtensionClassInstancePtr p_instance, const GDNativePropertyInfo *p_list) {}
  57. static GDNativeBool property_can_revert_bind(GDExtensionClassInstancePtr p_instance, const GDNativeStringNamePtr p_name) { return false; }
  58. static GDNativeBool property_get_revert_bind(GDExtensionClassInstancePtr p_instance, const GDNativeStringNamePtr p_name, GDNativeVariantPtr r_ret) { return false; }
  59. static void to_string_bind(GDExtensionClassInstancePtr p_instance, GDNativeStringPtr r_out) {}
  60. GDNativePropertyInfo *plist = nullptr;
  61. uint32_t plist_size = 0;
  62. void _postinitialize();
  63. Wrapped(const char *p_godot_class);
  64. Wrapped(GodotObject *p_godot_object);
  65. public:
  66. static const char *get_class_static() {
  67. return "Wrapped";
  68. }
  69. uint64_t get_instance_id() const {
  70. return 0;
  71. }
  72. static _FORCE_INLINE_ char *_alloc_and_copy_cstr(const char *p_str) {
  73. size_t size = strlen(p_str) + 1;
  74. char *ret = reinterpret_cast<char *>(memalloc(size));
  75. memcpy(ret, p_str, size);
  76. return ret;
  77. }
  78. // Must be public but you should not touch this.
  79. GodotObject *_owner = nullptr;
  80. };
  81. } // namespace godot
  82. #define GDCLASS(m_class, m_inherits) \
  83. private: \
  84. void operator=(const m_class &p_rval) {} \
  85. friend class ::godot::ClassDB; \
  86. \
  87. protected: \
  88. virtual const char *_get_extension_class() const override { \
  89. return get_class_static(); \
  90. } \
  91. \
  92. virtual const GDNativeInstanceBindingCallbacks *_get_bindings_callbacks() const override { \
  93. return &___binding_callbacks; \
  94. } \
  95. \
  96. static void (*_get_bind_methods())() { \
  97. return &m_class::_bind_methods; \
  98. } \
  99. \
  100. static void (::godot::Wrapped::*_get_notification())(int) { \
  101. return (void(::godot::Wrapped::*)(int)) & m_class::_notification; \
  102. } \
  103. \
  104. static bool (::godot::Wrapped::*_get_set())(const ::godot::StringName &p_name, const ::godot::Variant &p_property) { \
  105. return (bool(::godot::Wrapped::*)(const ::godot::StringName &p_name, const ::godot::Variant &p_property)) & m_class::_set; \
  106. } \
  107. \
  108. static bool (::godot::Wrapped::*_get_get())(const ::godot::StringName &p_name, ::godot::Variant &r_ret) { \
  109. return (bool(::godot::Wrapped::*)(const ::godot::StringName &p_name, ::godot::Variant &r_ret)) & m_class::_set; \
  110. } \
  111. \
  112. static void (::godot::Wrapped::*_get_get_property_list())(::godot::List<::godot::PropertyInfo> * p_list) { \
  113. return (void(::godot::Wrapped::*)(::godot::List<::godot::PropertyInfo> * p_list)) & m_class::_get_property_list; \
  114. } \
  115. \
  116. static bool (::godot::Wrapped::*_get_property_can_revert())(const ::godot::StringName &p_name) { \
  117. return (bool(::godot::Wrapped::*)(const ::godot::StringName &p_name)) & m_class::_property_can_revert; \
  118. } \
  119. \
  120. static bool (::godot::Wrapped::*_get_property_get_revert())(const ::godot::StringName &p_name, ::godot::Variant &) { \
  121. return (bool(::godot::Wrapped::*)(const ::godot::StringName &p_name, ::godot::Variant &)) & m_class::_property_get_revert; \
  122. } \
  123. \
  124. static ::godot::String (::godot::Wrapped::*_get_to_string())() { \
  125. return (::godot::String(::godot::Wrapped::*)()) & m_class::_to_string; \
  126. } \
  127. \
  128. template <class T> \
  129. static void register_virtuals() { \
  130. m_inherits::register_virtuals<T>(); \
  131. } \
  132. \
  133. public: \
  134. static void initialize_class() { \
  135. static bool initialized = false; \
  136. if (initialized) { \
  137. return; \
  138. } \
  139. m_inherits::initialize_class(); \
  140. if (m_class::_get_bind_methods() != m_inherits::_get_bind_methods()) { \
  141. _bind_methods(); \
  142. m_inherits::register_virtuals<m_class>(); \
  143. } \
  144. initialized = true; \
  145. } \
  146. \
  147. static const char *get_class_static() { \
  148. return #m_class; \
  149. } \
  150. \
  151. static const char *get_parent_class_static() { \
  152. return m_inherits::get_class_static(); \
  153. } \
  154. \
  155. static GDNativeObjectPtr create(void *data) { \
  156. m_class *new_object = memnew(m_class); \
  157. return new_object->_owner; \
  158. } \
  159. \
  160. static void notification_bind(GDExtensionClassInstancePtr p_instance, int32_t p_what) { \
  161. if (p_instance && m_class::_get_notification()) { \
  162. if (m_class::_get_notification() != m_inherits::_get_notification()) { \
  163. m_class *cls = reinterpret_cast<m_class *>(p_instance); \
  164. return cls->_notification(p_what); \
  165. } \
  166. m_inherits::notification_bind(p_instance, p_what); \
  167. } \
  168. } \
  169. \
  170. static GDNativeBool set_bind(GDExtensionClassInstancePtr p_instance, const GDNativeStringNamePtr p_name, const GDNativeVariantPtr p_value) { \
  171. if (p_instance && m_class::_get_set()) { \
  172. if (m_class::_get_set() != m_inherits::_get_set()) { \
  173. m_class *cls = reinterpret_cast<m_class *>(p_instance); \
  174. return cls->_set(*reinterpret_cast<const ::godot::StringName *>(p_name), *reinterpret_cast<const ::godot::Variant *>(p_value)); \
  175. } \
  176. return m_inherits::set_bind(p_instance, p_name, p_value); \
  177. } \
  178. return false; \
  179. } \
  180. \
  181. static GDNativeBool get_bind(GDExtensionClassInstancePtr p_instance, const GDNativeStringNamePtr p_name, GDNativeVariantPtr r_ret) { \
  182. if (p_instance && m_class::_get_get()) { \
  183. if (m_class::_get_get() != m_inherits::_get_get()) { \
  184. m_class *cls = reinterpret_cast<m_class *>(p_instance); \
  185. return cls->_get(*reinterpret_cast<const ::godot::StringName *>(p_name), *reinterpret_cast<::godot::Variant *>(r_ret)); \
  186. } \
  187. return m_inherits::get_bind(p_instance, p_name, r_ret); \
  188. } \
  189. return false; \
  190. } \
  191. \
  192. static const GDNativePropertyInfo *get_property_list_bind(GDExtensionClassInstancePtr p_instance, uint32_t *r_count) { \
  193. if (p_instance && m_class::_get_get_property_list()) { \
  194. if (m_class::_get_get_property_list() != m_inherits::_get_get_property_list()) { \
  195. m_class *cls = reinterpret_cast<m_class *>(p_instance); \
  196. ::godot::List<::godot::PropertyInfo> list; \
  197. cls->_get_property_list(&list); \
  198. ERR_FAIL_COND_V_MSG(cls->plist != nullptr || cls->plist_size != 0, nullptr, "Internal error, property list was not freed by engine!"); \
  199. cls->plist = reinterpret_cast<GDNativePropertyInfo *>(memalloc(sizeof(GDNativePropertyInfo) * list.size())); \
  200. cls->plist_size = 0; \
  201. for (const ::godot::PropertyInfo &E : list) { \
  202. cls->plist[cls->plist_size].type = E.type; \
  203. cls->plist[cls->plist_size].name = _alloc_and_copy_cstr(E.name); \
  204. cls->plist[cls->plist_size].hint = E.hint; \
  205. cls->plist[cls->plist_size].hint_string = _alloc_and_copy_cstr(E.hint_string); \
  206. cls->plist[cls->plist_size].class_name = _alloc_and_copy_cstr(E.class_name); \
  207. cls->plist[cls->plist_size].usage = E.usage; \
  208. cls->plist_size++; \
  209. } \
  210. if (r_count) \
  211. *r_count = cls->plist_size; \
  212. return cls->plist; \
  213. } \
  214. return m_inherits::get_property_list_bind(p_instance, r_count); \
  215. } \
  216. return nullptr; \
  217. } \
  218. \
  219. static void free_property_list_bind(GDExtensionClassInstancePtr p_instance, const GDNativePropertyInfo *p_list) { \
  220. if (p_instance) { \
  221. m_class *cls = reinterpret_cast<m_class *>(p_instance); \
  222. ERR_FAIL_COND_MSG(cls->plist == nullptr, "Internal error, property list double free!"); \
  223. for (size_t i = 0; i < cls->plist_size; i++) { \
  224. memfree(const_cast<char *>(cls->plist[i].name)); \
  225. memfree(const_cast<char *>(cls->plist[i].class_name)); \
  226. memfree(const_cast<char *>(cls->plist[i].hint_string)); \
  227. } \
  228. memfree(cls->plist); \
  229. cls->plist = nullptr; \
  230. cls->plist_size = 0; \
  231. } \
  232. } \
  233. \
  234. static GDNativeBool property_can_revert_bind(GDExtensionClassInstancePtr p_instance, const GDNativeStringNamePtr p_name) { \
  235. if (p_instance && m_class::_get_property_can_revert()) { \
  236. if (m_class::_get_property_can_revert() != m_inherits::_get_property_can_revert()) { \
  237. m_class *cls = reinterpret_cast<m_class *>(p_instance); \
  238. return cls->_property_can_revert(*reinterpret_cast<const ::godot::StringName *>(p_name)); \
  239. } \
  240. return m_inherits::property_can_revert_bind(p_instance, p_name); \
  241. } \
  242. return false; \
  243. } \
  244. \
  245. static GDNativeBool property_get_revert_bind(GDExtensionClassInstancePtr p_instance, const GDNativeStringNamePtr p_name, GDNativeVariantPtr r_ret) { \
  246. if (p_instance && m_class::_get_property_get_revert()) { \
  247. if (m_class::_get_property_get_revert() != m_inherits::_get_property_get_revert()) { \
  248. m_class *cls = reinterpret_cast<m_class *>(p_instance); \
  249. return cls->_property_get_revert(*reinterpret_cast<const ::godot::StringName *>(p_name), *reinterpret_cast<::godot::Variant *>(r_ret)); \
  250. } \
  251. return m_inherits::property_get_revert_bind(p_instance, p_name, r_ret); \
  252. } \
  253. return false; \
  254. } \
  255. \
  256. static void to_string_bind(GDExtensionClassInstancePtr p_instance, GDNativeStringPtr r_out) { \
  257. if (p_instance && m_class::_get_to_string()) { \
  258. if (m_class::_get_to_string() != m_inherits::_get_to_string()) { \
  259. m_class *cls = reinterpret_cast<m_class *>(p_instance); \
  260. *reinterpret_cast<::godot::String *>(r_out) = cls->_to_string(); \
  261. return; \
  262. } \
  263. m_inherits::to_string_bind(p_instance, r_out); \
  264. } \
  265. } \
  266. \
  267. static void free(void *data, GDExtensionClassInstancePtr ptr) { \
  268. if (ptr) { \
  269. m_class *cls = reinterpret_cast<m_class *>(ptr); \
  270. cls->~m_class(); \
  271. ::godot::Memory::free_static(cls); \
  272. } \
  273. } \
  274. \
  275. static void *___binding_create_callback(void *p_token, void *p_instance) { \
  276. return nullptr; \
  277. } \
  278. \
  279. static void ___binding_free_callback(void *p_token, void *p_instance, void *p_binding) { \
  280. } \
  281. \
  282. static GDNativeBool ___binding_reference_callback(void *p_token, void *p_instance, GDNativeBool p_reference) { \
  283. return true; \
  284. } \
  285. \
  286. static constexpr GDNativeInstanceBindingCallbacks ___binding_callbacks = { \
  287. ___binding_create_callback, \
  288. ___binding_free_callback, \
  289. ___binding_reference_callback, \
  290. };
  291. // Don't use this for your classes, use GDCLASS() instead.
  292. #define GDNATIVE_CLASS(m_class, m_inherits) \
  293. private: \
  294. void operator=(const m_class &p_rval) {} \
  295. \
  296. protected: \
  297. virtual const GDNativeInstanceBindingCallbacks *_get_bindings_callbacks() const override { \
  298. return &___binding_callbacks; \
  299. } \
  300. \
  301. m_class(const char *p_godot_class) : m_inherits(p_godot_class) {} \
  302. m_class(GodotObject *p_godot_object) : m_inherits(p_godot_object) {} \
  303. \
  304. static void (*_get_bind_methods())() { \
  305. return nullptr; \
  306. } \
  307. \
  308. static void (Wrapped::*_get_notification())(int) { \
  309. return nullptr; \
  310. } \
  311. \
  312. static bool (Wrapped::*_get_set())(const StringName &p_name, const Variant &p_property) { \
  313. return nullptr; \
  314. } \
  315. \
  316. static bool (Wrapped::*_get_get())(const StringName &p_name, Variant &r_ret) { \
  317. return nullptr; \
  318. } \
  319. \
  320. static void (Wrapped::*_get_get_property_list())(List<PropertyInfo> * p_list) { \
  321. return nullptr; \
  322. } \
  323. \
  324. static bool (Wrapped::*_get_property_can_revert())(const StringName &p_name) { \
  325. return nullptr; \
  326. } \
  327. \
  328. static bool (Wrapped::*_get_property_get_revert())(const StringName &p_name, Variant &) { \
  329. return nullptr; \
  330. } \
  331. \
  332. static String (Wrapped::*_get_to_string())() { \
  333. return nullptr; \
  334. } \
  335. \
  336. public: \
  337. static void initialize_class() {} \
  338. \
  339. static const char *get_class_static() { \
  340. return #m_class; \
  341. } \
  342. \
  343. static const char *get_parent_class_static() { \
  344. return m_inherits::get_class_static(); \
  345. } \
  346. \
  347. static void *___binding_create_callback(void *p_token, void *p_instance) { \
  348. /* Do not call memnew here, we don't want the postinitializer to be called */ \
  349. return new ("") m_class((GodotObject *)p_instance); \
  350. } \
  351. static void ___binding_free_callback(void *p_token, void *p_instance, void *p_binding) { \
  352. /* Explicitly call the deconstructor to ensure proper lifecycle for non-trivial members */ \
  353. reinterpret_cast<m_class *>(p_binding)->~m_class(); \
  354. Memory::free_static(reinterpret_cast<m_class *>(p_binding)); \
  355. } \
  356. static GDNativeBool ___binding_reference_callback(void *p_token, void *p_instance, GDNativeBool p_reference) { \
  357. return true; \
  358. } \
  359. static constexpr GDNativeInstanceBindingCallbacks ___binding_callbacks = { \
  360. ___binding_create_callback, \
  361. ___binding_free_callback, \
  362. ___binding_reference_callback, \
  363. }; \
  364. m_class() : m_class(#m_class) {}
  365. #endif // ! GODOT_CPP_WRAPPED_HPP