/*************************************************************************/ /* scene_tree.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. */ /*************************************************************************/ #ifndef SCENE_TREE_H #define SCENE_TREE_H #include "core/io/multiplayer_api.h" #include "core/os/main_loop.h" #include "core/os/thread_safe.h" #include "core/self_list.h" #include "scene/resources/mesh.h" #include "scene/resources/world.h" #include "scene/resources/world_2d.h" class PackedScene; class Node; class SceneTreeTween; class ShortCut; class Spatial; class Viewport; class Material; class Mesh; class SceneTreeTimer : public Reference { GDCLASS(SceneTreeTimer, Reference); float time_left; bool process_pause; bool ignore_time_scale = false; protected: static void _bind_methods(); public: void set_time_left(float p_time); float get_time_left() const; void set_pause_mode_process(bool p_pause_mode_process); bool is_pause_mode_process(); void set_ignore_time_scale(bool p_ignore); bool is_ignore_time_scale(); void release_connections(); SceneTreeTimer(); }; class SceneTree : public MainLoop { _THREAD_SAFE_CLASS_ GDCLASS(SceneTree, MainLoop); public: typedef void (*IdleCallback)(); enum StretchMode { STRETCH_MODE_DISABLED, STRETCH_MODE_2D, STRETCH_MODE_VIEWPORT, }; enum StretchAspect { STRETCH_ASPECT_IGNORE, STRETCH_ASPECT_KEEP, STRETCH_ASPECT_KEEP_WIDTH, STRETCH_ASPECT_KEEP_HEIGHT, STRETCH_ASPECT_EXPAND, }; private: struct Group { Vector nodes; //uint64_t last_tree_version; bool changed; Group() { changed = false; }; }; struct ClientPhysicsInterpolation { SelfList::List _spatials_list; void physics_process(); } _client_physics_interpolation; Viewport *root; uint64_t tree_version; float physics_process_time; float idle_process_time; bool accept_quit; bool quit_on_go_back; #ifdef DEBUG_ENABLED bool debug_collisions_hint; bool debug_navigation_hint; #endif bool pause; int root_lock; Map group_map; bool _quit; bool initialized; bool input_handled; bool _physics_interpolation_enabled; Size2 last_screen_size; StringName tree_changed_name; StringName node_added_name; StringName node_removed_name; StringName node_renamed_name; bool use_font_oversampling; int64_t current_frame; int64_t current_event; int node_count; #ifdef TOOLS_ENABLED Node *edited_scene_root; #endif struct UGCall { StringName group; StringName call; bool operator<(const UGCall &p_with) const { return group == p_with.group ? call < p_with.call : group < p_with.group; } }; //safety for when a node is deleted while a group is being called int call_lock; Set call_skip; //skip erased nodes StretchMode stretch_mode; StretchAspect stretch_aspect; Size2i stretch_min; real_t stretch_scale; void _update_font_oversampling(float p_ratio); void _update_root_rect(); struct DeleteQueueElement { ObjectID id; int32_t child_list_id; }; LocalVector delete_queue; Map> unique_group_calls; bool ugc_locked; void _flush_ugc(); _FORCE_INLINE_ void _update_group_order(Group &g, bool p_use_priority = false); Array _get_nodes_in_group(const StringName &p_group); Node *current_scene; Color debug_collisions_color; Color debug_collision_contact_color; Color debug_navigation_color; Color debug_navigation_disabled_color; Ref debug_contact_mesh; Ref navigation_material; Ref navigation_disabled_material; Ref collision_material; int collision_debug_contacts; void _change_scene(Node *p_to); //void _call_group(uint32_t p_call_flags,const StringName& p_group,const StringName& p_function,const Variant& p_arg1,const Variant& p_arg2); List> timers; List> tweens; ///network/// Ref multiplayer; bool multiplayer_poll; void _network_peer_connected(int p_id); void _network_peer_disconnected(int p_id); void _connected_to_server(); void _connection_failed(); void _server_disconnected(); static SceneTree *singleton; friend class Node; void tree_changed(); void node_added(Node *p_node); void node_removed(Node *p_node); void node_renamed(Node *p_node); void process_tweens(float p_delta, bool p_physics_frame); Group *add_to_group(const StringName &p_group, Node *p_node); void remove_from_group(const StringName &p_group, Node *p_node); void make_group_changed(const StringName &p_group); void _notify_group_pause(const StringName &p_group, int p_notification); void _call_input_pause(const StringName &p_group, const StringName &p_method, const Ref &p_input); Variant _call_group_flags(const Variant **p_args, int p_argcount, Variant::CallError &r_error); Variant _call_group(const Variant **p_args, int p_argcount, Variant::CallError &r_error); void _flush_delete_queue(); //optimization friend class CanvasItem; friend class Spatial; friend class Viewport; SelfList::List xform_change_list; friend class ScriptDebuggerRemote; Ref debugger_stop_shortcut; #ifdef DEBUG_ENABLED Map live_edit_node_path_cache; Map live_edit_resource_cache; NodePath live_edit_root; String live_edit_scene; Map> live_scene_edit_cache; Map> live_edit_remove_list; void _debugger_request_tree(); void _live_edit_node_path_func(const NodePath &p_path, int p_id); void _live_edit_res_path_func(const String &p_path, int p_id); void _live_edit_node_set_func(int p_id, const StringName &p_prop, const Variant &p_value); void _live_edit_node_set_res_func(int p_id, const StringName &p_prop, const String &p_value); void _live_edit_node_call_func(int p_id, const StringName &p_method, VARIANT_ARG_DECLARE); void _live_edit_res_set_func(int p_id, const StringName &p_prop, const Variant &p_value); void _live_edit_res_set_res_func(int p_id, const StringName &p_prop, const String &p_value); void _live_edit_res_call_func(int p_id, const StringName &p_method, VARIANT_ARG_DECLARE); void _live_edit_root_func(const NodePath &p_scene_path, const String &p_scene_from); void _live_edit_create_node_func(const NodePath &p_parent, const String &p_type, const String &p_name); void _live_edit_instance_node_func(const NodePath &p_parent, const String &p_path, const String &p_name); void _live_edit_remove_node_func(const NodePath &p_at); void _live_edit_remove_and_keep_node_func(const NodePath &p_at, ObjectID p_keep_id); void _live_edit_restore_node_func(ObjectID p_id, const NodePath &p_at, int p_at_pos); void _live_edit_duplicate_node_func(const NodePath &p_at, const String &p_new_name); void _live_edit_reparent_node_func(const NodePath &p_at, const NodePath &p_new_place, const String &p_new_name, int p_at_pos); #endif enum { MAX_IDLE_CALLBACKS = 256 }; static IdleCallback idle_callbacks[MAX_IDLE_CALLBACKS]; static int idle_callback_count; void _call_idle_callbacks(); protected: void _notification(int p_notification); static void _bind_methods(); public: enum { NOTIFICATION_TRANSFORM_CHANGED = 2000 }; enum GroupCallFlags { GROUP_CALL_DEFAULT = 0, GROUP_CALL_REVERSE = 1, GROUP_CALL_REALTIME = 2, GROUP_CALL_UNIQUE = 4, GROUP_CALL_MULTILEVEL = 8, }; _FORCE_INLINE_ Viewport *get_root() const { return root; } void call_group_flags(uint32_t p_call_flags, const StringName &p_group, const StringName &p_function, VARIANT_ARG_LIST); void notify_group_flags(uint32_t p_call_flags, const StringName &p_group, int p_notification); void set_group_flags(uint32_t p_call_flags, const StringName &p_group, const String &p_name, const Variant &p_value); void call_group(const StringName &p_group, const StringName &p_function, VARIANT_ARG_LIST); void notify_group(const StringName &p_group, int p_notification); void set_group(const StringName &p_group, const String &p_name, const Variant &p_value); void flush_transform_notifications(); virtual void input_text(const String &p_text); virtual void input_event(const Ref &p_event); virtual void init(); virtual bool iteration(float p_time); virtual void iteration_end(); virtual bool idle(float p_time); virtual void finish(); bool is_auto_accept_quit() const; void set_auto_accept_quit(bool p_enable); bool is_quit_on_go_back() const; void set_quit_on_go_back(bool p_enable); void quit(int p_exit_code = -1); void set_input_as_handled(); bool is_input_handled(); _FORCE_INLINE_ float get_physics_process_time() const { return physics_process_time; } _FORCE_INLINE_ float get_idle_process_time() const { return idle_process_time; } #ifdef TOOLS_ENABLED bool is_node_being_edited(const Node *p_node) const; #else bool is_node_being_edited(const Node *p_node) const { return false; } #endif void set_pause(bool p_enabled); bool is_paused() const; #ifdef DEBUG_ENABLED void set_debug_collisions_hint(bool p_enabled); bool is_debugging_collisions_hint() const; void set_debug_navigation_hint(bool p_enabled); bool is_debugging_navigation_hint() const; #else void set_debug_collisions_hint(bool p_enabled) {} bool is_debugging_collisions_hint() const { return false; } void set_debug_navigation_hint(bool p_enabled) {} bool is_debugging_navigation_hint() const { return false; } #endif void set_debug_collisions_color(const Color &p_color); Color get_debug_collisions_color() const; void set_debug_collision_contact_color(const Color &p_color); Color get_debug_collision_contact_color() const; void set_debug_navigation_color(const Color &p_color); Color get_debug_navigation_color() const; void set_debug_navigation_disabled_color(const Color &p_color); Color get_debug_navigation_disabled_color() const; Ref get_debug_navigation_material(); Ref get_debug_navigation_disabled_material(); Ref get_debug_collision_material(); Ref get_debug_contact_mesh(); int get_collision_debug_contact_count() { return collision_debug_contacts; } int64_t get_frame() const; int64_t get_event_count() const; int get_node_count() const; void queue_delete(Object *p_object); void get_nodes_in_group(const StringName &p_group, List *p_list); bool has_group(const StringName &p_identifier) const; void set_screen_stretch(StretchMode p_mode, StretchAspect p_aspect, const Size2 &p_minsize, real_t p_scale = 1.0); void set_use_font_oversampling(bool p_oversampling); bool is_using_font_oversampling() const; //void change_scene(const String& p_path); //Node *get_loaded_scene(); void set_edited_scene_root(Node *p_node); Node *get_edited_scene_root() const; void set_current_scene(Node *p_scene); Node *get_current_scene() const; Error change_scene(const String &p_path); Error change_scene_to(const Ref &p_scene); Error reload_current_scene(); Ref create_timer(float p_delay_sec, bool p_process_pause = true); Ref create_tween(); Array get_processed_tweens(); //used by Main::start, don't use otherwise void add_current_scene(Node *p_current); static SceneTree *get_singleton() { return singleton; } void drop_files(const Vector &p_files, int p_from_screen = 0); void global_menu_action(const Variant &p_id, const Variant &p_meta); void get_argument_options(const StringName &p_function, int p_idx, List *r_options) const; //network API Ref get_multiplayer() const; void set_multiplayer_poll_enabled(bool p_enabled); bool is_multiplayer_poll_enabled() const; void set_multiplayer(Ref p_multiplayer); void set_network_peer(const Ref &p_network_peer); Ref get_network_peer() const; bool is_network_server() const; bool has_network_peer() const; int get_network_unique_id() const; Vector get_network_connected_peers() const; int get_rpc_sender_id() const; void set_refuse_new_network_connections(bool p_refuse); bool is_refusing_new_network_connections() const; void set_physics_interpolation_enabled(bool p_enabled); bool is_physics_interpolation_enabled() const; void client_physics_interpolation_add_spatial(SelfList *p_elem); void client_physics_interpolation_remove_spatial(SelfList *p_elem); static void add_idle_callback(IdleCallback p_callback); SceneTree(); ~SceneTree(); }; VARIANT_ENUM_CAST(SceneTree::StretchMode); VARIANT_ENUM_CAST(SceneTree::StretchAspect); VARIANT_ENUM_CAST(SceneTree::GroupCallFlags); #endif // SCENE_TREE_H