/**************************************************************************/ /* run_instances_dialog.cpp */ /**************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /**************************************************************************/ /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */ /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */ /* */ /* Permission is hereby granted, free of charge, to any person obtaining */ /* a copy of this software and associated documentation files (the */ /* "Software"), to deal in the Software without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of the Software, and to */ /* permit persons to whom the Software is furnished to do so, subject to */ /* the following conditions: */ /* */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /**************************************************************************/ #include "run_instances_dialog.h" #include "core/config/project_settings.h" #include "editor/editor_settings.h" #include "editor/themes/editor_scale.h" #include "scene/gui/check_box.h" #include "scene/gui/grid_container.h" #include "scene/gui/label.h" #include "scene/gui/line_edit.h" #include "scene/gui/separator.h" #include "scene/gui/spin_box.h" #include "scene/gui/tree.h" #include "scene/main/timer.h" void RunInstancesDialog::_fetch_main_args() { if (!main_args_edit->has_focus()) { // Only set the text if the user is not currently editing it. main_args_edit->set_text(GLOBAL_GET("editor/run/main_run_args")); } } void RunInstancesDialog::_start_main_timer() { main_apply_timer->start(); } void RunInstancesDialog::_start_instance_timer() { instance_apply_timer->start(); } void RunInstancesDialog::_refresh_argument_count() { instance_tree->clear(); instance_tree->create_item(); // Root. while (instance_count->get_value() > stored_data.size()) { stored_data.append(Dictionary()); } stored_data.resize(instance_count->get_value()); instances_data.resize(stored_data.size()); InstanceData *instances_write = instances_data.ptrw(); for (int i = 0; i < instances_data.size(); i++) { InstanceData instance; const Dictionary &instance_data = stored_data[i]; _create_instance(instance, instance_data, i + 1); instances_write[i] = instance; } } void RunInstancesDialog::_create_instance(InstanceData &p_instance, const Dictionary &p_data, int p_idx) { TreeItem *instance_item = instance_tree->create_item(); p_instance.item = instance_item; instance_item->set_cell_mode(COLUMN_OVERRIDE_ARGS, TreeItem::CELL_MODE_CHECK); instance_item->set_editable(COLUMN_OVERRIDE_ARGS, true); instance_item->set_text(COLUMN_OVERRIDE_ARGS, TTR("Enabled")); instance_item->set_checked(COLUMN_OVERRIDE_ARGS, p_data.get("override_args", false)); instance_item->set_editable(COLUMN_LAUNCH_ARGUMENTS, true); instance_item->set_text(COLUMN_LAUNCH_ARGUMENTS, p_data.get("arguments", String())); instance_item->set_cell_mode(COLUMN_OVERRIDE_FEATURES, TreeItem::CELL_MODE_CHECK); instance_item->set_editable(COLUMN_OVERRIDE_FEATURES, true); instance_item->set_text(COLUMN_OVERRIDE_FEATURES, TTR("Enabled")); instance_item->set_checked(COLUMN_OVERRIDE_FEATURES, p_data.get("override_features", false)); instance_item->set_editable(COLUMN_FEATURE_TAGS, true); instance_item->set_text(COLUMN_FEATURE_TAGS, p_data.get("features", String())); } void RunInstancesDialog::_save_main_args() { ProjectSettings::get_singleton()->set_setting("editor/run/main_run_args", main_args_edit->get_text()); ProjectSettings::get_singleton()->save(); EditorSettings::get_singleton()->set_project_metadata("debug_options", "run_main_feature_tags", main_features_edit->get_text()); EditorSettings::get_singleton()->set_project_metadata("debug_options", "multiple_instances_enabled", enable_multiple_instances_checkbox->is_pressed()); } void RunInstancesDialog::_save_arguments() { stored_data.resize(instances_data.size()); for (int i = 0; i < instances_data.size(); i++) { const InstanceData &instance = instances_data[i]; Dictionary dict; dict["override_args"] = instance.overrides_run_args(); dict["arguments"] = instance.get_launch_arguments(); dict["override_features"] = instance.overrides_features(); dict["features"] = instance.get_feature_tags(); stored_data[i] = dict; } EditorSettings::get_singleton()->set_project_metadata("debug_options", "run_instances_config", stored_data); } Vector RunInstancesDialog::_split_cmdline_args(const String &p_arg_string) const { Vector split_args; int arg_start = 0; bool is_quoted = false; char32_t quote_char = '-'; char32_t arg_char; int arg_length; for (int i = 0; i < p_arg_string.length(); i++) { arg_char = p_arg_string[i]; if (arg_char == '\"' || arg_char == '\'') { if (i == 0 || p_arg_string[i - 1] != '\\') { if (is_quoted) { if (arg_char == quote_char) { is_quoted = false; quote_char = '-'; } } else { is_quoted = true; quote_char = arg_char; } } } else if (!is_quoted && arg_char == ' ') { arg_length = i - arg_start; if (arg_length > 0) { split_args.push_back(p_arg_string.substr(arg_start, arg_length)); } arg_start = i + 1; } } arg_length = p_arg_string.length() - arg_start; if (arg_length > 0) { split_args.push_back(p_arg_string.substr(arg_start, arg_length)); } return split_args; } void RunInstancesDialog::popup_dialog() { popup_centered(Vector2(1200, 600) * EDSCALE); } int RunInstancesDialog::get_instance_count() const { if (enable_multiple_instances_checkbox->is_pressed()) { return instance_count->get_value(); } else { return 1; } } void RunInstancesDialog::get_argument_list_for_instance(int p_idx, List &r_list) const { bool override_args = instances_data[p_idx].overrides_run_args(); bool use_multiple_instances = enable_multiple_instances_checkbox->is_pressed(); String raw_custom_args; if (use_multiple_instances) { if (override_args) { raw_custom_args = instances_data[p_idx].get_launch_arguments(); } else { raw_custom_args = main_args_edit->get_text() + " " + instances_data[p_idx].get_launch_arguments(); } } else { raw_custom_args = main_args_edit->get_text(); } String exec = OS::get_singleton()->get_executable_path(); if (!raw_custom_args.is_empty()) { // Allow the user to specify a command to run, similar to Steam's launch options. // In this case, Godot will no longer be run directly; it's up to the underlying command // to run it. For instance, this can be used on Linux to force a running project // to use Optimus using `prime-run` or similar. // Example: `prime-run %command% --time-scale 0.5` const int placeholder_pos = raw_custom_args.find("%command%"); Vector custom_args; if (placeholder_pos != -1) { // Prepend executable-specific custom arguments. // If nothing is placed before `%command%`, behave as if no placeholder was specified. Vector exec_args = _split_cmdline_args(raw_custom_args.substr(0, placeholder_pos)); if (exec_args.size() > 0) { exec = exec_args[0]; exec_args.remove_at(0); // Append the Godot executable name before we append executable arguments // (since the order is reversed when using `push_front()`). r_list.push_front(OS::get_singleton()->get_executable_path()); } for (int i = exec_args.size() - 1; i >= 0; i--) { // Iterate backwards as we're pushing items in the reverse order. r_list.push_front(exec_args[i].replace(" ", "%20")); } // Append Godot-specific custom arguments. custom_args = _split_cmdline_args(raw_custom_args.substr(placeholder_pos + String("%command%").size())); for (int i = 0; i < custom_args.size(); i++) { r_list.push_back(custom_args[i].replace(" ", "%20")); } } else { // Append Godot-specific custom arguments. custom_args = _split_cmdline_args(raw_custom_args); for (int i = 0; i < custom_args.size(); i++) { r_list.push_back(custom_args[i].replace(" ", "%20")); } } } } void RunInstancesDialog::apply_custom_features(int p_instance_idx) { const InstanceData &instance = instances_data[p_instance_idx]; String raw_text; if (enable_multiple_instances_checkbox->is_pressed()) { if (instance.overrides_features()) { raw_text = instance.get_feature_tags(); } else { raw_text = main_features_edit->get_text() + "," + instance.get_feature_tags(); } } else { raw_text = main_features_edit->get_text(); } const Vector raw_list = raw_text.split(","); Vector stripped_features; for (int i = 0; i < raw_list.size(); i++) { String f = raw_list[i].strip_edges(); if (!f.is_empty()) { stripped_features.push_back(f); } } OS::get_singleton()->set_environment("GODOT_EDITOR_CUSTOM_FEATURES", String(",").join(stripped_features)); } RunInstancesDialog::RunInstancesDialog() { singleton = this; set_title(TTR("Run Instances")); main_apply_timer = memnew(Timer); main_apply_timer->set_wait_time(0.5); main_apply_timer->set_one_shot(true); add_child(main_apply_timer); main_apply_timer->connect("timeout", callable_mp(this, &RunInstancesDialog::_save_main_args)); instance_apply_timer = memnew(Timer); instance_apply_timer->set_wait_time(0.5); instance_apply_timer->set_one_shot(true); add_child(instance_apply_timer); instance_apply_timer->connect("timeout", callable_mp(this, &RunInstancesDialog::_save_arguments)); VBoxContainer *main_vb = memnew(VBoxContainer); add_child(main_vb); GridContainer *args_gc = memnew(GridContainer); args_gc->set_columns(3); args_gc->add_theme_constant_override("h_separation", 12 * EDSCALE); main_vb->add_child(args_gc); enable_multiple_instances_checkbox = memnew(CheckBox); enable_multiple_instances_checkbox->set_text(TTR("Enable Multiple Instances")); enable_multiple_instances_checkbox->set_pressed(EditorSettings::get_singleton()->get_project_metadata("debug_options", "multiple_instances_enabled", false)); args_gc->add_child(enable_multiple_instances_checkbox); enable_multiple_instances_checkbox->connect(SceneStringName(pressed), callable_mp(this, &RunInstancesDialog::_start_main_timer)); { Label *l = memnew(Label); l->set_text(TTR("Main Run Args:")); args_gc->add_child(l); } { Label *l = memnew(Label); l->set_text(TTR("Main Feature Tags:")); args_gc->add_child(l); } stored_data = TypedArray(EditorSettings::get_singleton()->get_project_metadata("debug_options", "run_instances_config", TypedArray())); instance_count = memnew(SpinBox); instance_count->set_min(1); instance_count->set_max(20); instance_count->set_value(stored_data.size()); args_gc->add_child(instance_count); instance_count->connect(SceneStringName(value_changed), callable_mp(this, &RunInstancesDialog::_start_instance_timer).unbind(1)); instance_count->connect(SceneStringName(value_changed), callable_mp(this, &RunInstancesDialog::_refresh_argument_count).unbind(1)); enable_multiple_instances_checkbox->connect(SceneStringName(toggled), callable_mp(instance_count, &SpinBox::set_editable)); instance_count->set_editable(enable_multiple_instances_checkbox->is_pressed()); main_args_edit = memnew(LineEdit); main_args_edit->set_h_size_flags(Control::SIZE_EXPAND_FILL); main_args_edit->set_placeholder(TTR("Space-separated arguments, example: host player1 blue")); args_gc->add_child(main_args_edit); _fetch_main_args(); ProjectSettings::get_singleton()->connect("settings_changed", callable_mp(this, &RunInstancesDialog::_fetch_main_args)); main_args_edit->connect(SceneStringName(text_changed), callable_mp(this, &RunInstancesDialog::_start_main_timer).unbind(1)); main_features_edit = memnew(LineEdit); main_features_edit->set_h_size_flags(Control::SIZE_EXPAND_FILL); main_features_edit->set_placeholder(TTR("Comma-separated tags, example: demo, steam, event")); main_features_edit->set_text(EditorSettings::get_singleton()->get_project_metadata("debug_options", "run_main_feature_tags", "")); args_gc->add_child(main_features_edit); main_features_edit->connect(SceneStringName(text_changed), callable_mp(this, &RunInstancesDialog::_start_main_timer).unbind(1)); { Label *l = memnew(Label); l->set_text(TTR("Instance Configuration")); l->set_h_size_flags(Control::SIZE_SHRINK_CENTER); l->set_theme_type_variation("HeaderSmall"); main_vb->add_child(l); } instance_tree = memnew(Tree); instance_tree->set_v_size_flags(Control::SIZE_EXPAND_FILL); instance_tree->set_h_scroll_enabled(false); instance_tree->set_columns(4); instance_tree->set_column_titles_visible(true); instance_tree->set_column_title(COLUMN_OVERRIDE_ARGS, TTR("Override Main Run Args")); instance_tree->set_column_expand(COLUMN_OVERRIDE_ARGS, false); instance_tree->set_column_title(COLUMN_LAUNCH_ARGUMENTS, TTR("Launch Arguments")); instance_tree->set_column_title(COLUMN_OVERRIDE_FEATURES, TTR("Override Main Tags")); instance_tree->set_column_expand(COLUMN_OVERRIDE_FEATURES, false); instance_tree->set_column_title(COLUMN_FEATURE_TAGS, TTR("Feature Tags")); instance_tree->set_hide_root(true); main_vb->add_child(instance_tree); _refresh_argument_count(); instance_tree->connect("item_edited", callable_mp(this, &RunInstancesDialog::_start_instance_timer)); } bool RunInstancesDialog::InstanceData::overrides_run_args() const { return item->is_checked(COLUMN_OVERRIDE_ARGS); } String RunInstancesDialog::InstanceData::get_launch_arguments() const { return item->get_text(COLUMN_LAUNCH_ARGUMENTS); } bool RunInstancesDialog::InstanceData::overrides_features() const { return item->is_checked(COLUMN_OVERRIDE_FEATURES); } String RunInstancesDialog::InstanceData::get_feature_tags() const { return item->get_text(COLUMN_FEATURE_TAGS); }