/*************************************************************************/ /* object.h */ /*************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* http://www.godotengine.org */ /*************************************************************************/ /* 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. */ /*************************************************************************/ #ifndef OBJECT_H #define OBJECT_H #include "list.h" #include "variant.h" #include "set.h" #include "map.h" #include "vmap.h" #define VARIANT_ARG_LIST const Variant& p_arg1=Variant(),const Variant& p_arg2=Variant(),const Variant& p_arg3=Variant(),const Variant& p_arg4=Variant(),const Variant& p_arg5=Variant() #define VARIANT_ARG_PASS p_arg1,p_arg2,p_arg3,p_arg4,p_arg5 #define VARIANT_ARG_DECLARE const Variant& p_arg1,const Variant& p_arg2,const Variant& p_arg3,const Variant& p_arg4,const Variant& p_arg5 #define VARIANT_ARG_MAX 5 #define VARIANT_ARGPTRS const Variant *argptr[5]={&p_arg1,&p_arg2,&p_arg3,&p_arg4,&p_arg5}; #define VARIANT_ARGPTRS_PASS *argptr[0],*argptr[1],*argptr[2],*argptr[3],*argptr[4] #define VARIANT_ARGS_FROM_ARRAY(m_arr) m_arr[0],m_arr[1],m_arr[2],m_arr[3],m_arr[4] /** @author Juan Linietsky */ enum PropertyHint { PROPERTY_HINT_NONE, ///< no hint provided. PROPERTY_HINT_RANGE, ///< hint_text = "min,max,step" PROPERTY_HINT_EXP_RANGE, ///< hint_text = "min,max,step", exponential edit PROPERTY_HINT_ENUM, ///< hint_text= "val1,val2,val3,etc" PROPERTY_HINT_EXP_EASING, /// exponential easing funciton (Math::ease) PROPERTY_HINT_LENGTH, ///< hint_text= "length" (as integer) PROPERTY_HINT_KEY_ACCEL, ///< hint_text= "length" (as integer) PROPERTY_HINT_FLAGS, ///< hint_text= "flag1,flag2,etc" (as bit flags) PROPERTY_HINT_ALL_FLAGS, PROPERTY_HINT_FILE, ///< a file path must be passed, hint_text (optionally) is a filter "*.png,*.wav,*.doc," PROPERTY_HINT_DIR, ///< a directort path must be passed PROPERTY_HINT_GLOBAL_FILE, ///< a file path must be passed, hint_text (optionally) is a filter "*.png,*.wav,*.doc," PROPERTY_HINT_GLOBAL_DIR, ///< a directort path must be passed PROPERTY_HINT_RESOURCE_TYPE, ///< a resource object type PROPERTY_HINT_MULTILINE_TEXT, ///< used for string properties that can contain multiple lines PROPERTY_HINT_COLOR_NO_ALPHA, ///< used for ignoring alpha component when editing a color PROPERTY_HINT_IMAGE_COMPRESS_LOSSY, PROPERTY_HINT_IMAGE_COMPRESS_LOSSLESS, PROPERTY_HINT_MAX, }; enum PropertyUsageFlags { PROPERTY_USAGE_STORAGE=1, PROPERTY_USAGE_EDITOR=2, PROPERTY_USAGE_NETWORK=4, PROPERTY_USAGE_EDITOR_HELPER=8, PROPERTY_USAGE_CHECKABLE=16, //used for editing global variables PROPERTY_USAGE_CHECKED=32, //used for editing global variables PROPERTY_USAGE_INTERNATIONALIZED=64, //hint for internationalized strings PROPERTY_USAGE_BUNDLE=128, //used for optimized bundles PROPERTY_USAGE_CATEGORY=256, PROPERTY_USAGE_STORE_IF_NONZERO=512, //only store if nonzero PROPERTY_USAGE_DEFAULT=PROPERTY_USAGE_STORAGE|PROPERTY_USAGE_EDITOR|PROPERTY_USAGE_NETWORK, PROPERTY_USAGE_DEFAULT_INTL=PROPERTY_USAGE_STORAGE|PROPERTY_USAGE_EDITOR|PROPERTY_USAGE_NETWORK|PROPERTY_USAGE_INTERNATIONALIZED, PROPERTY_USAGE_NOEDITOR=PROPERTY_USAGE_STORAGE|PROPERTY_USAGE_NETWORK, }; #define ADD_SIGNAL( m_signal ) ObjectTypeDB::add_signal( get_type_static(), m_signal ) #define ADD_PROPERTY( m_property, m_setter, m_getter ) ObjectTypeDB::add_property( get_type_static(), m_property, m_setter, m_getter ) #define ADD_PROPERTYI( m_property, m_setter, m_getter, m_index ) ObjectTypeDB::add_property( get_type_static(), m_property, m_setter, m_getter, m_index ) #define ADD_PROPERTYNZ( m_property, m_setter, m_getter ) ObjectTypeDB::add_property( get_type_static(), (m_property).added_usage(PROPERTY_USAGE_STORE_IF_NONZERO), m_setter, m_getter ) #define ADD_PROPERTYINZ( m_property, m_setter, m_getter, m_index ) ObjectTypeDB::add_property( get_type_static(), (m_property).added_usage(PROPERTY_USAGE_STORE_IF_NONZERO), m_setter, m_getter, m_index ) struct PropertyInfo { Variant::Type type; String name; PropertyHint hint; String hint_string; uint32_t usage; _FORCE_INLINE_ PropertyInfo added_usage(int p_fl) const { PropertyInfo pi=*this; pi.usage|=p_fl; return pi; } PropertyInfo() { type=Variant::NIL; hint=PROPERTY_HINT_NONE; usage = PROPERTY_USAGE_DEFAULT; } PropertyInfo( Variant::Type p_type, const String p_name, PropertyHint p_hint=PROPERTY_HINT_NONE, const String& p_hint_string="",uint32_t p_usage=PROPERTY_USAGE_DEFAULT) { type=p_type; name=p_name; hint=p_hint; hint_string=p_hint_string; usage=p_usage; } }; Array convert_property_list(const List * p_list); struct MethodInfo { String name; List arguments; Vector default_arguments; PropertyInfo return_val; uint32_t flags; int id; inline bool operator<(const MethodInfo& p_method) const { return id==p_method.id?(name < p_method.name):(id(this); ////else //return NULL; /* the following is an uncomprehensible blob of hacks and workarounds to compensate for many of the fallencies in C++. As a plus, this macro pretty much alone defines the object model. */ #define REVERSE_GET_PROPERTY_LIST \ public:\ _FORCE_INLINE_ bool _is_gpl_reversed() const { return true; };\ private: #define UNREVERSE_GET_PROPERTY_LIST \ public:\ _FORCE_INLINE_ bool _is_gpl_reversed() const { return false; };\ private: #define OBJ_TYPE( m_type, m_inherits )\ private:\ void operator=(const m_type& p_rval) {}\ mutable StringName _type_name;\ friend class ObjectTypeDB;\ public:\ virtual String get_type() const { \ return String(#m_type);\ }\ virtual StringName get_type_name() const { \ if (!_type_name)\ _type_name=get_type_static();\ return _type_name;\ }\ static _FORCE_INLINE_ void* get_type_ptr_static() { \ static int ptr;\ return &ptr;\ }\ static _FORCE_INLINE_ String get_type_static() { \ return String(#m_type);\ }\ static _FORCE_INLINE_ String get_parent_type_static() { \ return m_inherits::get_type_static();\ }\ static void get_inheritance_list_static(List* p_inheritance_list) { \ m_inherits::get_inheritance_list_static(p_inheritance_list);\ p_inheritance_list->push_back(String(#m_type));\ }\ static String get_category_static() { \ String category = m_inherits::get_category_static();\ if (_get_category!=m_inherits::_get_category) {\ if (category!="")\ category+="/";\ category+=_get_category();\ }\ return category;\ }\ static String inherits_static() {\ return String(#m_inherits);\ }\ virtual bool is_type(const String& p_type) const { return (p_type==(#m_type))?true:m_inherits::is_type(p_type); }\ virtual bool is_type_ptr(void *p_ptr) const { return (p_ptr==get_type_ptr_static())?true:m_inherits::is_type_ptr(p_ptr); }\ \ \ static void get_valid_parents_static(List *p_parents) {\ \ if (m_type::_get_valid_parents_static!=m_inherits::_get_valid_parents_static) { \ m_type::_get_valid_parents_static(p_parents);\ }\ \ m_inherits::get_valid_parents_static(p_parents);\ }\ protected:\ _FORCE_INLINE_ static void (*_get_bind_methods())() {\ return &m_type::_bind_methods;\ }\ public:\ static void initialize_type() {\ static bool initialized=false;\ if (initialized)\ return;\ m_inherits::initialize_type();\ ObjectTypeDB::_add_type();\ if (m_type::_get_bind_methods() != m_inherits::_get_bind_methods())\ _bind_methods();\ initialized=true;\ }\ protected:\ virtual void _initialize_typev() {\ initialize_type();\ }\ _FORCE_INLINE_ bool (Object::* (_get_get() const))(const StringName& p_name,Variant&) const {\ return (bool (Object::*)(const StringName&,Variant&)const) &m_type::_get;\ }\ virtual bool _getv(const StringName& p_name, Variant& r_ret) const { \ if (m_type::_get_get() != m_inherits::_get_get()) {\ if (_get(p_name,r_ret))\ return true;\ }\ return m_inherits::_getv(p_name,r_ret);\ }\ _FORCE_INLINE_ bool (Object::* (_get_set() const))(const StringName& p_name,const Variant &p_property) {\ return (bool (Object::*)(const StringName&, const Variant&))&m_type::_set;\ }\ virtual bool _setv(const StringName& p_name,const Variant &p_property) { \ if (m_inherits::_setv(p_name,p_property)) return true;\ if (m_type::_get_set() != m_inherits::_get_set()) {\ return _set(p_name,p_property);\ \ }\ return false;\ }\ _FORCE_INLINE_ void (Object::* (_get_get_property_list() const))(List *p_list) const{\ return (void (Object::*)(List*)const)&m_type::_get_property_list;\ }\ virtual void _get_property_listv(List *p_list,bool p_reversed) const { \ if (!p_reversed) {\ m_inherits::_get_property_listv(p_list,p_reversed);\ }\ p_list->push_back( PropertyInfo(Variant::NIL,get_type_static(),PROPERTY_HINT_NONE,String(),PROPERTY_USAGE_CATEGORY));\ if (!_is_gpl_reversed())\ ObjectTypeDB::get_property_list(#m_type,p_list,true);\ if (m_type::_get_get_property_list() != m_inherits::_get_get_property_list()) {\ _get_property_list(p_list);\ }\ if (_is_gpl_reversed())\ ObjectTypeDB::get_property_list(#m_type,p_list,true);\ if (p_reversed) {\ m_inherits::_get_property_listv(p_list,p_reversed);\ }\ \ }\ _FORCE_INLINE_ void (Object::* (_get_notification() const))(int){\ return (void (Object::*)(int)) &m_type::_notification;\ }\ virtual void _notificationv(int p_notification,bool p_reversed) { \ if (!p_reversed) \ m_inherits::_notificationv(p_notification,p_reversed);\ if (m_type::_get_notification() != m_inherits::_get_notification()) {\ _notification(p_notification);\ }\ if (p_reversed)\ m_inherits::_notificationv(p_notification,p_reversed);\ }\ \ private: #define OBJ_CATEGORY(m_category)\ protected:\ _FORCE_INLINE_ static String _get_category() { return m_category; }\ private: #define OBJ_SAVE_TYPE(m_type) \ public: \ virtual String get_save_type() const { return #m_type; }\ private: class ScriptInstance; typedef uint32_t ObjectID; class Object { public: enum ConnectFlags { CONNECT_DEFERRED=1, CONNECT_PERSIST=2, // hint for scene to save this connection CONNECT_ONESHOT=4 }; struct Connection { Object *source; StringName signal; Object *target; StringName method; uint32_t flags; Vector binds; bool operator<(const Connection& p_conn) const; operator Variant() const; Connection() { source=NULL; target=NULL; flags=0; } Connection(const Variant& p_variant); }; private: #ifdef DEBUG_ENABLED friend class _ObjectDebugLock; #endif friend bool predelete_handler(Object*); friend void postinitialize_handler(Object*); struct Signal { struct Target { ObjectID _id; StringName method; _FORCE_INLINE_ bool operator<(const Target& p_target) const { return (_id==p_target._id)?(method::Element *cE; }; MethodInfo user; VMap slot_map; int lock; Signal() { lock=0; } }; HashMap< StringName, Signal, StringNameHasher> signal_map; List connections; #ifdef DEBUG_ENABLED SafeRefCount _lock_index; #endif bool _block_signals; int _predelete_ok; Set change_receptors; uint32_t _instance_ID; bool _predelete(); void _postinitialize(); bool _can_translate; #ifdef TOOLS_ENABLED bool _edited; #endif ScriptInstance *script_instance; RefPtr script; Dictionary metadata; void _add_user_signal(const String& p_name, const Array& p_pargs=Array()); Variant _emit_signal(const Variant** p_args, int p_argcount, Variant::CallError& r_error); Array _get_signal_list() const; Array _get_signal_connection_list(const String& p_signal) const; void _set_bind(const String& p_set,const Variant& p_value); Variant _get_bind(const String& p_name) const; void property_list_changed_notify(); protected: virtual bool _use_builtin_script() const { return false; } virtual void _initialize_typev() { initialize_type(); } virtual bool _setv(const StringName& p_name,const Variant &p_property) { return false; }; virtual bool _getv(const StringName& p_name,Variant &r_property) const { return false; }; virtual void _get_property_listv(List *p_list,bool p_reversed) const {}; virtual void _notificationv(int p_notification,bool p_reversed) {}; static String _get_category() { return ""; } static void _bind_methods(); 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 *p_list) const {}; void _notification(int p_notification) {}; _FORCE_INLINE_ static void (*_get_bind_methods())() { return &Object::_bind_methods; } _FORCE_INLINE_ bool (Object::* (_get_get() const))(const StringName& p_name,Variant &r_ret) const { return &Object::_get; } _FORCE_INLINE_ bool (Object::* (_get_set() const))(const StringName& p_name,const Variant &p_property) { return &Object::_set; } _FORCE_INLINE_ void (Object::* (_get_get_property_list() const))(List *p_list) const{ return &Object::_get_property_list; } _FORCE_INLINE_ void (Object::* (_get_notification() const))(int){ return &Object::_notification; } static void get_valid_parents_static(List *p_parents); static void _get_valid_parents_static(List *p_parents); void cancel_delete(); virtual void _changed_callback(Object *p_changed,const char *p_prop); //Variant _call_bind(const StringName& p_name, const Variant& p_arg1 = Variant(), const Variant& p_arg2 = Variant(), const Variant& p_arg3 = Variant(), const Variant& p_arg4 = Variant()); //void _call_deferred_bind(const StringName& p_name, const Variant& p_arg1 = Variant(), const Variant& p_arg2 = Variant(), const Variant& p_arg3 = Variant(), const Variant& p_arg4 = Variant()); Variant _call_bind(const Variant** p_args, int p_argcount, Variant::CallError& r_error); Variant _call_deferred_bind(const Variant** p_args, int p_argcount, Variant::CallError& r_error); DVector _get_meta_list_bind() const; Array _get_property_list_bind() const; public: //should be protected, but bug in clang++ static void initialize_type(); _FORCE_INLINE_ static void register_custom_data_to_otdb() {}; public: #ifdef TOOLS_ENABLED _FORCE_INLINE_ void _change_notify(const char *p_property="") { _edited=true; for(Set::Element *E=change_receptors.front();E;E=E->next()) ((Object*)(E->get()))->_changed_callback(this,p_property); } #else _FORCE_INLINE_ void _change_notify(const char *p_what="") { } #endif static void* get_type_ptr_static() { static int ptr; return &ptr; } bool _is_gpl_reversed() const { return false; } _FORCE_INLINE_ ObjectID get_instance_ID() const { return _instance_ID; } // this is used for editors void add_change_receptor( Object *p_receptor ); void remove_change_receptor( Object *p_receptor ); template T *cast_to() { #ifndef NO_SAFE_CAST return SAFE_CAST(this); #else if (!this) return NULL; if (is_type_ptr(T::get_type_ptr_static())) return static_cast(this); else return NULL; #endif } template const T *cast_to() const { #ifndef NO_SAFE_CAST return SAFE_CAST(this); #else if (!this) return NULL; if (is_type_ptr(T::get_type_ptr_static())) return static_cast(this); else return NULL; #endif } enum { NOTIFICATION_POSTINITIALIZE=0, NOTIFICATION_PREDELETE=1 }; /* TYPE API */ static void get_inheritance_list_static(List* p_inheritance_list) { p_inheritance_list->push_back("Object"); } static String get_type_static() { return "Object"; } static String get_parent_type_static() { return String(); } static String get_category_static() { return String(); } virtual String get_type() const { return "Object"; } virtual String get_save_type() const { return get_type(); } //type stored when saving virtual StringName get_type_name() const { return StringName("Object"); } virtual bool is_type(const String& p_type) const { return (p_type=="Object"); } virtual bool is_type_ptr(void *p_ptr) const { return get_type_ptr_static()==p_ptr; } /* IAPI */ // void set(const String& p_name, const Variant& p_value); // Variant get(const String& p_name) const; void set(const StringName& p_name, const Variant& p_value, bool *r_valid=NULL); Variant get(const StringName& p_name, bool *r_valid=NULL) const; void get_property_list(List *p_list,bool p_reversed=false) const; bool has_method(const StringName& p_method) const; void get_method_list(List *p_list) const; Variant callv(const StringName& p_method,const Array& p_args); virtual Variant call(const StringName& p_method,const Variant** p_args,int p_argcount,Variant::CallError &r_error); virtual void call_multilevel(const StringName& p_method,const Variant** p_args,int p_argcount); virtual void call_multilevel_reversed(const StringName& p_method,const Variant** p_args,int p_argcount); Variant call(const StringName& p_name, VARIANT_ARG_LIST); // C++ helper void call_multilevel(const StringName& p_name, VARIANT_ARG_LIST); // C++ helper void notification(int p_notification,bool p_reversed=false); //used mainly by script, get and set all INCLUDING string virtual Variant getvar(const Variant& p_key, bool *r_valid=NULL) const; virtual void setvar(const Variant& p_key, const Variant& p_value,bool *r_valid=NULL); /* SCRIPT */ void set_script(const RefPtr& p_script); RefPtr get_script() const; /* SCRIPT */ bool has_meta(const String& p_name) const; void set_meta(const String& p_name, const Variant& p_value ); Variant get_meta(const String& p_name) const; void get_meta_list(List *p_list) const; #ifdef TOOLS_ENABLED void set_edited(bool p_edited); bool is_edited() const; #endif void set_script_instance(ScriptInstance *p_instance); _FORCE_INLINE_ ScriptInstance* get_script_instance() const { return script_instance; } void add_user_signal(const MethodInfo& p_signal); void emit_signal(const StringName& p_name,VARIANT_ARG_LIST); void get_signal_list(List *p_signals ) const; void get_signal_connection_list(const StringName& p_signal,List *p_connections) const; void connect(const StringName& p_signal, Object *p_to_object, const StringName& p_to_method,const Vector& p_binds=Vector(),uint32_t p_flags=0); void disconnect(const StringName& p_signal, Object *p_to_object, const StringName& p_to_method); bool is_connected(const StringName& p_signal, Object *p_to_object, const StringName& p_to_method) const; void call_deferred(const StringName& p_method,VARIANT_ARG_LIST); void set_block_signals(bool p_block); bool is_blocking_signals() const; virtual void get_translatable_strings(List *p_strings) const; StringName XL_MESSAGE(const StringName& p_message) const; //translate message (internationalization) StringName tr(const StringName& p_message) const; //translate message (alternative) _FORCE_INLINE_ void set_message_translation(bool p_enable) { _can_translate=p_enable; } _FORCE_INLINE_ bool can_translate_messages() const { return _can_translate; } Object(); virtual ~Object(); }; bool predelete_handler(Object *p_object); void postinitialize_handler(Object *p_object); class ObjectDB { struct ObjectPtrHash { static _FORCE_INLINE_ uint32_t hash(const Object *p_obj) { union { const Object*p; unsigned long i; } u; u.p=p_obj; return HashMapHahserDefault::hash((uint64_t)u.i); } }; static HashMap instances; static HashMap instance_checks; static uint32_t instance_counter; friend class Object; friend void unregister_core_types(); static void cleanup(); static uint32_t add_instance(Object *p_object); static void remove_instance(Object *p_object); public: typedef void (*DebugFunc)(Object *p_obj); static Object *get_instance(uint32_t p_instance_ID); static void debug_objects(DebugFunc p_func); static int get_object_count(); #ifdef DEBUG_ENABLED _FORCE_INLINE_ static bool instance_validate(Object* p_ptr) { return instance_checks.has(p_ptr); } #else _FORCE_INLINE_ static bool instance_validate(Object* p_ptr) { return true; } #endif }; //needed by macros #include "object_type_db.h" #endif