Path: blob/master/editor/scene/scene_tree_editor.cpp
10277 views
/**************************************************************************/1/* scene_tree_editor.cpp */2/**************************************************************************/3/* This file is part of: */4/* GODOT ENGINE */5/* https://godotengine.org */6/**************************************************************************/7/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */8/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */9/* */10/* Permission is hereby granted, free of charge, to any person obtaining */11/* a copy of this software and associated documentation files (the */12/* "Software"), to deal in the Software without restriction, including */13/* without limitation the rights to use, copy, modify, merge, publish, */14/* distribute, sublicense, and/or sell copies of the Software, and to */15/* permit persons to whom the Software is furnished to do so, subject to */16/* the following conditions: */17/* */18/* The above copyright notice and this permission notice shall be */19/* included in all copies or substantial portions of the Software. */20/* */21/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */22/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */23/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */24/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */25/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */26/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */27/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */28/**************************************************************************/2930#include "scene_tree_editor.h"3132#include "core/config/project_settings.h"33#include "core/object/script_language.h"34#include "editor/animation/animation_player_editor_plugin.h"35#include "editor/docks/editor_dock_manager.h"36#include "editor/docks/node_dock.h"37#include "editor/editor_node.h"38#include "editor/editor_string_names.h"39#include "editor/editor_undo_redo_manager.h"40#include "editor/file_system/editor_file_system.h"41#include "editor/scene/canvas_item_editor_plugin.h"42#include "editor/script/script_editor_plugin.h"43#include "editor/settings/editor_settings.h"44#include "editor/themes/editor_scale.h"45#include "scene/2d/node_2d.h"46#include "scene/gui/flow_container.h"47#include "scene/gui/label.h"48#include "scene/gui/texture_rect.h"49#include "scene/main/window.h"50#include "scene/resources/packed_scene.h"5152Node *SceneTreeEditor::get_scene_node() const {53ERR_FAIL_COND_V(!is_inside_tree(), nullptr);5455return get_tree()->get_edited_scene_root();56}5758PackedStringArray SceneTreeEditor::_get_node_configuration_warnings(Node *p_node) {59PackedStringArray warnings = p_node->get_configuration_warnings();60if (p_node == get_scene_node()) {61Node2D *node_2d = Object::cast_to<Node2D>(p_node);62if (node_2d) {63// Note: Warn for Node2D but not all CanvasItems, don't warn for Control nodes.64// Control nodes may have reasons to use a transformed root node like anchors.65if (!node_2d->get_position().is_zero_approx()) {66warnings.append(TTR("The root node of a scene is recommended to not be transformed, since instances of the scene will usually override this. Reset the transform and reload the scene to remove this warning."));67}68}69Node3D *node_3d = Object::cast_to<Node3D>(p_node);70if (node_3d) {71if (!node_3d->get_position().is_zero_approx()) {72warnings.append(TTR("The root node of a scene is recommended to not be transformed, since instances of the scene will usually override this. Reset the transform and reload the scene to remove this warning."));73}74}75}76return warnings;77}7879PackedStringArray SceneTreeEditor::_get_node_accessibility_configuration_warnings(Node *p_node) {80PackedStringArray warnings = p_node->get_accessibility_configuration_warnings();8182return warnings;83}8485void SceneTreeEditor::_cell_button_pressed(Object *p_item, int p_column, int p_id, MouseButton p_button) {86if (p_button != MouseButton::LEFT) {87return;88}8990if (connect_to_script_mode) {91return; // Don't do anything in this mode.92}9394TreeItem *item = Object::cast_to<TreeItem>(p_item);95ERR_FAIL_NULL(item);9697NodePath np = item->get_metadata(0);9899Node *n = get_node(np);100ERR_FAIL_NULL(n);101102EditorUndoRedoManager *undo_redo = EditorUndoRedoManager::get_singleton();103if (p_id == BUTTON_SUBSCENE) {104if (n == get_scene_node()) {105if (n && n->get_scene_inherited_state().is_valid()) {106emit_signal(SNAME("open"), n->get_scene_inherited_state()->get_path());107}108} else {109emit_signal(SNAME("open"), n->get_scene_file_path());110}111} else if (p_id == BUTTON_SCRIPT) {112Ref<Script> script_typed = n->get_script();113if (script_typed.is_valid()) {114emit_signal(SNAME("open_script"), script_typed);115}116117} else if (p_id == BUTTON_VISIBILITY) {118undo_redo->create_action(TTR("Toggle Visible"));119_toggle_visible(n);120List<Node *> selection = editor_selection->get_top_selected_node_list();121if (selection.size() > 1 && selection.find(n) != nullptr) {122for (Node *nv : selection) {123ERR_FAIL_NULL(nv);124if (nv == n) {125continue;126}127_toggle_visible(nv);128}129}130undo_redo->commit_action();131} else if (p_id == BUTTON_LOCK) {132undo_redo->create_action(TTR("Unlock Node"));133undo_redo->add_do_method(n, "remove_meta", "_edit_lock_");134undo_redo->add_undo_method(n, "set_meta", "_edit_lock_", true);135undo_redo->add_do_method(this, "_update_tree");136undo_redo->add_undo_method(this, "_update_tree");137undo_redo->add_do_method(this, "emit_signal", "node_changed");138undo_redo->add_undo_method(this, "emit_signal", "node_changed");139undo_redo->commit_action();140} else if (p_id == BUTTON_PIN) {141if (n->is_class("AnimationMixer")) {142AnimationPlayerEditor::get_singleton()->unpin();143_update_tree();144}145146} else if (p_id == BUTTON_GROUP) {147undo_redo->create_action(TTR("Ungroup Children"));148149if (n->is_class("CanvasItem") || n->is_class("Node3D")) {150undo_redo->add_do_method(n, "remove_meta", "_edit_group_");151undo_redo->add_undo_method(n, "set_meta", "_edit_group_", true);152undo_redo->add_do_method(this, "_update_tree");153undo_redo->add_undo_method(this, "_update_tree");154undo_redo->add_do_method(this, "emit_signal", "node_changed");155undo_redo->add_undo_method(this, "emit_signal", "node_changed");156}157undo_redo->commit_action();158} else if (p_id == BUTTON_WARNING) {159PackedStringArray warnings = _get_node_configuration_warnings(n);160if (accessibility_warnings) {161warnings.append_array(_get_node_accessibility_configuration_warnings(n));162}163if (warnings.is_empty()) {164return;165}166167// Improve looks on tooltip, extra spacing on non-bullet point newlines.168const String bullet_point = U"• ";169String all_warnings;170for (const String &w : warnings) {171all_warnings += "\n" + bullet_point + w;172}173174// Limit the line width while keeping some padding.175// It is not efficient, but it does not have to be.176const PackedInt32Array boundaries = TS->string_get_word_breaks(all_warnings, "", 80);177PackedStringArray lines;178for (int i = 0; i < boundaries.size(); i += 2) {179const int start = boundaries[i];180const int end = boundaries[i + 1];181const String line = all_warnings.substr(start, end - start);182lines.append(line);183}184// We don't want the first two newlines.185all_warnings = String("\n").join(lines).indent(" ").replace(U" •", U"\n•").substr(2);186187warning->set_text(all_warnings);188warning->popup_centered();189190} else if (p_id == BUTTON_SIGNALS) {191editor_selection->clear();192editor_selection->add_node(n);193194set_selected(n);195196EditorDockManager::get_singleton()->focus_dock(NodeDock::get_singleton());197NodeDock::get_singleton()->show_connections();198} else if (p_id == BUTTON_GROUPS) {199editor_selection->clear();200editor_selection->add_node(n);201202set_selected(n);203204EditorDockManager::get_singleton()->focus_dock(NodeDock::get_singleton());205NodeDock::get_singleton()->show_groups();206} else if (p_id == BUTTON_UNIQUE) {207bool ask_before_revoking_unique_name = EDITOR_GET("docks/scene_tree/ask_before_revoking_unique_name");208revoke_node = n;209if (ask_before_revoking_unique_name) {210String msg = vformat(TTR("Revoke unique name for node \"%s\"?"), n->get_name());211ask_before_revoke_checkbox->set_pressed(false);212revoke_dialog_label->set_text(msg);213revoke_dialog->reset_size();214revoke_dialog->popup_centered();215} else {216_revoke_unique_name();217}218}219}220221void SceneTreeEditor::_update_ask_before_revoking_unique_name() {222if (ask_before_revoke_checkbox->is_pressed()) {223EditorSettings::get_singleton()->set("docks/scene_tree/ask_before_revoking_unique_name", false);224ask_before_revoke_checkbox->set_pressed(false);225}226227_revoke_unique_name();228}229230void SceneTreeEditor::_revoke_unique_name() {231EditorUndoRedoManager *undo_redo = EditorUndoRedoManager::get_singleton();232233undo_redo->create_action(TTR("Disable Scene Unique Name"));234undo_redo->add_do_method(revoke_node, "set_unique_name_in_owner", false);235undo_redo->add_undo_method(revoke_node, "set_unique_name_in_owner", true);236undo_redo->add_do_method(this, "_update_tree");237undo_redo->add_undo_method(this, "_update_tree");238undo_redo->commit_action();239}240241void SceneTreeEditor::_toggle_visible(Node *p_node) {242if (p_node->has_method("is_visible") && p_node->has_method("set_visible")) {243bool v = bool(p_node->call("is_visible"));244EditorUndoRedoManager *undo_redo = EditorUndoRedoManager::get_singleton();245undo_redo->add_do_method(p_node, "set_visible", !v);246undo_redo->add_undo_method(p_node, "set_visible", v);247}248}249250void SceneTreeEditor::_update_node_path(Node *p_node, bool p_recursive) {251if (!p_node) {252return;253}254255HashMap<Node *, CachedNode>::Iterator I = node_cache.get(p_node);256if (!I) {257return;258}259260I->value.item->set_metadata(0, p_node->get_path());261262if (!p_recursive) {263return;264}265266int cc = p_node->get_child_count(false);267for (int i = 0; i < cc; i++) {268Node *c = p_node->get_child(i, false);269_update_node_path(c, p_recursive);270}271}272273void SceneTreeEditor::_update_node_subtree(Node *p_node, TreeItem *p_parent, bool p_force) {274if (!p_node) {275return;276}277278// Only owned nodes are editable, since nodes can create their own (manually owned) child nodes,279// which the editor needs not to know about.280281bool part_of_subscene = false;282283if (!display_foreign && p_node->get_owner() != get_scene_node() && p_node != get_scene_node()) {284if ((show_enabled_subscene || can_open_instance) && p_node->get_owner() && (get_scene_node()->is_editable_instance(p_node->get_owner()))) {285part_of_subscene = true;286// Allow.287} else {288// Stale node, remove recursively.289node_cache.remove(p_node, true);290return;291}292} else {293part_of_subscene = p_node != get_scene_node() && get_scene_node()->get_scene_inherited_state().is_valid() && get_scene_node()->get_scene_inherited_state()->find_node_by_path(get_scene_node()->get_path_to(p_node)) >= 0;294}295296HashMap<Node *, CachedNode>::Iterator I = node_cache.get(p_node);297TreeItem *item = nullptr;298299bool is_new = false;300301if (I) {302item = I->value.item;303TreeItem *current_parent = item->get_parent();304305// Our parent might be re-created because of a changed type.306if (p_parent && p_parent != current_parent) {307if (current_parent) {308current_parent->remove_child(item);309}310p_parent->add_child(item);311I->value.removed = false;312_move_node_item(p_parent, I);313}314315if (I->value.has_moved_children) {316_move_node_children(I);317}318} else {319int index = -1;320// Check to see if there is a root node for us to reuse.321if (!p_parent) {322item = tree->get_root();323if (!item) {324item = tree->create_item(nullptr);325index = 0;326}327} else {328index = p_node->get_index(false);329item = tree->create_item(p_parent, index);330}331332I = node_cache.add(p_node, item);333I->value.index = index;334is_new = true;335}336337if (!(p_force || I->value.dirty)) {338// Nothing to do.339return;340}341342_update_node(p_node, item, part_of_subscene);343I->value.dirty = false;344I->value.can_process = p_node->can_process();345346// Force update all our children if we are new or if we were forced to update.347bool force_update_children = p_force || is_new;348// Update all our children.349for (int i = 0; i < p_node->get_child_count(false); i++) {350_update_node_subtree(p_node->get_child(i, false), item, force_update_children);351}352353if (valid_types.size()) {354bool valid = false;355for (const StringName &E : valid_types) {356if (p_node->is_class(E) ||357EditorNode::get_singleton()->is_object_of_custom_type(p_node, E)) {358valid = true;359break;360} else {361Ref<Script> node_script = p_node->get_script();362while (node_script.is_valid()) {363if (node_script->get_path() == E) {364valid = true;365break;366}367node_script = node_script->get_base_script();368}369if (valid) {370break;371}372}373}374375if (!valid) {376_set_item_custom_color(item, get_theme_color(SNAME("font_disabled_color"), EditorStringName(Editor)));377item->set_selectable(0, false);378item->deselect(0);379if (selected == p_node) {380selected = nullptr;381}382}383}384}385386void SceneTreeEditor::_update_node(Node *p_node, TreeItem *p_item, bool p_part_of_subscene) {387// Reset item properties that are not explicitly set in the default case.388p_item->clear_buttons();389p_item->remove_meta(SNAME("custom_color"));390p_item->clear_custom_color(0);391p_item->set_selectable(0, true);392393p_item->set_text(0, p_node->get_name());394p_item->set_text_overrun_behavior(0, TextServer::OVERRUN_NO_TRIMMING);395if (can_rename && !p_part_of_subscene) {396p_item->set_editable(0, true);397}398399if (can_rename) {400bool collapsed = p_node->is_displayed_folded();401if (collapsed) {402p_item->set_collapsed(true);403}404}405406Ref<Texture2D> icon = EditorNode::get_singleton()->get_object_icon(p_node, "Node");407p_item->set_icon(0, icon);408p_item->set_metadata(0, p_node->get_path());409410if (!p_node->is_connected("child_order_changed", callable_mp(this, &SceneTreeEditor::_node_child_order_changed))) {411p_node->connect("child_order_changed", callable_mp(this, &SceneTreeEditor::_node_child_order_changed).bind(p_node));412}413414if (!p_node->is_connected("editor_state_changed", callable_mp(this, &SceneTreeEditor::_node_editor_state_changed))) {415p_node->connect("editor_state_changed", callable_mp(this, &SceneTreeEditor::_node_editor_state_changed).bind(p_node));416}417418if (connecting_signal || (can_open_instance && is_scene_tree_dock)) {419if (!p_node->is_connected(CoreStringName(script_changed), callable_mp(this, &SceneTreeEditor::_node_script_changed))) {420p_node->connect(CoreStringName(script_changed), callable_mp(this, &SceneTreeEditor::_node_script_changed).bind(p_node));421}422}423424if (connecting_signal) {425// Add script icons for all scripted nodes.426Ref<Script> scr = p_node->get_script();427if (scr.is_valid()) {428p_item->add_button(0, get_editor_theme_icon(SNAME("Script")), BUTTON_SCRIPT);429if (EditorNode::get_singleton()->get_object_custom_type_base(p_node) == scr) {430// Disable button on custom scripts (pure visual cue).431p_item->set_button_disabled(0, p_item->get_button_count(0) - 1, true);432}433}434}435436if (connect_to_script_mode) {437Color accent = get_theme_color(SNAME("accent_color"), EditorStringName(Editor));438439Ref<Script> scr = p_node->get_script();440bool has_custom_script = scr.is_valid() && EditorNode::get_singleton()->get_object_custom_type_base(p_node) == scr;441if (scr.is_null() || has_custom_script) {442_set_item_custom_color(p_item, get_theme_color(SNAME("font_disabled_color"), EditorStringName(Editor)));443p_item->set_selectable(0, false);444445accent.a *= 0.7;446}447448if (marked.has(p_node)) {449String node_name = p_node->get_name();450if (connecting_signal) {451node_name += " " + TTR("(Connecting From)");452}453p_item->set_text(0, node_name);454_set_item_custom_color(p_item, accent);455}456} else if (p_part_of_subscene) {457if (valid_types.is_empty()) {458_set_item_custom_color(p_item, get_theme_color(SNAME("warning_color"), EditorStringName(Editor)));459}460} else if (marked.has(p_node)) {461String node_name = p_node->get_name();462if (connecting_signal) {463node_name += " " + TTR("(Connecting From)");464}465p_item->set_text(0, node_name);466p_item->set_selectable(0, marked_selectable);467_set_item_custom_color(p_item, get_theme_color(SNAME("accent_color"), EditorStringName(Editor)));468} else if (!p_node->can_process()) {469_set_item_custom_color(p_item, get_theme_color(SNAME("font_disabled_color"), EditorStringName(Editor)));470} else if (!marked_selectable && !marked_children_selectable) {471Node *node = p_node;472while (node) {473if (marked.has(node)) {474p_item->set_selectable(0, false);475_set_item_custom_color(p_item, get_theme_color(SNAME("error_color"), EditorStringName(Editor)));476break;477}478node = node->get_parent();479}480}481482if (can_rename) { // TODO Should be can edit..483PackedStringArray warnings = _get_node_configuration_warnings(p_node);484if (accessibility_warnings) {485warnings.append_array(_get_node_accessibility_configuration_warnings(p_node));486}487488const int num_warnings = warnings.size();489if (num_warnings > 0) {490StringName warning_icon;491if (num_warnings == 1) {492warning_icon = SNAME("NodeWarning");493} else if (num_warnings <= 3) {494warning_icon = vformat("NodeWarnings%d", num_warnings);495} else {496warning_icon = SNAME("NodeWarnings4Plus");497}498499// Improve looks on tooltip, extra spacing on non-bullet point newlines.500const String bullet_point = U"• ";501String all_warnings;502for (const String &w : warnings) {503all_warnings += "\n\n" + bullet_point + w.replace("\n", "\n ");504}505if (num_warnings == 1) {506all_warnings.remove_at(0); // With only one warning, two newlines do not look great.507}508509p_item->add_button(0, get_editor_theme_icon(warning_icon), BUTTON_WARNING, false, TTR("Node configuration warning:") + all_warnings);510}511512if (p_node->is_unique_name_in_owner()) {513const bool disabled = p_node->get_owner() != EditorNode::get_singleton()->get_edited_scene();514String button_text = vformat(TTR("This node can be accessed from anywhere within the scene it belongs to by using the '%s' prefix in the node path."), UNIQUE_NODE_PREFIX);515if (!disabled) {516button_text += "\n" + TTR("Click to disable this.");517}518p_item->add_button(0, get_editor_theme_icon(SNAME("SceneUniqueName")), BUTTON_UNIQUE, disabled, button_text);519}520521int num_connections = p_node->get_persistent_signal_connection_count();522int num_groups = p_node->get_persistent_group_count();523524String msg_temp;525if (num_connections >= 1) {526Array arr = { num_connections };527msg_temp += TTRN("Node has one connection.", "Node has {num} connections.", num_connections).format(arr, "{num}");528if (num_groups >= 1) {529msg_temp += "\n";530}531}532if (num_groups >= 1) {533msg_temp += TTRN("Node is in this group:", "Node is in the following groups:", num_groups) + "\n";534535List<GroupInfo> groups;536p_node->get_groups(&groups);537for (const GroupInfo &E : groups) {538if (E.persistent) {539msg_temp += String::utf8("• ") + String(E.name) + "\n";540}541}542} else {543msg_temp += "\n";544}545546Ref<Texture2D> icon_temp;547SceneTreeEditorButton signal_temp = BUTTON_SIGNALS;548String msg_temp_end = TTR("Click to show signals dock.");549550if (num_connections >= 1 && num_groups >= 1) {551icon_temp = get_editor_theme_icon(SNAME("SignalsAndGroups"));552} else if (num_connections >= 1) {553icon_temp = get_editor_theme_icon(SNAME("Signals"));554} else if (num_groups >= 1) {555icon_temp = get_editor_theme_icon(SNAME("Groups"));556signal_temp = BUTTON_GROUPS;557msg_temp_end = TTR("Click to show groups dock.");558}559560if (num_connections >= 1 || num_groups >= 1) {561msg_temp += msg_temp_end;562p_item->add_button(0, icon_temp, signal_temp, false, msg_temp);563}564}565566{567_update_node_tooltip(p_node, p_item);568Callable delay_update_tooltip = callable_mp(this, &SceneTreeEditor::_queue_update_node_tooltip);569if (p_node->is_connected("editor_description_changed", delay_update_tooltip)) {570p_node->disconnect("editor_description_changed", delay_update_tooltip);571}572p_node->connect("editor_description_changed", delay_update_tooltip.bind(p_item));573}574575// Show buttons only when necessary (SceneTreeDock) to avoid crashes.576if (can_open_instance && is_scene_tree_dock) {577Ref<Script> scr = p_node->get_script();578if (scr.is_valid()) {579String additional_notes;580Color button_color = Color(1, 1, 1);581// Can't set tooltip after adding button, need to do it before.582if (scr->is_tool()) {583if (Engine::get_singleton()->is_recovery_mode_hint()) {584additional_notes += "\n" + TTR("This script can run in the editor.\nIt is currently disabled due to recovery mode.");585button_color = get_theme_color(SNAME("warning_color"), EditorStringName(Editor));586} else {587additional_notes += "\n" + TTR("This script is currently running in the editor.");588button_color = get_theme_color(SNAME("accent_color"), EditorStringName(Editor));589}590}591if (EditorNode::get_singleton()->get_object_custom_type_base(p_node) == scr) {592additional_notes += "\n" + TTR("This script is a custom type.");593button_color.a = 0.5;594}595p_item->add_button(0, get_editor_theme_icon(SNAME("Script")), BUTTON_SCRIPT, false, TTR("Open Script:") + " " + scr->get_path() + additional_notes);596p_item->set_button_color(0, p_item->get_button_count(0) - 1, button_color);597}598599if (p_node->has_meta("_edit_lock_")) {600p_item->add_button(0, get_editor_theme_icon(SNAME("Lock")), BUTTON_LOCK, false, TTR("Node is locked.\nClick to unlock it."));601}602if (p_node->has_meta("_edit_group_")) {603p_item->add_button(0, get_editor_theme_icon(SNAME("Group")), BUTTON_GROUP, false, TTR("Children are not selectable.\nClick to make them selectable."));604}605606if (p_node->has_method("is_visible") && p_node->has_method("set_visible") && p_node->has_signal(SceneStringName(visibility_changed))) {607bool is_visible = p_node->call("is_visible");608if (is_visible) {609p_item->add_button(0, get_editor_theme_icon(SNAME("GuiVisibilityVisible")), BUTTON_VISIBILITY, false, TTR("Toggle Visibility"));610} else {611p_item->add_button(0, get_editor_theme_icon(SNAME("GuiVisibilityHidden")), BUTTON_VISIBILITY, false, TTR("Toggle Visibility"));612}613const Callable vis_changed = callable_mp(this, &SceneTreeEditor::_node_visibility_changed);614if (!p_node->is_connected(SceneStringName(visibility_changed), vis_changed)) {615p_node->connect(SceneStringName(visibility_changed), vis_changed.bind(p_node));616}617_update_visibility_color(p_node, p_item);618}619620if (p_node->is_class("AnimationMixer")) {621bool is_pinned = AnimationPlayerEditor::get_singleton()->get_editing_node() == p_node && AnimationPlayerEditor::get_singleton()->is_pinned();622623if (is_pinned) {624p_item->add_button(0, get_editor_theme_icon(SNAME("Pin")), BUTTON_PIN, false, TTR("AnimationPlayer is pinned.\nClick to unpin."));625}626}627}628629if (editor_selection) {630if (editor_selection->is_selected(p_node)) {631p_item->select(0);632}633}634635if (selected == p_node) {636if (!editor_selection) {637p_item->select(0);638}639p_item->set_as_cursor(0);640}641}642643void SceneTreeEditor::_update_if_clean() {644if (tree_dirty) {645return;646}647648callable_mp(this, &SceneTreeEditor::_update_tree).call_deferred(false);649tree_dirty = true;650}651652void SceneTreeEditor::_queue_update_node_tooltip(Node *p_node, TreeItem *p_item) {653Callable update_tooltip = callable_mp(this, &SceneTreeEditor::_update_node_tooltip);654if (update_node_tooltip_delay->is_connected("timeout", update_tooltip)) {655update_node_tooltip_delay->disconnect("timeout", update_tooltip);656}657658update_node_tooltip_delay->connect("timeout", update_tooltip.bind(p_node, p_item));659update_node_tooltip_delay->start();660}661662void SceneTreeEditor::_update_node_tooltip(Node *p_node, TreeItem *p_item) {663// Display the node name in all tooltips so that long node names can be previewed664// without having to rename them.665String tooltip = p_node->get_name();666667if (p_node == get_scene_node() && p_node->get_scene_inherited_state().is_valid()) {668if (p_item->get_button_by_id(0, BUTTON_SUBSCENE) == -1) {669p_item->add_button(0, get_editor_theme_icon(SNAME("InstanceOptions")), BUTTON_SUBSCENE, false, TTR("Open in Editor"));670}671tooltip += String("\n" + TTR("Inherits:") + " " + p_node->get_scene_inherited_state()->get_path());672} else if (p_node != get_scene_node() && !p_node->get_scene_file_path().is_empty() && can_open_instance) {673if (p_item->get_button_by_id(0, BUTTON_SUBSCENE) == -1) {674p_item->add_button(0, get_editor_theme_icon(SNAME("InstanceOptions")), BUTTON_SUBSCENE, false, TTR("Open in Editor"));675}676tooltip += String("\n" + TTR("Instance:") + " " + p_node->get_scene_file_path());677}678679StringName custom_type = EditorNode::get_singleton()->get_object_custom_type_name(p_node);680tooltip += "\n" + TTR("Type:") + " " + (custom_type != StringName() ? String(custom_type) : p_node->get_class());681682if (!p_node->get_editor_description().is_empty()) {683const PackedInt32Array boundaries = TS->string_get_word_breaks(p_node->get_editor_description(), "", 80);684tooltip += "\n";685686for (int i = 0; i < boundaries.size(); i += 2) {687const int start = boundaries[i];688const int end = boundaries[i + 1];689tooltip += "\n" + p_node->get_editor_description().substr(start, end - start + 1).rstrip("\n");690}691}692693p_item->set_tooltip_text(0, tooltip);694}695696void SceneTreeEditor::_node_visibility_changed(Node *p_node) {697HashMap<Node *, CachedNode>::Iterator I = node_cache.get(p_node, false);698if (!I) {699// We leave these signals connected when switching tabs.700// If the node is not in cache it was for a different tab.701return;702}703704if (!p_node || (p_node != get_scene_node() && !p_node->get_owner())) {705return;706}707708TreeItem *item = _find(tree->get_root(), p_node->get_path());709710if (!item) {711return;712}713714int idx = item->get_button_by_id(0, BUTTON_VISIBILITY);715ERR_FAIL_COND(idx == -1);716717bool node_visible = false;718719if (p_node->has_method("is_visible")) {720node_visible = p_node->call("is_visible");721if (p_node->is_class("CanvasItem") || p_node->is_class("CanvasLayer") || p_node->is_class("Window")) {722CanvasItemEditor::get_singleton()->get_viewport_control()->queue_redraw();723}724}725726if (node_visible) {727item->set_button(0, idx, get_editor_theme_icon(SNAME("GuiVisibilityVisible")));728} else {729item->set_button(0, idx, get_editor_theme_icon(SNAME("GuiVisibilityHidden")));730}731732_update_visibility_color(p_node, item);733}734735void SceneTreeEditor::_update_visibility_color(Node *p_node, TreeItem *p_item) {736if (p_node->has_method("is_visible_in_tree")) {737Color color(1, 1, 1, 1);738bool visible_on_screen = p_node->call("is_visible_in_tree");739if (!visible_on_screen) {740color.a = 0.6;741}742int idx = p_item->get_button_by_id(0, BUTTON_VISIBILITY);743p_item->set_button_color(0, idx, color);744}745}746747void SceneTreeEditor::_set_item_custom_color(TreeItem *p_item, Color p_color) {748p_item->set_custom_color(0, p_color);749p_item->set_meta(SNAME("custom_color"), p_color);750}751752void SceneTreeEditor::_node_script_changed(Node *p_node) {753HashMap<Node *, CachedNode>::Iterator I = node_cache.get(p_node, false);754if (!I) {755// We leave these signals connected when switching tabs.756// If the node is not in cache it was for a different tab.757return;758}759760node_cache.mark_dirty(p_node);761762_update_if_clean();763}764765void SceneTreeEditor::_move_node_children(HashMap<Node *, CachedNode>::Iterator &p_I) {766TreeItem *item = p_I->value.item;767Node *node = p_I->key;768int cc = node->get_child_count(false);769770for (int i = 0; i < cc; i++) {771HashMap<Node *, CachedNode>::Iterator CI = node_cache.get(node->get_child(i, false));772if (CI) {773_move_node_item(item, CI);774}775}776777p_I->value.has_moved_children = false;778}779780void SceneTreeEditor::_move_node_item(TreeItem *p_parent, HashMap<Node *, CachedNode>::Iterator &p_I) {781if (!p_parent) {782return;783}784785Node *node = p_I->key;786787int current_node_index = node->get_index(false);788int current_item_index = -1;789TreeItem *item = p_I->value.item;790791if (item->get_parent() != p_parent) {792TreeItem *p = item->get_parent();793if (p) {794item->get_parent()->remove_child(item);795}796p_parent->add_child(item);797p_I->value.removed = false;798current_item_index = p_parent->get_child_count() - 1;799p_I->value.index = current_item_index;800}801802if (p_I->value.index != current_node_index) {803// If we just re-parented we know our index.804if (current_item_index == -1) {805current_item_index = item->get_index();806}807808// Are we already in the right place?809if (current_node_index == current_item_index) {810p_I->value.index = current_node_index;811return;812}813814// Are we the first node?815if (current_node_index == 0) {816// There has to be at least 1 other node, otherwise we would not have gotten here.817TreeItem *neighbor_item = p_parent->get_child(0);818item->move_before(neighbor_item);819} else {820TreeItem *neighbor_item = p_parent->get_child(CLAMP(current_node_index - 1, 0, p_parent->get_child_count() - 1));821item->move_after(neighbor_item);822}823824p_I->value.index = current_node_index;825}826}827828void SceneTreeEditor::_node_child_order_changed(Node *p_node) {829// Do not try to change children on nodes currently marked for removal.830HashMap<Node *, CachedNode>::Iterator I = node_cache.get(p_node, false);831if (I) {832node_cache.mark_dirty(I->key);833I->value.has_moved_children = true;834}835836_update_if_clean();837}838839void SceneTreeEditor::_node_editor_state_changed(Node *p_node) {840node_cache.mark_dirty(p_node);841HashMap<Node *, CachedNode>::Iterator I = node_cache.get(p_node, false);842if (I) {843if (p_node->is_inside_tree() && p_node->can_process() != I->value.can_process) {844// All our children also change process mode.845node_cache.mark_children_dirty(p_node, true);846}847}848849_update_if_clean();850}851852void SceneTreeEditor::_node_added(Node *p_node) {853if (!get_scene_node()) {854return;855}856857if (p_node != get_scene_node() && !get_scene_node()->is_ancestor_of(p_node)) {858return;859}860861node_cache.mark_dirty(p_node);862_update_if_clean();863}864865void SceneTreeEditor::_node_removed(Node *p_node) {866if (EditorNode::get_singleton()->is_exiting()) {867return; // Speed up exit.868}869870if (EditorNode::get_singleton()->is_changing_scene()) {871return; // Switching tabs we will be destroying node cache anyway.872}873874if (!get_scene_node()) {875return;876}877878if (p_node != get_scene_node() && !get_scene_node()->is_ancestor_of(p_node)) {879return;880}881882node_cache.remove(p_node);883_update_if_clean();884}885886void SceneTreeEditor::_node_renamed(Node *p_node) {887if (!get_scene_node()) {888return;889}890891if (p_node != get_scene_node() && !get_scene_node()->is_ancestor_of(p_node)) {892return;893}894895node_cache.mark_dirty(p_node);896// Recursively update child node paths.897_update_node_path(p_node, true);898899emit_signal(SNAME("node_renamed"));900901_update_if_clean();902}903904void SceneTreeEditor::_update_tree(bool p_scroll_to_selected) {905if (!is_inside_tree()) {906tree_dirty = false;907return;908}909910Node *scene_node = get_scene_node();911912if (node_cache.current_scene_node != scene_node) {913_reset();914marked.clear();915node_cache.current_scene_node = scene_node;916node_cache.force_update = true;917}918919if (!update_when_invisible && !is_visible_in_tree()) {920return;921}922923if (tree->is_editing()) {924return;925}926927updating_tree = true;928929last_hash = hash_djb2_one_64(0);930931if (node_cache.current_scene_node) {932// Handle pinning/unpinning the animation player only do this once per iteration.933Node *pinned_node = AnimationPlayerEditor::get_singleton()->get_editing_node();934// If pinned state changed, update the currently pinned node.935if (AnimationPlayerEditor::get_singleton()->is_pinned() != node_cache.current_has_pin) {936node_cache.current_has_pin = AnimationPlayerEditor::get_singleton()->is_pinned();937if (node_cache.has(pinned_node)) {938node_cache.mark_dirty(pinned_node);939}940}941// If the current pinned node changed update both the old and new node.942if (node_cache.current_pinned_node != pinned_node) {943// get_editing_node() will return deleted nodes. If the nodes are not in cache don't try to mark them.944if (node_cache.has(pinned_node)) {945node_cache.mark_dirty(pinned_node);946}947if (node_cache.has(node_cache.current_pinned_node)) {948node_cache.mark_dirty(node_cache.current_pinned_node);949}950node_cache.current_pinned_node = pinned_node;951}952953_update_node_subtree(get_scene_node(), nullptr, node_cache.force_update);954_compute_hash(get_scene_node(), last_hash);955956node_cache.delete_pending();957}958959updating_tree = false;960tree_dirty = false;961node_cache.force_update = false;962963if (!filter.strip_edges().is_empty() || !show_all_nodes) {964_update_filter(nullptr, p_scroll_to_selected);965}966}967968bool SceneTreeEditor::_update_filter(TreeItem *p_parent, bool p_scroll_to_selected) {969if (!p_parent) {970p_parent = tree->get_root();971filter_term_warning.clear();972}973974if (!p_parent) {975// Tree is empty, nothing to do here.976return false;977}978979// Now find other reasons to keep this Node, too.980PackedStringArray terms = filter.to_lower().split_spaces();981bool keep = _item_matches_all_terms(p_parent, terms);982983bool selectable = keep;984bool is_root = p_parent == tree->get_root();985986if (keep) {987Node *n = get_node(p_parent->get_metadata(0));988if (!p_parent->is_visible() || (is_root && tree->is_root_hidden())) {989// Place back moved out children from when this item has hidden.990HashMap<Node *, CachedNode>::Iterator I = node_cache.get(n, false);991if (I && I->value.has_moved_children) {992_update_node_subtree(I->value.node, nullptr, true);993}994}995996if (!valid_types.is_empty()) {997selectable = false;998for (const StringName &E : valid_types) {999if (n->is_class(E) ||1000EditorNode::get_singleton()->is_object_of_custom_type(n, E)) {1001selectable = true;1002break;1003} else {1004Ref<Script> node_script = n->get_script();1005while (node_script.is_valid()) {1006if (node_script->get_path() == E) {1007selectable = true;1008break;1009}1010node_script = node_script->get_base_script();1011}1012if (selectable) {1013break;1014}1015}1016}1017}1018}10191020bool keep_for_children = false;1021for (TreeItem *child = p_parent->get_first_child(); child; child = child->get_next()) {1022// Always keep if at least one of the children are kept.1023keep_for_children = _update_filter(child, p_scroll_to_selected) || keep_for_children;1024}10251026if (!is_root) {1027if (show_all_nodes) {1028p_parent->set_visible(keep_for_children || keep);1029} else {1030// Show only selectable nodes, or parents of selectable.1031p_parent->set_visible(keep_for_children || selectable);1032}1033}10341035if (selectable) {1036Color custom_color = p_parent->get_meta(SNAME("custom_color"), Color(0, 0, 0, 0));1037if (custom_color == Color(0, 0, 0, 0)) {1038p_parent->clear_custom_color(0);1039} else {1040p_parent->set_custom_color(0, custom_color);1041}10421043p_parent->set_selectable(0, true);1044} else if (keep_for_children) {1045p_parent->set_visible(!hide_filtered_out_parents || is_root);10461047if (!p_parent->is_visible()) {1048TreeItem *filtered_parent = p_parent->get_parent();1049while (filtered_parent) {1050if (filtered_parent == tree->get_root() || (filtered_parent->is_selectable(0) && filtered_parent->is_visible())) {1051break;1052}1053filtered_parent = filtered_parent->get_parent();1054}10551056if (filtered_parent) {1057for (Variant &item : p_parent->get_children()) {1058TreeItem *ti = Object::cast_to<TreeItem>(item);1059bool is_selected = ti->is_selected(0);10601061p_parent->remove_child(ti);1062filtered_parent->add_child(ti);1063TreeItem *prev = p_parent->get_prev();1064if (prev) {1065ti->move_after(prev);1066}10671068if (is_selected) {1069ti->select(0);1070}10711072HashMap<Node *, CachedNode>::Iterator I = node_cache.get(get_node(p_parent->get_metadata(0)), false);1073if (I) {1074I->value.has_moved_children = true;1075}1076}10771078return false;1079}1080} else {1081p_parent->set_custom_color(0, get_theme_color(SNAME("font_disabled_color"), EditorStringName(Editor)));1082p_parent->set_selectable(0, false);1083p_parent->deselect(0);1084}1085}1086if (is_root) {1087tree->set_hide_root(hide_filtered_out_parents && !selectable);1088if (tree->is_root_hidden()) {1089p_parent->set_collapsed(false);1090}1091}10921093if (editor_selection) {1094Node *n = get_node(p_parent->get_metadata(0));1095if (selectable) {1096if (p_scroll_to_selected && n && editor_selection->is_selected(n)) {1097// Needs to be deferred to account for possible root visibility change.1098callable_mp(tree, &Tree::scroll_to_item).call_deferred(p_parent, false);1099}1100} else if (n) {1101editor_selection->remove_node(n);1102p_parent->deselect(0);1103}1104}11051106return p_parent->is_visible();1107}11081109bool SceneTreeEditor::_node_matches_class_term(const Node *p_item_node, const String &p_term) {1110if (p_term.is_empty()) {1111// Defend against https://github.com/godotengine/godot/issues/824731112return true;1113}1114Ref<Script> item_script = p_item_node->get_script();1115while (item_script.is_valid()) {1116String global_name = item_script->get_global_name();1117if (global_name.to_lower().contains(p_term)) {1118return true;1119}1120item_script = item_script->get_base_script();1121}11221123String type = p_item_node->get_class();1124// Every Node is a Node, duh!1125while (type != "Node") {1126if (type.to_lower().contains(p_term)) {1127return true;1128}11291130type = ClassDB::get_parent_class(type);1131}11321133return false;1134}11351136bool SceneTreeEditor::_item_matches_all_terms(TreeItem *p_item, const PackedStringArray &p_terms) {1137if (p_terms.is_empty()) {1138return true;1139}11401141for (int i = 0; i < p_terms.size(); i++) {1142const String &term = p_terms[i];11431144// Recognize special filter.1145if (term.contains_char(':') && !term.get_slicec(':', 0).is_empty()) {1146String parameter = term.get_slicec(':', 0);1147String argument = term.get_slicec(':', 1);11481149if (parameter == "type" || parameter == "t") {1150// Filter by Type.1151Node *item_node = get_node(p_item->get_metadata(0));1152if (!_node_matches_class_term(item_node, argument)) {1153return false;1154}1155} else if (parameter == "group" || parameter == "g") {1156// Filter by Group.1157Node *node = get_node(p_item->get_metadata(0));11581159if (argument.is_empty()) {1160// When argument is empty, match all Nodes belonging to any exposed group.1161if (node->get_persistent_group_count() == 0) {1162return false;1163}1164} else {1165List<Node::GroupInfo> group_info_list;1166node->get_groups(&group_info_list);11671168bool term_in_groups = false;1169for (const Node::GroupInfo &group_info : group_info_list) {1170if (!group_info.persistent) {1171continue; // Ignore internal groups.1172}1173if (String(group_info.name).to_lower().contains(argument)) {1174term_in_groups = true;1175break;1176}1177}1178if (!term_in_groups) {1179return false;1180}1181}1182} else if (filter_term_warning.is_empty()) {1183filter_term_warning = vformat(TTR("\"%s\" is not a known filter."), parameter);1184continue;1185}1186} else {1187// Default.1188if (!p_item->get_text(0).to_lower().contains(term)) {1189return false;1190}1191}1192}11931194return true;1195}11961197void SceneTreeEditor::_compute_hash(Node *p_node, uint64_t &hash) {1198// Nodes are added and removed by Node* pointers.1199hash = hash_djb2_one_64((ptrdiff_t)p_node, hash);1200// This hash is non-commutative: if the node order changes so will the hash.1201for (int i = 0; i < p_node->get_child_count(); i++) {1202_compute_hash(p_node->get_child(i), hash);1203}1204}12051206void SceneTreeEditor::_reset() {1207// Stop any waiting change to tooltip.1208update_node_tooltip_delay->stop();12091210tree->clear();1211node_cache.clear();1212}12131214void SceneTreeEditor::_test_update_tree() {1215pending_test_update = false;12161217if (!is_inside_tree()) {1218return;1219}12201221if (tree_dirty) {1222return; // Don't even bother.1223}12241225uint64_t hash = hash_djb2_one_64(0);1226if (get_scene_node()) {1227_compute_hash(get_scene_node(), hash);1228}12291230// Test hash.1231if (hash == last_hash) {1232return; // Did not change.1233}12341235_update_if_clean();1236}12371238void SceneTreeEditor::_tree_process_mode_changed() {1239callable_mp(this, &SceneTreeEditor::_update_tree).call_deferred(false);1240tree_dirty = true;1241}12421243void SceneTreeEditor::_tree_changed() {1244if (EditorNode::get_singleton()->is_exiting()) {1245return; // Speed up exit.1246}12471248if (pending_test_update) {1249return;1250}12511252if (tree_dirty) {1253return;1254}12551256callable_mp(this, &SceneTreeEditor::_test_update_tree).call_deferred();1257pending_test_update = true;1258}12591260void SceneTreeEditor::_selected_changed() {1261TreeItem *s = tree->get_selected();1262ERR_FAIL_NULL(s);1263NodePath np = s->get_metadata(0);12641265Node *n = get_node(np);12661267if (n == selected) {1268return;1269}12701271selected = n;12721273blocked++;1274emit_signal(SNAME("node_selected"));1275blocked--;1276}12771278void SceneTreeEditor::_deselect_items() {1279// Clear currently selected items in scene tree dock.1280if (editor_selection) {1281editor_selection->clear();1282emit_signal(SNAME("node_changed"));1283}1284}12851286void SceneTreeEditor::_cell_multi_selected(Object *p_object, int p_cell, bool p_selected) {1287TreeItem *item = Object::cast_to<TreeItem>(p_object);1288ERR_FAIL_NULL(item);12891290if (!item->is_visible()) {1291return;1292}12931294NodePath np = item->get_metadata(0);12951296Node *n = get_node(np);12971298if (!n) {1299return;1300}13011302if (!editor_selection) {1303return;1304}13051306if (p_selected) {1307editor_selection->add_node(n);13081309} else {1310editor_selection->remove_node(n);1311}13121313// Emitted "selected" in _selected_changed() when select single node, so select multiple node emit "changed".1314if (editor_selection->get_selected_nodes().size() > 1) {1315emit_signal(SNAME("node_changed"));1316}1317}13181319void SceneTreeEditor::_tree_scroll_to_item(ObjectID p_item_id) {1320ERR_FAIL_NULL(tree);1321TreeItem *item = ObjectDB::get_instance<TreeItem>(p_item_id);1322if (item) {1323tree->scroll_to_item(item, true);1324}1325}13261327void SceneTreeEditor::_notification(int p_what) {1328switch (p_what) {1329case NOTIFICATION_ENTER_TREE: {1330get_tree()->connect("tree_changed", callable_mp(this, &SceneTreeEditor::_tree_changed));1331get_tree()->connect("tree_process_mode_changed", callable_mp(this, &SceneTreeEditor::_tree_process_mode_changed));1332get_tree()->connect("node_added", callable_mp(this, &SceneTreeEditor::_node_added));1333get_tree()->connect("node_removed", callable_mp(this, &SceneTreeEditor::_node_removed));1334get_tree()->connect("node_renamed", callable_mp(this, &SceneTreeEditor::_node_renamed));1335get_tree()->connect(SceneStringName(node_configuration_warning_changed), callable_mp(this, &SceneTreeEditor::_warning_changed));13361337tree->connect("item_collapsed", callable_mp(this, &SceneTreeEditor::_cell_collapsed));13381339_update_tree();1340} break;13411342case NOTIFICATION_EXIT_TREE: {1343get_tree()->disconnect("tree_changed", callable_mp(this, &SceneTreeEditor::_tree_changed));1344get_tree()->disconnect("tree_process_mode_changed", callable_mp(this, &SceneTreeEditor::_tree_process_mode_changed));1345get_tree()->disconnect("node_added", callable_mp(this, &SceneTreeEditor::_node_added));1346get_tree()->disconnect("node_removed", callable_mp(this, &SceneTreeEditor::_node_removed));1347get_tree()->disconnect("node_renamed", callable_mp(this, &SceneTreeEditor::_node_renamed));1348tree->disconnect("item_collapsed", callable_mp(this, &SceneTreeEditor::_cell_collapsed));1349get_tree()->disconnect(SceneStringName(node_configuration_warning_changed), callable_mp(this, &SceneTreeEditor::_warning_changed));1350} break;13511352case NOTIFICATION_THEME_CHANGED: {1353tree->add_theme_constant_override("icon_max_width", get_theme_constant(SNAME("class_icon_size"), EditorStringName(Editor)));1354[[fallthrough]];1355}1356case NOTIFICATION_TRANSLATION_CHANGED: {1357// When we change theme or translation we need to re-do everything.1358_reset();1359_update_tree();1360} break;13611362case NOTIFICATION_VISIBILITY_CHANGED: {1363if (is_visible()) {1364TreeItem *item = nullptr;1365if (selected) {1366// Scroll to selected node.1367item = _find(tree->get_root(), selected->get_path());1368} else if (marked.size() == 1) {1369// Scroll to a single marked node.1370Node *marked_node = *marked.begin();1371if (marked_node) {1372item = _find(tree->get_root(), marked_node->get_path());1373}1374}13751376bool has_item = item;13771378if (update_when_invisible) {1379if (has_item) {1380ObjectID item_id = item->get_instance_id();1381callable_mp(this, &SceneTreeEditor::_tree_scroll_to_item).call_deferred(item_id);1382}1383} else {1384callable_mp(this, &SceneTreeEditor::_update_tree).call_deferred(has_item);1385}1386}1387} break;1388}1389}13901391TreeItem *SceneTreeEditor::_find(TreeItem *p_node, const NodePath &p_path) {1392if (!p_node) {1393return nullptr;1394}13951396NodePath np = p_node->get_metadata(0);1397if (np == p_path) {1398return p_node;1399}14001401TreeItem *children = p_node->get_first_child();1402while (children) {1403TreeItem *n = _find(children, p_path);1404if (n) {1405return n;1406}1407children = children->get_next();1408}14091410return nullptr;1411}14121413void SceneTreeEditor::set_selected(Node *p_node, bool p_emit_selected) {1414ERR_FAIL_COND(blocked > 0);14151416if (pending_test_update) {1417_test_update_tree();1418}14191420if (tree_dirty) {1421_update_tree();1422}14231424if (selected == p_node) {1425return;1426}14271428TreeItem *item = p_node ? _find(tree->get_root(), p_node->get_path()) : nullptr;14291430if (item) {1431selected = p_node;1432if (auto_expand_selected) {1433// Make visible when it's collapsed.1434TreeItem *node = item->get_parent();1435while (node && node != tree->get_root()) {1436node->set_collapsed(false);1437node = node->get_parent();1438}1439item->select(0);1440item->set_as_cursor(0);1441tree->ensure_cursor_is_visible();1442} else {1443// Ensure the node is selected and visible for the user if the node1444// is not collapsed.1445bool collapsed = false;1446TreeItem *node = item;1447while (node && node != tree->get_root()) {1448if (node->is_collapsed()) {1449collapsed = true;1450break;1451}1452node = node->get_parent();1453}1454if (!collapsed) {1455item->select(0);1456item->set_as_cursor(0);1457tree->ensure_cursor_is_visible();1458}1459}1460} else {1461if (!p_node) {1462selected = nullptr;1463}1464selected = p_node;1465}14661467if (p_emit_selected) {1468emit_signal(SNAME("node_selected"));1469}1470}14711472void SceneTreeEditor::rename_node(Node *p_node, const String &p_name, TreeItem *p_item) {1473TreeItem *item;1474if (p_item) {1475item = p_item; // During batch rename the paths may change, so using _find() is unreliable.1476} else {1477item = _find(tree->get_root(), p_node->get_path());1478}1479ERR_FAIL_NULL(item);1480bool check_for_unique_name_token = !p_name.is_empty() && p_name[0] == '%';1481String substr_name = p_name;14821483if (check_for_unique_name_token) {1484substr_name = p_name.substr(1);14851486// No need to do anything else with this if already unique.1487if (p_node->is_unique_name_in_owner()) {1488check_for_unique_name_token = false;1489// Do not set scene root as unique.1490} else if (get_tree()->get_edited_scene_root() == p_node) {1491check_for_unique_name_token = false;1492String text = TTR("Root nodes cannot be accessed as unique names in their own scene. Instantiate in another scene and set as unique name there.");1493if (error->is_visible()) {1494error->set_text(error->get_text() + "\n\n" + text);1495} else {1496error->set_text(text);1497error->popup_centered();1498}1499}1500}15011502String new_name = substr_name.validate_node_name();15031504// If p_name only has "%" at the beginning and no other invalid characters, do not error.1505if (new_name != substr_name) {1506String text = TTR("Invalid node name, the following characters are not allowed:") + "\n" + String::get_invalid_node_name_characters();1507if (error->is_visible()) {1508if (!error->get_meta("invalid_character", false)) {1509error->set_text(error->get_text() + "\n\n" + text);1510error->set_meta("invalid_character", true);1511}1512} else {1513error->set_text(text);1514error->set_meta("invalid_character", true);1515error->set_meta("same_unique_name", false);1516error->popup_centered();1517}1518}15191520// Trim leading/trailing whitespace to prevent node names from containing accidental whitespace,1521// which would make it more difficult to get the node via `get_node()`.1522new_name = new_name.strip_edges();1523if (new_name.is_empty() && p_node->get_owner() != nullptr && !p_node->get_scene_file_path().is_empty()) {1524// If name is empty and node is root of an instance, revert to the original name.1525const Ref<PackedScene> node_scene = ResourceLoader::load(p_node->get_scene_file_path());1526if (node_scene.is_valid()) {1527const Ref<SceneState> &state = node_scene->get_state();1528if (state->get_node_count() > 0) {1529new_name = state->get_node_name(0); // Root's name.1530}1531}1532}15331534if (new_name.is_empty()) {1535// If name is still empty, fallback to class name.1536if (GLOBAL_GET("editor/naming/node_name_casing").operator int() != NAME_CASING_PASCAL_CASE) {1537new_name = Node::adjust_name_casing(p_node->get_class());1538} else {1539new_name = p_node->get_class();1540}1541}15421543new_name = p_node->get_parent()->prevalidate_child_name(p_node, new_name);1544if (new_name == p_node->get_name()) {1545item->set_text(0, new_name);1546// If setting name as unique, check for existing unique node below first.1547if (!check_for_unique_name_token) {1548return;1549}1550}15511552// We previously made sure name is not the same as current name1553// so that it won't complain about already used unique name when not changing name.1554if ((check_for_unique_name_token || p_node->is_unique_name_in_owner()) && get_tree()->get_edited_scene_root()->get_node_or_null("%" + new_name)) {1555check_for_unique_name_token = false;1556String text = vformat(TTR("A node with the unique name %s already exists in this scene."), new_name);1557if (error->is_visible()) {1558if (!error->get_meta("same_unique_name", false)) {1559error->set_text(error->get_text() + "\n\n" + text);1560error->set_meta("same_unique_name", true);1561}1562} else {1563error->set_text(text);1564error->set_meta("same_unique_name", true);1565error->set_meta("invalid_character", false);1566error->popup_centered();1567}1568item->set_text(0, p_node->get_name());1569if (p_node->is_unique_name_in_owner()) {1570return;1571}1572}15731574// If same name and check_for_unique_name_token is still true, now set as unique.1575// This is separate from final action so "Rename Node" is not added to undo history.1576if (new_name == p_node->get_name()) {1577if (check_for_unique_name_token) {1578if (!is_scene_tree_dock) {1579p_node->set_unique_name_in_owner(true);1580} else {1581EditorUndoRedoManager *undo_redo = EditorUndoRedoManager::get_singleton();1582undo_redo->create_action(TTR("Enable Scene Unique Name(s)"));1583undo_redo->add_undo_method(p_node, "set_unique_name_in_owner", false);1584undo_redo->add_do_method(p_node, "set_unique_name_in_owner", true);1585undo_redo->commit_action();1586}1587}1588return;1589}15901591if (!is_scene_tree_dock) {1592p_node->set_name(new_name);1593if (check_for_unique_name_token) {1594p_node->set_unique_name_in_owner(true);1595}1596item->set_metadata(0, p_node->get_path());1597emit_signal(SNAME("node_renamed"));1598} else {1599EditorUndoRedoManager *undo_redo = EditorUndoRedoManager::get_singleton();1600undo_redo->create_action(TTR("Rename Node"), UndoRedo::MERGE_DISABLE, p_node);16011602if (check_for_unique_name_token) {1603undo_redo->add_undo_method(p_node, "set_unique_name_in_owner", false);1604}16051606emit_signal(SNAME("node_prerename"), p_node, new_name);16071608undo_redo->add_undo_method(p_node, "set_name", p_node->get_name());1609undo_redo->add_undo_method(item, "set_metadata", 0, p_node->get_path());1610undo_redo->add_undo_method(item, "set_text", 0, p_node->get_name());16111612undo_redo->add_do_method(p_node, "set_name", new_name);1613undo_redo->add_do_method(item, "set_metadata", 0, p_node->get_path());1614undo_redo->add_do_method(item, "set_text", 0, new_name);16151616if (check_for_unique_name_token) {1617undo_redo->add_do_method(p_node, "set_unique_name_in_owner", true);1618}16191620undo_redo->commit_action();1621}1622}16231624void SceneTreeEditor::_edited() {1625TreeItem *which = tree->get_next_selected(nullptr);1626ERR_FAIL_NULL(which);1627TreeItem *edited = tree->get_edited();1628ERR_FAIL_NULL(edited);16291630if (is_scene_tree_dock && tree->get_next_selected(which)) {1631List<Node *> nodes_to_rename;1632for (TreeItem *item = which; item; item = tree->get_next_selected(item)) {1633Node *n = get_node(item->get_metadata(0));1634ERR_FAIL_NULL(n);1635nodes_to_rename.push_back(n);1636}1637ERR_FAIL_COND(nodes_to_rename.is_empty());16381639EditorUndoRedoManager *undo_redo = EditorUndoRedoManager::get_singleton();1640undo_redo->create_action(TTR("Rename Nodes"), UndoRedo::MERGE_DISABLE, nodes_to_rename.front()->get(), true);16411642TreeItem *item = which;1643String new_name = edited->get_text(0);1644for (Node *n : nodes_to_rename) {1645rename_node(n, new_name, item);1646item = tree->get_next_selected(item);1647}16481649undo_redo->commit_action();1650} else {1651Node *n = get_node(which->get_metadata(0));1652ERR_FAIL_NULL(n);1653rename_node(n, which->get_text(0));1654}1655}16561657Node *SceneTreeEditor::get_selected() {1658return selected;1659}16601661void SceneTreeEditor::_update_marking_list(const HashSet<Node *> &p_marked) {1662for (Node *N : p_marked) {1663HashMap<Node *, CachedNode>::Iterator I = node_cache.get(N);1664if (I) {1665node_cache.mark_dirty(N);1666node_cache.mark_children_dirty(N, true);1667}1668}1669}16701671void SceneTreeEditor::set_marked(const HashSet<Node *> &p_marked, bool p_selectable, bool p_children_selectable) {1672_update_if_clean();16731674_update_marking_list(marked);1675_update_marking_list(p_marked);16761677marked = p_marked;16781679marked_selectable = p_selectable;1680marked_children_selectable = p_children_selectable;1681_update_tree();1682}16831684void SceneTreeEditor::set_marked(Node *p_marked, bool p_selectable, bool p_children_selectable) {1685HashSet<Node *> s;1686if (p_marked) {1687s.insert(p_marked);1688}1689set_marked(s, p_selectable, p_children_selectable);1690}16911692void SceneTreeEditor::set_filter(const String &p_filter) {1693filter = p_filter;1694_update_filter(nullptr, true);1695}16961697String SceneTreeEditor::get_filter() const {1698return filter;1699}17001701String SceneTreeEditor::get_filter_term_warning() {1702return filter_term_warning;1703}17041705void SceneTreeEditor::set_show_all_nodes(bool p_show_all_nodes) {1706show_all_nodes = p_show_all_nodes;1707_update_filter(nullptr, true);1708}17091710void SceneTreeEditor::set_as_scene_tree_dock() {1711is_scene_tree_dock = true;1712}17131714void SceneTreeEditor::set_display_foreign_nodes(bool p_display) {1715display_foreign = p_display;1716_update_tree();1717}17181719void SceneTreeEditor::set_valid_types(const Vector<StringName> &p_valid) {1720valid_types = p_valid;1721node_cache.force_update = true;1722callable_mp(this, &SceneTreeEditor::_update_tree).call_deferred(false);1723tree_dirty = true;1724}17251726void SceneTreeEditor::set_editor_selection(EditorSelection *p_selection) {1727editor_selection = p_selection;1728tree->set_select_mode(Tree::SELECT_MULTI);1729tree->set_cursor_can_exit_tree(false);1730editor_selection->connect("selection_changed", callable_mp(this, &SceneTreeEditor::_selection_changed));1731}17321733void SceneTreeEditor::_update_selection(TreeItem *item) {1734ERR_FAIL_NULL(item);17351736NodePath np = item->get_metadata(0);17371738if (!has_node(np)) {1739return;1740}17411742Node *n = get_node(np);17431744if (!n) {1745return;1746}17471748if (editor_selection->is_selected(n)) {1749if (!item->is_selected(0)) {1750item->select(0);1751}1752} else {1753if (item->is_selected(0)) {1754TreeItem *previous_cursor_item = tree->get_selected();1755item->deselect(0);1756if (previous_cursor_item) {1757previous_cursor_item->set_as_cursor(0);1758}1759}1760}17611762TreeItem *c = item->get_first_child();17631764while (c) {1765_update_selection(c);1766c = c->get_next();1767}1768}17691770void SceneTreeEditor::_selection_changed() {1771if (!editor_selection) {1772return;1773}17741775TreeItem *root = tree->get_root();17761777if (!root) {1778return;1779}1780_update_selection(root);1781}17821783void SceneTreeEditor::_cell_collapsed(Object *p_obj) {1784if (updating_tree) {1785return;1786}1787if (!can_rename) {1788return;1789}17901791TreeItem *ti = Object::cast_to<TreeItem>(p_obj);1792if (!ti) {1793return;1794}17951796bool collapsed = ti->is_collapsed();17971798NodePath np = ti->get_metadata(0);17991800Node *n = get_node(np);1801ERR_FAIL_NULL(n);18021803n->set_display_folded(collapsed);1804}18051806Variant SceneTreeEditor::get_drag_data_fw(const Point2 &p_point, Control *p_from) {1807if (!can_rename) {1808return Variant(); // Not editable tree.1809}18101811if (tree->get_button_id_at_position(p_point) != -1) {1812return Variant(); // Dragging from button.1813}18141815Vector<Node *> selected_nodes;1816Vector<Ref<Texture2D>> icons;1817TreeItem *next = tree->get_next_selected(nullptr);1818while (next) {1819NodePath np = next->get_metadata(0);18201821Node *n = get_node(np);1822if (n) {1823selected_nodes.push_back(n);1824icons.push_back(next->get_icon(0));1825}1826next = tree->get_next_selected(next);1827}18281829if (selected_nodes.is_empty()) {1830return Variant();1831}18321833VBoxContainer *vb = memnew(VBoxContainer);1834Array objs;1835int list_max = 10;1836float opacity_step = 1.0f / list_max;1837float opacity_item = 1.0f;1838for (int i = 0; i < selected_nodes.size(); i++) {1839if (i < list_max) {1840HBoxContainer *hb = memnew(HBoxContainer);1841TextureRect *tf = memnew(TextureRect);1842int icon_size = get_theme_constant(SNAME("class_icon_size"), EditorStringName(Editor));1843tf->set_custom_minimum_size(Size2(icon_size, icon_size));1844tf->set_stretch_mode(TextureRect::STRETCH_KEEP_ASPECT_CENTERED);1845tf->set_expand_mode(TextureRect::EXPAND_IGNORE_SIZE);1846tf->set_texture(icons[i]);1847hb->add_child(tf);1848Label *label = memnew(Label(selected_nodes[i]->get_name()));1849label->set_auto_translate_mode(AUTO_TRANSLATE_MODE_DISABLED);1850hb->add_child(label);1851vb->add_child(hb);1852hb->set_modulate(Color(1, 1, 1, opacity_item));1853opacity_item -= opacity_step;1854}1855NodePath p = selected_nodes[i]->get_path();1856objs.push_back(p);1857}18581859set_drag_preview(vb);1860Dictionary drag_data;1861drag_data["type"] = "nodes";1862drag_data["nodes"] = objs;18631864tree->set_drop_mode_flags(Tree::DROP_MODE_INBETWEEN | Tree::DROP_MODE_ON_ITEM);1865emit_signal(SNAME("nodes_dragged"));18661867return drag_data;1868}18691870bool SceneTreeEditor::_is_script_type(const StringName &p_type) const {1871return (script_types->has(p_type));1872}18731874bool SceneTreeEditor::can_drop_data_fw(const Point2 &p_point, const Variant &p_data, Control *p_from) const {1875if (!can_rename) {1876return false; // Not editable tree.1877}18781879Dictionary d = p_data;1880if (!d.has("type")) {1881return false;1882}18831884TreeItem *item = (p_point == Vector2(Math::INF, Math::INF)) ? tree->get_selected() : tree->get_item_at_position(p_point);1885if (!item) {1886return false;1887}18881889int section = (p_point == Vector2(Math::INF, Math::INF)) ? tree->get_drop_section_at_position(tree->get_item_rect(item).position) : tree->get_drop_section_at_position(p_point);1890if (section < -1 || (section == -1 && !item->get_parent())) {1891return false;1892}18931894if (String(d["type"]) == "files") {1895Vector<String> files = d["files"];18961897if (files.is_empty()) {1898return false; // TODO Weird?1899}19001901if (_is_script_type(EditorFileSystem::get_singleton()->get_file_type(files[0]))) {1902tree->set_drop_mode_flags(Tree::DROP_MODE_ON_ITEM);1903return true;1904}19051906bool scene_drop = true;1907bool audio_drop = true;1908for (int i = 0; i < files.size(); i++) {1909String ftype = EditorFileSystem::get_singleton()->get_file_type(files[i]);1910if (ftype != "PackedScene") {1911scene_drop = false;1912}1913if (audio_drop && !ClassDB::is_parent_class(ftype, "AudioStream")) {1914audio_drop = false;1915}1916}19171918if (scene_drop) {1919tree->set_drop_mode_flags(Tree::DROP_MODE_INBETWEEN | Tree::DROP_MODE_ON_ITEM);1920return true;1921}19221923if (audio_drop) {1924if (files.size() > 1) {1925tree->set_drop_mode_flags(Tree::DROP_MODE_INBETWEEN);1926} else {1927tree->set_drop_mode_flags(Tree::DROP_MODE_INBETWEEN | Tree::DROP_MODE_ON_ITEM);1928}1929return true;1930}19311932if (files.size() > 1) {1933return false;1934}1935tree->set_drop_mode_flags(Tree::DROP_MODE_ON_ITEM);19361937return true;1938}19391940if (String(d["type"]) == "script_list_element") {1941ScriptEditorBase *se = Object::cast_to<ScriptEditorBase>(d["script_list_element"]);1942if (se) {1943String sp = se->get_edited_resource()->get_path();1944if (_is_script_type(EditorFileSystem::get_singleton()->get_file_type(sp))) {1945tree->set_drop_mode_flags(Tree::DROP_MODE_ON_ITEM);1946return true;1947}1948}1949}19501951if (filter.is_empty() && String(d["type"]) == "nodes") {1952Array nodes = d["nodes"];19531954for (int i = 0; i < nodes.size(); i++) {1955Node *n = get_node(nodes[i]);1956// Nodes from an instantiated scene can't be rearranged.1957if (n && n->get_owner() && n->get_owner() != get_scene_node() && !n->get_owner()->get_scene_file_path().is_empty()) {1958return false;1959}1960}19611962return true;1963}19641965return false;1966}19671968void SceneTreeEditor::drop_data_fw(const Point2 &p_point, const Variant &p_data, Control *p_from) {1969if (!can_drop_data_fw(p_point, p_data, p_from)) {1970return;1971}19721973TreeItem *item = (p_point == Vector2(Math::INF, Math::INF)) ? tree->get_selected() : tree->get_item_at_position(p_point);1974if (!item) {1975return;1976}1977int section = (p_point == Vector2(Math::INF, Math::INF)) ? tree->get_drop_section_at_position(tree->get_item_rect(item).position) : tree->get_drop_section_at_position(p_point);1978if (section < -1) {1979return;1980}19811982NodePath np = item->get_metadata(0);1983Node *n = get_node(np);1984if (!n) {1985return;1986}19871988Dictionary d = p_data;19891990if (String(d["type"]) == "nodes") {1991Array nodes = d["nodes"];1992emit_signal(SNAME("nodes_rearranged"), nodes, np, section);1993}19941995if (String(d["type"]) == "files") {1996Vector<String> files = d["files"];19971998String ftype = EditorFileSystem::get_singleton()->get_file_type(files[0]);1999if (_is_script_type(ftype)) {2000emit_signal(SNAME("script_dropped"), files[0], np);2001} else {2002emit_signal(SNAME("files_dropped"), files, np, section);2003}2004}20052006if (String(d["type"]) == "script_list_element") {2007ScriptEditorBase *se = Object::cast_to<ScriptEditorBase>(d["script_list_element"]);2008if (se) {2009String sp = se->get_edited_resource()->get_path();2010if (_is_script_type(EditorFileSystem::get_singleton()->get_file_type(sp))) {2011emit_signal(SNAME("script_dropped"), sp, np);2012}2013}2014}2015}20162017void SceneTreeEditor::_empty_clicked(const Vector2 &p_pos, MouseButton p_button) {2018if (p_button != MouseButton::RIGHT) {2019return;2020}2021_rmb_select(p_pos);2022}20232024void SceneTreeEditor::_rmb_select(const Vector2 &p_pos, MouseButton p_button) {2025if (p_button != MouseButton::RIGHT) {2026return;2027}2028emit_signal(SNAME("rmb_pressed"), tree->get_screen_position() + p_pos);2029}20302031void SceneTreeEditor::update_warning() {2032_warning_changed(nullptr);2033}20342035void SceneTreeEditor::_warning_changed(Node *p_for_node) {2036node_cache.mark_dirty(p_for_node);20372038// Should use a timer.2039update_timer->start();2040}20412042void SceneTreeEditor::set_auto_expand_selected(bool p_auto, bool p_update_settings) {2043if (p_update_settings) {2044EditorSettings::get_singleton()->set("docks/scene_tree/auto_expand_to_selected", p_auto);2045}2046auto_expand_selected = p_auto;2047}20482049void SceneTreeEditor::set_hide_filtered_out_parents(bool p_hide, bool p_update_settings) {2050if (p_hide == hide_filtered_out_parents) {2051return;2052}20532054if (p_update_settings) {2055EditorSettings::get_singleton()->set("docks/scene_tree/hide_filtered_out_parents", p_hide);2056}2057hide_filtered_out_parents = p_hide;20582059if (hide_filtered_out_parents) {2060_update_filter();2061} else {2062node_cache.force_update = true;2063_update_tree();2064}2065}20662067void SceneTreeEditor::set_accessibility_warnings(bool p_enable, bool p_update_settings) {2068if (p_update_settings) {2069EditorSettings::get_singleton()->set("docks/scene_tree/accessibility_warnings", p_enable);2070}2071accessibility_warnings = p_enable;2072}20732074void SceneTreeEditor::set_connect_to_script_mode(bool p_enable) {2075connect_to_script_mode = p_enable;2076_update_tree();2077}20782079void SceneTreeEditor::set_connecting_signal(bool p_enable) {2080connecting_signal = p_enable;2081_update_tree();2082}20832084void SceneTreeEditor::set_update_when_invisible(bool p_enable) {2085update_when_invisible = p_enable;2086_update_tree();2087}20882089void SceneTreeEditor::_bind_methods() {2090ClassDB::bind_method(D_METHOD("_update_tree"), &SceneTreeEditor::_update_tree, DEFVAL(false)); // Still used by UndoRedo.20912092ClassDB::bind_method(D_METHOD("update_tree"), &SceneTreeEditor::update_tree);20932094ADD_SIGNAL(MethodInfo("node_selected"));2095ADD_SIGNAL(MethodInfo("node_renamed"));2096ADD_SIGNAL(MethodInfo("node_prerename"));2097ADD_SIGNAL(MethodInfo("node_changed"));2098ADD_SIGNAL(MethodInfo("nodes_dragged"));2099ADD_SIGNAL(MethodInfo("nodes_rearranged", PropertyInfo(Variant::ARRAY, "paths"), PropertyInfo(Variant::NODE_PATH, "to_path"), PropertyInfo(Variant::INT, "type")));2100ADD_SIGNAL(MethodInfo("files_dropped", PropertyInfo(Variant::PACKED_STRING_ARRAY, "files"), PropertyInfo(Variant::NODE_PATH, "to_path"), PropertyInfo(Variant::INT, "type")));2101ADD_SIGNAL(MethodInfo("script_dropped", PropertyInfo(Variant::STRING, "file"), PropertyInfo(Variant::NODE_PATH, "to_path")));2102ADD_SIGNAL(MethodInfo("rmb_pressed", PropertyInfo(Variant::VECTOR2, "position")));21032104ADD_SIGNAL(MethodInfo("open"));2105ADD_SIGNAL(MethodInfo("open_script"));2106}21072108SceneTreeEditor::SceneTreeEditor(bool p_label, bool p_can_rename, bool p_can_open_instance) :2109node_cache(this) {2110selected = nullptr;21112112can_rename = p_can_rename;2113can_open_instance = p_can_open_instance;2114editor_selection = nullptr;21152116if (p_label) {2117Label *label = memnew(Label);2118label->set_theme_type_variation("HeaderSmall");2119label->set_position(Point2(10, 0));2120label->set_text(TTR("Scene Tree (Nodes):"));21212122add_child(label);2123}21242125tree = memnew(Tree);2126tree->set_auto_translate_mode(AUTO_TRANSLATE_MODE_DISABLED);2127tree->set_anchor(SIDE_RIGHT, ANCHOR_END);2128tree->set_anchor(SIDE_BOTTOM, ANCHOR_END);2129tree->set_begin(Point2(0, p_label ? 18 : 0));2130tree->set_end(Point2(0, 0));2131tree->set_allow_reselect(true);2132tree->add_theme_constant_override("button_margin", 0);21332134add_child(tree);21352136SET_DRAG_FORWARDING_GCD(tree, SceneTreeEditor);2137if (p_can_rename) {2138tree->set_allow_rmb_select(true);2139tree->connect("item_mouse_selected", callable_mp(this, &SceneTreeEditor::_rmb_select));2140tree->connect("empty_clicked", callable_mp(this, &SceneTreeEditor::_empty_clicked));2141}21422143tree->connect("cell_selected", callable_mp(this, &SceneTreeEditor::_selected_changed));2144tree->connect("item_edited", callable_mp(this, &SceneTreeEditor::_edited));2145tree->connect("multi_selected", callable_mp(this, &SceneTreeEditor::_cell_multi_selected));2146tree->connect("button_clicked", callable_mp(this, &SceneTreeEditor::_cell_button_pressed));2147tree->connect("nothing_selected", callable_mp(this, &SceneTreeEditor::_deselect_items));21482149error = memnew(AcceptDialog);2150add_child(error);21512152warning = memnew(AcceptDialog);2153add_child(warning);2154warning->set_title(TTR("Node Configuration Warning!"));2155warning->set_flag(Window::FLAG_POPUP, true);21562157last_hash = 0;2158blocked = 0;21592160update_timer = memnew(Timer);2161update_timer->connect("timeout", callable_mp(this, &SceneTreeEditor::_update_tree).bind(false));2162update_timer->set_one_shot(true);2163update_timer->set_wait_time(0.5);2164add_child(update_timer);21652166update_node_tooltip_delay = memnew(Timer);2167update_node_tooltip_delay->set_wait_time(0.5);2168update_node_tooltip_delay->set_one_shot(true);2169add_child(update_node_tooltip_delay);21702171revoke_dialog = memnew(ConfirmationDialog);2172revoke_dialog->set_ok_button_text(TTR("Revoke"));2173add_child(revoke_dialog);2174revoke_dialog->connect(SceneStringName(confirmed), callable_mp(this, &SceneTreeEditor::_update_ask_before_revoking_unique_name));2175VBoxContainer *vb = memnew(VBoxContainer);2176revoke_dialog->add_child(vb);2177revoke_dialog_label = memnew(Label);2178revoke_dialog_label->set_focus_mode(Control::FOCUS_ACCESSIBILITY);2179vb->add_child(revoke_dialog_label);2180ask_before_revoke_checkbox = memnew(CheckBox(TTR("Don't Ask Again")));2181ask_before_revoke_checkbox->set_tooltip_text(TTR("This dialog can also be enabled/disabled in the Editor Settings: Docks > Scene Tree > Ask Before Revoking Unique Name."));2182vb->add_child(ask_before_revoke_checkbox);21832184script_types = memnew(LocalVector<StringName>);2185ClassDB::get_inheriters_from_class("Script", *script_types);2186}21872188SceneTreeEditor::~SceneTreeEditor() {2189memdelete(script_types);2190}21912192/******** DIALOG *********/21932194void SceneTreeDialog::popup_scenetree_dialog(Node *p_selected_node, Node *p_marked_node, bool p_marked_node_selectable, bool p_marked_node_children_selectable) {2195get_scene_tree()->set_marked(p_marked_node, p_marked_node_selectable, p_marked_node_children_selectable);2196get_scene_tree()->set_selected(p_selected_node);2197popup_centered_clamped(Size2(350, 700) * EDSCALE);2198}21992200void SceneTreeDialog::_show_all_nodes_changed(bool p_button_pressed) {2201EditorSettings::get_singleton()->set_project_metadata("editor_metadata", "show_all_nodes_for_node_selection", p_button_pressed);2202tree->set_show_all_nodes(p_button_pressed);2203}22042205void SceneTreeDialog::set_valid_types(const Vector<StringName> &p_valid) {2206if (allowed_types_hbox) {2207allowed_types_hbox->queue_free();2208allowed_types_hbox = nullptr;2209valid_type_icons.clear();2210}22112212tree->set_valid_types(p_valid);22132214if (p_valid.is_empty()) {2215return;2216}22172218allowed_types_hbox = memnew(HBoxContainer);2219content->add_child(allowed_types_hbox);2220content->move_child(allowed_types_hbox, 0);22212222{2223Label *label = memnew(Label);2224allowed_types_hbox->add_child(label);2225label->set_text(TTR("Allowed:"));2226}22272228HFlowContainer *hflow = memnew(HFlowContainer);2229allowed_types_hbox->add_child(hflow);2230hflow->set_h_size_flags(Control::SIZE_EXPAND_FILL);22312232for (const StringName &type : p_valid) {2233HBoxContainer *hb = memnew(HBoxContainer);2234hflow->add_child(hb);22352236// Attempt to get the correct name and icon for script path types.2237String name = type;2238Ref<Texture2D> icon = EditorNode::get_singleton()->get_class_icon(type);22392240// If we can't find a global class icon, try to find one for the script.2241if (icon.is_null() && ResourceLoader::exists(type, "Script")) {2242Ref<Script> node_script = ResourceLoader::load(type);2243if (node_script.is_valid()) {2244name = name.get_file();2245icon = EditorNode::get_singleton()->get_object_icon(node_script.ptr());2246}2247}22482249TextureRect *trect = memnew(TextureRect);2250hb->add_child(trect);2251trect->set_expand_mode(TextureRect::EXPAND_IGNORE_SIZE);2252trect->set_stretch_mode(TextureRect::STRETCH_KEEP_ASPECT_CENTERED);2253trect->set_meta("icon", icon);2254valid_type_icons.push_back(trect);22552256Label *label = memnew(Label);2257hb->add_child(label);2258label->set_focus_mode(Control::FOCUS_ACCESSIBILITY);2259label->set_text(name);2260label->set_auto_translate_mode(AUTO_TRANSLATE_MODE_DISABLED);2261}22622263show_all_nodes->show();2264if (is_inside_tree()) {2265_update_valid_type_icons();2266}2267}22682269void SceneTreeDialog::_notification(int p_what) {2270switch (p_what) {2271case NOTIFICATION_VISIBILITY_CHANGED: {2272if (is_visible()) {2273tree->update_tree();22742275// Select the search bar by default.2276callable_mp((Control *)filter, &Control::grab_focus).call_deferred();2277}2278} break;22792280case NOTIFICATION_ENTER_TREE: {2281connect(SceneStringName(confirmed), callable_mp(this, &SceneTreeDialog::_select));2282} break;22832284case NOTIFICATION_THEME_CHANGED: {2285_update_valid_type_icons();2286} break;22872288case NOTIFICATION_EXIT_TREE: {2289disconnect(SceneStringName(confirmed), callable_mp(this, &SceneTreeDialog::_select));2290} break;2291}2292}22932294void SceneTreeDialog::_update_valid_type_icons() {2295filter->set_right_icon(get_editor_theme_icon(SNAME("Search")));2296for (TextureRect *trect : valid_type_icons) {2297trect->set_custom_minimum_size(Vector2(get_theme_constant(SNAME("class_icon_size"), EditorStringName(Editor)), 0));2298trect->set_texture(trect->get_meta("icon"));2299}2300}23012302void SceneTreeDialog::_cancel() {2303hide();2304}23052306void SceneTreeDialog::_select() {2307if (tree->get_selected()) {2308// The signal may cause another dialog to be displayed, so be sure to hide this one first.2309hide();2310emit_signal(SNAME("selected"), tree->get_selected()->get_path());2311}2312}23132314void SceneTreeDialog::_selected_changed() {2315get_ok_button()->set_disabled(!tree->get_selected());2316}23172318void SceneTreeDialog::_filter_changed(const String &p_filter) {2319tree->set_filter(p_filter);2320}23212322void SceneTreeDialog::_on_filter_gui_input(const Ref<InputEvent> &p_event) {2323// Redirect navigational key events to the tree.2324Ref<InputEventKey> key = p_event;2325if (key.is_valid()) {2326if (key->is_action("ui_up", true) || key->is_action("ui_down", true) || key->is_action("ui_page_up") || key->is_action("ui_page_down")) {2327tree->get_scene_tree()->gui_input(key);2328filter->accept_event();2329}2330}2331}23322333void SceneTreeDialog::_bind_methods() {2334ClassDB::bind_method("_cancel", &SceneTreeDialog::_cancel);23352336ADD_SIGNAL(MethodInfo("selected", PropertyInfo(Variant::NODE_PATH, "path")));2337}23382339SceneTreeDialog::SceneTreeDialog() {2340set_title(TTR("Select a Node"));2341content = memnew(VBoxContainer);2342add_child(content);23432344HBoxContainer *filter_hbc = memnew(HBoxContainer);2345content->add_child(filter_hbc);23462347filter = memnew(LineEdit);2348filter->set_h_size_flags(Control::SIZE_EXPAND_FILL);2349filter->set_placeholder(TTR("Filter Nodes"));2350filter->set_clear_button_enabled(true);2351filter->add_theme_constant_override("minimum_character_width", 0);2352filter->connect(SceneStringName(text_changed), callable_mp(this, &SceneTreeDialog::_filter_changed));2353filter->connect(SceneStringName(gui_input), callable_mp(this, &SceneTreeDialog::_on_filter_gui_input));23542355register_text_enter(filter);23562357filter_hbc->add_child(filter);23582359// Add 'Show All' button to HBoxContainer next to the filter, visible only when valid_types is defined.2360show_all_nodes = memnew(CheckButton);2361show_all_nodes->set_text(TTR("Show All"));2362show_all_nodes->connect(SceneStringName(toggled), callable_mp(this, &SceneTreeDialog::_show_all_nodes_changed));2363show_all_nodes->set_h_size_flags(Control::SIZE_SHRINK_BEGIN);2364show_all_nodes->hide();2365filter_hbc->add_child(show_all_nodes);23662367tree = memnew(SceneTreeEditor(false, false, true));2368tree->set_update_when_invisible(false);2369tree->set_v_size_flags(Control::SIZE_EXPAND_FILL);2370tree->get_scene_tree()->connect("item_activated", callable_mp(this, &SceneTreeDialog::_select));2371// Initialize button state, must be done after the tree has been created to update its 'show_all_nodes' flag.2372// This is also done before adding the tree to the content to avoid triggering unnecessary tree filtering.2373show_all_nodes->set_pressed(EditorSettings::get_singleton()->get_project_metadata("editor_metadata", "show_all_nodes_for_node_selection", false));2374content->add_child(tree);23752376// Disable the OK button when no node is selected.2377get_ok_button()->set_disabled(!tree->get_selected());2378tree->connect("node_selected", callable_mp(this, &SceneTreeDialog::_selected_changed));2379}23802381/******** CACHE *********/23822383HashMap<Node *, SceneTreeEditor::CachedNode>::Iterator SceneTreeEditor::NodeCache::add(Node *p_node, TreeItem *p_item) {2384if (!p_node) {2385return HashMap<Node *, CachedNode>::Iterator();2386}23872388return cache.insert(p_node, CachedNode(p_node, p_item));2389}23902391HashMap<Node *, SceneTreeEditor::CachedNode>::Iterator SceneTreeEditor::NodeCache::get(Node *p_node, bool p_deleted_ok) {2392if (!p_node) {2393return HashMap<Node *, CachedNode>::Iterator();2394}23952396HashMap<Node *, CachedNode>::Iterator I = cache.find(p_node);2397if (I) {2398if (I->value.delete_serial != UINT16_MAX) {2399// Don't give us a node marked for deletion.2400if (!p_deleted_ok) {2401return HashMap<Node *, CachedNode>::Iterator();2402}24032404to_delete.erase(&I->value);2405I->value.delete_serial = UINT16_MAX;24062407// If we were resurrected from near-death we might have been renamed.2408// Make sure that we are updated properly.2409mark_dirty(p_node);2410mark_children_dirty(p_node, true);2411}2412}24132414return I;2415}24162417bool SceneTreeEditor::NodeCache::has(Node *p_node) {2418return get(p_node, false).operator bool();2419}24202421void SceneTreeEditor::NodeCache::remove(Node *p_node, bool p_recursive) {2422if (!p_node) {2423return;2424}24252426if (p_node == editor->selected) {2427editor->selected = nullptr;2428}24292430if (p_node == current_pinned_node) {2431current_pinned_node = nullptr;2432current_has_pin = false;2433}24342435editor->marked.erase(p_node);24362437HashMap<Node *, CachedNode>::Iterator I = cache.find(p_node);2438if (I) {2439if (p_recursive) {2440int cc = p_node->get_child_count(false);24412442for (int i = 0; i < cc; i++) {2443remove(p_node->get_child(i, false), p_recursive);2444}2445}24462447if (current_scene_node != p_node) {2448// Do not remove from the Tree control here. See delete_pending below.2449I->value.item->deselect(0);2450I->value.delete_serial = delete_serial;2451I->value.index = -1;2452I->value.cache_iterator = I;2453to_delete.insert(&I->value);2454} else {2455// If it is the root node, we leave the TreeItem and reuse it later.2456cache.remove(I);2457}2458}2459}24602461void SceneTreeEditor::NodeCache::mark_dirty(Node *p_node, bool p_parents) {2462Node *node = p_node;2463while (node) {2464HashMap<Node *, CachedNode>::Iterator I = cache.find(node);2465if (I) {2466I->value.dirty = true;2467}24682469if (!p_parents) {2470break;2471}24722473node = node->get_parent();2474}2475}24762477void SceneTreeEditor::NodeCache::mark_children_dirty(Node *p_node, bool p_recursive) {2478if (!p_node) {2479return;2480}24812482int cc = p_node->get_child_count(false);2483for (int i = 0; i < cc; i++) {2484Node *c = p_node->get_child(i, false);2485HashMap<Node *, CachedNode>::Iterator IC = cache.find(c);24862487if (IC) {2488IC->value.dirty = true;24892490if (p_recursive) {2491mark_children_dirty(c, p_recursive);2492}2493}2494}2495}24962497void SceneTreeEditor::NodeCache::delete_pending() {2498HashSet<CachedNode *>::Iterator I = to_delete.begin();2499while (I) {2500// We want to keep TreeItems around just long enough for a Node removal,2501// and immediate reinsertion. This is what happens with moves and2502// type changes.2503if (Math::abs((*I)->delete_serial - delete_serial) >= 2) {2504memdelete((*I)->item);2505cache.remove((*I)->cache_iterator);2506to_delete.remove(I);2507} else if (!(*I)->removed) {2508// We don't remove from the tree until now because if the node got2509// deleted from a @tool script the SceneTreeEditor might have had it2510// marked or selected before the node was removed. If we immediately2511// remove from the Tree control then we end up trying to scroll to an2512// Item without a parent.2513//2514// We might already be removed (and thus not have a parent) by rapid2515// undo/redo.2516if (!(*I)->removed) {2517TreeItem *parent = (*I)->item->get_parent();2518parent->remove_child((*I)->item);2519}2520(*I)->removed = true;2521}2522++I;2523}25242525++delete_serial;2526}25272528void SceneTreeEditor::NodeCache::clear() {2529for (CachedNode *E : to_delete) {2530// Only removed entries won't be automatically cleaned up by Tree::clear().2531if (E->removed) {2532memdelete(E->item);2533}2534}2535cache.clear();2536to_delete.clear();2537current_pinned_node = nullptr;2538current_has_pin = false;2539}254025412542