project_settings.cpp 41 KB

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