script_create_dialog.cpp 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989
  1. /**************************************************************************/
  2. /* script_create_dialog.cpp */
  3. /**************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /**************************************************************************/
  8. /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
  9. /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /**************************************************************************/
  30. #include "script_create_dialog.h"
  31. #include "core/config/project_settings.h"
  32. #include "core/io/file_access.h"
  33. #include "core/io/resource_saver.h"
  34. #include "editor/create_dialog.h"
  35. #include "editor/editor_file_system.h"
  36. #include "editor/editor_node.h"
  37. #include "editor/editor_paths.h"
  38. #include "editor/editor_settings.h"
  39. #include "editor/editor_string_names.h"
  40. #include "editor/gui/editor_file_dialog.h"
  41. #include "editor/gui/editor_validation_panel.h"
  42. #include "editor/themes/editor_scale.h"
  43. #include "scene/gui/grid_container.h"
  44. #include "scene/gui/line_edit.h"
  45. #include "scene/theme/theme_db.h"
  46. static String _get_parent_class_of_script(const String &p_path) {
  47. if (!ResourceLoader::exists(p_path, "Script")) {
  48. return "Object"; // A script eventually inherits from Object.
  49. }
  50. Ref<Script> script = ResourceLoader::load(p_path, "Script");
  51. ERR_FAIL_COND_V(script.is_null(), "Object");
  52. String class_name;
  53. Ref<Script> base = script->get_base_script();
  54. // Inherits from a built-in class.
  55. if (base.is_null()) {
  56. script->get_language()->get_global_class_name(script->get_path(), &class_name);
  57. return class_name;
  58. }
  59. // Inherits from a script that has class_name.
  60. class_name = script->get_language()->get_global_class_name(base->get_path());
  61. if (!class_name.is_empty()) {
  62. return class_name;
  63. }
  64. // Inherits from a plain script.
  65. return _get_parent_class_of_script(base->get_path());
  66. }
  67. static Vector<String> _get_hierarchy(const String &p_class_name) {
  68. Vector<String> hierarchy;
  69. String class_name = p_class_name;
  70. while (true) {
  71. // A registered class.
  72. if (ClassDB::class_exists(class_name)) {
  73. hierarchy.push_back(class_name);
  74. class_name = ClassDB::get_parent_class(class_name);
  75. continue;
  76. }
  77. // A class defined in script with class_name.
  78. if (ScriptServer::is_global_class(class_name)) {
  79. hierarchy.push_back(class_name);
  80. Ref<Script> script = EditorNode::get_editor_data().script_class_load_script(class_name);
  81. ERR_BREAK(script.is_null());
  82. class_name = _get_parent_class_of_script(script->get_path());
  83. continue;
  84. }
  85. break;
  86. }
  87. if (hierarchy.is_empty()) {
  88. if (p_class_name.is_valid_ascii_identifier()) {
  89. hierarchy.push_back(p_class_name);
  90. }
  91. hierarchy.push_back("Object");
  92. }
  93. return hierarchy;
  94. }
  95. void ScriptCreateDialog::_notification(int p_what) {
  96. switch (p_what) {
  97. case NOTIFICATION_ENTER_TREE: {
  98. String last_language = EditorSettings::get_singleton()->get_project_metadata("script_setup", "last_selected_language", "");
  99. if (!last_language.is_empty()) {
  100. for (int i = 0; i < language_menu->get_item_count(); i++) {
  101. if (language_menu->get_item_text(i) == last_language) {
  102. language_menu->select(i);
  103. break;
  104. }
  105. }
  106. } else {
  107. language_menu->select(default_language);
  108. }
  109. is_using_templates = EDITOR_DEF("_script_setup_use_script_templates", false);
  110. use_templates->set_pressed(is_using_templates);
  111. } break;
  112. case NOTIFICATION_THEME_CHANGED: {
  113. const int icon_size = get_theme_constant(SNAME("class_icon_size"), EditorStringName(Editor));
  114. EditorData &ed = EditorNode::get_editor_data();
  115. for (int i = 0; i < ScriptServer::get_language_count(); i++) {
  116. // Check if the extension has an icon first.
  117. String script_type = ScriptServer::get_language(i)->get_type();
  118. Ref<Texture2D> language_icon = get_editor_theme_icon(script_type);
  119. if (language_icon.is_null() || language_icon == ThemeDB::get_singleton()->get_fallback_icon()) {
  120. // The theme doesn't have an icon for this language, ask the extensions.
  121. Ref<Texture2D> extension_language_icon = ed.extension_class_get_icon(script_type);
  122. if (extension_language_icon.is_valid()) {
  123. language_menu->get_popup()->set_item_icon_max_width(i, icon_size);
  124. language_icon = extension_language_icon;
  125. }
  126. }
  127. if (language_icon.is_valid()) {
  128. language_menu->set_item_icon(i, language_icon);
  129. }
  130. }
  131. path_button->set_button_icon(get_editor_theme_icon(SNAME("Folder")));
  132. parent_browse_button->set_button_icon(get_editor_theme_icon(SNAME("Folder")));
  133. parent_search_button->set_button_icon(get_editor_theme_icon(SNAME("ClassList")));
  134. } break;
  135. }
  136. }
  137. void ScriptCreateDialog::_path_hbox_sorted() {
  138. if (is_visible()) {
  139. int filename_start_pos = file_path->get_text().rfind_char('/') + 1;
  140. int filename_end_pos = file_path->get_text().get_basename().length();
  141. if (!is_built_in) {
  142. file_path->select(filename_start_pos, filename_end_pos);
  143. }
  144. // First set cursor to the end of line to scroll LineEdit view
  145. // to the right and then set the actual cursor position.
  146. file_path->set_caret_column(file_path->get_text().length());
  147. file_path->set_caret_column(filename_start_pos);
  148. file_path->grab_focus();
  149. }
  150. }
  151. bool ScriptCreateDialog::_can_be_built_in() {
  152. return (supports_built_in && built_in_enabled);
  153. }
  154. String ScriptCreateDialog::_adjust_file_path(const String &p_base_path) const {
  155. if (p_base_path.is_empty()) {
  156. return p_base_path;
  157. }
  158. String base_dir = p_base_path.get_base_dir();
  159. String file_name = p_base_path.get_file().get_basename();
  160. file_name = EditorNode::adjust_script_name_casing(file_name, language->preferred_file_name_casing());
  161. String extension = language->get_extension();
  162. return base_dir.path_join(file_name + "." + extension);
  163. }
  164. void ScriptCreateDialog::config(const String &p_base_name, const String &p_base_path, bool p_built_in_enabled, bool p_load_enabled) {
  165. parent_name->set_text(p_base_name);
  166. parent_name->deselect();
  167. built_in_name->set_text("");
  168. file_path->set_text(p_base_path);
  169. file_path->deselect();
  170. built_in_enabled = p_built_in_enabled;
  171. load_enabled = p_load_enabled;
  172. _language_changed(language_menu->get_selected());
  173. }
  174. void ScriptCreateDialog::set_inheritance_base_type(const String &p_base) {
  175. base_type = p_base;
  176. }
  177. bool ScriptCreateDialog::_validate_parent(const String &p_string) {
  178. if (p_string.length() == 0) {
  179. return false;
  180. }
  181. if (can_inherit_from_file && p_string.is_quoted()) {
  182. String p = p_string.substr(1, p_string.length() - 2);
  183. if (_validate_path(p, true).is_empty()) {
  184. return true;
  185. }
  186. }
  187. return EditorNode::get_editor_data().is_type_recognized(p_string);
  188. }
  189. String ScriptCreateDialog::_validate_path(const String &p_path, bool p_file_must_exist, bool *r_path_valid) {
  190. String p = p_path.strip_edges();
  191. if (r_path_valid) {
  192. *r_path_valid = false;
  193. }
  194. if (p.is_empty()) {
  195. return TTR("Path is empty.");
  196. }
  197. if (p.get_file().get_basename().is_empty()) {
  198. return TTR("Filename is empty.");
  199. }
  200. if (!p.get_file().get_basename().is_valid_filename()) {
  201. return TTR("Filename is invalid.");
  202. }
  203. if (p.get_file().begins_with(".")) {
  204. return TTR("Name begins with a dot.");
  205. }
  206. p = ProjectSettings::get_singleton()->localize_path(p);
  207. if (!p.begins_with("res://")) {
  208. return TTR("Path is not local.");
  209. }
  210. {
  211. Ref<DirAccess> da = DirAccess::create(DirAccess::ACCESS_RESOURCES);
  212. if (da->change_dir(p.get_base_dir()) != OK) {
  213. return TTR("Base path is invalid.");
  214. }
  215. }
  216. {
  217. // Check if file exists.
  218. Ref<DirAccess> da = DirAccess::create(DirAccess::ACCESS_RESOURCES);
  219. if (da->dir_exists(p)) {
  220. return TTR("A directory with the same name exists.");
  221. } else if (p_file_must_exist && !da->file_exists(p)) {
  222. return TTR("File does not exist.");
  223. }
  224. }
  225. if (r_path_valid) {
  226. *r_path_valid = true;
  227. }
  228. // Check file extension.
  229. String extension = p.get_extension();
  230. List<String> extensions;
  231. // Get all possible extensions for script.
  232. for (int l = 0; l < language_menu->get_item_count(); l++) {
  233. ScriptServer::get_language(l)->get_recognized_extensions(&extensions);
  234. }
  235. bool found = false;
  236. bool match = false;
  237. for (const String &E : extensions) {
  238. if (E.nocasecmp_to(extension) == 0) {
  239. found = true;
  240. if (E == ScriptServer::get_language(language_menu->get_selected())->get_extension()) {
  241. match = true;
  242. }
  243. break;
  244. }
  245. }
  246. if (!found) {
  247. return TTR("Invalid extension.");
  248. }
  249. if (!match) {
  250. return TTR("Extension doesn't match chosen language.");
  251. }
  252. // Let ScriptLanguage do custom validation.
  253. return ScriptServer::get_language(language_menu->get_selected())->validate_path(p);
  254. }
  255. void ScriptCreateDialog::_parent_name_changed(const String &p_parent) {
  256. is_parent_name_valid = _validate_parent(parent_name->get_text());
  257. validation_panel->update();
  258. }
  259. void ScriptCreateDialog::_template_changed(int p_template) {
  260. const ScriptLanguage::ScriptTemplate &sinfo = _get_current_template();
  261. // Update last used dictionaries
  262. if (is_using_templates && !parent_name->get_text().begins_with("\"res:")) {
  263. if (sinfo.origin == ScriptLanguage::TemplateLocation::TEMPLATE_PROJECT) {
  264. // Save the last used template for this node into the project dictionary.
  265. Dictionary dic_templates_project = EditorSettings::get_singleton()->get_project_metadata("script_setup", "templates_dictionary", Dictionary());
  266. dic_templates_project[parent_name->get_text()] = sinfo.get_hash();
  267. EditorSettings::get_singleton()->set_project_metadata("script_setup", "templates_dictionary", dic_templates_project);
  268. } else {
  269. // Save template info to editor dictionary (not a project template).
  270. Dictionary dic_templates = EDITOR_GET("_script_setup_templates_dictionary");
  271. dic_templates[parent_name->get_text()] = sinfo.get_hash();
  272. EditorSettings::get_singleton()->set("_script_setup_templates_dictionary", dic_templates);
  273. // Remove template from project dictionary as we last used an editor level template.
  274. Dictionary dic_templates_project = EditorSettings::get_singleton()->get_project_metadata("script_setup", "templates_dictionary", Dictionary());
  275. if (dic_templates_project.has(parent_name->get_text())) {
  276. dic_templates_project.erase(parent_name->get_text());
  277. EditorSettings::get_singleton()->set_project_metadata("script_setup", "templates_dictionary", dic_templates_project);
  278. }
  279. }
  280. }
  281. // Update template label information.
  282. String template_info = U"• ";
  283. template_info += TTR("Template:");
  284. template_info += " " + sinfo.name;
  285. if (!sinfo.description.is_empty()) {
  286. template_info += " - " + sinfo.description;
  287. }
  288. validation_panel->set_message(MSG_ID_TEMPLATE, template_info, EditorValidationPanel::MSG_INFO, false);
  289. }
  290. void ScriptCreateDialog::ok_pressed() {
  291. if (is_new_script_created) {
  292. _create_new();
  293. } else {
  294. _load_exist();
  295. }
  296. EditorSettings::get_singleton()->save();
  297. is_new_script_created = true;
  298. validation_panel->update();
  299. }
  300. void ScriptCreateDialog::_create_new() {
  301. Ref<Script> scr;
  302. const ScriptLanguage::ScriptTemplate sinfo = _get_current_template();
  303. String parent_class = parent_name->get_text();
  304. if (!parent_name->get_text().is_quoted() && !ClassDB::class_exists(parent_class) && !ScriptServer::is_global_class(parent_class)) {
  305. // If base is a custom type, replace with script path instead.
  306. const EditorData::CustomType *type = EditorNode::get_editor_data().get_custom_type_by_name(parent_class);
  307. ERR_FAIL_NULL(type);
  308. parent_class = "\"" + type->script->get_path() + "\"";
  309. }
  310. String class_name = file_path->get_text().get_file().get_basename();
  311. scr = ScriptServer::get_language(language_menu->get_selected())->make_template(sinfo.content, class_name, parent_class);
  312. if (is_built_in) {
  313. scr->set_name(built_in_name->get_text());
  314. // Make sure the script is compiled to make its type recognizable.
  315. scr->reload();
  316. } else {
  317. String lpath = ProjectSettings::get_singleton()->localize_path(file_path->get_text());
  318. scr->set_path(lpath);
  319. Error err = ResourceSaver::save(scr, lpath, ResourceSaver::FLAG_CHANGE_PATH);
  320. if (err != OK) {
  321. alert->set_text(TTR("Error - Could not create script in filesystem."));
  322. alert->popup_centered();
  323. return;
  324. }
  325. }
  326. emit_signal(SNAME("script_created"), scr);
  327. hide();
  328. }
  329. void ScriptCreateDialog::_load_exist() {
  330. String path = file_path->get_text();
  331. Ref<Resource> p_script = ResourceLoader::load(path, "Script");
  332. if (p_script.is_null()) {
  333. alert->set_text(vformat(TTR("Error loading script from %s"), path));
  334. alert->popup_centered();
  335. return;
  336. }
  337. emit_signal(SNAME("script_created"), p_script);
  338. hide();
  339. }
  340. void ScriptCreateDialog::_language_changed(int l) {
  341. language = ScriptServer::get_language(l);
  342. can_inherit_from_file = language->can_inherit_from_file();
  343. supports_built_in = language->supports_builtin_mode();
  344. if (!supports_built_in) {
  345. is_built_in = false;
  346. }
  347. String path = file_path->get_text();
  348. path = _adjust_file_path(path);
  349. _path_changed(path);
  350. file_path->set_text(path);
  351. EditorSettings::get_singleton()->set_project_metadata("script_setup", "last_selected_language", language_menu->get_item_text(language_menu->get_selected()));
  352. _parent_name_changed(parent_name->get_text());
  353. validation_panel->update();
  354. }
  355. void ScriptCreateDialog::_built_in_pressed() {
  356. if (built_in->is_pressed()) {
  357. is_built_in = true;
  358. is_new_script_created = true;
  359. } else {
  360. is_built_in = false;
  361. _path_changed(file_path->get_text());
  362. }
  363. validation_panel->update();
  364. }
  365. void ScriptCreateDialog::_use_template_pressed() {
  366. is_using_templates = use_templates->is_pressed();
  367. EditorSettings::get_singleton()->set("_script_setup_use_script_templates", is_using_templates);
  368. validation_panel->update();
  369. }
  370. void ScriptCreateDialog::_browse_path(bool browse_parent, bool p_save) {
  371. is_browsing_parent = browse_parent;
  372. if (p_save) {
  373. file_browse->set_file_mode(EditorFileDialog::FILE_MODE_SAVE_FILE);
  374. file_browse->set_title(TTR("Open Script / Choose Location"));
  375. file_browse->set_ok_button_text(TTR("Open"));
  376. } else {
  377. file_browse->set_file_mode(EditorFileDialog::FILE_MODE_OPEN_FILE);
  378. file_browse->set_title(TTR("Open Script"));
  379. }
  380. file_browse->set_disable_overwrite_warning(true);
  381. file_browse->clear_filters();
  382. List<String> extensions;
  383. int lang = language_menu->get_selected();
  384. ScriptServer::get_language(lang)->get_recognized_extensions(&extensions);
  385. for (const String &E : extensions) {
  386. file_browse->add_filter("*." + E);
  387. }
  388. file_browse->set_current_path(file_path->get_text());
  389. file_browse->popup_file_dialog();
  390. }
  391. void ScriptCreateDialog::_file_selected(const String &p_file) {
  392. String path = ProjectSettings::get_singleton()->localize_path(p_file);
  393. if (is_browsing_parent) {
  394. parent_name->set_text("\"" + path + "\"");
  395. _parent_name_changed(parent_name->get_text());
  396. } else {
  397. file_path->set_text(path);
  398. _path_changed(path);
  399. String filename = path.get_file().get_basename();
  400. int select_start = path.rfind(filename);
  401. file_path->select(select_start, select_start + filename.length());
  402. file_path->set_caret_column(select_start + filename.length());
  403. file_path->grab_focus();
  404. }
  405. }
  406. void ScriptCreateDialog::_create() {
  407. parent_name->set_text(select_class->get_selected_type().split(" ")[0]);
  408. _parent_name_changed(parent_name->get_text());
  409. }
  410. void ScriptCreateDialog::_browse_class_in_tree() {
  411. select_class->set_base_type(base_type);
  412. select_class->popup_create(true);
  413. select_class->set_title(vformat(TTR("Inherit %s"), base_type));
  414. select_class->set_ok_button_text(TTR("Inherit"));
  415. }
  416. void ScriptCreateDialog::_path_changed(const String &p_path) {
  417. if (is_built_in) {
  418. return;
  419. }
  420. is_new_script_created = true;
  421. path_error = _validate_path(p_path, false, &is_path_valid);
  422. if (!path_error.is_empty()) {
  423. validation_panel->update();
  424. return;
  425. }
  426. // Check if file exists.
  427. Ref<DirAccess> da = DirAccess::create(DirAccess::ACCESS_RESOURCES);
  428. String p = ProjectSettings::get_singleton()->localize_path(p_path.strip_edges());
  429. if (da->file_exists(p)) {
  430. is_new_script_created = false;
  431. }
  432. validation_panel->update();
  433. }
  434. void ScriptCreateDialog::_update_template_menu() {
  435. bool is_language_using_templates = language->is_using_templates();
  436. template_menu->set_disabled(false);
  437. template_menu->clear();
  438. template_list.clear();
  439. if (is_language_using_templates) {
  440. // Get the latest templates used for each type of node from project settings then global settings.
  441. Dictionary last_local_templates = EditorSettings::get_singleton()->get_project_metadata("script_setup", "templates_dictionary", Dictionary());
  442. Dictionary last_global_templates = EDITOR_GET("_script_setup_templates_dictionary");
  443. String inherits_base_type = parent_name->get_text();
  444. // If it inherits from a script, get its parent class first.
  445. if (inherits_base_type[0] == '"') {
  446. inherits_base_type = _get_parent_class_of_script(inherits_base_type.unquote());
  447. }
  448. // Get all ancestor node for selected base node.
  449. // There templates will also fit the base node.
  450. Vector<String> hierarchy = _get_hierarchy(inherits_base_type);
  451. int last_used_template = -1;
  452. int preselected_template = -1;
  453. int previous_ancestor_level = -1;
  454. // Templates can be stored in tree different locations.
  455. Vector<ScriptLanguage::TemplateLocation> template_locations;
  456. template_locations.append(ScriptLanguage::TEMPLATE_PROJECT);
  457. template_locations.append(ScriptLanguage::TEMPLATE_EDITOR);
  458. template_locations.append(ScriptLanguage::TEMPLATE_BUILT_IN);
  459. for (const ScriptLanguage::TemplateLocation &template_location : template_locations) {
  460. String display_name = _get_script_origin_label(template_location);
  461. bool separator = false;
  462. int ancestor_level = 0;
  463. for (const String &current_node : hierarchy) {
  464. Vector<ScriptLanguage::ScriptTemplate> templates_found;
  465. if (template_location == ScriptLanguage::TEMPLATE_BUILT_IN) {
  466. templates_found = language->get_built_in_templates(current_node);
  467. } else {
  468. String template_directory;
  469. if (template_location == ScriptLanguage::TEMPLATE_PROJECT) {
  470. template_directory = EditorPaths::get_singleton()->get_project_script_templates_dir();
  471. } else {
  472. template_directory = EditorPaths::get_singleton()->get_script_templates_dir();
  473. }
  474. templates_found = _get_user_templates(language, current_node, template_directory, template_location);
  475. }
  476. if (!templates_found.is_empty()) {
  477. if (!separator) {
  478. template_menu->add_separator();
  479. template_menu->set_item_text(-1, display_name);
  480. separator = true;
  481. }
  482. for (ScriptLanguage::ScriptTemplate &t : templates_found) {
  483. template_menu->add_item(t.inherit + ": " + t.name);
  484. int id = template_menu->get_item_count() - 1;
  485. // Check if this template should be preselected if node isn't in the last used dictionary.
  486. if (ancestor_level < previous_ancestor_level || previous_ancestor_level == -1) {
  487. previous_ancestor_level = ancestor_level;
  488. preselected_template = id;
  489. }
  490. // Check for last used template for this node in project settings then in global settings.
  491. if (last_local_templates.has(parent_name->get_text()) && t.get_hash() == String(last_local_templates[parent_name->get_text()])) {
  492. last_used_template = id;
  493. } else if (last_used_template == -1 && last_global_templates.has(parent_name->get_text()) && t.get_hash() == String(last_global_templates[parent_name->get_text()])) {
  494. last_used_template = id;
  495. }
  496. t.id = id;
  497. template_list.push_back(t);
  498. String icon = has_theme_icon(t.inherit, EditorStringName(EditorIcons)) ? t.inherit : "Object";
  499. template_menu->set_item_icon(id, get_editor_theme_icon(icon));
  500. }
  501. }
  502. ancestor_level++;
  503. }
  504. }
  505. if (last_used_template != -1) {
  506. template_menu->select(last_used_template);
  507. } else if (preselected_template != -1) {
  508. template_menu->select(preselected_template);
  509. }
  510. }
  511. _template_changed(template_menu->get_selected());
  512. }
  513. void ScriptCreateDialog::_update_dialog() {
  514. // "Add Script Dialog" GUI logic and script checks.
  515. _update_template_menu();
  516. // Is script path/name valid (order from top to bottom)?
  517. if (!is_built_in && !is_path_valid) {
  518. validation_panel->set_message(MSG_ID_SCRIPT, TTR("Invalid path."), EditorValidationPanel::MSG_ERROR);
  519. }
  520. if (!is_parent_name_valid && is_new_script_created) {
  521. validation_panel->set_message(MSG_ID_SCRIPT, TTR("Invalid inherited parent name or path."), EditorValidationPanel::MSG_ERROR);
  522. }
  523. if (validation_panel->is_valid() && !is_new_script_created) {
  524. validation_panel->set_message(MSG_ID_SCRIPT, TTR("File exists, it will be reused."), EditorValidationPanel::MSG_OK);
  525. }
  526. if (!is_built_in && !path_error.is_empty()) {
  527. validation_panel->set_message(MSG_ID_PATH, path_error, EditorValidationPanel::MSG_ERROR);
  528. }
  529. // Is script Built-in?
  530. if (is_built_in) {
  531. file_path->set_editable(false);
  532. path_button->set_disabled(true);
  533. re_check_path = true;
  534. } else {
  535. file_path->set_editable(true);
  536. path_button->set_disabled(false);
  537. if (re_check_path) {
  538. re_check_path = false;
  539. _path_changed(file_path->get_text());
  540. }
  541. }
  542. if (!_can_be_built_in()) {
  543. built_in->set_pressed(false);
  544. }
  545. built_in->set_disabled(!_can_be_built_in());
  546. // Is Script created or loaded from existing file?
  547. if (is_built_in) {
  548. validation_panel->set_message(MSG_ID_BUILT_IN, TTR("Note: Built-in scripts have some limitations and can't be edited using an external editor."), EditorValidationPanel::MSG_INFO, false);
  549. } else if (file_path->get_text().get_file().get_basename() == parent_name->get_text()) {
  550. validation_panel->set_message(MSG_ID_BUILT_IN, TTR("Warning: Having the script name be the same as a built-in type is usually not desired."), EditorValidationPanel::MSG_WARNING, false);
  551. }
  552. path_controls[0]->set_visible(!is_built_in);
  553. path_controls[1]->set_visible(!is_built_in);
  554. name_controls[0]->set_visible(is_built_in);
  555. name_controls[1]->set_visible(is_built_in);
  556. bool is_new_file = is_built_in || is_new_script_created;
  557. parent_name->set_editable(is_new_file);
  558. parent_search_button->set_disabled(!is_new_file);
  559. parent_browse_button->set_disabled(!is_new_file || !can_inherit_from_file);
  560. template_inactive_message = "";
  561. String button_text = is_new_file ? TTR("Create") : TTR("Load");
  562. set_ok_button_text(button_text);
  563. if (is_new_file) {
  564. if (is_built_in) {
  565. validation_panel->set_message(MSG_ID_PATH, TTR("Built-in script (into scene file)."), EditorValidationPanel::MSG_OK);
  566. }
  567. } else {
  568. template_inactive_message = TTR("Using existing script file.");
  569. if (load_enabled) {
  570. if (is_path_valid) {
  571. validation_panel->set_message(MSG_ID_PATH, TTR("Will load an existing script file."), EditorValidationPanel::MSG_OK);
  572. }
  573. } else {
  574. validation_panel->set_message(MSG_ID_PATH, TTR("Script file already exists."), EditorValidationPanel::MSG_ERROR);
  575. }
  576. }
  577. // Show templates list if needed.
  578. if (is_using_templates) {
  579. // Check if at least one suitable template has been found.
  580. if (template_menu->get_item_count() == 0 && template_inactive_message.is_empty()) {
  581. template_inactive_message = TTR("No suitable template.");
  582. }
  583. } else {
  584. template_inactive_message = TTR("Empty");
  585. }
  586. if (!template_inactive_message.is_empty()) {
  587. template_menu->set_disabled(true);
  588. template_menu->clear();
  589. template_menu->add_item(template_inactive_message);
  590. validation_panel->set_message(MSG_ID_TEMPLATE, "", EditorValidationPanel::MSG_INFO);
  591. }
  592. }
  593. ScriptLanguage::ScriptTemplate ScriptCreateDialog::_get_current_template() const {
  594. int selected_index = template_menu->get_selected();
  595. for (const ScriptLanguage::ScriptTemplate &t : template_list) {
  596. if (is_using_templates) {
  597. if (t.id == selected_index) {
  598. return t;
  599. }
  600. } else {
  601. // Using empty built-in template if templates are disabled.
  602. if (t.origin == ScriptLanguage::TemplateLocation::TEMPLATE_BUILT_IN && t.name == "Empty") {
  603. return t;
  604. }
  605. }
  606. }
  607. return ScriptLanguage::ScriptTemplate();
  608. }
  609. Vector<ScriptLanguage::ScriptTemplate> ScriptCreateDialog::_get_user_templates(const ScriptLanguage *p_language, const StringName &p_object, const String &p_dir, const ScriptLanguage::TemplateLocation &p_origin) const {
  610. Vector<ScriptLanguage::ScriptTemplate> user_templates;
  611. String extension = p_language->get_extension();
  612. String dir_path = p_dir.path_join(p_object);
  613. Ref<DirAccess> d = DirAccess::open(dir_path);
  614. if (d.is_valid()) {
  615. d->list_dir_begin();
  616. String file = d->get_next();
  617. while (file != String()) {
  618. if (file.get_extension() == extension) {
  619. user_templates.append(_parse_template(p_language, dir_path, file, p_origin, p_object));
  620. }
  621. file = d->get_next();
  622. }
  623. d->list_dir_end();
  624. }
  625. return user_templates;
  626. }
  627. ScriptLanguage::ScriptTemplate ScriptCreateDialog::_parse_template(const ScriptLanguage *p_language, const String &p_path, const String &p_filename, const ScriptLanguage::TemplateLocation &p_origin, const String &p_inherits) const {
  628. ScriptLanguage::ScriptTemplate script_template = ScriptLanguage::ScriptTemplate();
  629. script_template.origin = p_origin;
  630. script_template.inherit = p_inherits;
  631. int space_indent_size = 4;
  632. // Get meta delimiter
  633. String meta_delimiter;
  634. List<String> comment_delimiters;
  635. p_language->get_comment_delimiters(&comment_delimiters);
  636. for (const String &script_delimiter : comment_delimiters) {
  637. if (!script_delimiter.contains_char(' ')) {
  638. meta_delimiter = script_delimiter;
  639. break;
  640. }
  641. }
  642. String meta_prefix = meta_delimiter + " meta-";
  643. // Parse file for meta-information and script content
  644. Error err;
  645. Ref<FileAccess> file = FileAccess::open(p_path.path_join(p_filename), FileAccess::READ, &err);
  646. if (!err) {
  647. while (!file->eof_reached()) {
  648. String line = file->get_line();
  649. if (line.begins_with(meta_prefix)) {
  650. // Store meta information
  651. line = line.substr(meta_prefix.length());
  652. if (line.begins_with("name:")) {
  653. script_template.name = line.substr(5).strip_edges();
  654. } else if (line.begins_with("description:")) {
  655. script_template.description = line.substr(12).strip_edges();
  656. } else if (line.begins_with("space-indent:")) {
  657. String indent_value = line.substr(13).strip_edges();
  658. if (indent_value.is_valid_int()) {
  659. int indent_size = indent_value.to_int();
  660. if (indent_size >= 0) {
  661. space_indent_size = indent_size;
  662. } else {
  663. WARN_PRINT(vformat("Template meta-space-indent need to be a non-negative integer value. Found %s.", indent_value));
  664. }
  665. } else {
  666. WARN_PRINT(vformat("Template meta-space-indent need to be a valid integer value. Found %s.", indent_value));
  667. }
  668. }
  669. } else {
  670. // Replace indentation.
  671. int i = 0;
  672. int space_count = 0;
  673. for (; i < line.length(); i++) {
  674. if (line[i] == '\t') {
  675. if (space_count) {
  676. script_template.content += String(" ").repeat(space_count);
  677. space_count = 0;
  678. }
  679. script_template.content += "_TS_";
  680. } else if (line[i] == ' ') {
  681. space_count++;
  682. if (space_count == space_indent_size) {
  683. script_template.content += "_TS_";
  684. space_count = 0;
  685. }
  686. } else {
  687. break;
  688. }
  689. }
  690. if (space_count) {
  691. script_template.content += String(" ").repeat(space_count);
  692. }
  693. script_template.content += line.substr(i) + "\n";
  694. }
  695. }
  696. }
  697. script_template.content = script_template.content.lstrip("\n");
  698. // Get name from file name if no name in meta information
  699. if (script_template.name == String()) {
  700. script_template.name = p_filename.get_basename().capitalize();
  701. }
  702. return script_template;
  703. }
  704. String ScriptCreateDialog::_get_script_origin_label(const ScriptLanguage::TemplateLocation &p_origin) const {
  705. switch (p_origin) {
  706. case ScriptLanguage::TEMPLATE_BUILT_IN:
  707. return TTR("Built-in");
  708. case ScriptLanguage::TEMPLATE_EDITOR:
  709. return TTR("Editor");
  710. case ScriptLanguage::TEMPLATE_PROJECT:
  711. return TTR("Project");
  712. }
  713. return "";
  714. }
  715. void ScriptCreateDialog::_bind_methods() {
  716. ClassDB::bind_method(D_METHOD("config", "inherits", "path", "built_in_enabled", "load_enabled"), &ScriptCreateDialog::config, DEFVAL(true), DEFVAL(true));
  717. ADD_SIGNAL(MethodInfo("script_created", PropertyInfo(Variant::OBJECT, "script", PROPERTY_HINT_RESOURCE_TYPE, "Script")));
  718. }
  719. ScriptCreateDialog::ScriptCreateDialog() {
  720. EDITOR_DEF("_script_setup_templates_dictionary", Dictionary());
  721. /* Main Controls */
  722. GridContainer *gc = memnew(GridContainer);
  723. gc->set_columns(2);
  724. /* Information Messages Field */
  725. validation_panel = memnew(EditorValidationPanel);
  726. validation_panel->add_line(MSG_ID_SCRIPT, TTR("Script path/name is valid."));
  727. validation_panel->add_line(MSG_ID_PATH, TTR("Will create a new script file."));
  728. validation_panel->add_line(MSG_ID_BUILT_IN);
  729. validation_panel->add_line(MSG_ID_TEMPLATE);
  730. validation_panel->set_update_callback(callable_mp(this, &ScriptCreateDialog::_update_dialog));
  731. validation_panel->set_accept_button(get_ok_button());
  732. /* Spacing */
  733. Control *spacing = memnew(Control);
  734. spacing->set_custom_minimum_size(Size2(0, 10 * EDSCALE));
  735. VBoxContainer *vb = memnew(VBoxContainer);
  736. vb->add_child(gc);
  737. vb->add_child(spacing);
  738. vb->add_child(validation_panel);
  739. add_child(vb);
  740. /* Language */
  741. language_menu = memnew(OptionButton);
  742. language_menu->set_custom_minimum_size(Size2(350, 0) * EDSCALE);
  743. language_menu->set_expand_icon(true);
  744. language_menu->set_h_size_flags(Control::SIZE_EXPAND_FILL);
  745. gc->add_child(memnew(Label(TTR("Language:"))));
  746. gc->add_child(language_menu);
  747. default_language = -1;
  748. for (int i = 0; i < ScriptServer::get_language_count(); i++) {
  749. String lang = ScriptServer::get_language(i)->get_name();
  750. language_menu->add_item(lang);
  751. if (lang == "GDScript") {
  752. default_language = i;
  753. }
  754. }
  755. if (default_language >= 0) {
  756. language_menu->select(default_language);
  757. }
  758. language_menu->connect(SceneStringName(item_selected), callable_mp(this, &ScriptCreateDialog::_language_changed));
  759. /* Inherits */
  760. base_type = "Object";
  761. HBoxContainer *hb = memnew(HBoxContainer);
  762. hb->set_h_size_flags(Control::SIZE_EXPAND_FILL);
  763. parent_name = memnew(LineEdit);
  764. parent_name->connect(SceneStringName(text_changed), callable_mp(this, &ScriptCreateDialog::_parent_name_changed));
  765. parent_name->set_h_size_flags(Control::SIZE_EXPAND_FILL);
  766. hb->add_child(parent_name);
  767. register_text_enter(parent_name);
  768. parent_search_button = memnew(Button);
  769. parent_search_button->connect(SceneStringName(pressed), callable_mp(this, &ScriptCreateDialog::_browse_class_in_tree));
  770. hb->add_child(parent_search_button);
  771. parent_browse_button = memnew(Button);
  772. parent_browse_button->connect(SceneStringName(pressed), callable_mp(this, &ScriptCreateDialog::_browse_path).bind(true, false));
  773. hb->add_child(parent_browse_button);
  774. gc->add_child(memnew(Label(TTR("Inherits:"))));
  775. gc->add_child(hb);
  776. /* Templates */
  777. gc->add_child(memnew(Label(TTR("Template:"))));
  778. HBoxContainer *template_hb = memnew(HBoxContainer);
  779. template_hb->set_h_size_flags(Control::SIZE_EXPAND_FILL);
  780. use_templates = memnew(CheckBox);
  781. use_templates->set_pressed(is_using_templates);
  782. use_templates->connect(SceneStringName(pressed), callable_mp(this, &ScriptCreateDialog::_use_template_pressed));
  783. template_hb->add_child(use_templates);
  784. template_inactive_message = "";
  785. template_menu = memnew(OptionButton);
  786. template_menu->set_h_size_flags(Control::SIZE_EXPAND_FILL);
  787. template_menu->connect(SceneStringName(item_selected), callable_mp(this, &ScriptCreateDialog::_template_changed));
  788. template_hb->add_child(template_menu);
  789. gc->add_child(template_hb);
  790. /* Built-in Script */
  791. built_in = memnew(CheckBox);
  792. built_in->set_text(TTR("On"));
  793. built_in->connect(SceneStringName(pressed), callable_mp(this, &ScriptCreateDialog::_built_in_pressed));
  794. gc->add_child(memnew(Label(TTR("Built-in Script:"))));
  795. gc->add_child(built_in);
  796. /* Path */
  797. hb = memnew(HBoxContainer);
  798. hb->connect(SceneStringName(sort_children), callable_mp(this, &ScriptCreateDialog::_path_hbox_sorted));
  799. file_path = memnew(LineEdit);
  800. file_path->connect(SceneStringName(text_changed), callable_mp(this, &ScriptCreateDialog::_path_changed));
  801. file_path->set_h_size_flags(Control::SIZE_EXPAND_FILL);
  802. hb->add_child(file_path);
  803. register_text_enter(file_path);
  804. path_button = memnew(Button);
  805. path_button->connect(SceneStringName(pressed), callable_mp(this, &ScriptCreateDialog::_browse_path).bind(false, true));
  806. hb->add_child(path_button);
  807. Label *label = memnew(Label(TTR("Path:")));
  808. gc->add_child(label);
  809. gc->add_child(hb);
  810. path_controls[0] = label;
  811. path_controls[1] = hb;
  812. /* Name */
  813. built_in_name = memnew(LineEdit);
  814. built_in_name->set_h_size_flags(Control::SIZE_EXPAND_FILL);
  815. register_text_enter(built_in_name);
  816. label = memnew(Label(TTR("Name:")));
  817. gc->add_child(label);
  818. gc->add_child(built_in_name);
  819. name_controls[0] = label;
  820. name_controls[1] = built_in_name;
  821. label->hide();
  822. built_in_name->hide();
  823. /* Dialog Setup */
  824. select_class = memnew(CreateDialog);
  825. select_class->connect("create", callable_mp(this, &ScriptCreateDialog::_create));
  826. add_child(select_class);
  827. file_browse = memnew(EditorFileDialog);
  828. file_browse->connect("file_selected", callable_mp(this, &ScriptCreateDialog::_file_selected));
  829. file_browse->set_file_mode(EditorFileDialog::FILE_MODE_OPEN_FILE);
  830. add_child(file_browse);
  831. set_ok_button_text(TTR("Create"));
  832. alert = memnew(AcceptDialog);
  833. alert->get_label()->set_autowrap_mode(TextServer::AUTOWRAP_WORD_SMART);
  834. alert->get_label()->set_horizontal_alignment(HORIZONTAL_ALIGNMENT_CENTER);
  835. alert->get_label()->set_vertical_alignment(VERTICAL_ALIGNMENT_CENTER);
  836. alert->get_label()->set_custom_minimum_size(Size2(325, 60) * EDSCALE);
  837. add_child(alert);
  838. set_hide_on_ok(false);
  839. set_title(TTR("Attach Node Script"));
  840. }