2022-03-17 21:58:11 +01:00
# ifndef OBJECT_H
# define OBJECT_H
2022-03-15 13:29:32 +01:00
/*************************************************************************/
/* object.h */
/*************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/*************************************************************************/
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
/* */
/* 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. */
/*************************************************************************/
2022-08-17 12:53:49 +02:00
# include "core/containers/hash_map.h"
# include "core/containers/list.h"
2023-01-15 19:12:50 +01:00
# include "core/containers/rb_map.h"
2023-06-12 21:13:26 +02:00
# include "core/containers/rb_set.h"
# include "core/containers/vmap.h"
2022-08-17 16:01:01 +02:00
# include "core/object/object_id.h"
2022-03-15 13:29:32 +01:00
# include "core/os/rw_lock.h"
2022-08-17 17:43:49 +02:00
# include "core/os/safe_refcount.h"
2022-08-17 13:17:12 +02:00
# include "core/variant/variant.h"
2022-03-15 13:29:32 +01:00
# include <atomic>
# 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(), const Variant &p_arg6 = Variant(), const Variant &p_arg7 = Variant(), const Variant &p_arg8 = Variant()
# define VARIANT_ARG_PASS p_arg1, p_arg2, p_arg3, p_arg4, p_arg5, p_arg6, p_arg7, p_arg8
# define VARIANT_ARG_DECLARE const Variant &p_arg1, const Variant &p_arg2, const Variant &p_arg3, const Variant &p_arg4, const Variant &p_arg5, const Variant &p_arg6, const Variant &p_arg7, const Variant &p_arg8
# define VARIANT_ARG_MAX 8
# define VARIANT_ARGPTRS const Variant *argptr[8] = { &p_arg1, &p_arg2, &p_arg3, &p_arg4, &p_arg5, &p_arg6, &p_arg7, &p_arg8 };
# define VARIANT_ARGPTRS_PASS *argptr[0], *argptr[1], *argptr[2], *argptr[3], *argptr[4], *argptr[5], *argptr[6], *argptr[7]
# define VARIANT_ARGS_FROM_ARRAY(m_arr) m_arr[0], m_arr[1], m_arr[2], m_arr[3], m_arr[4], m_arr[5], m_arr[6], m_arr[7]
/**
@ author Juan Linietsky < reduzio @ gmail . com >
*/
enum PropertyHint {
PROPERTY_HINT_NONE , ///< no hint provided.
PROPERTY_HINT_RANGE , ///< hint_text = "min,max,step,slider; //slider is optional"
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 function (Math::ease) use "attenuation" hint string to revert (flip h), "full" to also include in/out. (ie: "attenuation,inout")
PROPERTY_HINT_LENGTH , ///< hint_text= "length" (as integer)
2022-08-17 20:57:16 +02:00
PROPERTY_HINT_BUTTON , // Use a button in the inspector for this property. The property's type has to be Variant::NIL. hint_text="call_func:name/theme_type" -> calls call_func on press, optional: ":name/theme_type" -> get_theme_icon("name", "theme_type")
2022-03-15 13:29:32 +01:00
PROPERTY_HINT_KEY_ACCEL , ///< hint_text= "length" (as integer)
PROPERTY_HINT_FLAGS , ///< hint_text= "flag1,flag2,etc" (as bit flags)
PROPERTY_HINT_LAYERS_2D_RENDER ,
PROPERTY_HINT_LAYERS_2D_PHYSICS ,
2022-07-28 22:34:28 +02:00
PROPERTY_HINT_LAYERS_2D_NAVIGATION ,
2022-03-15 13:29:32 +01:00
PROPERTY_HINT_LAYERS_3D_RENDER ,
PROPERTY_HINT_LAYERS_3D_PHYSICS ,
2022-07-28 22:34:28 +02:00
PROPERTY_HINT_LAYERS_3D_NAVIGATION ,
2023-06-10 20:58:49 +02:00
PROPERTY_HINT_LAYERS_AVOIDANCE ,
2022-03-15 13:29:32 +01:00
PROPERTY_HINT_FILE , ///< a file path must be passed, hint_text (optionally) is a filter "*.png,*.wav,*.doc,"
PROPERTY_HINT_DIR , ///< a directory 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 directory 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_PLACEHOLDER_TEXT , ///< used to set a placeholder text for string properties
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_OBJECT_ID ,
PROPERTY_HINT_TYPE_STRING , ///< a type string, the hint is the base type to choose
PROPERTY_HINT_NODE_PATH_TO_EDITED_NODE , ///< so something else can provide this (used in scripts)
PROPERTY_HINT_METHOD_OF_VARIANT_TYPE , ///< a method of a type
PROPERTY_HINT_METHOD_OF_BASE_TYPE , ///< a method of a base type
PROPERTY_HINT_METHOD_OF_INSTANCE , ///< a method of an instance
PROPERTY_HINT_METHOD_OF_SCRIPT , ///< a method of a script & base
PROPERTY_HINT_PROPERTY_OF_VARIANT_TYPE , ///< a property of a type
PROPERTY_HINT_PROPERTY_OF_BASE_TYPE , ///< a property of a base type
PROPERTY_HINT_PROPERTY_OF_INSTANCE , ///< a property of an instance
PROPERTY_HINT_PROPERTY_OF_SCRIPT , ///< a property of a script & base
PROPERTY_HINT_OBJECT_TOO_BIG , ///< object is too big to send
PROPERTY_HINT_NODE_PATH_VALID_TYPES ,
PROPERTY_HINT_SAVE_FILE , ///< a file path must be passed, hint_text (optionally) is a filter "*.png,*.wav,*.doc,". This opens a save dialog
PROPERTY_HINT_ENUM_SUGGESTION , ///< hint_text= "val1,val2,val3,etc"
2022-12-22 18:50:17 +01:00
PROPERTY_HINT_LINK ,
2022-03-15 13:29:32 +01:00
PROPERTY_HINT_MAX ,
// When updating PropertyHint, also sync the hardcoded list in VisualScriptEditorVariableEdit
} ;
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_GROUP = 128 , //used for grouping props in the editor
PROPERTY_USAGE_CATEGORY = 256 ,
// FIXME: Drop in 4.0, possibly reorder other flags?
// Those below are deprecated thanks to ClassDB's now class value cache
//PROPERTY_USAGE_STORE_IF_NONZERO = 512, //only store if nonzero
//PROPERTY_USAGE_STORE_IF_NONONE = 1024, //only store if false
PROPERTY_USAGE_NO_INSTANCE_STATE = 2048 ,
PROPERTY_USAGE_RESTART_IF_CHANGED = 4096 ,
PROPERTY_USAGE_SCRIPT_VARIABLE = 8192 ,
PROPERTY_USAGE_STORE_IF_NULL = 16384 ,
PROPERTY_USAGE_ANIMATE_AS_TRIGGER = 32768 ,
PROPERTY_USAGE_UPDATE_ALL_IF_MODIFIED = 65536 ,
PROPERTY_USAGE_SCRIPT_DEFAULT_VALUE = 1 < < 17 ,
PROPERTY_USAGE_CLASS_IS_ENUM = 1 < < 18 ,
PROPERTY_USAGE_NIL_IS_VARIANT = 1 < < 19 ,
PROPERTY_USAGE_INTERNAL = 1 < < 20 ,
PROPERTY_USAGE_DO_NOT_SHARE_ON_DUPLICATE = 1 < < 21 , // If the object is duplicated also this property will be duplicated
PROPERTY_USAGE_HIGH_END_GFX = 1 < < 22 ,
PROPERTY_USAGE_NODE_PATH_FROM_SCENE_ROOT = 1 < < 23 ,
PROPERTY_USAGE_RESOURCE_NOT_PERSISTENT = 1 < < 24 ,
PROPERTY_USAGE_KEYING_INCREMENTS = 1 < < 25 , // Used in inspector to increment property when keyed in animation player
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) ClassDB::add_signal(get_class_static(), m_signal)
# define ADD_PROPERTY(m_property, m_setter, m_getter) ClassDB::add_property(get_class_static(), m_property, _scs_create(m_setter), _scs_create(m_getter))
# define ADD_PROPERTYI(m_property, m_setter, m_getter, m_index) ClassDB::add_property(get_class_static(), m_property, _scs_create(m_setter), _scs_create(m_getter), m_index)
# define ADD_PROPERTY_DEFAULT(m_property, m_default) ClassDB::set_property_default_value(get_class_static(), m_property, m_default)
# define ADD_GROUP(m_name, m_prefix) ClassDB::add_property_group(get_class_static(), m_name, m_prefix)
struct PropertyInfo {
Variant : : Type type ;
String name ;
StringName class_name ; //for classes
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 ;
}
operator Dictionary ( ) const ;
static PropertyInfo from_dict ( const Dictionary & p_dict ) ;
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 , const StringName & p_class_name = StringName ( ) ) :
type ( p_type ) ,
name ( p_name ) ,
hint ( p_hint ) ,
hint_string ( p_hint_string ) ,
usage ( p_usage ) {
if ( hint = = PROPERTY_HINT_RESOURCE_TYPE ) {
class_name = hint_string ;
} else {
class_name = p_class_name ;
}
}
PropertyInfo ( const StringName & p_class_name ) :
type ( Variant : : OBJECT ) ,
class_name ( p_class_name ) ,
hint ( PROPERTY_HINT_NONE ) ,
usage ( PROPERTY_USAGE_DEFAULT ) {
}
bool operator = = ( const PropertyInfo & p_info ) const {
return ( ( type = = p_info . type ) & &
( name = = p_info . name ) & &
( class_name = = p_info . class_name ) & &
( hint = = p_info . hint ) & &
( hint_string = = p_info . hint_string ) & &
( usage = = p_info . usage ) ) ;
}
bool operator < ( const PropertyInfo & p_info ) const {
return name < p_info . name ;
}
} ;
Array convert_property_list ( const List < PropertyInfo > * p_list ) ;
struct MethodInfo {
String name ;
PropertyInfo return_val ;
uint32_t flags ;
int id ;
List < PropertyInfo > arguments ;
Vector < Variant > default_arguments ;
inline bool operator = = ( const MethodInfo & p_method ) const { return id = = p_method . id ; }
inline bool operator < ( const MethodInfo & p_method ) const { return id = = p_method . id ? ( name < p_method . name ) : ( id < p_method . id ) ; }
operator Dictionary ( ) const ;
static MethodInfo from_dict ( const Dictionary & p_dict ) ;
MethodInfo ( ) ;
MethodInfo ( const String & p_name ) ;
MethodInfo ( const String & p_name , const PropertyInfo & p_param1 ) ;
MethodInfo ( const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 ) ;
MethodInfo ( const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 ) ;
MethodInfo ( const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 , const PropertyInfo & p_param4 ) ;
MethodInfo ( const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 , const PropertyInfo & p_param4 , const PropertyInfo & p_param5 ) ;
MethodInfo ( Variant : : Type ret ) ;
MethodInfo ( Variant : : Type ret , const String & p_name ) ;
MethodInfo ( Variant : : Type ret , const String & p_name , const PropertyInfo & p_param1 ) ;
MethodInfo ( Variant : : Type ret , const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 ) ;
MethodInfo ( Variant : : Type ret , const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 ) ;
MethodInfo ( Variant : : Type ret , const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 , const PropertyInfo & p_param4 ) ;
MethodInfo ( Variant : : Type ret , const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 , const PropertyInfo & p_param4 , const PropertyInfo & p_param5 ) ;
MethodInfo ( const PropertyInfo & p_ret , const String & p_name ) ;
MethodInfo ( const PropertyInfo & p_ret , const String & p_name , const PropertyInfo & p_param1 ) ;
MethodInfo ( const PropertyInfo & p_ret , const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 ) ;
MethodInfo ( const PropertyInfo & p_ret , const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 ) ;
MethodInfo ( const PropertyInfo & p_ret , const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 , const PropertyInfo & p_param4 ) ;
MethodInfo ( const PropertyInfo & p_ret , const String & p_name , const PropertyInfo & p_param1 , const PropertyInfo & p_param2 , const PropertyInfo & p_param3 , const PropertyInfo & p_param4 , const PropertyInfo & p_param5 ) ;
} ;
// old cast_to
//if ( is_type(T::get_class_static()) )
//return static_cast<T*>(this);
////else
//return NULL;
/*
the following is an incomprehensible 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 .
*/
2022-07-28 22:34:28 +02:00
# define REVERSE_GET_PROPERTY_LIST \
public : \
_FORCE_INLINE_ bool _is_gpl_reversed ( ) const { \
return true ; \
} ; \
\
2022-03-15 13:29:32 +01:00
private :
2022-07-28 22:34:28 +02:00
# define UNREVERSE_GET_PROPERTY_LIST \
public : \
_FORCE_INLINE_ bool _is_gpl_reversed ( ) const { \
return false ; \
} ; \
\
2022-03-15 13:29:32 +01:00
private :
2022-07-28 22:34:28 +02:00
# define GDCLASS(m_class, m_inherits) \
private : \
void operator = ( const m_class & p_rval ) { } \
mutable StringName _class_name ; \
friend class ClassDB ; \
\
public : \
virtual String get_class ( ) const { \
return String ( # m_class ) ; \
} \
virtual const StringName * _get_class_namev ( ) const { \
if ( ! _class_name ) \
_class_name = get_class_static ( ) ; \
return & _class_name ; \
} \
static _FORCE_INLINE_ void * get_class_ptr_static ( ) { \
static int ptr ; \
return & ptr ; \
} \
static _FORCE_INLINE_ String get_class_static ( ) { \
return String ( # m_class ) ; \
} \
static _FORCE_INLINE_ String get_parent_class_static ( ) { \
return m_inherits : : get_class_static ( ) ; \
} \
static void get_inheritance_list_static ( List < String > * p_inheritance_list ) { \
m_inherits : : get_inheritance_list_static ( p_inheritance_list ) ; \
p_inheritance_list - > push_back ( String ( # m_class ) ) ; \
} \
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_class ( const String & p_class ) const { \
return ( p_class = = ( # m_class ) ) ? true : m_inherits : : is_class ( p_class ) ; \
} \
virtual bool is_class_ptr ( void * p_ptr ) const { \
return ( p_ptr = = get_class_ptr_static ( ) ) ? true : m_inherits : : is_class_ptr ( p_ptr ) ; \
} \
\
static void get_valid_parents_static ( List < String > * p_parents ) { \
if ( m_class : : _get_valid_parents_static ! = m_inherits : : _get_valid_parents_static ) { \
m_class : : _get_valid_parents_static ( p_parents ) ; \
} \
\
m_inherits : : get_valid_parents_static ( p_parents ) ; \
} \
\
protected : \
_FORCE_INLINE_ static void ( * _get_bind_methods ( ) ) ( ) { \
return & m_class : : _bind_methods ; \
} \
\
public : \
static void initialize_class ( ) { \
static bool initialized = false ; \
if ( initialized ) \
return ; \
m_inherits : : initialize_class ( ) ; \
ClassDB : : _add_class < m_class > ( ) ; \
if ( m_class : : _get_bind_methods ( ) ! = m_inherits : : _get_bind_methods ( ) ) \
_bind_methods ( ) ; \
initialized = true ; \
} \
\
protected : \
virtual void _initialize_classv ( ) { \
initialize_class ( ) ; \
} \
_FORCE_INLINE_ bool ( Object : : * _get_get ( ) const ) ( const StringName & p_name , Variant & ) const { \
return ( bool ( Object : : * ) ( const StringName & , Variant & ) const ) & m_class : : _get ; \
} \
virtual bool _getv ( const StringName & p_name , Variant & r_ret ) const { \
if ( m_class : : _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_class : : _set ; \
} \
virtual bool _setv ( const StringName & p_name , const Variant & p_property ) { \
if ( m_inherits : : _setv ( p_name , p_property ) ) \
return true ; \
if ( m_class : : _get_set ( ) ! = m_inherits : : _get_set ( ) ) { \
return _set ( p_name , p_property ) ; \
} \
return false ; \
} \
_FORCE_INLINE_ void ( Object : : * _get_get_property_list ( ) const ) ( List < PropertyInfo > * p_list ) const { \
return ( void ( Object : : * ) ( List < PropertyInfo > * ) const ) & m_class : : _get_property_list ; \
} \
virtual void _get_property_listv ( List < PropertyInfo > * 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_class_static ( ) , PROPERTY_HINT_NONE , String ( ) , PROPERTY_USAGE_CATEGORY ) ) ; \
if ( ! _is_gpl_reversed ( ) ) \
ClassDB : : get_property_list ( # m_class , p_list , true , this ) ; \
if ( m_class : : _get_get_property_list ( ) ! = m_inherits : : _get_get_property_list ( ) ) { \
_get_property_list ( p_list ) ; \
} \
if ( _is_gpl_reversed ( ) ) \
ClassDB : : get_property_list ( # m_class , p_list , true , this ) ; \
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_class : : _notification ; \
} \
virtual void _notificationv ( int p_notification , bool p_reversed ) { \
if ( ! p_reversed ) \
m_inherits : : _notificationv ( p_notification , p_reversed ) ; \
if ( m_class : : _get_notification ( ) ! = m_inherits : : _get_notification ( ) ) { \
_notification ( p_notification ) ; \
} \
if ( p_reversed ) \
m_inherits : : _notificationv ( p_notification , p_reversed ) ; \
} \
\
2022-03-15 13:29:32 +01:00
private :
2022-07-28 22:34:28 +02:00
# define OBJ_CATEGORY(m_category) \
protected : \
_FORCE_INLINE_ static String _get_category ( ) { \
return m_category ; \
} \
\
2022-03-15 13:29:32 +01:00
private :
2022-07-28 22:34:28 +02:00
# define OBJ_SAVE_TYPE(m_class) \
public : \
virtual String get_save_class ( ) const { \
return # m_class ; \
} \
\
2022-03-15 13:29:32 +01:00
private :
class ScriptInstance ;
class ObjectRC ;
class Object {
public :
enum ConnectFlags {
CONNECT_DEFERRED = 1 ,
CONNECT_PERSIST = 2 , // hint for scene to save this connection
CONNECT_ONESHOT = 4 ,
CONNECT_REFERENCE_COUNTED = 8 ,
} ;
struct Connection {
Object * source ;
StringName signal ;
Object * target ;
StringName method ;
uint32_t flags ;
Vector < Variant > binds ;
bool operator < ( const Connection & p_conn ) const ;
operator Variant ( ) const ;
Connection ( ) {
source = nullptr ;
target = nullptr ;
flags = 0 ;
}
Connection ( const Variant & p_variant ) ;
} ;
private :
enum {
MAX_SCRIPT_INSTANCE_BINDINGS = 8
} ;
# ifdef DEBUG_ENABLED
friend struct _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 < p_target . method ) : ( _id < p_target . _id ) ; }
Target ( const ObjectID & p_id , const StringName & p_method ) :
_id ( p_id ) ,
method ( p_method ) {
}
Target ( ) { _id = 0 ; }
} ;
struct Slot {
int reference_count ;
Connection conn ;
List < Connection > : : Element * cE ;
Slot ( ) { reference_count = 0 ; }
} ;
MethodInfo user ;
VMap < Target , Slot > slot_map ;
Signal ( ) { }
} ;
HashMap < StringName , Signal > signal_map ;
List < Connection > connections ;
# ifdef DEBUG_ENABLED
SafeRefCount _lock_index ;
# endif
bool _block_signals ;
int _predelete_ok ;
2023-01-15 19:42:08 +01:00
RBSet < Object * > change_receptors ;
2022-03-15 13:29:32 +01:00
ObjectID _instance_id ;
std : : atomic < ObjectRC * > _rc ;
bool _predelete ( ) ;
void _postinitialize ( ) ;
bool _can_translate ;
bool _emitting ;
# ifdef TOOLS_ENABLED
bool _edited ;
uint32_t _edited_version ;
2023-01-15 19:42:08 +01:00
RBSet < String > editor_section_folding ;
2022-03-15 13:29:32 +01:00
# endif
ScriptInstance * script_instance ;
RefPtr script ;
Dictionary metadata ;
mutable StringName _class_name ;
mutable const StringName * _class_ptr ;
void _add_user_signal ( const String & p_name , const Array & p_args = Array ( ) ) ;
bool _has_user_signal ( const StringName & p_name ) const ;
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 ;
Array _get_incoming_connections ( ) const ;
void _set_bind ( const String & p_set , const Variant & p_value ) ;
Variant _get_bind ( const String & p_name ) const ;
void _set_indexed_bind ( const NodePath & p_name , const Variant & p_value ) ;
Variant _get_indexed_bind ( const NodePath & p_name ) const ;
friend class Reference ;
SafeNumeric < uint32_t > instance_binding_count ;
void * _script_instance_bindings [ MAX_SCRIPT_INSTANCE_BINDINGS ] ;
protected :
2022-07-28 22:34:28 +02:00
virtual void _initialize_classv ( ) {
initialize_class ( ) ;
}
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 ;
} ;
2022-03-15 13:29:32 +01:00
virtual void _get_property_listv ( List < PropertyInfo > * p_list , bool p_reversed ) const { } ;
virtual void _notificationv ( int p_notification , bool p_reversed ) { } ;
2022-07-28 22:34:28 +02:00
static String _get_category ( ) {
return " " ;
}
2022-03-15 13:29:32 +01:00
static void _bind_methods ( ) ;
2022-07-28 22:34:28 +02:00
bool _set ( const StringName & p_name , const Variant & p_property ) {
return false ;
} ;
bool _get ( const StringName & p_name , Variant & r_property ) const {
return false ;
} ;
2022-03-15 13:29:32 +01:00
void _get_property_list ( List < PropertyInfo > * 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 < PropertyInfo > * 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 < String > * p_parents ) ;
static void _get_valid_parents_static ( List < String > * p_parents ) ;
void property_list_changed_notify ( ) ;
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 ) ;
virtual const StringName * _get_class_namev ( ) const {
if ( ! _class_name ) {
_class_name = get_class_static ( ) ;
}
return & _class_name ;
}
PoolVector < String > _get_meta_list_bind ( ) const ;
Array _get_property_list_bind ( ) const ;
Array _get_method_list_bind ( ) const ;
void _clear_internal_resource_paths ( const Variant & p_var ) ;
friend class ClassDB ;
virtual void _validate_property ( PropertyInfo & property ) const ;
void _disconnect ( const StringName & p_signal , Object * p_to_object , const StringName & p_to_method , bool p_force = false ) ;
public : //should be protected, but bug in clang++
static void initialize_class ( ) ;
_FORCE_INLINE_ static void register_custom_data_to_otdb ( ) { } ;
public :
# ifdef TOOLS_ENABLED
_FORCE_INLINE_ void _change_notify ( const char * p_property = " " ) {
_edited = true ;
2023-01-15 19:42:08 +01:00
for ( RBSet < Object * > : : Element * E = change_receptors . front ( ) ; E ; E = E - > next ( ) ) {
2022-03-15 13:29:32 +01:00
( ( Object * ) ( E - > get ( ) ) ) - > _changed_callback ( this , p_property ) ;
}
}
# else
_FORCE_INLINE_ void _change_notify ( const char * p_what = " " ) { }
# endif
static void * get_class_ptr_static ( ) {
static int ptr ;
return & ptr ;
}
ObjectRC * _use_rc ( ) ;
2022-07-28 22:34:28 +02:00
bool _is_gpl_reversed ( ) const {
return false ;
}
2022-03-15 13:29:32 +01:00
2022-07-28 22:34:28 +02:00
_FORCE_INLINE_ ObjectID get_instance_id ( ) const {
return _instance_id ;
}
2022-03-15 13:29:32 +01:00
// this is used for editors
void add_change_receptor ( Object * p_receptor ) ;
void remove_change_receptor ( Object * p_receptor ) ;
template < class T >
static T * cast_to ( Object * p_object ) {
# ifndef NO_SAFE_CAST
return dynamic_cast < T * > ( p_object ) ;
# else
if ( ! p_object )
return NULL ;
if ( p_object - > is_class_ptr ( T : : get_class_ptr_static ( ) ) )
return static_cast < T * > ( p_object ) ;
else
return NULL ;
# endif
}
template < class T >
static const T * cast_to ( const Object * p_object ) {
# ifndef NO_SAFE_CAST
return dynamic_cast < const T * > ( p_object ) ;
# else
if ( ! p_object )
return NULL ;
if ( p_object - > is_class_ptr ( T : : get_class_ptr_static ( ) ) )
return static_cast < const T * > ( p_object ) ;
else
return NULL ;
# endif
}
enum {
NOTIFICATION_POSTINITIALIZE = 0 ,
NOTIFICATION_PREDELETE = 1
} ;
/* TYPE API */
2022-07-28 22:34:28 +02:00
static void get_inheritance_list_static ( List < String > * p_inheritance_list ) {
p_inheritance_list - > push_back ( " Object " ) ;
}
2022-03-15 13:29:32 +01:00
2022-07-28 22:34:28 +02:00
static String get_class_static ( ) {
return " Object " ;
}
static String get_parent_class_static ( ) {
return String ( ) ;
}
static String get_category_static ( ) {
return String ( ) ;
}
2022-03-15 13:29:32 +01:00
2022-07-28 22:34:28 +02:00
virtual String get_class ( ) const {
return " Object " ;
}
virtual String get_save_class ( ) const {
return get_class ( ) ;
} //class stored when saving
2022-03-15 13:29:32 +01:00
2022-07-28 22:34:28 +02:00
virtual bool is_class ( const String & p_class ) const {
return ( p_class = = " Object " ) ;
}
virtual bool is_class_ptr ( void * p_ptr ) const {
return get_class_ptr_static ( ) = = p_ptr ;
}
2022-03-15 13:29:32 +01:00
_FORCE_INLINE_ const StringName & get_class_name ( ) const {
if ( ! _class_ptr ) {
return * _get_class_namev ( ) ;
} else {
return * _class_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 = nullptr ) ;
Variant get ( const StringName & p_name , bool * r_valid = nullptr ) const ;
void set_indexed ( const Vector < StringName > & p_names , const Variant & p_value , bool * r_valid = nullptr ) ;
Variant get_indexed ( const Vector < StringName > & p_names , bool * r_valid = nullptr ) const ;
void get_property_list ( List < PropertyInfo > * p_list , bool p_reversed = false ) const ;
bool has_method ( const StringName & p_method ) const ;
void get_method_list ( List < MethodInfo > * 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 ) ;
virtual void notification_callback ( int p_message_type ) { }
virtual String to_string ( ) ;
//used mainly by script, get and set all INCLUDING string
virtual Variant getvar ( const Variant & p_key , bool * r_valid = nullptr ) const ;
virtual void setvar ( const Variant & p_key , const Variant & p_value , bool * r_valid = nullptr ) ;
/* SCRIPT */
void set_script ( const RefPtr & p_script ) ;
RefPtr get_script ( ) const ;
bool has_meta ( const String & p_name ) const ;
void set_meta ( const String & p_name , const Variant & p_value ) ;
void remove_meta ( const String & p_name ) ;
2022-02-27 22:03:33 +01:00
Variant get_meta ( const String & p_name , const Variant & p_default = Variant ( ) ) const ;
2022-03-15 13:29:32 +01:00
void get_meta_list ( List < String > * p_list ) const ;
# ifdef TOOLS_ENABLED
void set_edited ( bool p_edited ) ;
bool is_edited ( ) const ;
uint32_t get_edited_version ( ) const ; //this function is used to check when something changed beyond a point, it's used mainly for generating previews
# endif
void set_script_instance ( ScriptInstance * p_instance ) ;
2022-07-28 22:34:28 +02:00
_FORCE_INLINE_ ScriptInstance * get_script_instance ( ) const {
return script_instance ;
}
2022-03-15 13:29:32 +01:00
void set_script_and_instance ( const RefPtr & p_script , ScriptInstance * p_instance ) ; //some script languages can't control instance creation, so this function eases the process
void add_user_signal ( const MethodInfo & p_signal ) ;
Error emit_signal ( const StringName & p_name , VARIANT_ARG_LIST ) ;
Error emit_signal ( const StringName & p_name , const Variant * * p_args , int p_argcount ) ;
bool has_signal ( const StringName & p_name ) const ;
void get_signal_list ( List < MethodInfo > * p_signals ) const ;
void get_signal_connection_list ( const StringName & p_signal , List < Connection > * p_connections ) const ;
void get_all_signal_connections ( List < Connection > * p_connections ) const ;
int get_persistent_signal_connection_count ( ) const ;
void get_signals_connected_to_this ( List < Connection > * p_connections ) const ;
Error connect ( const StringName & p_signal , Object * p_to_object , const StringName & p_to_method , const Vector < Variant > & p_binds = Vector < Variant > ( ) , 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_deferred ( const StringName & p_property , const Variant & p_value ) ;
void set_block_signals ( bool p_block ) ;
bool is_blocking_signals ( ) const ;
Variant : : Type get_static_property_type ( const StringName & p_property , bool * r_valid = nullptr ) const ;
Variant : : Type get_static_property_type_indexed ( const Vector < StringName > & p_path , bool * r_valid = nullptr ) const ;
virtual void get_translatable_strings ( List < String > * p_strings ) const ;
2023-12-10 16:02:08 +01:00
virtual void get_argument_options ( const StringName & p_function , int p_idx , List < String > * r_options , const String & quote_style ) const ;
2022-03-15 13:29:32 +01:00
StringName tr ( const StringName & p_message ) const ; // translate message (internationalization)
2023-08-29 22:02:31 +02:00
StringName trt ( const StringName & p_message , const String & p_locale ) const ; // translate message (translate_to) (internationalization)
2022-03-15 13:29:32 +01:00
bool _is_queued_for_deletion ; // set to true by SceneTree::queue_delete()
bool is_queued_for_deletion ( ) const ;
2022-07-28 22:34:28 +02:00
_FORCE_INLINE_ void set_message_translation ( bool p_enable ) {
_can_translate = p_enable ;
}
_FORCE_INLINE_ bool can_translate_messages ( ) const {
return _can_translate ;
}
2022-03-15 13:29:32 +01:00
# ifdef TOOLS_ENABLED
void editor_set_section_unfold ( const String & p_section , bool p_unfolded ) ;
bool editor_is_section_unfolded ( const String & p_section ) ;
2023-01-15 19:42:08 +01:00
const RBSet < String > & editor_get_section_folding ( ) const {
2022-07-28 22:34:28 +02:00
return editor_section_folding ;
}
void editor_clear_section_folding ( ) {
editor_section_folding . clear ( ) ;
}
2022-03-15 13:29:32 +01:00
# endif
//used by script languages to store binding data
void * get_script_instance_binding ( int p_script_language_index ) ;
bool has_script_instance_binding ( int p_script_language_index ) ;
void set_script_instance_binding ( int p_script_language_index , void * p_data ) ;
void clear_internal_resource_paths ( ) ;
2023-06-12 21:13:26 +02:00
void cancel_free ( ) ;
2022-03-15 13:29:32 +01:00
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 HashMapHasherDefault : : hash ( ( uint64_t ) u . i ) ;
}
} ;
static HashMap < ObjectID , Object * > instances ;
static HashMap < Object * , ObjectID , ObjectPtrHash > instance_checks ;
static ObjectID instance_counter ;
friend class Object ;
friend void unregister_core_types ( ) ;
static RWLock rw_lock ;
static void cleanup ( ) ;
static ObjectID add_instance ( Object * p_object ) ;
static void remove_instance ( Object * p_object ) ;
friend void register_core_types ( ) ;
public :
typedef void ( * DebugFunc ) ( Object * p_obj ) ;
static Object * get_instance ( ObjectID p_instance_id ) ;
static void debug_objects ( DebugFunc p_func ) ;
static int get_object_count ( ) ;
// This one may give false positives because a new object may be allocated at the same memory of a previously freed one
_FORCE_INLINE_ static bool instance_validate ( Object * p_ptr ) {
rw_lock . read_lock ( ) ;
bool exists = instance_checks . has ( p_ptr ) ;
rw_lock . read_unlock ( ) ;
return exists ;
}
} ;
//needed by macros
2022-08-17 13:45:14 +02:00
# include "core/object/class_db.h"
2022-03-15 13:29:32 +01:00
# endif