core_bind.cpp 88 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589
  1. /*************************************************************************/
  2. /* core_bind.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 "core_bind.h"
  31. #include "core/config/project_settings.h"
  32. #include "core/crypto/crypto_core.h"
  33. #include "core/debugger/engine_debugger.h"
  34. #include "core/io/file_access_compressed.h"
  35. #include "core/io/file_access_encrypted.h"
  36. #include "core/io/json.h"
  37. #include "core/io/marshalls.h"
  38. #include "core/math/geometry_2d.h"
  39. #include "core/math/geometry_3d.h"
  40. #include "core/os/keyboard.h"
  41. #include "core/os/os.h"
  42. /**
  43. * Time constants borrowed from loc_time.h
  44. */
  45. #define EPOCH_YR 1970 /* EPOCH = Jan 1 1970 00:00:00 */
  46. #define SECS_DAY (24L * 60L * 60L)
  47. #define LEAPYEAR(year) (!((year) % 4) && (((year) % 100) || !((year) % 400)))
  48. #define YEARSIZE(year) (LEAPYEAR(year) ? 366 : 365)
  49. #define SECOND_KEY "second"
  50. #define MINUTE_KEY "minute"
  51. #define HOUR_KEY "hour"
  52. #define DAY_KEY "day"
  53. #define MONTH_KEY "month"
  54. #define YEAR_KEY "year"
  55. #define WEEKDAY_KEY "weekday"
  56. #define DST_KEY "dst"
  57. /// Table of number of days in each month (for regular year and leap year)
  58. static const unsigned int MONTH_DAYS_TABLE[2][12] = {
  59. { 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 },
  60. { 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }
  61. };
  62. ////// _ResourceLoader //////
  63. _ResourceLoader *_ResourceLoader::singleton = nullptr;
  64. Error _ResourceLoader::load_threaded_request(const String &p_path, const String &p_type_hint, bool p_use_sub_threads) {
  65. return ResourceLoader::load_threaded_request(p_path, p_type_hint, p_use_sub_threads);
  66. }
  67. _ResourceLoader::ThreadLoadStatus _ResourceLoader::load_threaded_get_status(const String &p_path, Array r_progress) {
  68. float progress = 0;
  69. ResourceLoader::ThreadLoadStatus tls = ResourceLoader::load_threaded_get_status(p_path, &progress);
  70. r_progress.resize(1);
  71. r_progress[0] = progress;
  72. return (ThreadLoadStatus)tls;
  73. }
  74. RES _ResourceLoader::load_threaded_get(const String &p_path) {
  75. Error error;
  76. RES res = ResourceLoader::load_threaded_get(p_path, &error);
  77. return res;
  78. }
  79. RES _ResourceLoader::load(const String &p_path, const String &p_type_hint, CacheMode p_cache_mode) {
  80. Error err = OK;
  81. RES ret = ResourceLoader::load(p_path, p_type_hint, ResourceFormatLoader::CacheMode(p_cache_mode), &err);
  82. ERR_FAIL_COND_V_MSG(err != OK, ret, "Error loading resource: '" + p_path + "'.");
  83. return ret;
  84. }
  85. Vector<String> _ResourceLoader::get_recognized_extensions_for_type(const String &p_type) {
  86. List<String> exts;
  87. ResourceLoader::get_recognized_extensions_for_type(p_type, &exts);
  88. Vector<String> ret;
  89. for (List<String>::Element *E = exts.front(); E; E = E->next()) {
  90. ret.push_back(E->get());
  91. }
  92. return ret;
  93. }
  94. void _ResourceLoader::set_abort_on_missing_resources(bool p_abort) {
  95. ResourceLoader::set_abort_on_missing_resources(p_abort);
  96. }
  97. PackedStringArray _ResourceLoader::get_dependencies(const String &p_path) {
  98. List<String> deps;
  99. ResourceLoader::get_dependencies(p_path, &deps);
  100. PackedStringArray ret;
  101. for (List<String>::Element *E = deps.front(); E; E = E->next()) {
  102. ret.push_back(E->get());
  103. }
  104. return ret;
  105. }
  106. bool _ResourceLoader::has_cached(const String &p_path) {
  107. String local_path = ProjectSettings::get_singleton()->localize_path(p_path);
  108. return ResourceCache::has(local_path);
  109. }
  110. bool _ResourceLoader::exists(const String &p_path, const String &p_type_hint) {
  111. return ResourceLoader::exists(p_path, p_type_hint);
  112. }
  113. void _ResourceLoader::_bind_methods() {
  114. ClassDB::bind_method(D_METHOD("load_threaded_request", "path", "type_hint", "use_sub_threads"), &_ResourceLoader::load_threaded_request, DEFVAL(""), DEFVAL(false));
  115. ClassDB::bind_method(D_METHOD("load_threaded_get_status", "path", "progress"), &_ResourceLoader::load_threaded_get_status, DEFVAL(Array()));
  116. ClassDB::bind_method(D_METHOD("load_threaded_get", "path"), &_ResourceLoader::load_threaded_get);
  117. ClassDB::bind_method(D_METHOD("load", "path", "type_hint", "cache_mode"), &_ResourceLoader::load, DEFVAL(""), DEFVAL(CACHE_MODE_REUSE));
  118. ClassDB::bind_method(D_METHOD("get_recognized_extensions_for_type", "type"), &_ResourceLoader::get_recognized_extensions_for_type);
  119. ClassDB::bind_method(D_METHOD("set_abort_on_missing_resources", "abort"), &_ResourceLoader::set_abort_on_missing_resources);
  120. ClassDB::bind_method(D_METHOD("get_dependencies", "path"), &_ResourceLoader::get_dependencies);
  121. ClassDB::bind_method(D_METHOD("has_cached", "path"), &_ResourceLoader::has_cached);
  122. ClassDB::bind_method(D_METHOD("exists", "path", "type_hint"), &_ResourceLoader::exists, DEFVAL(""));
  123. BIND_ENUM_CONSTANT(THREAD_LOAD_INVALID_RESOURCE);
  124. BIND_ENUM_CONSTANT(THREAD_LOAD_IN_PROGRESS);
  125. BIND_ENUM_CONSTANT(THREAD_LOAD_FAILED);
  126. BIND_ENUM_CONSTANT(THREAD_LOAD_LOADED);
  127. BIND_ENUM_CONSTANT(CACHE_MODE_IGNORE);
  128. BIND_ENUM_CONSTANT(CACHE_MODE_REUSE);
  129. BIND_ENUM_CONSTANT(CACHE_MODE_REPLACE);
  130. }
  131. ////// _ResourceSaver //////
  132. Error _ResourceSaver::save(const String &p_path, const RES &p_resource, SaverFlags p_flags) {
  133. ERR_FAIL_COND_V_MSG(p_resource.is_null(), ERR_INVALID_PARAMETER, "Can't save empty resource to path '" + String(p_path) + "'.");
  134. return ResourceSaver::save(p_path, p_resource, p_flags);
  135. }
  136. Vector<String> _ResourceSaver::get_recognized_extensions(const RES &p_resource) {
  137. ERR_FAIL_COND_V_MSG(p_resource.is_null(), Vector<String>(), "It's not a reference to a valid Resource object.");
  138. List<String> exts;
  139. ResourceSaver::get_recognized_extensions(p_resource, &exts);
  140. Vector<String> ret;
  141. for (List<String>::Element *E = exts.front(); E; E = E->next()) {
  142. ret.push_back(E->get());
  143. }
  144. return ret;
  145. }
  146. _ResourceSaver *_ResourceSaver::singleton = nullptr;
  147. void _ResourceSaver::_bind_methods() {
  148. ClassDB::bind_method(D_METHOD("save", "path", "resource", "flags"), &_ResourceSaver::save, DEFVAL(0));
  149. ClassDB::bind_method(D_METHOD("get_recognized_extensions", "type"), &_ResourceSaver::get_recognized_extensions);
  150. BIND_ENUM_CONSTANT(FLAG_RELATIVE_PATHS);
  151. BIND_ENUM_CONSTANT(FLAG_BUNDLE_RESOURCES);
  152. BIND_ENUM_CONSTANT(FLAG_CHANGE_PATH);
  153. BIND_ENUM_CONSTANT(FLAG_OMIT_EDITOR_PROPERTIES);
  154. BIND_ENUM_CONSTANT(FLAG_SAVE_BIG_ENDIAN);
  155. BIND_ENUM_CONSTANT(FLAG_COMPRESS);
  156. BIND_ENUM_CONSTANT(FLAG_REPLACE_SUBRESOURCE_PATHS);
  157. }
  158. ////// _OS //////
  159. PackedStringArray _OS::get_connected_midi_inputs() {
  160. return OS::get_singleton()->get_connected_midi_inputs();
  161. }
  162. void _OS::open_midi_inputs() {
  163. OS::get_singleton()->open_midi_inputs();
  164. }
  165. void _OS::close_midi_inputs() {
  166. OS::get_singleton()->close_midi_inputs();
  167. }
  168. void _OS::set_use_file_access_save_and_swap(bool p_enable) {
  169. FileAccess::set_backup_save(p_enable);
  170. }
  171. void _OS::set_low_processor_usage_mode(bool p_enabled) {
  172. OS::get_singleton()->set_low_processor_usage_mode(p_enabled);
  173. }
  174. bool _OS::is_in_low_processor_usage_mode() const {
  175. return OS::get_singleton()->is_in_low_processor_usage_mode();
  176. }
  177. void _OS::set_low_processor_usage_mode_sleep_usec(int p_usec) {
  178. OS::get_singleton()->set_low_processor_usage_mode_sleep_usec(p_usec);
  179. }
  180. int _OS::get_low_processor_usage_mode_sleep_usec() const {
  181. return OS::get_singleton()->get_low_processor_usage_mode_sleep_usec();
  182. }
  183. String _OS::get_executable_path() const {
  184. return OS::get_singleton()->get_executable_path();
  185. }
  186. Error _OS::shell_open(String p_uri) {
  187. if (p_uri.begins_with("res://")) {
  188. WARN_PRINT("Attempting to open an URL with the \"res://\" protocol. Use `ProjectSettings.globalize_path()` to convert a Godot-specific path to a system path before opening it with `OS.shell_open()`.");
  189. } else if (p_uri.begins_with("user://")) {
  190. WARN_PRINT("Attempting to open an URL with the \"user://\" protocol. Use `ProjectSettings.globalize_path()` to convert a Godot-specific path to a system path before opening it with `OS.shell_open()`.");
  191. }
  192. return OS::get_singleton()->shell_open(p_uri);
  193. }
  194. int _OS::execute(const String &p_path, const Vector<String> &p_arguments, Array r_output, bool p_read_stderr) {
  195. List<String> args;
  196. for (int i = 0; i < p_arguments.size(); i++) {
  197. args.push_back(p_arguments[i]);
  198. }
  199. String pipe;
  200. int exitcode = 0;
  201. Error err = OS::get_singleton()->execute(p_path, args, &pipe, &exitcode, p_read_stderr);
  202. r_output.push_back(pipe);
  203. if (err != OK) {
  204. return -1;
  205. }
  206. return exitcode;
  207. }
  208. int _OS::create_process(const String &p_path, const Vector<String> &p_arguments) {
  209. List<String> args;
  210. for (int i = 0; i < p_arguments.size(); i++) {
  211. args.push_back(p_arguments[i]);
  212. }
  213. OS::ProcessID pid = 0;
  214. Error err = OS::get_singleton()->create_process(p_path, args, &pid);
  215. if (err != OK) {
  216. return -1;
  217. }
  218. return pid;
  219. }
  220. Error _OS::kill(int p_pid) {
  221. return OS::get_singleton()->kill(p_pid);
  222. }
  223. int _OS::get_process_id() const {
  224. return OS::get_singleton()->get_process_id();
  225. }
  226. bool _OS::has_environment(const String &p_var) const {
  227. return OS::get_singleton()->has_environment(p_var);
  228. }
  229. String _OS::get_environment(const String &p_var) const {
  230. return OS::get_singleton()->get_environment(p_var);
  231. }
  232. bool _OS::set_environment(const String &p_var, const String &p_value) const {
  233. return OS::get_singleton()->set_environment(p_var, p_value);
  234. }
  235. String _OS::get_name() const {
  236. return OS::get_singleton()->get_name();
  237. }
  238. Vector<String> _OS::get_cmdline_args() {
  239. List<String> cmdline = OS::get_singleton()->get_cmdline_args();
  240. Vector<String> cmdlinev;
  241. for (List<String>::Element *E = cmdline.front(); E; E = E->next()) {
  242. cmdlinev.push_back(E->get());
  243. }
  244. return cmdlinev;
  245. }
  246. String _OS::get_locale() const {
  247. return OS::get_singleton()->get_locale();
  248. }
  249. String _OS::get_model_name() const {
  250. return OS::get_singleton()->get_model_name();
  251. }
  252. Error _OS::set_thread_name(const String &p_name) {
  253. return Thread::set_name(p_name);
  254. }
  255. Thread::ID _OS::get_thread_caller_id() const {
  256. return Thread::get_caller_id();
  257. };
  258. bool _OS::has_feature(const String &p_feature) const {
  259. return OS::get_singleton()->has_feature(p_feature);
  260. }
  261. uint64_t _OS::get_static_memory_usage() const {
  262. return OS::get_singleton()->get_static_memory_usage();
  263. }
  264. uint64_t _OS::get_static_memory_peak_usage() const {
  265. return OS::get_singleton()->get_static_memory_peak_usage();
  266. }
  267. /**
  268. * Get current datetime with consideration for utc and
  269. * dst
  270. */
  271. Dictionary _OS::get_datetime(bool utc) const {
  272. Dictionary dated = get_date(utc);
  273. Dictionary timed = get_time(utc);
  274. List<Variant> keys;
  275. timed.get_key_list(&keys);
  276. for (int i = 0; i < keys.size(); i++) {
  277. dated[keys[i]] = timed[keys[i]];
  278. }
  279. return dated;
  280. }
  281. Dictionary _OS::get_date(bool utc) const {
  282. OS::Date date = OS::get_singleton()->get_date(utc);
  283. Dictionary dated;
  284. dated[YEAR_KEY] = date.year;
  285. dated[MONTH_KEY] = date.month;
  286. dated[DAY_KEY] = date.day;
  287. dated[WEEKDAY_KEY] = date.weekday;
  288. dated[DST_KEY] = date.dst;
  289. return dated;
  290. }
  291. Dictionary _OS::get_time(bool utc) const {
  292. OS::Time time = OS::get_singleton()->get_time(utc);
  293. Dictionary timed;
  294. timed[HOUR_KEY] = time.hour;
  295. timed[MINUTE_KEY] = time.min;
  296. timed[SECOND_KEY] = time.sec;
  297. return timed;
  298. }
  299. /**
  300. * Get an epoch time value from a dictionary of time values
  301. * @p datetime must be populated with the following keys:
  302. * day, hour, minute, month, second, year. (dst is ignored).
  303. *
  304. * You can pass the output from
  305. * get_datetime_from_unix_time directly into this function
  306. *
  307. * @param datetime dictionary of date and time values to convert
  308. *
  309. * @return epoch calculated
  310. */
  311. int64_t _OS::get_unix_time_from_datetime(Dictionary datetime) const {
  312. // if datetime is an empty Dictionary throws an error
  313. ERR_FAIL_COND_V_MSG(datetime.is_empty(), 0, "Invalid datetime Dictionary: Dictionary is empty");
  314. // Bunch of conversion constants
  315. static const unsigned int SECONDS_PER_MINUTE = 60;
  316. static const unsigned int MINUTES_PER_HOUR = 60;
  317. static const unsigned int HOURS_PER_DAY = 24;
  318. static const unsigned int SECONDS_PER_HOUR = MINUTES_PER_HOUR * SECONDS_PER_MINUTE;
  319. static const unsigned int SECONDS_PER_DAY = SECONDS_PER_HOUR * HOURS_PER_DAY;
  320. // Get all time values from the dictionary, set to zero if it doesn't exist.
  321. // Risk incorrect calculation over throwing errors
  322. unsigned int second = ((datetime.has(SECOND_KEY)) ? static_cast<unsigned int>(datetime[SECOND_KEY]) : 0);
  323. unsigned int minute = ((datetime.has(MINUTE_KEY)) ? static_cast<unsigned int>(datetime[MINUTE_KEY]) : 0);
  324. unsigned int hour = ((datetime.has(HOUR_KEY)) ? static_cast<unsigned int>(datetime[HOUR_KEY]) : 0);
  325. unsigned int day = ((datetime.has(DAY_KEY)) ? static_cast<unsigned int>(datetime[DAY_KEY]) : 1);
  326. unsigned int month = ((datetime.has(MONTH_KEY)) ? static_cast<unsigned int>(datetime[MONTH_KEY]) : 1);
  327. unsigned int year = ((datetime.has(YEAR_KEY)) ? static_cast<unsigned int>(datetime[YEAR_KEY]) : 1970);
  328. /// How many days come before each month (0-12)
  329. static const unsigned short int DAYS_PAST_THIS_YEAR_TABLE[2][13] = {
  330. /* Normal years. */
  331. { 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365 },
  332. /* Leap years. */
  333. { 0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366 }
  334. };
  335. ERR_FAIL_COND_V_MSG(second > 59, 0, "Invalid second value of: " + itos(second) + ".");
  336. ERR_FAIL_COND_V_MSG(minute > 59, 0, "Invalid minute value of: " + itos(minute) + ".");
  337. ERR_FAIL_COND_V_MSG(hour > 23, 0, "Invalid hour value of: " + itos(hour) + ".");
  338. ERR_FAIL_COND_V_MSG(year == 0, 0, "Years before 1 AD are not supported. Value passed: " + itos(year) + ".");
  339. ERR_FAIL_COND_V_MSG(month > 12 || month == 0, 0, "Invalid month value of: " + itos(month) + ".");
  340. // Do this check after month is tested as valid
  341. unsigned int days_in_month = MONTH_DAYS_TABLE[LEAPYEAR(year)][month - 1];
  342. ERR_FAIL_COND_V_MSG(day == 0 || day > days_in_month, 0, "Invalid day value of: " + itos(day) + ". It should be comprised between 1 and " + itos(days_in_month) + " for month " + itos(month) + ".");
  343. // Calculate all the seconds from months past in this year
  344. uint64_t SECONDS_FROM_MONTHS_PAST_THIS_YEAR = DAYS_PAST_THIS_YEAR_TABLE[LEAPYEAR(year)][month - 1] * SECONDS_PER_DAY;
  345. int64_t SECONDS_FROM_YEARS_PAST = 0;
  346. if (year >= EPOCH_YR) {
  347. for (unsigned int iyear = EPOCH_YR; iyear < year; iyear++) {
  348. SECONDS_FROM_YEARS_PAST += YEARSIZE(iyear) * SECONDS_PER_DAY;
  349. }
  350. } else {
  351. for (unsigned int iyear = EPOCH_YR - 1; iyear >= year; iyear--) {
  352. SECONDS_FROM_YEARS_PAST -= YEARSIZE(iyear) * SECONDS_PER_DAY;
  353. }
  354. }
  355. int64_t epoch =
  356. second +
  357. minute * SECONDS_PER_MINUTE +
  358. hour * SECONDS_PER_HOUR +
  359. // Subtract 1 from day, since the current day isn't over yet
  360. // and we cannot count all 24 hours.
  361. (day - 1) * SECONDS_PER_DAY +
  362. SECONDS_FROM_MONTHS_PAST_THIS_YEAR +
  363. SECONDS_FROM_YEARS_PAST;
  364. return epoch;
  365. }
  366. /**
  367. * Get a dictionary of time values when given epoch time
  368. *
  369. * Dictionary Time values will be a union if values from #get_time
  370. * and #get_date dictionaries (with the exception of dst =
  371. * day light standard time, as it cannot be determined from epoch)
  372. *
  373. * @param unix_time_val epoch time to convert
  374. *
  375. * @return dictionary of date and time values
  376. */
  377. Dictionary _OS::get_datetime_from_unix_time(int64_t unix_time_val) const {
  378. OS::Date date;
  379. OS::Time time;
  380. long dayclock, dayno;
  381. int year = EPOCH_YR;
  382. if (unix_time_val >= 0) {
  383. dayno = unix_time_val / SECS_DAY;
  384. dayclock = unix_time_val % SECS_DAY;
  385. /* day 0 was a thursday */
  386. date.weekday = static_cast<OS::Weekday>((dayno + 4) % 7);
  387. while (dayno >= YEARSIZE(year)) {
  388. dayno -= YEARSIZE(year);
  389. year++;
  390. }
  391. } else {
  392. dayno = (unix_time_val - SECS_DAY + 1) / SECS_DAY;
  393. dayclock = unix_time_val - dayno * SECS_DAY;
  394. date.weekday = static_cast<OS::Weekday>(((dayno % 7) + 11) % 7);
  395. do {
  396. year--;
  397. dayno += YEARSIZE(year);
  398. } while (dayno < 0);
  399. }
  400. time.sec = dayclock % 60;
  401. time.min = (dayclock % 3600) / 60;
  402. time.hour = dayclock / 3600;
  403. date.year = year;
  404. size_t imonth = 0;
  405. while ((unsigned long)dayno >= MONTH_DAYS_TABLE[LEAPYEAR(year)][imonth]) {
  406. dayno -= MONTH_DAYS_TABLE[LEAPYEAR(year)][imonth];
  407. imonth++;
  408. }
  409. /// Add 1 to month to make sure months are indexed starting at 1
  410. date.month = static_cast<OS::Month>(imonth + 1);
  411. date.day = dayno + 1;
  412. Dictionary timed;
  413. timed[HOUR_KEY] = time.hour;
  414. timed[MINUTE_KEY] = time.min;
  415. timed[SECOND_KEY] = time.sec;
  416. timed[YEAR_KEY] = date.year;
  417. timed[MONTH_KEY] = date.month;
  418. timed[DAY_KEY] = date.day;
  419. timed[WEEKDAY_KEY] = date.weekday;
  420. return timed;
  421. }
  422. Dictionary _OS::get_time_zone_info() const {
  423. OS::TimeZoneInfo info = OS::get_singleton()->get_time_zone_info();
  424. Dictionary infod;
  425. infod["bias"] = info.bias;
  426. infod["name"] = info.name;
  427. return infod;
  428. }
  429. double _OS::get_unix_time() const {
  430. return OS::get_singleton()->get_unix_time();
  431. }
  432. /** This method uses a signed argument for better error reporting as it's used from the scripting API. */
  433. void _OS::delay_usec(int p_usec) const {
  434. ERR_FAIL_COND_MSG(
  435. p_usec < 0,
  436. vformat("Can't sleep for %d microseconds. The delay provided must be greater than or equal to 0 microseconds.", p_usec));
  437. OS::get_singleton()->delay_usec(p_usec);
  438. }
  439. /** This method uses a signed argument for better error reporting as it's used from the scripting API. */
  440. void _OS::delay_msec(int p_msec) const {
  441. ERR_FAIL_COND_MSG(
  442. p_msec < 0,
  443. vformat("Can't sleep for %d milliseconds. The delay provided must be greater than or equal to 0 milliseconds.", p_msec));
  444. OS::get_singleton()->delay_usec(int64_t(p_msec) * 1000);
  445. }
  446. uint32_t _OS::get_ticks_msec() const {
  447. return OS::get_singleton()->get_ticks_msec();
  448. }
  449. uint64_t _OS::get_ticks_usec() const {
  450. return OS::get_singleton()->get_ticks_usec();
  451. }
  452. bool _OS::can_use_threads() const {
  453. return OS::get_singleton()->can_use_threads();
  454. }
  455. bool _OS::is_userfs_persistent() const {
  456. return OS::get_singleton()->is_userfs_persistent();
  457. }
  458. int _OS::get_processor_count() const {
  459. return OS::get_singleton()->get_processor_count();
  460. }
  461. bool _OS::is_stdout_verbose() const {
  462. return OS::get_singleton()->is_stdout_verbose();
  463. }
  464. void _OS::dump_memory_to_file(const String &p_file) {
  465. OS::get_singleton()->dump_memory_to_file(p_file.utf8().get_data());
  466. }
  467. struct _OSCoreBindImg {
  468. String path;
  469. Size2 size;
  470. int fmt = 0;
  471. ObjectID id;
  472. int vram = 0;
  473. bool operator<(const _OSCoreBindImg &p_img) const { return vram == p_img.vram ? id < p_img.id : vram > p_img.vram; }
  474. };
  475. void _OS::print_all_textures_by_size() {
  476. List<_OSCoreBindImg> imgs;
  477. uint64_t total = 0;
  478. {
  479. List<Ref<Resource>> rsrc;
  480. ResourceCache::get_cached_resources(&rsrc);
  481. for (List<Ref<Resource>>::Element *E = rsrc.front(); E; E = E->next()) {
  482. if (!E->get()->is_class("ImageTexture")) {
  483. continue;
  484. }
  485. Size2 size = E->get()->call("get_size");
  486. int fmt = E->get()->call("get_format");
  487. _OSCoreBindImg img;
  488. img.size = size;
  489. img.fmt = fmt;
  490. img.path = E->get()->get_path();
  491. img.vram = Image::get_image_data_size(img.size.width, img.size.height, Image::Format(img.fmt));
  492. img.id = E->get()->get_instance_id();
  493. total += img.vram;
  494. imgs.push_back(img);
  495. }
  496. }
  497. imgs.sort();
  498. for (List<_OSCoreBindImg>::Element *E = imgs.front(); E; E = E->next()) {
  499. total -= E->get().vram;
  500. }
  501. }
  502. void _OS::print_resources_by_type(const Vector<String> &p_types) {
  503. Map<String, int> type_count;
  504. List<Ref<Resource>> resources;
  505. ResourceCache::get_cached_resources(&resources);
  506. for (List<Ref<Resource>>::Element *E = resources.front(); E; E = E->next()) {
  507. Ref<Resource> r = E->get();
  508. bool found = false;
  509. for (int i = 0; i < p_types.size(); i++) {
  510. if (r->is_class(p_types[i])) {
  511. found = true;
  512. }
  513. }
  514. if (!found) {
  515. continue;
  516. }
  517. if (!type_count.has(r->get_class())) {
  518. type_count[r->get_class()] = 0;
  519. }
  520. type_count[r->get_class()]++;
  521. }
  522. }
  523. void _OS::print_all_resources(const String &p_to_file) {
  524. OS::get_singleton()->print_all_resources(p_to_file);
  525. }
  526. void _OS::print_resources_in_use(bool p_short) {
  527. OS::get_singleton()->print_resources_in_use(p_short);
  528. }
  529. void _OS::dump_resources_to_file(const String &p_file) {
  530. OS::get_singleton()->dump_resources_to_file(p_file.utf8().get_data());
  531. }
  532. String _OS::get_user_data_dir() const {
  533. return OS::get_singleton()->get_user_data_dir();
  534. }
  535. bool _OS::is_debug_build() const {
  536. #ifdef DEBUG_ENABLED
  537. return true;
  538. #else
  539. return false;
  540. #endif
  541. }
  542. String _OS::get_system_dir(SystemDir p_dir) const {
  543. return OS::get_singleton()->get_system_dir(OS::SystemDir(p_dir));
  544. }
  545. String _OS::get_keycode_string(uint32_t p_code) const {
  546. return keycode_get_string(p_code);
  547. }
  548. bool _OS::is_keycode_unicode(uint32_t p_unicode) const {
  549. return keycode_has_unicode(p_unicode);
  550. }
  551. int _OS::find_keycode_from_string(const String &p_code) const {
  552. return find_keycode(p_code);
  553. }
  554. bool _OS::request_permission(const String &p_name) {
  555. return OS::get_singleton()->request_permission(p_name);
  556. }
  557. bool _OS::request_permissions() {
  558. return OS::get_singleton()->request_permissions();
  559. }
  560. Vector<String> _OS::get_granted_permissions() const {
  561. return OS::get_singleton()->get_granted_permissions();
  562. }
  563. String _OS::get_unique_id() const {
  564. return OS::get_singleton()->get_unique_id();
  565. }
  566. _OS *_OS::singleton = nullptr;
  567. void _OS::_bind_methods() {
  568. ClassDB::bind_method(D_METHOD("get_connected_midi_inputs"), &_OS::get_connected_midi_inputs);
  569. ClassDB::bind_method(D_METHOD("open_midi_inputs"), &_OS::open_midi_inputs);
  570. ClassDB::bind_method(D_METHOD("close_midi_inputs"), &_OS::close_midi_inputs);
  571. ClassDB::bind_method(D_METHOD("set_low_processor_usage_mode", "enable"), &_OS::set_low_processor_usage_mode);
  572. ClassDB::bind_method(D_METHOD("is_in_low_processor_usage_mode"), &_OS::is_in_low_processor_usage_mode);
  573. ClassDB::bind_method(D_METHOD("set_low_processor_usage_mode_sleep_usec", "usec"), &_OS::set_low_processor_usage_mode_sleep_usec);
  574. ClassDB::bind_method(D_METHOD("get_low_processor_usage_mode_sleep_usec"), &_OS::get_low_processor_usage_mode_sleep_usec);
  575. ClassDB::bind_method(D_METHOD("get_processor_count"), &_OS::get_processor_count);
  576. ClassDB::bind_method(D_METHOD("get_executable_path"), &_OS::get_executable_path);
  577. ClassDB::bind_method(D_METHOD("execute", "path", "arguments", "output", "read_stderr"), &_OS::execute, DEFVAL(Array()), DEFVAL(false));
  578. ClassDB::bind_method(D_METHOD("create_process", "path", "arguments"), &_OS::create_process);
  579. ClassDB::bind_method(D_METHOD("kill", "pid"), &_OS::kill);
  580. ClassDB::bind_method(D_METHOD("shell_open", "uri"), &_OS::shell_open);
  581. ClassDB::bind_method(D_METHOD("get_process_id"), &_OS::get_process_id);
  582. ClassDB::bind_method(D_METHOD("get_environment", "variable"), &_OS::get_environment);
  583. ClassDB::bind_method(D_METHOD("set_environment", "variable", "value"), &_OS::set_environment);
  584. ClassDB::bind_method(D_METHOD("has_environment", "variable"), &_OS::has_environment);
  585. ClassDB::bind_method(D_METHOD("get_name"), &_OS::get_name);
  586. ClassDB::bind_method(D_METHOD("get_cmdline_args"), &_OS::get_cmdline_args);
  587. ClassDB::bind_method(D_METHOD("get_datetime", "utc"), &_OS::get_datetime, DEFVAL(false));
  588. ClassDB::bind_method(D_METHOD("get_date", "utc"), &_OS::get_date, DEFVAL(false));
  589. ClassDB::bind_method(D_METHOD("get_time", "utc"), &_OS::get_time, DEFVAL(false));
  590. ClassDB::bind_method(D_METHOD("get_time_zone_info"), &_OS::get_time_zone_info);
  591. ClassDB::bind_method(D_METHOD("get_unix_time"), &_OS::get_unix_time);
  592. ClassDB::bind_method(D_METHOD("get_datetime_from_unix_time", "unix_time_val"), &_OS::get_datetime_from_unix_time);
  593. ClassDB::bind_method(D_METHOD("get_unix_time_from_datetime", "datetime"), &_OS::get_unix_time_from_datetime);
  594. ClassDB::bind_method(D_METHOD("delay_usec", "usec"), &_OS::delay_usec);
  595. ClassDB::bind_method(D_METHOD("delay_msec", "msec"), &_OS::delay_msec);
  596. ClassDB::bind_method(D_METHOD("get_ticks_msec"), &_OS::get_ticks_msec);
  597. ClassDB::bind_method(D_METHOD("get_ticks_usec"), &_OS::get_ticks_usec);
  598. ClassDB::bind_method(D_METHOD("get_locale"), &_OS::get_locale);
  599. ClassDB::bind_method(D_METHOD("get_model_name"), &_OS::get_model_name);
  600. ClassDB::bind_method(D_METHOD("is_userfs_persistent"), &_OS::is_userfs_persistent);
  601. ClassDB::bind_method(D_METHOD("is_stdout_verbose"), &_OS::is_stdout_verbose);
  602. ClassDB::bind_method(D_METHOD("can_use_threads"), &_OS::can_use_threads);
  603. ClassDB::bind_method(D_METHOD("is_debug_build"), &_OS::is_debug_build);
  604. ClassDB::bind_method(D_METHOD("dump_memory_to_file", "file"), &_OS::dump_memory_to_file);
  605. ClassDB::bind_method(D_METHOD("dump_resources_to_file", "file"), &_OS::dump_resources_to_file);
  606. ClassDB::bind_method(D_METHOD("print_resources_in_use", "short"), &_OS::print_resources_in_use, DEFVAL(false));
  607. ClassDB::bind_method(D_METHOD("print_all_resources", "tofile"), &_OS::print_all_resources, DEFVAL(""));
  608. ClassDB::bind_method(D_METHOD("get_static_memory_usage"), &_OS::get_static_memory_usage);
  609. ClassDB::bind_method(D_METHOD("get_static_memory_peak_usage"), &_OS::get_static_memory_peak_usage);
  610. ClassDB::bind_method(D_METHOD("get_user_data_dir"), &_OS::get_user_data_dir);
  611. ClassDB::bind_method(D_METHOD("get_system_dir", "dir"), &_OS::get_system_dir);
  612. ClassDB::bind_method(D_METHOD("get_unique_id"), &_OS::get_unique_id);
  613. ClassDB::bind_method(D_METHOD("print_all_textures_by_size"), &_OS::print_all_textures_by_size);
  614. ClassDB::bind_method(D_METHOD("print_resources_by_type", "types"), &_OS::print_resources_by_type);
  615. ClassDB::bind_method(D_METHOD("get_keycode_string", "code"), &_OS::get_keycode_string);
  616. ClassDB::bind_method(D_METHOD("is_keycode_unicode", "code"), &_OS::is_keycode_unicode);
  617. ClassDB::bind_method(D_METHOD("find_keycode_from_string", "string"), &_OS::find_keycode_from_string);
  618. ClassDB::bind_method(D_METHOD("set_use_file_access_save_and_swap", "enabled"), &_OS::set_use_file_access_save_and_swap);
  619. ClassDB::bind_method(D_METHOD("set_thread_name", "name"), &_OS::set_thread_name);
  620. ClassDB::bind_method(D_METHOD("get_thread_caller_id"), &_OS::get_thread_caller_id);
  621. ClassDB::bind_method(D_METHOD("has_feature", "tag_name"), &_OS::has_feature);
  622. ClassDB::bind_method(D_METHOD("request_permission", "name"), &_OS::request_permission);
  623. ClassDB::bind_method(D_METHOD("request_permissions"), &_OS::request_permissions);
  624. ClassDB::bind_method(D_METHOD("get_granted_permissions"), &_OS::get_granted_permissions);
  625. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "low_processor_usage_mode"), "set_low_processor_usage_mode", "is_in_low_processor_usage_mode");
  626. ADD_PROPERTY(PropertyInfo(Variant::INT, "low_processor_usage_mode_sleep_usec"), "set_low_processor_usage_mode_sleep_usec", "get_low_processor_usage_mode_sleep_usec");
  627. // Those default values need to be specified for the docs generator,
  628. // to avoid using values from the documentation writer's own OS instance.
  629. ADD_PROPERTY_DEFAULT("exit_code", 0);
  630. ADD_PROPERTY_DEFAULT("low_processor_usage_mode", false);
  631. ADD_PROPERTY_DEFAULT("low_processor_usage_mode_sleep_usec", 6900);
  632. BIND_ENUM_CONSTANT(VIDEO_DRIVER_GLES2);
  633. BIND_ENUM_CONSTANT(VIDEO_DRIVER_VULKAN);
  634. BIND_ENUM_CONSTANT(DAY_SUNDAY);
  635. BIND_ENUM_CONSTANT(DAY_MONDAY);
  636. BIND_ENUM_CONSTANT(DAY_TUESDAY);
  637. BIND_ENUM_CONSTANT(DAY_WEDNESDAY);
  638. BIND_ENUM_CONSTANT(DAY_THURSDAY);
  639. BIND_ENUM_CONSTANT(DAY_FRIDAY);
  640. BIND_ENUM_CONSTANT(DAY_SATURDAY);
  641. BIND_ENUM_CONSTANT(MONTH_JANUARY);
  642. BIND_ENUM_CONSTANT(MONTH_FEBRUARY);
  643. BIND_ENUM_CONSTANT(MONTH_MARCH);
  644. BIND_ENUM_CONSTANT(MONTH_APRIL);
  645. BIND_ENUM_CONSTANT(MONTH_MAY);
  646. BIND_ENUM_CONSTANT(MONTH_JUNE);
  647. BIND_ENUM_CONSTANT(MONTH_JULY);
  648. BIND_ENUM_CONSTANT(MONTH_AUGUST);
  649. BIND_ENUM_CONSTANT(MONTH_SEPTEMBER);
  650. BIND_ENUM_CONSTANT(MONTH_OCTOBER);
  651. BIND_ENUM_CONSTANT(MONTH_NOVEMBER);
  652. BIND_ENUM_CONSTANT(MONTH_DECEMBER);
  653. BIND_ENUM_CONSTANT(SYSTEM_DIR_DESKTOP);
  654. BIND_ENUM_CONSTANT(SYSTEM_DIR_DCIM);
  655. BIND_ENUM_CONSTANT(SYSTEM_DIR_DOCUMENTS);
  656. BIND_ENUM_CONSTANT(SYSTEM_DIR_DOWNLOADS);
  657. BIND_ENUM_CONSTANT(SYSTEM_DIR_MOVIES);
  658. BIND_ENUM_CONSTANT(SYSTEM_DIR_MUSIC);
  659. BIND_ENUM_CONSTANT(SYSTEM_DIR_PICTURES);
  660. BIND_ENUM_CONSTANT(SYSTEM_DIR_RINGTONES);
  661. }
  662. ////// _Geometry2D //////
  663. _Geometry2D *_Geometry2D::singleton = nullptr;
  664. _Geometry2D *_Geometry2D::get_singleton() {
  665. return singleton;
  666. }
  667. bool _Geometry2D::is_point_in_circle(const Vector2 &p_point, const Vector2 &p_circle_pos, real_t p_circle_radius) {
  668. return Geometry2D::is_point_in_circle(p_point, p_circle_pos, p_circle_radius);
  669. }
  670. real_t _Geometry2D::segment_intersects_circle(const Vector2 &p_from, const Vector2 &p_to, const Vector2 &p_circle_pos, real_t p_circle_radius) {
  671. return Geometry2D::segment_intersects_circle(p_from, p_to, p_circle_pos, p_circle_radius);
  672. }
  673. Variant _Geometry2D::segment_intersects_segment(const Vector2 &p_from_a, const Vector2 &p_to_a, const Vector2 &p_from_b, const Vector2 &p_to_b) {
  674. Vector2 result;
  675. if (Geometry2D::segment_intersects_segment(p_from_a, p_to_a, p_from_b, p_to_b, &result)) {
  676. return result;
  677. } else {
  678. return Variant();
  679. }
  680. }
  681. Variant _Geometry2D::line_intersects_line(const Vector2 &p_from_a, const Vector2 &p_dir_a, const Vector2 &p_from_b, const Vector2 &p_dir_b) {
  682. Vector2 result;
  683. if (Geometry2D::line_intersects_line(p_from_a, p_dir_a, p_from_b, p_dir_b, result)) {
  684. return result;
  685. } else {
  686. return Variant();
  687. }
  688. }
  689. Vector<Vector2> _Geometry2D::get_closest_points_between_segments(const Vector2 &p1, const Vector2 &q1, const Vector2 &p2, const Vector2 &q2) {
  690. Vector2 r1, r2;
  691. Geometry2D::get_closest_points_between_segments(p1, q1, p2, q2, r1, r2);
  692. Vector<Vector2> r;
  693. r.resize(2);
  694. r.set(0, r1);
  695. r.set(1, r2);
  696. return r;
  697. }
  698. Vector2 _Geometry2D::get_closest_point_to_segment(const Vector2 &p_point, const Vector2 &p_a, const Vector2 &p_b) {
  699. Vector2 s[2] = { p_a, p_b };
  700. return Geometry2D::get_closest_point_to_segment(p_point, s);
  701. }
  702. Vector2 _Geometry2D::get_closest_point_to_segment_uncapped(const Vector2 &p_point, const Vector2 &p_a, const Vector2 &p_b) {
  703. Vector2 s[2] = { p_a, p_b };
  704. return Geometry2D::get_closest_point_to_segment_uncapped(p_point, s);
  705. }
  706. bool _Geometry2D::point_is_inside_triangle(const Vector2 &s, const Vector2 &a, const Vector2 &b, const Vector2 &c) const {
  707. return Geometry2D::is_point_in_triangle(s, a, b, c);
  708. }
  709. bool _Geometry2D::is_polygon_clockwise(const Vector<Vector2> &p_polygon) {
  710. return Geometry2D::is_polygon_clockwise(p_polygon);
  711. }
  712. bool _Geometry2D::is_point_in_polygon(const Point2 &p_point, const Vector<Vector2> &p_polygon) {
  713. return Geometry2D::is_point_in_polygon(p_point, p_polygon);
  714. }
  715. Vector<int> _Geometry2D::triangulate_polygon(const Vector<Vector2> &p_polygon) {
  716. return Geometry2D::triangulate_polygon(p_polygon);
  717. }
  718. Vector<int> _Geometry2D::triangulate_delaunay(const Vector<Vector2> &p_points) {
  719. return Geometry2D::triangulate_delaunay(p_points);
  720. }
  721. Vector<Point2> _Geometry2D::convex_hull(const Vector<Point2> &p_points) {
  722. return Geometry2D::convex_hull(p_points);
  723. }
  724. Array _Geometry2D::merge_polygons(const Vector<Vector2> &p_polygon_a, const Vector<Vector2> &p_polygon_b) {
  725. Vector<Vector<Point2>> polys = Geometry2D::merge_polygons(p_polygon_a, p_polygon_b);
  726. Array ret;
  727. for (int i = 0; i < polys.size(); ++i) {
  728. ret.push_back(polys[i]);
  729. }
  730. return ret;
  731. }
  732. Array _Geometry2D::clip_polygons(const Vector<Vector2> &p_polygon_a, const Vector<Vector2> &p_polygon_b) {
  733. Vector<Vector<Point2>> polys = Geometry2D::clip_polygons(p_polygon_a, p_polygon_b);
  734. Array ret;
  735. for (int i = 0; i < polys.size(); ++i) {
  736. ret.push_back(polys[i]);
  737. }
  738. return ret;
  739. }
  740. Array _Geometry2D::intersect_polygons(const Vector<Vector2> &p_polygon_a, const Vector<Vector2> &p_polygon_b) {
  741. Vector<Vector<Point2>> polys = Geometry2D::intersect_polygons(p_polygon_a, p_polygon_b);
  742. Array ret;
  743. for (int i = 0; i < polys.size(); ++i) {
  744. ret.push_back(polys[i]);
  745. }
  746. return ret;
  747. }
  748. Array _Geometry2D::exclude_polygons(const Vector<Vector2> &p_polygon_a, const Vector<Vector2> &p_polygon_b) {
  749. Vector<Vector<Point2>> polys = Geometry2D::exclude_polygons(p_polygon_a, p_polygon_b);
  750. Array ret;
  751. for (int i = 0; i < polys.size(); ++i) {
  752. ret.push_back(polys[i]);
  753. }
  754. return ret;
  755. }
  756. Array _Geometry2D::clip_polyline_with_polygon(const Vector<Vector2> &p_polyline, const Vector<Vector2> &p_polygon) {
  757. Vector<Vector<Point2>> polys = Geometry2D::clip_polyline_with_polygon(p_polyline, p_polygon);
  758. Array ret;
  759. for (int i = 0; i < polys.size(); ++i) {
  760. ret.push_back(polys[i]);
  761. }
  762. return ret;
  763. }
  764. Array _Geometry2D::intersect_polyline_with_polygon(const Vector<Vector2> &p_polyline, const Vector<Vector2> &p_polygon) {
  765. Vector<Vector<Point2>> polys = Geometry2D::intersect_polyline_with_polygon(p_polyline, p_polygon);
  766. Array ret;
  767. for (int i = 0; i < polys.size(); ++i) {
  768. ret.push_back(polys[i]);
  769. }
  770. return ret;
  771. }
  772. Array _Geometry2D::offset_polygon(const Vector<Vector2> &p_polygon, real_t p_delta, PolyJoinType p_join_type) {
  773. Vector<Vector<Point2>> polys = Geometry2D::offset_polygon(p_polygon, p_delta, Geometry2D::PolyJoinType(p_join_type));
  774. Array ret;
  775. for (int i = 0; i < polys.size(); ++i) {
  776. ret.push_back(polys[i]);
  777. }
  778. return ret;
  779. }
  780. Array _Geometry2D::offset_polyline(const Vector<Vector2> &p_polygon, real_t p_delta, PolyJoinType p_join_type, PolyEndType p_end_type) {
  781. Vector<Vector<Point2>> polys = Geometry2D::offset_polyline(p_polygon, p_delta, Geometry2D::PolyJoinType(p_join_type), Geometry2D::PolyEndType(p_end_type));
  782. Array ret;
  783. for (int i = 0; i < polys.size(); ++i) {
  784. ret.push_back(polys[i]);
  785. }
  786. return ret;
  787. }
  788. Dictionary _Geometry2D::make_atlas(const Vector<Size2> &p_rects) {
  789. Dictionary ret;
  790. Vector<Size2i> rects;
  791. for (int i = 0; i < p_rects.size(); i++) {
  792. rects.push_back(p_rects[i]);
  793. }
  794. Vector<Point2i> result;
  795. Size2i size;
  796. Geometry2D::make_atlas(rects, result, size);
  797. Size2 r_size = size;
  798. Vector<Point2> r_result;
  799. for (int i = 0; i < result.size(); i++) {
  800. r_result.push_back(result[i]);
  801. }
  802. ret["points"] = r_result;
  803. ret["size"] = r_size;
  804. return ret;
  805. }
  806. void _Geometry2D::_bind_methods() {
  807. ClassDB::bind_method(D_METHOD("is_point_in_circle", "point", "circle_position", "circle_radius"), &_Geometry2D::is_point_in_circle);
  808. ClassDB::bind_method(D_METHOD("segment_intersects_segment", "from_a", "to_a", "from_b", "to_b"), &_Geometry2D::segment_intersects_segment);
  809. ClassDB::bind_method(D_METHOD("line_intersects_line", "from_a", "dir_a", "from_b", "dir_b"), &_Geometry2D::line_intersects_line);
  810. ClassDB::bind_method(D_METHOD("get_closest_points_between_segments", "p1", "q1", "p2", "q2"), &_Geometry2D::get_closest_points_between_segments);
  811. ClassDB::bind_method(D_METHOD("get_closest_point_to_segment", "point", "s1", "s2"), &_Geometry2D::get_closest_point_to_segment);
  812. ClassDB::bind_method(D_METHOD("get_closest_point_to_segment_uncapped", "point", "s1", "s2"), &_Geometry2D::get_closest_point_to_segment_uncapped);
  813. ClassDB::bind_method(D_METHOD("point_is_inside_triangle", "point", "a", "b", "c"), &_Geometry2D::point_is_inside_triangle);
  814. ClassDB::bind_method(D_METHOD("is_polygon_clockwise", "polygon"), &_Geometry2D::is_polygon_clockwise);
  815. ClassDB::bind_method(D_METHOD("is_point_in_polygon", "point", "polygon"), &_Geometry2D::is_point_in_polygon);
  816. ClassDB::bind_method(D_METHOD("triangulate_polygon", "polygon"), &_Geometry2D::triangulate_polygon);
  817. ClassDB::bind_method(D_METHOD("triangulate_delaunay", "points"), &_Geometry2D::triangulate_delaunay);
  818. ClassDB::bind_method(D_METHOD("convex_hull", "points"), &_Geometry2D::convex_hull);
  819. ClassDB::bind_method(D_METHOD("merge_polygons", "polygon_a", "polygon_b"), &_Geometry2D::merge_polygons);
  820. ClassDB::bind_method(D_METHOD("clip_polygons", "polygon_a", "polygon_b"), &_Geometry2D::clip_polygons);
  821. ClassDB::bind_method(D_METHOD("intersect_polygons", "polygon_a", "polygon_b"), &_Geometry2D::intersect_polygons);
  822. ClassDB::bind_method(D_METHOD("exclude_polygons", "polygon_a", "polygon_b"), &_Geometry2D::exclude_polygons);
  823. ClassDB::bind_method(D_METHOD("clip_polyline_with_polygon", "polyline", "polygon"), &_Geometry2D::clip_polyline_with_polygon);
  824. ClassDB::bind_method(D_METHOD("intersect_polyline_with_polygon", "polyline", "polygon"), &_Geometry2D::intersect_polyline_with_polygon);
  825. ClassDB::bind_method(D_METHOD("offset_polygon", "polygon", "delta", "join_type"), &_Geometry2D::offset_polygon, DEFVAL(JOIN_SQUARE));
  826. ClassDB::bind_method(D_METHOD("offset_polyline", "polyline", "delta", "join_type", "end_type"), &_Geometry2D::offset_polyline, DEFVAL(JOIN_SQUARE), DEFVAL(END_SQUARE));
  827. ClassDB::bind_method(D_METHOD("make_atlas", "sizes"), &_Geometry2D::make_atlas);
  828. BIND_ENUM_CONSTANT(OPERATION_UNION);
  829. BIND_ENUM_CONSTANT(OPERATION_DIFFERENCE);
  830. BIND_ENUM_CONSTANT(OPERATION_INTERSECTION);
  831. BIND_ENUM_CONSTANT(OPERATION_XOR);
  832. BIND_ENUM_CONSTANT(JOIN_SQUARE);
  833. BIND_ENUM_CONSTANT(JOIN_ROUND);
  834. BIND_ENUM_CONSTANT(JOIN_MITER);
  835. BIND_ENUM_CONSTANT(END_POLYGON);
  836. BIND_ENUM_CONSTANT(END_JOINED);
  837. BIND_ENUM_CONSTANT(END_BUTT);
  838. BIND_ENUM_CONSTANT(END_SQUARE);
  839. BIND_ENUM_CONSTANT(END_ROUND);
  840. }
  841. ////// _Geometry3D //////
  842. _Geometry3D *_Geometry3D::singleton = nullptr;
  843. _Geometry3D *_Geometry3D::get_singleton() {
  844. return singleton;
  845. }
  846. Vector<Plane> _Geometry3D::build_box_planes(const Vector3 &p_extents) {
  847. return Geometry3D::build_box_planes(p_extents);
  848. }
  849. Vector<Plane> _Geometry3D::build_cylinder_planes(float p_radius, float p_height, int p_sides, Vector3::Axis p_axis) {
  850. return Geometry3D::build_cylinder_planes(p_radius, p_height, p_sides, p_axis);
  851. }
  852. Vector<Plane> _Geometry3D::build_capsule_planes(float p_radius, float p_height, int p_sides, int p_lats, Vector3::Axis p_axis) {
  853. return Geometry3D::build_capsule_planes(p_radius, p_height, p_sides, p_lats, p_axis);
  854. }
  855. Vector<Vector3> _Geometry3D::get_closest_points_between_segments(const Vector3 &p1, const Vector3 &p2, const Vector3 &q1, const Vector3 &q2) {
  856. Vector3 r1, r2;
  857. Geometry3D::get_closest_points_between_segments(p1, p2, q1, q2, r1, r2);
  858. Vector<Vector3> r;
  859. r.resize(2);
  860. r.set(0, r1);
  861. r.set(1, r2);
  862. return r;
  863. }
  864. Vector3 _Geometry3D::get_closest_point_to_segment(const Vector3 &p_point, const Vector3 &p_a, const Vector3 &p_b) {
  865. Vector3 s[2] = { p_a, p_b };
  866. return Geometry3D::get_closest_point_to_segment(p_point, s);
  867. }
  868. Vector3 _Geometry3D::get_closest_point_to_segment_uncapped(const Vector3 &p_point, const Vector3 &p_a, const Vector3 &p_b) {
  869. Vector3 s[2] = { p_a, p_b };
  870. return Geometry3D::get_closest_point_to_segment_uncapped(p_point, s);
  871. }
  872. Variant _Geometry3D::ray_intersects_triangle(const Vector3 &p_from, const Vector3 &p_dir, const Vector3 &p_v0, const Vector3 &p_v1, const Vector3 &p_v2) {
  873. Vector3 res;
  874. if (Geometry3D::ray_intersects_triangle(p_from, p_dir, p_v0, p_v1, p_v2, &res)) {
  875. return res;
  876. } else {
  877. return Variant();
  878. }
  879. }
  880. Variant _Geometry3D::segment_intersects_triangle(const Vector3 &p_from, const Vector3 &p_to, const Vector3 &p_v0, const Vector3 &p_v1, const Vector3 &p_v2) {
  881. Vector3 res;
  882. if (Geometry3D::segment_intersects_triangle(p_from, p_to, p_v0, p_v1, p_v2, &res)) {
  883. return res;
  884. } else {
  885. return Variant();
  886. }
  887. }
  888. Vector<Vector3> _Geometry3D::segment_intersects_sphere(const Vector3 &p_from, const Vector3 &p_to, const Vector3 &p_sphere_pos, real_t p_sphere_radius) {
  889. Vector<Vector3> r;
  890. Vector3 res, norm;
  891. if (!Geometry3D::segment_intersects_sphere(p_from, p_to, p_sphere_pos, p_sphere_radius, &res, &norm)) {
  892. return r;
  893. }
  894. r.resize(2);
  895. r.set(0, res);
  896. r.set(1, norm);
  897. return r;
  898. }
  899. Vector<Vector3> _Geometry3D::segment_intersects_cylinder(const Vector3 &p_from, const Vector3 &p_to, float p_height, float p_radius) {
  900. Vector<Vector3> r;
  901. Vector3 res, norm;
  902. if (!Geometry3D::segment_intersects_cylinder(p_from, p_to, p_height, p_radius, &res, &norm)) {
  903. return r;
  904. }
  905. r.resize(2);
  906. r.set(0, res);
  907. r.set(1, norm);
  908. return r;
  909. }
  910. Vector<Vector3> _Geometry3D::segment_intersects_convex(const Vector3 &p_from, const Vector3 &p_to, const Vector<Plane> &p_planes) {
  911. Vector<Vector3> r;
  912. Vector3 res, norm;
  913. if (!Geometry3D::segment_intersects_convex(p_from, p_to, p_planes.ptr(), p_planes.size(), &res, &norm)) {
  914. return r;
  915. }
  916. r.resize(2);
  917. r.set(0, res);
  918. r.set(1, norm);
  919. return r;
  920. }
  921. Vector<Vector3> _Geometry3D::clip_polygon(const Vector<Vector3> &p_points, const Plane &p_plane) {
  922. return Geometry3D::clip_polygon(p_points, p_plane);
  923. }
  924. void _Geometry3D::_bind_methods() {
  925. ClassDB::bind_method(D_METHOD("build_box_planes", "extents"), &_Geometry3D::build_box_planes);
  926. ClassDB::bind_method(D_METHOD("build_cylinder_planes", "radius", "height", "sides", "axis"), &_Geometry3D::build_cylinder_planes, DEFVAL(Vector3::AXIS_Z));
  927. ClassDB::bind_method(D_METHOD("build_capsule_planes", "radius", "height", "sides", "lats", "axis"), &_Geometry3D::build_capsule_planes, DEFVAL(Vector3::AXIS_Z));
  928. ClassDB::bind_method(D_METHOD("get_closest_points_between_segments", "p1", "p2", "q1", "q2"), &_Geometry3D::get_closest_points_between_segments);
  929. ClassDB::bind_method(D_METHOD("get_closest_point_to_segment", "point", "s1", "s2"), &_Geometry3D::get_closest_point_to_segment);
  930. ClassDB::bind_method(D_METHOD("get_closest_point_to_segment_uncapped", "point", "s1", "s2"), &_Geometry3D::get_closest_point_to_segment_uncapped);
  931. ClassDB::bind_method(D_METHOD("ray_intersects_triangle", "from", "dir", "a", "b", "c"), &_Geometry3D::ray_intersects_triangle);
  932. ClassDB::bind_method(D_METHOD("segment_intersects_triangle", "from", "to", "a", "b", "c"), &_Geometry3D::segment_intersects_triangle);
  933. ClassDB::bind_method(D_METHOD("segment_intersects_sphere", "from", "to", "sphere_position", "sphere_radius"), &_Geometry3D::segment_intersects_sphere);
  934. ClassDB::bind_method(D_METHOD("segment_intersects_cylinder", "from", "to", "height", "radius"), &_Geometry3D::segment_intersects_cylinder);
  935. ClassDB::bind_method(D_METHOD("segment_intersects_convex", "from", "to", "planes"), &_Geometry3D::segment_intersects_convex);
  936. ClassDB::bind_method(D_METHOD("clip_polygon", "points", "plane"), &_Geometry3D::clip_polygon);
  937. }
  938. ////// _File //////
  939. Error _File::open_encrypted(const String &p_path, ModeFlags p_mode_flags, const Vector<uint8_t> &p_key) {
  940. Error err = open(p_path, p_mode_flags);
  941. if (err) {
  942. return err;
  943. }
  944. FileAccessEncrypted *fae = memnew(FileAccessEncrypted);
  945. err = fae->open_and_parse(f, p_key, (p_mode_flags == WRITE) ? FileAccessEncrypted::MODE_WRITE_AES256 : FileAccessEncrypted::MODE_READ);
  946. if (err) {
  947. memdelete(fae);
  948. close();
  949. return err;
  950. }
  951. f = fae;
  952. return OK;
  953. }
  954. Error _File::open_encrypted_pass(const String &p_path, ModeFlags p_mode_flags, const String &p_pass) {
  955. Error err = open(p_path, p_mode_flags);
  956. if (err) {
  957. return err;
  958. }
  959. FileAccessEncrypted *fae = memnew(FileAccessEncrypted);
  960. err = fae->open_and_parse_password(f, p_pass, (p_mode_flags == WRITE) ? FileAccessEncrypted::MODE_WRITE_AES256 : FileAccessEncrypted::MODE_READ);
  961. if (err) {
  962. memdelete(fae);
  963. close();
  964. return err;
  965. }
  966. f = fae;
  967. return OK;
  968. }
  969. Error _File::open_compressed(const String &p_path, ModeFlags p_mode_flags, CompressionMode p_compress_mode) {
  970. FileAccessCompressed *fac = memnew(FileAccessCompressed);
  971. fac->configure("GCPF", (Compression::Mode)p_compress_mode);
  972. Error err = fac->_open(p_path, p_mode_flags);
  973. if (err) {
  974. memdelete(fac);
  975. return err;
  976. }
  977. f = fac;
  978. return OK;
  979. }
  980. Error _File::open(const String &p_path, ModeFlags p_mode_flags) {
  981. close();
  982. Error err;
  983. f = FileAccess::open(p_path, p_mode_flags, &err);
  984. if (f) {
  985. f->set_endian_swap(eswap);
  986. }
  987. return err;
  988. }
  989. void _File::flush() {
  990. ERR_FAIL_COND_MSG(!f, "File must be opened before flushing.");
  991. f->flush();
  992. }
  993. void _File::close() {
  994. if (f) {
  995. memdelete(f);
  996. }
  997. f = nullptr;
  998. }
  999. bool _File::is_open() const {
  1000. return f != nullptr;
  1001. }
  1002. String _File::get_path() const {
  1003. ERR_FAIL_COND_V_MSG(!f, "", "File must be opened before use.");
  1004. return f->get_path();
  1005. }
  1006. String _File::get_path_absolute() const {
  1007. ERR_FAIL_COND_V_MSG(!f, "", "File must be opened before use.");
  1008. return f->get_path_absolute();
  1009. }
  1010. void _File::seek(int64_t p_position) {
  1011. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1012. ERR_FAIL_COND_MSG(p_position < 0, "Seek position must be a positive integer.");
  1013. f->seek(p_position);
  1014. }
  1015. void _File::seek_end(int64_t p_position) {
  1016. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1017. f->seek_end(p_position);
  1018. }
  1019. uint64_t _File::get_position() const {
  1020. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1021. return f->get_position();
  1022. }
  1023. uint64_t _File::get_length() const {
  1024. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1025. return f->get_length();
  1026. }
  1027. bool _File::eof_reached() const {
  1028. ERR_FAIL_COND_V_MSG(!f, false, "File must be opened before use.");
  1029. return f->eof_reached();
  1030. }
  1031. uint8_t _File::get_8() const {
  1032. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1033. return f->get_8();
  1034. }
  1035. uint16_t _File::get_16() const {
  1036. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1037. return f->get_16();
  1038. }
  1039. uint32_t _File::get_32() const {
  1040. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1041. return f->get_32();
  1042. }
  1043. uint64_t _File::get_64() const {
  1044. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1045. return f->get_64();
  1046. }
  1047. float _File::get_float() const {
  1048. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1049. return f->get_float();
  1050. }
  1051. double _File::get_double() const {
  1052. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1053. return f->get_double();
  1054. }
  1055. real_t _File::get_real() const {
  1056. ERR_FAIL_COND_V_MSG(!f, 0, "File must be opened before use.");
  1057. return f->get_real();
  1058. }
  1059. Vector<uint8_t> _File::get_buffer(int64_t p_length) const {
  1060. Vector<uint8_t> data;
  1061. ERR_FAIL_COND_V_MSG(!f, data, "File must be opened before use.");
  1062. ERR_FAIL_COND_V_MSG(p_length < 0, data, "Length of buffer cannot be smaller than 0.");
  1063. if (p_length == 0) {
  1064. return data;
  1065. }
  1066. Error err = data.resize(p_length);
  1067. ERR_FAIL_COND_V_MSG(err != OK, data, "Can't resize data to " + itos(p_length) + " elements.");
  1068. uint8_t *w = data.ptrw();
  1069. int64_t len = f->get_buffer(&w[0], p_length);
  1070. if (len < p_length) {
  1071. data.resize(len);
  1072. }
  1073. return data;
  1074. }
  1075. String _File::get_as_text() const {
  1076. ERR_FAIL_COND_V_MSG(!f, String(), "File must be opened before use.");
  1077. String text;
  1078. uint64_t original_pos = f->get_position();
  1079. f->seek(0);
  1080. String l = get_line();
  1081. while (!eof_reached()) {
  1082. text += l + "\n";
  1083. l = get_line();
  1084. }
  1085. text += l;
  1086. f->seek(original_pos);
  1087. return text;
  1088. }
  1089. String _File::get_md5(const String &p_path) const {
  1090. return FileAccess::get_md5(p_path);
  1091. }
  1092. String _File::get_sha256(const String &p_path) const {
  1093. return FileAccess::get_sha256(p_path);
  1094. }
  1095. String _File::get_line() const {
  1096. ERR_FAIL_COND_V_MSG(!f, String(), "File must be opened before use.");
  1097. return f->get_line();
  1098. }
  1099. Vector<String> _File::get_csv_line(const String &p_delim) const {
  1100. ERR_FAIL_COND_V_MSG(!f, Vector<String>(), "File must be opened before use.");
  1101. return f->get_csv_line(p_delim);
  1102. }
  1103. /**< use this for files WRITTEN in _big_ endian machines (i.e. amiga/mac)
  1104. * It's not about the current CPU type but file formats.
  1105. * These flags get reset to false (little endian) on each open
  1106. */
  1107. void _File::set_endian_swap(bool p_swap) {
  1108. eswap = p_swap;
  1109. if (f) {
  1110. f->set_endian_swap(p_swap);
  1111. }
  1112. }
  1113. bool _File::get_endian_swap() {
  1114. return eswap;
  1115. }
  1116. Error _File::get_error() const {
  1117. if (!f) {
  1118. return ERR_UNCONFIGURED;
  1119. }
  1120. return f->get_error();
  1121. }
  1122. void _File::store_8(uint8_t p_dest) {
  1123. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1124. f->store_8(p_dest);
  1125. }
  1126. void _File::store_16(uint16_t p_dest) {
  1127. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1128. f->store_16(p_dest);
  1129. }
  1130. void _File::store_32(uint32_t p_dest) {
  1131. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1132. f->store_32(p_dest);
  1133. }
  1134. void _File::store_64(uint64_t p_dest) {
  1135. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1136. f->store_64(p_dest);
  1137. }
  1138. void _File::store_float(float p_dest) {
  1139. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1140. f->store_float(p_dest);
  1141. }
  1142. void _File::store_double(double p_dest) {
  1143. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1144. f->store_double(p_dest);
  1145. }
  1146. void _File::store_real(real_t p_real) {
  1147. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1148. f->store_real(p_real);
  1149. }
  1150. void _File::store_string(const String &p_string) {
  1151. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1152. f->store_string(p_string);
  1153. }
  1154. void _File::store_pascal_string(const String &p_string) {
  1155. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1156. f->store_pascal_string(p_string);
  1157. }
  1158. String _File::get_pascal_string() {
  1159. ERR_FAIL_COND_V_MSG(!f, "", "File must be opened before use.");
  1160. return f->get_pascal_string();
  1161. }
  1162. void _File::store_line(const String &p_string) {
  1163. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1164. f->store_line(p_string);
  1165. }
  1166. void _File::store_csv_line(const Vector<String> &p_values, const String &p_delim) {
  1167. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1168. f->store_csv_line(p_values, p_delim);
  1169. }
  1170. void _File::store_buffer(const Vector<uint8_t> &p_buffer) {
  1171. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1172. uint64_t len = p_buffer.size();
  1173. if (len == 0) {
  1174. return;
  1175. }
  1176. const uint8_t *r = p_buffer.ptr();
  1177. f->store_buffer(&r[0], len);
  1178. }
  1179. bool _File::file_exists(const String &p_name) const {
  1180. return FileAccess::exists(p_name);
  1181. }
  1182. void _File::store_var(const Variant &p_var, bool p_full_objects) {
  1183. ERR_FAIL_COND_MSG(!f, "File must be opened before use.");
  1184. int len;
  1185. Error err = encode_variant(p_var, nullptr, len, p_full_objects);
  1186. ERR_FAIL_COND_MSG(err != OK, "Error when trying to encode Variant.");
  1187. Vector<uint8_t> buff;
  1188. buff.resize(len);
  1189. uint8_t *w = buff.ptrw();
  1190. err = encode_variant(p_var, &w[0], len, p_full_objects);
  1191. ERR_FAIL_COND_MSG(err != OK, "Error when trying to encode Variant.");
  1192. store_32(len);
  1193. store_buffer(buff);
  1194. }
  1195. Variant _File::get_var(bool p_allow_objects) const {
  1196. ERR_FAIL_COND_V_MSG(!f, Variant(), "File must be opened before use.");
  1197. uint32_t len = get_32();
  1198. Vector<uint8_t> buff = get_buffer(len);
  1199. ERR_FAIL_COND_V((uint32_t)buff.size() != len, Variant());
  1200. const uint8_t *r = buff.ptr();
  1201. Variant v;
  1202. Error err = decode_variant(v, &r[0], len, nullptr, p_allow_objects);
  1203. ERR_FAIL_COND_V_MSG(err != OK, Variant(), "Error when trying to encode Variant.");
  1204. return v;
  1205. }
  1206. uint64_t _File::get_modified_time(const String &p_file) const {
  1207. return FileAccess::get_modified_time(p_file);
  1208. }
  1209. void _File::_bind_methods() {
  1210. ClassDB::bind_method(D_METHOD("open_encrypted", "path", "mode_flags", "key"), &_File::open_encrypted);
  1211. ClassDB::bind_method(D_METHOD("open_encrypted_with_pass", "path", "mode_flags", "pass"), &_File::open_encrypted_pass);
  1212. ClassDB::bind_method(D_METHOD("open_compressed", "path", "mode_flags", "compression_mode"), &_File::open_compressed, DEFVAL(0));
  1213. ClassDB::bind_method(D_METHOD("open", "path", "flags"), &_File::open);
  1214. ClassDB::bind_method(D_METHOD("flush"), &_File::flush);
  1215. ClassDB::bind_method(D_METHOD("close"), &_File::close);
  1216. ClassDB::bind_method(D_METHOD("get_path"), &_File::get_path);
  1217. ClassDB::bind_method(D_METHOD("get_path_absolute"), &_File::get_path_absolute);
  1218. ClassDB::bind_method(D_METHOD("is_open"), &_File::is_open);
  1219. ClassDB::bind_method(D_METHOD("seek", "position"), &_File::seek);
  1220. ClassDB::bind_method(D_METHOD("seek_end", "position"), &_File::seek_end, DEFVAL(0));
  1221. ClassDB::bind_method(D_METHOD("get_position"), &_File::get_position);
  1222. ClassDB::bind_method(D_METHOD("get_length"), &_File::get_length);
  1223. ClassDB::bind_method(D_METHOD("eof_reached"), &_File::eof_reached);
  1224. ClassDB::bind_method(D_METHOD("get_8"), &_File::get_8);
  1225. ClassDB::bind_method(D_METHOD("get_16"), &_File::get_16);
  1226. ClassDB::bind_method(D_METHOD("get_32"), &_File::get_32);
  1227. ClassDB::bind_method(D_METHOD("get_64"), &_File::get_64);
  1228. ClassDB::bind_method(D_METHOD("get_float"), &_File::get_float);
  1229. ClassDB::bind_method(D_METHOD("get_double"), &_File::get_double);
  1230. ClassDB::bind_method(D_METHOD("get_real"), &_File::get_real);
  1231. ClassDB::bind_method(D_METHOD("get_buffer", "length"), &_File::get_buffer);
  1232. ClassDB::bind_method(D_METHOD("get_line"), &_File::get_line);
  1233. ClassDB::bind_method(D_METHOD("get_csv_line", "delim"), &_File::get_csv_line, DEFVAL(","));
  1234. ClassDB::bind_method(D_METHOD("get_as_text"), &_File::get_as_text);
  1235. ClassDB::bind_method(D_METHOD("get_md5", "path"), &_File::get_md5);
  1236. ClassDB::bind_method(D_METHOD("get_sha256", "path"), &_File::get_sha256);
  1237. ClassDB::bind_method(D_METHOD("get_endian_swap"), &_File::get_endian_swap);
  1238. ClassDB::bind_method(D_METHOD("set_endian_swap", "enable"), &_File::set_endian_swap);
  1239. ClassDB::bind_method(D_METHOD("get_error"), &_File::get_error);
  1240. ClassDB::bind_method(D_METHOD("get_var", "allow_objects"), &_File::get_var, DEFVAL(false));
  1241. ClassDB::bind_method(D_METHOD("store_8", "value"), &_File::store_8);
  1242. ClassDB::bind_method(D_METHOD("store_16", "value"), &_File::store_16);
  1243. ClassDB::bind_method(D_METHOD("store_32", "value"), &_File::store_32);
  1244. ClassDB::bind_method(D_METHOD("store_64", "value"), &_File::store_64);
  1245. ClassDB::bind_method(D_METHOD("store_float", "value"), &_File::store_float);
  1246. ClassDB::bind_method(D_METHOD("store_double", "value"), &_File::store_double);
  1247. ClassDB::bind_method(D_METHOD("store_real", "value"), &_File::store_real);
  1248. ClassDB::bind_method(D_METHOD("store_buffer", "buffer"), &_File::store_buffer);
  1249. ClassDB::bind_method(D_METHOD("store_line", "line"), &_File::store_line);
  1250. ClassDB::bind_method(D_METHOD("store_csv_line", "values", "delim"), &_File::store_csv_line, DEFVAL(","));
  1251. ClassDB::bind_method(D_METHOD("store_string", "string"), &_File::store_string);
  1252. ClassDB::bind_method(D_METHOD("store_var", "value", "full_objects"), &_File::store_var, DEFVAL(false));
  1253. ClassDB::bind_method(D_METHOD("store_pascal_string", "string"), &_File::store_pascal_string);
  1254. ClassDB::bind_method(D_METHOD("get_pascal_string"), &_File::get_pascal_string);
  1255. ClassDB::bind_method(D_METHOD("file_exists", "path"), &_File::file_exists);
  1256. ClassDB::bind_method(D_METHOD("get_modified_time", "file"), &_File::get_modified_time);
  1257. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "endian_swap"), "set_endian_swap", "get_endian_swap");
  1258. BIND_ENUM_CONSTANT(READ);
  1259. BIND_ENUM_CONSTANT(WRITE);
  1260. BIND_ENUM_CONSTANT(READ_WRITE);
  1261. BIND_ENUM_CONSTANT(WRITE_READ);
  1262. BIND_ENUM_CONSTANT(COMPRESSION_FASTLZ);
  1263. BIND_ENUM_CONSTANT(COMPRESSION_DEFLATE);
  1264. BIND_ENUM_CONSTANT(COMPRESSION_ZSTD);
  1265. BIND_ENUM_CONSTANT(COMPRESSION_GZIP);
  1266. }
  1267. _File::~_File() {
  1268. if (f) {
  1269. memdelete(f);
  1270. }
  1271. }
  1272. ////// _Directory //////
  1273. Error _Directory::open(const String &p_path) {
  1274. Error err;
  1275. DirAccess *alt = DirAccess::open(p_path, &err);
  1276. if (!alt) {
  1277. return err;
  1278. }
  1279. if (d) {
  1280. memdelete(d);
  1281. }
  1282. d = alt;
  1283. dir_open = true;
  1284. return OK;
  1285. }
  1286. bool _Directory::is_open() const {
  1287. return d && dir_open;
  1288. }
  1289. Error _Directory::list_dir_begin(bool p_show_navigational, bool p_show_hidden) {
  1290. ERR_FAIL_COND_V_MSG(!is_open(), ERR_UNCONFIGURED, "Directory must be opened before use.");
  1291. _list_skip_navigational = !p_show_navigational;
  1292. _list_skip_hidden = !p_show_hidden;
  1293. return d->list_dir_begin();
  1294. }
  1295. String _Directory::get_next() {
  1296. ERR_FAIL_COND_V_MSG(!is_open(), "", "Directory must be opened before use.");
  1297. String next = d->get_next();
  1298. while (next != "" && ((_list_skip_navigational && (next == "." || next == "..")) || (_list_skip_hidden && d->current_is_hidden()))) {
  1299. next = d->get_next();
  1300. }
  1301. return next;
  1302. }
  1303. bool _Directory::current_is_dir() const {
  1304. ERR_FAIL_COND_V_MSG(!is_open(), false, "Directory must be opened before use.");
  1305. return d->current_is_dir();
  1306. }
  1307. void _Directory::list_dir_end() {
  1308. ERR_FAIL_COND_MSG(!is_open(), "Directory must be opened before use.");
  1309. d->list_dir_end();
  1310. }
  1311. int _Directory::get_drive_count() {
  1312. ERR_FAIL_COND_V_MSG(!is_open(), 0, "Directory must be opened before use.");
  1313. return d->get_drive_count();
  1314. }
  1315. String _Directory::get_drive(int p_drive) {
  1316. ERR_FAIL_COND_V_MSG(!is_open(), "", "Directory must be opened before use.");
  1317. return d->get_drive(p_drive);
  1318. }
  1319. int _Directory::get_current_drive() {
  1320. ERR_FAIL_COND_V_MSG(!is_open(), 0, "Directory must be opened before use.");
  1321. return d->get_current_drive();
  1322. }
  1323. Error _Directory::change_dir(String p_dir) {
  1324. ERR_FAIL_COND_V_MSG(!d, ERR_UNCONFIGURED, "Directory is not configured properly.");
  1325. Error err = d->change_dir(p_dir);
  1326. if (err != OK) {
  1327. return err;
  1328. }
  1329. dir_open = true;
  1330. return OK;
  1331. }
  1332. String _Directory::get_current_dir() {
  1333. ERR_FAIL_COND_V_MSG(!is_open(), "", "Directory must be opened before use.");
  1334. return d->get_current_dir();
  1335. }
  1336. Error _Directory::make_dir(String p_dir) {
  1337. ERR_FAIL_COND_V_MSG(!d, ERR_UNCONFIGURED, "Directory is not configured properly.");
  1338. if (!p_dir.is_rel_path()) {
  1339. DirAccess *d = DirAccess::create_for_path(p_dir);
  1340. Error err = d->make_dir(p_dir);
  1341. memdelete(d);
  1342. return err;
  1343. }
  1344. return d->make_dir(p_dir);
  1345. }
  1346. Error _Directory::make_dir_recursive(String p_dir) {
  1347. ERR_FAIL_COND_V_MSG(!d, ERR_UNCONFIGURED, "Directory is not configured properly.");
  1348. if (!p_dir.is_rel_path()) {
  1349. DirAccess *d = DirAccess::create_for_path(p_dir);
  1350. Error err = d->make_dir_recursive(p_dir);
  1351. memdelete(d);
  1352. return err;
  1353. }
  1354. return d->make_dir_recursive(p_dir);
  1355. }
  1356. bool _Directory::file_exists(String p_file) {
  1357. ERR_FAIL_COND_V_MSG(!d, false, "Directory is not configured properly.");
  1358. if (!p_file.is_rel_path()) {
  1359. return FileAccess::exists(p_file);
  1360. }
  1361. return d->file_exists(p_file);
  1362. }
  1363. bool _Directory::dir_exists(String p_dir) {
  1364. ERR_FAIL_COND_V_MSG(!d, false, "Directory is not configured properly.");
  1365. if (!p_dir.is_rel_path()) {
  1366. DirAccess *d = DirAccess::create_for_path(p_dir);
  1367. bool exists = d->dir_exists(p_dir);
  1368. memdelete(d);
  1369. return exists;
  1370. }
  1371. return d->dir_exists(p_dir);
  1372. }
  1373. uint64_t _Directory::get_space_left() {
  1374. ERR_FAIL_COND_V_MSG(!d, 0, "Directory must be opened before use.");
  1375. return d->get_space_left() / 1024 * 1024; // Truncate to closest MiB.
  1376. }
  1377. Error _Directory::copy(String p_from, String p_to) {
  1378. ERR_FAIL_COND_V_MSG(!is_open(), ERR_UNCONFIGURED, "Directory must be opened before use.");
  1379. return d->copy(p_from, p_to);
  1380. }
  1381. Error _Directory::rename(String p_from, String p_to) {
  1382. ERR_FAIL_COND_V_MSG(!is_open(), ERR_UNCONFIGURED, "Directory must be opened before use.");
  1383. if (!p_from.is_rel_path()) {
  1384. DirAccess *d = DirAccess::create_for_path(p_from);
  1385. ERR_FAIL_COND_V_MSG(!d->file_exists(p_from), ERR_DOES_NOT_EXIST, "File does not exist.");
  1386. Error err = d->rename(p_from, p_to);
  1387. memdelete(d);
  1388. return err;
  1389. }
  1390. ERR_FAIL_COND_V_MSG(!d->file_exists(p_from), ERR_DOES_NOT_EXIST, "File does not exist.");
  1391. return d->rename(p_from, p_to);
  1392. }
  1393. Error _Directory::remove(String p_name) {
  1394. ERR_FAIL_COND_V_MSG(!is_open(), ERR_UNCONFIGURED, "Directory must be opened before use.");
  1395. if (!p_name.is_rel_path()) {
  1396. DirAccess *d = DirAccess::create_for_path(p_name);
  1397. Error err = d->remove(p_name);
  1398. memdelete(d);
  1399. return err;
  1400. }
  1401. return d->remove(p_name);
  1402. }
  1403. void _Directory::_bind_methods() {
  1404. ClassDB::bind_method(D_METHOD("open", "path"), &_Directory::open);
  1405. ClassDB::bind_method(D_METHOD("list_dir_begin", "show_navigational", "show_hidden"), &_Directory::list_dir_begin, DEFVAL(false), DEFVAL(false));
  1406. ClassDB::bind_method(D_METHOD("get_next"), &_Directory::get_next);
  1407. ClassDB::bind_method(D_METHOD("current_is_dir"), &_Directory::current_is_dir);
  1408. ClassDB::bind_method(D_METHOD("list_dir_end"), &_Directory::list_dir_end);
  1409. ClassDB::bind_method(D_METHOD("get_drive_count"), &_Directory::get_drive_count);
  1410. ClassDB::bind_method(D_METHOD("get_drive", "idx"), &_Directory::get_drive);
  1411. ClassDB::bind_method(D_METHOD("get_current_drive"), &_Directory::get_current_drive);
  1412. ClassDB::bind_method(D_METHOD("change_dir", "todir"), &_Directory::change_dir);
  1413. ClassDB::bind_method(D_METHOD("get_current_dir"), &_Directory::get_current_dir);
  1414. ClassDB::bind_method(D_METHOD("make_dir", "path"), &_Directory::make_dir);
  1415. ClassDB::bind_method(D_METHOD("make_dir_recursive", "path"), &_Directory::make_dir_recursive);
  1416. ClassDB::bind_method(D_METHOD("file_exists", "path"), &_Directory::file_exists);
  1417. ClassDB::bind_method(D_METHOD("dir_exists", "path"), &_Directory::dir_exists);
  1418. //ClassDB::bind_method(D_METHOD("get_modified_time","file"),&_Directory::get_modified_time);
  1419. ClassDB::bind_method(D_METHOD("get_space_left"), &_Directory::get_space_left);
  1420. ClassDB::bind_method(D_METHOD("copy", "from", "to"), &_Directory::copy);
  1421. ClassDB::bind_method(D_METHOD("rename", "from", "to"), &_Directory::rename);
  1422. ClassDB::bind_method(D_METHOD("remove", "path"), &_Directory::remove);
  1423. }
  1424. _Directory::_Directory() {
  1425. d = DirAccess::create(DirAccess::ACCESS_RESOURCES);
  1426. }
  1427. _Directory::~_Directory() {
  1428. if (d) {
  1429. memdelete(d);
  1430. }
  1431. }
  1432. ////// _Marshalls //////
  1433. _Marshalls *_Marshalls::singleton = nullptr;
  1434. _Marshalls *_Marshalls::get_singleton() {
  1435. return singleton;
  1436. }
  1437. String _Marshalls::variant_to_base64(const Variant &p_var, bool p_full_objects) {
  1438. int len;
  1439. Error err = encode_variant(p_var, nullptr, len, p_full_objects);
  1440. ERR_FAIL_COND_V_MSG(err != OK, "", "Error when trying to encode Variant.");
  1441. Vector<uint8_t> buff;
  1442. buff.resize(len);
  1443. uint8_t *w = buff.ptrw();
  1444. err = encode_variant(p_var, &w[0], len, p_full_objects);
  1445. ERR_FAIL_COND_V_MSG(err != OK, "", "Error when trying to encode Variant.");
  1446. String ret = CryptoCore::b64_encode_str(&w[0], len);
  1447. ERR_FAIL_COND_V(ret == "", ret);
  1448. return ret;
  1449. }
  1450. Variant _Marshalls::base64_to_variant(const String &p_str, bool p_allow_objects) {
  1451. int strlen = p_str.length();
  1452. CharString cstr = p_str.ascii();
  1453. Vector<uint8_t> buf;
  1454. buf.resize(strlen / 4 * 3 + 1);
  1455. uint8_t *w = buf.ptrw();
  1456. size_t len = 0;
  1457. ERR_FAIL_COND_V(CryptoCore::b64_decode(&w[0], buf.size(), &len, (unsigned char *)cstr.get_data(), strlen) != OK, Variant());
  1458. Variant v;
  1459. Error err = decode_variant(v, &w[0], len, nullptr, p_allow_objects);
  1460. ERR_FAIL_COND_V_MSG(err != OK, Variant(), "Error when trying to decode Variant.");
  1461. return v;
  1462. }
  1463. String _Marshalls::raw_to_base64(const Vector<uint8_t> &p_arr) {
  1464. String ret = CryptoCore::b64_encode_str(p_arr.ptr(), p_arr.size());
  1465. ERR_FAIL_COND_V(ret == "", ret);
  1466. return ret;
  1467. }
  1468. Vector<uint8_t> _Marshalls::base64_to_raw(const String &p_str) {
  1469. int strlen = p_str.length();
  1470. CharString cstr = p_str.ascii();
  1471. size_t arr_len = 0;
  1472. Vector<uint8_t> buf;
  1473. {
  1474. buf.resize(strlen / 4 * 3 + 1);
  1475. uint8_t *w = buf.ptrw();
  1476. ERR_FAIL_COND_V(CryptoCore::b64_decode(&w[0], buf.size(), &arr_len, (unsigned char *)cstr.get_data(), strlen) != OK, Vector<uint8_t>());
  1477. }
  1478. buf.resize(arr_len);
  1479. return buf;
  1480. }
  1481. String _Marshalls::utf8_to_base64(const String &p_str) {
  1482. CharString cstr = p_str.utf8();
  1483. String ret = CryptoCore::b64_encode_str((unsigned char *)cstr.get_data(), cstr.length());
  1484. ERR_FAIL_COND_V(ret == "", ret);
  1485. return ret;
  1486. }
  1487. String _Marshalls::base64_to_utf8(const String &p_str) {
  1488. int strlen = p_str.length();
  1489. CharString cstr = p_str.ascii();
  1490. Vector<uint8_t> buf;
  1491. buf.resize(strlen / 4 * 3 + 1 + 1);
  1492. uint8_t *w = buf.ptrw();
  1493. size_t len = 0;
  1494. ERR_FAIL_COND_V(CryptoCore::b64_decode(&w[0], buf.size(), &len, (unsigned char *)cstr.get_data(), strlen) != OK, String());
  1495. w[len] = 0;
  1496. String ret = String::utf8((char *)&w[0]);
  1497. return ret;
  1498. }
  1499. void _Marshalls::_bind_methods() {
  1500. ClassDB::bind_method(D_METHOD("variant_to_base64", "variant", "full_objects"), &_Marshalls::variant_to_base64, DEFVAL(false));
  1501. ClassDB::bind_method(D_METHOD("base64_to_variant", "base64_str", "allow_objects"), &_Marshalls::base64_to_variant, DEFVAL(false));
  1502. ClassDB::bind_method(D_METHOD("raw_to_base64", "array"), &_Marshalls::raw_to_base64);
  1503. ClassDB::bind_method(D_METHOD("base64_to_raw", "base64_str"), &_Marshalls::base64_to_raw);
  1504. ClassDB::bind_method(D_METHOD("utf8_to_base64", "utf8_str"), &_Marshalls::utf8_to_base64);
  1505. ClassDB::bind_method(D_METHOD("base64_to_utf8", "base64_str"), &_Marshalls::base64_to_utf8);
  1506. }
  1507. ////// _Semaphore //////
  1508. void _Semaphore::wait() {
  1509. semaphore.wait();
  1510. }
  1511. Error _Semaphore::try_wait() {
  1512. return semaphore.try_wait() ? OK : ERR_BUSY;
  1513. }
  1514. void _Semaphore::post() {
  1515. semaphore.post();
  1516. }
  1517. void _Semaphore::_bind_methods() {
  1518. ClassDB::bind_method(D_METHOD("wait"), &_Semaphore::wait);
  1519. ClassDB::bind_method(D_METHOD("try_wait"), &_Semaphore::try_wait);
  1520. ClassDB::bind_method(D_METHOD("post"), &_Semaphore::post);
  1521. }
  1522. ////// _Mutex //////
  1523. void _Mutex::lock() {
  1524. mutex.lock();
  1525. }
  1526. Error _Mutex::try_lock() {
  1527. return mutex.try_lock();
  1528. }
  1529. void _Mutex::unlock() {
  1530. mutex.unlock();
  1531. }
  1532. void _Mutex::_bind_methods() {
  1533. ClassDB::bind_method(D_METHOD("lock"), &_Mutex::lock);
  1534. ClassDB::bind_method(D_METHOD("try_lock"), &_Mutex::try_lock);
  1535. ClassDB::bind_method(D_METHOD("unlock"), &_Mutex::unlock);
  1536. }
  1537. ////// _Thread //////
  1538. void _Thread::_start_func(void *ud) {
  1539. Ref<_Thread> *tud = (Ref<_Thread> *)ud;
  1540. Ref<_Thread> t = *tud;
  1541. memdelete(tud);
  1542. Callable::CallError ce;
  1543. const Variant *arg[1] = { &t->userdata };
  1544. Thread::set_name(t->target_method);
  1545. t->ret = t->target_instance->call(t->target_method, arg, 1, ce);
  1546. if (ce.error != Callable::CallError::CALL_OK) {
  1547. String reason;
  1548. switch (ce.error) {
  1549. case Callable::CallError::CALL_ERROR_INVALID_ARGUMENT: {
  1550. reason = "Invalid Argument #" + itos(ce.argument);
  1551. } break;
  1552. case Callable::CallError::CALL_ERROR_TOO_MANY_ARGUMENTS: {
  1553. reason = "Too Many Arguments";
  1554. } break;
  1555. case Callable::CallError::CALL_ERROR_TOO_FEW_ARGUMENTS: {
  1556. reason = "Too Few Arguments";
  1557. } break;
  1558. case Callable::CallError::CALL_ERROR_INVALID_METHOD: {
  1559. reason = "Method Not Found";
  1560. } break;
  1561. default: {
  1562. }
  1563. }
  1564. ERR_FAIL_MSG("Could not call function '" + t->target_method.operator String() + "' to start thread " + t->get_id() + ": " + reason + ".");
  1565. }
  1566. }
  1567. Error _Thread::start(Object *p_instance, const StringName &p_method, const Variant &p_userdata, Priority p_priority) {
  1568. ERR_FAIL_COND_V_MSG(active.is_set(), ERR_ALREADY_IN_USE, "Thread already started.");
  1569. ERR_FAIL_COND_V(!p_instance, ERR_INVALID_PARAMETER);
  1570. ERR_FAIL_COND_V(p_method == StringName(), ERR_INVALID_PARAMETER);
  1571. ERR_FAIL_INDEX_V(p_priority, PRIORITY_MAX, ERR_INVALID_PARAMETER);
  1572. ret = Variant();
  1573. target_method = p_method;
  1574. target_instance = p_instance;
  1575. userdata = p_userdata;
  1576. active.set();
  1577. Ref<_Thread> *ud = memnew(Ref<_Thread>(this));
  1578. Thread::Settings s;
  1579. s.priority = (Thread::Priority)p_priority;
  1580. thread.start(_start_func, ud, s);
  1581. return OK;
  1582. }
  1583. String _Thread::get_id() const {
  1584. return itos(thread.get_id());
  1585. }
  1586. bool _Thread::is_active() const {
  1587. return active.is_set();
  1588. }
  1589. Variant _Thread::wait_to_finish() {
  1590. ERR_FAIL_COND_V_MSG(!active.is_set(), Variant(), "Thread must be active to wait for its completion.");
  1591. thread.wait_to_finish();
  1592. Variant r = ret;
  1593. active.clear();
  1594. target_method = StringName();
  1595. target_instance = nullptr;
  1596. userdata = Variant();
  1597. return r;
  1598. }
  1599. void _Thread::_bind_methods() {
  1600. ClassDB::bind_method(D_METHOD("start", "instance", "method", "userdata", "priority"), &_Thread::start, DEFVAL(Variant()), DEFVAL(PRIORITY_NORMAL));
  1601. ClassDB::bind_method(D_METHOD("get_id"), &_Thread::get_id);
  1602. ClassDB::bind_method(D_METHOD("is_active"), &_Thread::is_active);
  1603. ClassDB::bind_method(D_METHOD("wait_to_finish"), &_Thread::wait_to_finish);
  1604. BIND_ENUM_CONSTANT(PRIORITY_LOW);
  1605. BIND_ENUM_CONSTANT(PRIORITY_NORMAL);
  1606. BIND_ENUM_CONSTANT(PRIORITY_HIGH);
  1607. }
  1608. ////// _ClassDB //////
  1609. PackedStringArray _ClassDB::get_class_list() const {
  1610. List<StringName> classes;
  1611. ClassDB::get_class_list(&classes);
  1612. PackedStringArray ret;
  1613. ret.resize(classes.size());
  1614. int idx = 0;
  1615. for (List<StringName>::Element *E = classes.front(); E; E = E->next()) {
  1616. ret.set(idx++, E->get());
  1617. }
  1618. return ret;
  1619. }
  1620. PackedStringArray _ClassDB::get_inheriters_from_class(const StringName &p_class) const {
  1621. List<StringName> classes;
  1622. ClassDB::get_inheriters_from_class(p_class, &classes);
  1623. PackedStringArray ret;
  1624. ret.resize(classes.size());
  1625. int idx = 0;
  1626. for (List<StringName>::Element *E = classes.front(); E; E = E->next()) {
  1627. ret.set(idx++, E->get());
  1628. }
  1629. return ret;
  1630. }
  1631. StringName _ClassDB::get_parent_class(const StringName &p_class) const {
  1632. return ClassDB::get_parent_class(p_class);
  1633. }
  1634. bool _ClassDB::class_exists(const StringName &p_class) const {
  1635. return ClassDB::class_exists(p_class);
  1636. }
  1637. bool _ClassDB::is_parent_class(const StringName &p_class, const StringName &p_inherits) const {
  1638. return ClassDB::is_parent_class(p_class, p_inherits);
  1639. }
  1640. bool _ClassDB::can_instance(const StringName &p_class) const {
  1641. return ClassDB::can_instance(p_class);
  1642. }
  1643. Variant _ClassDB::instance(const StringName &p_class) const {
  1644. Object *obj = ClassDB::instance(p_class);
  1645. if (!obj) {
  1646. return Variant();
  1647. }
  1648. Reference *r = Object::cast_to<Reference>(obj);
  1649. if (r) {
  1650. return REF(r);
  1651. } else {
  1652. return obj;
  1653. }
  1654. }
  1655. bool _ClassDB::has_signal(StringName p_class, StringName p_signal) const {
  1656. return ClassDB::has_signal(p_class, p_signal);
  1657. }
  1658. Dictionary _ClassDB::get_signal(StringName p_class, StringName p_signal) const {
  1659. MethodInfo signal;
  1660. if (ClassDB::get_signal(p_class, p_signal, &signal)) {
  1661. return signal.operator Dictionary();
  1662. } else {
  1663. return Dictionary();
  1664. }
  1665. }
  1666. Array _ClassDB::get_signal_list(StringName p_class, bool p_no_inheritance) const {
  1667. List<MethodInfo> signals;
  1668. ClassDB::get_signal_list(p_class, &signals, p_no_inheritance);
  1669. Array ret;
  1670. for (List<MethodInfo>::Element *E = signals.front(); E; E = E->next()) {
  1671. ret.push_back(E->get().operator Dictionary());
  1672. }
  1673. return ret;
  1674. }
  1675. Array _ClassDB::get_property_list(StringName p_class, bool p_no_inheritance) const {
  1676. List<PropertyInfo> plist;
  1677. ClassDB::get_property_list(p_class, &plist, p_no_inheritance);
  1678. Array ret;
  1679. for (List<PropertyInfo>::Element *E = plist.front(); E; E = E->next()) {
  1680. ret.push_back(E->get().operator Dictionary());
  1681. }
  1682. return ret;
  1683. }
  1684. Variant _ClassDB::get_property(Object *p_object, const StringName &p_property) const {
  1685. Variant ret;
  1686. ClassDB::get_property(p_object, p_property, ret);
  1687. return ret;
  1688. }
  1689. Error _ClassDB::set_property(Object *p_object, const StringName &p_property, const Variant &p_value) const {
  1690. Variant ret;
  1691. bool valid;
  1692. if (!ClassDB::set_property(p_object, p_property, p_value, &valid)) {
  1693. return ERR_UNAVAILABLE;
  1694. } else if (!valid) {
  1695. return ERR_INVALID_DATA;
  1696. }
  1697. return OK;
  1698. }
  1699. bool _ClassDB::has_method(StringName p_class, StringName p_method, bool p_no_inheritance) const {
  1700. return ClassDB::has_method(p_class, p_method, p_no_inheritance);
  1701. }
  1702. Array _ClassDB::get_method_list(StringName p_class, bool p_no_inheritance) const {
  1703. List<MethodInfo> methods;
  1704. ClassDB::get_method_list(p_class, &methods, p_no_inheritance);
  1705. Array ret;
  1706. for (List<MethodInfo>::Element *E = methods.front(); E; E = E->next()) {
  1707. #ifdef DEBUG_METHODS_ENABLED
  1708. ret.push_back(E->get().operator Dictionary());
  1709. #else
  1710. Dictionary dict;
  1711. dict["name"] = E->get().name;
  1712. ret.push_back(dict);
  1713. #endif
  1714. }
  1715. return ret;
  1716. }
  1717. PackedStringArray _ClassDB::get_integer_constant_list(const StringName &p_class, bool p_no_inheritance) const {
  1718. List<String> constants;
  1719. ClassDB::get_integer_constant_list(p_class, &constants, p_no_inheritance);
  1720. PackedStringArray ret;
  1721. ret.resize(constants.size());
  1722. int idx = 0;
  1723. for (List<String>::Element *E = constants.front(); E; E = E->next()) {
  1724. ret.set(idx++, E->get());
  1725. }
  1726. return ret;
  1727. }
  1728. bool _ClassDB::has_integer_constant(const StringName &p_class, const StringName &p_name) const {
  1729. bool success;
  1730. ClassDB::get_integer_constant(p_class, p_name, &success);
  1731. return success;
  1732. }
  1733. int _ClassDB::get_integer_constant(const StringName &p_class, const StringName &p_name) const {
  1734. bool found;
  1735. int c = ClassDB::get_integer_constant(p_class, p_name, &found);
  1736. ERR_FAIL_COND_V(!found, 0);
  1737. return c;
  1738. }
  1739. StringName _ClassDB::get_category(const StringName &p_node) const {
  1740. return ClassDB::get_category(p_node);
  1741. }
  1742. bool _ClassDB::is_class_enabled(StringName p_class) const {
  1743. return ClassDB::is_class_enabled(p_class);
  1744. }
  1745. void _ClassDB::_bind_methods() {
  1746. ClassDB::bind_method(D_METHOD("get_class_list"), &_ClassDB::get_class_list);
  1747. ClassDB::bind_method(D_METHOD("get_inheriters_from_class", "class"), &_ClassDB::get_inheriters_from_class);
  1748. ClassDB::bind_method(D_METHOD("get_parent_class", "class"), &_ClassDB::get_parent_class);
  1749. ClassDB::bind_method(D_METHOD("class_exists", "class"), &_ClassDB::class_exists);
  1750. ClassDB::bind_method(D_METHOD("is_parent_class", "class", "inherits"), &_ClassDB::is_parent_class);
  1751. ClassDB::bind_method(D_METHOD("can_instance", "class"), &_ClassDB::can_instance);
  1752. ClassDB::bind_method(D_METHOD("instance", "class"), &_ClassDB::instance);
  1753. ClassDB::bind_method(D_METHOD("class_has_signal", "class", "signal"), &_ClassDB::has_signal);
  1754. ClassDB::bind_method(D_METHOD("class_get_signal", "class", "signal"), &_ClassDB::get_signal);
  1755. ClassDB::bind_method(D_METHOD("class_get_signal_list", "class", "no_inheritance"), &_ClassDB::get_signal_list, DEFVAL(false));
  1756. ClassDB::bind_method(D_METHOD("class_get_property_list", "class", "no_inheritance"), &_ClassDB::get_property_list, DEFVAL(false));
  1757. ClassDB::bind_method(D_METHOD("class_get_property", "object", "property"), &_ClassDB::get_property);
  1758. ClassDB::bind_method(D_METHOD("class_set_property", "object", "property", "value"), &_ClassDB::set_property);
  1759. ClassDB::bind_method(D_METHOD("class_has_method", "class", "method", "no_inheritance"), &_ClassDB::has_method, DEFVAL(false));
  1760. ClassDB::bind_method(D_METHOD("class_get_method_list", "class", "no_inheritance"), &_ClassDB::get_method_list, DEFVAL(false));
  1761. ClassDB::bind_method(D_METHOD("class_get_integer_constant_list", "class", "no_inheritance"), &_ClassDB::get_integer_constant_list, DEFVAL(false));
  1762. ClassDB::bind_method(D_METHOD("class_has_integer_constant", "class", "name"), &_ClassDB::has_integer_constant);
  1763. ClassDB::bind_method(D_METHOD("class_get_integer_constant", "class", "name"), &_ClassDB::get_integer_constant);
  1764. ClassDB::bind_method(D_METHOD("class_get_category", "class"), &_ClassDB::get_category);
  1765. ClassDB::bind_method(D_METHOD("is_class_enabled", "class"), &_ClassDB::is_class_enabled);
  1766. }
  1767. ////// _Engine //////
  1768. void _Engine::set_iterations_per_second(int p_ips) {
  1769. Engine::get_singleton()->set_iterations_per_second(p_ips);
  1770. }
  1771. int _Engine::get_iterations_per_second() const {
  1772. return Engine::get_singleton()->get_iterations_per_second();
  1773. }
  1774. void _Engine::set_physics_jitter_fix(float p_threshold) {
  1775. Engine::get_singleton()->set_physics_jitter_fix(p_threshold);
  1776. }
  1777. float _Engine::get_physics_jitter_fix() const {
  1778. return Engine::get_singleton()->get_physics_jitter_fix();
  1779. }
  1780. float _Engine::get_physics_interpolation_fraction() const {
  1781. return Engine::get_singleton()->get_physics_interpolation_fraction();
  1782. }
  1783. void _Engine::set_target_fps(int p_fps) {
  1784. Engine::get_singleton()->set_target_fps(p_fps);
  1785. }
  1786. int _Engine::get_target_fps() const {
  1787. return Engine::get_singleton()->get_target_fps();
  1788. }
  1789. float _Engine::get_frames_per_second() const {
  1790. return Engine::get_singleton()->get_frames_per_second();
  1791. }
  1792. uint64_t _Engine::get_physics_frames() const {
  1793. return Engine::get_singleton()->get_physics_frames();
  1794. }
  1795. uint64_t _Engine::get_process_frames() const {
  1796. return Engine::get_singleton()->get_process_frames();
  1797. }
  1798. void _Engine::set_time_scale(float p_scale) {
  1799. Engine::get_singleton()->set_time_scale(p_scale);
  1800. }
  1801. float _Engine::get_time_scale() {
  1802. return Engine::get_singleton()->get_time_scale();
  1803. }
  1804. int _Engine::get_frames_drawn() {
  1805. return Engine::get_singleton()->get_frames_drawn();
  1806. }
  1807. MainLoop *_Engine::get_main_loop() const {
  1808. //needs to remain in OS, since it's actually OS that interacts with it, but it's better exposed here
  1809. return OS::get_singleton()->get_main_loop();
  1810. }
  1811. Dictionary _Engine::get_version_info() const {
  1812. return Engine::get_singleton()->get_version_info();
  1813. }
  1814. Dictionary _Engine::get_author_info() const {
  1815. return Engine::get_singleton()->get_author_info();
  1816. }
  1817. Array _Engine::get_copyright_info() const {
  1818. return Engine::get_singleton()->get_copyright_info();
  1819. }
  1820. Dictionary _Engine::get_donor_info() const {
  1821. return Engine::get_singleton()->get_donor_info();
  1822. }
  1823. Dictionary _Engine::get_license_info() const {
  1824. return Engine::get_singleton()->get_license_info();
  1825. }
  1826. String _Engine::get_license_text() const {
  1827. return Engine::get_singleton()->get_license_text();
  1828. }
  1829. bool _Engine::is_in_physics_frame() const {
  1830. return Engine::get_singleton()->is_in_physics_frame();
  1831. }
  1832. bool _Engine::has_singleton(const String &p_name) const {
  1833. return Engine::get_singleton()->has_singleton(p_name);
  1834. }
  1835. Object *_Engine::get_singleton_object(const String &p_name) const {
  1836. return Engine::get_singleton()->get_singleton_object(p_name);
  1837. }
  1838. void _Engine::set_editor_hint(bool p_enabled) {
  1839. Engine::get_singleton()->set_editor_hint(p_enabled);
  1840. }
  1841. bool _Engine::is_editor_hint() const {
  1842. return Engine::get_singleton()->is_editor_hint();
  1843. }
  1844. void _Engine::_bind_methods() {
  1845. ClassDB::bind_method(D_METHOD("set_iterations_per_second", "iterations_per_second"), &_Engine::set_iterations_per_second);
  1846. ClassDB::bind_method(D_METHOD("get_iterations_per_second"), &_Engine::get_iterations_per_second);
  1847. ClassDB::bind_method(D_METHOD("set_physics_jitter_fix", "physics_jitter_fix"), &_Engine::set_physics_jitter_fix);
  1848. ClassDB::bind_method(D_METHOD("get_physics_jitter_fix"), &_Engine::get_physics_jitter_fix);
  1849. ClassDB::bind_method(D_METHOD("get_physics_interpolation_fraction"), &_Engine::get_physics_interpolation_fraction);
  1850. ClassDB::bind_method(D_METHOD("set_target_fps", "target_fps"), &_Engine::set_target_fps);
  1851. ClassDB::bind_method(D_METHOD("get_target_fps"), &_Engine::get_target_fps);
  1852. ClassDB::bind_method(D_METHOD("set_time_scale", "time_scale"), &_Engine::set_time_scale);
  1853. ClassDB::bind_method(D_METHOD("get_time_scale"), &_Engine::get_time_scale);
  1854. ClassDB::bind_method(D_METHOD("get_frames_drawn"), &_Engine::get_frames_drawn);
  1855. ClassDB::bind_method(D_METHOD("get_frames_per_second"), &_Engine::get_frames_per_second);
  1856. ClassDB::bind_method(D_METHOD("get_physics_frames"), &_Engine::get_physics_frames);
  1857. ClassDB::bind_method(D_METHOD("get_process_frames"), &_Engine::get_process_frames);
  1858. ClassDB::bind_method(D_METHOD("get_main_loop"), &_Engine::get_main_loop);
  1859. ClassDB::bind_method(D_METHOD("get_version_info"), &_Engine::get_version_info);
  1860. ClassDB::bind_method(D_METHOD("get_author_info"), &_Engine::get_author_info);
  1861. ClassDB::bind_method(D_METHOD("get_copyright_info"), &_Engine::get_copyright_info);
  1862. ClassDB::bind_method(D_METHOD("get_donor_info"), &_Engine::get_donor_info);
  1863. ClassDB::bind_method(D_METHOD("get_license_info"), &_Engine::get_license_info);
  1864. ClassDB::bind_method(D_METHOD("get_license_text"), &_Engine::get_license_text);
  1865. ClassDB::bind_method(D_METHOD("is_in_physics_frame"), &_Engine::is_in_physics_frame);
  1866. ClassDB::bind_method(D_METHOD("has_singleton", "name"), &_Engine::has_singleton);
  1867. ClassDB::bind_method(D_METHOD("get_singleton", "name"), &_Engine::get_singleton_object);
  1868. ClassDB::bind_method(D_METHOD("set_editor_hint", "enabled"), &_Engine::set_editor_hint);
  1869. ClassDB::bind_method(D_METHOD("is_editor_hint"), &_Engine::is_editor_hint);
  1870. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "editor_hint"), "set_editor_hint", "is_editor_hint");
  1871. ADD_PROPERTY(PropertyInfo(Variant::INT, "iterations_per_second"), "set_iterations_per_second", "get_iterations_per_second");
  1872. ADD_PROPERTY(PropertyInfo(Variant::INT, "target_fps"), "set_target_fps", "get_target_fps");
  1873. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "time_scale"), "set_time_scale", "get_time_scale");
  1874. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "physics_jitter_fix"), "set_physics_jitter_fix", "get_physics_jitter_fix");
  1875. }
  1876. _Engine *_Engine::singleton = nullptr;
  1877. ////// _JSON //////
  1878. void JSONParseResult::_bind_methods() {
  1879. ClassDB::bind_method(D_METHOD("get_error"), &JSONParseResult::get_error);
  1880. ClassDB::bind_method(D_METHOD("get_error_string"), &JSONParseResult::get_error_string);
  1881. ClassDB::bind_method(D_METHOD("get_error_line"), &JSONParseResult::get_error_line);
  1882. ClassDB::bind_method(D_METHOD("get_result"), &JSONParseResult::get_result);
  1883. ClassDB::bind_method(D_METHOD("set_error", "error"), &JSONParseResult::set_error);
  1884. ClassDB::bind_method(D_METHOD("set_error_string", "error_string"), &JSONParseResult::set_error_string);
  1885. ClassDB::bind_method(D_METHOD("set_error_line", "error_line"), &JSONParseResult::set_error_line);
  1886. ClassDB::bind_method(D_METHOD("set_result", "result"), &JSONParseResult::set_result);
  1887. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "error", PROPERTY_HINT_NONE, "Error", PROPERTY_USAGE_CLASS_IS_ENUM), "set_error", "get_error");
  1888. ADD_PROPERTY(PropertyInfo(Variant::STRING, "error_string"), "set_error_string", "get_error_string");
  1889. ADD_PROPERTY(PropertyInfo(Variant::INT, "error_line"), "set_error_line", "get_error_line");
  1890. ADD_PROPERTY(PropertyInfo(Variant::NIL, "result", PROPERTY_HINT_NONE, "", PROPERTY_USAGE_NIL_IS_VARIANT), "set_result", "get_result");
  1891. }
  1892. void JSONParseResult::set_error(Error p_error) {
  1893. error = p_error;
  1894. }
  1895. Error JSONParseResult::get_error() const {
  1896. return error;
  1897. }
  1898. void JSONParseResult::set_error_string(const String &p_error_string) {
  1899. error_string = p_error_string;
  1900. }
  1901. String JSONParseResult::get_error_string() const {
  1902. return error_string;
  1903. }
  1904. void JSONParseResult::set_error_line(int p_error_line) {
  1905. error_line = p_error_line;
  1906. }
  1907. int JSONParseResult::get_error_line() const {
  1908. return error_line;
  1909. }
  1910. void JSONParseResult::set_result(const Variant &p_result) {
  1911. result = p_result;
  1912. }
  1913. Variant JSONParseResult::get_result() const {
  1914. return result;
  1915. }
  1916. void _JSON::_bind_methods() {
  1917. ClassDB::bind_method(D_METHOD("print", "value", "indent", "sort_keys"), &_JSON::print, DEFVAL(String()), DEFVAL(false));
  1918. ClassDB::bind_method(D_METHOD("parse", "json"), &_JSON::parse);
  1919. }
  1920. String _JSON::print(const Variant &p_value, const String &p_indent, bool p_sort_keys) {
  1921. return JSON::print(p_value, p_indent, p_sort_keys);
  1922. }
  1923. Ref<JSONParseResult> _JSON::parse(const String &p_json) {
  1924. Ref<JSONParseResult> result;
  1925. result.instance();
  1926. result->error = JSON::parse(p_json, result->result, result->error_string, result->error_line);
  1927. if (result->error != OK) {
  1928. ERR_PRINT(vformat("Error parsing JSON at line %s: %s", result->error_line, result->error_string));
  1929. }
  1930. return result;
  1931. }
  1932. _JSON *_JSON::singleton = nullptr;
  1933. ////// _EngineDebugger //////
  1934. void _EngineDebugger::_bind_methods() {
  1935. ClassDB::bind_method(D_METHOD("is_active"), &_EngineDebugger::is_active);
  1936. ClassDB::bind_method(D_METHOD("register_profiler", "name", "toggle", "add", "tick"), &_EngineDebugger::register_profiler);
  1937. ClassDB::bind_method(D_METHOD("unregister_profiler", "name"), &_EngineDebugger::unregister_profiler);
  1938. ClassDB::bind_method(D_METHOD("is_profiling", "name"), &_EngineDebugger::is_profiling);
  1939. ClassDB::bind_method(D_METHOD("has_profiler", "name"), &_EngineDebugger::has_profiler);
  1940. ClassDB::bind_method(D_METHOD("profiler_add_frame_data", "name", "data"), &_EngineDebugger::profiler_add_frame_data);
  1941. ClassDB::bind_method(D_METHOD("profiler_enable", "name", "enable", "arguments"), &_EngineDebugger::profiler_enable, DEFVAL(Array()));
  1942. ClassDB::bind_method(D_METHOD("register_message_capture", "name", "callable"), &_EngineDebugger::register_message_capture);
  1943. ClassDB::bind_method(D_METHOD("unregister_message_capture", "name"), &_EngineDebugger::unregister_message_capture);
  1944. ClassDB::bind_method(D_METHOD("has_capture", "name"), &_EngineDebugger::has_capture);
  1945. ClassDB::bind_method(D_METHOD("send_message", "message", "data"), &_EngineDebugger::send_message);
  1946. }
  1947. bool _EngineDebugger::is_active() {
  1948. return EngineDebugger::is_active();
  1949. }
  1950. void _EngineDebugger::register_profiler(const StringName &p_name, const Callable &p_toggle, const Callable &p_add, const Callable &p_tick) {
  1951. ERR_FAIL_COND_MSG(profilers.has(p_name) || has_profiler(p_name), "Profiler already registered: " + p_name);
  1952. profilers.insert(p_name, ProfilerCallable(p_toggle, p_add, p_tick));
  1953. ProfilerCallable &p = profilers[p_name];
  1954. EngineDebugger::Profiler profiler(
  1955. &p,
  1956. &_EngineDebugger::call_toggle,
  1957. &_EngineDebugger::call_add,
  1958. &_EngineDebugger::call_tick);
  1959. EngineDebugger::register_profiler(p_name, profiler);
  1960. }
  1961. void _EngineDebugger::unregister_profiler(const StringName &p_name) {
  1962. ERR_FAIL_COND_MSG(!profilers.has(p_name), "Profiler not registered: " + p_name);
  1963. EngineDebugger::unregister_profiler(p_name);
  1964. profilers.erase(p_name);
  1965. }
  1966. bool _EngineDebugger::_EngineDebugger::is_profiling(const StringName &p_name) {
  1967. return EngineDebugger::is_profiling(p_name);
  1968. }
  1969. bool _EngineDebugger::has_profiler(const StringName &p_name) {
  1970. return EngineDebugger::has_profiler(p_name);
  1971. }
  1972. void _EngineDebugger::profiler_add_frame_data(const StringName &p_name, const Array &p_data) {
  1973. EngineDebugger::profiler_add_frame_data(p_name, p_data);
  1974. }
  1975. void _EngineDebugger::profiler_enable(const StringName &p_name, bool p_enabled, const Array &p_opts) {
  1976. if (EngineDebugger::get_singleton()) {
  1977. EngineDebugger::get_singleton()->profiler_enable(p_name, p_enabled, p_opts);
  1978. }
  1979. }
  1980. void _EngineDebugger::register_message_capture(const StringName &p_name, const Callable &p_callable) {
  1981. ERR_FAIL_COND_MSG(captures.has(p_name) || has_capture(p_name), "Capture already registered: " + p_name);
  1982. captures.insert(p_name, p_callable);
  1983. Callable &c = captures[p_name];
  1984. EngineDebugger::Capture capture(&c, &_EngineDebugger::call_capture);
  1985. EngineDebugger::register_message_capture(p_name, capture);
  1986. }
  1987. void _EngineDebugger::unregister_message_capture(const StringName &p_name) {
  1988. ERR_FAIL_COND_MSG(!captures.has(p_name), "Capture not registered: " + p_name);
  1989. EngineDebugger::unregister_message_capture(p_name);
  1990. captures.erase(p_name);
  1991. }
  1992. bool _EngineDebugger::has_capture(const StringName &p_name) {
  1993. return EngineDebugger::has_capture(p_name);
  1994. }
  1995. void _EngineDebugger::send_message(const String &p_msg, const Array &p_data) {
  1996. ERR_FAIL_COND_MSG(!EngineDebugger::is_active(), "Can't send message. No active debugger");
  1997. EngineDebugger::get_singleton()->send_message(p_msg, p_data);
  1998. }
  1999. void _EngineDebugger::call_toggle(void *p_user, bool p_enable, const Array &p_opts) {
  2000. Callable &toggle = ((ProfilerCallable *)p_user)->callable_toggle;
  2001. if (toggle.is_null()) {
  2002. return;
  2003. }
  2004. Variant enable = p_enable, opts = p_opts;
  2005. const Variant *args[2] = { &enable, &opts };
  2006. Variant retval;
  2007. Callable::CallError err;
  2008. toggle.call(args, 2, retval, err);
  2009. ERR_FAIL_COND_MSG(err.error != Callable::CallError::CALL_OK, "Error calling 'toggle' to callable: " + Variant::get_callable_error_text(toggle, args, 2, err));
  2010. }
  2011. void _EngineDebugger::call_add(void *p_user, const Array &p_data) {
  2012. Callable &add = ((ProfilerCallable *)p_user)->callable_add;
  2013. if (add.is_null()) {
  2014. return;
  2015. }
  2016. Variant data = p_data;
  2017. const Variant *args[1] = { &data };
  2018. Variant retval;
  2019. Callable::CallError err;
  2020. add.call(args, 1, retval, err);
  2021. ERR_FAIL_COND_MSG(err.error != Callable::CallError::CALL_OK, "Error calling 'add' to callable: " + Variant::get_callable_error_text(add, args, 1, err));
  2022. }
  2023. void _EngineDebugger::call_tick(void *p_user, float p_frame_time, float p_idle_time, float p_physics_time, float p_physics_frame_time) {
  2024. Callable &tick = ((ProfilerCallable *)p_user)->callable_tick;
  2025. if (tick.is_null()) {
  2026. return;
  2027. }
  2028. Variant frame_time = p_frame_time, idle_time = p_idle_time, physics_time = p_physics_time, physics_frame_time = p_physics_frame_time;
  2029. const Variant *args[4] = { &frame_time, &idle_time, &physics_time, &physics_frame_time };
  2030. Variant retval;
  2031. Callable::CallError err;
  2032. tick.call(args, 4, retval, err);
  2033. ERR_FAIL_COND_MSG(err.error != Callable::CallError::CALL_OK, "Error calling 'tick' to callable: " + Variant::get_callable_error_text(tick, args, 4, err));
  2034. }
  2035. Error _EngineDebugger::call_capture(void *p_user, const String &p_cmd, const Array &p_data, bool &r_captured) {
  2036. Callable &capture = *(Callable *)p_user;
  2037. if (capture.is_null()) {
  2038. return FAILED;
  2039. }
  2040. Variant cmd = p_cmd, data = p_data;
  2041. const Variant *args[2] = { &cmd, &data };
  2042. Variant retval;
  2043. Callable::CallError err;
  2044. capture.call(args, 2, retval, err);
  2045. ERR_FAIL_COND_V_MSG(err.error != Callable::CallError::CALL_OK, FAILED, "Error calling 'capture' to callable: " + Variant::get_callable_error_text(capture, args, 2, err));
  2046. ERR_FAIL_COND_V_MSG(retval.get_type() != Variant::BOOL, FAILED, "Error calling 'capture' to callable: " + String(capture) + ". Return type is not bool.");
  2047. r_captured = retval;
  2048. return OK;
  2049. }
  2050. _EngineDebugger::~_EngineDebugger() {
  2051. for (Map<StringName, Callable>::Element *E = captures.front(); E; E = E->next()) {
  2052. EngineDebugger::unregister_message_capture(E->key());
  2053. }
  2054. captures.clear();
  2055. for (Map<StringName, ProfilerCallable>::Element *E = profilers.front(); E; E = E->next()) {
  2056. EngineDebugger::unregister_profiler(E->key());
  2057. }
  2058. profilers.clear();
  2059. }
  2060. _EngineDebugger *_EngineDebugger::singleton = nullptr;