1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447 |
- /**************************************************************************/
- /* main.cpp */
- /**************************************************************************/
- /* This file is part of: */
- /* GODOT ENGINE */
- /* https://godotengine.org */
- /**************************************************************************/
- /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
- /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
- /* */
- /* Permission is hereby granted, free of charge, to any person obtaining */
- /* a copy of this software and associated documentation files (the */
- /* "Software"), to deal in the Software without restriction, including */
- /* without limitation the rights to use, copy, modify, merge, publish, */
- /* distribute, sublicense, and/or sell copies of the Software, and to */
- /* permit persons to whom the Software is furnished to do so, subject to */
- /* the following conditions: */
- /* */
- /* The above copyright notice and this permission notice shall be */
- /* included in all copies or substantial portions of the Software. */
- /* */
- /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
- /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
- /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
- /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
- /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
- /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
- /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
- /**************************************************************************/
- #include "main.h"
- #include "core/config/project_settings.h"
- #include "core/core_globals.h"
- #include "core/crypto/crypto.h"
- #include "core/debugger/engine_debugger.h"
- #include "core/extension/extension_api_dump.h"
- #include "core/extension/gdextension_interface_dump.gen.h"
- #include "core/extension/gdextension_manager.h"
- #include "core/input/input.h"
- #include "core/input/input_map.h"
- #include "core/io/dir_access.h"
- #include "core/io/file_access_pack.h"
- #include "core/io/file_access_zip.h"
- #include "core/io/image_loader.h"
- #include "core/io/ip.h"
- #include "core/io/resource_loader.h"
- #include "core/object/message_queue.h"
- #include "core/os/os.h"
- #include "core/os/time.h"
- #include "core/register_core_types.h"
- #include "core/string/translation.h"
- #include "core/version.h"
- #include "drivers/register_driver_types.h"
- #include "main/app_icon.gen.h"
- #include "main/main_timer_sync.h"
- #include "main/performance.h"
- #include "main/splash.gen.h"
- #include "modules/register_module_types.h"
- #include "platform/register_platform_apis.h"
- #include "scene/main/scene_tree.h"
- #include "scene/main/window.h"
- #include "scene/property_list_helper.h"
- #include "scene/register_scene_types.h"
- #include "scene/resources/packed_scene.h"
- #include "scene/theme/theme_db.h"
- #include "servers/audio_server.h"
- #include "servers/camera_server.h"
- #include "servers/display_server.h"
- #include "servers/movie_writer/movie_writer.h"
- #include "servers/movie_writer/movie_writer_mjpeg.h"
- #include "servers/navigation_server_3d.h"
- #include "servers/navigation_server_3d_dummy.h"
- #include "servers/register_server_types.h"
- #include "servers/rendering/rendering_server_default.h"
- #include "servers/text/text_server_dummy.h"
- #include "servers/text_server.h"
- // 2D
- #include "servers/navigation_server_2d.h"
- #include "servers/navigation_server_2d_dummy.h"
- #include "servers/physics_server_2d.h"
- #ifndef _3D_DISABLED
- #include "servers/physics_server_3d.h"
- #include "servers/xr_server.h"
- #endif // _3D_DISABLED
- #ifdef TESTS_ENABLED
- #include "tests/test_main.h"
- #endif
- #ifdef TOOLS_ENABLED
- #include "editor/debugger/debug_adapter/debug_adapter_server.h"
- #include "editor/debugger/editor_debugger_node.h"
- #include "editor/doc_data_class_path.gen.h"
- #include "editor/doc_tools.h"
- #include "editor/editor_file_system.h"
- #include "editor/editor_help.h"
- #include "editor/editor_node.h"
- #include "editor/editor_paths.h"
- #include "editor/editor_settings.h"
- #include "editor/editor_translation.h"
- #include "editor/progress_dialog.h"
- #include "editor/project_manager.h"
- #include "editor/register_editor_types.h"
- #if defined(TOOLS_ENABLED) && !defined(NO_EDITOR_SPLASH)
- #include "main/splash_editor.gen.h"
- #endif
- #ifndef DISABLE_DEPRECATED
- #include "editor/project_converter_3_to_4.h"
- #endif // DISABLE_DEPRECATED
- #endif // TOOLS_ENABLED
- #if defined(STEAMAPI_ENABLED)
- #include "main/steam_tracker.h"
- #endif
- #include "modules/modules_enabled.gen.h" // For mono.
- #if defined(MODULE_MONO_ENABLED) && defined(TOOLS_ENABLED)
- #include "modules/mono/editor/bindings_generator.h"
- #endif
- #ifdef MODULE_GDSCRIPT_ENABLED
- #include "modules/gdscript/gdscript.h"
- #if defined(TOOLS_ENABLED) && !defined(GDSCRIPT_NO_LSP)
- #include "modules/gdscript/language_server/gdscript_language_server.h"
- #endif // TOOLS_ENABLED && !GDSCRIPT_NO_LSP
- #endif // MODULE_GDSCRIPT_ENABLED
- /* Static members */
- // Singletons
- // Initialized in setup()
- static Engine *engine = nullptr;
- static ProjectSettings *globals = nullptr;
- static Input *input = nullptr;
- static InputMap *input_map = nullptr;
- static TranslationServer *translation_server = nullptr;
- static Performance *performance = nullptr;
- static PackedData *packed_data = nullptr;
- #ifdef MINIZIP_ENABLED
- static ZipArchive *zip_packed_data = nullptr;
- #endif
- static MessageQueue *message_queue = nullptr;
- #if defined(STEAMAPI_ENABLED)
- static SteamTracker *steam_tracker = nullptr;
- #endif
- // Initialized in setup2()
- static AudioServer *audio_server = nullptr;
- static CameraServer *camera_server = nullptr;
- static DisplayServer *display_server = nullptr;
- static RenderingServer *rendering_server = nullptr;
- static TextServerManager *tsman = nullptr;
- static ThemeDB *theme_db = nullptr;
- static NavigationServer2D *navigation_server_2d = nullptr;
- static PhysicsServer2DManager *physics_server_2d_manager = nullptr;
- static PhysicsServer2D *physics_server_2d = nullptr;
- static NavigationServer3D *navigation_server_3d = nullptr;
- #ifndef _3D_DISABLED
- static PhysicsServer3DManager *physics_server_3d_manager = nullptr;
- static PhysicsServer3D *physics_server_3d = nullptr;
- static XRServer *xr_server = nullptr;
- #endif // _3D_DISABLED
- // We error out if setup2() doesn't turn this true
- static bool _start_success = false;
- // Drivers
- String display_driver = "";
- String tablet_driver = "";
- String text_driver = "";
- String rendering_driver = "";
- String rendering_method = "";
- static int text_driver_idx = -1;
- static int audio_driver_idx = -1;
- // Engine config/tools
- static bool single_window = false;
- static bool editor = false;
- static bool project_manager = false;
- static bool cmdline_tool = false;
- static String locale;
- static String log_file;
- static bool show_help = false;
- static uint64_t quit_after = 0;
- static OS::ProcessID editor_pid = 0;
- #ifdef TOOLS_ENABLED
- static bool found_project = false;
- static bool auto_build_solutions = false;
- static String debug_server_uri;
- static bool wait_for_import = false;
- #ifndef DISABLE_DEPRECATED
- static int converter_max_kb_file = 4 * 1024; // 4MB
- static int converter_max_line_length = 100000;
- #endif // DISABLE_DEPRECATED
- HashMap<Main::CLIScope, Vector<String>> forwardable_cli_arguments;
- #endif
- static bool single_threaded_scene = false;
- // Display
- static DisplayServer::WindowMode window_mode = DisplayServer::WINDOW_MODE_WINDOWED;
- static DisplayServer::ScreenOrientation window_orientation = DisplayServer::SCREEN_LANDSCAPE;
- static DisplayServer::VSyncMode window_vsync_mode = DisplayServer::VSYNC_ENABLED;
- static uint32_t window_flags = 0;
- static Size2i window_size = Size2i(1152, 648);
- static int init_screen = DisplayServer::SCREEN_PRIMARY;
- static bool init_fullscreen = false;
- static bool init_maximized = false;
- static bool init_windowed = false;
- static bool init_always_on_top = false;
- static bool init_use_custom_pos = false;
- static bool init_use_custom_screen = false;
- static Vector2 init_custom_pos;
- // Debug
- static bool use_debug_profiler = false;
- #ifdef DEBUG_ENABLED
- static bool debug_collisions = false;
- static bool debug_paths = false;
- static bool debug_navigation = false;
- static bool debug_avoidance = false;
- static bool debug_canvas_item_redraw = false;
- #endif
- static int max_fps = -1;
- static int frame_delay = 0;
- static int audio_output_latency = 0;
- static bool disable_render_loop = false;
- static int fixed_fps = -1;
- static MovieWriter *movie_writer = nullptr;
- static bool disable_vsync = false;
- static bool print_fps = false;
- #ifdef TOOLS_ENABLED
- static bool dump_gdextension_interface = false;
- static bool dump_extension_api = false;
- static bool include_docs_in_extension_api_dump = false;
- static bool validate_extension_api = false;
- static String validate_extension_api_file;
- #endif
- bool profile_gpu = false;
- // Constants.
- static const String NULL_DISPLAY_DRIVER("headless");
- static const String NULL_AUDIO_DRIVER("Dummy");
- // The length of the longest column in the command-line help we should align to
- // (excluding the 2-space left and right margins).
- // Currently, this is `--export-release <preset> <path>`.
- static const int OPTION_COLUMN_LENGTH = 32;
- /* Helper methods */
- bool Main::is_cmdline_tool() {
- return cmdline_tool;
- }
- #ifdef TOOLS_ENABLED
- const Vector<String> &Main::get_forwardable_cli_arguments(Main::CLIScope p_scope) {
- return forwardable_cli_arguments[p_scope];
- }
- #endif
- static String unescape_cmdline(const String &p_str) {
- return p_str.replace("%20", " ");
- }
- static String get_full_version_string() {
- String hash = String(VERSION_HASH);
- if (!hash.is_empty()) {
- hash = "." + hash.left(9);
- }
- return String(VERSION_FULL_BUILD) + hash;
- }
- #if defined(TOOLS_ENABLED) && defined(MODULE_GDSCRIPT_ENABLED)
- static Vector<String> get_files_with_extension(const String &p_root, const String &p_extension) {
- Vector<String> paths;
- Ref<DirAccess> dir = DirAccess::open(p_root);
- if (dir.is_valid()) {
- dir->list_dir_begin();
- String fn = dir->get_next();
- while (!fn.is_empty()) {
- if (!dir->current_is_hidden() && fn != "." && fn != "..") {
- if (dir->current_is_dir()) {
- paths.append_array(get_files_with_extension(p_root.path_join(fn), p_extension));
- } else if (fn.get_extension() == p_extension) {
- paths.append(p_root.path_join(fn));
- }
- }
- fn = dir->get_next();
- }
- dir->list_dir_end();
- }
- return paths;
- }
- #endif
- // FIXME: Could maybe be moved to have less code in main.cpp.
- void initialize_physics() {
- #ifndef _3D_DISABLED
- /// 3D Physics Server
- physics_server_3d = PhysicsServer3DManager::get_singleton()->new_server(
- GLOBAL_GET(PhysicsServer3DManager::setting_property_name));
- if (!physics_server_3d) {
- // Physics server not found, Use the default physics
- physics_server_3d = PhysicsServer3DManager::get_singleton()->new_default_server();
- }
- ERR_FAIL_NULL(physics_server_3d);
- physics_server_3d->init();
- #endif // _3D_DISABLED
- // 2D Physics server
- physics_server_2d = PhysicsServer2DManager::get_singleton()->new_server(
- GLOBAL_GET(PhysicsServer2DManager::get_singleton()->setting_property_name));
- if (!physics_server_2d) {
- // Physics server not found, Use the default physics
- physics_server_2d = PhysicsServer2DManager::get_singleton()->new_default_server();
- }
- ERR_FAIL_NULL(physics_server_2d);
- physics_server_2d->init();
- }
- void finalize_physics() {
- #ifndef _3D_DISABLED
- physics_server_3d->finish();
- memdelete(physics_server_3d);
- #endif // _3D_DISABLED
- physics_server_2d->finish();
- memdelete(physics_server_2d);
- }
- void finalize_display() {
- rendering_server->finish();
- memdelete(rendering_server);
- memdelete(display_server);
- }
- void initialize_navigation_server() {
- ERR_FAIL_COND(navigation_server_3d != nullptr);
- ERR_FAIL_COND(navigation_server_2d != nullptr);
- // Init 3D Navigation Server
- navigation_server_3d = NavigationServer3DManager::new_default_server();
- // Fall back to dummy if no default server has been registered.
- if (!navigation_server_3d) {
- navigation_server_3d = memnew(NavigationServer3DDummy);
- }
- // Should be impossible, but make sure it's not null.
- ERR_FAIL_NULL_MSG(navigation_server_3d, "Failed to initialize NavigationServer3D.");
- navigation_server_3d->init();
- // Init 2D Navigation Server
- navigation_server_2d = NavigationServer2DManager::new_default_server();
- if (!navigation_server_2d) {
- navigation_server_2d = memnew(NavigationServer2DDummy);
- }
- ERR_FAIL_NULL_MSG(navigation_server_2d, "Failed to initialize NavigationServer2D.");
- navigation_server_2d->init();
- }
- void finalize_navigation_server() {
- ERR_FAIL_NULL(navigation_server_3d);
- navigation_server_3d->finish();
- memdelete(navigation_server_3d);
- navigation_server_3d = nullptr;
- ERR_FAIL_NULL(navigation_server_2d);
- navigation_server_2d->finish();
- memdelete(navigation_server_2d);
- navigation_server_2d = nullptr;
- }
- void initialize_theme_db() {
- theme_db = memnew(ThemeDB);
- }
- void finalize_theme_db() {
- memdelete(theme_db);
- theme_db = nullptr;
- }
- //#define DEBUG_INIT
- #ifdef DEBUG_INIT
- #define MAIN_PRINT(m_txt) print_line(m_txt)
- #else
- #define MAIN_PRINT(m_txt)
- #endif
- void Main::print_header(bool p_rich) {
- if (VERSION_TIMESTAMP > 0) {
- // Version timestamp available.
- if (p_rich) {
- Engine::get_singleton()->print_header_rich("\u001b[38;5;39m" + String(VERSION_NAME) + "\u001b[0m v" + get_full_version_string() + " (" + Time::get_singleton()->get_datetime_string_from_unix_time(VERSION_TIMESTAMP, true) + " UTC) - \u001b[4m" + String(VERSION_WEBSITE));
- } else {
- Engine::get_singleton()->print_header(String(VERSION_NAME) + " v" + get_full_version_string() + " (" + Time::get_singleton()->get_datetime_string_from_unix_time(VERSION_TIMESTAMP, true) + " UTC) - " + String(VERSION_WEBSITE));
- }
- } else {
- if (p_rich) {
- Engine::get_singleton()->print_header_rich("\u001b[38;5;39m" + String(VERSION_NAME) + "\u001b[0m v" + get_full_version_string() + " - \u001b[4m" + String(VERSION_WEBSITE));
- } else {
- Engine::get_singleton()->print_header(String(VERSION_NAME) + " v" + get_full_version_string() + " - " + String(VERSION_WEBSITE));
- }
- }
- }
- /**
- * Prints a copyright notice in the command-line help with colored text. A newline is
- * automatically added at the end.
- */
- void Main::print_help_copyright(const char *p_notice) {
- OS::get_singleton()->print("\u001b[90m%s\u001b[0m\n", p_notice);
- }
- /**
- * Prints a title in the command-line help with colored text. A newline is
- * automatically added at beginning and at the end.
- */
- void Main::print_help_title(const char *p_title) {
- OS::get_singleton()->print("\n\u001b[1;93m%s:\u001b[0m\n", p_title);
- }
- /**
- * Returns the option string with required and optional arguments colored separately from the rest of the option.
- * This color replacement must be done *after* calling `rpad()` for the length padding to be done correctly.
- */
- String Main::format_help_option(const char *p_option) {
- return (String(p_option)
- .rpad(OPTION_COLUMN_LENGTH)
- .replace("[", "\u001b[96m[")
- .replace("]", "]\u001b[0m")
- .replace("<", "\u001b[95m<")
- .replace(">", ">\u001b[0m"));
- }
- /**
- * Prints an option in the command-line help with colored text. No newline is
- * added at the end. `p_availability` denotes which build types the argument is
- * available in. Support in release export templates implies support in debug
- * export templates and editor. Support in debug export templates implies
- * support in editor.
- */
- void Main::print_help_option(const char *p_option, const char *p_description, CLIOptionAvailability p_availability) {
- const bool option_empty = (p_option && !p_option[0]);
- if (!option_empty) {
- const char *availability_badge = "";
- switch (p_availability) {
- case CLI_OPTION_AVAILABILITY_EDITOR:
- availability_badge = "\u001b[1;91mE";
- break;
- case CLI_OPTION_AVAILABILITY_TEMPLATE_DEBUG:
- availability_badge = "\u001b[1;94mD";
- break;
- case CLI_OPTION_AVAILABILITY_TEMPLATE_RELEASE:
- availability_badge = "\u001b[1;92mR";
- break;
- case CLI_OPTION_AVAILABILITY_HIDDEN:
- // Use for multiline option names (but not when the option name is empty).
- availability_badge = " ";
- break;
- }
- OS::get_singleton()->print(
- " \u001b[92m%s %s\u001b[0m %s",
- format_help_option(p_option).utf8().ptr(),
- availability_badge,
- p_description);
- } else {
- // Make continuation lines for descriptions faint if the option name is empty.
- OS::get_singleton()->print(
- " \u001b[92m%s \u001b[0m \u001b[90m%s",
- format_help_option(p_option).utf8().ptr(),
- p_description);
- }
- }
- void Main::print_help(const char *p_binary) {
- print_header(true);
- print_help_copyright("Free and open source software under the terms of the MIT license.");
- print_help_copyright("(c) 2014-present Godot Engine contributors. (c) 2007-present Juan Linietsky, Ariel Manzur.");
- print_help_title("Usage");
- OS::get_singleton()->print(" %s \u001b[96m[options] [path to scene or \"project.godot\" file]\u001b[0m\n", p_binary);
- #if defined(TOOLS_ENABLED)
- print_help_title("Option legend (this build = editor)");
- #elif defined(DEBUG_ENABLED)
- print_help_title("Option legend (this build = debug export template)");
- #else
- print_help_title("Option legend (this build = release export template)");
- #endif
- OS::get_singleton()->print(" \u001b[1;92mR\u001b[0m Available in editor builds, debug export templates and release export templates.\n");
- #ifdef DEBUG_ENABLED
- OS::get_singleton()->print(" \u001b[1;94mD\u001b[0m Available in editor builds and debug export templates only.\n");
- #endif
- #ifdef TOOLS_ENABLED
- OS::get_singleton()->print(" \u001b[1;91mE\u001b[0m Only available in editor builds.\n");
- #endif
- print_help_title("General options");
- print_help_option("-h, --help", "Display this help message.\n");
- print_help_option("--version", "Display the version string.\n");
- print_help_option("-v, --verbose", "Use verbose stdout mode.\n");
- print_help_option("--quiet", "Quiet mode, silences stdout messages. Errors are still displayed.\n");
- print_help_option("--no-header", "Do not print engine version and rendering method header on startup.\n");
- print_help_title("Run options");
- print_help_option("--, ++", "Separator for user-provided arguments. Following arguments are not used by the engine, but can be read from `OS.get_cmdline_user_args()`.\n");
- #ifdef TOOLS_ENABLED
- print_help_option("-e, --editor", "Start the editor instead of running the scene.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("-p, --project-manager", "Start the project manager, even if a project is auto-detected.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--debug-server <uri>", "Start the editor debug server (<protocol>://<host/IP>[:port], e.g. tcp://127.0.0.1:6007)\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--dap-port <port>", "Use the specified port for the GDScript Debugger Adaptor protocol. Recommended port range [1024, 49151].\n", CLI_OPTION_AVAILABILITY_EDITOR);
- #if defined(MODULE_GDSCRIPT_ENABLED) && !defined(GDSCRIPT_NO_LSP)
- print_help_option("--lsp-port <port>", "Use the specified port for the GDScript language server protocol. Recommended port range [1024, 49151].\n", CLI_OPTION_AVAILABILITY_EDITOR);
- #endif // MODULE_GDSCRIPT_ENABLED && !GDSCRIPT_NO_LSP
- #endif
- print_help_option("--quit", "Quit after the first iteration.\n");
- print_help_option("--quit-after <int>", "Quit after the given number of iterations. Set to 0 to disable.\n");
- print_help_option("-l, --language <locale>", "Use a specific locale (<locale> being a two-letter code).\n");
- print_help_option("--path <directory>", "Path to a project (<directory> must contain a \"project.godot\" file).\n");
- print_help_option("-u, --upwards", "Scan folders upwards for project.godot file.\n");
- print_help_option("--main-pack <file>", "Path to a pack (.pck) file to load.\n");
- print_help_option("--render-thread <mode>", "Render thread mode (\"unsafe\", \"safe\", \"separate\").\n");
- print_help_option("--remote-fs <address>", "Remote filesystem (<host/IP>[:<port>] address).\n");
- print_help_option("--remote-fs-password <password>", "Password for remote filesystem.\n");
- print_help_option("--audio-driver <driver>", "Audio driver [");
- for (int i = 0; i < AudioDriverManager::get_driver_count(); i++) {
- if (i > 0) {
- OS::get_singleton()->print(", ");
- }
- OS::get_singleton()->print("\"%s\"", AudioDriverManager::get_driver(i)->get_name());
- }
- OS::get_singleton()->print("].\n");
- print_help_option("--display-driver <driver>", "Display driver (and rendering driver) [");
- for (int i = 0; i < DisplayServer::get_create_function_count(); i++) {
- if (i > 0) {
- OS::get_singleton()->print(", ");
- }
- OS::get_singleton()->print("\"%s\" (", DisplayServer::get_create_function_name(i));
- Vector<String> rd = DisplayServer::get_create_function_rendering_drivers(i);
- for (int j = 0; j < rd.size(); j++) {
- if (j > 0) {
- OS::get_singleton()->print(", ");
- }
- OS::get_singleton()->print("\"%s\"", rd[j].utf8().get_data());
- }
- OS::get_singleton()->print(")");
- }
- OS::get_singleton()->print("].\n");
- print_help_option("--audio-output-latency <ms>", "Override audio output latency in milliseconds (default is 15 ms).\n");
- print_help_option("", "Lower values make sound playback more reactive but increase CPU usage, and may result in audio cracking if the CPU can't keep up.\n");
- print_help_option("--rendering-method <renderer>", "Renderer name. Requires driver support.\n");
- print_help_option("--rendering-driver <driver>", "Rendering driver (depends on display driver).\n");
- print_help_option("--gpu-index <device_index>", "Use a specific GPU (run with --verbose to get a list of available devices).\n");
- print_help_option("--text-driver <driver>", "Text driver (used for font rendering, bidirectional support and shaping).\n");
- print_help_option("--tablet-driver <driver>", "Pen tablet input driver.\n");
- print_help_option("--headless", "Enable headless mode (--display-driver headless --audio-driver Dummy). Useful for servers and with --script.\n");
- print_help_option("--log-file <file>", "Write output/error log to the specified path instead of the default location defined by the project.\n");
- print_help_option("", "<file> path should be absolute or relative to the project directory.\n");
- print_help_option("--write-movie <file>", "Write a video to the specified path (usually with .avi or .png extension).\n");
- print_help_option("", "--fixed-fps is forced when enabled, but it can be used to change movie FPS.\n");
- print_help_option("", "--disable-vsync can speed up movie writing but makes interaction more difficult.\n");
- print_help_option("", "--quit-after can be used to specify the number of frames to write.\n");
- print_help_title("Display options");
- print_help_option("-f, --fullscreen", "Request fullscreen mode.\n");
- print_help_option("-m, --maximized", "Request a maximized window.\n");
- print_help_option("-w, --windowed", "Request windowed mode.\n");
- print_help_option("-t, --always-on-top", "Request an always-on-top window.\n");
- print_help_option("--resolution <W>x<H>", "Request window resolution.\n");
- print_help_option("--position <X>,<Y>", "Request window position.\n");
- print_help_option("--screen <N>", "Request window screen.\n");
- print_help_option("--single-window", "Use a single window (no separate subwindows).\n");
- print_help_option("--xr-mode <mode>", "Select XR (Extended Reality) mode [\"default\", \"off\", \"on\"].\n");
- print_help_title("Debug options");
- print_help_option("-d, --debug", "Debug (local stdout debugger).\n");
- print_help_option("-b, --breakpoints", "Breakpoint list as source::line comma-separated pairs, no spaces (use %%20 instead).\n");
- print_help_option("--profiling", "Enable profiling in the script debugger.\n");
- print_help_option("--gpu-profile", "Show a GPU profile of the tasks that took the most time during frame rendering.\n");
- print_help_option("--gpu-validation", "Enable graphics API validation layers for debugging.\n");
- #ifdef DEBUG_ENABLED
- print_help_option("--gpu-abort", "Abort on graphics API usage errors (usually validation layer errors). May help see the problem if your system freezes.\n", CLI_OPTION_AVAILABILITY_TEMPLATE_DEBUG);
- #endif
- print_help_option("--generate-spirv-debug-info", "Generate SPIR-V debug information. This allows source-level shader debugging with RenderDoc.\n");
- print_help_option("--remote-debug <uri>", "Remote debug (<protocol>://<host/IP>[:<port>], e.g. tcp://127.0.0.1:6007).\n");
- print_help_option("--single-threaded-scene", "Force scene tree to run in single-threaded mode. Sub-thread groups are disabled and run on the main thread.\n");
- #if defined(DEBUG_ENABLED)
- print_help_option("--debug-collisions", "Show collision shapes when running the scene.\n", CLI_OPTION_AVAILABILITY_TEMPLATE_DEBUG);
- print_help_option("--debug-paths", "Show path lines when running the scene.\n", CLI_OPTION_AVAILABILITY_TEMPLATE_DEBUG);
- print_help_option("--debug-navigation", "Show navigation polygons when running the scene.\n", CLI_OPTION_AVAILABILITY_TEMPLATE_DEBUG);
- print_help_option("--debug-avoidance", "Show navigation avoidance debug visuals when running the scene.\n", CLI_OPTION_AVAILABILITY_TEMPLATE_DEBUG);
- print_help_option("--debug-stringnames", "Print all StringName allocations to stdout when the engine quits.\n", CLI_OPTION_AVAILABILITY_TEMPLATE_DEBUG);
- print_help_option("--debug-canvas-item-redraw", "Display a rectangle each time a canvas item requests a redraw (useful to troubleshoot low processor mode).\n", CLI_OPTION_AVAILABILITY_TEMPLATE_DEBUG);
- #endif
- print_help_option("--max-fps <fps>", "Set a maximum number of frames per second rendered (can be used to limit power usage). A value of 0 results in unlimited framerate.\n");
- print_help_option("--frame-delay <ms>", "Simulate high CPU load (delay each frame by <ms> milliseconds). Do not use as a FPS limiter; use --max-fps instead.\n");
- print_help_option("--time-scale <scale>", "Force time scale (higher values are faster, 1.0 is normal speed).\n");
- print_help_option("--disable-vsync", "Forces disabling of vertical synchronization, even if enabled in the project settings. Does not override driver-level V-Sync enforcement.\n");
- print_help_option("--disable-render-loop", "Disable render loop so rendering only occurs when called explicitly from script.\n");
- print_help_option("--disable-crash-handler", "Disable crash handler when supported by the platform code.\n");
- print_help_option("--fixed-fps <fps>", "Force a fixed number of frames per second. This setting disables real-time synchronization.\n");
- print_help_option("--delta-smoothing <enable>", "Enable or disable frame delta smoothing [\"enable\", \"disable\"].\n");
- print_help_option("--print-fps", "Print the frames per second to the stdout.\n");
- print_help_title("Standalone tools");
- print_help_option("-s, --script <script>", "Run a script.\n");
- print_help_option("--main-loop <main_loop_name>", "Run a MainLoop specified by its global class name.\n");
- print_help_option("--check-only", "Only parse for errors and quit (use with --script).\n");
- #ifdef TOOLS_ENABLED
- print_help_option("--import", "Starts the editor, waits for any resources to be imported, and then quits.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--export-release <preset> <path>", "Export the project in release mode using the given preset and output path. The preset name should match one defined in \"export_presets.cfg\".\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("", "<path> should be absolute or relative to the project directory, and include the filename for the binary (e.g. \"builds/game.exe\").\n");
- print_help_option("", "The target directory must exist.\n");
- print_help_option("--export-debug <preset> <path>", "Export the project in debug mode using the given preset and output path. See --export-release description for other considerations.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--export-pack <preset> <path>", "Export the project data only using the given preset and output path. The <path> extension determines whether it will be in PCK or ZIP format.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--install-android-build-template", "Install the Android build template. Used in conjunction with --export-release or --export-debug.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- #ifndef DISABLE_DEPRECATED
- // Commands are long; split the description to a second line.
- print_help_option("--convert-3to4 ", "\n", CLI_OPTION_AVAILABILITY_HIDDEN);
- print_help_option(" [max_file_kb] [max_line_size]", "Converts project from Godot 3.x to Godot 4.x.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--validate-conversion-3to4 ", "\n", CLI_OPTION_AVAILABILITY_HIDDEN);
- print_help_option(" [max_file_kb] [max_line_size]", "Shows what elements will be renamed when converting project from Godot 3.x to Godot 4.x.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- #endif // DISABLE_DEPRECATED
- print_help_option("--doctool [path]", "Dump the engine API reference to the given <path> (defaults to current directory) in XML format, merging if existing files are found.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--no-docbase", "Disallow dumping the base types (used with --doctool).\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--gdextension-docs", "Rather than dumping the engine API, generate API reference from all the GDExtensions loaded in the current project (used with --doctool).\n", CLI_OPTION_AVAILABILITY_EDITOR);
- #ifdef MODULE_GDSCRIPT_ENABLED
- print_help_option("--gdscript-docs <path>", "Rather than dumping the engine API, generate API reference from the inline documentation in the GDScript files found in <path> (used with --doctool).\n", CLI_OPTION_AVAILABILITY_EDITOR);
- #endif
- print_help_option("--build-solutions", "Build the scripting solutions (e.g. for C# projects). Implies --editor and requires a valid project to edit.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--dump-gdextension-interface", "Generate a GDExtension header file \"gdextension_interface.h\" in the current folder. This file is the base file required to implement a GDExtension.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--dump-extension-api", "Generate a JSON dump of the Godot API for GDExtension bindings named \"extension_api.json\" in the current folder.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--dump-extension-api-with-docs", "Generate JSON dump of the Godot API like the previous option, but including documentation.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--validate-extension-api <path>", "Validate an extension API file dumped (with one of the two previous options) from a previous version of the engine to ensure API compatibility.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("", "If incompatibilities or errors are detected, the exit code will be non-zero.\n");
- print_help_option("--benchmark", "Benchmark the run time and print it to console.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- print_help_option("--benchmark-file <path>", "Benchmark the run time and save it to a given file in JSON format. The path should be absolute.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- #ifdef TESTS_ENABLED
- print_help_option("--test [--help]", "Run unit tests. Use --test --help for more information.\n", CLI_OPTION_AVAILABILITY_EDITOR);
- #endif
- #endif
- OS::get_singleton()->print("\n");
- }
- #ifdef TESTS_ENABLED
- // The order is the same as in `Main::setup()`, only core and some editor types
- // are initialized here. This also combines `Main::setup2()` initialization.
- Error Main::test_setup() {
- Thread::make_main_thread();
- set_current_thread_safe_for_nodes(true);
- OS::get_singleton()->initialize();
- engine = memnew(Engine);
- register_core_types();
- register_core_driver_types();
- packed_data = memnew(PackedData);
- globals = memnew(ProjectSettings);
- register_core_settings(); // Here globals are present.
- translation_server = memnew(TranslationServer);
- tsman = memnew(TextServerManager);
- if (tsman) {
- Ref<TextServerDummy> ts;
- ts.instantiate();
- tsman->add_interface(ts);
- }
- #ifndef _3D_DISABLED
- physics_server_3d_manager = memnew(PhysicsServer3DManager);
- #endif // _3D_DISABLED
- physics_server_2d_manager = memnew(PhysicsServer2DManager);
- // From `Main::setup2()`.
- initialize_modules(MODULE_INITIALIZATION_LEVEL_CORE);
- register_core_extensions();
- register_core_singletons();
- /** INITIALIZE SERVERS **/
- register_server_types();
- #ifndef _3D_DISABLED
- XRServer::set_xr_mode(XRServer::XRMODE_OFF); // Skip in tests.
- #endif // _3D_DISABLED
- initialize_modules(MODULE_INITIALIZATION_LEVEL_SERVERS);
- GDExtensionManager::get_singleton()->initialize_extensions(GDExtension::INITIALIZATION_LEVEL_SERVERS);
- translation_server->setup(); //register translations, load them, etc.
- if (!locale.is_empty()) {
- translation_server->set_locale(locale);
- }
- translation_server->load_translations();
- ResourceLoader::load_translation_remaps(); //load remaps for resources
- ResourceLoader::load_path_remaps();
- // Initialize ThemeDB early so that scene types can register their theme items.
- // Default theme will be initialized later, after modules and ScriptServer are ready.
- initialize_theme_db();
- register_scene_types();
- register_driver_types();
- register_scene_singletons();
- initialize_modules(MODULE_INITIALIZATION_LEVEL_SCENE);
- GDExtensionManager::get_singleton()->initialize_extensions(GDExtension::INITIALIZATION_LEVEL_SCENE);
- #ifdef TOOLS_ENABLED
- ClassDB::set_current_api(ClassDB::API_EDITOR);
- register_editor_types();
- initialize_modules(MODULE_INITIALIZATION_LEVEL_EDITOR);
- GDExtensionManager::get_singleton()->initialize_extensions(GDExtension::INITIALIZATION_LEVEL_EDITOR);
- ClassDB::set_current_api(ClassDB::API_CORE);
- #endif
- register_platform_apis();
- // Theme needs modules to be initialized so that sub-resources can be loaded.
- theme_db->initialize_theme_noproject();
- initialize_navigation_server();
- ERR_FAIL_COND_V(TextServerManager::get_singleton()->get_interface_count() == 0, ERR_CANT_CREATE);
- /* Use one with the most features available. */
- int max_features = 0;
- for (int i = 0; i < TextServerManager::get_singleton()->get_interface_count(); i++) {
- uint32_t features = TextServerManager::get_singleton()->get_interface(i)->get_features();
- int feature_number = 0;
- while (features) {
- feature_number += features & 1;
- features >>= 1;
- }
- if (feature_number >= max_features) {
- max_features = feature_number;
- text_driver_idx = i;
- }
- }
- if (text_driver_idx >= 0) {
- Ref<TextServer> ts = TextServerManager::get_singleton()->get_interface(text_driver_idx);
- TextServerManager::get_singleton()->set_primary_interface(ts);
- if (ts->has_feature(TextServer::FEATURE_USE_SUPPORT_DATA)) {
- ts->load_support_data("res://" + ts->get_support_data_filename());
- }
- } else {
- ERR_FAIL_V_MSG(ERR_CANT_CREATE, "TextServer: Unable to create TextServer interface.");
- }
- ClassDB::set_current_api(ClassDB::API_NONE);
- _start_success = true;
- return OK;
- }
- // The order is the same as in `Main::cleanup()`.
- void Main::test_cleanup() {
- ERR_FAIL_COND(!_start_success);
- for (int i = 0; i < TextServerManager::get_singleton()->get_interface_count(); i++) {
- TextServerManager::get_singleton()->get_interface(i)->cleanup();
- }
- ResourceLoader::remove_custom_loaders();
- ResourceSaver::remove_custom_savers();
- PropertyListHelper::clear_base_helpers();
- #ifdef TOOLS_ENABLED
- GDExtensionManager::get_singleton()->deinitialize_extensions(GDExtension::INITIALIZATION_LEVEL_EDITOR);
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_EDITOR);
- unregister_editor_types();
- #endif
- GDExtensionManager::get_singleton()->deinitialize_extensions(GDExtension::INITIALIZATION_LEVEL_SCENE);
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_SCENE);
- unregister_platform_apis();
- unregister_driver_types();
- unregister_scene_types();
- finalize_theme_db();
- finalize_navigation_server();
- GDExtensionManager::get_singleton()->deinitialize_extensions(GDExtension::INITIALIZATION_LEVEL_SERVERS);
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_SERVERS);
- unregister_server_types();
- EngineDebugger::deinitialize();
- OS::get_singleton()->finalize();
- if (packed_data) {
- memdelete(packed_data);
- }
- if (translation_server) {
- memdelete(translation_server);
- }
- if (tsman) {
- memdelete(tsman);
- }
- #ifndef _3D_DISABLED
- if (physics_server_3d_manager) {
- memdelete(physics_server_3d_manager);
- }
- #endif // _3D_DISABLED
- if (physics_server_2d_manager) {
- memdelete(physics_server_2d_manager);
- }
- if (globals) {
- memdelete(globals);
- }
- unregister_core_driver_types();
- unregister_core_extensions();
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_CORE);
- if (engine) {
- memdelete(engine);
- }
- unregister_core_types();
- OS::get_singleton()->finalize_core();
- }
- #endif
- int Main::test_entrypoint(int argc, char *argv[], bool &tests_need_run) {
- for (int x = 0; x < argc; x++) {
- if ((strncmp(argv[x], "--test", 6) == 0) && (strlen(argv[x]) == 6)) {
- tests_need_run = true;
- #ifdef TESTS_ENABLED
- // TODO: need to come up with different test contexts.
- // Not every test requires high-level functionality like `ClassDB`.
- test_setup();
- int status = test_main(argc, argv);
- test_cleanup();
- return status;
- #else
- ERR_PRINT(
- "`--test` was specified on the command line, but this Godot binary was compiled without support for unit tests. Aborting.\n"
- "To be able to run unit tests, use the `tests=yes` SCons option when compiling Godot.\n");
- return EXIT_FAILURE;
- #endif
- }
- }
- tests_need_run = false;
- return EXIT_SUCCESS;
- }
- /* Engine initialization
- *
- * Consists of several methods that are called by each platform's specific main(argc, argv).
- * To fully understand engine init, one should therefore start from the platform's main and
- * see how it calls into the Main class' methods.
- *
- * The initialization is typically done in 3 steps (with the setup2 step triggered either
- * automatically by setup, or manually in the platform's main).
- *
- * - setup(execpath, argc, argv, p_second_phase) is the main entry point for all platforms,
- * responsible for the initialization of all low level singletons and core types, and parsing
- * command line arguments to configure things accordingly.
- * If p_second_phase is true, it will chain into setup2() (default behavior). This is
- * disabled on some platforms (Android, iOS) which trigger the second step in their own time.
- *
- * - setup2(p_main_tid_override) registers high level servers and singletons, displays the
- * boot splash, then registers higher level types (scene, editor, etc.).
- *
- * - start() is the last step and that's where command line tools can run, or the main loop
- * can be created eventually and the project settings put into action. That's also where
- * the editor node is created, if relevant.
- * start() does it own argument parsing for a subset of the command line arguments described
- * in help, it's a bit messy and should be globalized with the setup() parsing somehow.
- */
- Error Main::setup(const char *execpath, int argc, char *argv[], bool p_second_phase) {
- Thread::make_main_thread();
- set_current_thread_safe_for_nodes(true);
- OS::get_singleton()->initialize();
- // Benchmark tracking must be done after `OS::get_singleton()->initialize()` as on some
- // platforms, it's used to set up the time utilities.
- OS::get_singleton()->benchmark_begin_measure("Startup", "Main::Setup");
- engine = memnew(Engine);
- MAIN_PRINT("Main: Initialize CORE");
- register_core_types();
- register_core_driver_types();
- MAIN_PRINT("Main: Initialize Globals");
- input_map = memnew(InputMap);
- globals = memnew(ProjectSettings);
- register_core_settings(); //here globals are present
- translation_server = memnew(TranslationServer);
- performance = memnew(Performance);
- GDREGISTER_CLASS(Performance);
- engine->add_singleton(Engine::Singleton("Performance", performance));
- // Only flush stdout in debug builds by default, as spamming `print()` will
- // decrease performance if this is enabled.
- GLOBAL_DEF_RST("application/run/flush_stdout_on_print", false);
- GLOBAL_DEF_RST("application/run/flush_stdout_on_print.debug", true);
- MAIN_PRINT("Main: Parse CMDLine");
- /* argument parsing and main creation */
- List<String> args;
- List<String> main_args;
- List<String> user_args;
- bool adding_user_args = false;
- List<String> platform_args = OS::get_singleton()->get_cmdline_platform_args();
- // Add command line arguments.
- for (int i = 0; i < argc; i++) {
- args.push_back(String::utf8(argv[i]));
- }
- // Add arguments received from macOS LaunchService (URL schemas, file associations).
- for (const String &arg : platform_args) {
- args.push_back(arg);
- }
- List<String>::Element *I = args.front();
- while (I) {
- I->get() = unescape_cmdline(I->get().strip_edges());
- I = I->next();
- }
- String audio_driver = "";
- String project_path = ".";
- bool upwards = false;
- String debug_uri = "";
- bool skip_breakpoints = false;
- String main_pack;
- bool quiet_stdout = false;
- int rtm = -1;
- String remotefs;
- String remotefs_pass;
- Vector<String> breakpoints;
- bool use_custom_res = true;
- bool force_res = false;
- bool delta_smoothing_override = false;
- String default_renderer = "";
- String default_renderer_mobile = "";
- String renderer_hints = "";
- packed_data = PackedData::get_singleton();
- if (!packed_data) {
- packed_data = memnew(PackedData);
- }
- #ifdef MINIZIP_ENABLED
- //XXX: always get_singleton() == 0x0
- zip_packed_data = ZipArchive::get_singleton();
- //TODO: remove this temporary fix
- if (!zip_packed_data) {
- zip_packed_data = memnew(ZipArchive);
- }
- packed_data->add_pack_source(zip_packed_data);
- #endif
- // Exit error code used in the `goto error` conditions.
- // It's returned as the program exit code. ERR_HELP is special cased and handled as success (0).
- Error exit_err = ERR_INVALID_PARAMETER;
- I = args.front();
- while (I) {
- List<String>::Element *N = I->next();
- const String &arg = I->get();
- #ifdef MACOS_ENABLED
- // Ignore the process serial number argument passed by macOS Gatekeeper.
- // Otherwise, Godot would try to open a non-existent project on the first start and abort.
- if (arg.begins_with("-psn_")) {
- I = N;
- continue;
- }
- #endif
- #ifdef TOOLS_ENABLED
- if (arg == "--debug" ||
- arg == "--verbose" ||
- arg == "--disable-crash-handler") {
- forwardable_cli_arguments[CLI_SCOPE_TOOL].push_back(arg);
- forwardable_cli_arguments[CLI_SCOPE_PROJECT].push_back(arg);
- }
- if (arg == "--single-window") {
- forwardable_cli_arguments[CLI_SCOPE_TOOL].push_back(arg);
- }
- if (arg == "--audio-driver" ||
- arg == "--display-driver" ||
- arg == "--rendering-method" ||
- arg == "--rendering-driver") {
- if (N) {
- forwardable_cli_arguments[CLI_SCOPE_TOOL].push_back(arg);
- forwardable_cli_arguments[CLI_SCOPE_TOOL].push_back(N->get());
- }
- }
- // If gpu is specified, both editor and debug instances started from editor will inherit.
- if (arg == "--gpu-index") {
- if (N) {
- const String &next_arg = N->get();
- forwardable_cli_arguments[CLI_SCOPE_TOOL].push_back(arg);
- forwardable_cli_arguments[CLI_SCOPE_TOOL].push_back(next_arg);
- forwardable_cli_arguments[CLI_SCOPE_PROJECT].push_back(arg);
- forwardable_cli_arguments[CLI_SCOPE_PROJECT].push_back(next_arg);
- }
- }
- #endif
- if (adding_user_args) {
- user_args.push_back(arg);
- } else if (arg == "-h" || arg == "--help" || arg == "/?") { // display help
- show_help = true;
- exit_err = ERR_HELP; // Hack to force an early exit in `main()` with a success code.
- goto error;
- } else if (arg == "--version") {
- print_line(get_full_version_string());
- exit_err = ERR_HELP; // Hack to force an early exit in `main()` with a success code.
- goto error;
- } else if (arg == "-v" || arg == "--verbose") { // verbose output
- OS::get_singleton()->_verbose_stdout = true;
- } else if (arg == "-q" || arg == "--quiet") { // quieter output
- quiet_stdout = true;
- } else if (arg == "--no-header") {
- Engine::get_singleton()->_print_header = false;
- } else if (arg == "--audio-driver") { // audio driver
- if (N) {
- audio_driver = N->get();
- bool found = false;
- for (int i = 0; i < AudioDriverManager::get_driver_count(); i++) {
- if (audio_driver == AudioDriverManager::get_driver(i)->get_name()) {
- found = true;
- }
- }
- if (!found) {
- OS::get_singleton()->print("Unknown audio driver '%s', aborting.\nValid options are ",
- audio_driver.utf8().get_data());
- for (int i = 0; i < AudioDriverManager::get_driver_count(); i++) {
- if (i == AudioDriverManager::get_driver_count() - 1) {
- OS::get_singleton()->print(" and ");
- } else if (i != 0) {
- OS::get_singleton()->print(", ");
- }
- OS::get_singleton()->print("'%s'", AudioDriverManager::get_driver(i)->get_name());
- }
- OS::get_singleton()->print(".\n");
- goto error;
- }
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing audio driver argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--audio-output-latency") {
- if (N) {
- audio_output_latency = N->get().to_int();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing audio output latency argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--text-driver") {
- if (N) {
- text_driver = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing text driver argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--display-driver") { // force video driver
- if (N) {
- display_driver = N->get();
- bool found = false;
- for (int i = 0; i < DisplayServer::get_create_function_count(); i++) {
- if (display_driver == DisplayServer::get_create_function_name(i)) {
- found = true;
- }
- }
- if (!found) {
- OS::get_singleton()->print("Unknown display driver '%s', aborting.\nValid options are ",
- display_driver.utf8().get_data());
- for (int i = 0; i < DisplayServer::get_create_function_count(); i++) {
- if (i == DisplayServer::get_create_function_count() - 1) {
- OS::get_singleton()->print(" and ");
- } else if (i != 0) {
- OS::get_singleton()->print(", ");
- }
- OS::get_singleton()->print("'%s'", DisplayServer::get_create_function_name(i));
- }
- OS::get_singleton()->print(".\n");
- goto error;
- }
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing display driver argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--rendering-method") {
- if (N) {
- rendering_method = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing renderer name argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--rendering-driver") {
- if (N) {
- rendering_driver = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing rendering driver argument, aborting.\n");
- goto error;
- }
- } else if (arg == "-f" || arg == "--fullscreen") { // force fullscreen
- init_fullscreen = true;
- window_mode = DisplayServer::WINDOW_MODE_FULLSCREEN;
- } else if (arg == "-m" || arg == "--maximized") { // force maximized window
- init_maximized = true;
- window_mode = DisplayServer::WINDOW_MODE_MAXIMIZED;
- } else if (arg == "-w" || arg == "--windowed") { // force windowed window
- init_windowed = true;
- } else if (arg == "--gpu-index") {
- if (N) {
- Engine::singleton->gpu_idx = N->get().to_int();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing GPU index argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--gpu-validation") {
- Engine::singleton->use_validation_layers = true;
- #ifdef DEBUG_ENABLED
- } else if (arg == "--gpu-abort") {
- Engine::singleton->abort_on_gpu_errors = true;
- #endif
- } else if (arg == "--generate-spirv-debug-info") {
- Engine::singleton->generate_spirv_debug_info = true;
- } else if (arg == "--tablet-driver") {
- if (N) {
- tablet_driver = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing tablet driver argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--delta-smoothing") {
- if (N) {
- String string = N->get();
- bool recognized = false;
- if (string == "enable") {
- OS::get_singleton()->set_delta_smoothing(true);
- delta_smoothing_override = true;
- recognized = true;
- }
- if (string == "disable") {
- OS::get_singleton()->set_delta_smoothing(false);
- delta_smoothing_override = false;
- recognized = true;
- }
- if (!recognized) {
- OS::get_singleton()->print("Delta-smoothing argument not recognized, aborting.\n");
- goto error;
- }
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing delta-smoothing argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--single-window") { // force single window
- single_window = true;
- } else if (arg == "-t" || arg == "--always-on-top") { // force always-on-top window
- init_always_on_top = true;
- } else if (arg == "--resolution") { // force resolution
- if (N) {
- String vm = N->get();
- if (!vm.contains("x")) { // invalid parameter format
- OS::get_singleton()->print("Invalid resolution '%s', it should be e.g. '1280x720'.\n",
- vm.utf8().get_data());
- goto error;
- }
- int w = vm.get_slice("x", 0).to_int();
- int h = vm.get_slice("x", 1).to_int();
- if (w <= 0 || h <= 0) {
- OS::get_singleton()->print("Invalid resolution '%s', width and height must be above 0.\n",
- vm.utf8().get_data());
- goto error;
- }
- window_size.width = w;
- window_size.height = h;
- force_res = true;
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing resolution argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--screen") { // set window screen
- if (N) {
- init_screen = N->get().to_int();
- init_use_custom_screen = true;
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing screen argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--position") { // set window position
- if (N) {
- String vm = N->get();
- if (!vm.contains(",")) { // invalid parameter format
- OS::get_singleton()->print("Invalid position '%s', it should be e.g. '80,128'.\n",
- vm.utf8().get_data());
- goto error;
- }
- int x = vm.get_slice(",", 0).to_int();
- int y = vm.get_slice(",", 1).to_int();
- init_custom_pos = Point2(x, y);
- init_use_custom_pos = true;
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing position argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--headless") { // enable headless mode (no audio, no rendering).
- audio_driver = NULL_AUDIO_DRIVER;
- display_driver = NULL_DISPLAY_DRIVER;
- } else if (arg == "--log-file") { // write to log file
- if (N) {
- log_file = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing log file path argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--profiling") { // enable profiling
- use_debug_profiler = true;
- } else if (arg == "-l" || arg == "--language") { // language
- if (N) {
- locale = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing language argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--remote-fs") { // remote filesystem
- if (N) {
- remotefs = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing remote filesystem address, aborting.\n");
- goto error;
- }
- } else if (arg == "--remote-fs-password") { // remote filesystem password
- if (N) {
- remotefs_pass = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing remote filesystem password, aborting.\n");
- goto error;
- }
- } else if (arg == "--render-thread") { // render thread mode
- if (N) {
- if (N->get() == "safe") {
- rtm = OS::RENDER_THREAD_SAFE;
- } else if (N->get() == "unsafe") {
- rtm = OS::RENDER_THREAD_UNSAFE;
- } else if (N->get() == "separate") {
- rtm = OS::RENDER_SEPARATE_THREAD;
- } else {
- OS::get_singleton()->print("Unknown render thread mode, aborting.\nValid options are 'unsafe', 'safe' and 'separate'.\n");
- goto error;
- }
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing render thread mode argument, aborting.\n");
- goto error;
- }
- #ifdef TOOLS_ENABLED
- } else if (arg == "-e" || arg == "--editor") { // starts editor
- editor = true;
- } else if (arg == "-p" || arg == "--project-manager") { // starts project manager
- project_manager = true;
- } else if (arg == "--debug-server") {
- if (N) {
- debug_server_uri = N->get();
- if (!debug_server_uri.contains("://")) { // wrong address
- OS::get_singleton()->print("Invalid debug server uri. It should be of the form <protocol>://<bind_address>:<port>.\n");
- goto error;
- }
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing remote debug server uri, aborting.\n");
- goto error;
- }
- } else if (arg == "--single-threaded-scene") {
- single_threaded_scene = true;
- } else if (arg == "--build-solutions") { // Build the scripting solution such C#
- auto_build_solutions = true;
- editor = true;
- cmdline_tool = true;
- } else if (arg == "--dump-gdextension-interface") {
- // Register as an editor instance to use low-end fallback if relevant.
- editor = true;
- cmdline_tool = true;
- dump_gdextension_interface = true;
- print_line("Dumping GDExtension interface header file");
- // Hack. Not needed but otherwise we end up detecting that this should
- // run the project instead of a cmdline tool.
- // Needs full refactoring to fix properly.
- main_args.push_back(arg);
- } else if (arg == "--dump-extension-api") {
- // Register as an editor instance to use low-end fallback if relevant.
- editor = true;
- cmdline_tool = true;
- dump_extension_api = true;
- print_line("Dumping Extension API");
- // Hack. Not needed but otherwise we end up detecting that this should
- // run the project instead of a cmdline tool.
- // Needs full refactoring to fix properly.
- main_args.push_back(arg);
- } else if (arg == "--dump-extension-api-with-docs") {
- // Register as an editor instance to use low-end fallback if relevant.
- editor = true;
- cmdline_tool = true;
- dump_extension_api = true;
- include_docs_in_extension_api_dump = true;
- print_line("Dumping Extension API including documentation");
- // Hack. Not needed but otherwise we end up detecting that this should
- // run the project instead of a cmdline tool.
- // Needs full refactoring to fix properly.
- main_args.push_back(arg);
- } else if (arg == "--validate-extension-api") {
- // Register as an editor instance to use low-end fallback if relevant.
- editor = true;
- cmdline_tool = true;
- validate_extension_api = true;
- // Hack. Not needed but otherwise we end up detecting that this should
- // run the project instead of a cmdline tool.
- // Needs full refactoring to fix properly.
- main_args.push_back(arg);
- if (N) {
- validate_extension_api_file = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing file to load argument after --validate-extension-api, aborting.");
- goto error;
- }
- } else if (arg == "--import") {
- editor = true;
- cmdline_tool = true;
- wait_for_import = true;
- quit_after = 1;
- } else if (arg == "--export-release" || arg == "--export-debug" ||
- arg == "--export-pack") { // Export project
- // Actually handling is done in start().
- editor = true;
- cmdline_tool = true;
- wait_for_import = true;
- main_args.push_back(arg);
- #ifndef DISABLE_DEPRECATED
- } else if (arg == "--export") { // For users used to 3.x syntax.
- OS::get_singleton()->print("The Godot 3 --export option was changed to more explicit --export-release / --export-debug / --export-pack options.\nSee the --help output for details.\n");
- goto error;
- } else if (arg == "--convert-3to4") {
- // Actually handling is done in start().
- cmdline_tool = true;
- main_args.push_back(arg);
- if (N && !N->get().begins_with("-")) {
- if (itos(N->get().to_int()) == N->get()) {
- converter_max_kb_file = N->get().to_int();
- }
- if (N->next() && !N->next()->get().begins_with("-")) {
- if (itos(N->next()->get().to_int()) == N->next()->get()) {
- converter_max_line_length = N->next()->get().to_int();
- }
- }
- }
- } else if (arg == "--validate-conversion-3to4") {
- // Actually handling is done in start().
- cmdline_tool = true;
- main_args.push_back(arg);
- if (N && !N->get().begins_with("-")) {
- if (itos(N->get().to_int()) == N->get()) {
- converter_max_kb_file = N->get().to_int();
- }
- if (N->next() && !N->next()->get().begins_with("-")) {
- if (itos(N->next()->get().to_int()) == N->next()->get()) {
- converter_max_line_length = N->next()->get().to_int();
- }
- }
- }
- #endif // DISABLE_DEPRECATED
- } else if (arg == "--doctool") {
- // Actually handling is done in start().
- cmdline_tool = true;
- // `--doctool` implies `--headless` to avoid spawning an unnecessary window
- // and speed up class reference generation.
- audio_driver = NULL_AUDIO_DRIVER;
- display_driver = NULL_DISPLAY_DRIVER;
- main_args.push_back(arg);
- #ifdef MODULE_GDSCRIPT_ENABLED
- } else if (arg == "--gdscript-docs") {
- if (N) {
- project_path = N->get();
- // Will be handled in start()
- main_args.push_back(arg);
- main_args.push_back(N->get());
- N = N->next();
- // GDScript docgen requires Autoloads, but loading those also creates a main loop.
- // This forces main loop to quit without adding more GDScript-specific exceptions to setup.
- quit_after = 1;
- } else {
- OS::get_singleton()->print("Missing relative or absolute path to project for --gdscript-docs, aborting.\n");
- goto error;
- }
- #endif // MODULE_GDSCRIPT_ENABLED
- #endif // TOOLS_ENABLED
- } else if (arg == "--path") { // set path of project to start or edit
- if (N) {
- String p = N->get();
- if (OS::get_singleton()->set_cwd(p) != OK) {
- OS::get_singleton()->print("Invalid project path specified: \"%s\", aborting.\n", p.utf8().get_data());
- goto error;
- }
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing relative or absolute path, aborting.\n");
- goto error;
- }
- } else if (arg == "-u" || arg == "--upwards") { // scan folders upwards
- upwards = true;
- } else if (arg == "--quit") { // Auto quit at the end of the first main loop iteration
- quit_after = 1;
- } else if (arg == "--quit-after") { // Quit after the given number of iterations
- if (N) {
- quit_after = N->get().to_int();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing number of iterations, aborting.\n");
- goto error;
- }
- } else if (arg.ends_with("project.godot")) {
- String path;
- String file = arg;
- int sep = MAX(file.rfind("/"), file.rfind("\\"));
- if (sep == -1) {
- path = ".";
- } else {
- path = file.substr(0, sep);
- }
- if (OS::get_singleton()->set_cwd(path) == OK) {
- // path already specified, don't override
- } else {
- project_path = path;
- }
- #ifdef TOOLS_ENABLED
- editor = true;
- #endif
- } else if (arg == "-b" || arg == "--breakpoints") { // add breakpoints
- if (N) {
- String bplist = N->get();
- breakpoints = bplist.split(",");
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing list of breakpoints, aborting.\n");
- goto error;
- }
- } else if (arg == "--max-fps") { // set maximum rendered FPS
- if (N) {
- max_fps = N->get().to_int();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing maximum FPS argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--frame-delay") { // force frame delay
- if (N) {
- frame_delay = N->get().to_int();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing frame delay argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--time-scale") { // force time scale
- if (N) {
- Engine::get_singleton()->set_time_scale(N->get().to_float());
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing time scale argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--main-pack") {
- if (N) {
- main_pack = N->get();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing path to main pack file, aborting.\n");
- goto error;
- }
- } else if (arg == "-d" || arg == "--debug") {
- debug_uri = "local://";
- OS::get_singleton()->_debug_stdout = true;
- #if defined(DEBUG_ENABLED)
- } else if (arg == "--debug-collisions") {
- debug_collisions = true;
- } else if (arg == "--debug-paths") {
- debug_paths = true;
- } else if (arg == "--debug-navigation") {
- debug_navigation = true;
- } else if (arg == "--debug-avoidance") {
- debug_avoidance = true;
- } else if (arg == "--debug-canvas-item-redraw") {
- debug_canvas_item_redraw = true;
- } else if (arg == "--debug-stringnames") {
- StringName::set_debug_stringnames(true);
- #endif
- } else if (arg == "--remote-debug") {
- if (N) {
- debug_uri = N->get();
- if (!debug_uri.contains("://")) { // wrong address
- OS::get_singleton()->print(
- "Invalid debug host address, it should be of the form <protocol>://<host/IP>:<port>.\n");
- goto error;
- }
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing remote debug host address, aborting.\n");
- goto error;
- }
- } else if (arg == "--editor-pid") { // not exposed to user
- if (N) {
- editor_pid = N->get().to_int();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing editor PID argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--disable-render-loop") {
- disable_render_loop = true;
- } else if (arg == "--fixed-fps") {
- if (N) {
- fixed_fps = N->get().to_int();
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing fixed-fps argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--write-movie") {
- if (N) {
- Engine::get_singleton()->set_write_movie_path(N->get());
- N = N->next();
- if (fixed_fps == -1) {
- fixed_fps = 60;
- }
- OS::get_singleton()->_writing_movie = true;
- } else {
- OS::get_singleton()->print("Missing write-movie argument, aborting.\n");
- goto error;
- }
- } else if (arg == "--disable-vsync") {
- disable_vsync = true;
- } else if (arg == "--print-fps") {
- print_fps = true;
- } else if (arg == "--profile-gpu") {
- profile_gpu = true;
- } else if (arg == "--disable-crash-handler") {
- OS::get_singleton()->disable_crash_handler();
- } else if (arg == "--skip-breakpoints") {
- skip_breakpoints = true;
- #ifndef _3D_DISABLED
- } else if (arg == "--xr-mode") {
- if (N) {
- String xr_mode = N->get().to_lower();
- N = N->next();
- if (xr_mode == "default") {
- XRServer::set_xr_mode(XRServer::XRMODE_DEFAULT);
- } else if (xr_mode == "off") {
- XRServer::set_xr_mode(XRServer::XRMODE_OFF);
- } else if (xr_mode == "on") {
- XRServer::set_xr_mode(XRServer::XRMODE_ON);
- } else {
- OS::get_singleton()->print("Unknown --xr-mode argument \"%s\", aborting.\n", xr_mode.ascii().get_data());
- goto error;
- }
- } else {
- OS::get_singleton()->print("Missing --xr-mode argument, aborting.\n");
- goto error;
- }
- #endif // _3D_DISABLED
- } else if (arg == "--benchmark") {
- OS::get_singleton()->set_use_benchmark(true);
- } else if (arg == "--benchmark-file") {
- if (N) {
- OS::get_singleton()->set_use_benchmark(true);
- String benchmark_file = N->get();
- OS::get_singleton()->set_benchmark_file(benchmark_file);
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing <path> argument for --benchmark-file <path>.\n");
- goto error;
- }
- #if defined(TOOLS_ENABLED) && defined(MODULE_GDSCRIPT_ENABLED) && !defined(GDSCRIPT_NO_LSP)
- } else if (arg == "--lsp-port") {
- if (N) {
- int port_override = N->get().to_int();
- if (port_override < 0 || port_override > 65535) {
- OS::get_singleton()->print("<port> argument for --lsp-port <port> must be between 0 and 65535.\n");
- goto error;
- }
- GDScriptLanguageServer::port_override = port_override;
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing <port> argument for --lsp-port <port>.\n");
- goto error;
- }
- #endif // TOOLS_ENABLED && MODULE_GDSCRIPT_ENABLED && !GDSCRIPT_NO_LSP
- #if defined(TOOLS_ENABLED)
- } else if (arg == "--dap-port") {
- if (N) {
- int port_override = N->get().to_int();
- if (port_override < 0 || port_override > 65535) {
- OS::get_singleton()->print("<port> argument for --dap-port <port> must be between 0 and 65535.\n");
- goto error;
- }
- DebugAdapterServer::port_override = port_override;
- N = N->next();
- } else {
- OS::get_singleton()->print("Missing <port> argument for --dap-port <port>.\n");
- goto error;
- }
- #endif // TOOLS_ENABLED
- } else if (arg == "--" || arg == "++") {
- adding_user_args = true;
- } else {
- main_args.push_back(arg);
- }
- I = N;
- }
- #ifdef TOOLS_ENABLED
- if (editor && project_manager) {
- OS::get_singleton()->print(
- "Error: Command line arguments implied opening both editor and project manager, which is not possible. Aborting.\n");
- goto error;
- }
- #endif
- // Network file system needs to be configured before globals, since globals are based on the
- // 'project.godot' file which will only be available through the network if this is enabled
- if (!remotefs.is_empty()) {
- int port;
- if (remotefs.contains(":")) {
- port = remotefs.get_slicec(':', 1).to_int();
- remotefs = remotefs.get_slicec(':', 0);
- } else {
- port = 6010;
- }
- Error err = OS::get_singleton()->setup_remote_filesystem(remotefs, port, remotefs_pass, project_path);
- if (err) {
- OS::get_singleton()->printerr("Could not connect to remotefs: %s:%i.\n", remotefs.utf8().get_data(), port);
- goto error;
- }
- }
- OS::get_singleton()->_in_editor = editor;
- if (globals->setup(project_path, main_pack, upwards, editor) == OK) {
- #ifdef TOOLS_ENABLED
- found_project = true;
- #endif
- } else {
- #ifdef TOOLS_ENABLED
- editor = false;
- #else
- const String error_msg = "Error: Couldn't load project data at path \"" + project_path + "\". Is the .pck file missing?\nIf you've renamed the executable, the associated .pck file should also be renamed to match the executable's name (without the extension).\n";
- OS::get_singleton()->print("%s", error_msg.utf8().get_data());
- OS::get_singleton()->alert(error_msg);
- goto error;
- #endif
- }
- // Initialize WorkerThreadPool.
- {
- #ifdef THREADS_ENABLED
- if (editor || project_manager) {
- WorkerThreadPool::get_singleton()->init(-1, 0.75);
- } else {
- int worker_threads = GLOBAL_GET("threading/worker_pool/max_threads");
- float low_priority_ratio = GLOBAL_GET("threading/worker_pool/low_priority_thread_ratio");
- WorkerThreadPool::get_singleton()->init(worker_threads, low_priority_ratio);
- }
- #else
- WorkerThreadPool::get_singleton()->init(0, 0);
- #endif
- }
- #ifdef TOOLS_ENABLED
- if (editor) {
- Engine::get_singleton()->set_editor_hint(true);
- Engine::get_singleton()->set_extension_reloading_enabled(true);
- }
- #endif
- // Initialize user data dir.
- OS::get_singleton()->ensure_user_data_dir();
- initialize_modules(MODULE_INITIALIZATION_LEVEL_CORE);
- register_core_extensions(); // core extensions must be registered after globals setup and before display
- ResourceUID::get_singleton()->load_from_cache(true); // load UUIDs from cache.
- if (ProjectSettings::get_singleton()->has_custom_feature("dedicated_server")) {
- audio_driver = NULL_AUDIO_DRIVER;
- display_driver = NULL_DISPLAY_DRIVER;
- }
- GLOBAL_DEF(PropertyInfo(Variant::INT, "network/limits/debugger/max_chars_per_second", PROPERTY_HINT_RANGE, "0, 4096, 1, or_greater"), 32768);
- GLOBAL_DEF(PropertyInfo(Variant::INT, "network/limits/debugger/max_queued_messages", PROPERTY_HINT_RANGE, "0, 8192, 1, or_greater"), 2048);
- GLOBAL_DEF(PropertyInfo(Variant::INT, "network/limits/debugger/max_errors_per_second", PROPERTY_HINT_RANGE, "0, 200, 1, or_greater"), 400);
- GLOBAL_DEF(PropertyInfo(Variant::INT, "network/limits/debugger/max_warnings_per_second", PROPERTY_HINT_RANGE, "0, 200, 1, or_greater"), 400);
- EngineDebugger::initialize(debug_uri, skip_breakpoints, breakpoints, []() {
- if (editor_pid) {
- DisplayServer::get_singleton()->enable_for_stealing_focus(editor_pid);
- }
- });
- #ifdef TOOLS_ENABLED
- if (editor) {
- packed_data->set_disabled(true);
- main_args.push_back("--editor");
- if (!init_windowed && !init_fullscreen) {
- init_maximized = true;
- window_mode = DisplayServer::WINDOW_MODE_MAXIMIZED;
- }
- }
- if (!project_manager && !editor) {
- // If we didn't find a project, we fall back to the project manager.
- project_manager = !found_project && !cmdline_tool;
- }
- if (project_manager) {
- Engine::get_singleton()->set_project_manager_hint(true);
- }
- #endif
- GLOBAL_DEF("debug/file_logging/enable_file_logging", false);
- // Only file logging by default on desktop platforms as logs can't be
- // accessed easily on mobile/Web platforms (if at all).
- // This also prevents logs from being created for the editor instance, as feature tags
- // are disabled while in the editor (even if they should logically apply).
- GLOBAL_DEF("debug/file_logging/enable_file_logging.pc", true);
- GLOBAL_DEF("debug/file_logging/log_path", "user://logs/godot.log");
- GLOBAL_DEF(PropertyInfo(Variant::INT, "debug/file_logging/max_log_files", PROPERTY_HINT_RANGE, "0,20,1,or_greater"), 5);
- // If `--log-file` is used to override the log path, allow creating logs for the project manager or editor
- // and even if file logging is disabled in the Project Settings.
- // `--log-file` can be used with any path (including absolute paths outside the project folder),
- // so check for filesystem access if it's used.
- if (FileAccess::get_create_func(!log_file.is_empty() ? FileAccess::ACCESS_FILESYSTEM : FileAccess::ACCESS_USERDATA) &&
- (!log_file.is_empty() || (!project_manager && !editor && GLOBAL_GET("debug/file_logging/enable_file_logging")))) {
- // Don't create logs for the project manager as they would be written to
- // the current working directory, which is inconvenient.
- String base_path;
- int max_files;
- if (!log_file.is_empty()) {
- base_path = log_file;
- // Ensure log file name respects the specified override by disabling log rotation.
- max_files = 1;
- } else {
- base_path = GLOBAL_GET("debug/file_logging/log_path");
- max_files = GLOBAL_GET("debug/file_logging/max_log_files");
- }
- OS::get_singleton()->add_logger(memnew(RotatedFileLogger(base_path, max_files)));
- }
- if (main_args.size() == 0 && String(GLOBAL_GET("application/run/main_scene")) == "") {
- #ifdef TOOLS_ENABLED
- if (!editor && !project_manager) {
- #endif
- const String error_msg = "Error: Can't run project: no main scene defined in the project.\n";
- OS::get_singleton()->print("%s", error_msg.utf8().get_data());
- OS::get_singleton()->alert(error_msg);
- goto error;
- #ifdef TOOLS_ENABLED
- }
- #endif
- }
- if (editor || project_manager) {
- Engine::get_singleton()->set_editor_hint(true);
- use_custom_res = false;
- input_map->load_default(); //keys for editor
- } else {
- input_map->load_from_project_settings(); //keys for game
- }
- if (bool(GLOBAL_GET("application/run/disable_stdout"))) {
- quiet_stdout = true;
- }
- if (bool(GLOBAL_GET("application/run/disable_stderr"))) {
- CoreGlobals::print_error_enabled = false;
- }
- if (!bool(GLOBAL_GET("application/run/print_header"))) {
- // --no-header option for project settings.
- Engine::get_singleton()->_print_header = false;
- }
- if (quiet_stdout) {
- CoreGlobals::print_line_enabled = false;
- }
- Logger::set_flush_stdout_on_print(GLOBAL_GET("application/run/flush_stdout_on_print"));
- OS::get_singleton()->set_cmdline(execpath, main_args, user_args);
- {
- String driver_hints = "";
- String driver_hints_with_d3d12 = "";
- {
- Vector<String> driver_hints_arr;
- #ifdef VULKAN_ENABLED
- driver_hints_arr.push_back("vulkan");
- #endif
- driver_hints = String(",").join(driver_hints_arr);
- #ifdef D3D12_ENABLED
- driver_hints_arr.push_back("d3d12");
- #endif
- driver_hints_with_d3d12 = String(",").join(driver_hints_arr);
- }
- String default_driver = driver_hints.get_slice(",", 0);
- String default_driver_with_d3d12 = driver_hints_with_d3d12.get_slice(",", 0);
- // For now everything defaults to vulkan when available. This can change in future updates.
- GLOBAL_DEF_RST_NOVAL("rendering/rendering_device/driver", default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/rendering_device/driver.windows", PROPERTY_HINT_ENUM, driver_hints_with_d3d12), default_driver_with_d3d12);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/rendering_device/driver.linuxbsd", PROPERTY_HINT_ENUM, driver_hints), default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/rendering_device/driver.android", PROPERTY_HINT_ENUM, driver_hints), default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/rendering_device/driver.ios", PROPERTY_HINT_ENUM, driver_hints), default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/rendering_device/driver.macos", PROPERTY_HINT_ENUM, driver_hints), default_driver);
- GLOBAL_DEF_RST("rendering/rendering_device/fallback_to_vulkan", true);
- GLOBAL_DEF_RST("rendering/rendering_device/fallback_to_d3d12", true);
- }
- {
- String driver_hints = "";
- String driver_hints_angle = "";
- String driver_hints_egl = "";
- #ifdef GLES3_ENABLED
- driver_hints = "opengl3";
- driver_hints_angle = "opengl3,opengl3_angle"; // macOS, Windows.
- driver_hints_egl = "opengl3,opengl3_es"; // Linux.
- #endif
- String default_driver = driver_hints.get_slice(",", 0);
- GLOBAL_DEF_RST_NOVAL("rendering/gl_compatibility/driver", default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/gl_compatibility/driver.windows", PROPERTY_HINT_ENUM, driver_hints_angle), default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/gl_compatibility/driver.linuxbsd", PROPERTY_HINT_ENUM, driver_hints_egl), default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/gl_compatibility/driver.web", PROPERTY_HINT_ENUM, driver_hints), default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/gl_compatibility/driver.android", PROPERTY_HINT_ENUM, driver_hints), default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/gl_compatibility/driver.ios", PROPERTY_HINT_ENUM, driver_hints), default_driver);
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "rendering/gl_compatibility/driver.macos", PROPERTY_HINT_ENUM, driver_hints_angle), default_driver);
- GLOBAL_DEF_RST("rendering/gl_compatibility/nvidia_disable_threaded_optimization", true);
- GLOBAL_DEF_RST("rendering/gl_compatibility/fallback_to_angle", true);
- GLOBAL_DEF_RST("rendering/gl_compatibility/fallback_to_native", true);
- GLOBAL_DEF_RST("rendering/gl_compatibility/fallback_to_gles", true);
- Array device_blocklist;
- #define BLOCK_DEVICE(m_vendor, m_name) \
- { \
- Dictionary device; \
- device["vendor"] = m_vendor; \
- device["name"] = m_name; \
- device_blocklist.push_back(device); \
- }
- // AMD GPUs.
- BLOCK_DEVICE("ATI", "Radeon 9"); // ATI Radeon 9000 Series
- BLOCK_DEVICE("ATI", "Radeon X"); // ATI Radeon X500-X2000 Series
- BLOCK_DEVICE("ATI", "Radeon HD 2"); // AMD/ATI (Mobility) Radeon HD 2xxx Series
- BLOCK_DEVICE("ATI", "Radeon HD 3"); // AMD/ATI (Mobility) Radeon HD 3xxx Series
- BLOCK_DEVICE("ATI", "Radeon HD 4"); // AMD/ATI (Mobility) Radeon HD 4xxx Series
- BLOCK_DEVICE("ATI", "Radeon HD 5"); // AMD/ATI (Mobility) Radeon HD 5xxx Series
- BLOCK_DEVICE("ATI", "Radeon HD 6"); // AMD/ATI (Mobility) Radeon HD 6xxx Series
- BLOCK_DEVICE("ATI", "Radeon HD 7"); // AMD/ATI (Mobility) Radeon HD 7xxx Series
- BLOCK_DEVICE("ATI", "Radeon HD 8"); // AMD/ATI (Mobility) Radeon HD 8xxx Series
- BLOCK_DEVICE("ATI", "Radeon(TM) R2 Graphics"); // APUs
- BLOCK_DEVICE("ATI", "Radeon(TM) R3 Graphics");
- BLOCK_DEVICE("ATI", "Radeon(TM) R4 Graphics");
- BLOCK_DEVICE("ATI", "Radeon(TM) R5 Graphics");
- BLOCK_DEVICE("ATI", "Radeon(TM) R6 Graphics");
- BLOCK_DEVICE("ATI", "Radeon(TM) R7 Graphics");
- BLOCK_DEVICE("AMD", "Radeon(TM) R7 Graphics");
- BLOCK_DEVICE("AMD", "Radeon(TM) R8 Graphics");
- BLOCK_DEVICE("ATI", "Radeon R5 Graphics");
- BLOCK_DEVICE("ATI", "Radeon R6 Graphics");
- BLOCK_DEVICE("ATI", "Radeon R7 Graphics");
- BLOCK_DEVICE("AMD", "Radeon R7 Graphics");
- BLOCK_DEVICE("AMD", "Radeon R8 Graphics");
- BLOCK_DEVICE("ATI", "Radeon R5 2"); // Rx 2xx Series
- BLOCK_DEVICE("ATI", "Radeon R7 2");
- BLOCK_DEVICE("ATI", "Radeon R9 2");
- BLOCK_DEVICE("ATI", "Radeon R5 M2"); // Rx M2xx Series
- BLOCK_DEVICE("ATI", "Radeon R7 M2");
- BLOCK_DEVICE("ATI", "Radeon R9 M2");
- BLOCK_DEVICE("ATI", "Radeon (TM) R9 Fury");
- BLOCK_DEVICE("ATI", "Radeon (TM) R5 3"); // Rx 3xx Series
- BLOCK_DEVICE("AMD", "Radeon (TM) R5 3");
- BLOCK_DEVICE("ATI", "Radeon (TM) R7 3");
- BLOCK_DEVICE("AMD", "Radeon (TM) R7 3");
- BLOCK_DEVICE("ATI", "Radeon (TM) R9 3");
- BLOCK_DEVICE("AMD", "Radeon (TM) R9 3");
- BLOCK_DEVICE("ATI", "Radeon (TM) R5 M3"); // Rx M3xx Series
- BLOCK_DEVICE("AMD", "Radeon (TM) R5 M3");
- BLOCK_DEVICE("ATI", "Radeon (TM) R7 M3");
- BLOCK_DEVICE("AMD", "Radeon (TM) R7 M3");
- BLOCK_DEVICE("ATI", "Radeon (TM) R9 M3");
- BLOCK_DEVICE("AMD", "Radeon (TM) R9 M3");
- // Intel GPUs.
- BLOCK_DEVICE("0x8086", "0x0042"); // HD Graphics, Gen5, Clarkdale
- BLOCK_DEVICE("0x8086", "0x0046"); // HD Graphics, Gen5, Arrandale
- BLOCK_DEVICE("0x8086", "0x010A"); // HD Graphics, Gen6, Sandy Bridge
- BLOCK_DEVICE("Intel", "Intel HD Graphics 2000");
- BLOCK_DEVICE("Intel", "Intel(R) HD Graphics 2000");
- BLOCK_DEVICE("0x8086", "0x0102"); // HD Graphics 2000, Gen6, Sandy Bridge
- BLOCK_DEVICE("0x8086", "0x0116"); // HD Graphics 3000, Gen6, Sandy Bridge
- BLOCK_DEVICE("Intel", "Intel HD Graphics 3000");
- BLOCK_DEVICE("Intel", "Intel(R) HD Graphics 3000");
- BLOCK_DEVICE("0x8086", "0x0126"); // HD Graphics 3000, Gen6, Sandy Bridge
- BLOCK_DEVICE("Intel", "Intel HD Graphics P3000");
- BLOCK_DEVICE("Intel", "Intel(R) HD Graphics P3000");
- BLOCK_DEVICE("0x8086", "0x0112"); // HD Graphics P3000, Gen6, Sandy Bridge
- BLOCK_DEVICE("0x8086", "0x0122"); // HD Graphics P3000, Gen6, Sandy Bridge
- BLOCK_DEVICE("0x8086", "0x015A"); // HD Graphics, Gen7, Ivy Bridge
- BLOCK_DEVICE("Intel", "Intel HD Graphics 2500");
- BLOCK_DEVICE("Intel", "Intel(R) HD Graphics 2500");
- BLOCK_DEVICE("0x8086", "0x0152"); // HD Graphics 2500, Gen7, Ivy Bridge
- BLOCK_DEVICE("Intel", "Intel HD Graphics 4000");
- BLOCK_DEVICE("Intel", "Intel(R) HD Graphics 4000");
- BLOCK_DEVICE("0x8086", "0x0162"); // HD Graphics 4000, Gen7, Ivy Bridge
- BLOCK_DEVICE("0x8086", "0x0166"); // HD Graphics 4000, Gen7, Ivy Bridge
- BLOCK_DEVICE("Intel", "Intel HD Graphics P4000");
- BLOCK_DEVICE("Intel", "Intel(R) HD Graphics P4000");
- BLOCK_DEVICE("0x8086", "0x016A"); // HD Graphics P4000, Gen7, Ivy Bridge
- #undef BLOCK_DEVICE
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::ARRAY, "rendering/gl_compatibility/force_angle_on_devices", PROPERTY_HINT_ARRAY_TYPE, vformat("%s/%s:%s", Variant::DICTIONARY, PROPERTY_HINT_NONE, String())), device_blocklist);
- }
- // Start with RenderingDevice-based backends.
- #ifdef RD_ENABLED
- renderer_hints = "forward_plus,mobile";
- default_renderer_mobile = "mobile";
- #endif
- // And Compatibility next, or first if Vulkan is disabled.
- #ifdef GLES3_ENABLED
- if (!renderer_hints.is_empty()) {
- renderer_hints += ",";
- }
- renderer_hints += "gl_compatibility";
- if (default_renderer_mobile.is_empty()) {
- default_renderer_mobile = "gl_compatibility";
- }
- // Default to Compatibility when using the project manager.
- if (rendering_driver.is_empty() && rendering_method.is_empty() && project_manager) {
- rendering_driver = "opengl3";
- rendering_method = "gl_compatibility";
- default_renderer_mobile = "gl_compatibility";
- }
- #endif
- if (renderer_hints.is_empty()) {
- ERR_PRINT("No renderers available.");
- }
- if (!rendering_method.is_empty()) {
- if (rendering_method != "forward_plus" &&
- rendering_method != "mobile" &&
- rendering_method != "gl_compatibility") {
- OS::get_singleton()->print("Unknown renderer name '%s', aborting. Valid options are: %s\n", rendering_method.utf8().get_data(), renderer_hints.utf8().get_data());
- goto error;
- }
- }
- if (!rendering_driver.is_empty()) {
- // As the rendering drivers available may depend on the display driver and renderer
- // selected, we can't do an exhaustive check here, but we can look through all
- // the options in all the display drivers for a match.
- bool found = false;
- for (int i = 0; i < DisplayServer::get_create_function_count(); i++) {
- Vector<String> r_drivers = DisplayServer::get_create_function_rendering_drivers(i);
- for (int d = 0; d < r_drivers.size(); d++) {
- if (rendering_driver == r_drivers[d]) {
- found = true;
- break;
- }
- }
- }
- if (!found) {
- OS::get_singleton()->print("Unknown rendering driver '%s', aborting.\nValid options are ",
- rendering_driver.utf8().get_data());
- for (int i = 0; i < DisplayServer::get_create_function_count(); i++) {
- Vector<String> r_drivers = DisplayServer::get_create_function_rendering_drivers(i);
- for (int d = 0; d < r_drivers.size(); d++) {
- OS::get_singleton()->print("'%s', ", r_drivers[d].utf8().get_data());
- }
- }
- OS::get_singleton()->print(".\n");
- goto error;
- }
- // Set a default renderer if none selected. Try to choose one that matches the driver.
- if (rendering_method.is_empty()) {
- if (rendering_driver == "opengl3" || rendering_driver == "opengl3_angle" || rendering_driver == "opengl3_es") {
- rendering_method = "gl_compatibility";
- } else {
- rendering_method = "forward_plus";
- }
- }
- // Now validate whether the selected driver matches with the renderer.
- bool valid_combination = false;
- Vector<String> available_drivers;
- if (rendering_method == "forward_plus" || rendering_method == "mobile") {
- #ifdef VULKAN_ENABLED
- available_drivers.push_back("vulkan");
- #endif
- #ifdef D3D12_ENABLED
- available_drivers.push_back("d3d12");
- #endif
- }
- #ifdef GLES3_ENABLED
- if (rendering_method == "gl_compatibility") {
- available_drivers.push_back("opengl3");
- available_drivers.push_back("opengl3_angle");
- available_drivers.push_back("opengl3_es");
- }
- #endif
- if (available_drivers.is_empty()) {
- OS::get_singleton()->print("Unknown renderer name '%s', aborting.\n", rendering_method.utf8().get_data());
- goto error;
- }
- for (int i = 0; i < available_drivers.size(); i++) {
- if (rendering_driver == available_drivers[i]) {
- valid_combination = true;
- break;
- }
- }
- if (!valid_combination) {
- OS::get_singleton()->print("Invalid renderer/driver combination '%s' and '%s', aborting. %s only supports the following drivers ", rendering_method.utf8().get_data(), rendering_driver.utf8().get_data(), rendering_method.utf8().get_data());
- for (int d = 0; d < available_drivers.size(); d++) {
- OS::get_singleton()->print("'%s', ", available_drivers[d].utf8().get_data());
- }
- OS::get_singleton()->print(".\n");
- goto error;
- }
- }
- default_renderer = renderer_hints.get_slice(",", 0);
- GLOBAL_DEF_RST_BASIC(PropertyInfo(Variant::STRING, "rendering/renderer/rendering_method", PROPERTY_HINT_ENUM, renderer_hints), default_renderer);
- GLOBAL_DEF_RST_BASIC("rendering/renderer/rendering_method.mobile", default_renderer_mobile);
- GLOBAL_DEF_RST_BASIC("rendering/renderer/rendering_method.web", "gl_compatibility"); // This is a bit of a hack until we have WebGPU support.
- // Default to ProjectSettings default if nothing set on the command line.
- if (rendering_method.is_empty()) {
- rendering_method = GLOBAL_GET("rendering/renderer/rendering_method");
- }
- if (rendering_driver.is_empty()) {
- if (rendering_method == "gl_compatibility") {
- rendering_driver = GLOBAL_GET("rendering/gl_compatibility/driver");
- } else {
- rendering_driver = GLOBAL_GET("rendering/rendering_device/driver");
- }
- }
- // note this is the desired rendering driver, it doesn't mean we will get it.
- // TODO - make sure this is updated in the case of fallbacks, so that the user interface
- // shows the correct driver string.
- OS::get_singleton()->set_current_rendering_driver_name(rendering_driver);
- OS::get_singleton()->set_current_rendering_method(rendering_method);
- // always convert to lower case for consistency in the code
- rendering_driver = rendering_driver.to_lower();
- if (use_custom_res) {
- if (!force_res) {
- window_size.width = GLOBAL_GET("display/window/size/viewport_width");
- window_size.height = GLOBAL_GET("display/window/size/viewport_height");
- if (globals->has_setting("display/window/size/window_width_override") &&
- globals->has_setting("display/window/size/window_height_override")) {
- int desired_width = GLOBAL_GET("display/window/size/window_width_override");
- if (desired_width > 0) {
- window_size.width = desired_width;
- }
- int desired_height = GLOBAL_GET("display/window/size/window_height_override");
- if (desired_height > 0) {
- window_size.height = desired_height;
- }
- }
- }
- if (!bool(GLOBAL_GET("display/window/size/resizable"))) {
- window_flags |= DisplayServer::WINDOW_FLAG_RESIZE_DISABLED_BIT;
- }
- if (bool(GLOBAL_GET("display/window/size/borderless"))) {
- window_flags |= DisplayServer::WINDOW_FLAG_BORDERLESS_BIT;
- }
- if (bool(GLOBAL_GET("display/window/size/always_on_top"))) {
- window_flags |= DisplayServer::WINDOW_FLAG_ALWAYS_ON_TOP_BIT;
- }
- if (bool(GLOBAL_GET("display/window/size/transparent"))) {
- window_flags |= DisplayServer::WINDOW_FLAG_TRANSPARENT_BIT;
- }
- if (bool(GLOBAL_GET("display/window/size/extend_to_title"))) {
- window_flags |= DisplayServer::WINDOW_FLAG_EXTEND_TO_TITLE_BIT;
- }
- if (bool(GLOBAL_GET("display/window/size/no_focus"))) {
- window_flags |= DisplayServer::WINDOW_FLAG_NO_FOCUS_BIT;
- }
- window_mode = (DisplayServer::WindowMode)(GLOBAL_GET("display/window/size/mode").operator int());
- int initial_position_type = GLOBAL_GET("display/window/size/initial_position_type").operator int();
- if (initial_position_type == 0) { // Absolute.
- if (!init_use_custom_pos) {
- init_custom_pos = GLOBAL_GET("display/window/size/initial_position").operator Vector2i();
- init_use_custom_pos = true;
- }
- } else if (initial_position_type == 1) { // Center of Primary Screen.
- if (!init_use_custom_screen) {
- init_screen = DisplayServer::SCREEN_PRIMARY;
- init_use_custom_screen = true;
- }
- } else if (initial_position_type == 2) { // Center of Other Screen.
- if (!init_use_custom_screen) {
- init_screen = GLOBAL_GET("display/window/size/initial_screen").operator int();
- init_use_custom_screen = true;
- }
- } else if (initial_position_type == 3) { // Center of Screen With Mouse Pointer.
- if (!init_use_custom_screen) {
- init_screen = DisplayServer::SCREEN_WITH_MOUSE_FOCUS;
- init_use_custom_screen = true;
- }
- } else if (initial_position_type == 4) { // Center of Screen With Keyboard Focus.
- if (!init_use_custom_screen) {
- init_screen = DisplayServer::SCREEN_WITH_KEYBOARD_FOCUS;
- init_use_custom_screen = true;
- }
- }
- }
- GLOBAL_DEF("internationalization/locale/include_text_server_data", false);
- OS::get_singleton()->_allow_hidpi = GLOBAL_DEF("display/window/dpi/allow_hidpi", true);
- OS::get_singleton()->_allow_layered = GLOBAL_DEF("display/window/per_pixel_transparency/allowed", false);
- #ifdef TOOLS_ENABLED
- if (editor || project_manager) {
- // The editor and project manager always detect and use hiDPI if needed.
- OS::get_singleton()->_allow_hidpi = true;
- // Disable Vulkan overlays in editor, they cause various issues.
- OS::get_singleton()->set_environment("DISABLE_MANGOHUD", "1"); // GH-57403.
- OS::get_singleton()->set_environment("DISABLE_RTSS_LAYER", "1"); // GH-57937.
- OS::get_singleton()->set_environment("DISABLE_VKBASALT", "1");
- OS::get_singleton()->set_environment("DISABLE_VK_LAYER_reshade_1", "1"); // GH-70849.
- } else {
- // Re-allow using Vulkan overlays, disabled while using the editor.
- OS::get_singleton()->unset_environment("DISABLE_MANGOHUD");
- OS::get_singleton()->unset_environment("DISABLE_RTSS_LAYER");
- OS::get_singleton()->unset_environment("DISABLE_VKBASALT");
- OS::get_singleton()->unset_environment("DISABLE_VK_LAYER_reshade_1");
- }
- #endif
- if (rtm == -1) {
- rtm = GLOBAL_DEF("rendering/driver/threads/thread_model", OS::RENDER_THREAD_SAFE);
- }
- if (rtm >= 0 && rtm < 3) {
- if (editor || project_manager) {
- // Editor and project manager cannot run with rendering in a separate thread (they will crash on startup).
- rtm = OS::RENDER_THREAD_SAFE;
- }
- #if !defined(THREADS_ENABLED)
- rtm = OS::RENDER_THREAD_SAFE;
- #endif
- OS::get_singleton()->_render_thread_mode = OS::RenderThreadMode(rtm);
- }
- /* Determine audio and video drivers */
- // Display driver, e.g. X11, Wayland.
- // Make sure that headless is the last one, which it is assumed to be by design.
- DEV_ASSERT(NULL_DISPLAY_DRIVER == DisplayServer::get_create_function_name(DisplayServer::get_create_function_count() - 1));
- GLOBAL_DEF_NOVAL("display/display_server/driver", "default");
- GLOBAL_DEF_NOVAL(PropertyInfo(Variant::STRING, "display/display_server/driver.windows", PROPERTY_HINT_ENUM_SUGGESTION, "default,windows,headless"), "default");
- GLOBAL_DEF_NOVAL(PropertyInfo(Variant::STRING, "display/display_server/driver.linuxbsd", PROPERTY_HINT_ENUM_SUGGESTION, "default,x11,wayland,headless"), "default");
- GLOBAL_DEF_NOVAL(PropertyInfo(Variant::STRING, "display/display_server/driver.android", PROPERTY_HINT_ENUM_SUGGESTION, "default,android,headless"), "default");
- GLOBAL_DEF_NOVAL(PropertyInfo(Variant::STRING, "display/display_server/driver.ios", PROPERTY_HINT_ENUM_SUGGESTION, "default,iOS,headless"), "default");
- GLOBAL_DEF_NOVAL(PropertyInfo(Variant::STRING, "display/display_server/driver.macos", PROPERTY_HINT_ENUM_SUGGESTION, "default,macos,headless"), "default");
- GLOBAL_DEF_RST_NOVAL("audio/driver/driver", AudioDriverManager::get_driver(0)->get_name());
- if (audio_driver.is_empty()) { // Specified in project.godot.
- audio_driver = GLOBAL_GET("audio/driver/driver");
- }
- // Make sure that dummy is the last one, which it is assumed to be by design.
- DEV_ASSERT(NULL_AUDIO_DRIVER == AudioDriverManager::get_driver(AudioDriverManager::get_driver_count() - 1)->get_name());
- for (int i = 0; i < AudioDriverManager::get_driver_count(); i++) {
- if (audio_driver == AudioDriverManager::get_driver(i)->get_name()) {
- audio_driver_idx = i;
- break;
- }
- }
- if (audio_driver_idx < 0) {
- // If the requested driver wasn't found, pick the first entry.
- // If all else failed it would be the dummy driver (no sound).
- audio_driver_idx = 0;
- }
- if (Engine::get_singleton()->get_write_movie_path() != String()) {
- // Always use dummy driver for audio driver (which is last), also in no threaded mode.
- audio_driver_idx = AudioDriverManager::get_driver_count() - 1;
- AudioDriverDummy::get_dummy_singleton()->set_use_threads(false);
- }
- {
- window_orientation = DisplayServer::ScreenOrientation(int(GLOBAL_DEF_BASIC("display/window/handheld/orientation", DisplayServer::ScreenOrientation::SCREEN_LANDSCAPE)));
- }
- {
- window_vsync_mode = DisplayServer::VSyncMode(int(GLOBAL_DEF_BASIC("display/window/vsync/vsync_mode", DisplayServer::VSyncMode::VSYNC_ENABLED)));
- if (disable_vsync) {
- window_vsync_mode = DisplayServer::VSyncMode::VSYNC_DISABLED;
- }
- }
- Engine::get_singleton()->set_physics_ticks_per_second(GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "physics/common/physics_ticks_per_second", PROPERTY_HINT_RANGE, "1,1000,1"), 60));
- Engine::get_singleton()->set_max_physics_steps_per_frame(GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "physics/common/max_physics_steps_per_frame", PROPERTY_HINT_RANGE, "1,100,1"), 8));
- Engine::get_singleton()->set_physics_jitter_fix(GLOBAL_DEF("physics/common/physics_jitter_fix", 0.5));
- Engine::get_singleton()->set_max_fps(GLOBAL_DEF(PropertyInfo(Variant::INT, "application/run/max_fps", PROPERTY_HINT_RANGE, "0,1000,1"), 0));
- GLOBAL_DEF_RST(PropertyInfo(Variant::INT, "audio/driver/output_latency", PROPERTY_HINT_RANGE, "1,100,1"), 15);
- // Use a safer default output_latency for web to avoid audio cracking on low-end devices, especially mobile.
- GLOBAL_DEF_RST("audio/driver/output_latency.web", 50);
- Engine::get_singleton()->set_audio_output_latency(GLOBAL_GET("audio/driver/output_latency"));
- GLOBAL_DEF("debug/settings/stdout/print_fps", false);
- GLOBAL_DEF("debug/settings/stdout/print_gpu_profile", false);
- GLOBAL_DEF("debug/settings/stdout/verbose_stdout", false);
- if (!OS::get_singleton()->_verbose_stdout) { // Not manually overridden.
- OS::get_singleton()->_verbose_stdout = GLOBAL_GET("debug/settings/stdout/verbose_stdout");
- }
- #if defined(MACOS_ENABLED) || defined(IOS_ENABLED)
- OS::get_singleton()->set_environment("MVK_CONFIG_LOG_LEVEL", OS::get_singleton()->_verbose_stdout ? "3" : "1"); // 1 = Errors only, 3 = Info
- #endif
- if (max_fps >= 0) {
- Engine::get_singleton()->set_max_fps(max_fps);
- }
- if (frame_delay == 0) {
- frame_delay = GLOBAL_DEF(PropertyInfo(Variant::INT, "application/run/frame_delay_msec", PROPERTY_HINT_RANGE, "0,100,1,or_greater"), 0);
- if (Engine::get_singleton()->is_editor_hint()) {
- frame_delay = 0;
- }
- }
- if (audio_output_latency >= 1) {
- Engine::get_singleton()->set_audio_output_latency(audio_output_latency);
- }
- OS::get_singleton()->set_low_processor_usage_mode(GLOBAL_DEF("application/run/low_processor_mode", false));
- OS::get_singleton()->set_low_processor_usage_mode_sleep_usec(
- GLOBAL_DEF(PropertyInfo(Variant::INT, "application/run/low_processor_mode_sleep_usec", PROPERTY_HINT_RANGE, "0,33200,1,or_greater"), 6900)); // Roughly 144 FPS
- GLOBAL_DEF("application/run/delta_smoothing", true);
- if (!delta_smoothing_override) {
- OS::get_singleton()->set_delta_smoothing(GLOBAL_GET("application/run/delta_smoothing"));
- }
- GLOBAL_DEF("display/window/ios/allow_high_refresh_rate", true);
- GLOBAL_DEF("display/window/ios/hide_home_indicator", true);
- GLOBAL_DEF("display/window/ios/hide_status_bar", true);
- GLOBAL_DEF("display/window/ios/suppress_ui_gesture", true);
- // XR project settings.
- GLOBAL_DEF_RST_BASIC("xr/openxr/enabled", false);
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::STRING, "xr/openxr/default_action_map", PROPERTY_HINT_FILE, "*.tres"), "res://openxr_action_map.tres");
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "xr/openxr/form_factor", PROPERTY_HINT_ENUM, "Head Mounted,Handheld"), "0");
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "xr/openxr/view_configuration", PROPERTY_HINT_ENUM, "Mono,Stereo"), "1"); // "Mono,Stereo,Quad,Observer"
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "xr/openxr/reference_space", PROPERTY_HINT_ENUM, "Local,Stage,Local Floor"), "1");
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "xr/openxr/environment_blend_mode", PROPERTY_HINT_ENUM, "Opaque,Additive,Alpha"), "0");
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "xr/openxr/foveation_level", PROPERTY_HINT_ENUM, "Off,Low,Medium,High"), "0");
- GLOBAL_DEF_BASIC("xr/openxr/foveation_dynamic", false);
- GLOBAL_DEF_BASIC("xr/openxr/submit_depth_buffer", false);
- GLOBAL_DEF_BASIC("xr/openxr/startup_alert", true);
- // OpenXR project extensions settings.
- GLOBAL_DEF_BASIC("xr/openxr/extensions/hand_tracking", true);
- GLOBAL_DEF_RST_BASIC("xr/openxr/extensions/hand_interaction_profile", false);
- GLOBAL_DEF_BASIC("xr/openxr/extensions/eye_gaze_interaction", false);
- #ifdef TOOLS_ENABLED
- // Disabled for now, using XR inside of the editor we'll be working on during the coming months.
- // editor settings (it seems we're too early in the process when setting up rendering, to access editor settings...)
- // EDITOR_DEF_RST("xr/openxr/in_editor", false);
- // GLOBAL_DEF("xr/openxr/in_editor", false);
- #endif
- Engine::get_singleton()->set_frame_delay(frame_delay);
- message_queue = memnew(MessageQueue);
- Thread::release_main_thread(); // If setup2() is called from another thread, that one will become main thread, so preventively release this one.
- set_current_thread_safe_for_nodes(false);
- #if defined(STEAMAPI_ENABLED)
- if (editor || project_manager) {
- steam_tracker = memnew(SteamTracker);
- }
- #endif
- OS::get_singleton()->benchmark_end_measure("Startup", "Main::Setup");
- if (p_second_phase) {
- exit_err = setup2();
- if (exit_err != OK) {
- goto error;
- }
- }
- return OK;
- error:
- text_driver = "";
- display_driver = "";
- audio_driver = "";
- tablet_driver = "";
- Engine::get_singleton()->set_write_movie_path(String());
- project_path = "";
- args.clear();
- main_args.clear();
- if (show_help) {
- print_help(execpath);
- }
- EngineDebugger::deinitialize();
- if (performance) {
- memdelete(performance);
- }
- if (input_map) {
- memdelete(input_map);
- }
- if (translation_server) {
- memdelete(translation_server);
- }
- if (globals) {
- memdelete(globals);
- }
- if (packed_data) {
- memdelete(packed_data);
- }
- unregister_core_driver_types();
- unregister_core_extensions();
- if (engine) {
- memdelete(engine);
- }
- unregister_core_types();
- OS::get_singleton()->_cmdline.clear();
- OS::get_singleton()->_user_args.clear();
- if (message_queue) {
- memdelete(message_queue);
- }
- OS::get_singleton()->benchmark_end_measure("Startup", "Main::Setup");
- #if defined(STEAMAPI_ENABLED)
- if (steam_tracker) {
- memdelete(steam_tracker);
- }
- #endif
- OS::get_singleton()->finalize_core();
- locale = String();
- return exit_err;
- }
- Error _parse_resource_dummy(void *p_data, VariantParser::Stream *p_stream, Ref<Resource> &r_res, int &line, String &r_err_str) {
- VariantParser::Token token;
- VariantParser::get_token(p_stream, token, line, r_err_str);
- if (token.type != VariantParser::TK_NUMBER && token.type != VariantParser::TK_STRING) {
- r_err_str = "Expected number (old style sub-resource index) or String (ext-resource ID)";
- return ERR_PARSE_ERROR;
- }
- r_res.unref();
- VariantParser::get_token(p_stream, token, line, r_err_str);
- if (token.type != VariantParser::TK_PARENTHESIS_CLOSE) {
- r_err_str = "Expected ')'";
- return ERR_PARSE_ERROR;
- }
- return OK;
- }
- Error Main::setup2(bool p_show_boot_logo) {
- OS::get_singleton()->benchmark_begin_measure("Startup", "Main::Setup2");
- Thread::make_main_thread(); // Make whatever thread call this the main thread.
- set_current_thread_safe_for_nodes(true);
- // Don't use rich formatting to prevent ANSI escape codes from being written to log files.
- print_header(false);
- #ifdef TOOLS_ENABLED
- if (editor || project_manager || cmdline_tool) {
- OS::get_singleton()->benchmark_begin_measure("Startup", "Initialize Early Settings");
- EditorPaths::create();
- // Editor setting class is not available, load config directly.
- if (!init_use_custom_screen && (editor || project_manager) && EditorPaths::get_singleton()->are_paths_valid()) {
- ERR_FAIL_COND_V(!DirAccess::dir_exists_absolute(EditorPaths::get_singleton()->get_config_dir()), FAILED);
- String config_file_path = EditorSettings::get_existing_settings_path();
- if (FileAccess::exists(config_file_path)) {
- Error err;
- Ref<FileAccess> f = FileAccess::open(config_file_path, FileAccess::READ, &err);
- if (f.is_valid()) {
- VariantParser::StreamFile stream;
- stream.f = f;
- String assign;
- Variant value;
- VariantParser::Tag next_tag;
- int lines = 0;
- String error_text;
- VariantParser::ResourceParser rp_new;
- rp_new.ext_func = _parse_resource_dummy;
- rp_new.sub_func = _parse_resource_dummy;
- bool screen_found = false;
- String screen_property;
- bool prefer_wayland_found = false;
- bool prefer_wayland = false;
- if (editor) {
- screen_property = "interface/editor/editor_screen";
- } else if (project_manager) {
- screen_property = "interface/editor/project_manager_screen";
- } else {
- // Skip.
- screen_found = true;
- }
- if (!display_driver.is_empty()) {
- // Skip.
- prefer_wayland_found = true;
- }
- while (!screen_found || !prefer_wayland_found) {
- assign = Variant();
- next_tag.fields.clear();
- next_tag.name = String();
- err = VariantParser::parse_tag_assign_eof(&stream, lines, error_text, next_tag, assign, value, &rp_new, true);
- if (err == ERR_FILE_EOF) {
- break;
- }
- if (err == OK && !assign.is_empty()) {
- if (!screen_found && assign == screen_property) {
- init_screen = value;
- screen_found = true;
- }
- if (!prefer_wayland_found && assign == "run/platforms/linuxbsd/prefer_wayland") {
- prefer_wayland = value;
- prefer_wayland_found = true;
- }
- }
- }
- if (display_driver.is_empty()) {
- if (prefer_wayland) {
- display_driver = "wayland";
- } else {
- display_driver = "default";
- }
- }
- }
- }
- }
- if (found_project && EditorPaths::get_singleton()->is_self_contained()) {
- if (ProjectSettings::get_singleton()->get_resource_path() == OS::get_singleton()->get_executable_path().get_base_dir()) {
- ERR_PRINT("You are trying to run a self-contained editor at the same location as a project. This is not allowed, since editor files will mix with project files.");
- OS::get_singleton()->set_exit_code(EXIT_FAILURE);
- return FAILED;
- }
- }
- OS::get_singleton()->benchmark_end_measure("Startup", "Initialize Early Settings");
- }
- #endif
- OS::get_singleton()->benchmark_begin_measure("Startup", "Servers");
- tsman = memnew(TextServerManager);
- if (tsman) {
- Ref<TextServerDummy> ts;
- ts.instantiate();
- tsman->add_interface(ts);
- }
- #ifndef _3D_DISABLED
- physics_server_3d_manager = memnew(PhysicsServer3DManager);
- #endif // _3D_DISABLED
- physics_server_2d_manager = memnew(PhysicsServer2DManager);
- register_server_types();
- {
- OS::get_singleton()->benchmark_begin_measure("Servers", "Modules and Extensions");
- initialize_modules(MODULE_INITIALIZATION_LEVEL_SERVERS);
- GDExtensionManager::get_singleton()->initialize_extensions(GDExtension::INITIALIZATION_LEVEL_SERVERS);
- OS::get_singleton()->benchmark_end_measure("Servers", "Modules and Extensions");
- }
- /* Initialize Input */
- {
- OS::get_singleton()->benchmark_begin_measure("Servers", "Input");
- input = memnew(Input);
- OS::get_singleton()->initialize_joypads();
- OS::get_singleton()->benchmark_end_measure("Servers", "Input");
- }
- /* Initialize Display Server */
- {
- OS::get_singleton()->benchmark_begin_measure("Servers", "Display");
- if (display_driver.is_empty()) {
- display_driver = GLOBAL_GET("display/display_server/driver");
- }
- int display_driver_idx = -1;
- if (display_driver.is_empty() || display_driver == "default") {
- display_driver_idx = 0;
- } else {
- for (int i = 0; i < DisplayServer::get_create_function_count(); i++) {
- String name = DisplayServer::get_create_function_name(i);
- if (display_driver == name) {
- display_driver_idx = i;
- break;
- }
- }
- if (display_driver_idx < 0) {
- // If the requested driver wasn't found, pick the first entry.
- // If all else failed it would be the headless server.
- display_driver_idx = 0;
- }
- }
- // Store this in a globally accessible place, so we can retrieve the rendering drivers
- // list from the display driver for the editor UI.
- OS::get_singleton()->set_display_driver_id(display_driver_idx);
- Vector2i *window_position = nullptr;
- Vector2i position = init_custom_pos;
- if (init_use_custom_pos) {
- window_position = &position;
- }
- Color boot_bg_color = GLOBAL_DEF_BASIC("application/boot_splash/bg_color", boot_splash_bg_color);
- DisplayServer::set_early_window_clear_color_override(true, boot_bg_color);
- DisplayServer::Context context;
- if (editor) {
- context = DisplayServer::CONTEXT_EDITOR;
- } else if (project_manager) {
- context = DisplayServer::CONTEXT_PROJECTMAN;
- } else {
- context = DisplayServer::CONTEXT_ENGINE;
- }
- // rendering_driver now held in static global String in main and initialized in setup()
- Error err;
- display_server = DisplayServer::create(display_driver_idx, rendering_driver, window_mode, window_vsync_mode, window_flags, window_position, window_size, init_screen, context, err);
- if (err != OK || display_server == nullptr) {
- // We can't use this display server, try other ones as fallback.
- // Skip headless (always last registered) because that's not what users
- // would expect if they didn't request it explicitly.
- for (int i = 0; i < DisplayServer::get_create_function_count() - 1; i++) {
- if (i == display_driver_idx) {
- continue; // Don't try the same twice.
- }
- display_server = DisplayServer::create(i, rendering_driver, window_mode, window_vsync_mode, window_flags, window_position, window_size, init_screen, context, err);
- if (err == OK && display_server != nullptr) {
- break;
- }
- }
- }
- if (err != OK || display_server == nullptr) {
- ERR_PRINT("Unable to create DisplayServer, all display drivers failed.\nUse \"--headless\" command line argument to run the engine in headless mode if this is desired (e.g. for continuous integration).");
- if (display_server) {
- memdelete(display_server);
- }
- GDExtensionManager::get_singleton()->deinitialize_extensions(GDExtension::INITIALIZATION_LEVEL_SERVERS);
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_SERVERS);
- unregister_server_types();
- if (input) {
- memdelete(input);
- }
- if (tsman) {
- memdelete(tsman);
- }
- #ifndef _3D_DISABLED
- if (physics_server_3d_manager) {
- memdelete(physics_server_3d_manager);
- }
- #endif // _3D_DISABLED
- if (physics_server_2d_manager) {
- memdelete(physics_server_2d_manager);
- }
- return err;
- }
- if (display_server->has_feature(DisplayServer::FEATURE_ORIENTATION)) {
- display_server->screen_set_orientation(window_orientation);
- }
- OS::get_singleton()->benchmark_end_measure("Servers", "Display");
- }
- if (GLOBAL_GET("debug/settings/stdout/print_fps") || print_fps) {
- // Print requested V-Sync mode at startup to diagnose the printed FPS not going above the monitor refresh rate.
- switch (window_vsync_mode) {
- case DisplayServer::VSyncMode::VSYNC_DISABLED:
- print_line("Requested V-Sync mode: Disabled");
- break;
- case DisplayServer::VSyncMode::VSYNC_ENABLED:
- print_line("Requested V-Sync mode: Enabled - FPS will likely be capped to the monitor refresh rate.");
- break;
- case DisplayServer::VSyncMode::VSYNC_ADAPTIVE:
- print_line("Requested V-Sync mode: Adaptive");
- break;
- case DisplayServer::VSyncMode::VSYNC_MAILBOX:
- print_line("Requested V-Sync mode: Mailbox");
- break;
- }
- }
- if (OS::get_singleton()->_render_thread_mode == OS::RENDER_SEPARATE_THREAD) {
- WARN_PRINT("The Multi-Threaded rendering thread model is experimental. Feel free to try it since it will eventually become a stable feature.\n"
- "However, bear in mind that at the moment it can lead to project crashes or instability.\n"
- "So, unless you want to test the engine, use the Single-Safe option in the project settings instead.");
- }
- /* Initialize Pen Tablet Driver */
- {
- OS::get_singleton()->benchmark_begin_measure("Servers", "Tablet Driver");
- GLOBAL_DEF_RST_NOVAL("input_devices/pen_tablet/driver", "");
- GLOBAL_DEF_RST_NOVAL(PropertyInfo(Variant::STRING, "input_devices/pen_tablet/driver.windows", PROPERTY_HINT_ENUM, "winink,wintab,dummy"), "");
- if (tablet_driver.is_empty()) { // specified in project.godot
- tablet_driver = GLOBAL_GET("input_devices/pen_tablet/driver");
- if (tablet_driver.is_empty()) {
- tablet_driver = DisplayServer::get_singleton()->tablet_get_driver_name(0);
- }
- }
- for (int i = 0; i < DisplayServer::get_singleton()->tablet_get_driver_count(); i++) {
- if (tablet_driver == DisplayServer::get_singleton()->tablet_get_driver_name(i)) {
- DisplayServer::get_singleton()->tablet_set_current_driver(DisplayServer::get_singleton()->tablet_get_driver_name(i));
- break;
- }
- }
- if (DisplayServer::get_singleton()->tablet_get_current_driver().is_empty()) {
- DisplayServer::get_singleton()->tablet_set_current_driver(DisplayServer::get_singleton()->tablet_get_driver_name(0));
- }
- print_verbose("Using \"" + tablet_driver + "\" pen tablet driver...");
- OS::get_singleton()->benchmark_end_measure("Servers", "Tablet Driver");
- }
- /* Initialize Rendering Server */
- {
- OS::get_singleton()->benchmark_begin_measure("Servers", "Rendering");
- rendering_server = memnew(RenderingServerDefault(OS::get_singleton()->get_render_thread_mode() == OS::RENDER_SEPARATE_THREAD));
- rendering_server->init();
- //rendering_server->call_set_use_vsync(OS::get_singleton()->_use_vsync);
- rendering_server->set_render_loop_enabled(!disable_render_loop);
- if (profile_gpu || (!editor && bool(GLOBAL_GET("debug/settings/stdout/print_gpu_profile")))) {
- rendering_server->set_print_gpu_profile(true);
- }
- if (Engine::get_singleton()->get_write_movie_path() != String()) {
- movie_writer = MovieWriter::find_writer_for_file(Engine::get_singleton()->get_write_movie_path());
- if (movie_writer == nullptr) {
- ERR_PRINT("Can't find movie writer for file type, aborting: " + Engine::get_singleton()->get_write_movie_path());
- Engine::get_singleton()->set_write_movie_path(String());
- }
- }
- OS::get_singleton()->benchmark_end_measure("Servers", "Rendering");
- }
- #ifdef UNIX_ENABLED
- // Print warning after initializing the renderer but before initializing audio.
- if (OS::get_singleton()->get_environment("USER") == "root" && !OS::get_singleton()->has_environment("GODOT_SILENCE_ROOT_WARNING")) {
- WARN_PRINT("Started the engine as `root`/superuser. This is a security risk, and subsystems like audio may not work correctly.\nSet the environment variable `GODOT_SILENCE_ROOT_WARNING` to 1 to silence this warning.");
- }
- #endif
- /* Initialize Audio Driver */
- {
- OS::get_singleton()->benchmark_begin_measure("Servers", "Audio");
- AudioDriverManager::initialize(audio_driver_idx);
- // Right moment to create and initialize the audio server.
- audio_server = memnew(AudioServer);
- audio_server->init();
- OS::get_singleton()->benchmark_end_measure("Servers", "Audio");
- }
- #ifndef _3D_DISABLED
- /* Initialize XR Server */
- {
- OS::get_singleton()->benchmark_begin_measure("Servers", "XR");
- xr_server = memnew(XRServer);
- OS::get_singleton()->benchmark_end_measure("Servers", "XR");
- }
- #endif // _3D_DISABLED
- OS::get_singleton()->benchmark_end_measure("Startup", "Servers");
- #ifndef WEB_ENABLED
- // Add a blank line for readability.
- Engine::get_singleton()->print_header("");
- #endif // WEB_ENABLED
- register_core_singletons();
- /* Initialize the main window and boot screen */
- {
- OS::get_singleton()->benchmark_begin_measure("Startup", "Setup Window and Boot");
- MAIN_PRINT("Main: Setup Logo");
- if (init_windowed) {
- //do none..
- } else if (init_maximized) {
- DisplayServer::get_singleton()->window_set_mode(DisplayServer::WINDOW_MODE_MAXIMIZED);
- } else if (init_fullscreen) {
- DisplayServer::get_singleton()->window_set_mode(DisplayServer::WINDOW_MODE_FULLSCREEN);
- }
- if (init_always_on_top) {
- DisplayServer::get_singleton()->window_set_flag(DisplayServer::WINDOW_FLAG_ALWAYS_ON_TOP, true);
- }
- Color clear = GLOBAL_DEF_BASIC("rendering/environment/defaults/default_clear_color", Color(0.3, 0.3, 0.3));
- RenderingServer::get_singleton()->set_default_clear_color(clear);
- if (p_show_boot_logo) {
- setup_boot_logo();
- }
- MAIN_PRINT("Main: Clear Color");
- DisplayServer::set_early_window_clear_color_override(false);
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::STRING, "application/config/icon", PROPERTY_HINT_FILE, "*.png,*.webp,*.svg"), String());
- GLOBAL_DEF(PropertyInfo(Variant::STRING, "application/config/macos_native_icon", PROPERTY_HINT_FILE, "*.icns"), String());
- GLOBAL_DEF(PropertyInfo(Variant::STRING, "application/config/windows_native_icon", PROPERTY_HINT_FILE, "*.ico"), String());
- MAIN_PRINT("Main: Touch Input");
- Input *id = Input::get_singleton();
- if (id) {
- bool agile_input_event_flushing = GLOBAL_DEF("input_devices/buffering/agile_event_flushing", false);
- id->set_agile_input_event_flushing(agile_input_event_flushing);
- if (bool(GLOBAL_DEF_BASIC("input_devices/pointing/emulate_touch_from_mouse", false)) &&
- !(editor || project_manager)) {
- if (!DisplayServer::get_singleton()->is_touchscreen_available()) {
- //only if no touchscreen ui hint, set emulation
- id->set_emulate_touch_from_mouse(true);
- }
- }
- id->set_emulate_mouse_from_touch(bool(GLOBAL_DEF_BASIC("input_devices/pointing/emulate_mouse_from_touch", true)));
- }
- GLOBAL_DEF_BASIC("input_devices/pointing/android/enable_long_press_as_right_click", false);
- GLOBAL_DEF_BASIC("input_devices/pointing/android/enable_pan_and_scale_gestures", false);
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::INT, "input_devices/pointing/android/rotary_input_scroll_axis", PROPERTY_HINT_ENUM, "Horizontal,Vertical"), 1);
- OS::get_singleton()->benchmark_end_measure("Startup", "Setup Window and Boot");
- }
- MAIN_PRINT("Main: Load Translations and Remaps");
- /* Setup translations and remaps */
- {
- OS::get_singleton()->benchmark_begin_measure("Startup", "Translations and Remaps");
- translation_server->setup(); //register translations, load them, etc.
- if (!locale.is_empty()) {
- translation_server->set_locale(locale);
- }
- translation_server->load_translations();
- ResourceLoader::load_translation_remaps(); //load remaps for resources
- ResourceLoader::load_path_remaps();
- OS::get_singleton()->benchmark_end_measure("Startup", "Translations and Remaps");
- }
- MAIN_PRINT("Main: Load TextServer");
- /* Setup Text Server */
- {
- OS::get_singleton()->benchmark_begin_measure("Startup", "Text Server");
- /* Enum text drivers */
- GLOBAL_DEF_RST("internationalization/rendering/text_driver", "");
- String text_driver_options;
- for (int i = 0; i < TextServerManager::get_singleton()->get_interface_count(); i++) {
- const String driver_name = TextServerManager::get_singleton()->get_interface(i)->get_name();
- if (driver_name == "Dummy") {
- // Dummy text driver cannot draw any text, making the editor unusable if selected.
- continue;
- }
- if (!text_driver_options.is_empty() && !text_driver_options.contains(",")) {
- // Not the first option; add a comma before it as a separator for the property hint.
- text_driver_options += ",";
- }
- text_driver_options += driver_name;
- }
- ProjectSettings::get_singleton()->set_custom_property_info(PropertyInfo(Variant::STRING, "internationalization/rendering/text_driver", PROPERTY_HINT_ENUM, text_driver_options));
- /* Determine text driver */
- if (text_driver.is_empty()) {
- text_driver = GLOBAL_GET("internationalization/rendering/text_driver");
- }
- if (!text_driver.is_empty()) {
- /* Load user selected text server. */
- for (int i = 0; i < TextServerManager::get_singleton()->get_interface_count(); i++) {
- if (TextServerManager::get_singleton()->get_interface(i)->get_name() == text_driver) {
- text_driver_idx = i;
- break;
- }
- }
- }
- if (text_driver_idx < 0) {
- /* If not selected, use one with the most features available. */
- int max_features = 0;
- for (int i = 0; i < TextServerManager::get_singleton()->get_interface_count(); i++) {
- uint32_t features = TextServerManager::get_singleton()->get_interface(i)->get_features();
- int feature_number = 0;
- while (features) {
- feature_number += features & 1;
- features >>= 1;
- }
- if (feature_number >= max_features) {
- max_features = feature_number;
- text_driver_idx = i;
- }
- }
- }
- if (text_driver_idx >= 0) {
- Ref<TextServer> ts = TextServerManager::get_singleton()->get_interface(text_driver_idx);
- TextServerManager::get_singleton()->set_primary_interface(ts);
- if (ts->has_feature(TextServer::FEATURE_USE_SUPPORT_DATA)) {
- ts->load_support_data("res://" + ts->get_support_data_filename());
- }
- } else {
- ERR_FAIL_V_MSG(ERR_CANT_CREATE, "TextServer: Unable to create TextServer interface.");
- }
- OS::get_singleton()->benchmark_end_measure("Startup", "Text Server");
- }
- MAIN_PRINT("Main: Load Scene Types");
- OS::get_singleton()->benchmark_begin_measure("Startup", "Scene");
- // Initialize ThemeDB early so that scene types can register their theme items.
- // Default theme will be initialized later, after modules and ScriptServer are ready.
- initialize_theme_db();
- register_scene_types();
- register_driver_types();
- register_scene_singletons();
- {
- OS::get_singleton()->benchmark_begin_measure("Scene", "Modules and Extensions");
- initialize_modules(MODULE_INITIALIZATION_LEVEL_SCENE);
- GDExtensionManager::get_singleton()->initialize_extensions(GDExtension::INITIALIZATION_LEVEL_SCENE);
- OS::get_singleton()->benchmark_end_measure("Scene", "Modules and Extensions");
- }
- PackedStringArray extensions;
- extensions.push_back("gd");
- if (ClassDB::class_exists("CSharpScript")) {
- extensions.push_back("cs");
- }
- extensions.push_back("gdshader");
- GLOBAL_DEF_NOVAL(PropertyInfo(Variant::PACKED_STRING_ARRAY, "editor/script/search_in_file_extensions"), extensions); // Note: should be defined after Scene level modules init to see .NET.
- OS::get_singleton()->benchmark_end_measure("Startup", "Scene");
- #ifdef TOOLS_ENABLED
- ClassDB::set_current_api(ClassDB::API_EDITOR);
- register_editor_types();
- {
- OS::get_singleton()->benchmark_begin_measure("Editor", "Modules and Extensions");
- initialize_modules(MODULE_INITIALIZATION_LEVEL_EDITOR);
- GDExtensionManager::get_singleton()->initialize_extensions(GDExtension::INITIALIZATION_LEVEL_EDITOR);
- OS::get_singleton()->benchmark_end_measure("Editor", "Modules and Extensions");
- }
- ClassDB::set_current_api(ClassDB::API_CORE);
- #endif
- MAIN_PRINT("Main: Load Platforms");
- OS::get_singleton()->benchmark_begin_measure("Startup", "Platforms");
- register_platform_apis();
- OS::get_singleton()->benchmark_end_measure("Startup", "Platforms");
- GLOBAL_DEF_BASIC(PropertyInfo(Variant::STRING, "display/mouse_cursor/custom_image", PROPERTY_HINT_FILE, "*.png,*.webp"), String());
- GLOBAL_DEF_BASIC("display/mouse_cursor/custom_image_hotspot", Vector2());
- GLOBAL_DEF_BASIC("display/mouse_cursor/tooltip_position_offset", Point2(10, 10));
- if (String(GLOBAL_GET("display/mouse_cursor/custom_image")) != String()) {
- Ref<Texture2D> cursor = ResourceLoader::load(
- GLOBAL_GET("display/mouse_cursor/custom_image"));
- if (cursor.is_valid()) {
- Vector2 hotspot = GLOBAL_GET("display/mouse_cursor/custom_image_hotspot");
- Input::get_singleton()->set_custom_mouse_cursor(cursor, Input::CURSOR_ARROW, hotspot);
- }
- }
- OS::get_singleton()->benchmark_begin_measure("Startup", "Finalize Setup");
- camera_server = CameraServer::create();
- MAIN_PRINT("Main: Load Physics");
- initialize_physics();
- MAIN_PRINT("Main: Load Navigation");
- initialize_navigation_server();
- register_server_singletons();
- // This loads global classes, so it must happen before custom loaders and savers are registered
- ScriptServer::init_languages();
- theme_db->initialize_theme();
- audio_server->load_default_bus_layout();
- #if defined(MODULE_MONO_ENABLED) && defined(TOOLS_ENABLED)
- // Hacky to have it here, but we don't have good facility yet to let modules
- // register command line options to call at the right time. This needs to happen
- // after init'ing the ScriptServer, but also after init'ing the ThemeDB,
- // for the C# docs generation in the bindings.
- List<String> cmdline_args = OS::get_singleton()->get_cmdline_args();
- BindingsGenerator::handle_cmdline_args(cmdline_args);
- #endif
- if (use_debug_profiler && EngineDebugger::is_active()) {
- // Start the "scripts" profiler, used in local debugging.
- // We could add more, and make the CLI arg require a comma-separated list of profilers.
- EngineDebugger::get_singleton()->profiler_enable("scripts", true);
- }
- if (!project_manager) {
- // If not running the project manager, and now that the engine is
- // able to load resources, load the global shader variables.
- // If running on editor, don't load the textures because the editor
- // may want to import them first. Editor will reload those later.
- rendering_server->global_shader_parameters_load_settings(!editor);
- }
- OS::get_singleton()->benchmark_end_measure("Startup", "Finalize Setup");
- _start_success = true;
- ClassDB::set_current_api(ClassDB::API_NONE); //no more APIs are registered at this point
- print_verbose("CORE API HASH: " + uitos(ClassDB::get_api_hash(ClassDB::API_CORE)));
- print_verbose("EDITOR API HASH: " + uitos(ClassDB::get_api_hash(ClassDB::API_EDITOR)));
- MAIN_PRINT("Main: Done");
- OS::get_singleton()->benchmark_end_measure("Startup", "Main::Setup2");
- return OK;
- }
- void Main::setup_boot_logo() {
- MAIN_PRINT("Main: Load Boot Image");
- #if !defined(TOOLS_ENABLED) && defined(WEB_ENABLED)
- bool show_logo = false;
- #else
- bool show_logo = true;
- #endif
- if (show_logo) { //boot logo!
- const bool boot_logo_image = GLOBAL_DEF_BASIC("application/boot_splash/show_image", true);
- const String boot_logo_path = String(GLOBAL_DEF_BASIC(PropertyInfo(Variant::STRING, "application/boot_splash/image", PROPERTY_HINT_FILE, "*.png"), String())).strip_edges();
- const bool boot_logo_scale = GLOBAL_DEF_BASIC("application/boot_splash/fullsize", true);
- const bool boot_logo_filter = GLOBAL_DEF_BASIC("application/boot_splash/use_filter", true);
- Ref<Image> boot_logo;
- if (boot_logo_image) {
- if (!boot_logo_path.is_empty()) {
- boot_logo.instantiate();
- Error load_err = ImageLoader::load_image(boot_logo_path, boot_logo);
- if (load_err) {
- ERR_PRINT("Non-existing or invalid boot splash at '" + boot_logo_path + "'. Loading default splash.");
- }
- }
- } else {
- // Create a 1×1 transparent image. This will effectively hide the splash image.
- boot_logo.instantiate();
- boot_logo->initialize_data(1, 1, false, Image::FORMAT_RGBA8);
- boot_logo->set_pixel(0, 0, Color(0, 0, 0, 0));
- }
- Color boot_bg_color = GLOBAL_GET("application/boot_splash/bg_color");
- #if defined(TOOLS_ENABLED) && !defined(NO_EDITOR_SPLASH)
- boot_bg_color = GLOBAL_DEF_BASIC("application/boot_splash/bg_color", (editor || project_manager) ? boot_splash_editor_bg_color : boot_splash_bg_color);
- #endif
- if (boot_logo.is_valid()) {
- RenderingServer::get_singleton()->set_boot_image(boot_logo, boot_bg_color, boot_logo_scale, boot_logo_filter);
- } else {
- #ifndef NO_DEFAULT_BOOT_LOGO
- MAIN_PRINT("Main: Create bootsplash");
- #if defined(TOOLS_ENABLED) && !defined(NO_EDITOR_SPLASH)
- Ref<Image> splash = (editor || project_manager) ? memnew(Image(boot_splash_editor_png)) : memnew(Image(boot_splash_png));
- #else
- Ref<Image> splash = memnew(Image(boot_splash_png));
- #endif
- MAIN_PRINT("Main: ClearColor");
- RenderingServer::get_singleton()->set_default_clear_color(boot_bg_color);
- MAIN_PRINT("Main: Image");
- RenderingServer::get_singleton()->set_boot_image(splash, boot_bg_color, false);
- #endif
- }
- #if defined(TOOLS_ENABLED) && defined(MACOS_ENABLED)
- if (DisplayServer::get_singleton()->has_feature(DisplayServer::FEATURE_ICON) && OS::get_singleton()->get_bundle_icon_path().is_empty()) {
- Ref<Image> icon = memnew(Image(app_icon_png));
- DisplayServer::get_singleton()->set_icon(icon);
- }
- #endif
- }
- RenderingServer::get_singleton()->set_default_clear_color(
- GLOBAL_GET("rendering/environment/defaults/default_clear_color"));
- }
- String Main::get_rendering_driver_name() {
- return rendering_driver;
- }
- // everything the main loop needs to know about frame timings
- static MainTimerSync main_timer_sync;
- // Return value should be EXIT_SUCCESS if we start successfully
- // and should move on to `OS::run`, and EXIT_FAILURE otherwise for
- // an early exit with that error code.
- int Main::start() {
- OS::get_singleton()->benchmark_begin_measure("Startup", "Main::Start");
- ERR_FAIL_COND_V(!_start_success, false);
- bool has_icon = false;
- String positional_arg;
- String game_path;
- String script;
- String main_loop_type;
- bool check_only = false;
- #ifdef TOOLS_ENABLED
- String doc_tool_path;
- bool doc_tool_implicit_cwd = false;
- BitField<DocTools::GenerateFlags> gen_flags;
- String _export_preset;
- bool export_debug = false;
- bool export_pack_only = false;
- bool install_android_build_template = false;
- #ifdef MODULE_GDSCRIPT_ENABLED
- String gdscript_docs_path;
- #endif
- #ifndef DISABLE_DEPRECATED
- bool converting_project = false;
- bool validating_converting_project = false;
- #endif // DISABLE_DEPRECATED
- #endif // TOOLS_ENABLED
- main_timer_sync.init(OS::get_singleton()->get_ticks_usec());
- List<String> args = OS::get_singleton()->get_cmdline_args();
- for (List<String>::Element *E = args.front(); E; E = E->next()) {
- // First check parameters that do not have an argument to the right.
- // Doctest Unit Testing Handler
- // Designed to override and pass arguments to the unit test handler.
- if (E->get() == "--check-only") {
- check_only = true;
- #ifdef TOOLS_ENABLED
- } else if (E->get() == "--no-docbase") {
- gen_flags.set_flag(DocTools::GENERATE_FLAG_SKIP_BASIC_TYPES);
- } else if (E->get() == "--gdextension-docs") {
- gen_flags.set_flag(DocTools::GENERATE_FLAG_SKIP_BASIC_TYPES);
- gen_flags.set_flag(DocTools::GENERATE_FLAG_EXTENSION_CLASSES_ONLY);
- #ifndef DISABLE_DEPRECATED
- } else if (E->get() == "--convert-3to4") {
- converting_project = true;
- } else if (E->get() == "--validate-conversion-3to4") {
- validating_converting_project = true;
- #endif // DISABLE_DEPRECATED
- } else if (E->get() == "-e" || E->get() == "--editor") {
- editor = true;
- } else if (E->get() == "-p" || E->get() == "--project-manager") {
- project_manager = true;
- } else if (E->get() == "--install-android-build-template") {
- install_android_build_template = true;
- #endif // TOOLS_ENABLED
- } else if (E->get().length() && E->get()[0] != '-' && positional_arg.is_empty()) {
- positional_arg = E->get();
- if (E->get().ends_with(".scn") ||
- E->get().ends_with(".tscn") ||
- E->get().ends_with(".escn") ||
- E->get().ends_with(".res") ||
- E->get().ends_with(".tres")) {
- // Only consider the positional argument to be a scene path if it ends with
- // a file extension associated with Godot scenes. This makes it possible
- // for projects to parse command-line arguments for custom CLI arguments
- // or other file extensions without trouble. This can be used to implement
- // "drag-and-drop onto executable" logic, which can prove helpful
- // for non-game applications.
- game_path = E->get();
- }
- }
- // Then parameters that have an argument to the right.
- else if (E->next()) {
- bool parsed_pair = true;
- if (E->get() == "-s" || E->get() == "--script") {
- script = E->next()->get();
- } else if (E->get() == "--main-loop") {
- main_loop_type = E->next()->get();
- #ifdef TOOLS_ENABLED
- } else if (E->get() == "--doctool") {
- doc_tool_path = E->next()->get();
- if (doc_tool_path.begins_with("-")) {
- // Assuming other command line arg, so default to cwd.
- doc_tool_path = ".";
- doc_tool_implicit_cwd = true;
- parsed_pair = false;
- }
- #ifdef MODULE_GDSCRIPT_ENABLED
- } else if (E->get() == "--gdscript-docs") {
- gdscript_docs_path = E->next()->get();
- #endif
- } else if (E->get() == "--export-release") {
- ERR_FAIL_COND_V_MSG(!editor && !found_project, EXIT_FAILURE, "Please provide a valid project path when exporting, aborting.");
- editor = true; //needs editor
- _export_preset = E->next()->get();
- } else if (E->get() == "--export-debug") {
- ERR_FAIL_COND_V_MSG(!editor && !found_project, EXIT_FAILURE, "Please provide a valid project path when exporting, aborting.");
- editor = true; //needs editor
- _export_preset = E->next()->get();
- export_debug = true;
- } else if (E->get() == "--export-pack") {
- ERR_FAIL_COND_V_MSG(!editor && !found_project, EXIT_FAILURE, "Please provide a valid project path when exporting, aborting.");
- editor = true;
- _export_preset = E->next()->get();
- export_pack_only = true;
- #endif
- } else {
- // The parameter does not match anything known, don't skip the next argument
- parsed_pair = false;
- }
- if (parsed_pair) {
- E = E->next();
- }
- } else if (E->get().begins_with("--export-")) {
- ERR_FAIL_V_MSG(EXIT_FAILURE, "Missing export preset name, aborting.");
- }
- #ifdef TOOLS_ENABLED
- // Handle case where no path is given to --doctool.
- else if (E->get() == "--doctool") {
- doc_tool_path = ".";
- doc_tool_implicit_cwd = true;
- }
- #endif
- }
- uint64_t minimum_time_msec = GLOBAL_DEF(PropertyInfo(Variant::INT, "application/boot_splash/minimum_display_time", PROPERTY_HINT_RANGE, "0,100,1,or_greater,suffix:ms"), 0);
- if (Engine::get_singleton()->is_editor_hint()) {
- minimum_time_msec = 0;
- }
- #ifdef TOOLS_ENABLED
- #ifdef MODULE_GDSCRIPT_ENABLED
- if (!doc_tool_path.is_empty() && gdscript_docs_path.is_empty()) {
- #else
- if (!doc_tool_path.is_empty()) {
- #endif
- // Needed to instance editor-only classes for their default values
- Engine::get_singleton()->set_editor_hint(true);
- // Translate the class reference only when `-l LOCALE` parameter is given.
- if (!locale.is_empty() && locale != "en") {
- load_doc_translations(locale);
- }
- {
- Ref<DirAccess> da = DirAccess::open(doc_tool_path);
- ERR_FAIL_COND_V_MSG(da.is_null(), EXIT_FAILURE, "Argument supplied to --doctool must be a valid directory path.");
- // Ensure that doctool is running in the root dir, but only if
- // user did not manually specify a path as argument.
- if (doc_tool_implicit_cwd) {
- ERR_FAIL_COND_V_MSG(!da->dir_exists("doc"), EXIT_FAILURE, "--doctool must be run from the Godot repository's root folder, or specify a path that points there.");
- }
- }
- #ifndef MODULE_MONO_ENABLED
- // Hack to define .NET-specific project settings even on non-.NET builds,
- // so that we don't lose their descriptions and default values in DocTools.
- // Default values should be synced with mono_gd/gd_mono.cpp.
- GLOBAL_DEF("dotnet/project/assembly_name", "");
- GLOBAL_DEF("dotnet/project/solution_directory", "");
- GLOBAL_DEF(PropertyInfo(Variant::INT, "dotnet/project/assembly_reload_attempts", PROPERTY_HINT_RANGE, "1,16,1,or_greater"), 3);
- #endif
- Error err;
- DocTools doc;
- doc.generate(gen_flags);
- DocTools docsrc;
- HashMap<String, String> doc_data_classes;
- HashSet<String> checked_paths;
- print_line("Loading docs...");
- const bool gdextension_docs = gen_flags.has_flag(DocTools::GENERATE_FLAG_EXTENSION_CLASSES_ONLY);
- if (!gdextension_docs) {
- for (int i = 0; i < _doc_data_class_path_count; i++) {
- // Custom modules are always located by absolute path.
- String path = _doc_data_class_paths[i].path;
- if (path.is_relative_path()) {
- path = doc_tool_path.path_join(path);
- }
- String name = _doc_data_class_paths[i].name;
- doc_data_classes[name] = path;
- if (!checked_paths.has(path)) {
- checked_paths.insert(path);
- // Create the module documentation directory if it doesn't exist
- Ref<DirAccess> da = DirAccess::create_for_path(path);
- err = da->make_dir_recursive(path);
- ERR_FAIL_COND_V_MSG(err != OK, EXIT_FAILURE, "Error: Can't create directory: " + path + ": " + itos(err));
- print_line("Loading docs from: " + path);
- err = docsrc.load_classes(path);
- ERR_FAIL_COND_V_MSG(err != OK, EXIT_FAILURE, "Error loading docs from: " + path + ": " + itos(err));
- }
- }
- }
- // For GDExtension docs, use a path that is compatible with Godot modules.
- String index_path = gdextension_docs ? doc_tool_path.path_join("doc_classes") : doc_tool_path.path_join("doc/classes");
- // Create the main documentation directory if it doesn't exist
- Ref<DirAccess> da = DirAccess::create_for_path(index_path);
- err = da->make_dir_recursive(index_path);
- ERR_FAIL_COND_V_MSG(err != OK, EXIT_FAILURE, "Error: Can't create index directory: " + index_path + ": " + itos(err));
- print_line("Loading classes from: " + index_path);
- err = docsrc.load_classes(index_path);
- ERR_FAIL_COND_V_MSG(err != OK, EXIT_FAILURE, "Error loading classes from: " + index_path + ": " + itos(err));
- checked_paths.insert(index_path);
- print_line("Merging docs...");
- doc.merge_from(docsrc);
- for (const String &E : checked_paths) {
- print_line("Erasing old docs at: " + E);
- err = DocTools::erase_classes(E);
- ERR_FAIL_COND_V_MSG(err != OK, EXIT_FAILURE, "Error erasing old docs at: " + E + ": " + itos(err));
- }
- print_line("Generating new docs...");
- err = doc.save_classes(index_path, doc_data_classes, !gdextension_docs);
- ERR_FAIL_COND_V_MSG(err != OK, EXIT_FAILURE, "Error saving new docs:" + itos(err));
- print_line("Deleting docs cache...");
- if (FileAccess::exists(EditorHelp::get_cache_full_path())) {
- DirAccess::remove_file_or_error(EditorHelp::get_cache_full_path());
- }
- return EXIT_SUCCESS;
- }
- // GDExtension API and interface.
- {
- if (dump_gdextension_interface) {
- GDExtensionInterfaceDump::generate_gdextension_interface_file("gdextension_interface.h");
- }
- if (dump_extension_api) {
- Engine::get_singleton()->set_editor_hint(true); // "extension_api.json" should always contains editor singletons.
- GDExtensionAPIDump::generate_extension_json_file("extension_api.json", include_docs_in_extension_api_dump);
- }
- if (dump_gdextension_interface || dump_extension_api) {
- return EXIT_SUCCESS;
- }
- if (validate_extension_api) {
- Engine::get_singleton()->set_editor_hint(true); // "extension_api.json" should always contains editor singletons.
- bool valid = GDExtensionAPIDump::validate_extension_json_file(validate_extension_api_file) == OK;
- return valid ? EXIT_SUCCESS : EXIT_FAILURE;
- }
- }
- #ifndef DISABLE_DEPRECATED
- if (converting_project) {
- int ret = ProjectConverter3To4(converter_max_kb_file, converter_max_line_length).convert();
- return ret ? EXIT_SUCCESS : EXIT_FAILURE;
- }
- if (validating_converting_project) {
- bool ret = ProjectConverter3To4(converter_max_kb_file, converter_max_line_length).validate_conversion();
- return ret ? EXIT_SUCCESS : EXIT_FAILURE;
- }
- #endif // DISABLE_DEPRECATED
- #endif // TOOLS_ENABLED
- if (script.is_empty() && game_path.is_empty() && String(GLOBAL_GET("application/run/main_scene")) != "") {
- game_path = GLOBAL_GET("application/run/main_scene");
- }
- #ifdef TOOLS_ENABLED
- if (!editor && !project_manager && !cmdline_tool && script.is_empty() && game_path.is_empty()) {
- // If we end up here, it means we didn't manage to detect what we want to run.
- // Let's throw an error gently. The code leading to this is pretty brittle so
- // this might end up triggered by valid usage, in which case we'll have to
- // fine-tune further.
- OS::get_singleton()->alert("Couldn't detect whether to run the editor, the project manager or a specific project. Aborting.");
- ERR_FAIL_V_MSG(EXIT_FAILURE, "Couldn't detect whether to run the editor, the project manager or a specific project. Aborting.");
- }
- #endif
- MainLoop *main_loop = nullptr;
- if (editor) {
- main_loop = memnew(SceneTree);
- }
- if (main_loop_type.is_empty()) {
- main_loop_type = GLOBAL_GET("application/run/main_loop_type");
- }
- if (!script.is_empty()) {
- Ref<Script> script_res = ResourceLoader::load(script);
- ERR_FAIL_COND_V_MSG(script_res.is_null(), EXIT_FAILURE, "Can't load script: " + script);
- if (check_only) {
- return script_res->is_valid() ? EXIT_SUCCESS : EXIT_FAILURE;
- }
- if (script_res->can_instantiate()) {
- StringName instance_type = script_res->get_instance_base_type();
- Object *obj = ClassDB::instantiate(instance_type);
- MainLoop *script_loop = Object::cast_to<MainLoop>(obj);
- if (!script_loop) {
- if (obj) {
- memdelete(obj);
- }
- OS::get_singleton()->alert(vformat("Can't load the script \"%s\" as it doesn't inherit from SceneTree or MainLoop.", script));
- ERR_FAIL_V_MSG(EXIT_FAILURE, vformat("Can't load the script \"%s\" as it doesn't inherit from SceneTree or MainLoop.", script));
- }
- script_loop->set_script(script_res);
- main_loop = script_loop;
- } else {
- return EXIT_FAILURE;
- }
- } else { // Not based on script path.
- if (!editor && !ClassDB::class_exists(main_loop_type) && ScriptServer::is_global_class(main_loop_type)) {
- String script_path = ScriptServer::get_global_class_path(main_loop_type);
- Ref<Script> script_res = ResourceLoader::load(script_path);
- if (script_res.is_null()) {
- OS::get_singleton()->alert("Error: Could not load MainLoop script type: " + main_loop_type);
- ERR_FAIL_V_MSG(EXIT_FAILURE, vformat("Could not load global class %s.", main_loop_type));
- }
- StringName script_base = script_res->get_instance_base_type();
- Object *obj = ClassDB::instantiate(script_base);
- MainLoop *script_loop = Object::cast_to<MainLoop>(obj);
- if (!script_loop) {
- if (obj) {
- memdelete(obj);
- }
- OS::get_singleton()->alert("Error: Invalid MainLoop script base type: " + script_base);
- ERR_FAIL_V_MSG(EXIT_FAILURE, vformat("The global class %s does not inherit from SceneTree or MainLoop.", main_loop_type));
- }
- script_loop->set_script(script_res);
- main_loop = script_loop;
- }
- }
- if (!main_loop && main_loop_type.is_empty()) {
- main_loop_type = "SceneTree";
- }
- if (!main_loop) {
- if (!ClassDB::class_exists(main_loop_type)) {
- OS::get_singleton()->alert("Error: MainLoop type doesn't exist: " + main_loop_type);
- return EXIT_FAILURE;
- } else {
- Object *ml = ClassDB::instantiate(main_loop_type);
- ERR_FAIL_NULL_V_MSG(ml, EXIT_FAILURE, "Can't instance MainLoop type.");
- main_loop = Object::cast_to<MainLoop>(ml);
- if (!main_loop) {
- memdelete(ml);
- ERR_FAIL_V_MSG(EXIT_FAILURE, "Invalid MainLoop type.");
- }
- }
- }
- OS::get_singleton()->set_main_loop(main_loop);
- SceneTree *sml = Object::cast_to<SceneTree>(main_loop);
- if (sml) {
- #ifdef DEBUG_ENABLED
- if (debug_collisions) {
- sml->set_debug_collisions_hint(true);
- }
- if (debug_paths) {
- sml->set_debug_paths_hint(true);
- }
- if (debug_navigation) {
- sml->set_debug_navigation_hint(true);
- NavigationServer3D::get_singleton()->set_debug_navigation_enabled(true);
- }
- if (debug_avoidance) {
- NavigationServer3D::get_singleton()->set_debug_avoidance_enabled(true);
- }
- if (debug_navigation || debug_avoidance) {
- NavigationServer3D::get_singleton()->set_active(true);
- NavigationServer3D::get_singleton()->set_debug_enabled(true);
- }
- if (debug_canvas_item_redraw) {
- RenderingServer::get_singleton()->canvas_item_set_debug_redraw(true);
- }
- #endif
- if (single_threaded_scene) {
- sml->set_disable_node_threading(true);
- }
- bool embed_subwindows = GLOBAL_GET("display/window/subwindows/embed_subwindows");
- if (single_window || (!project_manager && !editor && embed_subwindows) || !DisplayServer::get_singleton()->has_feature(DisplayServer::Feature::FEATURE_SUBWINDOWS)) {
- sml->get_root()->set_embedding_subwindows(true);
- }
- ResourceLoader::add_custom_loaders();
- ResourceSaver::add_custom_savers();
- if (!project_manager && !editor) { // game
- if (!game_path.is_empty() || !script.is_empty()) {
- //autoload
- OS::get_singleton()->benchmark_begin_measure("Startup", "Load Autoloads");
- HashMap<StringName, ProjectSettings::AutoloadInfo> autoloads = ProjectSettings::get_singleton()->get_autoload_list();
- //first pass, add the constants so they exist before any script is loaded
- for (const KeyValue<StringName, ProjectSettings::AutoloadInfo> &E : autoloads) {
- const ProjectSettings::AutoloadInfo &info = E.value;
- if (info.is_singleton) {
- for (int i = 0; i < ScriptServer::get_language_count(); i++) {
- ScriptServer::get_language(i)->add_global_constant(info.name, Variant());
- }
- }
- }
- //second pass, load into global constants
- List<Node *> to_add;
- for (const KeyValue<StringName, ProjectSettings::AutoloadInfo> &E : autoloads) {
- const ProjectSettings::AutoloadInfo &info = E.value;
- Node *n = nullptr;
- if (ResourceLoader::get_resource_type(info.path) == "PackedScene") {
- // Cache the scene reference before loading it (for cyclic references)
- Ref<PackedScene> scn;
- scn.instantiate();
- scn->set_path(info.path);
- scn->reload_from_file();
- ERR_CONTINUE_MSG(!scn.is_valid(), vformat("Failed to instantiate an autoload, can't load from path: %s.", info.path));
- if (scn.is_valid()) {
- n = scn->instantiate();
- }
- } else {
- Ref<Resource> res = ResourceLoader::load(info.path);
- ERR_CONTINUE_MSG(res.is_null(), vformat("Failed to instantiate an autoload, can't load from path: %s.", info.path));
- Ref<Script> script_res = res;
- if (script_res.is_valid()) {
- StringName ibt = script_res->get_instance_base_type();
- bool valid_type = ClassDB::is_parent_class(ibt, "Node");
- ERR_CONTINUE_MSG(!valid_type, vformat("Failed to instantiate an autoload, script '%s' does not inherit from 'Node'.", info.path));
- Object *obj = ClassDB::instantiate(ibt);
- ERR_CONTINUE_MSG(!obj, vformat("Failed to instantiate an autoload, cannot instantiate '%s'.", ibt));
- n = Object::cast_to<Node>(obj);
- n->set_script(script_res);
- }
- }
- ERR_CONTINUE_MSG(!n, vformat("Failed to instantiate an autoload, path is not pointing to a scene or a script: %s.", info.path));
- n->set_name(info.name);
- //defer so references are all valid on _ready()
- to_add.push_back(n);
- if (info.is_singleton) {
- for (int i = 0; i < ScriptServer::get_language_count(); i++) {
- ScriptServer::get_language(i)->add_global_constant(info.name, n);
- }
- }
- }
- for (Node *E : to_add) {
- sml->get_root()->add_child(E);
- }
- OS::get_singleton()->benchmark_end_measure("Startup", "Load Autoloads");
- }
- }
- #ifdef TOOLS_ENABLED
- #ifdef MODULE_GDSCRIPT_ENABLED
- if (!doc_tool_path.is_empty() && !gdscript_docs_path.is_empty()) {
- DocTools docs;
- Error err;
- Vector<String> paths = get_files_with_extension(gdscript_docs_path, "gd");
- ERR_FAIL_COND_V_MSG(paths.is_empty(), EXIT_FAILURE, "Couldn't find any GDScript files under the given directory: " + gdscript_docs_path);
- for (const String &path : paths) {
- Ref<GDScript> gdscript = ResourceLoader::load(path);
- for (const DocData::ClassDoc &class_doc : gdscript->get_documentation()) {
- docs.add_doc(class_doc);
- }
- }
- if (doc_tool_implicit_cwd) {
- doc_tool_path = "./docs";
- }
- Ref<DirAccess> da = DirAccess::create_for_path(doc_tool_path);
- err = da->make_dir_recursive(doc_tool_path);
- ERR_FAIL_COND_V_MSG(err != OK, EXIT_FAILURE, "Error: Can't create GDScript docs directory: " + doc_tool_path + ": " + itos(err));
- HashMap<String, String> doc_data_classes;
- err = docs.save_classes(doc_tool_path, doc_data_classes, false);
- ERR_FAIL_COND_V_MSG(err != OK, EXIT_FAILURE, "Error saving GDScript docs:" + itos(err));
- return EXIT_SUCCESS;
- }
- #endif // MODULE_GDSCRIPT_ENABLED
- EditorNode *editor_node = nullptr;
- if (editor) {
- OS::get_singleton()->benchmark_begin_measure("Startup", "Editor");
- editor_node = memnew(EditorNode);
- sml->get_root()->add_child(editor_node);
- if (!_export_preset.is_empty()) {
- editor_node->export_preset(_export_preset, positional_arg, export_debug, export_pack_only, install_android_build_template);
- game_path = ""; // Do not load anything.
- }
- OS::get_singleton()->benchmark_end_measure("Startup", "Editor");
- }
- #endif
- sml->set_auto_accept_quit(GLOBAL_GET("application/config/auto_accept_quit"));
- sml->set_quit_on_go_back(GLOBAL_GET("application/config/quit_on_go_back"));
- if (!editor && !project_manager) {
- //standard helpers that can be changed from main config
- String stretch_mode = GLOBAL_GET("display/window/stretch/mode");
- String stretch_aspect = GLOBAL_GET("display/window/stretch/aspect");
- Size2i stretch_size = Size2i(GLOBAL_GET("display/window/size/viewport_width"),
- GLOBAL_GET("display/window/size/viewport_height"));
- real_t stretch_scale = GLOBAL_GET("display/window/stretch/scale");
- String stretch_scale_mode = GLOBAL_GET("display/window/stretch/scale_mode");
- Window::ContentScaleMode cs_sm = Window::CONTENT_SCALE_MODE_DISABLED;
- if (stretch_mode == "canvas_items") {
- cs_sm = Window::CONTENT_SCALE_MODE_CANVAS_ITEMS;
- } else if (stretch_mode == "viewport") {
- cs_sm = Window::CONTENT_SCALE_MODE_VIEWPORT;
- }
- Window::ContentScaleAspect cs_aspect = Window::CONTENT_SCALE_ASPECT_IGNORE;
- if (stretch_aspect == "keep") {
- cs_aspect = Window::CONTENT_SCALE_ASPECT_KEEP;
- } else if (stretch_aspect == "keep_width") {
- cs_aspect = Window::CONTENT_SCALE_ASPECT_KEEP_WIDTH;
- } else if (stretch_aspect == "keep_height") {
- cs_aspect = Window::CONTENT_SCALE_ASPECT_KEEP_HEIGHT;
- } else if (stretch_aspect == "expand") {
- cs_aspect = Window::CONTENT_SCALE_ASPECT_EXPAND;
- }
- Window::ContentScaleStretch cs_stretch = Window::CONTENT_SCALE_STRETCH_FRACTIONAL;
- if (stretch_scale_mode == "integer") {
- cs_stretch = Window::CONTENT_SCALE_STRETCH_INTEGER;
- }
- sml->get_root()->set_content_scale_mode(cs_sm);
- sml->get_root()->set_content_scale_aspect(cs_aspect);
- sml->get_root()->set_content_scale_stretch(cs_stretch);
- sml->get_root()->set_content_scale_size(stretch_size);
- sml->get_root()->set_content_scale_factor(stretch_scale);
- sml->set_auto_accept_quit(GLOBAL_GET("application/config/auto_accept_quit"));
- sml->set_quit_on_go_back(GLOBAL_GET("application/config/quit_on_go_back"));
- String appname = GLOBAL_GET("application/config/name");
- appname = TranslationServer::get_singleton()->translate(appname);
- #ifdef DEBUG_ENABLED
- // Append a suffix to the window title to denote that the project is running
- // from a debug build (including the editor). Since this results in lower performance,
- // this should be clearly presented to the user.
- DisplayServer::get_singleton()->window_set_title(vformat("%s (DEBUG)", appname));
- #else
- DisplayServer::get_singleton()->window_set_title(appname);
- #endif
- bool snap_controls = GLOBAL_GET("gui/common/snap_controls_to_pixels");
- sml->get_root()->set_snap_controls_to_pixels(snap_controls);
- bool font_oversampling = GLOBAL_GET("gui/fonts/dynamic_fonts/use_oversampling");
- sml->get_root()->set_use_font_oversampling(font_oversampling);
- int texture_filter = GLOBAL_GET("rendering/textures/canvas_textures/default_texture_filter");
- int texture_repeat = GLOBAL_GET("rendering/textures/canvas_textures/default_texture_repeat");
- sml->get_root()->set_default_canvas_item_texture_filter(
- Viewport::DefaultCanvasItemTextureFilter(texture_filter));
- sml->get_root()->set_default_canvas_item_texture_repeat(
- Viewport::DefaultCanvasItemTextureRepeat(texture_repeat));
- }
- #ifdef TOOLS_ENABLED
- if (editor) {
- bool editor_embed_subwindows = EditorSettings::get_singleton()->get_setting(
- "interface/editor/single_window_mode");
- if (editor_embed_subwindows) {
- sml->get_root()->set_embedding_subwindows(true);
- }
- }
- #endif
- String local_game_path;
- if (!game_path.is_empty() && !project_manager) {
- local_game_path = game_path.replace("\\", "/");
- if (!local_game_path.begins_with("res://")) {
- bool absolute =
- (local_game_path.size() > 1) && (local_game_path[0] == '/' || local_game_path[1] == ':');
- if (!absolute) {
- if (ProjectSettings::get_singleton()->is_using_datapack()) {
- local_game_path = "res://" + local_game_path;
- } else {
- int sep = local_game_path.rfind("/");
- if (sep == -1) {
- Ref<DirAccess> da = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
- ERR_FAIL_COND_V(da.is_null(), EXIT_FAILURE);
- local_game_path = da->get_current_dir().path_join(local_game_path);
- } else {
- Ref<DirAccess> da = DirAccess::open(local_game_path.substr(0, sep));
- if (da.is_valid()) {
- local_game_path = da->get_current_dir().path_join(
- local_game_path.substr(sep + 1, local_game_path.length()));
- }
- }
- }
- }
- }
- local_game_path = ProjectSettings::get_singleton()->localize_path(local_game_path);
- #ifdef TOOLS_ENABLED
- if (editor) {
- if (game_path != String(GLOBAL_GET("application/run/main_scene")) || !editor_node->has_scenes_in_session()) {
- Error serr = editor_node->load_scene(local_game_path);
- if (serr != OK) {
- ERR_PRINT("Failed to load scene");
- }
- }
- if (!debug_server_uri.is_empty()) {
- EditorDebuggerNode::get_singleton()->start(debug_server_uri);
- EditorDebuggerNode::get_singleton()->set_keep_open(true);
- }
- }
- #endif
- }
- if (!project_manager && !editor) { // game
- OS::get_singleton()->benchmark_begin_measure("Startup", "Load Game");
- // Load SSL Certificates from Project Settings (or builtin).
- Crypto::load_default_certificates(GLOBAL_GET("network/tls/certificate_bundle_override"));
- if (!game_path.is_empty()) {
- Node *scene = nullptr;
- Ref<PackedScene> scenedata = ResourceLoader::load(local_game_path);
- if (scenedata.is_valid()) {
- scene = scenedata->instantiate();
- }
- ERR_FAIL_NULL_V_MSG(scene, EXIT_FAILURE, "Failed loading scene: " + local_game_path + ".");
- sml->add_current_scene(scene);
- #ifdef MACOS_ENABLED
- String mac_icon_path = GLOBAL_GET("application/config/macos_native_icon");
- if (DisplayServer::get_singleton()->has_feature(DisplayServer::FEATURE_NATIVE_ICON) && !mac_icon_path.is_empty()) {
- DisplayServer::get_singleton()->set_native_icon(mac_icon_path);
- has_icon = true;
- }
- #endif
- #ifdef WINDOWS_ENABLED
- String win_icon_path = GLOBAL_GET("application/config/windows_native_icon");
- if (DisplayServer::get_singleton()->has_feature(DisplayServer::FEATURE_NATIVE_ICON) && !win_icon_path.is_empty()) {
- DisplayServer::get_singleton()->set_native_icon(win_icon_path);
- has_icon = true;
- }
- #endif
- String icon_path = GLOBAL_GET("application/config/icon");
- if (DisplayServer::get_singleton()->has_feature(DisplayServer::FEATURE_ICON) && !icon_path.is_empty() && !has_icon) {
- Ref<Image> icon;
- icon.instantiate();
- if (ImageLoader::load_image(icon_path, icon) == OK) {
- DisplayServer::get_singleton()->set_icon(icon);
- has_icon = true;
- }
- }
- }
- OS::get_singleton()->benchmark_end_measure("Startup", "Load Game");
- }
- #ifdef TOOLS_ENABLED
- if (project_manager) {
- OS::get_singleton()->benchmark_begin_measure("Startup", "Project Manager");
- Engine::get_singleton()->set_editor_hint(true);
- ProjectManager *pmanager = memnew(ProjectManager);
- ProgressDialog *progress_dialog = memnew(ProgressDialog);
- pmanager->add_child(progress_dialog);
- sml->get_root()->add_child(pmanager);
- OS::get_singleton()->benchmark_end_measure("Startup", "Project Manager");
- }
- if (project_manager || editor) {
- // Load SSL Certificates from Editor Settings (or builtin)
- Crypto::load_default_certificates(
- EditorSettings::get_singleton()->get_setting("network/tls/editor_tls_certificates").operator String());
- }
- #endif
- }
- if (DisplayServer::get_singleton()->has_feature(DisplayServer::FEATURE_ICON) && !has_icon && OS::get_singleton()->get_bundle_icon_path().is_empty()) {
- Ref<Image> icon = memnew(Image(app_icon_png));
- DisplayServer::get_singleton()->set_icon(icon);
- }
- if (movie_writer) {
- movie_writer->begin(DisplayServer::get_singleton()->window_get_size(), fixed_fps, Engine::get_singleton()->get_write_movie_path());
- }
- if (minimum_time_msec) {
- uint64_t minimum_time = 1000 * minimum_time_msec;
- uint64_t elapsed_time = OS::get_singleton()->get_ticks_usec();
- if (elapsed_time < minimum_time) {
- OS::get_singleton()->delay_usec(minimum_time - elapsed_time);
- }
- }
- OS::get_singleton()->benchmark_end_measure("Startup", "Main::Start");
- OS::get_singleton()->benchmark_dump();
- return EXIT_SUCCESS;
- }
- /* Main iteration
- *
- * This is the iteration of the engine's game loop, advancing the state of physics,
- * rendering and audio.
- * It's called directly by the platform's OS::run method, where the loop is created
- * and monitored.
- *
- * The OS implementation can impact its draw step with the Main::force_redraw() method.
- */
- uint64_t Main::last_ticks = 0;
- uint32_t Main::frames = 0;
- uint32_t Main::hide_print_fps_attempts = 3;
- uint32_t Main::frame = 0;
- bool Main::force_redraw_requested = false;
- int Main::iterating = 0;
- bool Main::is_iterating() {
- return iterating > 0;
- }
- // For performance metrics.
- static uint64_t physics_process_max = 0;
- static uint64_t process_max = 0;
- static uint64_t navigation_process_max = 0;
- // Return false means iterating further, returning true means `OS::run`
- // will terminate the program. In case of failure, the OS exit code needs
- // to be set explicitly here (defaults to EXIT_SUCCESS).
- bool Main::iteration() {
- iterating++;
- const uint64_t ticks = OS::get_singleton()->get_ticks_usec();
- Engine::get_singleton()->_frame_ticks = ticks;
- main_timer_sync.set_cpu_ticks_usec(ticks);
- main_timer_sync.set_fixed_fps(fixed_fps);
- const uint64_t ticks_elapsed = ticks - last_ticks;
- const int physics_ticks_per_second = Engine::get_singleton()->get_physics_ticks_per_second();
- const double physics_step = 1.0 / physics_ticks_per_second;
- const double time_scale = Engine::get_singleton()->get_time_scale();
- MainFrameTime advance = main_timer_sync.advance(physics_step, physics_ticks_per_second);
- double process_step = advance.process_step;
- double scaled_step = process_step * time_scale;
- Engine::get_singleton()->_process_step = process_step;
- Engine::get_singleton()->_physics_interpolation_fraction = advance.interpolation_fraction;
- uint64_t physics_process_ticks = 0;
- uint64_t process_ticks = 0;
- uint64_t navigation_process_ticks = 0;
- frame += ticks_elapsed;
- last_ticks = ticks;
- const int max_physics_steps = Engine::get_singleton()->get_max_physics_steps_per_frame();
- if (fixed_fps == -1 && advance.physics_steps > max_physics_steps) {
- process_step -= (advance.physics_steps - max_physics_steps) * physics_step;
- advance.physics_steps = max_physics_steps;
- }
- bool exit = false;
- // process all our active interfaces
- #ifndef _3D_DISABLED
- XRServer::get_singleton()->_process();
- #endif // _3D_DISABLED
- NavigationServer2D::get_singleton()->sync();
- NavigationServer3D::get_singleton()->sync();
- for (int iters = 0; iters < advance.physics_steps; ++iters) {
- if (Input::get_singleton()->is_agile_input_event_flushing()) {
- Input::get_singleton()->flush_buffered_events();
- }
- Engine::get_singleton()->_in_physics = true;
- Engine::get_singleton()->_physics_frames++;
- uint64_t physics_begin = OS::get_singleton()->get_ticks_usec();
- #ifndef _3D_DISABLED
- PhysicsServer3D::get_singleton()->sync();
- PhysicsServer3D::get_singleton()->flush_queries();
- #endif // _3D_DISABLED
- // Prepare the fixed timestep interpolated nodes BEFORE they are updated
- // by the physics server, otherwise the current and previous transforms
- // may be the same, and no interpolation takes place.
- OS::get_singleton()->get_main_loop()->iteration_prepare();
- PhysicsServer2D::get_singleton()->sync();
- PhysicsServer2D::get_singleton()->flush_queries();
- if (OS::get_singleton()->get_main_loop()->physics_process(physics_step * time_scale)) {
- #ifndef _3D_DISABLED
- PhysicsServer3D::get_singleton()->end_sync();
- #endif // _3D_DISABLED
- PhysicsServer2D::get_singleton()->end_sync();
- exit = true;
- break;
- }
- uint64_t navigation_begin = OS::get_singleton()->get_ticks_usec();
- NavigationServer3D::get_singleton()->process(physics_step * time_scale);
- navigation_process_ticks = MAX(navigation_process_ticks, OS::get_singleton()->get_ticks_usec() - navigation_begin); // keep the largest one for reference
- navigation_process_max = MAX(OS::get_singleton()->get_ticks_usec() - navigation_begin, navigation_process_max);
- message_queue->flush();
- #ifndef _3D_DISABLED
- PhysicsServer3D::get_singleton()->end_sync();
- PhysicsServer3D::get_singleton()->step(physics_step * time_scale);
- #endif // _3D_DISABLED
- PhysicsServer2D::get_singleton()->end_sync();
- PhysicsServer2D::get_singleton()->step(physics_step * time_scale);
- message_queue->flush();
- physics_process_ticks = MAX(physics_process_ticks, OS::get_singleton()->get_ticks_usec() - physics_begin); // keep the largest one for reference
- physics_process_max = MAX(OS::get_singleton()->get_ticks_usec() - physics_begin, physics_process_max);
- Engine::get_singleton()->_in_physics = false;
- }
- if (Input::get_singleton()->is_agile_input_event_flushing()) {
- Input::get_singleton()->flush_buffered_events();
- }
- uint64_t process_begin = OS::get_singleton()->get_ticks_usec();
- if (OS::get_singleton()->get_main_loop()->process(process_step * time_scale)) {
- exit = true;
- }
- message_queue->flush();
- RenderingServer::get_singleton()->sync(); //sync if still drawing from previous frames.
- if ((DisplayServer::get_singleton()->can_any_window_draw() || DisplayServer::get_singleton()->has_additional_outputs()) &&
- RenderingServer::get_singleton()->is_render_loop_enabled()) {
- if ((!force_redraw_requested) && OS::get_singleton()->is_in_low_processor_usage_mode()) {
- if (RenderingServer::get_singleton()->has_changed()) {
- RenderingServer::get_singleton()->draw(true, scaled_step); // flush visual commands
- Engine::get_singleton()->increment_frames_drawn();
- }
- } else {
- RenderingServer::get_singleton()->draw(true, scaled_step); // flush visual commands
- Engine::get_singleton()->increment_frames_drawn();
- force_redraw_requested = false;
- }
- }
- process_ticks = OS::get_singleton()->get_ticks_usec() - process_begin;
- process_max = MAX(process_ticks, process_max);
- uint64_t frame_time = OS::get_singleton()->get_ticks_usec() - ticks;
- for (int i = 0; i < ScriptServer::get_language_count(); i++) {
- ScriptServer::get_language(i)->frame();
- }
- AudioServer::get_singleton()->update();
- if (EngineDebugger::is_active()) {
- EngineDebugger::get_singleton()->iteration(frame_time, process_ticks, physics_process_ticks, physics_step);
- }
- frames++;
- Engine::get_singleton()->_process_frames++;
- if (frame > 1000000) {
- // Wait a few seconds before printing FPS, as FPS reporting just after the engine has started is inaccurate.
- if (hide_print_fps_attempts == 0) {
- if (editor || project_manager) {
- if (print_fps) {
- print_line(vformat("Editor FPS: %d (%s mspf)", frames, rtos(1000.0 / frames).pad_decimals(2)));
- }
- } else if (print_fps || GLOBAL_GET("debug/settings/stdout/print_fps")) {
- print_line(vformat("Project FPS: %d (%s mspf)", frames, rtos(1000.0 / frames).pad_decimals(2)));
- }
- } else {
- hide_print_fps_attempts--;
- }
- Engine::get_singleton()->_fps = frames;
- performance->set_process_time(USEC_TO_SEC(process_max));
- performance->set_physics_process_time(USEC_TO_SEC(physics_process_max));
- performance->set_navigation_process_time(USEC_TO_SEC(navigation_process_max));
- process_max = 0;
- physics_process_max = 0;
- navigation_process_max = 0;
- frame %= 1000000;
- frames = 0;
- }
- iterating--;
- if (movie_writer) {
- movie_writer->add_frame();
- }
- #ifdef TOOLS_ENABLED
- bool quit_after_timeout = false;
- #endif
- if ((quit_after > 0) && (Engine::get_singleton()->_process_frames >= quit_after)) {
- #ifdef TOOLS_ENABLED
- quit_after_timeout = true;
- #endif
- exit = true;
- }
- #ifdef TOOLS_ENABLED
- if (wait_for_import && EditorFileSystem::get_singleton() && EditorFileSystem::get_singleton()->doing_first_scan()) {
- exit = false;
- }
- #endif
- if (fixed_fps != -1) {
- return exit;
- }
- OS::get_singleton()->add_frame_delay(DisplayServer::get_singleton()->window_can_draw());
- #ifdef TOOLS_ENABLED
- if (auto_build_solutions) {
- auto_build_solutions = false;
- // Only relevant when running the editor.
- if (!editor) {
- OS::get_singleton()->set_exit_code(EXIT_FAILURE);
- ERR_FAIL_V_MSG(true,
- "Command line option --build-solutions was passed, but no project is being edited. Aborting.");
- }
- if (!EditorNode::get_singleton()->call_build()) {
- OS::get_singleton()->set_exit_code(EXIT_FAILURE);
- ERR_FAIL_V_MSG(true,
- "Command line option --build-solutions was passed, but the build callback failed. Aborting.");
- }
- }
- #endif
- #ifdef TOOLS_ENABLED
- if (exit && quit_after_timeout && EditorNode::get_singleton()) {
- EditorNode::get_singleton()->unload_editor_addons();
- }
- #endif
- return exit;
- }
- void Main::force_redraw() {
- force_redraw_requested = true;
- }
- /* Engine deinitialization
- *
- * Responsible for freeing all the memory allocated by previous setup steps,
- * so that the engine closes cleanly without leaking memory or crashing.
- * The order matters as some of those steps are linked with each other.
- */
- void Main::cleanup(bool p_force) {
- OS::get_singleton()->benchmark_begin_measure("Shutdown", "Main::Cleanup");
- if (!p_force) {
- ERR_FAIL_COND(!_start_success);
- }
- #ifdef DEBUG_ENABLED
- if (input) {
- input->flush_frame_parsed_events();
- }
- #endif
- for (int i = 0; i < TextServerManager::get_singleton()->get_interface_count(); i++) {
- TextServerManager::get_singleton()->get_interface(i)->cleanup();
- }
- if (movie_writer) {
- movie_writer->end();
- }
- ResourceLoader::clear_thread_load_tasks();
- ResourceLoader::remove_custom_loaders();
- ResourceSaver::remove_custom_savers();
- PropertyListHelper::clear_base_helpers();
- // Flush before uninitializing the scene, but delete the MessageQueue as late as possible.
- message_queue->flush();
- OS::get_singleton()->delete_main_loop();
- OS::get_singleton()->_cmdline.clear();
- OS::get_singleton()->_user_args.clear();
- OS::get_singleton()->_execpath = "";
- OS::get_singleton()->_local_clipboard = "";
- ResourceLoader::clear_translation_remaps();
- ResourceLoader::clear_path_remaps();
- ScriptServer::finish_languages();
- // Sync pending commands that may have been queued from a different thread during ScriptServer finalization
- RenderingServer::get_singleton()->sync();
- //clear global shader variables before scene and other graphics stuff are deinitialized.
- rendering_server->global_shader_parameters_clear();
- #ifndef _3D_DISABLED
- if (xr_server) {
- // Now that we're unregistering properly in plugins we need to keep access to xr_server for a little longer
- // We do however unset our primary interface
- xr_server->set_primary_interface(Ref<XRInterface>());
- }
- #endif // _3D_DISABLED
- #ifdef TOOLS_ENABLED
- GDExtensionManager::get_singleton()->deinitialize_extensions(GDExtension::INITIALIZATION_LEVEL_EDITOR);
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_EDITOR);
- unregister_editor_types();
- #endif
- ImageLoader::cleanup();
- GDExtensionManager::get_singleton()->deinitialize_extensions(GDExtension::INITIALIZATION_LEVEL_SCENE);
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_SCENE);
- unregister_platform_apis();
- unregister_driver_types();
- unregister_scene_types();
- finalize_theme_db();
- // Before deinitializing server extensions, finalize servers which may be loaded as extensions.
- finalize_navigation_server();
- finalize_physics();
- GDExtensionManager::get_singleton()->deinitialize_extensions(GDExtension::INITIALIZATION_LEVEL_SERVERS);
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_SERVERS);
- unregister_server_types();
- EngineDebugger::deinitialize();
- #ifndef _3D_DISABLED
- if (xr_server) {
- memdelete(xr_server);
- }
- #endif // _3D_DISABLED
- if (audio_server) {
- audio_server->finish();
- memdelete(audio_server);
- }
- if (camera_server) {
- memdelete(camera_server);
- }
- OS::get_singleton()->finalize();
- finalize_display();
- if (input) {
- memdelete(input);
- }
- if (packed_data) {
- memdelete(packed_data);
- }
- if (performance) {
- memdelete(performance);
- }
- if (input_map) {
- memdelete(input_map);
- }
- if (translation_server) {
- memdelete(translation_server);
- }
- if (tsman) {
- memdelete(tsman);
- }
- #ifndef _3D_DISABLED
- if (physics_server_3d_manager) {
- memdelete(physics_server_3d_manager);
- }
- #endif // _3D_DISABLED
- if (physics_server_2d_manager) {
- memdelete(physics_server_2d_manager);
- }
- if (globals) {
- memdelete(globals);
- }
- if (OS::get_singleton()->is_restart_on_exit_set()) {
- //attempt to restart with arguments
- List<String> args = OS::get_singleton()->get_restart_on_exit_arguments();
- OS::get_singleton()->create_instance(args);
- OS::get_singleton()->set_restart_on_exit(false, List<String>()); //clear list (uses memory)
- }
- // Now should be safe to delete MessageQueue (famous last words).
- message_queue->flush();
- memdelete(message_queue);
- #if defined(STEAMAPI_ENABLED)
- if (steam_tracker) {
- memdelete(steam_tracker);
- }
- #endif
- unregister_core_driver_types();
- unregister_core_extensions();
- uninitialize_modules(MODULE_INITIALIZATION_LEVEL_CORE);
- if (engine) {
- memdelete(engine);
- }
- unregister_core_types();
- OS::get_singleton()->benchmark_end_measure("Shutdown", "Main::Cleanup");
- OS::get_singleton()->benchmark_dump();
- OS::get_singleton()->finalize_core();
- }
|