project_settings.cpp 43 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257
  1. /*************************************************************************/
  2. /* project_settings.cpp */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
  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 "project_settings.h"
  31. #include "core/bind/core_bind.h"
  32. #include "core/core_string_names.h"
  33. #include "core/io/file_access_network.h"
  34. #include "core/io/file_access_pack.h"
  35. #include "core/io/marshalls.h"
  36. #include "core/os/dir_access.h"
  37. #include "core/os/file_access.h"
  38. #include "core/os/keyboard.h"
  39. #include "core/os/os.h"
  40. #include "core/variant_parser.h"
  41. #include <zlib.h>
  42. const String ProjectSettings::PROJECT_DATA_DIR_NAME_SUFFIX = "import";
  43. ProjectSettings *ProjectSettings::singleton = nullptr;
  44. ProjectSettings *ProjectSettings::get_singleton() {
  45. return singleton;
  46. }
  47. String ProjectSettings::get_project_data_dir_name() const {
  48. return project_data_dir_name;
  49. }
  50. String ProjectSettings::get_project_data_path() const {
  51. return "res://" + get_project_data_dir_name();
  52. }
  53. String ProjectSettings::get_resource_path() const {
  54. return resource_path;
  55. };
  56. String ProjectSettings::localize_path(const String &p_path) const {
  57. if (resource_path.empty() || p_path.begins_with("res://") || p_path.begins_with("user://") ||
  58. (p_path.is_abs_path() && !p_path.begins_with(resource_path))) {
  59. return p_path.simplify_path();
  60. }
  61. DirAccess *dir = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
  62. String path = p_path.replace("\\", "/").simplify_path();
  63. if (dir->change_dir(path) == OK) {
  64. String cwd = dir->get_current_dir();
  65. cwd = cwd.replace("\\", "/");
  66. memdelete(dir);
  67. // Ensure that we end with a '/'.
  68. // This is important to ensure that we do not wrongly localize the resource path
  69. // in an absolute path that just happens to contain this string but points to a
  70. // different folder (e.g. "/my/project" as resource_path would be contained in
  71. // "/my/project_data", even though the latter is not part of res://.
  72. // `plus_file("")` is an easy way to ensure we have a trailing '/'.
  73. const String res_path = resource_path.plus_file("");
  74. // DirAccess::get_current_dir() is not guaranteed to return a path that with a trailing '/',
  75. // so we must make sure we have it as well in order to compare with 'res_path'.
  76. cwd = cwd.plus_file("");
  77. if (!cwd.begins_with(res_path)) {
  78. return p_path;
  79. };
  80. return cwd.replace_first(res_path, "res://");
  81. } else {
  82. memdelete(dir);
  83. int sep = path.find_last("/");
  84. if (sep == -1) {
  85. return "res://" + path;
  86. };
  87. String parent = path.substr(0, sep);
  88. String plocal = localize_path(parent);
  89. if (plocal == "") {
  90. return "";
  91. };
  92. // Only strip the starting '/' from 'path' if its parent ('plocal') ends with '/'
  93. if (plocal[plocal.length() - 1] == '/') {
  94. sep += 1;
  95. }
  96. return plocal + path.substr(sep, path.size() - sep);
  97. };
  98. }
  99. void ProjectSettings::set_initial_value(const String &p_name, const Variant &p_value) {
  100. ERR_FAIL_COND_MSG(!props.has(p_name), "Request for nonexistent project setting: " + p_name + ".");
  101. props[p_name].initial = p_value;
  102. }
  103. void ProjectSettings::set_restart_if_changed(const String &p_name, bool p_restart) {
  104. ERR_FAIL_COND_MSG(!props.has(p_name), "Request for nonexistent project setting: " + p_name + ".");
  105. props[p_name].restart_if_changed = p_restart;
  106. }
  107. void ProjectSettings::set_ignore_value_in_docs(const String &p_name, bool p_ignore) {
  108. ERR_FAIL_COND_MSG(!props.has(p_name), "Request for nonexistent project setting: " + p_name + ".");
  109. #ifdef DEBUG_METHODS_ENABLED
  110. props[p_name].ignore_value_in_docs = p_ignore;
  111. #endif
  112. }
  113. bool ProjectSettings::get_ignore_value_in_docs(const String &p_name) const {
  114. ERR_FAIL_COND_V_MSG(!props.has(p_name), false, "Request for nonexistent project setting: " + p_name + ".");
  115. #ifdef DEBUG_METHODS_ENABLED
  116. return props[p_name].ignore_value_in_docs;
  117. #else
  118. return false;
  119. #endif
  120. }
  121. String ProjectSettings::globalize_path(const String &p_path) const {
  122. if (p_path.begins_with("res://")) {
  123. if (resource_path != "") {
  124. return p_path.replace("res:/", resource_path);
  125. };
  126. return p_path.replace("res://", "");
  127. } else if (p_path.begins_with("user://")) {
  128. String data_dir = OS::get_singleton()->get_user_data_dir();
  129. if (data_dir != "") {
  130. return p_path.replace("user:/", data_dir);
  131. };
  132. return p_path.replace("user://", "");
  133. }
  134. return p_path;
  135. }
  136. bool ProjectSettings::_set(const StringName &p_name, const Variant &p_value) {
  137. _THREAD_SAFE_METHOD_
  138. if (p_value.get_type() == Variant::NIL) {
  139. props.erase(p_name);
  140. } else {
  141. if (p_name == CoreStringNames::get_singleton()->_custom_features) {
  142. Vector<String> custom_feature_array = String(p_value).split(",");
  143. for (int i = 0; i < custom_feature_array.size(); i++) {
  144. custom_features.insert(custom_feature_array[i]);
  145. }
  146. return true;
  147. }
  148. if (!disable_feature_overrides) {
  149. int dot = p_name.operator String().find(".");
  150. if (dot != -1) {
  151. Vector<String> s = p_name.operator String().split(".");
  152. bool override_valid = false;
  153. for (int i = 1; i < s.size(); i++) {
  154. String feature = s[i].strip_edges();
  155. if (OS::get_singleton()->has_feature(feature) || custom_features.has(feature)) {
  156. override_valid = true;
  157. break;
  158. }
  159. }
  160. if (override_valid) {
  161. feature_overrides[s[0]] = p_name;
  162. }
  163. }
  164. }
  165. if (props.has(p_name)) {
  166. if (!props[p_name].overridden) {
  167. props[p_name].variant = p_value;
  168. }
  169. } else {
  170. props[p_name] = VariantContainer(p_value, last_order++);
  171. }
  172. }
  173. return true;
  174. }
  175. bool ProjectSettings::_get(const StringName &p_name, Variant &r_ret) const {
  176. _THREAD_SAFE_METHOD_
  177. StringName name = p_name;
  178. if (!disable_feature_overrides && feature_overrides.has(name)) {
  179. name = feature_overrides[name];
  180. }
  181. if (!props.has(name)) {
  182. WARN_PRINT("Property not found: " + String(name));
  183. return false;
  184. }
  185. r_ret = props[name].variant;
  186. return true;
  187. }
  188. struct _VCSort {
  189. String name;
  190. Variant::Type type;
  191. int order;
  192. int flags;
  193. bool operator<(const _VCSort &p_vcs) const { return order == p_vcs.order ? name < p_vcs.name : order < p_vcs.order; }
  194. };
  195. void ProjectSettings::_get_property_list(List<PropertyInfo> *p_list) const {
  196. _THREAD_SAFE_METHOD_
  197. Set<_VCSort> vclist;
  198. for (Map<StringName, VariantContainer>::Element *E = props.front(); E; E = E->next()) {
  199. const VariantContainer *v = &E->get();
  200. if (v->hide_from_editor) {
  201. continue;
  202. }
  203. _VCSort vc;
  204. vc.name = E->key();
  205. vc.order = v->order;
  206. vc.type = v->variant.get_type();
  207. if (vc.name.begins_with("input/") || vc.name.begins_with("import/") || vc.name.begins_with("export/") || vc.name.begins_with("/remap") || vc.name.begins_with("/locale") || vc.name.begins_with("/autoload")) {
  208. vc.flags = PROPERTY_USAGE_STORAGE;
  209. } else {
  210. vc.flags = PROPERTY_USAGE_EDITOR | PROPERTY_USAGE_STORAGE;
  211. }
  212. if (v->restart_if_changed) {
  213. vc.flags |= PROPERTY_USAGE_RESTART_IF_CHANGED;
  214. }
  215. vclist.insert(vc);
  216. }
  217. for (Set<_VCSort>::Element *E = vclist.front(); E; E = E->next()) {
  218. String prop_info_name = E->get().name;
  219. int dot = prop_info_name.find(".");
  220. if (dot != -1) {
  221. prop_info_name = prop_info_name.substr(0, dot);
  222. }
  223. if (custom_prop_info.has(prop_info_name)) {
  224. PropertyInfo pi = custom_prop_info[prop_info_name];
  225. pi.name = E->get().name;
  226. pi.usage = E->get().flags;
  227. p_list->push_back(pi);
  228. } else {
  229. p_list->push_back(PropertyInfo(E->get().type, E->get().name, PROPERTY_HINT_NONE, "", E->get().flags));
  230. }
  231. }
  232. }
  233. bool ProjectSettings::_load_resource_pack(const String &p_pack, bool p_replace_files, int p_offset) {
  234. if (PackedData::get_singleton()->is_disabled()) {
  235. return false;
  236. }
  237. bool ok = PackedData::get_singleton()->add_pack(p_pack, p_replace_files, p_offset) == OK;
  238. if (!ok) {
  239. return false;
  240. }
  241. //if data.pck is found, all directory access will be from here
  242. DirAccess::make_default<DirAccessPack>(DirAccess::ACCESS_RESOURCES);
  243. using_datapack = true;
  244. return true;
  245. }
  246. void ProjectSettings::_convert_to_last_version(int p_from_version) {
  247. if (p_from_version <= 3) {
  248. // Converts the actions from array to dictionary (array of events to dictionary with deadzone + events)
  249. for (Map<StringName, ProjectSettings::VariantContainer>::Element *E = props.front(); E; E = E->next()) {
  250. Variant value = E->get().variant;
  251. if (String(E->key()).begins_with("input/") && value.get_type() == Variant::ARRAY) {
  252. Array array = value;
  253. Dictionary action;
  254. action["deadzone"] = Variant(0.5f);
  255. action["events"] = array;
  256. E->get().variant = action;
  257. }
  258. }
  259. }
  260. }
  261. /*
  262. * This method is responsible for loading a project.godot file and/or data file
  263. * using the following merit order:
  264. * - If using NetworkClient, try to lookup project file or fail.
  265. * - If --main-pack was passed by the user (`p_main_pack`), load it or fail.
  266. * - Search for project PCKs automatically. For each step we try loading a potential
  267. * PCK, and if it doesn't work, we proceed to the next step. If any step succeeds,
  268. * we try loading the project settings, and abort if it fails. Steps:
  269. * o Bundled PCK in the executable.
  270. * o [macOS only] PCK with same basename as the binary in the .app resource dir.
  271. * o PCK with same basename as the binary in the binary's directory. We handle both
  272. * changing the extension to '.pck' (e.g. 'win_game.exe' -> 'win_game.pck') and
  273. * appending '.pck' to the binary name (e.g. 'linux_game' -> 'linux_game.pck').
  274. * o PCK with the same basename as the binary in the current working directory.
  275. * Same as above for the two possible PCK file names.
  276. * - On relevant platforms (Android/iOS), lookup project file in OS resource path.
  277. * If found, load it or fail.
  278. * - Lookup project file in passed `p_path` (--path passed by the user), i.e. we
  279. * are running from source code.
  280. * If not found and `p_upwards` is true (--upwards passed by the user), look for
  281. * project files in parent folders up to the system root (used to run a game
  282. * from command line while in a subfolder).
  283. * If a project file is found, load it or fail.
  284. * If nothing was found, error out.
  285. */
  286. Error ProjectSettings::_setup(const String &p_path, const String &p_main_pack, bool p_upwards) {
  287. // If looking for files in a network client, use it directly
  288. if (FileAccessNetworkClient::get_singleton()) {
  289. Error err = _load_settings_text_or_binary("res://project.godot", "res://project.binary");
  290. if (err == OK) {
  291. // Optional, we don't mind if it fails
  292. _load_settings_text("res://override.cfg");
  293. }
  294. return err;
  295. }
  296. // Attempt with a user-defined main pack first
  297. if (p_main_pack != "") {
  298. bool ok = _load_resource_pack(p_main_pack);
  299. ERR_FAIL_COND_V_MSG(!ok, ERR_CANT_OPEN, "Cannot open resource pack '" + p_main_pack + "'.");
  300. Error err = _load_settings_text_or_binary("res://project.godot", "res://project.binary");
  301. if (err == OK) {
  302. // Load override from location of the main pack
  303. // Optional, we don't mind if it fails
  304. _load_settings_text(p_main_pack.get_base_dir().plus_file("override.cfg"));
  305. }
  306. return err;
  307. }
  308. String exec_path = OS::get_singleton()->get_executable_path();
  309. if (exec_path != "") {
  310. // We do several tests sequentially until one succeeds to find a PCK,
  311. // and if so we attempt loading it at the end.
  312. // Attempt with PCK bundled into executable.
  313. bool found = _load_resource_pack(exec_path);
  314. // Attempt with exec_name.pck.
  315. // (This is the usual case when distributing a Godot game.)
  316. String exec_dir = exec_path.get_base_dir();
  317. String exec_filename = exec_path.get_file();
  318. String exec_basename = exec_filename.get_basename();
  319. // Based on the OS, it can be the exec path + '.pck' (Linux w/o extension, macOS in .app bundle)
  320. // or the exec path's basename + '.pck' (Windows).
  321. // We need to test both possibilities as extensions for Linux binaries are optional
  322. // (so both 'mygame.bin' and 'mygame' should be able to find 'mygame.pck').
  323. #ifdef OSX_ENABLED
  324. if (!found) {
  325. // Attempt to load PCK from macOS .app bundle resources.
  326. found = _load_resource_pack(OS::get_singleton()->get_bundle_resource_dir().plus_file(exec_basename + ".pck")) || _load_resource_pack(OS::get_singleton()->get_bundle_resource_dir().plus_file(exec_filename + ".pck"));
  327. }
  328. #endif
  329. if (!found) {
  330. // Try to load data pack at the location of the executable.
  331. // As mentioned above, we have two potential names to attempt.
  332. found = _load_resource_pack(exec_dir.plus_file(exec_basename + ".pck")) || _load_resource_pack(exec_dir.plus_file(exec_filename + ".pck"));
  333. }
  334. if (!found) {
  335. // If we couldn't find them next to the executable, we attempt
  336. // the current working directory. Same story, two tests.
  337. found = _load_resource_pack(exec_basename + ".pck") || _load_resource_pack(exec_filename + ".pck");
  338. }
  339. // If we opened our package, try and load our project.
  340. if (found) {
  341. Error err = _load_settings_text_or_binary("res://project.godot", "res://project.binary");
  342. if (err == OK) {
  343. // Load override from location of the executable.
  344. // Optional, we don't mind if it fails.
  345. _load_settings_text(exec_path.get_base_dir().plus_file("override.cfg"));
  346. }
  347. return err;
  348. }
  349. }
  350. // Try to use the filesystem for files, according to OS.
  351. // (Only Android -when reading from pck- and iOS use this.)
  352. if (OS::get_singleton()->get_resource_dir() != "") {
  353. // OS will call ProjectSettings->get_resource_path which will be empty if not overridden!
  354. // If the OS would rather use a specific location, then it will not be empty.
  355. resource_path = OS::get_singleton()->get_resource_dir().replace("\\", "/");
  356. if (resource_path != "" && resource_path[resource_path.length() - 1] == '/') {
  357. resource_path = resource_path.substr(0, resource_path.length() - 1); // Chop end.
  358. }
  359. Error err = _load_settings_text_or_binary("res://project.godot", "res://project.binary");
  360. if (err == OK) {
  361. // Optional, we don't mind if it fails.
  362. _load_settings_text("res://override.cfg");
  363. }
  364. return err;
  365. }
  366. // Nothing was found, try to find a project file in provided path (`p_path`)
  367. // or, if requested (`p_upwards`) in parent directories.
  368. DirAccess *d = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
  369. ERR_FAIL_COND_V_MSG(!d, ERR_CANT_CREATE, "Cannot create DirAccess for path '" + p_path + "'.");
  370. d->change_dir(p_path);
  371. String current_dir = d->get_current_dir();
  372. String candidate = current_dir;
  373. bool found = false;
  374. Error err;
  375. while (true) {
  376. err = _load_settings_text_or_binary(current_dir.plus_file("project.godot"), current_dir.plus_file("project.binary"));
  377. if (err == OK) {
  378. // Optional, we don't mind if it fails.
  379. _load_settings_text(current_dir.plus_file("override.cfg"));
  380. candidate = current_dir;
  381. found = true;
  382. break;
  383. }
  384. if (p_upwards) {
  385. // Try to load settings ascending through parent directories
  386. d->change_dir("..");
  387. if (d->get_current_dir() == current_dir) {
  388. break; // not doing anything useful
  389. }
  390. current_dir = d->get_current_dir();
  391. } else {
  392. break;
  393. }
  394. }
  395. resource_path = candidate;
  396. resource_path = resource_path.replace("\\", "/"); // Windows path to Unix path just in case.
  397. memdelete(d);
  398. if (!found) {
  399. return err;
  400. }
  401. if (resource_path.length() && resource_path[resource_path.length() - 1] == '/') {
  402. resource_path = resource_path.substr(0, resource_path.length() - 1); // Chop end.
  403. }
  404. return OK;
  405. }
  406. Error ProjectSettings::setup(const String &p_path, const String &p_main_pack, bool p_upwards) {
  407. Error err = _setup(p_path, p_main_pack, p_upwards);
  408. if (err == OK) {
  409. String custom_settings = GLOBAL_DEF("application/config/project_settings_override", "");
  410. if (custom_settings != "") {
  411. _load_settings_text(custom_settings);
  412. }
  413. }
  414. // Updating the default value after the project settings have loaded.
  415. bool use_hidden_directory = GLOBAL_GET("application/config/use_hidden_project_data_directory");
  416. project_data_dir_name = (use_hidden_directory ? "." : "") + PROJECT_DATA_DIR_NAME_SUFFIX;
  417. // Using GLOBAL_GET on every block for compressing can be slow, so assigning here.
  418. Compression::zstd_long_distance_matching = GLOBAL_GET("compression/formats/zstd/long_distance_matching");
  419. Compression::zstd_level = GLOBAL_GET("compression/formats/zstd/compression_level");
  420. Compression::zstd_window_log_size = GLOBAL_GET("compression/formats/zstd/window_log_size");
  421. Compression::zlib_level = GLOBAL_GET("compression/formats/zlib/compression_level");
  422. Compression::gzip_level = GLOBAL_GET("compression/formats/gzip/compression_level");
  423. return err;
  424. }
  425. bool ProjectSettings::has_setting(String p_var) const {
  426. _THREAD_SAFE_METHOD_
  427. return props.has(p_var);
  428. }
  429. void ProjectSettings::set_registering_order(bool p_enable) {
  430. registering_order = p_enable;
  431. }
  432. Error ProjectSettings::_load_settings_binary(const String &p_path) {
  433. Error err;
  434. FileAccess *f = FileAccess::open(p_path, FileAccess::READ, &err);
  435. if (err != OK) {
  436. return err;
  437. }
  438. uint8_t hdr[4];
  439. f->get_buffer(hdr, 4);
  440. if (hdr[0] != 'E' || hdr[1] != 'C' || hdr[2] != 'F' || hdr[3] != 'G') {
  441. memdelete(f);
  442. ERR_FAIL_V_MSG(ERR_FILE_CORRUPT, "Corrupted header in binary project.binary (not ECFG).");
  443. }
  444. uint32_t count = f->get_32();
  445. for (uint32_t i = 0; i < count; i++) {
  446. uint32_t slen = f->get_32();
  447. CharString cs;
  448. cs.resize(slen + 1);
  449. cs[slen] = 0;
  450. f->get_buffer((uint8_t *)cs.ptr(), slen);
  451. String key;
  452. key.parse_utf8(cs.ptr());
  453. uint32_t vlen = f->get_32();
  454. Vector<uint8_t> d;
  455. d.resize(vlen);
  456. f->get_buffer(d.ptrw(), vlen);
  457. Variant value;
  458. err = decode_variant(value, d.ptr(), d.size(), nullptr, true);
  459. ERR_CONTINUE_MSG(err != OK, "Error decoding property: " + key + ".");
  460. set(key, value);
  461. }
  462. f->close();
  463. memdelete(f);
  464. return OK;
  465. }
  466. Error ProjectSettings::_load_settings_text(const String &p_path) {
  467. Error err;
  468. FileAccess *f = FileAccess::open(p_path, FileAccess::READ, &err);
  469. if (!f) {
  470. // FIXME: Above 'err' error code is ERR_FILE_CANT_OPEN if the file is missing
  471. // This needs to be streamlined if we want decent error reporting
  472. return ERR_FILE_NOT_FOUND;
  473. }
  474. VariantParser::StreamFile stream;
  475. stream.f = f;
  476. String assign;
  477. Variant value;
  478. VariantParser::Tag next_tag;
  479. int lines = 0;
  480. String error_text;
  481. String section;
  482. int config_version = 0;
  483. while (true) {
  484. assign = Variant();
  485. next_tag.fields.clear();
  486. next_tag.name = String();
  487. err = VariantParser::parse_tag_assign_eof(&stream, lines, error_text, next_tag, assign, value, nullptr, true);
  488. if (err == ERR_FILE_EOF) {
  489. memdelete(f);
  490. // If we're loading a project.godot from source code, we can operate some
  491. // ProjectSettings conversions if need be.
  492. _convert_to_last_version(config_version);
  493. last_save_time = FileAccess::get_modified_time(get_resource_path().plus_file("project.godot"));
  494. return OK;
  495. } else if (err != OK) {
  496. ERR_PRINT("Error parsing " + p_path + " at line " + itos(lines) + ": " + error_text + " File might be corrupted.");
  497. memdelete(f);
  498. return err;
  499. }
  500. if (assign != String()) {
  501. if (section == String() && assign == "config_version") {
  502. config_version = value;
  503. if (config_version > CONFIG_VERSION) {
  504. memdelete(f);
  505. ERR_FAIL_V_MSG(ERR_FILE_CANT_OPEN, vformat("Can't open project at '%s', its `config_version` (%d) is from a more recent and incompatible version of the engine. Expected config version: %d.", p_path, config_version, CONFIG_VERSION));
  506. }
  507. } else {
  508. if (section == String()) {
  509. set(assign, value);
  510. } else {
  511. set(section + "/" + assign, value);
  512. }
  513. }
  514. } else if (next_tag.name != String()) {
  515. section = next_tag.name;
  516. }
  517. }
  518. }
  519. Error ProjectSettings::_load_settings_text_or_binary(const String &p_text_path, const String &p_bin_path) {
  520. // Attempt first to load the binary project.godot file.
  521. Error err = _load_settings_binary(p_bin_path);
  522. if (err == OK) {
  523. return OK;
  524. } else if (err != ERR_FILE_NOT_FOUND) {
  525. // If the file exists but can't be loaded, we want to know it.
  526. ERR_PRINT("Couldn't load file '" + p_bin_path + "', error code " + itos(err) + ".");
  527. }
  528. // Fallback to text-based project.godot file if binary was not found.
  529. err = _load_settings_text(p_text_path);
  530. if (err == OK) {
  531. return OK;
  532. } else if (err != ERR_FILE_NOT_FOUND) {
  533. ERR_PRINT("Couldn't load file '" + p_text_path + "', error code " + itos(err) + ".");
  534. }
  535. return err;
  536. }
  537. int ProjectSettings::get_order(const String &p_name) const {
  538. ERR_FAIL_COND_V_MSG(!props.has(p_name), -1, "Request for nonexistent project setting: " + p_name + ".");
  539. return props[p_name].order;
  540. }
  541. void ProjectSettings::set_order(const String &p_name, int p_order) {
  542. ERR_FAIL_COND_MSG(!props.has(p_name), "Request for nonexistent project setting: " + p_name + ".");
  543. props[p_name].order = p_order;
  544. }
  545. void ProjectSettings::set_builtin_order(const String &p_name) {
  546. ERR_FAIL_COND_MSG(!props.has(p_name), "Request for nonexistent project setting: " + p_name + ".");
  547. if (props[p_name].order >= NO_BUILTIN_ORDER_BASE) {
  548. props[p_name].order = last_builtin_order++;
  549. }
  550. }
  551. void ProjectSettings::clear(const String &p_name) {
  552. ERR_FAIL_COND_MSG(!props.has(p_name), "Request for nonexistent project setting: " + p_name + ".");
  553. props.erase(p_name);
  554. }
  555. Error ProjectSettings::save() {
  556. Error error = save_custom(get_resource_path().plus_file("project.godot"));
  557. if (error == OK) {
  558. last_save_time = FileAccess::get_modified_time(get_resource_path().plus_file("project.godot"));
  559. }
  560. return error;
  561. }
  562. Error ProjectSettings::_save_settings_binary(const String &p_file, const Map<String, List<String>> &props, const CustomMap &p_custom, const String &p_custom_features) {
  563. Error err;
  564. FileAccess *file = FileAccess::open(p_file, FileAccess::WRITE, &err);
  565. ERR_FAIL_COND_V_MSG(err != OK, err, "Couldn't save project.binary at " + p_file + ".");
  566. uint8_t hdr[4] = { 'E', 'C', 'F', 'G' };
  567. file->store_buffer(hdr, 4);
  568. int count = 0;
  569. for (Map<String, List<String>>::Element *E = props.front(); E; E = E->next()) {
  570. for (List<String>::Element *F = E->get().front(); F; F = F->next()) {
  571. count++;
  572. }
  573. }
  574. if (p_custom_features != String()) {
  575. file->store_32(count + 1);
  576. //store how many properties are saved, add one for custom featuers, which must always go first
  577. String key = CoreStringNames::get_singleton()->_custom_features;
  578. file->store_pascal_string(key);
  579. int len;
  580. err = encode_variant(p_custom_features, nullptr, len, false);
  581. if (err != OK) {
  582. memdelete(file);
  583. ERR_FAIL_V(err);
  584. }
  585. Vector<uint8_t> buff;
  586. buff.resize(len);
  587. err = encode_variant(p_custom_features, buff.ptrw(), len, false);
  588. if (err != OK) {
  589. memdelete(file);
  590. ERR_FAIL_V(err);
  591. }
  592. file->store_32(len);
  593. file->store_buffer(buff.ptr(), buff.size());
  594. } else {
  595. file->store_32(count); //store how many properties are saved
  596. }
  597. for (Map<String, List<String>>::Element *E = props.front(); E; E = E->next()) {
  598. for (List<String>::Element *F = E->get().front(); F; F = F->next()) {
  599. String key = F->get();
  600. if (E->key() != "") {
  601. key = E->key() + "/" + key;
  602. }
  603. Variant value;
  604. if (p_custom.has(key)) {
  605. value = p_custom[key];
  606. } else {
  607. value = get(key);
  608. }
  609. file->store_pascal_string(key);
  610. int len;
  611. err = encode_variant(value, nullptr, len, true);
  612. if (err != OK) {
  613. memdelete(file);
  614. }
  615. ERR_FAIL_COND_V_MSG(err != OK, ERR_INVALID_DATA, "Error when trying to encode Variant.");
  616. Vector<uint8_t> buff;
  617. buff.resize(len);
  618. err = encode_variant(value, buff.ptrw(), len, true);
  619. if (err != OK) {
  620. memdelete(file);
  621. }
  622. ERR_FAIL_COND_V_MSG(err != OK, ERR_INVALID_DATA, "Error when trying to encode Variant.");
  623. file->store_32(len);
  624. file->store_buffer(buff.ptr(), buff.size());
  625. }
  626. }
  627. file->close();
  628. memdelete(file);
  629. return OK;
  630. }
  631. Error ProjectSettings::_save_settings_text(const String &p_file, const Map<String, List<String>> &props, const CustomMap &p_custom, const String &p_custom_features) {
  632. Error err;
  633. FileAccess *file = FileAccess::open(p_file, FileAccess::WRITE, &err);
  634. ERR_FAIL_COND_V_MSG(err != OK, err, "Couldn't save project.godot - " + p_file + ".");
  635. file->store_line("; Engine configuration file.");
  636. file->store_line("; It's best edited using the editor UI and not directly,");
  637. file->store_line("; since the parameters that go here are not all obvious.");
  638. file->store_line(";");
  639. file->store_line("; Format:");
  640. file->store_line("; [section] ; section goes between []");
  641. file->store_line("; param=value ; assign values to parameters");
  642. file->store_line("");
  643. file->store_string("config_version=" + itos(CONFIG_VERSION) + "\n");
  644. if (p_custom_features != String()) {
  645. file->store_string("custom_features=\"" + p_custom_features + "\"\n");
  646. }
  647. file->store_string("\n");
  648. for (Map<String, List<String>>::Element *E = props.front(); E; E = E->next()) {
  649. if (E != props.front()) {
  650. file->store_string("\n");
  651. }
  652. if (E->key() != "") {
  653. file->store_string("[" + E->key() + "]\n\n");
  654. }
  655. for (List<String>::Element *F = E->get().front(); F; F = F->next()) {
  656. String key = F->get();
  657. if (E->key() != "") {
  658. key = E->key() + "/" + key;
  659. }
  660. Variant value;
  661. if (p_custom.has(key)) {
  662. value = p_custom[key];
  663. } else {
  664. value = get(key);
  665. }
  666. String vstr;
  667. VariantWriter::write_to_string(value, vstr);
  668. file->store_string(F->get().property_name_encode() + "=" + vstr + "\n");
  669. }
  670. }
  671. file->close();
  672. memdelete(file);
  673. return OK;
  674. }
  675. Error ProjectSettings::_save_custom_bnd(const String &p_file) { // add other params as dictionary and array?
  676. return save_custom(p_file);
  677. };
  678. Error ProjectSettings::save_custom(const String &p_path, const CustomMap &p_custom, const Vector<String> &p_custom_features, bool p_merge_with_current) {
  679. ERR_FAIL_COND_V_MSG(p_path == "", ERR_INVALID_PARAMETER, "Project settings save path cannot be empty.");
  680. Set<_VCSort> vclist;
  681. if (p_merge_with_current) {
  682. for (Map<StringName, VariantContainer>::Element *G = props.front(); G; G = G->next()) {
  683. const VariantContainer *v = &G->get();
  684. if (v->hide_from_editor) {
  685. continue;
  686. }
  687. if (p_custom.has(G->key())) {
  688. continue;
  689. }
  690. _VCSort vc;
  691. vc.name = G->key(); //*k;
  692. vc.order = v->order;
  693. vc.type = v->variant.get_type();
  694. vc.flags = PROPERTY_USAGE_EDITOR | PROPERTY_USAGE_STORAGE;
  695. if (v->variant == v->initial) {
  696. continue;
  697. }
  698. vclist.insert(vc);
  699. }
  700. }
  701. for (const Map<String, Variant>::Element *E = p_custom.front(); E; E = E->next()) {
  702. // Lookup global prop to store in the same order
  703. Map<StringName, VariantContainer>::Element *global_prop = props.find(E->key());
  704. _VCSort vc;
  705. vc.name = E->key();
  706. vc.order = global_prop ? global_prop->get().order : 0xFFFFFFF;
  707. vc.type = E->get().get_type();
  708. vc.flags = PROPERTY_USAGE_STORAGE;
  709. vclist.insert(vc);
  710. }
  711. Map<String, List<String>> props;
  712. for (Set<_VCSort>::Element *E = vclist.front(); E; E = E->next()) {
  713. String category = E->get().name;
  714. String name = E->get().name;
  715. int div = category.find("/");
  716. if (div < 0) {
  717. category = "";
  718. } else {
  719. category = category.substr(0, div);
  720. name = name.substr(div + 1, name.size());
  721. }
  722. props[category].push_back(name);
  723. }
  724. String custom_features;
  725. for (int i = 0; i < p_custom_features.size(); i++) {
  726. if (i > 0) {
  727. custom_features += ",";
  728. }
  729. String f = p_custom_features[i].strip_edges().replace("\"", "");
  730. custom_features += f;
  731. }
  732. if (p_path.ends_with(".godot") || p_path.ends_with("override.cfg")) {
  733. return _save_settings_text(p_path, props, p_custom, custom_features);
  734. } else if (p_path.ends_with(".binary")) {
  735. return _save_settings_binary(p_path, props, p_custom, custom_features);
  736. } else {
  737. ERR_FAIL_V_MSG(ERR_FILE_UNRECOGNIZED, "Unknown config file format: " + p_path + ".");
  738. }
  739. }
  740. Variant _GLOBAL_DEF_ALIAS(const String &p_var, const String &p_old_name, const Variant &p_default, bool p_restart_if_changed) {
  741. // if the new name setting isn't present, try the old one
  742. if (!ProjectSettings::get_singleton()->has_setting(p_var)) {
  743. if (ProjectSettings::get_singleton()->has_setting(p_old_name)) {
  744. // if the old setting is present, get the value and set it in the new setting
  745. Variant value = ProjectSettings::get_singleton()->get(p_old_name);
  746. ProjectSettings::get_singleton()->set(p_var, value);
  747. }
  748. }
  749. return _GLOBAL_DEF(p_var, p_default, p_restart_if_changed);
  750. }
  751. Variant _GLOBAL_DEF(const String &p_var, const Variant &p_default, bool p_restart_if_changed, bool p_ignore_value_in_docs) {
  752. Variant ret;
  753. if (!ProjectSettings::get_singleton()->has_setting(p_var)) {
  754. ProjectSettings::get_singleton()->set(p_var, p_default);
  755. }
  756. ret = ProjectSettings::get_singleton()->get(p_var);
  757. ProjectSettings::get_singleton()->set_initial_value(p_var, p_default);
  758. ProjectSettings::get_singleton()->set_builtin_order(p_var);
  759. ProjectSettings::get_singleton()->set_restart_if_changed(p_var, p_restart_if_changed);
  760. ProjectSettings::get_singleton()->set_ignore_value_in_docs(p_var, p_ignore_value_in_docs);
  761. return ret;
  762. }
  763. Vector<String> ProjectSettings::get_optimizer_presets() const {
  764. List<PropertyInfo> pi;
  765. ProjectSettings::get_singleton()->get_property_list(&pi);
  766. Vector<String> names;
  767. for (List<PropertyInfo>::Element *E = pi.front(); E; E = E->next()) {
  768. if (!E->get().name.begins_with("optimizer_presets/")) {
  769. continue;
  770. }
  771. names.push_back(E->get().name.get_slicec('/', 1));
  772. }
  773. names.sort();
  774. return names;
  775. }
  776. void ProjectSettings::_add_property_info_bind(const Dictionary &p_info) {
  777. ERR_FAIL_COND(!p_info.has("name"));
  778. ERR_FAIL_COND(!p_info.has("type"));
  779. PropertyInfo pinfo;
  780. pinfo.name = p_info["name"];
  781. ERR_FAIL_COND(!props.has(pinfo.name));
  782. pinfo.type = Variant::Type(p_info["type"].operator int());
  783. ERR_FAIL_INDEX(pinfo.type, Variant::VARIANT_MAX);
  784. if (p_info.has("hint")) {
  785. pinfo.hint = PropertyHint(p_info["hint"].operator int());
  786. }
  787. if (p_info.has("hint_string")) {
  788. pinfo.hint_string = p_info["hint_string"];
  789. }
  790. set_custom_property_info(pinfo.name, pinfo);
  791. }
  792. void ProjectSettings::set_custom_property_info(const String &p_prop, const PropertyInfo &p_info) {
  793. ERR_FAIL_COND(!props.has(p_prop));
  794. custom_prop_info[p_prop] = p_info;
  795. custom_prop_info[p_prop].name = p_prop;
  796. }
  797. const Map<StringName, PropertyInfo> &ProjectSettings::get_custom_property_info() const {
  798. return custom_prop_info;
  799. }
  800. void ProjectSettings::set_disable_feature_overrides(bool p_disable) {
  801. disable_feature_overrides = p_disable;
  802. }
  803. bool ProjectSettings::is_using_datapack() const {
  804. return using_datapack;
  805. }
  806. bool ProjectSettings::property_can_revert(const String &p_name) {
  807. if (!props.has(p_name)) {
  808. return false;
  809. }
  810. return props[p_name].initial != props[p_name].variant;
  811. }
  812. Variant ProjectSettings::property_get_revert(const String &p_name) {
  813. if (!props.has(p_name)) {
  814. return Variant();
  815. }
  816. return props[p_name].initial;
  817. }
  818. void ProjectSettings::set_setting(const String &p_setting, const Variant &p_value) {
  819. set(p_setting, p_value);
  820. }
  821. Variant ProjectSettings::get_setting(const String &p_setting) const {
  822. return get(p_setting);
  823. }
  824. bool ProjectSettings::has_custom_feature(const String &p_feature) const {
  825. return custom_features.has(p_feature);
  826. }
  827. void ProjectSettings::_bind_methods() {
  828. ClassDB::bind_method(D_METHOD("has_setting", "name"), &ProjectSettings::has_setting);
  829. ClassDB::bind_method(D_METHOD("set_setting", "name", "value"), &ProjectSettings::set_setting);
  830. ClassDB::bind_method(D_METHOD("get_setting", "name"), &ProjectSettings::get_setting);
  831. ClassDB::bind_method(D_METHOD("set_order", "name", "position"), &ProjectSettings::set_order);
  832. ClassDB::bind_method(D_METHOD("get_order", "name"), &ProjectSettings::get_order);
  833. ClassDB::bind_method(D_METHOD("set_initial_value", "name", "value"), &ProjectSettings::set_initial_value);
  834. ClassDB::bind_method(D_METHOD("add_property_info", "hint"), &ProjectSettings::_add_property_info_bind);
  835. ClassDB::bind_method(D_METHOD("clear", "name"), &ProjectSettings::clear);
  836. ClassDB::bind_method(D_METHOD("localize_path", "path"), &ProjectSettings::localize_path);
  837. ClassDB::bind_method(D_METHOD("globalize_path", "path"), &ProjectSettings::globalize_path);
  838. ClassDB::bind_method(D_METHOD("save"), &ProjectSettings::save);
  839. ClassDB::bind_method(D_METHOD("load_resource_pack", "pack", "replace_files", "offset"), &ProjectSettings::_load_resource_pack, DEFVAL(true), DEFVAL(0));
  840. ClassDB::bind_method(D_METHOD("property_can_revert", "name"), &ProjectSettings::property_can_revert);
  841. ClassDB::bind_method(D_METHOD("property_get_revert", "name"), &ProjectSettings::property_get_revert);
  842. ClassDB::bind_method(D_METHOD("save_custom", "file"), &ProjectSettings::_save_custom_bnd);
  843. }
  844. ProjectSettings::ProjectSettings() {
  845. // Initialization of engine variables should be done in the setup() method,
  846. // so that the values can be overridden from project.godot or project.binary.
  847. singleton = this;
  848. last_order = NO_BUILTIN_ORDER_BASE;
  849. last_builtin_order = 0;
  850. disable_feature_overrides = false;
  851. registering_order = true;
  852. Array events;
  853. Dictionary action;
  854. Ref<InputEventKey> key;
  855. Ref<InputEventJoypadButton> joyb;
  856. GLOBAL_DEF("application/config/name", "");
  857. GLOBAL_DEF("application/config/description", "");
  858. custom_prop_info["application/config/description"] = PropertyInfo(Variant::STRING, "application/config/description", PROPERTY_HINT_MULTILINE_TEXT);
  859. GLOBAL_DEF("application/run/main_scene", "");
  860. custom_prop_info["application/run/main_scene"] = PropertyInfo(Variant::STRING, "application/run/main_scene", PROPERTY_HINT_FILE, "*.tscn,*.scn,*.res");
  861. GLOBAL_DEF("application/run/disable_stdout", false);
  862. GLOBAL_DEF("application/run/disable_stderr", false);
  863. GLOBAL_DEF_RST("application/config/use_hidden_project_data_directory", true);
  864. GLOBAL_DEF("application/config/use_custom_user_dir", false);
  865. GLOBAL_DEF("application/config/custom_user_dir_name", "");
  866. GLOBAL_DEF("application/config/project_settings_override", "");
  867. GLOBAL_DEF("audio/default_bus_layout", "res://default_bus_layout.tres");
  868. custom_prop_info["audio/default_bus_layout"] = PropertyInfo(Variant::STRING, "audio/default_bus_layout", PROPERTY_HINT_FILE, "*.tres");
  869. PoolStringArray extensions = PoolStringArray();
  870. extensions.push_back("gd");
  871. if (Engine::get_singleton()->has_singleton("GodotSharp")) {
  872. extensions.push_back("cs");
  873. }
  874. extensions.push_back("gdshader");
  875. extensions.push_back("shader");
  876. GLOBAL_DEF("editor/main_run_args", "");
  877. GLOBAL_DEF("editor/search_in_file_extensions", extensions);
  878. custom_prop_info["editor/search_in_file_extensions"] = PropertyInfo(Variant::POOL_STRING_ARRAY, "editor/search_in_file_extensions");
  879. GLOBAL_DEF("editor/script_templates_search_path", "res://script_templates");
  880. custom_prop_info["editor/script_templates_search_path"] = PropertyInfo(Variant::STRING, "editor/script_templates_search_path", PROPERTY_HINT_DIR);
  881. action = Dictionary();
  882. action["deadzone"] = Variant(0.5f);
  883. events = Array();
  884. key.instance();
  885. key->set_scancode(KEY_ENTER);
  886. events.push_back(key);
  887. key.instance();
  888. key->set_scancode(KEY_KP_ENTER);
  889. events.push_back(key);
  890. key.instance();
  891. key->set_scancode(KEY_SPACE);
  892. events.push_back(key);
  893. joyb.instance();
  894. joyb->set_button_index(JOY_BUTTON_0);
  895. events.push_back(joyb);
  896. action["events"] = events;
  897. GLOBAL_DEF("input/ui_accept", action);
  898. input_presets.push_back("input/ui_accept");
  899. action = Dictionary();
  900. action["deadzone"] = Variant(0.5f);
  901. events = Array();
  902. key.instance();
  903. key->set_scancode(KEY_SPACE);
  904. events.push_back(key);
  905. joyb.instance();
  906. joyb->set_button_index(JOY_BUTTON_3);
  907. events.push_back(joyb);
  908. action["events"] = events;
  909. GLOBAL_DEF("input/ui_select", action);
  910. input_presets.push_back("input/ui_select");
  911. action = Dictionary();
  912. action["deadzone"] = Variant(0.5f);
  913. events = Array();
  914. key.instance();
  915. key->set_scancode(KEY_ESCAPE);
  916. events.push_back(key);
  917. joyb.instance();
  918. joyb->set_button_index(JOY_BUTTON_1);
  919. events.push_back(joyb);
  920. action["events"] = events;
  921. GLOBAL_DEF("input/ui_cancel", action);
  922. input_presets.push_back("input/ui_cancel");
  923. action = Dictionary();
  924. action["deadzone"] = Variant(0.5f);
  925. events = Array();
  926. key.instance();
  927. key->set_scancode(KEY_TAB);
  928. events.push_back(key);
  929. action["events"] = events;
  930. GLOBAL_DEF("input/ui_focus_next", action);
  931. input_presets.push_back("input/ui_focus_next");
  932. action = Dictionary();
  933. action["deadzone"] = Variant(0.5f);
  934. events = Array();
  935. key.instance();
  936. key->set_scancode(KEY_TAB);
  937. key->set_shift(true);
  938. events.push_back(key);
  939. action["events"] = events;
  940. GLOBAL_DEF("input/ui_focus_prev", action);
  941. input_presets.push_back("input/ui_focus_prev");
  942. action = Dictionary();
  943. action["deadzone"] = Variant(0.5f);
  944. events = Array();
  945. key.instance();
  946. key->set_scancode(KEY_LEFT);
  947. events.push_back(key);
  948. joyb.instance();
  949. joyb->set_button_index(JOY_DPAD_LEFT);
  950. events.push_back(joyb);
  951. action["events"] = events;
  952. GLOBAL_DEF("input/ui_left", action);
  953. input_presets.push_back("input/ui_left");
  954. action = Dictionary();
  955. action["deadzone"] = Variant(0.5f);
  956. events = Array();
  957. key.instance();
  958. key->set_scancode(KEY_RIGHT);
  959. events.push_back(key);
  960. joyb.instance();
  961. joyb->set_button_index(JOY_DPAD_RIGHT);
  962. events.push_back(joyb);
  963. action["events"] = events;
  964. GLOBAL_DEF("input/ui_right", action);
  965. input_presets.push_back("input/ui_right");
  966. action = Dictionary();
  967. action["deadzone"] = Variant(0.5f);
  968. events = Array();
  969. key.instance();
  970. key->set_scancode(KEY_UP);
  971. events.push_back(key);
  972. joyb.instance();
  973. joyb->set_button_index(JOY_DPAD_UP);
  974. events.push_back(joyb);
  975. action["events"] = events;
  976. GLOBAL_DEF("input/ui_up", action);
  977. input_presets.push_back("input/ui_up");
  978. action = Dictionary();
  979. action["deadzone"] = Variant(0.5f);
  980. events = Array();
  981. key.instance();
  982. key->set_scancode(KEY_DOWN);
  983. events.push_back(key);
  984. joyb.instance();
  985. joyb->set_button_index(JOY_DPAD_DOWN);
  986. events.push_back(joyb);
  987. action["events"] = events;
  988. GLOBAL_DEF("input/ui_down", action);
  989. input_presets.push_back("input/ui_down");
  990. action = Dictionary();
  991. action["deadzone"] = Variant(0.5f);
  992. events = Array();
  993. key.instance();
  994. key->set_scancode(KEY_PAGEUP);
  995. events.push_back(key);
  996. action["events"] = events;
  997. GLOBAL_DEF("input/ui_page_up", action);
  998. input_presets.push_back("input/ui_page_up");
  999. action = Dictionary();
  1000. action["deadzone"] = Variant(0.5f);
  1001. events = Array();
  1002. key.instance();
  1003. key->set_scancode(KEY_PAGEDOWN);
  1004. events.push_back(key);
  1005. action["events"] = events;
  1006. GLOBAL_DEF("input/ui_page_down", action);
  1007. input_presets.push_back("input/ui_page_down");
  1008. action = Dictionary();
  1009. action["deadzone"] = Variant(0.5f);
  1010. events = Array();
  1011. key.instance();
  1012. key->set_scancode(KEY_HOME);
  1013. events.push_back(key);
  1014. action["events"] = events;
  1015. GLOBAL_DEF("input/ui_home", action);
  1016. input_presets.push_back("input/ui_home");
  1017. action = Dictionary();
  1018. action["deadzone"] = Variant(0.5f);
  1019. events = Array();
  1020. key.instance();
  1021. key->set_scancode(KEY_END);
  1022. events.push_back(key);
  1023. action["events"] = events;
  1024. GLOBAL_DEF("input/ui_end", action);
  1025. input_presets.push_back("input/ui_end");
  1026. custom_prop_info["display/window/handheld/orientation"] = PropertyInfo(Variant::STRING, "display/window/handheld/orientation", PROPERTY_HINT_ENUM, "landscape,portrait,reverse_landscape,reverse_portrait,sensor_landscape,sensor_portrait,sensor");
  1027. custom_prop_info["rendering/threads/thread_model"] = PropertyInfo(Variant::INT, "rendering/threads/thread_model", PROPERTY_HINT_ENUM, "Single-Unsafe,Single-Safe,Multi-Threaded");
  1028. custom_prop_info["physics/2d/thread_model"] = PropertyInfo(Variant::INT, "physics/2d/thread_model", PROPERTY_HINT_ENUM, "Single-Unsafe,Single-Safe,Multi-Threaded");
  1029. custom_prop_info["rendering/quality/intended_usage/framebuffer_allocation"] = PropertyInfo(Variant::INT, "rendering/quality/intended_usage/framebuffer_allocation", PROPERTY_HINT_ENUM, "2D,2D Without Sampling,3D,3D Without Effects");
  1030. GLOBAL_DEF("rendering/quality/filters/sharpen_intensity", 0.0);
  1031. custom_prop_info["rendering/quality/filters/sharpen_intensity"] = PropertyInfo(Variant::REAL, "rendering/quality/filters/sharpen_intensity", PROPERTY_HINT_RANGE, "0,1");
  1032. GLOBAL_DEF("debug/settings/profiler/max_functions", 16384);
  1033. custom_prop_info["debug/settings/profiler/max_functions"] = PropertyInfo(Variant::INT, "debug/settings/profiler/max_functions", PROPERTY_HINT_RANGE, "128,65535,1");
  1034. GLOBAL_DEF("compression/formats/zstd/long_distance_matching", Compression::zstd_long_distance_matching);
  1035. custom_prop_info["compression/formats/zstd/long_distance_matching"] = PropertyInfo(Variant::BOOL, "compression/formats/zstd/long_distance_matching");
  1036. GLOBAL_DEF("compression/formats/zstd/compression_level", Compression::zstd_level);
  1037. custom_prop_info["compression/formats/zstd/compression_level"] = PropertyInfo(Variant::INT, "compression/formats/zstd/compression_level", PROPERTY_HINT_RANGE, "1,22,1");
  1038. GLOBAL_DEF("compression/formats/zstd/window_log_size", Compression::zstd_window_log_size);
  1039. custom_prop_info["compression/formats/zstd/window_log_size"] = PropertyInfo(Variant::INT, "compression/formats/zstd/window_log_size", PROPERTY_HINT_RANGE, "10,30,1");
  1040. GLOBAL_DEF("compression/formats/zlib/compression_level", Compression::zlib_level);
  1041. custom_prop_info["compression/formats/zlib/compression_level"] = PropertyInfo(Variant::INT, "compression/formats/zlib/compression_level", PROPERTY_HINT_RANGE, "-1,9,1");
  1042. GLOBAL_DEF("compression/formats/gzip/compression_level", Compression::gzip_level);
  1043. custom_prop_info["compression/formats/gzip/compression_level"] = PropertyInfo(Variant::INT, "compression/formats/gzip/compression_level", PROPERTY_HINT_RANGE, "-1,9,1");
  1044. // Would ideally be defined in an Android-specific file, but then it doesn't appear in the docs
  1045. GLOBAL_DEF("android/modules", "");
  1046. using_datapack = false;
  1047. }
  1048. ProjectSettings::~ProjectSettings() {
  1049. singleton = nullptr;
  1050. }