[email protected] 327 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/@GlobalScope.xml.
  6. .. _class_@GlobalScope:
  7. @GlobalScope
  8. ============
  9. Global scope constants and functions.
  10. .. rst-class:: classref-introduction-group
  11. Description
  12. -----------
  13. A list of global scope enumerated constants and built-in functions. This is all that resides in the globals, constants regarding error codes, keycodes, property hints, etc.
  14. Singletons are also documented here, since they can be accessed from anywhere.
  15. For the entries that can only be accessed from scripts written in GDScript, see :ref:`@GDScript<class_@GDScript>`.
  16. .. note::
  17. There are notable differences when using this API with C#. See :ref:`doc_c_sharp_differences` for more information.
  18. .. rst-class:: classref-introduction-group
  19. Tutorials
  20. ---------
  21. - :doc:`Random number generation <../tutorials/math/random_number_generation>`
  22. .. rst-class:: classref-reftable-group
  23. Properties
  24. ----------
  25. .. table::
  26. :widths: auto
  27. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  28. | :ref:`AudioServer<class_AudioServer>` | :ref:`AudioServer<class_@GlobalScope_property_AudioServer>` |
  29. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  30. | :ref:`CameraServer<class_CameraServer>` | :ref:`CameraServer<class_@GlobalScope_property_CameraServer>` |
  31. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  32. | :ref:`ClassDB<class_ClassDB>` | :ref:`ClassDB<class_@GlobalScope_property_ClassDB>` |
  33. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  34. | :ref:`DisplayServer<class_DisplayServer>` | :ref:`DisplayServer<class_@GlobalScope_property_DisplayServer>` |
  35. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  36. | :ref:`EditorInterface<class_EditorInterface>` | :ref:`EditorInterface<class_@GlobalScope_property_EditorInterface>` |
  37. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  38. | :ref:`Engine<class_Engine>` | :ref:`Engine<class_@GlobalScope_property_Engine>` |
  39. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  40. | :ref:`EngineDebugger<class_EngineDebugger>` | :ref:`EngineDebugger<class_@GlobalScope_property_EngineDebugger>` |
  41. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  42. | :ref:`GDExtensionManager<class_GDExtensionManager>` | :ref:`GDExtensionManager<class_@GlobalScope_property_GDExtensionManager>` |
  43. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  44. | :ref:`Geometry2D<class_Geometry2D>` | :ref:`Geometry2D<class_@GlobalScope_property_Geometry2D>` |
  45. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  46. | :ref:`Geometry3D<class_Geometry3D>` | :ref:`Geometry3D<class_@GlobalScope_property_Geometry3D>` |
  47. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  48. | :ref:`IP<class_IP>` | :ref:`IP<class_@GlobalScope_property_IP>` |
  49. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  50. | :ref:`Input<class_Input>` | :ref:`Input<class_@GlobalScope_property_Input>` |
  51. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  52. | :ref:`InputMap<class_InputMap>` | :ref:`InputMap<class_@GlobalScope_property_InputMap>` |
  53. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  54. | :ref:`JavaClassWrapper<class_JavaClassWrapper>` | :ref:`JavaClassWrapper<class_@GlobalScope_property_JavaClassWrapper>` |
  55. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  56. | :ref:`JavaScriptBridge<class_JavaScriptBridge>` | :ref:`JavaScriptBridge<class_@GlobalScope_property_JavaScriptBridge>` |
  57. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  58. | :ref:`Marshalls<class_Marshalls>` | :ref:`Marshalls<class_@GlobalScope_property_Marshalls>` |
  59. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  60. | :ref:`NativeMenu<class_NativeMenu>` | :ref:`NativeMenu<class_@GlobalScope_property_NativeMenu>` |
  61. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  62. | :ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` | :ref:`NavigationMeshGenerator<class_@GlobalScope_property_NavigationMeshGenerator>` |
  63. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  64. | :ref:`NavigationServer2D<class_NavigationServer2D>` | :ref:`NavigationServer2D<class_@GlobalScope_property_NavigationServer2D>` |
  65. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  66. | :ref:`NavigationServer3D<class_NavigationServer3D>` | :ref:`NavigationServer3D<class_@GlobalScope_property_NavigationServer3D>` |
  67. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  68. | :ref:`OS<class_OS>` | :ref:`OS<class_@GlobalScope_property_OS>` |
  69. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  70. | :ref:`Performance<class_Performance>` | :ref:`Performance<class_@GlobalScope_property_Performance>` |
  71. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  72. | :ref:`PhysicsServer2D<class_PhysicsServer2D>` | :ref:`PhysicsServer2D<class_@GlobalScope_property_PhysicsServer2D>` |
  73. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  74. | :ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` | :ref:`PhysicsServer2DManager<class_@GlobalScope_property_PhysicsServer2DManager>` |
  75. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  76. | :ref:`PhysicsServer3D<class_PhysicsServer3D>` | :ref:`PhysicsServer3D<class_@GlobalScope_property_PhysicsServer3D>` |
  77. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  78. | :ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` | :ref:`PhysicsServer3DManager<class_@GlobalScope_property_PhysicsServer3DManager>` |
  79. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  80. | :ref:`ProjectSettings<class_ProjectSettings>` | :ref:`ProjectSettings<class_@GlobalScope_property_ProjectSettings>` |
  81. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  82. | :ref:`RenderingServer<class_RenderingServer>` | :ref:`RenderingServer<class_@GlobalScope_property_RenderingServer>` |
  83. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  84. | :ref:`ResourceLoader<class_ResourceLoader>` | :ref:`ResourceLoader<class_@GlobalScope_property_ResourceLoader>` |
  85. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  86. | :ref:`ResourceSaver<class_ResourceSaver>` | :ref:`ResourceSaver<class_@GlobalScope_property_ResourceSaver>` |
  87. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  88. | :ref:`ResourceUID<class_ResourceUID>` | :ref:`ResourceUID<class_@GlobalScope_property_ResourceUID>` |
  89. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  90. | :ref:`TextServerManager<class_TextServerManager>` | :ref:`TextServerManager<class_@GlobalScope_property_TextServerManager>` |
  91. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  92. | :ref:`ThemeDB<class_ThemeDB>` | :ref:`ThemeDB<class_@GlobalScope_property_ThemeDB>` |
  93. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  94. | :ref:`Time<class_Time>` | :ref:`Time<class_@GlobalScope_property_Time>` |
  95. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  96. | :ref:`TranslationServer<class_TranslationServer>` | :ref:`TranslationServer<class_@GlobalScope_property_TranslationServer>` |
  97. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  98. | :ref:`WorkerThreadPool<class_WorkerThreadPool>` | :ref:`WorkerThreadPool<class_@GlobalScope_property_WorkerThreadPool>` |
  99. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  100. | :ref:`XRServer<class_XRServer>` | :ref:`XRServer<class_@GlobalScope_property_XRServer>` |
  101. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  102. .. rst-class:: classref-reftable-group
  103. Methods
  104. -------
  105. .. table::
  106. :widths: auto
  107. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  108. | :ref:`Variant<class_Variant>` | :ref:`abs<class_@GlobalScope_method_abs>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  109. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  110. | :ref:`float<class_float>` | :ref:`absf<class_@GlobalScope_method_absf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  111. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  112. | :ref:`int<class_int>` | :ref:`absi<class_@GlobalScope_method_absi>`\ (\ x\: :ref:`int<class_int>`\ ) |
  113. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  114. | :ref:`float<class_float>` | :ref:`acos<class_@GlobalScope_method_acos>`\ (\ x\: :ref:`float<class_float>`\ ) |
  115. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  116. | :ref:`float<class_float>` | :ref:`acosh<class_@GlobalScope_method_acosh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  117. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  118. | :ref:`float<class_float>` | :ref:`angle_difference<class_@GlobalScope_method_angle_difference>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) |
  119. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  120. | :ref:`float<class_float>` | :ref:`asin<class_@GlobalScope_method_asin>`\ (\ x\: :ref:`float<class_float>`\ ) |
  121. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  122. | :ref:`float<class_float>` | :ref:`asinh<class_@GlobalScope_method_asinh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  123. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  124. | :ref:`float<class_float>` | :ref:`atan<class_@GlobalScope_method_atan>`\ (\ x\: :ref:`float<class_float>`\ ) |
  125. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  126. | :ref:`float<class_float>` | :ref:`atan2<class_@GlobalScope_method_atan2>`\ (\ y\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) |
  127. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  128. | :ref:`float<class_float>` | :ref:`atanh<class_@GlobalScope_method_atanh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  129. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  130. | :ref:`float<class_float>` | :ref:`bezier_derivative<class_@GlobalScope_method_bezier_derivative>`\ (\ start\: :ref:`float<class_float>`, control_1\: :ref:`float<class_float>`, control_2\: :ref:`float<class_float>`, end\: :ref:`float<class_float>`, t\: :ref:`float<class_float>`\ ) |
  131. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  132. | :ref:`float<class_float>` | :ref:`bezier_interpolate<class_@GlobalScope_method_bezier_interpolate>`\ (\ start\: :ref:`float<class_float>`, control_1\: :ref:`float<class_float>`, control_2\: :ref:`float<class_float>`, end\: :ref:`float<class_float>`, t\: :ref:`float<class_float>`\ ) |
  133. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  134. | :ref:`Variant<class_Variant>` | :ref:`bytes_to_var<class_@GlobalScope_method_bytes_to_var>`\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) |
  135. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  136. | :ref:`Variant<class_Variant>` | :ref:`bytes_to_var_with_objects<class_@GlobalScope_method_bytes_to_var_with_objects>`\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) |
  137. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  138. | :ref:`Variant<class_Variant>` | :ref:`ceil<class_@GlobalScope_method_ceil>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  139. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  140. | :ref:`float<class_float>` | :ref:`ceilf<class_@GlobalScope_method_ceilf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  141. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  142. | :ref:`int<class_int>` | :ref:`ceili<class_@GlobalScope_method_ceili>`\ (\ x\: :ref:`float<class_float>`\ ) |
  143. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  144. | :ref:`Variant<class_Variant>` | :ref:`clamp<class_@GlobalScope_method_clamp>`\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ ) |
  145. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  146. | :ref:`float<class_float>` | :ref:`clampf<class_@GlobalScope_method_clampf>`\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) |
  147. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  148. | :ref:`int<class_int>` | :ref:`clampi<class_@GlobalScope_method_clampi>`\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) |
  149. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  150. | :ref:`float<class_float>` | :ref:`cos<class_@GlobalScope_method_cos>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
  151. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  152. | :ref:`float<class_float>` | :ref:`cosh<class_@GlobalScope_method_cosh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  153. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  154. | :ref:`float<class_float>` | :ref:`cubic_interpolate<class_@GlobalScope_method_cubic_interpolate>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
  155. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  156. | :ref:`float<class_float>` | :ref:`cubic_interpolate_angle<class_@GlobalScope_method_cubic_interpolate_angle>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
  157. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  158. | :ref:`float<class_float>` | :ref:`cubic_interpolate_angle_in_time<class_@GlobalScope_method_cubic_interpolate_angle_in_time>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`, to_t\: :ref:`float<class_float>`, pre_t\: :ref:`float<class_float>`, post_t\: :ref:`float<class_float>`\ ) |
  159. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  160. | :ref:`float<class_float>` | :ref:`cubic_interpolate_in_time<class_@GlobalScope_method_cubic_interpolate_in_time>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`, to_t\: :ref:`float<class_float>`, pre_t\: :ref:`float<class_float>`, post_t\: :ref:`float<class_float>`\ ) |
  161. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  162. | :ref:`float<class_float>` | :ref:`db_to_linear<class_@GlobalScope_method_db_to_linear>`\ (\ db\: :ref:`float<class_float>`\ ) |
  163. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  164. | :ref:`float<class_float>` | :ref:`deg_to_rad<class_@GlobalScope_method_deg_to_rad>`\ (\ deg\: :ref:`float<class_float>`\ ) |
  165. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  166. | :ref:`float<class_float>` | :ref:`ease<class_@GlobalScope_method_ease>`\ (\ x\: :ref:`float<class_float>`, curve\: :ref:`float<class_float>`\ ) |
  167. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  168. | :ref:`String<class_String>` | :ref:`error_string<class_@GlobalScope_method_error_string>`\ (\ error\: :ref:`int<class_int>`\ ) |
  169. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  170. | :ref:`float<class_float>` | :ref:`exp<class_@GlobalScope_method_exp>`\ (\ x\: :ref:`float<class_float>`\ ) |
  171. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  172. | :ref:`Variant<class_Variant>` | :ref:`floor<class_@GlobalScope_method_floor>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  173. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  174. | :ref:`float<class_float>` | :ref:`floorf<class_@GlobalScope_method_floorf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  175. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  176. | :ref:`int<class_int>` | :ref:`floori<class_@GlobalScope_method_floori>`\ (\ x\: :ref:`float<class_float>`\ ) |
  177. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  178. | :ref:`float<class_float>` | :ref:`fmod<class_@GlobalScope_method_fmod>`\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) |
  179. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  180. | :ref:`float<class_float>` | :ref:`fposmod<class_@GlobalScope_method_fposmod>`\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) |
  181. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  182. | :ref:`int<class_int>` | :ref:`hash<class_@GlobalScope_method_hash>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  183. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  184. | :ref:`Object<class_Object>` | :ref:`instance_from_id<class_@GlobalScope_method_instance_from_id>`\ (\ instance_id\: :ref:`int<class_int>`\ ) |
  185. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  186. | :ref:`float<class_float>` | :ref:`inverse_lerp<class_@GlobalScope_method_inverse_lerp>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
  187. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  188. | :ref:`bool<class_bool>` | :ref:`is_equal_approx<class_@GlobalScope_method_is_equal_approx>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
  189. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  190. | :ref:`bool<class_bool>` | :ref:`is_finite<class_@GlobalScope_method_is_finite>`\ (\ x\: :ref:`float<class_float>`\ ) |
  191. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  192. | :ref:`bool<class_bool>` | :ref:`is_inf<class_@GlobalScope_method_is_inf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  193. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  194. | :ref:`bool<class_bool>` | :ref:`is_instance_id_valid<class_@GlobalScope_method_is_instance_id_valid>`\ (\ id\: :ref:`int<class_int>`\ ) |
  195. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  196. | :ref:`bool<class_bool>` | :ref:`is_instance_valid<class_@GlobalScope_method_is_instance_valid>`\ (\ instance\: :ref:`Variant<class_Variant>`\ ) |
  197. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  198. | :ref:`bool<class_bool>` | :ref:`is_nan<class_@GlobalScope_method_is_nan>`\ (\ x\: :ref:`float<class_float>`\ ) |
  199. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  200. | :ref:`bool<class_bool>` | :ref:`is_same<class_@GlobalScope_method_is_same>`\ (\ a\: :ref:`Variant<class_Variant>`, b\: :ref:`Variant<class_Variant>`\ ) |
  201. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  202. | :ref:`bool<class_bool>` | :ref:`is_zero_approx<class_@GlobalScope_method_is_zero_approx>`\ (\ x\: :ref:`float<class_float>`\ ) |
  203. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  204. | :ref:`Variant<class_Variant>` | :ref:`lerp<class_@GlobalScope_method_lerp>`\ (\ from\: :ref:`Variant<class_Variant>`, to\: :ref:`Variant<class_Variant>`, weight\: :ref:`Variant<class_Variant>`\ ) |
  205. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  206. | :ref:`float<class_float>` | :ref:`lerp_angle<class_@GlobalScope_method_lerp_angle>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
  207. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  208. | :ref:`float<class_float>` | :ref:`lerpf<class_@GlobalScope_method_lerpf>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
  209. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  210. | :ref:`float<class_float>` | :ref:`linear_to_db<class_@GlobalScope_method_linear_to_db>`\ (\ lin\: :ref:`float<class_float>`\ ) |
  211. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  212. | :ref:`float<class_float>` | :ref:`log<class_@GlobalScope_method_log>`\ (\ x\: :ref:`float<class_float>`\ ) |
  213. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  214. | :ref:`Variant<class_Variant>` | :ref:`max<class_@GlobalScope_method_max>`\ (\ ...\ ) |vararg| |
  215. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  216. | :ref:`float<class_float>` | :ref:`maxf<class_@GlobalScope_method_maxf>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
  217. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  218. | :ref:`int<class_int>` | :ref:`maxi<class_@GlobalScope_method_maxi>`\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) |
  219. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  220. | :ref:`Variant<class_Variant>` | :ref:`min<class_@GlobalScope_method_min>`\ (\ ...\ ) |vararg| |
  221. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  222. | :ref:`float<class_float>` | :ref:`minf<class_@GlobalScope_method_minf>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
  223. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  224. | :ref:`int<class_int>` | :ref:`mini<class_@GlobalScope_method_mini>`\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) |
  225. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  226. | :ref:`float<class_float>` | :ref:`move_toward<class_@GlobalScope_method_move_toward>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ ) |
  227. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  228. | :ref:`int<class_int>` | :ref:`nearest_po2<class_@GlobalScope_method_nearest_po2>`\ (\ value\: :ref:`int<class_int>`\ ) |
  229. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  230. | :ref:`float<class_float>` | :ref:`pingpong<class_@GlobalScope_method_pingpong>`\ (\ value\: :ref:`float<class_float>`, length\: :ref:`float<class_float>`\ ) |
  231. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  232. | :ref:`int<class_int>` | :ref:`posmod<class_@GlobalScope_method_posmod>`\ (\ x\: :ref:`int<class_int>`, y\: :ref:`int<class_int>`\ ) |
  233. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  234. | :ref:`float<class_float>` | :ref:`pow<class_@GlobalScope_method_pow>`\ (\ base\: :ref:`float<class_float>`, exp\: :ref:`float<class_float>`\ ) |
  235. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  236. | |void| | :ref:`print<class_@GlobalScope_method_print>`\ (\ ...\ ) |vararg| |
  237. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  238. | |void| | :ref:`print_rich<class_@GlobalScope_method_print_rich>`\ (\ ...\ ) |vararg| |
  239. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  240. | |void| | :ref:`print_verbose<class_@GlobalScope_method_print_verbose>`\ (\ ...\ ) |vararg| |
  241. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  242. | |void| | :ref:`printerr<class_@GlobalScope_method_printerr>`\ (\ ...\ ) |vararg| |
  243. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  244. | |void| | :ref:`printraw<class_@GlobalScope_method_printraw>`\ (\ ...\ ) |vararg| |
  245. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  246. | |void| | :ref:`prints<class_@GlobalScope_method_prints>`\ (\ ...\ ) |vararg| |
  247. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  248. | |void| | :ref:`printt<class_@GlobalScope_method_printt>`\ (\ ...\ ) |vararg| |
  249. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  250. | |void| | :ref:`push_error<class_@GlobalScope_method_push_error>`\ (\ ...\ ) |vararg| |
  251. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  252. | |void| | :ref:`push_warning<class_@GlobalScope_method_push_warning>`\ (\ ...\ ) |vararg| |
  253. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  254. | :ref:`float<class_float>` | :ref:`rad_to_deg<class_@GlobalScope_method_rad_to_deg>`\ (\ rad\: :ref:`float<class_float>`\ ) |
  255. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  256. | :ref:`PackedInt64Array<class_PackedInt64Array>` | :ref:`rand_from_seed<class_@GlobalScope_method_rand_from_seed>`\ (\ seed\: :ref:`int<class_int>`\ ) |
  257. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  258. | :ref:`float<class_float>` | :ref:`randf<class_@GlobalScope_method_randf>`\ (\ ) |
  259. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  260. | :ref:`float<class_float>` | :ref:`randf_range<class_@GlobalScope_method_randf_range>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) |
  261. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  262. | :ref:`float<class_float>` | :ref:`randfn<class_@GlobalScope_method_randfn>`\ (\ mean\: :ref:`float<class_float>`, deviation\: :ref:`float<class_float>`\ ) |
  263. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  264. | :ref:`int<class_int>` | :ref:`randi<class_@GlobalScope_method_randi>`\ (\ ) |
  265. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  266. | :ref:`int<class_int>` | :ref:`randi_range<class_@GlobalScope_method_randi_range>`\ (\ from\: :ref:`int<class_int>`, to\: :ref:`int<class_int>`\ ) |
  267. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  268. | |void| | :ref:`randomize<class_@GlobalScope_method_randomize>`\ (\ ) |
  269. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  270. | :ref:`float<class_float>` | :ref:`remap<class_@GlobalScope_method_remap>`\ (\ value\: :ref:`float<class_float>`, istart\: :ref:`float<class_float>`, istop\: :ref:`float<class_float>`, ostart\: :ref:`float<class_float>`, ostop\: :ref:`float<class_float>`\ ) |
  271. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  272. | :ref:`int<class_int>` | :ref:`rid_allocate_id<class_@GlobalScope_method_rid_allocate_id>`\ (\ ) |
  273. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  274. | :ref:`RID<class_RID>` | :ref:`rid_from_int64<class_@GlobalScope_method_rid_from_int64>`\ (\ base\: :ref:`int<class_int>`\ ) |
  275. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  276. | :ref:`float<class_float>` | :ref:`rotate_toward<class_@GlobalScope_method_rotate_toward>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ ) |
  277. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  278. | :ref:`Variant<class_Variant>` | :ref:`round<class_@GlobalScope_method_round>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  279. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  280. | :ref:`float<class_float>` | :ref:`roundf<class_@GlobalScope_method_roundf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  281. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  282. | :ref:`int<class_int>` | :ref:`roundi<class_@GlobalScope_method_roundi>`\ (\ x\: :ref:`float<class_float>`\ ) |
  283. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  284. | |void| | :ref:`seed<class_@GlobalScope_method_seed>`\ (\ base\: :ref:`int<class_int>`\ ) |
  285. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  286. | :ref:`Variant<class_Variant>` | :ref:`sign<class_@GlobalScope_method_sign>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  287. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  288. | :ref:`float<class_float>` | :ref:`signf<class_@GlobalScope_method_signf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  289. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  290. | :ref:`int<class_int>` | :ref:`signi<class_@GlobalScope_method_signi>`\ (\ x\: :ref:`int<class_int>`\ ) |
  291. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  292. | :ref:`float<class_float>` | :ref:`sin<class_@GlobalScope_method_sin>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
  293. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  294. | :ref:`float<class_float>` | :ref:`sinh<class_@GlobalScope_method_sinh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  295. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  296. | :ref:`float<class_float>` | :ref:`smoothstep<class_@GlobalScope_method_smoothstep>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) |
  297. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  298. | :ref:`Variant<class_Variant>` | :ref:`snapped<class_@GlobalScope_method_snapped>`\ (\ x\: :ref:`Variant<class_Variant>`, step\: :ref:`Variant<class_Variant>`\ ) |
  299. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  300. | :ref:`float<class_float>` | :ref:`snappedf<class_@GlobalScope_method_snappedf>`\ (\ x\: :ref:`float<class_float>`, step\: :ref:`float<class_float>`\ ) |
  301. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  302. | :ref:`int<class_int>` | :ref:`snappedi<class_@GlobalScope_method_snappedi>`\ (\ x\: :ref:`float<class_float>`, step\: :ref:`int<class_int>`\ ) |
  303. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  304. | :ref:`float<class_float>` | :ref:`sqrt<class_@GlobalScope_method_sqrt>`\ (\ x\: :ref:`float<class_float>`\ ) |
  305. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  306. | :ref:`int<class_int>` | :ref:`step_decimals<class_@GlobalScope_method_step_decimals>`\ (\ x\: :ref:`float<class_float>`\ ) |
  307. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  308. | :ref:`String<class_String>` | :ref:`str<class_@GlobalScope_method_str>`\ (\ ...\ ) |vararg| |
  309. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  310. | :ref:`Variant<class_Variant>` | :ref:`str_to_var<class_@GlobalScope_method_str_to_var>`\ (\ string\: :ref:`String<class_String>`\ ) |
  311. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  312. | :ref:`float<class_float>` | :ref:`tan<class_@GlobalScope_method_tan>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
  313. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  314. | :ref:`float<class_float>` | :ref:`tanh<class_@GlobalScope_method_tanh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  315. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  316. | :ref:`Variant<class_Variant>` | :ref:`type_convert<class_@GlobalScope_method_type_convert>`\ (\ variant\: :ref:`Variant<class_Variant>`, type\: :ref:`int<class_int>`\ ) |
  317. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  318. | :ref:`String<class_String>` | :ref:`type_string<class_@GlobalScope_method_type_string>`\ (\ type\: :ref:`int<class_int>`\ ) |
  319. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  320. | :ref:`int<class_int>` | :ref:`typeof<class_@GlobalScope_method_typeof>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  321. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  322. | :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`var_to_bytes<class_@GlobalScope_method_var_to_bytes>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  323. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  324. | :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`var_to_bytes_with_objects<class_@GlobalScope_method_var_to_bytes_with_objects>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  325. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  326. | :ref:`String<class_String>` | :ref:`var_to_str<class_@GlobalScope_method_var_to_str>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  327. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  328. | :ref:`Variant<class_Variant>` | :ref:`weakref<class_@GlobalScope_method_weakref>`\ (\ obj\: :ref:`Variant<class_Variant>`\ ) |
  329. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  330. | :ref:`Variant<class_Variant>` | :ref:`wrap<class_@GlobalScope_method_wrap>`\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ ) |
  331. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  332. | :ref:`float<class_float>` | :ref:`wrapf<class_@GlobalScope_method_wrapf>`\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) |
  333. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  334. | :ref:`int<class_int>` | :ref:`wrapi<class_@GlobalScope_method_wrapi>`\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) |
  335. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  336. .. rst-class:: classref-section-separator
  337. ----
  338. .. rst-class:: classref-descriptions-group
  339. Enumerations
  340. ------------
  341. .. _enum_@GlobalScope_Side:
  342. .. rst-class:: classref-enumeration
  343. enum **Side**: :ref:`🔗<enum_@GlobalScope_Side>`
  344. .. _class_@GlobalScope_constant_SIDE_LEFT:
  345. .. rst-class:: classref-enumeration-constant
  346. :ref:`Side<enum_@GlobalScope_Side>` **SIDE_LEFT** = ``0``
  347. Left side, usually used for :ref:`Control<class_Control>` or :ref:`StyleBox<class_StyleBox>`-derived classes.
  348. .. _class_@GlobalScope_constant_SIDE_TOP:
  349. .. rst-class:: classref-enumeration-constant
  350. :ref:`Side<enum_@GlobalScope_Side>` **SIDE_TOP** = ``1``
  351. Top side, usually used for :ref:`Control<class_Control>` or :ref:`StyleBox<class_StyleBox>`-derived classes.
  352. .. _class_@GlobalScope_constant_SIDE_RIGHT:
  353. .. rst-class:: classref-enumeration-constant
  354. :ref:`Side<enum_@GlobalScope_Side>` **SIDE_RIGHT** = ``2``
  355. Right side, usually used for :ref:`Control<class_Control>` or :ref:`StyleBox<class_StyleBox>`-derived classes.
  356. .. _class_@GlobalScope_constant_SIDE_BOTTOM:
  357. .. rst-class:: classref-enumeration-constant
  358. :ref:`Side<enum_@GlobalScope_Side>` **SIDE_BOTTOM** = ``3``
  359. Bottom side, usually used for :ref:`Control<class_Control>` or :ref:`StyleBox<class_StyleBox>`-derived classes.
  360. .. rst-class:: classref-item-separator
  361. ----
  362. .. _enum_@GlobalScope_Corner:
  363. .. rst-class:: classref-enumeration
  364. enum **Corner**: :ref:`🔗<enum_@GlobalScope_Corner>`
  365. .. _class_@GlobalScope_constant_CORNER_TOP_LEFT:
  366. .. rst-class:: classref-enumeration-constant
  367. :ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_TOP_LEFT** = ``0``
  368. Top-left corner.
  369. .. _class_@GlobalScope_constant_CORNER_TOP_RIGHT:
  370. .. rst-class:: classref-enumeration-constant
  371. :ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_TOP_RIGHT** = ``1``
  372. Top-right corner.
  373. .. _class_@GlobalScope_constant_CORNER_BOTTOM_RIGHT:
  374. .. rst-class:: classref-enumeration-constant
  375. :ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_BOTTOM_RIGHT** = ``2``
  376. Bottom-right corner.
  377. .. _class_@GlobalScope_constant_CORNER_BOTTOM_LEFT:
  378. .. rst-class:: classref-enumeration-constant
  379. :ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_BOTTOM_LEFT** = ``3``
  380. Bottom-left corner.
  381. .. rst-class:: classref-item-separator
  382. ----
  383. .. _enum_@GlobalScope_Orientation:
  384. .. rst-class:: classref-enumeration
  385. enum **Orientation**: :ref:`🔗<enum_@GlobalScope_Orientation>`
  386. .. _class_@GlobalScope_constant_VERTICAL:
  387. .. rst-class:: classref-enumeration-constant
  388. :ref:`Orientation<enum_@GlobalScope_Orientation>` **VERTICAL** = ``1``
  389. General vertical alignment, usually used for :ref:`Separator<class_Separator>`, :ref:`ScrollBar<class_ScrollBar>`, :ref:`Slider<class_Slider>`, etc.
  390. .. _class_@GlobalScope_constant_HORIZONTAL:
  391. .. rst-class:: classref-enumeration-constant
  392. :ref:`Orientation<enum_@GlobalScope_Orientation>` **HORIZONTAL** = ``0``
  393. General horizontal alignment, usually used for :ref:`Separator<class_Separator>`, :ref:`ScrollBar<class_ScrollBar>`, :ref:`Slider<class_Slider>`, etc.
  394. .. rst-class:: classref-item-separator
  395. ----
  396. .. _enum_@GlobalScope_ClockDirection:
  397. .. rst-class:: classref-enumeration
  398. enum **ClockDirection**: :ref:`🔗<enum_@GlobalScope_ClockDirection>`
  399. .. _class_@GlobalScope_constant_CLOCKWISE:
  400. .. rst-class:: classref-enumeration-constant
  401. :ref:`ClockDirection<enum_@GlobalScope_ClockDirection>` **CLOCKWISE** = ``0``
  402. Clockwise rotation. Used by some methods (e.g. :ref:`Image.rotate_90<class_Image_method_rotate_90>`).
  403. .. _class_@GlobalScope_constant_COUNTERCLOCKWISE:
  404. .. rst-class:: classref-enumeration-constant
  405. :ref:`ClockDirection<enum_@GlobalScope_ClockDirection>` **COUNTERCLOCKWISE** = ``1``
  406. Counter-clockwise rotation. Used by some methods (e.g. :ref:`Image.rotate_90<class_Image_method_rotate_90>`).
  407. .. rst-class:: classref-item-separator
  408. ----
  409. .. _enum_@GlobalScope_HorizontalAlignment:
  410. .. rst-class:: classref-enumeration
  411. enum **HorizontalAlignment**: :ref:`🔗<enum_@GlobalScope_HorizontalAlignment>`
  412. .. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_LEFT:
  413. .. rst-class:: classref-enumeration-constant
  414. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_LEFT** = ``0``
  415. Horizontal left alignment, usually for text-derived classes.
  416. .. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_CENTER:
  417. .. rst-class:: classref-enumeration-constant
  418. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_CENTER** = ``1``
  419. Horizontal center alignment, usually for text-derived classes.
  420. .. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_RIGHT:
  421. .. rst-class:: classref-enumeration-constant
  422. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_RIGHT** = ``2``
  423. Horizontal right alignment, usually for text-derived classes.
  424. .. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_FILL:
  425. .. rst-class:: classref-enumeration-constant
  426. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_FILL** = ``3``
  427. Expand row to fit width, usually for text-derived classes.
  428. .. rst-class:: classref-item-separator
  429. ----
  430. .. _enum_@GlobalScope_VerticalAlignment:
  431. .. rst-class:: classref-enumeration
  432. enum **VerticalAlignment**: :ref:`🔗<enum_@GlobalScope_VerticalAlignment>`
  433. .. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_TOP:
  434. .. rst-class:: classref-enumeration-constant
  435. :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_TOP** = ``0``
  436. Vertical top alignment, usually for text-derived classes.
  437. .. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_CENTER:
  438. .. rst-class:: classref-enumeration-constant
  439. :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_CENTER** = ``1``
  440. Vertical center alignment, usually for text-derived classes.
  441. .. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_BOTTOM:
  442. .. rst-class:: classref-enumeration-constant
  443. :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_BOTTOM** = ``2``
  444. Vertical bottom alignment, usually for text-derived classes.
  445. .. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_FILL:
  446. .. rst-class:: classref-enumeration-constant
  447. :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_FILL** = ``3``
  448. Expand rows to fit height, usually for text-derived classes.
  449. .. rst-class:: classref-item-separator
  450. ----
  451. .. _enum_@GlobalScope_InlineAlignment:
  452. .. rst-class:: classref-enumeration
  453. enum **InlineAlignment**: :ref:`🔗<enum_@GlobalScope_InlineAlignment>`
  454. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TOP_TO:
  455. .. rst-class:: classref-enumeration-constant
  456. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TOP_TO** = ``0``
  457. Aligns the top of the inline object (e.g. image, table) to the position of the text specified by ``INLINE_ALIGNMENT_TO_*`` constant.
  458. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_CENTER_TO:
  459. .. rst-class:: classref-enumeration-constant
  460. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_CENTER_TO** = ``1``
  461. Aligns the center of the inline object (e.g. image, table) to the position of the text specified by ``INLINE_ALIGNMENT_TO_*`` constant.
  462. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BASELINE_TO:
  463. .. rst-class:: classref-enumeration-constant
  464. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BASELINE_TO** = ``3``
  465. Aligns the baseline (user defined) of the inline object (e.g. image, table) to the position of the text specified by ``INLINE_ALIGNMENT_TO_*`` constant.
  466. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BOTTOM_TO:
  467. .. rst-class:: classref-enumeration-constant
  468. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BOTTOM_TO** = ``2``
  469. Aligns the bottom of the inline object (e.g. image, table) to the position of the text specified by ``INLINE_ALIGNMENT_TO_*`` constant.
  470. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_TOP:
  471. .. rst-class:: classref-enumeration-constant
  472. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_TOP** = ``0``
  473. Aligns the position of the inline object (e.g. image, table) specified by ``INLINE_ALIGNMENT_*_TO`` constant to the top of the text.
  474. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_CENTER:
  475. .. rst-class:: classref-enumeration-constant
  476. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_CENTER** = ``4``
  477. Aligns the position of the inline object (e.g. image, table) specified by ``INLINE_ALIGNMENT_*_TO`` constant to the center of the text.
  478. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_BASELINE:
  479. .. rst-class:: classref-enumeration-constant
  480. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_BASELINE** = ``8``
  481. Aligns the position of the inline object (e.g. image, table) specified by ``INLINE_ALIGNMENT_*_TO`` constant to the baseline of the text.
  482. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_BOTTOM:
  483. .. rst-class:: classref-enumeration-constant
  484. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_BOTTOM** = ``12``
  485. Aligns inline object (e.g. image, table) to the bottom of the text.
  486. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TOP:
  487. .. rst-class:: classref-enumeration-constant
  488. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TOP** = ``0``
  489. Aligns top of the inline object (e.g. image, table) to the top of the text. Equivalent to ``INLINE_ALIGNMENT_TOP_TO | INLINE_ALIGNMENT_TO_TOP``.
  490. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_CENTER:
  491. .. rst-class:: classref-enumeration-constant
  492. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_CENTER** = ``5``
  493. Aligns center of the inline object (e.g. image, table) to the center of the text. Equivalent to ``INLINE_ALIGNMENT_CENTER_TO | INLINE_ALIGNMENT_TO_CENTER``.
  494. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BOTTOM:
  495. .. rst-class:: classref-enumeration-constant
  496. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BOTTOM** = ``14``
  497. Aligns bottom of the inline object (e.g. image, table) to the bottom of the text. Equivalent to ``INLINE_ALIGNMENT_BOTTOM_TO | INLINE_ALIGNMENT_TO_BOTTOM``.
  498. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_IMAGE_MASK:
  499. .. rst-class:: classref-enumeration-constant
  500. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_IMAGE_MASK** = ``3``
  501. A bit mask for ``INLINE_ALIGNMENT_*_TO`` alignment constants.
  502. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TEXT_MASK:
  503. .. rst-class:: classref-enumeration-constant
  504. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TEXT_MASK** = ``12``
  505. A bit mask for ``INLINE_ALIGNMENT_TO_*`` alignment constants.
  506. .. rst-class:: classref-item-separator
  507. ----
  508. .. _enum_@GlobalScope_EulerOrder:
  509. .. rst-class:: classref-enumeration
  510. enum **EulerOrder**: :ref:`🔗<enum_@GlobalScope_EulerOrder>`
  511. .. _class_@GlobalScope_constant_EULER_ORDER_XYZ:
  512. .. rst-class:: classref-enumeration-constant
  513. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_XYZ** = ``0``
  514. Specifies that Euler angles should be in XYZ order. When composing, the order is X, Y, Z. When decomposing, the order is reversed, first Z, then Y, and X last.
  515. .. _class_@GlobalScope_constant_EULER_ORDER_XZY:
  516. .. rst-class:: classref-enumeration-constant
  517. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_XZY** = ``1``
  518. Specifies that Euler angles should be in XZY order. When composing, the order is X, Z, Y. When decomposing, the order is reversed, first Y, then Z, and X last.
  519. .. _class_@GlobalScope_constant_EULER_ORDER_YXZ:
  520. .. rst-class:: classref-enumeration-constant
  521. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_YXZ** = ``2``
  522. Specifies that Euler angles should be in YXZ order. When composing, the order is Y, X, Z. When decomposing, the order is reversed, first Z, then X, and Y last.
  523. .. _class_@GlobalScope_constant_EULER_ORDER_YZX:
  524. .. rst-class:: classref-enumeration-constant
  525. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_YZX** = ``3``
  526. Specifies that Euler angles should be in YZX order. When composing, the order is Y, Z, X. When decomposing, the order is reversed, first X, then Z, and Y last.
  527. .. _class_@GlobalScope_constant_EULER_ORDER_ZXY:
  528. .. rst-class:: classref-enumeration-constant
  529. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_ZXY** = ``4``
  530. Specifies that Euler angles should be in ZXY order. When composing, the order is Z, X, Y. When decomposing, the order is reversed, first Y, then X, and Z last.
  531. .. _class_@GlobalScope_constant_EULER_ORDER_ZYX:
  532. .. rst-class:: classref-enumeration-constant
  533. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_ZYX** = ``5``
  534. Specifies that Euler angles should be in ZYX order. When composing, the order is Z, Y, X. When decomposing, the order is reversed, first X, then Y, and Z last.
  535. .. rst-class:: classref-item-separator
  536. ----
  537. .. _enum_@GlobalScope_Key:
  538. .. rst-class:: classref-enumeration
  539. enum **Key**: :ref:`🔗<enum_@GlobalScope_Key>`
  540. .. _class_@GlobalScope_constant_KEY_NONE:
  541. .. rst-class:: classref-enumeration-constant
  542. :ref:`Key<enum_@GlobalScope_Key>` **KEY_NONE** = ``0``
  543. Enum value which doesn't correspond to any key. This is used to initialize :ref:`Key<enum_@GlobalScope_Key>` properties with a generic state.
  544. .. _class_@GlobalScope_constant_KEY_SPECIAL:
  545. .. rst-class:: classref-enumeration-constant
  546. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SPECIAL** = ``4194304``
  547. Keycodes with this bit applied are non-printable.
  548. .. _class_@GlobalScope_constant_KEY_ESCAPE:
  549. .. rst-class:: classref-enumeration-constant
  550. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ESCAPE** = ``4194305``
  551. Escape key.
  552. .. _class_@GlobalScope_constant_KEY_TAB:
  553. .. rst-class:: classref-enumeration-constant
  554. :ref:`Key<enum_@GlobalScope_Key>` **KEY_TAB** = ``4194306``
  555. Tab key.
  556. .. _class_@GlobalScope_constant_KEY_BACKTAB:
  557. .. rst-class:: classref-enumeration-constant
  558. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKTAB** = ``4194307``
  559. Shift + Tab key.
  560. .. _class_@GlobalScope_constant_KEY_BACKSPACE:
  561. .. rst-class:: classref-enumeration-constant
  562. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKSPACE** = ``4194308``
  563. Backspace key.
  564. .. _class_@GlobalScope_constant_KEY_ENTER:
  565. .. rst-class:: classref-enumeration-constant
  566. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ENTER** = ``4194309``
  567. Return key (on the main keyboard).
  568. .. _class_@GlobalScope_constant_KEY_KP_ENTER:
  569. .. rst-class:: classref-enumeration-constant
  570. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_ENTER** = ``4194310``
  571. Enter key on the numeric keypad.
  572. .. _class_@GlobalScope_constant_KEY_INSERT:
  573. .. rst-class:: classref-enumeration-constant
  574. :ref:`Key<enum_@GlobalScope_Key>` **KEY_INSERT** = ``4194311``
  575. Insert key.
  576. .. _class_@GlobalScope_constant_KEY_DELETE:
  577. .. rst-class:: classref-enumeration-constant
  578. :ref:`Key<enum_@GlobalScope_Key>` **KEY_DELETE** = ``4194312``
  579. Delete key.
  580. .. _class_@GlobalScope_constant_KEY_PAUSE:
  581. .. rst-class:: classref-enumeration-constant
  582. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PAUSE** = ``4194313``
  583. Pause key.
  584. .. _class_@GlobalScope_constant_KEY_PRINT:
  585. .. rst-class:: classref-enumeration-constant
  586. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PRINT** = ``4194314``
  587. Print Screen key.
  588. .. _class_@GlobalScope_constant_KEY_SYSREQ:
  589. .. rst-class:: classref-enumeration-constant
  590. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SYSREQ** = ``4194315``
  591. System Request key.
  592. .. _class_@GlobalScope_constant_KEY_CLEAR:
  593. .. rst-class:: classref-enumeration-constant
  594. :ref:`Key<enum_@GlobalScope_Key>` **KEY_CLEAR** = ``4194316``
  595. Clear key.
  596. .. _class_@GlobalScope_constant_KEY_HOME:
  597. .. rst-class:: classref-enumeration-constant
  598. :ref:`Key<enum_@GlobalScope_Key>` **KEY_HOME** = ``4194317``
  599. Home key.
  600. .. _class_@GlobalScope_constant_KEY_END:
  601. .. rst-class:: classref-enumeration-constant
  602. :ref:`Key<enum_@GlobalScope_Key>` **KEY_END** = ``4194318``
  603. End key.
  604. .. _class_@GlobalScope_constant_KEY_LEFT:
  605. .. rst-class:: classref-enumeration-constant
  606. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LEFT** = ``4194319``
  607. Left arrow key.
  608. .. _class_@GlobalScope_constant_KEY_UP:
  609. .. rst-class:: classref-enumeration-constant
  610. :ref:`Key<enum_@GlobalScope_Key>` **KEY_UP** = ``4194320``
  611. Up arrow key.
  612. .. _class_@GlobalScope_constant_KEY_RIGHT:
  613. .. rst-class:: classref-enumeration-constant
  614. :ref:`Key<enum_@GlobalScope_Key>` **KEY_RIGHT** = ``4194321``
  615. Right arrow key.
  616. .. _class_@GlobalScope_constant_KEY_DOWN:
  617. .. rst-class:: classref-enumeration-constant
  618. :ref:`Key<enum_@GlobalScope_Key>` **KEY_DOWN** = ``4194322``
  619. Down arrow key.
  620. .. _class_@GlobalScope_constant_KEY_PAGEUP:
  621. .. rst-class:: classref-enumeration-constant
  622. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PAGEUP** = ``4194323``
  623. Page Up key.
  624. .. _class_@GlobalScope_constant_KEY_PAGEDOWN:
  625. .. rst-class:: classref-enumeration-constant
  626. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PAGEDOWN** = ``4194324``
  627. Page Down key.
  628. .. _class_@GlobalScope_constant_KEY_SHIFT:
  629. .. rst-class:: classref-enumeration-constant
  630. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SHIFT** = ``4194325``
  631. Shift key.
  632. .. _class_@GlobalScope_constant_KEY_CTRL:
  633. .. rst-class:: classref-enumeration-constant
  634. :ref:`Key<enum_@GlobalScope_Key>` **KEY_CTRL** = ``4194326``
  635. Control key.
  636. .. _class_@GlobalScope_constant_KEY_META:
  637. .. rst-class:: classref-enumeration-constant
  638. :ref:`Key<enum_@GlobalScope_Key>` **KEY_META** = ``4194327``
  639. Meta key.
  640. .. _class_@GlobalScope_constant_KEY_ALT:
  641. .. rst-class:: classref-enumeration-constant
  642. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ALT** = ``4194328``
  643. Alt key.
  644. .. _class_@GlobalScope_constant_KEY_CAPSLOCK:
  645. .. rst-class:: classref-enumeration-constant
  646. :ref:`Key<enum_@GlobalScope_Key>` **KEY_CAPSLOCK** = ``4194329``
  647. Caps Lock key.
  648. .. _class_@GlobalScope_constant_KEY_NUMLOCK:
  649. .. rst-class:: classref-enumeration-constant
  650. :ref:`Key<enum_@GlobalScope_Key>` **KEY_NUMLOCK** = ``4194330``
  651. Num Lock key.
  652. .. _class_@GlobalScope_constant_KEY_SCROLLLOCK:
  653. .. rst-class:: classref-enumeration-constant
  654. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SCROLLLOCK** = ``4194331``
  655. Scroll Lock key.
  656. .. _class_@GlobalScope_constant_KEY_F1:
  657. .. rst-class:: classref-enumeration-constant
  658. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F1** = ``4194332``
  659. F1 key.
  660. .. _class_@GlobalScope_constant_KEY_F2:
  661. .. rst-class:: classref-enumeration-constant
  662. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F2** = ``4194333``
  663. F2 key.
  664. .. _class_@GlobalScope_constant_KEY_F3:
  665. .. rst-class:: classref-enumeration-constant
  666. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F3** = ``4194334``
  667. F3 key.
  668. .. _class_@GlobalScope_constant_KEY_F4:
  669. .. rst-class:: classref-enumeration-constant
  670. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F4** = ``4194335``
  671. F4 key.
  672. .. _class_@GlobalScope_constant_KEY_F5:
  673. .. rst-class:: classref-enumeration-constant
  674. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F5** = ``4194336``
  675. F5 key.
  676. .. _class_@GlobalScope_constant_KEY_F6:
  677. .. rst-class:: classref-enumeration-constant
  678. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F6** = ``4194337``
  679. F6 key.
  680. .. _class_@GlobalScope_constant_KEY_F7:
  681. .. rst-class:: classref-enumeration-constant
  682. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F7** = ``4194338``
  683. F7 key.
  684. .. _class_@GlobalScope_constant_KEY_F8:
  685. .. rst-class:: classref-enumeration-constant
  686. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F8** = ``4194339``
  687. F8 key.
  688. .. _class_@GlobalScope_constant_KEY_F9:
  689. .. rst-class:: classref-enumeration-constant
  690. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F9** = ``4194340``
  691. F9 key.
  692. .. _class_@GlobalScope_constant_KEY_F10:
  693. .. rst-class:: classref-enumeration-constant
  694. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F10** = ``4194341``
  695. F10 key.
  696. .. _class_@GlobalScope_constant_KEY_F11:
  697. .. rst-class:: classref-enumeration-constant
  698. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F11** = ``4194342``
  699. F11 key.
  700. .. _class_@GlobalScope_constant_KEY_F12:
  701. .. rst-class:: classref-enumeration-constant
  702. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F12** = ``4194343``
  703. F12 key.
  704. .. _class_@GlobalScope_constant_KEY_F13:
  705. .. rst-class:: classref-enumeration-constant
  706. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F13** = ``4194344``
  707. F13 key.
  708. .. _class_@GlobalScope_constant_KEY_F14:
  709. .. rst-class:: classref-enumeration-constant
  710. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F14** = ``4194345``
  711. F14 key.
  712. .. _class_@GlobalScope_constant_KEY_F15:
  713. .. rst-class:: classref-enumeration-constant
  714. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F15** = ``4194346``
  715. F15 key.
  716. .. _class_@GlobalScope_constant_KEY_F16:
  717. .. rst-class:: classref-enumeration-constant
  718. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F16** = ``4194347``
  719. F16 key.
  720. .. _class_@GlobalScope_constant_KEY_F17:
  721. .. rst-class:: classref-enumeration-constant
  722. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F17** = ``4194348``
  723. F17 key.
  724. .. _class_@GlobalScope_constant_KEY_F18:
  725. .. rst-class:: classref-enumeration-constant
  726. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F18** = ``4194349``
  727. F18 key.
  728. .. _class_@GlobalScope_constant_KEY_F19:
  729. .. rst-class:: classref-enumeration-constant
  730. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F19** = ``4194350``
  731. F19 key.
  732. .. _class_@GlobalScope_constant_KEY_F20:
  733. .. rst-class:: classref-enumeration-constant
  734. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F20** = ``4194351``
  735. F20 key.
  736. .. _class_@GlobalScope_constant_KEY_F21:
  737. .. rst-class:: classref-enumeration-constant
  738. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F21** = ``4194352``
  739. F21 key.
  740. .. _class_@GlobalScope_constant_KEY_F22:
  741. .. rst-class:: classref-enumeration-constant
  742. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F22** = ``4194353``
  743. F22 key.
  744. .. _class_@GlobalScope_constant_KEY_F23:
  745. .. rst-class:: classref-enumeration-constant
  746. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F23** = ``4194354``
  747. F23 key.
  748. .. _class_@GlobalScope_constant_KEY_F24:
  749. .. rst-class:: classref-enumeration-constant
  750. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F24** = ``4194355``
  751. F24 key.
  752. .. _class_@GlobalScope_constant_KEY_F25:
  753. .. rst-class:: classref-enumeration-constant
  754. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F25** = ``4194356``
  755. F25 key. Only supported on macOS and Linux due to a Windows limitation.
  756. .. _class_@GlobalScope_constant_KEY_F26:
  757. .. rst-class:: classref-enumeration-constant
  758. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F26** = ``4194357``
  759. F26 key. Only supported on macOS and Linux due to a Windows limitation.
  760. .. _class_@GlobalScope_constant_KEY_F27:
  761. .. rst-class:: classref-enumeration-constant
  762. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F27** = ``4194358``
  763. F27 key. Only supported on macOS and Linux due to a Windows limitation.
  764. .. _class_@GlobalScope_constant_KEY_F28:
  765. .. rst-class:: classref-enumeration-constant
  766. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F28** = ``4194359``
  767. F28 key. Only supported on macOS and Linux due to a Windows limitation.
  768. .. _class_@GlobalScope_constant_KEY_F29:
  769. .. rst-class:: classref-enumeration-constant
  770. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F29** = ``4194360``
  771. F29 key. Only supported on macOS and Linux due to a Windows limitation.
  772. .. _class_@GlobalScope_constant_KEY_F30:
  773. .. rst-class:: classref-enumeration-constant
  774. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F30** = ``4194361``
  775. F30 key. Only supported on macOS and Linux due to a Windows limitation.
  776. .. _class_@GlobalScope_constant_KEY_F31:
  777. .. rst-class:: classref-enumeration-constant
  778. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F31** = ``4194362``
  779. F31 key. Only supported on macOS and Linux due to a Windows limitation.
  780. .. _class_@GlobalScope_constant_KEY_F32:
  781. .. rst-class:: classref-enumeration-constant
  782. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F32** = ``4194363``
  783. F32 key. Only supported on macOS and Linux due to a Windows limitation.
  784. .. _class_@GlobalScope_constant_KEY_F33:
  785. .. rst-class:: classref-enumeration-constant
  786. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F33** = ``4194364``
  787. F33 key. Only supported on macOS and Linux due to a Windows limitation.
  788. .. _class_@GlobalScope_constant_KEY_F34:
  789. .. rst-class:: classref-enumeration-constant
  790. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F34** = ``4194365``
  791. F34 key. Only supported on macOS and Linux due to a Windows limitation.
  792. .. _class_@GlobalScope_constant_KEY_F35:
  793. .. rst-class:: classref-enumeration-constant
  794. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F35** = ``4194366``
  795. F35 key. Only supported on macOS and Linux due to a Windows limitation.
  796. .. _class_@GlobalScope_constant_KEY_KP_MULTIPLY:
  797. .. rst-class:: classref-enumeration-constant
  798. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_MULTIPLY** = ``4194433``
  799. Multiply (\*) key on the numeric keypad.
  800. .. _class_@GlobalScope_constant_KEY_KP_DIVIDE:
  801. .. rst-class:: classref-enumeration-constant
  802. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_DIVIDE** = ``4194434``
  803. Divide (/) key on the numeric keypad.
  804. .. _class_@GlobalScope_constant_KEY_KP_SUBTRACT:
  805. .. rst-class:: classref-enumeration-constant
  806. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_SUBTRACT** = ``4194435``
  807. Subtract (-) key on the numeric keypad.
  808. .. _class_@GlobalScope_constant_KEY_KP_PERIOD:
  809. .. rst-class:: classref-enumeration-constant
  810. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_PERIOD** = ``4194436``
  811. Period (.) key on the numeric keypad.
  812. .. _class_@GlobalScope_constant_KEY_KP_ADD:
  813. .. rst-class:: classref-enumeration-constant
  814. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_ADD** = ``4194437``
  815. Add (+) key on the numeric keypad.
  816. .. _class_@GlobalScope_constant_KEY_KP_0:
  817. .. rst-class:: classref-enumeration-constant
  818. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_0** = ``4194438``
  819. Number 0 on the numeric keypad.
  820. .. _class_@GlobalScope_constant_KEY_KP_1:
  821. .. rst-class:: classref-enumeration-constant
  822. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_1** = ``4194439``
  823. Number 1 on the numeric keypad.
  824. .. _class_@GlobalScope_constant_KEY_KP_2:
  825. .. rst-class:: classref-enumeration-constant
  826. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_2** = ``4194440``
  827. Number 2 on the numeric keypad.
  828. .. _class_@GlobalScope_constant_KEY_KP_3:
  829. .. rst-class:: classref-enumeration-constant
  830. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_3** = ``4194441``
  831. Number 3 on the numeric keypad.
  832. .. _class_@GlobalScope_constant_KEY_KP_4:
  833. .. rst-class:: classref-enumeration-constant
  834. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_4** = ``4194442``
  835. Number 4 on the numeric keypad.
  836. .. _class_@GlobalScope_constant_KEY_KP_5:
  837. .. rst-class:: classref-enumeration-constant
  838. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_5** = ``4194443``
  839. Number 5 on the numeric keypad.
  840. .. _class_@GlobalScope_constant_KEY_KP_6:
  841. .. rst-class:: classref-enumeration-constant
  842. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_6** = ``4194444``
  843. Number 6 on the numeric keypad.
  844. .. _class_@GlobalScope_constant_KEY_KP_7:
  845. .. rst-class:: classref-enumeration-constant
  846. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_7** = ``4194445``
  847. Number 7 on the numeric keypad.
  848. .. _class_@GlobalScope_constant_KEY_KP_8:
  849. .. rst-class:: classref-enumeration-constant
  850. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_8** = ``4194446``
  851. Number 8 on the numeric keypad.
  852. .. _class_@GlobalScope_constant_KEY_KP_9:
  853. .. rst-class:: classref-enumeration-constant
  854. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_9** = ``4194447``
  855. Number 9 on the numeric keypad.
  856. .. _class_@GlobalScope_constant_KEY_MENU:
  857. .. rst-class:: classref-enumeration-constant
  858. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MENU** = ``4194370``
  859. Context menu key.
  860. .. _class_@GlobalScope_constant_KEY_HYPER:
  861. .. rst-class:: classref-enumeration-constant
  862. :ref:`Key<enum_@GlobalScope_Key>` **KEY_HYPER** = ``4194371``
  863. Hyper key. (On Linux/X11 only).
  864. .. _class_@GlobalScope_constant_KEY_HELP:
  865. .. rst-class:: classref-enumeration-constant
  866. :ref:`Key<enum_@GlobalScope_Key>` **KEY_HELP** = ``4194373``
  867. Help key.
  868. .. _class_@GlobalScope_constant_KEY_BACK:
  869. .. rst-class:: classref-enumeration-constant
  870. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BACK** = ``4194376``
  871. Media back key. Not to be confused with the Back button on an Android device.
  872. .. _class_@GlobalScope_constant_KEY_FORWARD:
  873. .. rst-class:: classref-enumeration-constant
  874. :ref:`Key<enum_@GlobalScope_Key>` **KEY_FORWARD** = ``4194377``
  875. Media forward key.
  876. .. _class_@GlobalScope_constant_KEY_STOP:
  877. .. rst-class:: classref-enumeration-constant
  878. :ref:`Key<enum_@GlobalScope_Key>` **KEY_STOP** = ``4194378``
  879. Media stop key.
  880. .. _class_@GlobalScope_constant_KEY_REFRESH:
  881. .. rst-class:: classref-enumeration-constant
  882. :ref:`Key<enum_@GlobalScope_Key>` **KEY_REFRESH** = ``4194379``
  883. Media refresh key.
  884. .. _class_@GlobalScope_constant_KEY_VOLUMEDOWN:
  885. .. rst-class:: classref-enumeration-constant
  886. :ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEDOWN** = ``4194380``
  887. Volume down key.
  888. .. _class_@GlobalScope_constant_KEY_VOLUMEMUTE:
  889. .. rst-class:: classref-enumeration-constant
  890. :ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEMUTE** = ``4194381``
  891. Mute volume key.
  892. .. _class_@GlobalScope_constant_KEY_VOLUMEUP:
  893. .. rst-class:: classref-enumeration-constant
  894. :ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEUP** = ``4194382``
  895. Volume up key.
  896. .. _class_@GlobalScope_constant_KEY_MEDIAPLAY:
  897. .. rst-class:: classref-enumeration-constant
  898. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIAPLAY** = ``4194388``
  899. Media play key.
  900. .. _class_@GlobalScope_constant_KEY_MEDIASTOP:
  901. .. rst-class:: classref-enumeration-constant
  902. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIASTOP** = ``4194389``
  903. Media stop key.
  904. .. _class_@GlobalScope_constant_KEY_MEDIAPREVIOUS:
  905. .. rst-class:: classref-enumeration-constant
  906. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIAPREVIOUS** = ``4194390``
  907. Previous song key.
  908. .. _class_@GlobalScope_constant_KEY_MEDIANEXT:
  909. .. rst-class:: classref-enumeration-constant
  910. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIANEXT** = ``4194391``
  911. Next song key.
  912. .. _class_@GlobalScope_constant_KEY_MEDIARECORD:
  913. .. rst-class:: classref-enumeration-constant
  914. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIARECORD** = ``4194392``
  915. Media record key.
  916. .. _class_@GlobalScope_constant_KEY_HOMEPAGE:
  917. .. rst-class:: classref-enumeration-constant
  918. :ref:`Key<enum_@GlobalScope_Key>` **KEY_HOMEPAGE** = ``4194393``
  919. Home page key.
  920. .. _class_@GlobalScope_constant_KEY_FAVORITES:
  921. .. rst-class:: classref-enumeration-constant
  922. :ref:`Key<enum_@GlobalScope_Key>` **KEY_FAVORITES** = ``4194394``
  923. Favorites key.
  924. .. _class_@GlobalScope_constant_KEY_SEARCH:
  925. .. rst-class:: classref-enumeration-constant
  926. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SEARCH** = ``4194395``
  927. Search key.
  928. .. _class_@GlobalScope_constant_KEY_STANDBY:
  929. .. rst-class:: classref-enumeration-constant
  930. :ref:`Key<enum_@GlobalScope_Key>` **KEY_STANDBY** = ``4194396``
  931. Standby key.
  932. .. _class_@GlobalScope_constant_KEY_OPENURL:
  933. .. rst-class:: classref-enumeration-constant
  934. :ref:`Key<enum_@GlobalScope_Key>` **KEY_OPENURL** = ``4194397``
  935. Open URL / Launch Browser key.
  936. .. _class_@GlobalScope_constant_KEY_LAUNCHMAIL:
  937. .. rst-class:: classref-enumeration-constant
  938. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHMAIL** = ``4194398``
  939. Launch Mail key.
  940. .. _class_@GlobalScope_constant_KEY_LAUNCHMEDIA:
  941. .. rst-class:: classref-enumeration-constant
  942. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHMEDIA** = ``4194399``
  943. Launch Media key.
  944. .. _class_@GlobalScope_constant_KEY_LAUNCH0:
  945. .. rst-class:: classref-enumeration-constant
  946. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH0** = ``4194400``
  947. Launch Shortcut 0 key.
  948. .. _class_@GlobalScope_constant_KEY_LAUNCH1:
  949. .. rst-class:: classref-enumeration-constant
  950. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH1** = ``4194401``
  951. Launch Shortcut 1 key.
  952. .. _class_@GlobalScope_constant_KEY_LAUNCH2:
  953. .. rst-class:: classref-enumeration-constant
  954. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH2** = ``4194402``
  955. Launch Shortcut 2 key.
  956. .. _class_@GlobalScope_constant_KEY_LAUNCH3:
  957. .. rst-class:: classref-enumeration-constant
  958. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH3** = ``4194403``
  959. Launch Shortcut 3 key.
  960. .. _class_@GlobalScope_constant_KEY_LAUNCH4:
  961. .. rst-class:: classref-enumeration-constant
  962. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH4** = ``4194404``
  963. Launch Shortcut 4 key.
  964. .. _class_@GlobalScope_constant_KEY_LAUNCH5:
  965. .. rst-class:: classref-enumeration-constant
  966. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH5** = ``4194405``
  967. Launch Shortcut 5 key.
  968. .. _class_@GlobalScope_constant_KEY_LAUNCH6:
  969. .. rst-class:: classref-enumeration-constant
  970. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH6** = ``4194406``
  971. Launch Shortcut 6 key.
  972. .. _class_@GlobalScope_constant_KEY_LAUNCH7:
  973. .. rst-class:: classref-enumeration-constant
  974. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH7** = ``4194407``
  975. Launch Shortcut 7 key.
  976. .. _class_@GlobalScope_constant_KEY_LAUNCH8:
  977. .. rst-class:: classref-enumeration-constant
  978. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH8** = ``4194408``
  979. Launch Shortcut 8 key.
  980. .. _class_@GlobalScope_constant_KEY_LAUNCH9:
  981. .. rst-class:: classref-enumeration-constant
  982. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH9** = ``4194409``
  983. Launch Shortcut 9 key.
  984. .. _class_@GlobalScope_constant_KEY_LAUNCHA:
  985. .. rst-class:: classref-enumeration-constant
  986. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHA** = ``4194410``
  987. Launch Shortcut A key.
  988. .. _class_@GlobalScope_constant_KEY_LAUNCHB:
  989. .. rst-class:: classref-enumeration-constant
  990. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHB** = ``4194411``
  991. Launch Shortcut B key.
  992. .. _class_@GlobalScope_constant_KEY_LAUNCHC:
  993. .. rst-class:: classref-enumeration-constant
  994. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHC** = ``4194412``
  995. Launch Shortcut C key.
  996. .. _class_@GlobalScope_constant_KEY_LAUNCHD:
  997. .. rst-class:: classref-enumeration-constant
  998. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHD** = ``4194413``
  999. Launch Shortcut D key.
  1000. .. _class_@GlobalScope_constant_KEY_LAUNCHE:
  1001. .. rst-class:: classref-enumeration-constant
  1002. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHE** = ``4194414``
  1003. Launch Shortcut E key.
  1004. .. _class_@GlobalScope_constant_KEY_LAUNCHF:
  1005. .. rst-class:: classref-enumeration-constant
  1006. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHF** = ``4194415``
  1007. Launch Shortcut F key.
  1008. .. _class_@GlobalScope_constant_KEY_GLOBE:
  1009. .. rst-class:: classref-enumeration-constant
  1010. :ref:`Key<enum_@GlobalScope_Key>` **KEY_GLOBE** = ``4194416``
  1011. "Globe" key on Mac / iPad keyboard.
  1012. .. _class_@GlobalScope_constant_KEY_KEYBOARD:
  1013. .. rst-class:: classref-enumeration-constant
  1014. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KEYBOARD** = ``4194417``
  1015. "On-screen keyboard" key on iPad keyboard.
  1016. .. _class_@GlobalScope_constant_KEY_JIS_EISU:
  1017. .. rst-class:: classref-enumeration-constant
  1018. :ref:`Key<enum_@GlobalScope_Key>` **KEY_JIS_EISU** = ``4194418``
  1019. 英数 key on Mac keyboard.
  1020. .. _class_@GlobalScope_constant_KEY_JIS_KANA:
  1021. .. rst-class:: classref-enumeration-constant
  1022. :ref:`Key<enum_@GlobalScope_Key>` **KEY_JIS_KANA** = ``4194419``
  1023. かな key on Mac keyboard.
  1024. .. _class_@GlobalScope_constant_KEY_UNKNOWN:
  1025. .. rst-class:: classref-enumeration-constant
  1026. :ref:`Key<enum_@GlobalScope_Key>` **KEY_UNKNOWN** = ``8388607``
  1027. Unknown key.
  1028. .. _class_@GlobalScope_constant_KEY_SPACE:
  1029. .. rst-class:: classref-enumeration-constant
  1030. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SPACE** = ``32``
  1031. Space key.
  1032. .. _class_@GlobalScope_constant_KEY_EXCLAM:
  1033. .. rst-class:: classref-enumeration-constant
  1034. :ref:`Key<enum_@GlobalScope_Key>` **KEY_EXCLAM** = ``33``
  1035. ! key.
  1036. .. _class_@GlobalScope_constant_KEY_QUOTEDBL:
  1037. .. rst-class:: classref-enumeration-constant
  1038. :ref:`Key<enum_@GlobalScope_Key>` **KEY_QUOTEDBL** = ``34``
  1039. " key.
  1040. .. _class_@GlobalScope_constant_KEY_NUMBERSIGN:
  1041. .. rst-class:: classref-enumeration-constant
  1042. :ref:`Key<enum_@GlobalScope_Key>` **KEY_NUMBERSIGN** = ``35``
  1043. # key.
  1044. .. _class_@GlobalScope_constant_KEY_DOLLAR:
  1045. .. rst-class:: classref-enumeration-constant
  1046. :ref:`Key<enum_@GlobalScope_Key>` **KEY_DOLLAR** = ``36``
  1047. $ key.
  1048. .. _class_@GlobalScope_constant_KEY_PERCENT:
  1049. .. rst-class:: classref-enumeration-constant
  1050. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PERCENT** = ``37``
  1051. % key.
  1052. .. _class_@GlobalScope_constant_KEY_AMPERSAND:
  1053. .. rst-class:: classref-enumeration-constant
  1054. :ref:`Key<enum_@GlobalScope_Key>` **KEY_AMPERSAND** = ``38``
  1055. & key.
  1056. .. _class_@GlobalScope_constant_KEY_APOSTROPHE:
  1057. .. rst-class:: classref-enumeration-constant
  1058. :ref:`Key<enum_@GlobalScope_Key>` **KEY_APOSTROPHE** = ``39``
  1059. ' key.
  1060. .. _class_@GlobalScope_constant_KEY_PARENLEFT:
  1061. .. rst-class:: classref-enumeration-constant
  1062. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PARENLEFT** = ``40``
  1063. ( key.
  1064. .. _class_@GlobalScope_constant_KEY_PARENRIGHT:
  1065. .. rst-class:: classref-enumeration-constant
  1066. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PARENRIGHT** = ``41``
  1067. ) key.
  1068. .. _class_@GlobalScope_constant_KEY_ASTERISK:
  1069. .. rst-class:: classref-enumeration-constant
  1070. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ASTERISK** = ``42``
  1071. \* key.
  1072. .. _class_@GlobalScope_constant_KEY_PLUS:
  1073. .. rst-class:: classref-enumeration-constant
  1074. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PLUS** = ``43``
  1075. + key.
  1076. .. _class_@GlobalScope_constant_KEY_COMMA:
  1077. .. rst-class:: classref-enumeration-constant
  1078. :ref:`Key<enum_@GlobalScope_Key>` **KEY_COMMA** = ``44``
  1079. , key.
  1080. .. _class_@GlobalScope_constant_KEY_MINUS:
  1081. .. rst-class:: classref-enumeration-constant
  1082. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MINUS** = ``45``
  1083. - key.
  1084. .. _class_@GlobalScope_constant_KEY_PERIOD:
  1085. .. rst-class:: classref-enumeration-constant
  1086. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PERIOD** = ``46``
  1087. . key.
  1088. .. _class_@GlobalScope_constant_KEY_SLASH:
  1089. .. rst-class:: classref-enumeration-constant
  1090. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SLASH** = ``47``
  1091. / key.
  1092. .. _class_@GlobalScope_constant_KEY_0:
  1093. .. rst-class:: classref-enumeration-constant
  1094. :ref:`Key<enum_@GlobalScope_Key>` **KEY_0** = ``48``
  1095. Number 0 key.
  1096. .. _class_@GlobalScope_constant_KEY_1:
  1097. .. rst-class:: classref-enumeration-constant
  1098. :ref:`Key<enum_@GlobalScope_Key>` **KEY_1** = ``49``
  1099. Number 1 key.
  1100. .. _class_@GlobalScope_constant_KEY_2:
  1101. .. rst-class:: classref-enumeration-constant
  1102. :ref:`Key<enum_@GlobalScope_Key>` **KEY_2** = ``50``
  1103. Number 2 key.
  1104. .. _class_@GlobalScope_constant_KEY_3:
  1105. .. rst-class:: classref-enumeration-constant
  1106. :ref:`Key<enum_@GlobalScope_Key>` **KEY_3** = ``51``
  1107. Number 3 key.
  1108. .. _class_@GlobalScope_constant_KEY_4:
  1109. .. rst-class:: classref-enumeration-constant
  1110. :ref:`Key<enum_@GlobalScope_Key>` **KEY_4** = ``52``
  1111. Number 4 key.
  1112. .. _class_@GlobalScope_constant_KEY_5:
  1113. .. rst-class:: classref-enumeration-constant
  1114. :ref:`Key<enum_@GlobalScope_Key>` **KEY_5** = ``53``
  1115. Number 5 key.
  1116. .. _class_@GlobalScope_constant_KEY_6:
  1117. .. rst-class:: classref-enumeration-constant
  1118. :ref:`Key<enum_@GlobalScope_Key>` **KEY_6** = ``54``
  1119. Number 6 key.
  1120. .. _class_@GlobalScope_constant_KEY_7:
  1121. .. rst-class:: classref-enumeration-constant
  1122. :ref:`Key<enum_@GlobalScope_Key>` **KEY_7** = ``55``
  1123. Number 7 key.
  1124. .. _class_@GlobalScope_constant_KEY_8:
  1125. .. rst-class:: classref-enumeration-constant
  1126. :ref:`Key<enum_@GlobalScope_Key>` **KEY_8** = ``56``
  1127. Number 8 key.
  1128. .. _class_@GlobalScope_constant_KEY_9:
  1129. .. rst-class:: classref-enumeration-constant
  1130. :ref:`Key<enum_@GlobalScope_Key>` **KEY_9** = ``57``
  1131. Number 9 key.
  1132. .. _class_@GlobalScope_constant_KEY_COLON:
  1133. .. rst-class:: classref-enumeration-constant
  1134. :ref:`Key<enum_@GlobalScope_Key>` **KEY_COLON** = ``58``
  1135. : key.
  1136. .. _class_@GlobalScope_constant_KEY_SEMICOLON:
  1137. .. rst-class:: classref-enumeration-constant
  1138. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SEMICOLON** = ``59``
  1139. ; key.
  1140. .. _class_@GlobalScope_constant_KEY_LESS:
  1141. .. rst-class:: classref-enumeration-constant
  1142. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LESS** = ``60``
  1143. < key.
  1144. .. _class_@GlobalScope_constant_KEY_EQUAL:
  1145. .. rst-class:: classref-enumeration-constant
  1146. :ref:`Key<enum_@GlobalScope_Key>` **KEY_EQUAL** = ``61``
  1147. = key.
  1148. .. _class_@GlobalScope_constant_KEY_GREATER:
  1149. .. rst-class:: classref-enumeration-constant
  1150. :ref:`Key<enum_@GlobalScope_Key>` **KEY_GREATER** = ``62``
  1151. > key.
  1152. .. _class_@GlobalScope_constant_KEY_QUESTION:
  1153. .. rst-class:: classref-enumeration-constant
  1154. :ref:`Key<enum_@GlobalScope_Key>` **KEY_QUESTION** = ``63``
  1155. ? key.
  1156. .. _class_@GlobalScope_constant_KEY_AT:
  1157. .. rst-class:: classref-enumeration-constant
  1158. :ref:`Key<enum_@GlobalScope_Key>` **KEY_AT** = ``64``
  1159. @ key.
  1160. .. _class_@GlobalScope_constant_KEY_A:
  1161. .. rst-class:: classref-enumeration-constant
  1162. :ref:`Key<enum_@GlobalScope_Key>` **KEY_A** = ``65``
  1163. A key.
  1164. .. _class_@GlobalScope_constant_KEY_B:
  1165. .. rst-class:: classref-enumeration-constant
  1166. :ref:`Key<enum_@GlobalScope_Key>` **KEY_B** = ``66``
  1167. B key.
  1168. .. _class_@GlobalScope_constant_KEY_C:
  1169. .. rst-class:: classref-enumeration-constant
  1170. :ref:`Key<enum_@GlobalScope_Key>` **KEY_C** = ``67``
  1171. C key.
  1172. .. _class_@GlobalScope_constant_KEY_D:
  1173. .. rst-class:: classref-enumeration-constant
  1174. :ref:`Key<enum_@GlobalScope_Key>` **KEY_D** = ``68``
  1175. D key.
  1176. .. _class_@GlobalScope_constant_KEY_E:
  1177. .. rst-class:: classref-enumeration-constant
  1178. :ref:`Key<enum_@GlobalScope_Key>` **KEY_E** = ``69``
  1179. E key.
  1180. .. _class_@GlobalScope_constant_KEY_F:
  1181. .. rst-class:: classref-enumeration-constant
  1182. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F** = ``70``
  1183. F key.
  1184. .. _class_@GlobalScope_constant_KEY_G:
  1185. .. rst-class:: classref-enumeration-constant
  1186. :ref:`Key<enum_@GlobalScope_Key>` **KEY_G** = ``71``
  1187. G key.
  1188. .. _class_@GlobalScope_constant_KEY_H:
  1189. .. rst-class:: classref-enumeration-constant
  1190. :ref:`Key<enum_@GlobalScope_Key>` **KEY_H** = ``72``
  1191. H key.
  1192. .. _class_@GlobalScope_constant_KEY_I:
  1193. .. rst-class:: classref-enumeration-constant
  1194. :ref:`Key<enum_@GlobalScope_Key>` **KEY_I** = ``73``
  1195. I key.
  1196. .. _class_@GlobalScope_constant_KEY_J:
  1197. .. rst-class:: classref-enumeration-constant
  1198. :ref:`Key<enum_@GlobalScope_Key>` **KEY_J** = ``74``
  1199. J key.
  1200. .. _class_@GlobalScope_constant_KEY_K:
  1201. .. rst-class:: classref-enumeration-constant
  1202. :ref:`Key<enum_@GlobalScope_Key>` **KEY_K** = ``75``
  1203. K key.
  1204. .. _class_@GlobalScope_constant_KEY_L:
  1205. .. rst-class:: classref-enumeration-constant
  1206. :ref:`Key<enum_@GlobalScope_Key>` **KEY_L** = ``76``
  1207. L key.
  1208. .. _class_@GlobalScope_constant_KEY_M:
  1209. .. rst-class:: classref-enumeration-constant
  1210. :ref:`Key<enum_@GlobalScope_Key>` **KEY_M** = ``77``
  1211. M key.
  1212. .. _class_@GlobalScope_constant_KEY_N:
  1213. .. rst-class:: classref-enumeration-constant
  1214. :ref:`Key<enum_@GlobalScope_Key>` **KEY_N** = ``78``
  1215. N key.
  1216. .. _class_@GlobalScope_constant_KEY_O:
  1217. .. rst-class:: classref-enumeration-constant
  1218. :ref:`Key<enum_@GlobalScope_Key>` **KEY_O** = ``79``
  1219. O key.
  1220. .. _class_@GlobalScope_constant_KEY_P:
  1221. .. rst-class:: classref-enumeration-constant
  1222. :ref:`Key<enum_@GlobalScope_Key>` **KEY_P** = ``80``
  1223. P key.
  1224. .. _class_@GlobalScope_constant_KEY_Q:
  1225. .. rst-class:: classref-enumeration-constant
  1226. :ref:`Key<enum_@GlobalScope_Key>` **KEY_Q** = ``81``
  1227. Q key.
  1228. .. _class_@GlobalScope_constant_KEY_R:
  1229. .. rst-class:: classref-enumeration-constant
  1230. :ref:`Key<enum_@GlobalScope_Key>` **KEY_R** = ``82``
  1231. R key.
  1232. .. _class_@GlobalScope_constant_KEY_S:
  1233. .. rst-class:: classref-enumeration-constant
  1234. :ref:`Key<enum_@GlobalScope_Key>` **KEY_S** = ``83``
  1235. S key.
  1236. .. _class_@GlobalScope_constant_KEY_T:
  1237. .. rst-class:: classref-enumeration-constant
  1238. :ref:`Key<enum_@GlobalScope_Key>` **KEY_T** = ``84``
  1239. T key.
  1240. .. _class_@GlobalScope_constant_KEY_U:
  1241. .. rst-class:: classref-enumeration-constant
  1242. :ref:`Key<enum_@GlobalScope_Key>` **KEY_U** = ``85``
  1243. U key.
  1244. .. _class_@GlobalScope_constant_KEY_V:
  1245. .. rst-class:: classref-enumeration-constant
  1246. :ref:`Key<enum_@GlobalScope_Key>` **KEY_V** = ``86``
  1247. V key.
  1248. .. _class_@GlobalScope_constant_KEY_W:
  1249. .. rst-class:: classref-enumeration-constant
  1250. :ref:`Key<enum_@GlobalScope_Key>` **KEY_W** = ``87``
  1251. W key.
  1252. .. _class_@GlobalScope_constant_KEY_X:
  1253. .. rst-class:: classref-enumeration-constant
  1254. :ref:`Key<enum_@GlobalScope_Key>` **KEY_X** = ``88``
  1255. X key.
  1256. .. _class_@GlobalScope_constant_KEY_Y:
  1257. .. rst-class:: classref-enumeration-constant
  1258. :ref:`Key<enum_@GlobalScope_Key>` **KEY_Y** = ``89``
  1259. Y key.
  1260. .. _class_@GlobalScope_constant_KEY_Z:
  1261. .. rst-class:: classref-enumeration-constant
  1262. :ref:`Key<enum_@GlobalScope_Key>` **KEY_Z** = ``90``
  1263. Z key.
  1264. .. _class_@GlobalScope_constant_KEY_BRACKETLEFT:
  1265. .. rst-class:: classref-enumeration-constant
  1266. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACKETLEFT** = ``91``
  1267. [ key.
  1268. .. _class_@GlobalScope_constant_KEY_BACKSLASH:
  1269. .. rst-class:: classref-enumeration-constant
  1270. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKSLASH** = ``92``
  1271. \\ key.
  1272. .. _class_@GlobalScope_constant_KEY_BRACKETRIGHT:
  1273. .. rst-class:: classref-enumeration-constant
  1274. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACKETRIGHT** = ``93``
  1275. ] key.
  1276. .. _class_@GlobalScope_constant_KEY_ASCIICIRCUM:
  1277. .. rst-class:: classref-enumeration-constant
  1278. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ASCIICIRCUM** = ``94``
  1279. ^ key.
  1280. .. _class_@GlobalScope_constant_KEY_UNDERSCORE:
  1281. .. rst-class:: classref-enumeration-constant
  1282. :ref:`Key<enum_@GlobalScope_Key>` **KEY_UNDERSCORE** = ``95``
  1283. \_ key.
  1284. .. _class_@GlobalScope_constant_KEY_QUOTELEFT:
  1285. .. rst-class:: classref-enumeration-constant
  1286. :ref:`Key<enum_@GlobalScope_Key>` **KEY_QUOTELEFT** = ``96``
  1287. ` key.
  1288. .. _class_@GlobalScope_constant_KEY_BRACELEFT:
  1289. .. rst-class:: classref-enumeration-constant
  1290. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACELEFT** = ``123``
  1291. { key.
  1292. .. _class_@GlobalScope_constant_KEY_BAR:
  1293. .. rst-class:: classref-enumeration-constant
  1294. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BAR** = ``124``
  1295. | key.
  1296. .. _class_@GlobalScope_constant_KEY_BRACERIGHT:
  1297. .. rst-class:: classref-enumeration-constant
  1298. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACERIGHT** = ``125``
  1299. } key.
  1300. .. _class_@GlobalScope_constant_KEY_ASCIITILDE:
  1301. .. rst-class:: classref-enumeration-constant
  1302. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ASCIITILDE** = ``126``
  1303. ~ key.
  1304. .. _class_@GlobalScope_constant_KEY_YEN:
  1305. .. rst-class:: classref-enumeration-constant
  1306. :ref:`Key<enum_@GlobalScope_Key>` **KEY_YEN** = ``165``
  1307. ¥ key.
  1308. .. _class_@GlobalScope_constant_KEY_SECTION:
  1309. .. rst-class:: classref-enumeration-constant
  1310. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SECTION** = ``167``
  1311. § key.
  1312. .. rst-class:: classref-item-separator
  1313. ----
  1314. .. _enum_@GlobalScope_KeyModifierMask:
  1315. .. rst-class:: classref-enumeration
  1316. flags **KeyModifierMask**: :ref:`🔗<enum_@GlobalScope_KeyModifierMask>`
  1317. .. _class_@GlobalScope_constant_KEY_CODE_MASK:
  1318. .. rst-class:: classref-enumeration-constant
  1319. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_CODE_MASK** = ``8388607``
  1320. Key Code mask.
  1321. .. _class_@GlobalScope_constant_KEY_MODIFIER_MASK:
  1322. .. rst-class:: classref-enumeration-constant
  1323. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MODIFIER_MASK** = ``532676608``
  1324. Modifier key mask.
  1325. .. _class_@GlobalScope_constant_KEY_MASK_CMD_OR_CTRL:
  1326. .. rst-class:: classref-enumeration-constant
  1327. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_CMD_OR_CTRL** = ``16777216``
  1328. Automatically remapped to :ref:`KEY_META<class_@GlobalScope_constant_KEY_META>` on macOS and :ref:`KEY_CTRL<class_@GlobalScope_constant_KEY_CTRL>` on other platforms, this mask is never set in the actual events, and should be used for key mapping only.
  1329. .. _class_@GlobalScope_constant_KEY_MASK_SHIFT:
  1330. .. rst-class:: classref-enumeration-constant
  1331. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_SHIFT** = ``33554432``
  1332. Shift key mask.
  1333. .. _class_@GlobalScope_constant_KEY_MASK_ALT:
  1334. .. rst-class:: classref-enumeration-constant
  1335. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_ALT** = ``67108864``
  1336. Alt or Option (on macOS) key mask.
  1337. .. _class_@GlobalScope_constant_KEY_MASK_META:
  1338. .. rst-class:: classref-enumeration-constant
  1339. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_META** = ``134217728``
  1340. Command (on macOS) or Meta/Windows key mask.
  1341. .. _class_@GlobalScope_constant_KEY_MASK_CTRL:
  1342. .. rst-class:: classref-enumeration-constant
  1343. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_CTRL** = ``268435456``
  1344. Control key mask.
  1345. .. _class_@GlobalScope_constant_KEY_MASK_KPAD:
  1346. .. rst-class:: classref-enumeration-constant
  1347. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_KPAD** = ``536870912``
  1348. Keypad key mask.
  1349. .. _class_@GlobalScope_constant_KEY_MASK_GROUP_SWITCH:
  1350. .. rst-class:: classref-enumeration-constant
  1351. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_GROUP_SWITCH** = ``1073741824``
  1352. Group Switch key mask.
  1353. .. rst-class:: classref-item-separator
  1354. ----
  1355. .. _enum_@GlobalScope_KeyLocation:
  1356. .. rst-class:: classref-enumeration
  1357. enum **KeyLocation**: :ref:`🔗<enum_@GlobalScope_KeyLocation>`
  1358. .. _class_@GlobalScope_constant_KEY_LOCATION_UNSPECIFIED:
  1359. .. rst-class:: classref-enumeration-constant
  1360. :ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_UNSPECIFIED** = ``0``
  1361. Used for keys which only appear once, or when a comparison doesn't need to differentiate the ``LEFT`` and ``RIGHT`` versions.
  1362. For example, when using :ref:`InputEvent.is_match<class_InputEvent_method_is_match>`, an event which has :ref:`KEY_LOCATION_UNSPECIFIED<class_@GlobalScope_constant_KEY_LOCATION_UNSPECIFIED>` will match any :ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` on the passed event.
  1363. .. _class_@GlobalScope_constant_KEY_LOCATION_LEFT:
  1364. .. rst-class:: classref-enumeration-constant
  1365. :ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_LEFT** = ``1``
  1366. A key which is to the left of its twin.
  1367. .. _class_@GlobalScope_constant_KEY_LOCATION_RIGHT:
  1368. .. rst-class:: classref-enumeration-constant
  1369. :ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_RIGHT** = ``2``
  1370. A key which is to the right of its twin.
  1371. .. rst-class:: classref-item-separator
  1372. ----
  1373. .. _enum_@GlobalScope_MouseButton:
  1374. .. rst-class:: classref-enumeration
  1375. enum **MouseButton**: :ref:`🔗<enum_@GlobalScope_MouseButton>`
  1376. .. _class_@GlobalScope_constant_MOUSE_BUTTON_NONE:
  1377. .. rst-class:: classref-enumeration-constant
  1378. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_NONE** = ``0``
  1379. Enum value which doesn't correspond to any mouse button. This is used to initialize :ref:`MouseButton<enum_@GlobalScope_MouseButton>` properties with a generic state.
  1380. .. _class_@GlobalScope_constant_MOUSE_BUTTON_LEFT:
  1381. .. rst-class:: classref-enumeration-constant
  1382. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_LEFT** = ``1``
  1383. Primary mouse button, usually assigned to the left button.
  1384. .. _class_@GlobalScope_constant_MOUSE_BUTTON_RIGHT:
  1385. .. rst-class:: classref-enumeration-constant
  1386. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_RIGHT** = ``2``
  1387. Secondary mouse button, usually assigned to the right button.
  1388. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MIDDLE:
  1389. .. rst-class:: classref-enumeration-constant
  1390. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_MIDDLE** = ``3``
  1391. Middle mouse button.
  1392. .. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_UP:
  1393. .. rst-class:: classref-enumeration-constant
  1394. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_UP** = ``4``
  1395. Mouse wheel scrolling up.
  1396. .. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_DOWN:
  1397. .. rst-class:: classref-enumeration-constant
  1398. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_DOWN** = ``5``
  1399. Mouse wheel scrolling down.
  1400. .. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_LEFT:
  1401. .. rst-class:: classref-enumeration-constant
  1402. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_LEFT** = ``6``
  1403. Mouse wheel left button (only present on some mice).
  1404. .. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_RIGHT:
  1405. .. rst-class:: classref-enumeration-constant
  1406. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_RIGHT** = ``7``
  1407. Mouse wheel right button (only present on some mice).
  1408. .. _class_@GlobalScope_constant_MOUSE_BUTTON_XBUTTON1:
  1409. .. rst-class:: classref-enumeration-constant
  1410. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_XBUTTON1** = ``8``
  1411. Extra mouse button 1. This is sometimes present, usually to the sides of the mouse.
  1412. .. _class_@GlobalScope_constant_MOUSE_BUTTON_XBUTTON2:
  1413. .. rst-class:: classref-enumeration-constant
  1414. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_XBUTTON2** = ``9``
  1415. Extra mouse button 2. This is sometimes present, usually to the sides of the mouse.
  1416. .. rst-class:: classref-item-separator
  1417. ----
  1418. .. _enum_@GlobalScope_MouseButtonMask:
  1419. .. rst-class:: classref-enumeration
  1420. flags **MouseButtonMask**: :ref:`🔗<enum_@GlobalScope_MouseButtonMask>`
  1421. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_LEFT:
  1422. .. rst-class:: classref-enumeration-constant
  1423. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_LEFT** = ``1``
  1424. Primary mouse button mask, usually for the left button.
  1425. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_RIGHT:
  1426. .. rst-class:: classref-enumeration-constant
  1427. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_RIGHT** = ``2``
  1428. Secondary mouse button mask, usually for the right button.
  1429. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MIDDLE:
  1430. .. rst-class:: classref-enumeration-constant
  1431. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MIDDLE** = ``4``
  1432. Middle mouse button mask.
  1433. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MB_XBUTTON1:
  1434. .. rst-class:: classref-enumeration-constant
  1435. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MB_XBUTTON1** = ``128``
  1436. Extra mouse button 1 mask.
  1437. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MB_XBUTTON2:
  1438. .. rst-class:: classref-enumeration-constant
  1439. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MB_XBUTTON2** = ``256``
  1440. Extra mouse button 2 mask.
  1441. .. rst-class:: classref-item-separator
  1442. ----
  1443. .. _enum_@GlobalScope_JoyButton:
  1444. .. rst-class:: classref-enumeration
  1445. enum **JoyButton**: :ref:`🔗<enum_@GlobalScope_JoyButton>`
  1446. .. _class_@GlobalScope_constant_JOY_BUTTON_INVALID:
  1447. .. rst-class:: classref-enumeration-constant
  1448. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_INVALID** = ``-1``
  1449. An invalid game controller button.
  1450. .. _class_@GlobalScope_constant_JOY_BUTTON_A:
  1451. .. rst-class:: classref-enumeration-constant
  1452. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_A** = ``0``
  1453. Game controller SDL button A. Corresponds to the bottom action button: Sony Cross, Xbox A, Nintendo B.
  1454. .. _class_@GlobalScope_constant_JOY_BUTTON_B:
  1455. .. rst-class:: classref-enumeration-constant
  1456. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_B** = ``1``
  1457. Game controller SDL button B. Corresponds to the right action button: Sony Circle, Xbox B, Nintendo A.
  1458. .. _class_@GlobalScope_constant_JOY_BUTTON_X:
  1459. .. rst-class:: classref-enumeration-constant
  1460. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_X** = ``2``
  1461. Game controller SDL button X. Corresponds to the left action button: Sony Square, Xbox X, Nintendo Y.
  1462. .. _class_@GlobalScope_constant_JOY_BUTTON_Y:
  1463. .. rst-class:: classref-enumeration-constant
  1464. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_Y** = ``3``
  1465. Game controller SDL button Y. Corresponds to the top action button: Sony Triangle, Xbox Y, Nintendo X.
  1466. .. _class_@GlobalScope_constant_JOY_BUTTON_BACK:
  1467. .. rst-class:: classref-enumeration-constant
  1468. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_BACK** = ``4``
  1469. Game controller SDL back button. Corresponds to the Sony Select, Xbox Back, Nintendo - button.
  1470. .. _class_@GlobalScope_constant_JOY_BUTTON_GUIDE:
  1471. .. rst-class:: classref-enumeration-constant
  1472. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_GUIDE** = ``5``
  1473. Game controller SDL guide button. Corresponds to the Sony PS, Xbox Home button.
  1474. .. _class_@GlobalScope_constant_JOY_BUTTON_START:
  1475. .. rst-class:: classref-enumeration-constant
  1476. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_START** = ``6``
  1477. Game controller SDL start button. Corresponds to the Sony Options, Xbox Menu, Nintendo + button.
  1478. .. _class_@GlobalScope_constant_JOY_BUTTON_LEFT_STICK:
  1479. .. rst-class:: classref-enumeration-constant
  1480. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_LEFT_STICK** = ``7``
  1481. Game controller SDL left stick button. Corresponds to the Sony L3, Xbox L/LS button.
  1482. .. _class_@GlobalScope_constant_JOY_BUTTON_RIGHT_STICK:
  1483. .. rst-class:: classref-enumeration-constant
  1484. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_RIGHT_STICK** = ``8``
  1485. Game controller SDL right stick button. Corresponds to the Sony R3, Xbox R/RS button.
  1486. .. _class_@GlobalScope_constant_JOY_BUTTON_LEFT_SHOULDER:
  1487. .. rst-class:: classref-enumeration-constant
  1488. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_LEFT_SHOULDER** = ``9``
  1489. Game controller SDL left shoulder button. Corresponds to the Sony L1, Xbox LB button.
  1490. .. _class_@GlobalScope_constant_JOY_BUTTON_RIGHT_SHOULDER:
  1491. .. rst-class:: classref-enumeration-constant
  1492. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_RIGHT_SHOULDER** = ``10``
  1493. Game controller SDL right shoulder button. Corresponds to the Sony R1, Xbox RB button.
  1494. .. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_UP:
  1495. .. rst-class:: classref-enumeration-constant
  1496. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_UP** = ``11``
  1497. Game controller D-pad up button.
  1498. .. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_DOWN:
  1499. .. rst-class:: classref-enumeration-constant
  1500. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_DOWN** = ``12``
  1501. Game controller D-pad down button.
  1502. .. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_LEFT:
  1503. .. rst-class:: classref-enumeration-constant
  1504. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_LEFT** = ``13``
  1505. Game controller D-pad left button.
  1506. .. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_RIGHT:
  1507. .. rst-class:: classref-enumeration-constant
  1508. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_RIGHT** = ``14``
  1509. Game controller D-pad right button.
  1510. .. _class_@GlobalScope_constant_JOY_BUTTON_MISC1:
  1511. .. rst-class:: classref-enumeration-constant
  1512. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_MISC1** = ``15``
  1513. Game controller SDL miscellaneous button. Corresponds to Xbox share button, PS5 microphone button, Nintendo Switch capture button.
  1514. .. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE1:
  1515. .. rst-class:: classref-enumeration-constant
  1516. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE1** = ``16``
  1517. Game controller SDL paddle 1 button.
  1518. .. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE2:
  1519. .. rst-class:: classref-enumeration-constant
  1520. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE2** = ``17``
  1521. Game controller SDL paddle 2 button.
  1522. .. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE3:
  1523. .. rst-class:: classref-enumeration-constant
  1524. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE3** = ``18``
  1525. Game controller SDL paddle 3 button.
  1526. .. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE4:
  1527. .. rst-class:: classref-enumeration-constant
  1528. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE4** = ``19``
  1529. Game controller SDL paddle 4 button.
  1530. .. _class_@GlobalScope_constant_JOY_BUTTON_TOUCHPAD:
  1531. .. rst-class:: classref-enumeration-constant
  1532. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_TOUCHPAD** = ``20``
  1533. Game controller SDL touchpad button.
  1534. .. _class_@GlobalScope_constant_JOY_BUTTON_SDL_MAX:
  1535. .. rst-class:: classref-enumeration-constant
  1536. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_SDL_MAX** = ``21``
  1537. The number of SDL game controller buttons.
  1538. .. _class_@GlobalScope_constant_JOY_BUTTON_MAX:
  1539. .. rst-class:: classref-enumeration-constant
  1540. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_MAX** = ``128``
  1541. The maximum number of game controller buttons supported by the engine. The actual limit may be lower on specific platforms:
  1542. - **Android:** Up to 36 buttons.
  1543. - **Linux:** Up to 80 buttons.
  1544. - **Windows** and **macOS:** Up to 128 buttons.
  1545. .. rst-class:: classref-item-separator
  1546. ----
  1547. .. _enum_@GlobalScope_JoyAxis:
  1548. .. rst-class:: classref-enumeration
  1549. enum **JoyAxis**: :ref:`🔗<enum_@GlobalScope_JoyAxis>`
  1550. .. _class_@GlobalScope_constant_JOY_AXIS_INVALID:
  1551. .. rst-class:: classref-enumeration-constant
  1552. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_INVALID** = ``-1``
  1553. An invalid game controller axis.
  1554. .. _class_@GlobalScope_constant_JOY_AXIS_LEFT_X:
  1555. .. rst-class:: classref-enumeration-constant
  1556. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_LEFT_X** = ``0``
  1557. Game controller left joystick x-axis.
  1558. .. _class_@GlobalScope_constant_JOY_AXIS_LEFT_Y:
  1559. .. rst-class:: classref-enumeration-constant
  1560. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_LEFT_Y** = ``1``
  1561. Game controller left joystick y-axis.
  1562. .. _class_@GlobalScope_constant_JOY_AXIS_RIGHT_X:
  1563. .. rst-class:: classref-enumeration-constant
  1564. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_RIGHT_X** = ``2``
  1565. Game controller right joystick x-axis.
  1566. .. _class_@GlobalScope_constant_JOY_AXIS_RIGHT_Y:
  1567. .. rst-class:: classref-enumeration-constant
  1568. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_RIGHT_Y** = ``3``
  1569. Game controller right joystick y-axis.
  1570. .. _class_@GlobalScope_constant_JOY_AXIS_TRIGGER_LEFT:
  1571. .. rst-class:: classref-enumeration-constant
  1572. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_TRIGGER_LEFT** = ``4``
  1573. Game controller left trigger axis.
  1574. .. _class_@GlobalScope_constant_JOY_AXIS_TRIGGER_RIGHT:
  1575. .. rst-class:: classref-enumeration-constant
  1576. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_TRIGGER_RIGHT** = ``5``
  1577. Game controller right trigger axis.
  1578. .. _class_@GlobalScope_constant_JOY_AXIS_SDL_MAX:
  1579. .. rst-class:: classref-enumeration-constant
  1580. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_SDL_MAX** = ``6``
  1581. The number of SDL game controller axes.
  1582. .. _class_@GlobalScope_constant_JOY_AXIS_MAX:
  1583. .. rst-class:: classref-enumeration-constant
  1584. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_MAX** = ``10``
  1585. The maximum number of game controller axes: OpenVR supports up to 5 Joysticks making a total of 10 axes.
  1586. .. rst-class:: classref-item-separator
  1587. ----
  1588. .. _enum_@GlobalScope_MIDIMessage:
  1589. .. rst-class:: classref-enumeration
  1590. enum **MIDIMessage**: :ref:`🔗<enum_@GlobalScope_MIDIMessage>`
  1591. .. _class_@GlobalScope_constant_MIDI_MESSAGE_NONE:
  1592. .. rst-class:: classref-enumeration-constant
  1593. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NONE** = ``0``
  1594. Does not correspond to any MIDI message. This is the default value of :ref:`InputEventMIDI.message<class_InputEventMIDI_property_message>`.
  1595. .. _class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_OFF:
  1596. .. rst-class:: classref-enumeration-constant
  1597. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NOTE_OFF** = ``8``
  1598. MIDI message sent when a note is released.
  1599. \ **Note:** Not all MIDI devices send this message; some may send :ref:`MIDI_MESSAGE_NOTE_ON<class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_ON>` with :ref:`InputEventMIDI.velocity<class_InputEventMIDI_property_velocity>` set to ``0``.
  1600. .. _class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_ON:
  1601. .. rst-class:: classref-enumeration-constant
  1602. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NOTE_ON** = ``9``
  1603. MIDI message sent when a note is pressed.
  1604. .. _class_@GlobalScope_constant_MIDI_MESSAGE_AFTERTOUCH:
  1605. .. rst-class:: classref-enumeration-constant
  1606. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_AFTERTOUCH** = ``10``
  1607. MIDI message sent to indicate a change in pressure while a note is being pressed down, also called aftertouch.
  1608. .. _class_@GlobalScope_constant_MIDI_MESSAGE_CONTROL_CHANGE:
  1609. .. rst-class:: classref-enumeration-constant
  1610. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CONTROL_CHANGE** = ``11``
  1611. MIDI message sent when a controller value changes. In a MIDI device, a controller is any input that doesn't play notes. These may include sliders for volume, balance, and panning, as well as switches and pedals. See the `General MIDI specification <https://en.wikipedia.org/wiki/General_MIDI#Controller_events>`__ for a small list.
  1612. .. _class_@GlobalScope_constant_MIDI_MESSAGE_PROGRAM_CHANGE:
  1613. .. rst-class:: classref-enumeration-constant
  1614. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_PROGRAM_CHANGE** = ``12``
  1615. MIDI message sent when the MIDI device changes its current instrument (also called *program* or *preset*).
  1616. .. _class_@GlobalScope_constant_MIDI_MESSAGE_CHANNEL_PRESSURE:
  1617. .. rst-class:: classref-enumeration-constant
  1618. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CHANNEL_PRESSURE** = ``13``
  1619. MIDI message sent to indicate a change in pressure for the whole channel. Some MIDI devices may send this instead of :ref:`MIDI_MESSAGE_AFTERTOUCH<class_@GlobalScope_constant_MIDI_MESSAGE_AFTERTOUCH>`.
  1620. .. _class_@GlobalScope_constant_MIDI_MESSAGE_PITCH_BEND:
  1621. .. rst-class:: classref-enumeration-constant
  1622. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_PITCH_BEND** = ``14``
  1623. MIDI message sent when the value of the pitch bender changes, usually a wheel on the MIDI device.
  1624. .. _class_@GlobalScope_constant_MIDI_MESSAGE_SYSTEM_EXCLUSIVE:
  1625. .. rst-class:: classref-enumeration-constant
  1626. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SYSTEM_EXCLUSIVE** = ``240``
  1627. MIDI system exclusive (SysEx) message. This type of message is not standardized and it's highly dependent on the MIDI device sending it.
  1628. \ **Note:** Getting this message's data from :ref:`InputEventMIDI<class_InputEventMIDI>` is not implemented.
  1629. .. _class_@GlobalScope_constant_MIDI_MESSAGE_QUARTER_FRAME:
  1630. .. rst-class:: classref-enumeration-constant
  1631. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_QUARTER_FRAME** = ``241``
  1632. MIDI message sent every quarter frame to keep connected MIDI devices synchronized. Related to :ref:`MIDI_MESSAGE_TIMING_CLOCK<class_@GlobalScope_constant_MIDI_MESSAGE_TIMING_CLOCK>`.
  1633. \ **Note:** Getting this message's data from :ref:`InputEventMIDI<class_InputEventMIDI>` is not implemented.
  1634. .. _class_@GlobalScope_constant_MIDI_MESSAGE_SONG_POSITION_POINTER:
  1635. .. rst-class:: classref-enumeration-constant
  1636. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SONG_POSITION_POINTER** = ``242``
  1637. MIDI message sent to jump onto a new position in the current sequence or song.
  1638. \ **Note:** Getting this message's data from :ref:`InputEventMIDI<class_InputEventMIDI>` is not implemented.
  1639. .. _class_@GlobalScope_constant_MIDI_MESSAGE_SONG_SELECT:
  1640. .. rst-class:: classref-enumeration-constant
  1641. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SONG_SELECT** = ``243``
  1642. MIDI message sent to select a sequence or song to play.
  1643. \ **Note:** Getting this message's data from :ref:`InputEventMIDI<class_InputEventMIDI>` is not implemented.
  1644. .. _class_@GlobalScope_constant_MIDI_MESSAGE_TUNE_REQUEST:
  1645. .. rst-class:: classref-enumeration-constant
  1646. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_TUNE_REQUEST** = ``246``
  1647. MIDI message sent to request a tuning calibration. Used on analog synthesizers. Most modern MIDI devices do not need this message.
  1648. .. _class_@GlobalScope_constant_MIDI_MESSAGE_TIMING_CLOCK:
  1649. .. rst-class:: classref-enumeration-constant
  1650. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_TIMING_CLOCK** = ``248``
  1651. MIDI message sent 24 times after :ref:`MIDI_MESSAGE_QUARTER_FRAME<class_@GlobalScope_constant_MIDI_MESSAGE_QUARTER_FRAME>`, to keep connected MIDI devices synchronized.
  1652. .. _class_@GlobalScope_constant_MIDI_MESSAGE_START:
  1653. .. rst-class:: classref-enumeration-constant
  1654. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_START** = ``250``
  1655. MIDI message sent to start the current sequence or song from the beginning.
  1656. .. _class_@GlobalScope_constant_MIDI_MESSAGE_CONTINUE:
  1657. .. rst-class:: classref-enumeration-constant
  1658. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CONTINUE** = ``251``
  1659. MIDI message sent to resume from the point the current sequence or song was paused.
  1660. .. _class_@GlobalScope_constant_MIDI_MESSAGE_STOP:
  1661. .. rst-class:: classref-enumeration-constant
  1662. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_STOP** = ``252``
  1663. MIDI message sent to pause the current sequence or song.
  1664. .. _class_@GlobalScope_constant_MIDI_MESSAGE_ACTIVE_SENSING:
  1665. .. rst-class:: classref-enumeration-constant
  1666. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_ACTIVE_SENSING** = ``254``
  1667. MIDI message sent repeatedly while the MIDI device is idle, to tell the receiver that the connection is alive. Most MIDI devices do not send this message.
  1668. .. _class_@GlobalScope_constant_MIDI_MESSAGE_SYSTEM_RESET:
  1669. .. rst-class:: classref-enumeration-constant
  1670. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SYSTEM_RESET** = ``255``
  1671. MIDI message sent to reset a MIDI device to its default state, as if it was just turned on. It should not be sent when the MIDI device is being turned on.
  1672. .. rst-class:: classref-item-separator
  1673. ----
  1674. .. _enum_@GlobalScope_Error:
  1675. .. rst-class:: classref-enumeration
  1676. enum **Error**: :ref:`🔗<enum_@GlobalScope_Error>`
  1677. .. _class_@GlobalScope_constant_OK:
  1678. .. rst-class:: classref-enumeration-constant
  1679. :ref:`Error<enum_@GlobalScope_Error>` **OK** = ``0``
  1680. Methods that return :ref:`Error<enum_@GlobalScope_Error>` return :ref:`OK<class_@GlobalScope_constant_OK>` when no error occurred.
  1681. Since :ref:`OK<class_@GlobalScope_constant_OK>` has value ``0``, and all other error constants are positive integers, it can also be used in boolean checks.
  1682. ::
  1683. var error = method_that_returns_error()
  1684. if error != OK:
  1685. printerr("Failure!")
  1686. # Or, alternatively:
  1687. if error:
  1688. printerr("Still failing!")
  1689. \ **Note:** Many functions do not return an error code, but will print error messages to standard output.
  1690. .. _class_@GlobalScope_constant_FAILED:
  1691. .. rst-class:: classref-enumeration-constant
  1692. :ref:`Error<enum_@GlobalScope_Error>` **FAILED** = ``1``
  1693. Generic error.
  1694. .. _class_@GlobalScope_constant_ERR_UNAVAILABLE:
  1695. .. rst-class:: classref-enumeration-constant
  1696. :ref:`Error<enum_@GlobalScope_Error>` **ERR_UNAVAILABLE** = ``2``
  1697. Unavailable error.
  1698. .. _class_@GlobalScope_constant_ERR_UNCONFIGURED:
  1699. .. rst-class:: classref-enumeration-constant
  1700. :ref:`Error<enum_@GlobalScope_Error>` **ERR_UNCONFIGURED** = ``3``
  1701. Unconfigured error.
  1702. .. _class_@GlobalScope_constant_ERR_UNAUTHORIZED:
  1703. .. rst-class:: classref-enumeration-constant
  1704. :ref:`Error<enum_@GlobalScope_Error>` **ERR_UNAUTHORIZED** = ``4``
  1705. Unauthorized error.
  1706. .. _class_@GlobalScope_constant_ERR_PARAMETER_RANGE_ERROR:
  1707. .. rst-class:: classref-enumeration-constant
  1708. :ref:`Error<enum_@GlobalScope_Error>` **ERR_PARAMETER_RANGE_ERROR** = ``5``
  1709. Parameter range error.
  1710. .. _class_@GlobalScope_constant_ERR_OUT_OF_MEMORY:
  1711. .. rst-class:: classref-enumeration-constant
  1712. :ref:`Error<enum_@GlobalScope_Error>` **ERR_OUT_OF_MEMORY** = ``6``
  1713. Out of memory (OOM) error.
  1714. .. _class_@GlobalScope_constant_ERR_FILE_NOT_FOUND:
  1715. .. rst-class:: classref-enumeration-constant
  1716. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_NOT_FOUND** = ``7``
  1717. File: Not found error.
  1718. .. _class_@GlobalScope_constant_ERR_FILE_BAD_DRIVE:
  1719. .. rst-class:: classref-enumeration-constant
  1720. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_BAD_DRIVE** = ``8``
  1721. File: Bad drive error.
  1722. .. _class_@GlobalScope_constant_ERR_FILE_BAD_PATH:
  1723. .. rst-class:: classref-enumeration-constant
  1724. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_BAD_PATH** = ``9``
  1725. File: Bad path error.
  1726. .. _class_@GlobalScope_constant_ERR_FILE_NO_PERMISSION:
  1727. .. rst-class:: classref-enumeration-constant
  1728. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_NO_PERMISSION** = ``10``
  1729. File: No permission error.
  1730. .. _class_@GlobalScope_constant_ERR_FILE_ALREADY_IN_USE:
  1731. .. rst-class:: classref-enumeration-constant
  1732. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_ALREADY_IN_USE** = ``11``
  1733. File: Already in use error.
  1734. .. _class_@GlobalScope_constant_ERR_FILE_CANT_OPEN:
  1735. .. rst-class:: classref-enumeration-constant
  1736. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_OPEN** = ``12``
  1737. File: Can't open error.
  1738. .. _class_@GlobalScope_constant_ERR_FILE_CANT_WRITE:
  1739. .. rst-class:: classref-enumeration-constant
  1740. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_WRITE** = ``13``
  1741. File: Can't write error.
  1742. .. _class_@GlobalScope_constant_ERR_FILE_CANT_READ:
  1743. .. rst-class:: classref-enumeration-constant
  1744. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_READ** = ``14``
  1745. File: Can't read error.
  1746. .. _class_@GlobalScope_constant_ERR_FILE_UNRECOGNIZED:
  1747. .. rst-class:: classref-enumeration-constant
  1748. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_UNRECOGNIZED** = ``15``
  1749. File: Unrecognized error.
  1750. .. _class_@GlobalScope_constant_ERR_FILE_CORRUPT:
  1751. .. rst-class:: classref-enumeration-constant
  1752. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CORRUPT** = ``16``
  1753. File: Corrupt error.
  1754. .. _class_@GlobalScope_constant_ERR_FILE_MISSING_DEPENDENCIES:
  1755. .. rst-class:: classref-enumeration-constant
  1756. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_MISSING_DEPENDENCIES** = ``17``
  1757. File: Missing dependencies error.
  1758. .. _class_@GlobalScope_constant_ERR_FILE_EOF:
  1759. .. rst-class:: classref-enumeration-constant
  1760. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_EOF** = ``18``
  1761. File: End of file (EOF) error.
  1762. .. _class_@GlobalScope_constant_ERR_CANT_OPEN:
  1763. .. rst-class:: classref-enumeration-constant
  1764. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_OPEN** = ``19``
  1765. Can't open error.
  1766. .. _class_@GlobalScope_constant_ERR_CANT_CREATE:
  1767. .. rst-class:: classref-enumeration-constant
  1768. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_CREATE** = ``20``
  1769. Can't create error.
  1770. .. _class_@GlobalScope_constant_ERR_QUERY_FAILED:
  1771. .. rst-class:: classref-enumeration-constant
  1772. :ref:`Error<enum_@GlobalScope_Error>` **ERR_QUERY_FAILED** = ``21``
  1773. Query failed error.
  1774. .. _class_@GlobalScope_constant_ERR_ALREADY_IN_USE:
  1775. .. rst-class:: classref-enumeration-constant
  1776. :ref:`Error<enum_@GlobalScope_Error>` **ERR_ALREADY_IN_USE** = ``22``
  1777. Already in use error.
  1778. .. _class_@GlobalScope_constant_ERR_LOCKED:
  1779. .. rst-class:: classref-enumeration-constant
  1780. :ref:`Error<enum_@GlobalScope_Error>` **ERR_LOCKED** = ``23``
  1781. Locked error.
  1782. .. _class_@GlobalScope_constant_ERR_TIMEOUT:
  1783. .. rst-class:: classref-enumeration-constant
  1784. :ref:`Error<enum_@GlobalScope_Error>` **ERR_TIMEOUT** = ``24``
  1785. Timeout error.
  1786. .. _class_@GlobalScope_constant_ERR_CANT_CONNECT:
  1787. .. rst-class:: classref-enumeration-constant
  1788. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_CONNECT** = ``25``
  1789. Can't connect error.
  1790. .. _class_@GlobalScope_constant_ERR_CANT_RESOLVE:
  1791. .. rst-class:: classref-enumeration-constant
  1792. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_RESOLVE** = ``26``
  1793. Can't resolve error.
  1794. .. _class_@GlobalScope_constant_ERR_CONNECTION_ERROR:
  1795. .. rst-class:: classref-enumeration-constant
  1796. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CONNECTION_ERROR** = ``27``
  1797. Connection error.
  1798. .. _class_@GlobalScope_constant_ERR_CANT_ACQUIRE_RESOURCE:
  1799. .. rst-class:: classref-enumeration-constant
  1800. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_ACQUIRE_RESOURCE** = ``28``
  1801. Can't acquire resource error.
  1802. .. _class_@GlobalScope_constant_ERR_CANT_FORK:
  1803. .. rst-class:: classref-enumeration-constant
  1804. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_FORK** = ``29``
  1805. Can't fork process error.
  1806. .. _class_@GlobalScope_constant_ERR_INVALID_DATA:
  1807. .. rst-class:: classref-enumeration-constant
  1808. :ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_DATA** = ``30``
  1809. Invalid data error.
  1810. .. _class_@GlobalScope_constant_ERR_INVALID_PARAMETER:
  1811. .. rst-class:: classref-enumeration-constant
  1812. :ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_PARAMETER** = ``31``
  1813. Invalid parameter error.
  1814. .. _class_@GlobalScope_constant_ERR_ALREADY_EXISTS:
  1815. .. rst-class:: classref-enumeration-constant
  1816. :ref:`Error<enum_@GlobalScope_Error>` **ERR_ALREADY_EXISTS** = ``32``
  1817. Already exists error.
  1818. .. _class_@GlobalScope_constant_ERR_DOES_NOT_EXIST:
  1819. .. rst-class:: classref-enumeration-constant
  1820. :ref:`Error<enum_@GlobalScope_Error>` **ERR_DOES_NOT_EXIST** = ``33``
  1821. Does not exist error.
  1822. .. _class_@GlobalScope_constant_ERR_DATABASE_CANT_READ:
  1823. .. rst-class:: classref-enumeration-constant
  1824. :ref:`Error<enum_@GlobalScope_Error>` **ERR_DATABASE_CANT_READ** = ``34``
  1825. Database: Read error.
  1826. .. _class_@GlobalScope_constant_ERR_DATABASE_CANT_WRITE:
  1827. .. rst-class:: classref-enumeration-constant
  1828. :ref:`Error<enum_@GlobalScope_Error>` **ERR_DATABASE_CANT_WRITE** = ``35``
  1829. Database: Write error.
  1830. .. _class_@GlobalScope_constant_ERR_COMPILATION_FAILED:
  1831. .. rst-class:: classref-enumeration-constant
  1832. :ref:`Error<enum_@GlobalScope_Error>` **ERR_COMPILATION_FAILED** = ``36``
  1833. Compilation failed error.
  1834. .. _class_@GlobalScope_constant_ERR_METHOD_NOT_FOUND:
  1835. .. rst-class:: classref-enumeration-constant
  1836. :ref:`Error<enum_@GlobalScope_Error>` **ERR_METHOD_NOT_FOUND** = ``37``
  1837. Method not found error.
  1838. .. _class_@GlobalScope_constant_ERR_LINK_FAILED:
  1839. .. rst-class:: classref-enumeration-constant
  1840. :ref:`Error<enum_@GlobalScope_Error>` **ERR_LINK_FAILED** = ``38``
  1841. Linking failed error.
  1842. .. _class_@GlobalScope_constant_ERR_SCRIPT_FAILED:
  1843. .. rst-class:: classref-enumeration-constant
  1844. :ref:`Error<enum_@GlobalScope_Error>` **ERR_SCRIPT_FAILED** = ``39``
  1845. Script failed error.
  1846. .. _class_@GlobalScope_constant_ERR_CYCLIC_LINK:
  1847. .. rst-class:: classref-enumeration-constant
  1848. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CYCLIC_LINK** = ``40``
  1849. Cycling link (import cycle) error.
  1850. .. _class_@GlobalScope_constant_ERR_INVALID_DECLARATION:
  1851. .. rst-class:: classref-enumeration-constant
  1852. :ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_DECLARATION** = ``41``
  1853. Invalid declaration error.
  1854. .. _class_@GlobalScope_constant_ERR_DUPLICATE_SYMBOL:
  1855. .. rst-class:: classref-enumeration-constant
  1856. :ref:`Error<enum_@GlobalScope_Error>` **ERR_DUPLICATE_SYMBOL** = ``42``
  1857. Duplicate symbol error.
  1858. .. _class_@GlobalScope_constant_ERR_PARSE_ERROR:
  1859. .. rst-class:: classref-enumeration-constant
  1860. :ref:`Error<enum_@GlobalScope_Error>` **ERR_PARSE_ERROR** = ``43``
  1861. Parse error.
  1862. .. _class_@GlobalScope_constant_ERR_BUSY:
  1863. .. rst-class:: classref-enumeration-constant
  1864. :ref:`Error<enum_@GlobalScope_Error>` **ERR_BUSY** = ``44``
  1865. Busy error.
  1866. .. _class_@GlobalScope_constant_ERR_SKIP:
  1867. .. rst-class:: classref-enumeration-constant
  1868. :ref:`Error<enum_@GlobalScope_Error>` **ERR_SKIP** = ``45``
  1869. Skip error.
  1870. .. _class_@GlobalScope_constant_ERR_HELP:
  1871. .. rst-class:: classref-enumeration-constant
  1872. :ref:`Error<enum_@GlobalScope_Error>` **ERR_HELP** = ``46``
  1873. Help error. Used internally when passing ``--version`` or ``--help`` as executable options.
  1874. .. _class_@GlobalScope_constant_ERR_BUG:
  1875. .. rst-class:: classref-enumeration-constant
  1876. :ref:`Error<enum_@GlobalScope_Error>` **ERR_BUG** = ``47``
  1877. Bug error, caused by an implementation issue in the method.
  1878. \ **Note:** If a built-in method returns this code, please open an issue on `the GitHub Issue Tracker <https://github.com/godotengine/godot/issues>`__.
  1879. .. _class_@GlobalScope_constant_ERR_PRINTER_ON_FIRE:
  1880. .. rst-class:: classref-enumeration-constant
  1881. :ref:`Error<enum_@GlobalScope_Error>` **ERR_PRINTER_ON_FIRE** = ``48``
  1882. Printer on fire error (This is an easter egg, no built-in methods return this error code).
  1883. .. rst-class:: classref-item-separator
  1884. ----
  1885. .. _enum_@GlobalScope_PropertyHint:
  1886. .. rst-class:: classref-enumeration
  1887. enum **PropertyHint**: :ref:`🔗<enum_@GlobalScope_PropertyHint>`
  1888. .. _class_@GlobalScope_constant_PROPERTY_HINT_NONE:
  1889. .. rst-class:: classref-enumeration-constant
  1890. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NONE** = ``0``
  1891. The property has no hint for the editor.
  1892. .. _class_@GlobalScope_constant_PROPERTY_HINT_RANGE:
  1893. .. rst-class:: classref-enumeration-constant
  1894. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_RANGE** = ``1``
  1895. Hints that an :ref:`int<class_int>` or :ref:`float<class_float>` property should be within a range specified via the hint string ``"min,max"`` or ``"min,max,step"``. The hint string can optionally include ``"or_greater"`` and/or ``"or_less"`` to allow manual input going respectively above the max or below the min values.
  1896. \ **Example:** ``"-360,360,1,or_greater,or_less"``.
  1897. Additionally, other keywords can be included: ``"exp"`` for exponential range editing, ``"radians_as_degrees"`` for editing radian angles in degrees (the range values are also in degrees), ``"degrees"`` to hint at an angle and ``"hide_slider"`` to hide the slider.
  1898. .. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM:
  1899. .. rst-class:: classref-enumeration-constant
  1900. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ENUM** = ``2``
  1901. Hints that an :ref:`int<class_int>` or :ref:`String<class_String>` property is an enumerated value to pick in a list specified via a hint string.
  1902. The hint string is a comma separated list of names such as ``"Hello,Something,Else"``. Whitespaces are **not** removed from either end of a name. For integer properties, the first name in the list has value 0, the next 1, and so on. Explicit values can also be specified by appending ``:integer`` to the name, e.g. ``"Zero,One,Three:3,Four,Six:6"``.
  1903. .. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM_SUGGESTION:
  1904. .. rst-class:: classref-enumeration-constant
  1905. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ENUM_SUGGESTION** = ``3``
  1906. Hints that a :ref:`String<class_String>` property can be an enumerated value to pick in a list specified via a hint string such as ``"Hello,Something,Else"``.
  1907. Unlike :ref:`PROPERTY_HINT_ENUM<class_@GlobalScope_constant_PROPERTY_HINT_ENUM>`, a property with this hint still accepts arbitrary values and can be empty. The list of values serves to suggest possible values.
  1908. .. _class_@GlobalScope_constant_PROPERTY_HINT_EXP_EASING:
  1909. .. rst-class:: classref-enumeration-constant
  1910. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_EXP_EASING** = ``4``
  1911. Hints that a :ref:`float<class_float>` property should be edited via an exponential easing function. The hint string can include ``"attenuation"`` to flip the curve horizontally and/or ``"positive_only"`` to exclude in/out easing and limit values to be greater than or equal to zero.
  1912. .. _class_@GlobalScope_constant_PROPERTY_HINT_LINK:
  1913. .. rst-class:: classref-enumeration-constant
  1914. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LINK** = ``5``
  1915. Hints that a vector property should allow its components to be linked. For example, this allows :ref:`Vector2.x<class_Vector2_property_x>` and :ref:`Vector2.y<class_Vector2_property_y>` to be edited together.
  1916. .. _class_@GlobalScope_constant_PROPERTY_HINT_FLAGS:
  1917. .. rst-class:: classref-enumeration-constant
  1918. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_FLAGS** = ``6``
  1919. Hints that an :ref:`int<class_int>` property is a bitmask with named bit flags.
  1920. The hint string is a comma separated list of names such as ``"Bit0,Bit1,Bit2,Bit3"``. Whitespaces are **not** removed from either end of a name. The first name in the list has value 1, the next 2, then 4, 8, 16 and so on. Explicit values can also be specified by appending ``:integer`` to the name, e.g. ``"A:4,B:8,C:16"``. You can also combine several flags (``"A:4,B:8,AB:12,C:16"``).
  1921. \ **Note:** A flag value must be at least ``1`` and at most ``2 ** 32 - 1``.
  1922. \ **Note:** Unlike :ref:`PROPERTY_HINT_ENUM<class_@GlobalScope_constant_PROPERTY_HINT_ENUM>`, the previous explicit value is not taken into account. For the hint ``"A:16,B,C"``, A is 16, B is 2, C is 4.
  1923. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_RENDER:
  1924. .. rst-class:: classref-enumeration-constant
  1925. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_RENDER** = ``7``
  1926. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 2D render layers.
  1927. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_PHYSICS:
  1928. .. rst-class:: classref-enumeration-constant
  1929. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_PHYSICS** = ``8``
  1930. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 2D physics layers.
  1931. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_NAVIGATION:
  1932. .. rst-class:: classref-enumeration-constant
  1933. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_NAVIGATION** = ``9``
  1934. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 2D navigation layers.
  1935. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_RENDER:
  1936. .. rst-class:: classref-enumeration-constant
  1937. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_RENDER** = ``10``
  1938. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 3D render layers.
  1939. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_PHYSICS:
  1940. .. rst-class:: classref-enumeration-constant
  1941. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_PHYSICS** = ``11``
  1942. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 3D physics layers.
  1943. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_NAVIGATION:
  1944. .. rst-class:: classref-enumeration-constant
  1945. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_NAVIGATION** = ``12``
  1946. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 3D navigation layers.
  1947. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_AVOIDANCE:
  1948. .. rst-class:: classref-enumeration-constant
  1949. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_AVOIDANCE** = ``37``
  1950. Hints that an integer property is a bitmask using the optionally named avoidance layers.
  1951. .. _class_@GlobalScope_constant_PROPERTY_HINT_FILE:
  1952. .. rst-class:: classref-enumeration-constant
  1953. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_FILE** = ``13``
  1954. Hints that a :ref:`String<class_String>` property is a path to a file. Editing it will show a file dialog for picking the path. The hint string can be a set of filters with wildcards like ``"*.png,*.jpg"``.
  1955. .. _class_@GlobalScope_constant_PROPERTY_HINT_DIR:
  1956. .. rst-class:: classref-enumeration-constant
  1957. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_DIR** = ``14``
  1958. Hints that a :ref:`String<class_String>` property is a path to a directory. Editing it will show a file dialog for picking the path.
  1959. .. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_FILE:
  1960. .. rst-class:: classref-enumeration-constant
  1961. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_FILE** = ``15``
  1962. Hints that a :ref:`String<class_String>` property is an absolute path to a file outside the project folder. Editing it will show a file dialog for picking the path. The hint string can be a set of filters with wildcards, like ``"*.png,*.jpg"``.
  1963. .. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_DIR:
  1964. .. rst-class:: classref-enumeration-constant
  1965. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_DIR** = ``16``
  1966. Hints that a :ref:`String<class_String>` property is an absolute path to a directory outside the project folder. Editing it will show a file dialog for picking the path.
  1967. .. _class_@GlobalScope_constant_PROPERTY_HINT_RESOURCE_TYPE:
  1968. .. rst-class:: classref-enumeration-constant
  1969. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_RESOURCE_TYPE** = ``17``
  1970. Hints that a property is an instance of a :ref:`Resource<class_Resource>`-derived type, optionally specified via the hint string (e.g. ``"Texture2D"``). Editing it will show a popup menu of valid resource types to instantiate.
  1971. .. _class_@GlobalScope_constant_PROPERTY_HINT_MULTILINE_TEXT:
  1972. .. rst-class:: classref-enumeration-constant
  1973. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_MULTILINE_TEXT** = ``18``
  1974. Hints that a :ref:`String<class_String>` property is text with line breaks. Editing it will show a text input field where line breaks can be typed.
  1975. .. _class_@GlobalScope_constant_PROPERTY_HINT_EXPRESSION:
  1976. .. rst-class:: classref-enumeration-constant
  1977. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_EXPRESSION** = ``19``
  1978. Hints that a :ref:`String<class_String>` property is an :ref:`Expression<class_Expression>`.
  1979. .. _class_@GlobalScope_constant_PROPERTY_HINT_PLACEHOLDER_TEXT:
  1980. .. rst-class:: classref-enumeration-constant
  1981. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_PLACEHOLDER_TEXT** = ``20``
  1982. Hints that a :ref:`String<class_String>` property should show a placeholder text on its input field, if empty. The hint string is the placeholder text to use.
  1983. .. _class_@GlobalScope_constant_PROPERTY_HINT_COLOR_NO_ALPHA:
  1984. .. rst-class:: classref-enumeration-constant
  1985. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_COLOR_NO_ALPHA** = ``21``
  1986. Hints that a :ref:`Color<class_Color>` property should be edited without affecting its transparency (:ref:`Color.a<class_Color_property_a>` is not editable).
  1987. .. _class_@GlobalScope_constant_PROPERTY_HINT_OBJECT_ID:
  1988. .. rst-class:: classref-enumeration-constant
  1989. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_OBJECT_ID** = ``22``
  1990. Hints that the property's value is an object encoded as object ID, with its type specified in the hint string. Used by the debugger.
  1991. .. _class_@GlobalScope_constant_PROPERTY_HINT_TYPE_STRING:
  1992. .. rst-class:: classref-enumeration-constant
  1993. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_TYPE_STRING** = ``23``
  1994. If a property is :ref:`String<class_String>`, hints that the property represents a particular type (class). This allows to select a type from the create dialog. The property will store the selected type as a string.
  1995. If a property is :ref:`Array<class_Array>`, hints the editor how to show elements. The ``hint_string`` must encode nested types using ``":"`` and ``"/"``.
  1996. .. tabs::
  1997. .. code-tab:: gdscript
  1998. # Array of elem_type.
  1999. hint_string = "%d:" % [elem_type]
  2000. hint_string = "%d/%d:%s" % [elem_type, elem_hint, elem_hint_string]
  2001. # Two-dimensional array of elem_type (array of arrays of elem_type).
  2002. hint_string = "%d:%d:" % [TYPE_ARRAY, elem_type]
  2003. hint_string = "%d:%d/%d:%s" % [TYPE_ARRAY, elem_type, elem_hint, elem_hint_string]
  2004. # Three-dimensional array of elem_type (array of arrays of arrays of elem_type).
  2005. hint_string = "%d:%d:%d:" % [TYPE_ARRAY, TYPE_ARRAY, elem_type]
  2006. hint_string = "%d:%d:%d/%d:%s" % [TYPE_ARRAY, TYPE_ARRAY, elem_type, elem_hint, elem_hint_string]
  2007. .. code-tab:: csharp
  2008. // Array of elemType.
  2009. hintString = $"{elemType:D}:";
  2010. hintString = $"{elemType:}/{elemHint:D}:{elemHintString}";
  2011. // Two-dimensional array of elemType (array of arrays of elemType).
  2012. hintString = $"{Variant.Type.Array:D}:{elemType:D}:";
  2013. hintString = $"{Variant.Type.Array:D}:{elemType:D}/{elemHint:D}:{elemHintString}";
  2014. // Three-dimensional array of elemType (array of arrays of arrays of elemType).
  2015. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Array:D}:{elemType:D}:";
  2016. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Array:D}:{elemType:D}/{elemHint:D}:{elemHintString}";
  2017. \ **Examples:**\
  2018. .. tabs::
  2019. .. code-tab:: gdscript
  2020. hint_string = "%d:" % [TYPE_INT] # Array of integers.
  2021. hint_string = "%d/%d:1,10,1" % [TYPE_INT, PROPERTY_HINT_RANGE] # Array of integers (in range from 1 to 10).
  2022. hint_string = "%d/%d:Zero,One,Two" % [TYPE_INT, PROPERTY_HINT_ENUM] # Array of integers (an enum).
  2023. hint_string = "%d/%d:Zero,One,Three:3,Six:6" % [TYPE_INT, PROPERTY_HINT_ENUM] # Array of integers (an enum).
  2024. hint_string = "%d/%d:*.png" % [TYPE_STRING, PROPERTY_HINT_FILE] # Array of strings (file paths).
  2025. hint_string = "%d/%d:Texture2D" % [TYPE_OBJECT, PROPERTY_HINT_RESOURCE_TYPE] # Array of textures.
  2026. hint_string = "%d:%d:" % [TYPE_ARRAY, TYPE_FLOAT] # Two-dimensional array of floats.
  2027. hint_string = "%d:%d/%d:" % [TYPE_ARRAY, TYPE_STRING, PROPERTY_HINT_MULTILINE_TEXT] # Two-dimensional array of multiline strings.
  2028. hint_string = "%d:%d/%d:-1,1,0.1" % [TYPE_ARRAY, TYPE_FLOAT, PROPERTY_HINT_RANGE] # Two-dimensional array of floats (in range from -1 to 1).
  2029. hint_string = "%d:%d/%d:Texture2D" % [TYPE_ARRAY, TYPE_OBJECT, PROPERTY_HINT_RESOURCE_TYPE] # Two-dimensional array of textures.
  2030. .. code-tab:: csharp
  2031. hintString = $"{Variant.Type.Int:D}/{PropertyHint.Range:D}:1,10,1"; // Array of integers (in range from 1 to 10).
  2032. hintString = $"{Variant.Type.Int:D}/{PropertyHint.Enum:D}:Zero,One,Two"; // Array of integers (an enum).
  2033. hintString = $"{Variant.Type.Int:D}/{PropertyHint.Enum:D}:Zero,One,Three:3,Six:6"; // Array of integers (an enum).
  2034. hintString = $"{Variant.Type.String:D}/{PropertyHint.File:D}:*.png"; // Array of strings (file paths).
  2035. hintString = $"{Variant.Type.Object:D}/{PropertyHint.ResourceType:D}:Texture2D"; // Array of textures.
  2036. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Float:D}:"; // Two-dimensional array of floats.
  2037. hintString = $"{Variant.Type.Array:D}:{Variant.Type.String:D}/{PropertyHint.MultilineText:D}:"; // Two-dimensional array of multiline strings.
  2038. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Float:D}/{PropertyHint.Range:D}:-1,1,0.1"; // Two-dimensional array of floats (in range from -1 to 1).
  2039. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Object:D}/{PropertyHint.ResourceType:D}:Texture2D"; // Two-dimensional array of textures.
  2040. \ **Note:** The trailing colon is required for properly detecting built-in types.
  2041. .. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_PATH_TO_EDITED_NODE:
  2042. .. rst-class:: classref-enumeration-constant
  2043. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_PATH_TO_EDITED_NODE** = ``24``
  2044. **Deprecated:** This hint is not used by the engine.
  2045. .. _class_@GlobalScope_constant_PROPERTY_HINT_OBJECT_TOO_BIG:
  2046. .. rst-class:: classref-enumeration-constant
  2047. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_OBJECT_TOO_BIG** = ``25``
  2048. Hints that an object is too big to be sent via the debugger.
  2049. .. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_PATH_VALID_TYPES:
  2050. .. rst-class:: classref-enumeration-constant
  2051. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_PATH_VALID_TYPES** = ``26``
  2052. Hints that the hint string specifies valid node types for property of type :ref:`NodePath<class_NodePath>`.
  2053. .. _class_@GlobalScope_constant_PROPERTY_HINT_SAVE_FILE:
  2054. .. rst-class:: classref-enumeration-constant
  2055. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_SAVE_FILE** = ``27``
  2056. Hints that a :ref:`String<class_String>` property is a path to a file. Editing it will show a file dialog for picking the path for the file to be saved at. The dialog has access to the project's directory. The hint string can be a set of filters with wildcards like ``"*.png,*.jpg"``. See also :ref:`FileDialog.filters<class_FileDialog_property_filters>`.
  2057. .. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_SAVE_FILE:
  2058. .. rst-class:: classref-enumeration-constant
  2059. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_SAVE_FILE** = ``28``
  2060. Hints that a :ref:`String<class_String>` property is a path to a file. Editing it will show a file dialog for picking the path for the file to be saved at. The dialog has access to the entire filesystem. The hint string can be a set of filters with wildcards like ``"*.png,*.jpg"``. See also :ref:`FileDialog.filters<class_FileDialog_property_filters>`.
  2061. .. _class_@GlobalScope_constant_PROPERTY_HINT_INT_IS_OBJECTID:
  2062. .. rst-class:: classref-enumeration-constant
  2063. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_INT_IS_OBJECTID** = ``29``
  2064. **Deprecated:** This hint is not used by the engine.
  2065. .. _class_@GlobalScope_constant_PROPERTY_HINT_INT_IS_POINTER:
  2066. .. rst-class:: classref-enumeration-constant
  2067. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_INT_IS_POINTER** = ``30``
  2068. Hints that an :ref:`int<class_int>` property is a pointer. Used by GDExtension.
  2069. .. _class_@GlobalScope_constant_PROPERTY_HINT_ARRAY_TYPE:
  2070. .. rst-class:: classref-enumeration-constant
  2071. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ARRAY_TYPE** = ``31``
  2072. Hints that a property is an :ref:`Array<class_Array>` with the stored type specified in the hint string.
  2073. .. _class_@GlobalScope_constant_PROPERTY_HINT_DICTIONARY_TYPE:
  2074. .. rst-class:: classref-enumeration-constant
  2075. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_DICTIONARY_TYPE** = ``38``
  2076. Hints that a property is a :ref:`Dictionary<class_Dictionary>` with the stored types specified in the hint string.
  2077. .. _class_@GlobalScope_constant_PROPERTY_HINT_LOCALE_ID:
  2078. .. rst-class:: classref-enumeration-constant
  2079. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LOCALE_ID** = ``32``
  2080. Hints that a string property is a locale code. Editing it will show a locale dialog for picking language and country.
  2081. .. _class_@GlobalScope_constant_PROPERTY_HINT_LOCALIZABLE_STRING:
  2082. .. rst-class:: classref-enumeration-constant
  2083. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LOCALIZABLE_STRING** = ``33``
  2084. Hints that a dictionary property is string translation map. Dictionary keys are locale codes and, values are translated strings.
  2085. .. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_TYPE:
  2086. .. rst-class:: classref-enumeration-constant
  2087. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_TYPE** = ``34``
  2088. Hints that a property is an instance of a :ref:`Node<class_Node>`-derived type, optionally specified via the hint string (e.g. ``"Node2D"``). Editing it will show a dialog for picking a node from the scene.
  2089. .. _class_@GlobalScope_constant_PROPERTY_HINT_HIDE_QUATERNION_EDIT:
  2090. .. rst-class:: classref-enumeration-constant
  2091. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_HIDE_QUATERNION_EDIT** = ``35``
  2092. Hints that a quaternion property should disable the temporary euler editor.
  2093. .. _class_@GlobalScope_constant_PROPERTY_HINT_PASSWORD:
  2094. .. rst-class:: classref-enumeration-constant
  2095. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_PASSWORD** = ``36``
  2096. Hints that a string property is a password, and every character is replaced with the secret character.
  2097. .. _class_@GlobalScope_constant_PROPERTY_HINT_TOOL_BUTTON:
  2098. .. rst-class:: classref-enumeration-constant
  2099. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_TOOL_BUTTON** = ``39``
  2100. Hints that a :ref:`Callable<class_Callable>` property should be displayed as a clickable button. When the button is pressed, the callable is called. The hint string specifies the button text and optionally an icon from the ``"EditorIcons"`` theme type.
  2101. .. code:: text
  2102. "Click me!" - A button with the text "Click me!" and the default "Callable" icon.
  2103. "Click me!,ColorRect" - A button with the text "Click me!" and the "ColorRect" icon.
  2104. \ **Note:** A :ref:`Callable<class_Callable>` cannot be properly serialized and stored in a file, so it is recommended to use :ref:`PROPERTY_USAGE_EDITOR<class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR>` instead of :ref:`PROPERTY_USAGE_DEFAULT<class_@GlobalScope_constant_PROPERTY_USAGE_DEFAULT>`.
  2105. .. _class_@GlobalScope_constant_PROPERTY_HINT_ONESHOT:
  2106. .. rst-class:: classref-enumeration-constant
  2107. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ONESHOT** = ``40``
  2108. Hints that a property will be changed on its own after setting, such as :ref:`AudioStreamPlayer.playing<class_AudioStreamPlayer_property_playing>` or :ref:`GPUParticles3D.emitting<class_GPUParticles3D_property_emitting>`.
  2109. .. _class_@GlobalScope_constant_PROPERTY_HINT_MAX:
  2110. .. rst-class:: classref-enumeration-constant
  2111. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_MAX** = ``41``
  2112. Represents the size of the :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` enum.
  2113. .. rst-class:: classref-item-separator
  2114. ----
  2115. .. _enum_@GlobalScope_PropertyUsageFlags:
  2116. .. rst-class:: classref-enumeration
  2117. flags **PropertyUsageFlags**: :ref:`🔗<enum_@GlobalScope_PropertyUsageFlags>`
  2118. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NONE:
  2119. .. rst-class:: classref-enumeration-constant
  2120. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NONE** = ``0``
  2121. The property is not stored, and does not display in the editor. This is the default for non-exported properties.
  2122. .. _class_@GlobalScope_constant_PROPERTY_USAGE_STORAGE:
  2123. .. rst-class:: classref-enumeration-constant
  2124. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_STORAGE** = ``2``
  2125. The property is serialized and saved in the scene file (default for exported properties).
  2126. .. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR:
  2127. .. rst-class:: classref-enumeration-constant
  2128. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR** = ``4``
  2129. The property is shown in the :ref:`EditorInspector<class_EditorInspector>` (default for exported properties).
  2130. .. _class_@GlobalScope_constant_PROPERTY_USAGE_INTERNAL:
  2131. .. rst-class:: classref-enumeration-constant
  2132. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_INTERNAL** = ``8``
  2133. The property is excluded from the class reference.
  2134. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CHECKABLE:
  2135. .. rst-class:: classref-enumeration-constant
  2136. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CHECKABLE** = ``16``
  2137. The property can be checked in the :ref:`EditorInspector<class_EditorInspector>`.
  2138. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CHECKED:
  2139. .. rst-class:: classref-enumeration-constant
  2140. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CHECKED** = ``32``
  2141. The property is checked in the :ref:`EditorInspector<class_EditorInspector>`.
  2142. .. _class_@GlobalScope_constant_PROPERTY_USAGE_GROUP:
  2143. .. rst-class:: classref-enumeration-constant
  2144. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_GROUP** = ``64``
  2145. Used to group properties together in the editor. See :ref:`EditorInspector<class_EditorInspector>`.
  2146. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CATEGORY:
  2147. .. rst-class:: classref-enumeration-constant
  2148. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CATEGORY** = ``128``
  2149. Used to categorize properties together in the editor.
  2150. .. _class_@GlobalScope_constant_PROPERTY_USAGE_SUBGROUP:
  2151. .. rst-class:: classref-enumeration-constant
  2152. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SUBGROUP** = ``256``
  2153. Used to group properties together in the editor in a subgroup (under a group). See :ref:`EditorInspector<class_EditorInspector>`.
  2154. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CLASS_IS_BITFIELD:
  2155. .. rst-class:: classref-enumeration-constant
  2156. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CLASS_IS_BITFIELD** = ``512``
  2157. The property is a bitfield, i.e. it contains multiple flags represented as bits.
  2158. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NO_INSTANCE_STATE:
  2159. .. rst-class:: classref-enumeration-constant
  2160. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NO_INSTANCE_STATE** = ``1024``
  2161. The property does not save its state in :ref:`PackedScene<class_PackedScene>`.
  2162. .. _class_@GlobalScope_constant_PROPERTY_USAGE_RESTART_IF_CHANGED:
  2163. .. rst-class:: classref-enumeration-constant
  2164. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_RESTART_IF_CHANGED** = ``2048``
  2165. Editing the property prompts the user for restarting the editor.
  2166. .. _class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_VARIABLE:
  2167. .. rst-class:: classref-enumeration-constant
  2168. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SCRIPT_VARIABLE** = ``4096``
  2169. The property is a script variable. :ref:`PROPERTY_USAGE_SCRIPT_VARIABLE<class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_VARIABLE>` can be used to distinguish between exported script variables from built-in variables (which don't have this usage flag). By default, :ref:`PROPERTY_USAGE_SCRIPT_VARIABLE<class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_VARIABLE>` is **not** applied to variables that are created by overriding :ref:`Object._get_property_list<class_Object_private_method__get_property_list>` in a script.
  2170. .. _class_@GlobalScope_constant_PROPERTY_USAGE_STORE_IF_NULL:
  2171. .. rst-class:: classref-enumeration-constant
  2172. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_STORE_IF_NULL** = ``8192``
  2173. The property value of type :ref:`Object<class_Object>` will be stored even if its value is ``null``.
  2174. .. _class_@GlobalScope_constant_PROPERTY_USAGE_UPDATE_ALL_IF_MODIFIED:
  2175. .. rst-class:: classref-enumeration-constant
  2176. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_UPDATE_ALL_IF_MODIFIED** = ``16384``
  2177. If this property is modified, all inspector fields will be refreshed.
  2178. .. _class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_DEFAULT_VALUE:
  2179. .. rst-class:: classref-enumeration-constant
  2180. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SCRIPT_DEFAULT_VALUE** = ``32768``
  2181. **Deprecated:** This flag is not used by the engine.
  2182. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CLASS_IS_ENUM:
  2183. .. rst-class:: classref-enumeration-constant
  2184. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CLASS_IS_ENUM** = ``65536``
  2185. The property is a variable of enum type, i.e. it only takes named integer constants from its associated enumeration.
  2186. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NIL_IS_VARIANT:
  2187. .. rst-class:: classref-enumeration-constant
  2188. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NIL_IS_VARIANT** = ``131072``
  2189. If property has ``nil`` as default value, its type will be :ref:`Variant<class_Variant>`.
  2190. .. _class_@GlobalScope_constant_PROPERTY_USAGE_ARRAY:
  2191. .. rst-class:: classref-enumeration-constant
  2192. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_ARRAY** = ``262144``
  2193. The property is an array.
  2194. .. _class_@GlobalScope_constant_PROPERTY_USAGE_ALWAYS_DUPLICATE:
  2195. .. rst-class:: classref-enumeration-constant
  2196. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_ALWAYS_DUPLICATE** = ``524288``
  2197. When duplicating a resource with :ref:`Resource.duplicate<class_Resource_method_duplicate>`, and this flag is set on a property of that resource, the property should always be duplicated, regardless of the ``subresources`` bool parameter.
  2198. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NEVER_DUPLICATE:
  2199. .. rst-class:: classref-enumeration-constant
  2200. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NEVER_DUPLICATE** = ``1048576``
  2201. When duplicating a resource with :ref:`Resource.duplicate<class_Resource_method_duplicate>`, and this flag is set on a property of that resource, the property should never be duplicated, regardless of the ``subresources`` bool parameter.
  2202. .. _class_@GlobalScope_constant_PROPERTY_USAGE_HIGH_END_GFX:
  2203. .. rst-class:: classref-enumeration-constant
  2204. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_HIGH_END_GFX** = ``2097152``
  2205. The property is only shown in the editor if modern renderers are supported (the Compatibility rendering method is excluded).
  2206. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NODE_PATH_FROM_SCENE_ROOT:
  2207. .. rst-class:: classref-enumeration-constant
  2208. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NODE_PATH_FROM_SCENE_ROOT** = ``4194304``
  2209. The :ref:`NodePath<class_NodePath>` property will always be relative to the scene's root. Mostly useful for local resources.
  2210. .. _class_@GlobalScope_constant_PROPERTY_USAGE_RESOURCE_NOT_PERSISTENT:
  2211. .. rst-class:: classref-enumeration-constant
  2212. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_RESOURCE_NOT_PERSISTENT** = ``8388608``
  2213. Use when a resource is created on the fly, i.e. the getter will always return a different instance. :ref:`ResourceSaver<class_ResourceSaver>` needs this information to properly save such resources.
  2214. .. _class_@GlobalScope_constant_PROPERTY_USAGE_KEYING_INCREMENTS:
  2215. .. rst-class:: classref-enumeration-constant
  2216. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_KEYING_INCREMENTS** = ``16777216``
  2217. Inserting an animation key frame of this property will automatically increment the value, allowing to easily keyframe multiple values in a row.
  2218. .. _class_@GlobalScope_constant_PROPERTY_USAGE_DEFERRED_SET_RESOURCE:
  2219. .. rst-class:: classref-enumeration-constant
  2220. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_DEFERRED_SET_RESOURCE** = ``33554432``
  2221. **Deprecated:** This flag is not used by the engine.
  2222. .. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR_INSTANTIATE_OBJECT:
  2223. .. rst-class:: classref-enumeration-constant
  2224. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR_INSTANTIATE_OBJECT** = ``67108864``
  2225. When this property is a :ref:`Resource<class_Resource>` and base object is a :ref:`Node<class_Node>`, a resource instance will be automatically created whenever the node is created in the editor.
  2226. .. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR_BASIC_SETTING:
  2227. .. rst-class:: classref-enumeration-constant
  2228. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR_BASIC_SETTING** = ``134217728``
  2229. The property is considered a basic setting and will appear even when advanced mode is disabled. Used for project settings.
  2230. .. _class_@GlobalScope_constant_PROPERTY_USAGE_READ_ONLY:
  2231. .. rst-class:: classref-enumeration-constant
  2232. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_READ_ONLY** = ``268435456``
  2233. The property is read-only in the :ref:`EditorInspector<class_EditorInspector>`.
  2234. .. _class_@GlobalScope_constant_PROPERTY_USAGE_SECRET:
  2235. .. rst-class:: classref-enumeration-constant
  2236. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SECRET** = ``536870912``
  2237. An export preset property with this flag contains confidential information and is stored separately from the rest of the export preset configuration.
  2238. .. _class_@GlobalScope_constant_PROPERTY_USAGE_DEFAULT:
  2239. .. rst-class:: classref-enumeration-constant
  2240. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_DEFAULT** = ``6``
  2241. Default usage (storage and editor).
  2242. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NO_EDITOR:
  2243. .. rst-class:: classref-enumeration-constant
  2244. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NO_EDITOR** = ``2``
  2245. Default usage but without showing the property in the editor (storage).
  2246. .. rst-class:: classref-item-separator
  2247. ----
  2248. .. _enum_@GlobalScope_MethodFlags:
  2249. .. rst-class:: classref-enumeration
  2250. flags **MethodFlags**: :ref:`🔗<enum_@GlobalScope_MethodFlags>`
  2251. .. _class_@GlobalScope_constant_METHOD_FLAG_NORMAL:
  2252. .. rst-class:: classref-enumeration-constant
  2253. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_NORMAL** = ``1``
  2254. Flag for a normal method.
  2255. .. _class_@GlobalScope_constant_METHOD_FLAG_EDITOR:
  2256. .. rst-class:: classref-enumeration-constant
  2257. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_EDITOR** = ``2``
  2258. Flag for an editor method.
  2259. .. _class_@GlobalScope_constant_METHOD_FLAG_CONST:
  2260. .. rst-class:: classref-enumeration-constant
  2261. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_CONST** = ``4``
  2262. Flag for a constant method.
  2263. .. _class_@GlobalScope_constant_METHOD_FLAG_VIRTUAL:
  2264. .. rst-class:: classref-enumeration-constant
  2265. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_VIRTUAL** = ``8``
  2266. Flag for a virtual method.
  2267. .. _class_@GlobalScope_constant_METHOD_FLAG_VARARG:
  2268. .. rst-class:: classref-enumeration-constant
  2269. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_VARARG** = ``16``
  2270. Flag for a method with a variable number of arguments.
  2271. .. _class_@GlobalScope_constant_METHOD_FLAG_STATIC:
  2272. .. rst-class:: classref-enumeration-constant
  2273. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_STATIC** = ``32``
  2274. Flag for a static method.
  2275. .. _class_@GlobalScope_constant_METHOD_FLAG_OBJECT_CORE:
  2276. .. rst-class:: classref-enumeration-constant
  2277. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_OBJECT_CORE** = ``64``
  2278. Used internally. Allows to not dump core virtual methods (such as :ref:`Object._notification<class_Object_private_method__notification>`) to the JSON API.
  2279. .. _class_@GlobalScope_constant_METHOD_FLAGS_DEFAULT:
  2280. .. rst-class:: classref-enumeration-constant
  2281. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAGS_DEFAULT** = ``1``
  2282. Default method flags (normal).
  2283. .. rst-class:: classref-item-separator
  2284. ----
  2285. .. _enum_@GlobalScope_Variant.Type:
  2286. .. rst-class:: classref-enumeration
  2287. enum **Variant.Type**: :ref:`🔗<enum_@GlobalScope_Variant.Type>`
  2288. .. _class_@GlobalScope_constant_TYPE_NIL:
  2289. .. rst-class:: classref-enumeration-constant
  2290. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_NIL** = ``0``
  2291. Variable is ``null``.
  2292. .. _class_@GlobalScope_constant_TYPE_BOOL:
  2293. .. rst-class:: classref-enumeration-constant
  2294. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_BOOL** = ``1``
  2295. Variable is of type :ref:`bool<class_bool>`.
  2296. .. _class_@GlobalScope_constant_TYPE_INT:
  2297. .. rst-class:: classref-enumeration-constant
  2298. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_INT** = ``2``
  2299. Variable is of type :ref:`int<class_int>`.
  2300. .. _class_@GlobalScope_constant_TYPE_FLOAT:
  2301. .. rst-class:: classref-enumeration-constant
  2302. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_FLOAT** = ``3``
  2303. Variable is of type :ref:`float<class_float>`.
  2304. .. _class_@GlobalScope_constant_TYPE_STRING:
  2305. .. rst-class:: classref-enumeration-constant
  2306. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_STRING** = ``4``
  2307. Variable is of type :ref:`String<class_String>`.
  2308. .. _class_@GlobalScope_constant_TYPE_VECTOR2:
  2309. .. rst-class:: classref-enumeration-constant
  2310. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR2** = ``5``
  2311. Variable is of type :ref:`Vector2<class_Vector2>`.
  2312. .. _class_@GlobalScope_constant_TYPE_VECTOR2I:
  2313. .. rst-class:: classref-enumeration-constant
  2314. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR2I** = ``6``
  2315. Variable is of type :ref:`Vector2i<class_Vector2i>`.
  2316. .. _class_@GlobalScope_constant_TYPE_RECT2:
  2317. .. rst-class:: classref-enumeration-constant
  2318. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RECT2** = ``7``
  2319. Variable is of type :ref:`Rect2<class_Rect2>`.
  2320. .. _class_@GlobalScope_constant_TYPE_RECT2I:
  2321. .. rst-class:: classref-enumeration-constant
  2322. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RECT2I** = ``8``
  2323. Variable is of type :ref:`Rect2i<class_Rect2i>`.
  2324. .. _class_@GlobalScope_constant_TYPE_VECTOR3:
  2325. .. rst-class:: classref-enumeration-constant
  2326. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR3** = ``9``
  2327. Variable is of type :ref:`Vector3<class_Vector3>`.
  2328. .. _class_@GlobalScope_constant_TYPE_VECTOR3I:
  2329. .. rst-class:: classref-enumeration-constant
  2330. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR3I** = ``10``
  2331. Variable is of type :ref:`Vector3i<class_Vector3i>`.
  2332. .. _class_@GlobalScope_constant_TYPE_TRANSFORM2D:
  2333. .. rst-class:: classref-enumeration-constant
  2334. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_TRANSFORM2D** = ``11``
  2335. Variable is of type :ref:`Transform2D<class_Transform2D>`.
  2336. .. _class_@GlobalScope_constant_TYPE_VECTOR4:
  2337. .. rst-class:: classref-enumeration-constant
  2338. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR4** = ``12``
  2339. Variable is of type :ref:`Vector4<class_Vector4>`.
  2340. .. _class_@GlobalScope_constant_TYPE_VECTOR4I:
  2341. .. rst-class:: classref-enumeration-constant
  2342. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR4I** = ``13``
  2343. Variable is of type :ref:`Vector4i<class_Vector4i>`.
  2344. .. _class_@GlobalScope_constant_TYPE_PLANE:
  2345. .. rst-class:: classref-enumeration-constant
  2346. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PLANE** = ``14``
  2347. Variable is of type :ref:`Plane<class_Plane>`.
  2348. .. _class_@GlobalScope_constant_TYPE_QUATERNION:
  2349. .. rst-class:: classref-enumeration-constant
  2350. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_QUATERNION** = ``15``
  2351. Variable is of type :ref:`Quaternion<class_Quaternion>`.
  2352. .. _class_@GlobalScope_constant_TYPE_AABB:
  2353. .. rst-class:: classref-enumeration-constant
  2354. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_AABB** = ``16``
  2355. Variable is of type :ref:`AABB<class_AABB>`.
  2356. .. _class_@GlobalScope_constant_TYPE_BASIS:
  2357. .. rst-class:: classref-enumeration-constant
  2358. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_BASIS** = ``17``
  2359. Variable is of type :ref:`Basis<class_Basis>`.
  2360. .. _class_@GlobalScope_constant_TYPE_TRANSFORM3D:
  2361. .. rst-class:: classref-enumeration-constant
  2362. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_TRANSFORM3D** = ``18``
  2363. Variable is of type :ref:`Transform3D<class_Transform3D>`.
  2364. .. _class_@GlobalScope_constant_TYPE_PROJECTION:
  2365. .. rst-class:: classref-enumeration-constant
  2366. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PROJECTION** = ``19``
  2367. Variable is of type :ref:`Projection<class_Projection>`.
  2368. .. _class_@GlobalScope_constant_TYPE_COLOR:
  2369. .. rst-class:: classref-enumeration-constant
  2370. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_COLOR** = ``20``
  2371. Variable is of type :ref:`Color<class_Color>`.
  2372. .. _class_@GlobalScope_constant_TYPE_STRING_NAME:
  2373. .. rst-class:: classref-enumeration-constant
  2374. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_STRING_NAME** = ``21``
  2375. Variable is of type :ref:`StringName<class_StringName>`.
  2376. .. _class_@GlobalScope_constant_TYPE_NODE_PATH:
  2377. .. rst-class:: classref-enumeration-constant
  2378. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_NODE_PATH** = ``22``
  2379. Variable is of type :ref:`NodePath<class_NodePath>`.
  2380. .. _class_@GlobalScope_constant_TYPE_RID:
  2381. .. rst-class:: classref-enumeration-constant
  2382. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RID** = ``23``
  2383. Variable is of type :ref:`RID<class_RID>`.
  2384. .. _class_@GlobalScope_constant_TYPE_OBJECT:
  2385. .. rst-class:: classref-enumeration-constant
  2386. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_OBJECT** = ``24``
  2387. Variable is of type :ref:`Object<class_Object>`.
  2388. .. _class_@GlobalScope_constant_TYPE_CALLABLE:
  2389. .. rst-class:: classref-enumeration-constant
  2390. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_CALLABLE** = ``25``
  2391. Variable is of type :ref:`Callable<class_Callable>`.
  2392. .. _class_@GlobalScope_constant_TYPE_SIGNAL:
  2393. .. rst-class:: classref-enumeration-constant
  2394. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_SIGNAL** = ``26``
  2395. Variable is of type :ref:`Signal<class_Signal>`.
  2396. .. _class_@GlobalScope_constant_TYPE_DICTIONARY:
  2397. .. rst-class:: classref-enumeration-constant
  2398. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_DICTIONARY** = ``27``
  2399. Variable is of type :ref:`Dictionary<class_Dictionary>`.
  2400. .. _class_@GlobalScope_constant_TYPE_ARRAY:
  2401. .. rst-class:: classref-enumeration-constant
  2402. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_ARRAY** = ``28``
  2403. Variable is of type :ref:`Array<class_Array>`.
  2404. .. _class_@GlobalScope_constant_TYPE_PACKED_BYTE_ARRAY:
  2405. .. rst-class:: classref-enumeration-constant
  2406. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_BYTE_ARRAY** = ``29``
  2407. Variable is of type :ref:`PackedByteArray<class_PackedByteArray>`.
  2408. .. _class_@GlobalScope_constant_TYPE_PACKED_INT32_ARRAY:
  2409. .. rst-class:: classref-enumeration-constant
  2410. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_INT32_ARRAY** = ``30``
  2411. Variable is of type :ref:`PackedInt32Array<class_PackedInt32Array>`.
  2412. .. _class_@GlobalScope_constant_TYPE_PACKED_INT64_ARRAY:
  2413. .. rst-class:: classref-enumeration-constant
  2414. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_INT64_ARRAY** = ``31``
  2415. Variable is of type :ref:`PackedInt64Array<class_PackedInt64Array>`.
  2416. .. _class_@GlobalScope_constant_TYPE_PACKED_FLOAT32_ARRAY:
  2417. .. rst-class:: classref-enumeration-constant
  2418. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_FLOAT32_ARRAY** = ``32``
  2419. Variable is of type :ref:`PackedFloat32Array<class_PackedFloat32Array>`.
  2420. .. _class_@GlobalScope_constant_TYPE_PACKED_FLOAT64_ARRAY:
  2421. .. rst-class:: classref-enumeration-constant
  2422. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_FLOAT64_ARRAY** = ``33``
  2423. Variable is of type :ref:`PackedFloat64Array<class_PackedFloat64Array>`.
  2424. .. _class_@GlobalScope_constant_TYPE_PACKED_STRING_ARRAY:
  2425. .. rst-class:: classref-enumeration-constant
  2426. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_STRING_ARRAY** = ``34``
  2427. Variable is of type :ref:`PackedStringArray<class_PackedStringArray>`.
  2428. .. _class_@GlobalScope_constant_TYPE_PACKED_VECTOR2_ARRAY:
  2429. .. rst-class:: classref-enumeration-constant
  2430. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_VECTOR2_ARRAY** = ``35``
  2431. Variable is of type :ref:`PackedVector2Array<class_PackedVector2Array>`.
  2432. .. _class_@GlobalScope_constant_TYPE_PACKED_VECTOR3_ARRAY:
  2433. .. rst-class:: classref-enumeration-constant
  2434. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_VECTOR3_ARRAY** = ``36``
  2435. Variable is of type :ref:`PackedVector3Array<class_PackedVector3Array>`.
  2436. .. _class_@GlobalScope_constant_TYPE_PACKED_COLOR_ARRAY:
  2437. .. rst-class:: classref-enumeration-constant
  2438. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_COLOR_ARRAY** = ``37``
  2439. Variable is of type :ref:`PackedColorArray<class_PackedColorArray>`.
  2440. .. _class_@GlobalScope_constant_TYPE_PACKED_VECTOR4_ARRAY:
  2441. .. rst-class:: classref-enumeration-constant
  2442. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_VECTOR4_ARRAY** = ``38``
  2443. Variable is of type :ref:`PackedVector4Array<class_PackedVector4Array>`.
  2444. .. _class_@GlobalScope_constant_TYPE_MAX:
  2445. .. rst-class:: classref-enumeration-constant
  2446. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_MAX** = ``39``
  2447. Represents the size of the :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` enum.
  2448. .. rst-class:: classref-item-separator
  2449. ----
  2450. .. _enum_@GlobalScope_Variant.Operator:
  2451. .. rst-class:: classref-enumeration
  2452. enum **Variant.Operator**: :ref:`🔗<enum_@GlobalScope_Variant.Operator>`
  2453. .. _class_@GlobalScope_constant_OP_EQUAL:
  2454. .. rst-class:: classref-enumeration-constant
  2455. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_EQUAL** = ``0``
  2456. Equality operator (``==``).
  2457. .. _class_@GlobalScope_constant_OP_NOT_EQUAL:
  2458. .. rst-class:: classref-enumeration-constant
  2459. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NOT_EQUAL** = ``1``
  2460. Inequality operator (``!=``).
  2461. .. _class_@GlobalScope_constant_OP_LESS:
  2462. .. rst-class:: classref-enumeration-constant
  2463. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_LESS** = ``2``
  2464. Less than operator (``<``).
  2465. .. _class_@GlobalScope_constant_OP_LESS_EQUAL:
  2466. .. rst-class:: classref-enumeration-constant
  2467. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_LESS_EQUAL** = ``3``
  2468. Less than or equal operator (``<=``).
  2469. .. _class_@GlobalScope_constant_OP_GREATER:
  2470. .. rst-class:: classref-enumeration-constant
  2471. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_GREATER** = ``4``
  2472. Greater than operator (``>``).
  2473. .. _class_@GlobalScope_constant_OP_GREATER_EQUAL:
  2474. .. rst-class:: classref-enumeration-constant
  2475. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_GREATER_EQUAL** = ``5``
  2476. Greater than or equal operator (``>=``).
  2477. .. _class_@GlobalScope_constant_OP_ADD:
  2478. .. rst-class:: classref-enumeration-constant
  2479. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_ADD** = ``6``
  2480. Addition operator (``+``).
  2481. .. _class_@GlobalScope_constant_OP_SUBTRACT:
  2482. .. rst-class:: classref-enumeration-constant
  2483. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SUBTRACT** = ``7``
  2484. Subtraction operator (``-``).
  2485. .. _class_@GlobalScope_constant_OP_MULTIPLY:
  2486. .. rst-class:: classref-enumeration-constant
  2487. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MULTIPLY** = ``8``
  2488. Multiplication operator (``*``).
  2489. .. _class_@GlobalScope_constant_OP_DIVIDE:
  2490. .. rst-class:: classref-enumeration-constant
  2491. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_DIVIDE** = ``9``
  2492. Division operator (``/``).
  2493. .. _class_@GlobalScope_constant_OP_NEGATE:
  2494. .. rst-class:: classref-enumeration-constant
  2495. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NEGATE** = ``10``
  2496. Unary negation operator (``-``).
  2497. .. _class_@GlobalScope_constant_OP_POSITIVE:
  2498. .. rst-class:: classref-enumeration-constant
  2499. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_POSITIVE** = ``11``
  2500. Unary plus operator (``+``).
  2501. .. _class_@GlobalScope_constant_OP_MODULE:
  2502. .. rst-class:: classref-enumeration-constant
  2503. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MODULE** = ``12``
  2504. Remainder/modulo operator (``%``).
  2505. .. _class_@GlobalScope_constant_OP_POWER:
  2506. .. rst-class:: classref-enumeration-constant
  2507. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_POWER** = ``13``
  2508. Power operator (``**``).
  2509. .. _class_@GlobalScope_constant_OP_SHIFT_LEFT:
  2510. .. rst-class:: classref-enumeration-constant
  2511. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SHIFT_LEFT** = ``14``
  2512. Left shift operator (``<<``).
  2513. .. _class_@GlobalScope_constant_OP_SHIFT_RIGHT:
  2514. .. rst-class:: classref-enumeration-constant
  2515. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SHIFT_RIGHT** = ``15``
  2516. Right shift operator (``>>``).
  2517. .. _class_@GlobalScope_constant_OP_BIT_AND:
  2518. .. rst-class:: classref-enumeration-constant
  2519. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_AND** = ``16``
  2520. Bitwise AND operator (``&``).
  2521. .. _class_@GlobalScope_constant_OP_BIT_OR:
  2522. .. rst-class:: classref-enumeration-constant
  2523. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_OR** = ``17``
  2524. Bitwise OR operator (``|``).
  2525. .. _class_@GlobalScope_constant_OP_BIT_XOR:
  2526. .. rst-class:: classref-enumeration-constant
  2527. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_XOR** = ``18``
  2528. Bitwise XOR operator (``^``).
  2529. .. _class_@GlobalScope_constant_OP_BIT_NEGATE:
  2530. .. rst-class:: classref-enumeration-constant
  2531. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_NEGATE** = ``19``
  2532. Bitwise NOT operator (``~``).
  2533. .. _class_@GlobalScope_constant_OP_AND:
  2534. .. rst-class:: classref-enumeration-constant
  2535. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_AND** = ``20``
  2536. Logical AND operator (``and`` or ``&&``).
  2537. .. _class_@GlobalScope_constant_OP_OR:
  2538. .. rst-class:: classref-enumeration-constant
  2539. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_OR** = ``21``
  2540. Logical OR operator (``or`` or ``||``).
  2541. .. _class_@GlobalScope_constant_OP_XOR:
  2542. .. rst-class:: classref-enumeration-constant
  2543. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_XOR** = ``22``
  2544. Logical XOR operator (not implemented in GDScript).
  2545. .. _class_@GlobalScope_constant_OP_NOT:
  2546. .. rst-class:: classref-enumeration-constant
  2547. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NOT** = ``23``
  2548. Logical NOT operator (``not`` or ``!``).
  2549. .. _class_@GlobalScope_constant_OP_IN:
  2550. .. rst-class:: classref-enumeration-constant
  2551. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_IN** = ``24``
  2552. Logical IN operator (``in``).
  2553. .. _class_@GlobalScope_constant_OP_MAX:
  2554. .. rst-class:: classref-enumeration-constant
  2555. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MAX** = ``25``
  2556. Represents the size of the :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` enum.
  2557. .. rst-class:: classref-section-separator
  2558. ----
  2559. .. rst-class:: classref-descriptions-group
  2560. Property Descriptions
  2561. ---------------------
  2562. .. _class_@GlobalScope_property_AudioServer:
  2563. .. rst-class:: classref-property
  2564. :ref:`AudioServer<class_AudioServer>` **AudioServer** :ref:`🔗<class_@GlobalScope_property_AudioServer>`
  2565. The :ref:`AudioServer<class_AudioServer>` singleton.
  2566. .. rst-class:: classref-item-separator
  2567. ----
  2568. .. _class_@GlobalScope_property_CameraServer:
  2569. .. rst-class:: classref-property
  2570. :ref:`CameraServer<class_CameraServer>` **CameraServer** :ref:`🔗<class_@GlobalScope_property_CameraServer>`
  2571. The :ref:`CameraServer<class_CameraServer>` singleton.
  2572. .. rst-class:: classref-item-separator
  2573. ----
  2574. .. _class_@GlobalScope_property_ClassDB:
  2575. .. rst-class:: classref-property
  2576. :ref:`ClassDB<class_ClassDB>` **ClassDB** :ref:`🔗<class_@GlobalScope_property_ClassDB>`
  2577. The :ref:`ClassDB<class_ClassDB>` singleton.
  2578. .. rst-class:: classref-item-separator
  2579. ----
  2580. .. _class_@GlobalScope_property_DisplayServer:
  2581. .. rst-class:: classref-property
  2582. :ref:`DisplayServer<class_DisplayServer>` **DisplayServer** :ref:`🔗<class_@GlobalScope_property_DisplayServer>`
  2583. The :ref:`DisplayServer<class_DisplayServer>` singleton.
  2584. .. rst-class:: classref-item-separator
  2585. ----
  2586. .. _class_@GlobalScope_property_EditorInterface:
  2587. .. rst-class:: classref-property
  2588. :ref:`EditorInterface<class_EditorInterface>` **EditorInterface** :ref:`🔗<class_@GlobalScope_property_EditorInterface>`
  2589. The :ref:`EditorInterface<class_EditorInterface>` singleton.
  2590. \ **Note:** Only available in editor builds.
  2591. .. rst-class:: classref-item-separator
  2592. ----
  2593. .. _class_@GlobalScope_property_Engine:
  2594. .. rst-class:: classref-property
  2595. :ref:`Engine<class_Engine>` **Engine** :ref:`🔗<class_@GlobalScope_property_Engine>`
  2596. The :ref:`Engine<class_Engine>` singleton.
  2597. .. rst-class:: classref-item-separator
  2598. ----
  2599. .. _class_@GlobalScope_property_EngineDebugger:
  2600. .. rst-class:: classref-property
  2601. :ref:`EngineDebugger<class_EngineDebugger>` **EngineDebugger** :ref:`🔗<class_@GlobalScope_property_EngineDebugger>`
  2602. The :ref:`EngineDebugger<class_EngineDebugger>` singleton.
  2603. .. rst-class:: classref-item-separator
  2604. ----
  2605. .. _class_@GlobalScope_property_GDExtensionManager:
  2606. .. rst-class:: classref-property
  2607. :ref:`GDExtensionManager<class_GDExtensionManager>` **GDExtensionManager** :ref:`🔗<class_@GlobalScope_property_GDExtensionManager>`
  2608. The :ref:`GDExtensionManager<class_GDExtensionManager>` singleton.
  2609. .. rst-class:: classref-item-separator
  2610. ----
  2611. .. _class_@GlobalScope_property_Geometry2D:
  2612. .. rst-class:: classref-property
  2613. :ref:`Geometry2D<class_Geometry2D>` **Geometry2D** :ref:`🔗<class_@GlobalScope_property_Geometry2D>`
  2614. The :ref:`Geometry2D<class_Geometry2D>` singleton.
  2615. .. rst-class:: classref-item-separator
  2616. ----
  2617. .. _class_@GlobalScope_property_Geometry3D:
  2618. .. rst-class:: classref-property
  2619. :ref:`Geometry3D<class_Geometry3D>` **Geometry3D** :ref:`🔗<class_@GlobalScope_property_Geometry3D>`
  2620. The :ref:`Geometry3D<class_Geometry3D>` singleton.
  2621. .. rst-class:: classref-item-separator
  2622. ----
  2623. .. _class_@GlobalScope_property_IP:
  2624. .. rst-class:: classref-property
  2625. :ref:`IP<class_IP>` **IP** :ref:`🔗<class_@GlobalScope_property_IP>`
  2626. The :ref:`IP<class_IP>` singleton.
  2627. .. rst-class:: classref-item-separator
  2628. ----
  2629. .. _class_@GlobalScope_property_Input:
  2630. .. rst-class:: classref-property
  2631. :ref:`Input<class_Input>` **Input** :ref:`🔗<class_@GlobalScope_property_Input>`
  2632. The :ref:`Input<class_Input>` singleton.
  2633. .. rst-class:: classref-item-separator
  2634. ----
  2635. .. _class_@GlobalScope_property_InputMap:
  2636. .. rst-class:: classref-property
  2637. :ref:`InputMap<class_InputMap>` **InputMap** :ref:`🔗<class_@GlobalScope_property_InputMap>`
  2638. The :ref:`InputMap<class_InputMap>` singleton.
  2639. .. rst-class:: classref-item-separator
  2640. ----
  2641. .. _class_@GlobalScope_property_JavaClassWrapper:
  2642. .. rst-class:: classref-property
  2643. :ref:`JavaClassWrapper<class_JavaClassWrapper>` **JavaClassWrapper** :ref:`🔗<class_@GlobalScope_property_JavaClassWrapper>`
  2644. The :ref:`JavaClassWrapper<class_JavaClassWrapper>` singleton.
  2645. \ **Note:** Only implemented on Android.
  2646. .. rst-class:: classref-item-separator
  2647. ----
  2648. .. _class_@GlobalScope_property_JavaScriptBridge:
  2649. .. rst-class:: classref-property
  2650. :ref:`JavaScriptBridge<class_JavaScriptBridge>` **JavaScriptBridge** :ref:`🔗<class_@GlobalScope_property_JavaScriptBridge>`
  2651. The :ref:`JavaScriptBridge<class_JavaScriptBridge>` singleton.
  2652. \ **Note:** Only implemented on the Web platform.
  2653. .. rst-class:: classref-item-separator
  2654. ----
  2655. .. _class_@GlobalScope_property_Marshalls:
  2656. .. rst-class:: classref-property
  2657. :ref:`Marshalls<class_Marshalls>` **Marshalls** :ref:`🔗<class_@GlobalScope_property_Marshalls>`
  2658. The :ref:`Marshalls<class_Marshalls>` singleton.
  2659. .. rst-class:: classref-item-separator
  2660. ----
  2661. .. _class_@GlobalScope_property_NativeMenu:
  2662. .. rst-class:: classref-property
  2663. :ref:`NativeMenu<class_NativeMenu>` **NativeMenu** :ref:`🔗<class_@GlobalScope_property_NativeMenu>`
  2664. The :ref:`NativeMenu<class_NativeMenu>` singleton.
  2665. \ **Note:** Only implemented on macOS.
  2666. .. rst-class:: classref-item-separator
  2667. ----
  2668. .. _class_@GlobalScope_property_NavigationMeshGenerator:
  2669. .. rst-class:: classref-property
  2670. :ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` **NavigationMeshGenerator** :ref:`🔗<class_@GlobalScope_property_NavigationMeshGenerator>`
  2671. The :ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` singleton.
  2672. .. rst-class:: classref-item-separator
  2673. ----
  2674. .. _class_@GlobalScope_property_NavigationServer2D:
  2675. .. rst-class:: classref-property
  2676. :ref:`NavigationServer2D<class_NavigationServer2D>` **NavigationServer2D** :ref:`🔗<class_@GlobalScope_property_NavigationServer2D>`
  2677. The :ref:`NavigationServer2D<class_NavigationServer2D>` singleton.
  2678. .. rst-class:: classref-item-separator
  2679. ----
  2680. .. _class_@GlobalScope_property_NavigationServer3D:
  2681. .. rst-class:: classref-property
  2682. :ref:`NavigationServer3D<class_NavigationServer3D>` **NavigationServer3D** :ref:`🔗<class_@GlobalScope_property_NavigationServer3D>`
  2683. The :ref:`NavigationServer3D<class_NavigationServer3D>` singleton.
  2684. .. rst-class:: classref-item-separator
  2685. ----
  2686. .. _class_@GlobalScope_property_OS:
  2687. .. rst-class:: classref-property
  2688. :ref:`OS<class_OS>` **OS** :ref:`🔗<class_@GlobalScope_property_OS>`
  2689. The :ref:`OS<class_OS>` singleton.
  2690. .. rst-class:: classref-item-separator
  2691. ----
  2692. .. _class_@GlobalScope_property_Performance:
  2693. .. rst-class:: classref-property
  2694. :ref:`Performance<class_Performance>` **Performance** :ref:`🔗<class_@GlobalScope_property_Performance>`
  2695. The :ref:`Performance<class_Performance>` singleton.
  2696. .. rst-class:: classref-item-separator
  2697. ----
  2698. .. _class_@GlobalScope_property_PhysicsServer2D:
  2699. .. rst-class:: classref-property
  2700. :ref:`PhysicsServer2D<class_PhysicsServer2D>` **PhysicsServer2D** :ref:`🔗<class_@GlobalScope_property_PhysicsServer2D>`
  2701. The :ref:`PhysicsServer2D<class_PhysicsServer2D>` singleton.
  2702. .. rst-class:: classref-item-separator
  2703. ----
  2704. .. _class_@GlobalScope_property_PhysicsServer2DManager:
  2705. .. rst-class:: classref-property
  2706. :ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` **PhysicsServer2DManager** :ref:`🔗<class_@GlobalScope_property_PhysicsServer2DManager>`
  2707. The :ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` singleton.
  2708. .. rst-class:: classref-item-separator
  2709. ----
  2710. .. _class_@GlobalScope_property_PhysicsServer3D:
  2711. .. rst-class:: classref-property
  2712. :ref:`PhysicsServer3D<class_PhysicsServer3D>` **PhysicsServer3D** :ref:`🔗<class_@GlobalScope_property_PhysicsServer3D>`
  2713. The :ref:`PhysicsServer3D<class_PhysicsServer3D>` singleton.
  2714. .. rst-class:: classref-item-separator
  2715. ----
  2716. .. _class_@GlobalScope_property_PhysicsServer3DManager:
  2717. .. rst-class:: classref-property
  2718. :ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` **PhysicsServer3DManager** :ref:`🔗<class_@GlobalScope_property_PhysicsServer3DManager>`
  2719. The :ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` singleton.
  2720. .. rst-class:: classref-item-separator
  2721. ----
  2722. .. _class_@GlobalScope_property_ProjectSettings:
  2723. .. rst-class:: classref-property
  2724. :ref:`ProjectSettings<class_ProjectSettings>` **ProjectSettings** :ref:`🔗<class_@GlobalScope_property_ProjectSettings>`
  2725. The :ref:`ProjectSettings<class_ProjectSettings>` singleton.
  2726. .. rst-class:: classref-item-separator
  2727. ----
  2728. .. _class_@GlobalScope_property_RenderingServer:
  2729. .. rst-class:: classref-property
  2730. :ref:`RenderingServer<class_RenderingServer>` **RenderingServer** :ref:`🔗<class_@GlobalScope_property_RenderingServer>`
  2731. The :ref:`RenderingServer<class_RenderingServer>` singleton.
  2732. .. rst-class:: classref-item-separator
  2733. ----
  2734. .. _class_@GlobalScope_property_ResourceLoader:
  2735. .. rst-class:: classref-property
  2736. :ref:`ResourceLoader<class_ResourceLoader>` **ResourceLoader** :ref:`🔗<class_@GlobalScope_property_ResourceLoader>`
  2737. The :ref:`ResourceLoader<class_ResourceLoader>` singleton.
  2738. .. rst-class:: classref-item-separator
  2739. ----
  2740. .. _class_@GlobalScope_property_ResourceSaver:
  2741. .. rst-class:: classref-property
  2742. :ref:`ResourceSaver<class_ResourceSaver>` **ResourceSaver** :ref:`🔗<class_@GlobalScope_property_ResourceSaver>`
  2743. The :ref:`ResourceSaver<class_ResourceSaver>` singleton.
  2744. .. rst-class:: classref-item-separator
  2745. ----
  2746. .. _class_@GlobalScope_property_ResourceUID:
  2747. .. rst-class:: classref-property
  2748. :ref:`ResourceUID<class_ResourceUID>` **ResourceUID** :ref:`🔗<class_@GlobalScope_property_ResourceUID>`
  2749. The :ref:`ResourceUID<class_ResourceUID>` singleton.
  2750. .. rst-class:: classref-item-separator
  2751. ----
  2752. .. _class_@GlobalScope_property_TextServerManager:
  2753. .. rst-class:: classref-property
  2754. :ref:`TextServerManager<class_TextServerManager>` **TextServerManager** :ref:`🔗<class_@GlobalScope_property_TextServerManager>`
  2755. The :ref:`TextServerManager<class_TextServerManager>` singleton.
  2756. .. rst-class:: classref-item-separator
  2757. ----
  2758. .. _class_@GlobalScope_property_ThemeDB:
  2759. .. rst-class:: classref-property
  2760. :ref:`ThemeDB<class_ThemeDB>` **ThemeDB** :ref:`🔗<class_@GlobalScope_property_ThemeDB>`
  2761. The :ref:`ThemeDB<class_ThemeDB>` singleton.
  2762. .. rst-class:: classref-item-separator
  2763. ----
  2764. .. _class_@GlobalScope_property_Time:
  2765. .. rst-class:: classref-property
  2766. :ref:`Time<class_Time>` **Time** :ref:`🔗<class_@GlobalScope_property_Time>`
  2767. The :ref:`Time<class_Time>` singleton.
  2768. .. rst-class:: classref-item-separator
  2769. ----
  2770. .. _class_@GlobalScope_property_TranslationServer:
  2771. .. rst-class:: classref-property
  2772. :ref:`TranslationServer<class_TranslationServer>` **TranslationServer** :ref:`🔗<class_@GlobalScope_property_TranslationServer>`
  2773. The :ref:`TranslationServer<class_TranslationServer>` singleton.
  2774. .. rst-class:: classref-item-separator
  2775. ----
  2776. .. _class_@GlobalScope_property_WorkerThreadPool:
  2777. .. rst-class:: classref-property
  2778. :ref:`WorkerThreadPool<class_WorkerThreadPool>` **WorkerThreadPool** :ref:`🔗<class_@GlobalScope_property_WorkerThreadPool>`
  2779. The :ref:`WorkerThreadPool<class_WorkerThreadPool>` singleton.
  2780. .. rst-class:: classref-item-separator
  2781. ----
  2782. .. _class_@GlobalScope_property_XRServer:
  2783. .. rst-class:: classref-property
  2784. :ref:`XRServer<class_XRServer>` **XRServer** :ref:`🔗<class_@GlobalScope_property_XRServer>`
  2785. The :ref:`XRServer<class_XRServer>` singleton.
  2786. .. rst-class:: classref-section-separator
  2787. ----
  2788. .. rst-class:: classref-descriptions-group
  2789. Method Descriptions
  2790. -------------------
  2791. .. _class_@GlobalScope_method_abs:
  2792. .. rst-class:: classref-method
  2793. :ref:`Variant<class_Variant>` **abs**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_abs>`
  2794. Returns the absolute value of a :ref:`Variant<class_Variant>` parameter ``x`` (i.e. non-negative value). Supported types: :ref:`int<class_int>`, :ref:`float<class_float>`, :ref:`Vector2<class_Vector2>`, :ref:`Vector2i<class_Vector2i>`, :ref:`Vector3<class_Vector3>`, :ref:`Vector3i<class_Vector3i>`, :ref:`Vector4<class_Vector4>`, :ref:`Vector4i<class_Vector4i>`.
  2795. ::
  2796. var a = abs(-1)
  2797. # a is 1
  2798. var b = abs(-1.2)
  2799. # b is 1.2
  2800. var c = abs(Vector2(-3.5, -4))
  2801. # c is (3.5, 4)
  2802. var d = abs(Vector2i(-5, -6))
  2803. # d is (5, 6)
  2804. var e = abs(Vector3(-7, 8.5, -3.8))
  2805. # e is (7, 8.5, 3.8)
  2806. var f = abs(Vector3i(-7, -8, -9))
  2807. # f is (7, 8, 9)
  2808. \ **Note:** For better type safety, use :ref:`absf<class_@GlobalScope_method_absf>`, :ref:`absi<class_@GlobalScope_method_absi>`, :ref:`Vector2.abs<class_Vector2_method_abs>`, :ref:`Vector2i.abs<class_Vector2i_method_abs>`, :ref:`Vector3.abs<class_Vector3_method_abs>`, :ref:`Vector3i.abs<class_Vector3i_method_abs>`, :ref:`Vector4.abs<class_Vector4_method_abs>`, or :ref:`Vector4i.abs<class_Vector4i_method_abs>`.
  2809. .. rst-class:: classref-item-separator
  2810. ----
  2811. .. _class_@GlobalScope_method_absf:
  2812. .. rst-class:: classref-method
  2813. :ref:`float<class_float>` **absf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_absf>`
  2814. Returns the absolute value of float parameter ``x`` (i.e. positive value).
  2815. ::
  2816. # a is 1.2
  2817. var a = absf(-1.2)
  2818. .. rst-class:: classref-item-separator
  2819. ----
  2820. .. _class_@GlobalScope_method_absi:
  2821. .. rst-class:: classref-method
  2822. :ref:`int<class_int>` **absi**\ (\ x\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_absi>`
  2823. Returns the absolute value of int parameter ``x`` (i.e. positive value).
  2824. ::
  2825. # a is 1
  2826. var a = absi(-1)
  2827. .. rst-class:: classref-item-separator
  2828. ----
  2829. .. _class_@GlobalScope_method_acos:
  2830. .. rst-class:: classref-method
  2831. :ref:`float<class_float>` **acos**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_acos>`
  2832. Returns the arc cosine of ``x`` in radians. Use to get the angle of cosine ``x``. ``x`` will be clamped between ``-1.0`` and ``1.0`` (inclusive), in order to prevent :ref:`acos<class_@GlobalScope_method_acos>` from returning :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
  2833. ::
  2834. # c is 0.523599 or 30 degrees if converted with rad_to_deg(c)
  2835. var c = acos(0.866025)
  2836. .. rst-class:: classref-item-separator
  2837. ----
  2838. .. _class_@GlobalScope_method_acosh:
  2839. .. rst-class:: classref-method
  2840. :ref:`float<class_float>` **acosh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_acosh>`
  2841. Returns the hyperbolic arc (also called inverse) cosine of ``x``, returning a value in radians. Use it to get the angle from an angle's cosine in hyperbolic space if ``x`` is larger or equal to 1. For values of ``x`` lower than 1, it will return 0, in order to prevent :ref:`acosh<class_@GlobalScope_method_acosh>` from returning :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
  2842. ::
  2843. var a = acosh(2) # Returns 1.31695789692482
  2844. cosh(a) # Returns 2
  2845. var b = acosh(-1) # Returns 0
  2846. .. rst-class:: classref-item-separator
  2847. ----
  2848. .. _class_@GlobalScope_method_angle_difference:
  2849. .. rst-class:: classref-method
  2850. :ref:`float<class_float>` **angle_difference**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_angle_difference>`
  2851. Returns the difference between the two angles (in radians), in the range of ``[-PI, +PI]``. When ``from`` and ``to`` are opposite, returns ``-PI`` if ``from`` is smaller than ``to``, or ``PI`` otherwise.
  2852. .. rst-class:: classref-item-separator
  2853. ----
  2854. .. _class_@GlobalScope_method_asin:
  2855. .. rst-class:: classref-method
  2856. :ref:`float<class_float>` **asin**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_asin>`
  2857. Returns the arc sine of ``x`` in radians. Use to get the angle of sine ``x``. ``x`` will be clamped between ``-1.0`` and ``1.0`` (inclusive), in order to prevent :ref:`asin<class_@GlobalScope_method_asin>` from returning :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
  2858. ::
  2859. # s is 0.523599 or 30 degrees if converted with rad_to_deg(s)
  2860. var s = asin(0.5)
  2861. .. rst-class:: classref-item-separator
  2862. ----
  2863. .. _class_@GlobalScope_method_asinh:
  2864. .. rst-class:: classref-method
  2865. :ref:`float<class_float>` **asinh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_asinh>`
  2866. Returns the hyperbolic arc (also called inverse) sine of ``x``, returning a value in radians. Use it to get the angle from an angle's sine in hyperbolic space.
  2867. ::
  2868. var a = asinh(0.9) # Returns 0.8088669356527824
  2869. sinh(a) # Returns 0.9
  2870. .. rst-class:: classref-item-separator
  2871. ----
  2872. .. _class_@GlobalScope_method_atan:
  2873. .. rst-class:: classref-method
  2874. :ref:`float<class_float>` **atan**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_atan>`
  2875. Returns the arc tangent of ``x`` in radians. Use it to get the angle from an angle's tangent in trigonometry.
  2876. The method cannot know in which quadrant the angle should fall. See :ref:`atan2<class_@GlobalScope_method_atan2>` if you have both ``y`` and ``x``.
  2877. ::
  2878. var a = atan(0.5) # a is 0.463648
  2879. If ``x`` is between ``-PI / 2`` and ``PI / 2`` (inclusive), ``atan(tan(x))`` is equal to ``x``.
  2880. .. rst-class:: classref-item-separator
  2881. ----
  2882. .. _class_@GlobalScope_method_atan2:
  2883. .. rst-class:: classref-method
  2884. :ref:`float<class_float>` **atan2**\ (\ y\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_atan2>`
  2885. Returns the arc tangent of ``y/x`` in radians. Use to get the angle of tangent ``y/x``. To compute the value, the method takes into account the sign of both arguments in order to determine the quadrant.
  2886. Important note: The Y coordinate comes first, by convention.
  2887. ::
  2888. var a = atan2(0, -1) # a is 3.141593
  2889. .. rst-class:: classref-item-separator
  2890. ----
  2891. .. _class_@GlobalScope_method_atanh:
  2892. .. rst-class:: classref-method
  2893. :ref:`float<class_float>` **atanh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_atanh>`
  2894. Returns the hyperbolic arc (also called inverse) tangent of ``x``, returning a value in radians. Use it to get the angle from an angle's tangent in hyperbolic space if ``x`` is between -1 and 1 (non-inclusive).
  2895. In mathematics, the inverse hyperbolic tangent is only defined for -1 < ``x`` < 1 in the real set, so values equal or lower to -1 for ``x`` return negative :ref:`@GDScript.INF<class_@GDScript_constant_INF>` and values equal or higher than 1 return positive :ref:`@GDScript.INF<class_@GDScript_constant_INF>` in order to prevent :ref:`atanh<class_@GlobalScope_method_atanh>` from returning :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`.
  2896. ::
  2897. var a = atanh(0.9) # Returns 1.47221948958322
  2898. tanh(a) # Returns 0.9
  2899. var b = atanh(-2) # Returns -inf
  2900. tanh(b) # Returns -1
  2901. .. rst-class:: classref-item-separator
  2902. ----
  2903. .. _class_@GlobalScope_method_bezier_derivative:
  2904. .. rst-class:: classref-method
  2905. :ref:`float<class_float>` **bezier_derivative**\ (\ start\: :ref:`float<class_float>`, control_1\: :ref:`float<class_float>`, control_2\: :ref:`float<class_float>`, end\: :ref:`float<class_float>`, t\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_bezier_derivative>`
  2906. Returns the derivative at the given ``t`` on a one-dimensional `Bézier curve <https://en.wikipedia.org/wiki/B%C3%A9zier_curve>`__ defined by the given ``control_1``, ``control_2``, and ``end`` points.
  2907. .. rst-class:: classref-item-separator
  2908. ----
  2909. .. _class_@GlobalScope_method_bezier_interpolate:
  2910. .. rst-class:: classref-method
  2911. :ref:`float<class_float>` **bezier_interpolate**\ (\ start\: :ref:`float<class_float>`, control_1\: :ref:`float<class_float>`, control_2\: :ref:`float<class_float>`, end\: :ref:`float<class_float>`, t\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_bezier_interpolate>`
  2912. Returns the point at the given ``t`` on a one-dimensional `Bézier curve <https://en.wikipedia.org/wiki/B%C3%A9zier_curve>`__ defined by the given ``control_1``, ``control_2``, and ``end`` points.
  2913. .. rst-class:: classref-item-separator
  2914. ----
  2915. .. _class_@GlobalScope_method_bytes_to_var:
  2916. .. rst-class:: classref-method
  2917. :ref:`Variant<class_Variant>` **bytes_to_var**\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) :ref:`🔗<class_@GlobalScope_method_bytes_to_var>`
  2918. Decodes a byte array back to a :ref:`Variant<class_Variant>` value, without decoding objects.
  2919. \ **Note:** If you need object deserialization, see :ref:`bytes_to_var_with_objects<class_@GlobalScope_method_bytes_to_var_with_objects>`.
  2920. .. rst-class:: classref-item-separator
  2921. ----
  2922. .. _class_@GlobalScope_method_bytes_to_var_with_objects:
  2923. .. rst-class:: classref-method
  2924. :ref:`Variant<class_Variant>` **bytes_to_var_with_objects**\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) :ref:`🔗<class_@GlobalScope_method_bytes_to_var_with_objects>`
  2925. Decodes a byte array back to a :ref:`Variant<class_Variant>` value. Decoding objects is allowed.
  2926. \ **Warning:** Deserialized object can contain code which gets executed. Do not use this option if the serialized object comes from untrusted sources to avoid potential security threats (remote code execution).
  2927. .. rst-class:: classref-item-separator
  2928. ----
  2929. .. _class_@GlobalScope_method_ceil:
  2930. .. rst-class:: classref-method
  2931. :ref:`Variant<class_Variant>` **ceil**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_ceil>`
  2932. Rounds ``x`` upward (towards positive infinity), returning the smallest whole number that is not less than ``x``. Supported types: :ref:`int<class_int>`, :ref:`float<class_float>`, :ref:`Vector2<class_Vector2>`, :ref:`Vector2i<class_Vector2i>`, :ref:`Vector3<class_Vector3>`, :ref:`Vector3i<class_Vector3i>`, :ref:`Vector4<class_Vector4>`, :ref:`Vector4i<class_Vector4i>`.
  2933. ::
  2934. var i = ceil(1.45) # i is 2.0
  2935. i = ceil(1.001) # i is 2.0
  2936. See also :ref:`floor<class_@GlobalScope_method_floor>`, :ref:`round<class_@GlobalScope_method_round>`, and :ref:`snapped<class_@GlobalScope_method_snapped>`.
  2937. \ **Note:** For better type safety, use :ref:`ceilf<class_@GlobalScope_method_ceilf>`, :ref:`ceili<class_@GlobalScope_method_ceili>`, :ref:`Vector2.ceil<class_Vector2_method_ceil>`, :ref:`Vector3.ceil<class_Vector3_method_ceil>`, or :ref:`Vector4.ceil<class_Vector4_method_ceil>`.
  2938. .. rst-class:: classref-item-separator
  2939. ----
  2940. .. _class_@GlobalScope_method_ceilf:
  2941. .. rst-class:: classref-method
  2942. :ref:`float<class_float>` **ceilf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_ceilf>`
  2943. Rounds ``x`` upward (towards positive infinity), returning the smallest whole number that is not less than ``x``.
  2944. A type-safe version of :ref:`ceil<class_@GlobalScope_method_ceil>`, returning a :ref:`float<class_float>`.
  2945. .. rst-class:: classref-item-separator
  2946. ----
  2947. .. _class_@GlobalScope_method_ceili:
  2948. .. rst-class:: classref-method
  2949. :ref:`int<class_int>` **ceili**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_ceili>`
  2950. Rounds ``x`` upward (towards positive infinity), returning the smallest whole number that is not less than ``x``.
  2951. A type-safe version of :ref:`ceil<class_@GlobalScope_method_ceil>`, returning an :ref:`int<class_int>`.
  2952. .. rst-class:: classref-item-separator
  2953. ----
  2954. .. _class_@GlobalScope_method_clamp:
  2955. .. rst-class:: classref-method
  2956. :ref:`Variant<class_Variant>` **clamp**\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_clamp>`
  2957. Clamps the ``value``, returning a :ref:`Variant<class_Variant>` not less than ``min`` and not more than ``max``. Any values that can be compared with the less than and greater than operators will work.
  2958. ::
  2959. var a = clamp(-10, -1, 5)
  2960. # a is -1
  2961. var b = clamp(8.1, 0.9, 5.5)
  2962. # b is 5.5
  2963. \ **Note:** For better type safety, use :ref:`clampf<class_@GlobalScope_method_clampf>`, :ref:`clampi<class_@GlobalScope_method_clampi>`, :ref:`Vector2.clamp<class_Vector2_method_clamp>`, :ref:`Vector2i.clamp<class_Vector2i_method_clamp>`, :ref:`Vector3.clamp<class_Vector3_method_clamp>`, :ref:`Vector3i.clamp<class_Vector3i_method_clamp>`, :ref:`Vector4.clamp<class_Vector4_method_clamp>`, :ref:`Vector4i.clamp<class_Vector4i_method_clamp>`, or :ref:`Color.clamp<class_Color_method_clamp>` (not currently supported by this method).
  2964. \ **Note:** When using this on vectors it will *not* perform component-wise clamping, and will pick ``min`` if ``value < min`` or ``max`` if ``value > max``. To perform component-wise clamping use the methods listed above.
  2965. .. rst-class:: classref-item-separator
  2966. ----
  2967. .. _class_@GlobalScope_method_clampf:
  2968. .. rst-class:: classref-method
  2969. :ref:`float<class_float>` **clampf**\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_clampf>`
  2970. Clamps the ``value``, returning a :ref:`float<class_float>` not less than ``min`` and not more than ``max``.
  2971. ::
  2972. var speed = 42.1
  2973. var a = clampf(speed, 1.0, 20.5) # a is 20.5
  2974. speed = -10.0
  2975. var b = clampf(speed, -1.0, 1.0) # b is -1.0
  2976. .. rst-class:: classref-item-separator
  2977. ----
  2978. .. _class_@GlobalScope_method_clampi:
  2979. .. rst-class:: classref-method
  2980. :ref:`int<class_int>` **clampi**\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_clampi>`
  2981. Clamps the ``value``, returning an :ref:`int<class_int>` not less than ``min`` and not more than ``max``.
  2982. ::
  2983. var speed = 42
  2984. var a = clampi(speed, 1, 20) # a is 20
  2985. speed = -10
  2986. var b = clampi(speed, -1, 1) # b is -1
  2987. .. rst-class:: classref-item-separator
  2988. ----
  2989. .. _class_@GlobalScope_method_cos:
  2990. .. rst-class:: classref-method
  2991. :ref:`float<class_float>` **cos**\ (\ angle_rad\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cos>`
  2992. Returns the cosine of angle ``angle_rad`` in radians.
  2993. ::
  2994. cos(PI * 2) # Returns 1.0
  2995. cos(PI) # Returns -1.0
  2996. cos(deg_to_rad(90)) # Returns 0.0
  2997. .. rst-class:: classref-item-separator
  2998. ----
  2999. .. _class_@GlobalScope_method_cosh:
  3000. .. rst-class:: classref-method
  3001. :ref:`float<class_float>` **cosh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cosh>`
  3002. Returns the hyperbolic cosine of ``x`` in radians.
  3003. ::
  3004. print(cosh(1)) # Prints 1.543081
  3005. .. rst-class:: classref-item-separator
  3006. ----
  3007. .. _class_@GlobalScope_method_cubic_interpolate:
  3008. .. rst-class:: classref-method
  3009. :ref:`float<class_float>` **cubic_interpolate**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cubic_interpolate>`
  3010. Cubic interpolates between two values by the factor defined in ``weight`` with ``pre`` and ``post`` values.
  3011. .. rst-class:: classref-item-separator
  3012. ----
  3013. .. _class_@GlobalScope_method_cubic_interpolate_angle:
  3014. .. rst-class:: classref-method
  3015. :ref:`float<class_float>` **cubic_interpolate_angle**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cubic_interpolate_angle>`
  3016. Cubic interpolates between two rotation values with shortest path by the factor defined in ``weight`` with ``pre`` and ``post`` values. See also :ref:`lerp_angle<class_@GlobalScope_method_lerp_angle>`.
  3017. .. rst-class:: classref-item-separator
  3018. ----
  3019. .. _class_@GlobalScope_method_cubic_interpolate_angle_in_time:
  3020. .. rst-class:: classref-method
  3021. :ref:`float<class_float>` **cubic_interpolate_angle_in_time**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`, to_t\: :ref:`float<class_float>`, pre_t\: :ref:`float<class_float>`, post_t\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cubic_interpolate_angle_in_time>`
  3022. Cubic interpolates between two rotation values with shortest path by the factor defined in ``weight`` with ``pre`` and ``post`` values. See also :ref:`lerp_angle<class_@GlobalScope_method_lerp_angle>`.
  3023. It can perform smoother interpolation than :ref:`cubic_interpolate<class_@GlobalScope_method_cubic_interpolate>` by the time values.
  3024. .. rst-class:: classref-item-separator
  3025. ----
  3026. .. _class_@GlobalScope_method_cubic_interpolate_in_time:
  3027. .. rst-class:: classref-method
  3028. :ref:`float<class_float>` **cubic_interpolate_in_time**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`, to_t\: :ref:`float<class_float>`, pre_t\: :ref:`float<class_float>`, post_t\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cubic_interpolate_in_time>`
  3029. Cubic interpolates between two values by the factor defined in ``weight`` with ``pre`` and ``post`` values.
  3030. It can perform smoother interpolation than :ref:`cubic_interpolate<class_@GlobalScope_method_cubic_interpolate>` by the time values.
  3031. .. rst-class:: classref-item-separator
  3032. ----
  3033. .. _class_@GlobalScope_method_db_to_linear:
  3034. .. rst-class:: classref-method
  3035. :ref:`float<class_float>` **db_to_linear**\ (\ db\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_db_to_linear>`
  3036. Converts from decibels to linear energy (audio).
  3037. .. rst-class:: classref-item-separator
  3038. ----
  3039. .. _class_@GlobalScope_method_deg_to_rad:
  3040. .. rst-class:: classref-method
  3041. :ref:`float<class_float>` **deg_to_rad**\ (\ deg\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_deg_to_rad>`
  3042. Converts an angle expressed in degrees to radians.
  3043. ::
  3044. var r = deg_to_rad(180) # r is 3.141593
  3045. .. rst-class:: classref-item-separator
  3046. ----
  3047. .. _class_@GlobalScope_method_ease:
  3048. .. rst-class:: classref-method
  3049. :ref:`float<class_float>` **ease**\ (\ x\: :ref:`float<class_float>`, curve\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_ease>`
  3050. Returns an "eased" value of ``x`` based on an easing function defined with ``curve``. This easing function is based on an exponent. The ``curve`` can be any floating-point number, with specific values leading to the following behaviors:
  3051. .. code:: text
  3052. - Lower than -1.0 (exclusive): Ease in-out
  3053. - 1.0: Linear
  3054. - Between -1.0 and 0.0 (exclusive): Ease out-in
  3055. - 0.0: Constant
  3056. - Between 0.0 to 1.0 (exclusive): Ease out
  3057. - 1.0: Linear
  3058. - Greater than 1.0 (exclusive): Ease in
  3059. \ `ease() curve values cheatsheet <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/ease_cheatsheet.png>`__\
  3060. See also :ref:`smoothstep<class_@GlobalScope_method_smoothstep>`. If you need to perform more advanced transitions, use :ref:`Tween.interpolate_value<class_Tween_method_interpolate_value>`.
  3061. .. rst-class:: classref-item-separator
  3062. ----
  3063. .. _class_@GlobalScope_method_error_string:
  3064. .. rst-class:: classref-method
  3065. :ref:`String<class_String>` **error_string**\ (\ error\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_error_string>`
  3066. Returns a human-readable name for the given :ref:`Error<enum_@GlobalScope_Error>` code.
  3067. ::
  3068. print(OK) # Prints 0
  3069. print(error_string(OK)) # Prints OK
  3070. print(error_string(ERR_BUSY)) # Prints Busy
  3071. print(error_string(ERR_OUT_OF_MEMORY)) # Prints Out of memory
  3072. .. rst-class:: classref-item-separator
  3073. ----
  3074. .. _class_@GlobalScope_method_exp:
  3075. .. rst-class:: classref-method
  3076. :ref:`float<class_float>` **exp**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_exp>`
  3077. The natural exponential function. It raises the mathematical constant *e* to the power of ``x`` and returns it.
  3078. \ *e* has an approximate value of 2.71828, and can be obtained with ``exp(1)``.
  3079. For exponents to other bases use the method :ref:`pow<class_@GlobalScope_method_pow>`.
  3080. ::
  3081. var a = exp(2) # Approximately 7.39
  3082. .. rst-class:: classref-item-separator
  3083. ----
  3084. .. _class_@GlobalScope_method_floor:
  3085. .. rst-class:: classref-method
  3086. :ref:`Variant<class_Variant>` **floor**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_floor>`
  3087. Rounds ``x`` downward (towards negative infinity), returning the largest whole number that is not more than ``x``. Supported types: :ref:`int<class_int>`, :ref:`float<class_float>`, :ref:`Vector2<class_Vector2>`, :ref:`Vector2i<class_Vector2i>`, :ref:`Vector3<class_Vector3>`, :ref:`Vector3i<class_Vector3i>`, :ref:`Vector4<class_Vector4>`, :ref:`Vector4i<class_Vector4i>`.
  3088. ::
  3089. var a = floor(2.99) # a is 2.0
  3090. a = floor(-2.99) # a is -3.0
  3091. See also :ref:`ceil<class_@GlobalScope_method_ceil>`, :ref:`round<class_@GlobalScope_method_round>`, and :ref:`snapped<class_@GlobalScope_method_snapped>`.
  3092. \ **Note:** For better type safety, use :ref:`floorf<class_@GlobalScope_method_floorf>`, :ref:`floori<class_@GlobalScope_method_floori>`, :ref:`Vector2.floor<class_Vector2_method_floor>`, :ref:`Vector3.floor<class_Vector3_method_floor>`, or :ref:`Vector4.floor<class_Vector4_method_floor>`.
  3093. .. rst-class:: classref-item-separator
  3094. ----
  3095. .. _class_@GlobalScope_method_floorf:
  3096. .. rst-class:: classref-method
  3097. :ref:`float<class_float>` **floorf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_floorf>`
  3098. Rounds ``x`` downward (towards negative infinity), returning the largest whole number that is not more than ``x``.
  3099. A type-safe version of :ref:`floor<class_@GlobalScope_method_floor>`, returning a :ref:`float<class_float>`.
  3100. .. rst-class:: classref-item-separator
  3101. ----
  3102. .. _class_@GlobalScope_method_floori:
  3103. .. rst-class:: classref-method
  3104. :ref:`int<class_int>` **floori**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_floori>`
  3105. Rounds ``x`` downward (towards negative infinity), returning the largest whole number that is not more than ``x``.
  3106. A type-safe version of :ref:`floor<class_@GlobalScope_method_floor>`, returning an :ref:`int<class_int>`.
  3107. \ **Note:** This function is *not* the same as ``int(x)``, which rounds towards 0.
  3108. .. rst-class:: classref-item-separator
  3109. ----
  3110. .. _class_@GlobalScope_method_fmod:
  3111. .. rst-class:: classref-method
  3112. :ref:`float<class_float>` **fmod**\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_fmod>`
  3113. Returns the floating-point remainder of ``x`` divided by ``y``, keeping the sign of ``x``.
  3114. ::
  3115. var remainder = fmod(7, 5.5) # remainder is 1.5
  3116. For the integer remainder operation, use the ``%`` operator.
  3117. .. rst-class:: classref-item-separator
  3118. ----
  3119. .. _class_@GlobalScope_method_fposmod:
  3120. .. rst-class:: classref-method
  3121. :ref:`float<class_float>` **fposmod**\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_fposmod>`
  3122. Returns the floating-point modulus of ``x`` divided by ``y``, wrapping equally in positive and negative.
  3123. ::
  3124. print(" (x) (fmod(x, 1.5)) (fposmod(x, 1.5))")
  3125. for i in 7:
  3126. var x = i * 0.5 - 1.5
  3127. print("%4.1f %4.1f | %4.1f" % [x, fmod(x, 1.5), fposmod(x, 1.5)])
  3128. Prints:
  3129. .. code:: text
  3130. (x) (fmod(x, 1.5)) (fposmod(x, 1.5))
  3131. -1.5 -0.0 | 0.0
  3132. -1.0 -1.0 | 0.5
  3133. -0.5 -0.5 | 1.0
  3134. 0.0 0.0 | 0.0
  3135. 0.5 0.5 | 0.5
  3136. 1.0 1.0 | 1.0
  3137. 1.5 0.0 | 0.0
  3138. .. rst-class:: classref-item-separator
  3139. ----
  3140. .. _class_@GlobalScope_method_hash:
  3141. .. rst-class:: classref-method
  3142. :ref:`int<class_int>` **hash**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_hash>`
  3143. Returns the integer hash of the passed ``variable``.
  3144. .. tabs::
  3145. .. code-tab:: gdscript
  3146. print(hash("a")) # Prints 177670
  3147. .. code-tab:: csharp
  3148. GD.Print(GD.Hash("a")); // Prints 177670
  3149. .. rst-class:: classref-item-separator
  3150. ----
  3151. .. _class_@GlobalScope_method_instance_from_id:
  3152. .. rst-class:: classref-method
  3153. :ref:`Object<class_Object>` **instance_from_id**\ (\ instance_id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_instance_from_id>`
  3154. Returns the :ref:`Object<class_Object>` that corresponds to ``instance_id``. All Objects have a unique instance ID. See also :ref:`Object.get_instance_id<class_Object_method_get_instance_id>`.
  3155. .. tabs::
  3156. .. code-tab:: gdscript
  3157. var foo = "bar"
  3158. func _ready():
  3159. var id = get_instance_id()
  3160. var inst = instance_from_id(id)
  3161. print(inst.foo) # Prints bar
  3162. .. code-tab:: csharp
  3163. public partial class MyNode : Node
  3164. {
  3165. public string Foo { get; set; } = "bar";
  3166. public override void _Ready()
  3167. {
  3168. ulong id = GetInstanceId();
  3169. var inst = (MyNode)InstanceFromId(Id);
  3170. GD.Print(inst.Foo); // Prints bar
  3171. }
  3172. }
  3173. .. rst-class:: classref-item-separator
  3174. ----
  3175. .. _class_@GlobalScope_method_inverse_lerp:
  3176. .. rst-class:: classref-method
  3177. :ref:`float<class_float>` **inverse_lerp**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_inverse_lerp>`
  3178. Returns an interpolation or extrapolation factor considering the range specified in ``from`` and ``to``, and the interpolated value specified in ``weight``. The returned value will be between ``0.0`` and ``1.0`` if ``weight`` is between ``from`` and ``to`` (inclusive). If ``weight`` is located outside this range, then an extrapolation factor will be returned (return value lower than ``0.0`` or greater than ``1.0``). Use :ref:`clamp<class_@GlobalScope_method_clamp>` on the result of :ref:`inverse_lerp<class_@GlobalScope_method_inverse_lerp>` if this is not desired.
  3179. ::
  3180. # The interpolation ratio in the `lerp()` call below is 0.75.
  3181. var middle = lerp(20, 30, 0.75)
  3182. # middle is now 27.5.
  3183. # Now, we pretend to have forgotten the original ratio and want to get it back.
  3184. var ratio = inverse_lerp(20, 30, 27.5)
  3185. # ratio is now 0.75.
  3186. See also :ref:`lerp<class_@GlobalScope_method_lerp>`, which performs the reverse of this operation, and :ref:`remap<class_@GlobalScope_method_remap>` to map a continuous series of values to another.
  3187. .. rst-class:: classref-item-separator
  3188. ----
  3189. .. _class_@GlobalScope_method_is_equal_approx:
  3190. .. rst-class:: classref-method
  3191. :ref:`bool<class_bool>` **is_equal_approx**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_equal_approx>`
  3192. Returns ``true`` if ``a`` and ``b`` are approximately equal to each other.
  3193. Here, "approximately equal" means that ``a`` and ``b`` are within a small internal epsilon of each other, which scales with the magnitude of the numbers.
  3194. Infinity values of the same sign are considered equal.
  3195. .. rst-class:: classref-item-separator
  3196. ----
  3197. .. _class_@GlobalScope_method_is_finite:
  3198. .. rst-class:: classref-method
  3199. :ref:`bool<class_bool>` **is_finite**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_finite>`
  3200. Returns whether ``x`` is a finite value, i.e. it is not :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`, positive infinity, or negative infinity.
  3201. .. rst-class:: classref-item-separator
  3202. ----
  3203. .. _class_@GlobalScope_method_is_inf:
  3204. .. rst-class:: classref-method
  3205. :ref:`bool<class_bool>` **is_inf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_inf>`
  3206. Returns ``true`` if ``x`` is either positive infinity or negative infinity.
  3207. .. rst-class:: classref-item-separator
  3208. ----
  3209. .. _class_@GlobalScope_method_is_instance_id_valid:
  3210. .. rst-class:: classref-method
  3211. :ref:`bool<class_bool>` **is_instance_id_valid**\ (\ id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_is_instance_id_valid>`
  3212. Returns ``true`` if the Object that corresponds to ``id`` is a valid object (e.g. has not been deleted from memory). All Objects have a unique instance ID.
  3213. .. rst-class:: classref-item-separator
  3214. ----
  3215. .. _class_@GlobalScope_method_is_instance_valid:
  3216. .. rst-class:: classref-method
  3217. :ref:`bool<class_bool>` **is_instance_valid**\ (\ instance\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_is_instance_valid>`
  3218. Returns ``true`` if ``instance`` is a valid Object (e.g. has not been deleted from memory).
  3219. .. rst-class:: classref-item-separator
  3220. ----
  3221. .. _class_@GlobalScope_method_is_nan:
  3222. .. rst-class:: classref-method
  3223. :ref:`bool<class_bool>` **is_nan**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_nan>`
  3224. Returns ``true`` if ``x`` is a NaN ("Not a Number" or invalid) value.
  3225. .. rst-class:: classref-item-separator
  3226. ----
  3227. .. _class_@GlobalScope_method_is_same:
  3228. .. rst-class:: classref-method
  3229. :ref:`bool<class_bool>` **is_same**\ (\ a\: :ref:`Variant<class_Variant>`, b\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_is_same>`
  3230. Returns ``true``, for value types, if ``a`` and ``b`` share the same value. Returns ``true``, for reference types, if the references of ``a`` and ``b`` are the same.
  3231. ::
  3232. # Vector2 is a value type
  3233. var vec2_a = Vector2(0, 0)
  3234. var vec2_b = Vector2(0, 0)
  3235. var vec2_c = Vector2(1, 1)
  3236. is_same(vec2_a, vec2_a) # true
  3237. is_same(vec2_a, vec2_b) # true
  3238. is_same(vec2_a, vec2_c) # false
  3239. # Array is a reference type
  3240. var arr_a = []
  3241. var arr_b = []
  3242. is_same(arr_a, arr_a) # true
  3243. is_same(arr_a, arr_b) # false
  3244. These are :ref:`Variant<class_Variant>` value types: ``null``, :ref:`bool<class_bool>`, :ref:`int<class_int>`, :ref:`float<class_float>`, :ref:`String<class_String>`, :ref:`StringName<class_StringName>`, :ref:`Vector2<class_Vector2>`, :ref:`Vector2i<class_Vector2i>`, :ref:`Vector3<class_Vector3>`, :ref:`Vector3i<class_Vector3i>`, :ref:`Vector4<class_Vector4>`, :ref:`Vector4i<class_Vector4i>`, :ref:`Rect2<class_Rect2>`, :ref:`Rect2i<class_Rect2i>`, :ref:`Transform2D<class_Transform2D>`, :ref:`Transform3D<class_Transform3D>`, :ref:`Plane<class_Plane>`, :ref:`Quaternion<class_Quaternion>`, :ref:`AABB<class_AABB>`, :ref:`Basis<class_Basis>`, :ref:`Projection<class_Projection>`, :ref:`Color<class_Color>`, :ref:`NodePath<class_NodePath>`, :ref:`RID<class_RID>`, :ref:`Callable<class_Callable>` and :ref:`Signal<class_Signal>`.
  3245. These are :ref:`Variant<class_Variant>` reference types: :ref:`Object<class_Object>`, :ref:`Dictionary<class_Dictionary>`, :ref:`Array<class_Array>`, :ref:`PackedByteArray<class_PackedByteArray>`, :ref:`PackedInt32Array<class_PackedInt32Array>`, :ref:`PackedInt64Array<class_PackedInt64Array>`, :ref:`PackedFloat32Array<class_PackedFloat32Array>`, :ref:`PackedFloat64Array<class_PackedFloat64Array>`, :ref:`PackedStringArray<class_PackedStringArray>`, :ref:`PackedVector2Array<class_PackedVector2Array>`, :ref:`PackedVector3Array<class_PackedVector3Array>`, :ref:`PackedVector4Array<class_PackedVector4Array>`, and :ref:`PackedColorArray<class_PackedColorArray>`.
  3246. .. rst-class:: classref-item-separator
  3247. ----
  3248. .. _class_@GlobalScope_method_is_zero_approx:
  3249. .. rst-class:: classref-method
  3250. :ref:`bool<class_bool>` **is_zero_approx**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_zero_approx>`
  3251. Returns ``true`` if ``x`` is zero or almost zero. The comparison is done using a tolerance calculation with a small internal epsilon.
  3252. This function is faster than using :ref:`is_equal_approx<class_@GlobalScope_method_is_equal_approx>` with one value as zero.
  3253. .. rst-class:: classref-item-separator
  3254. ----
  3255. .. _class_@GlobalScope_method_lerp:
  3256. .. rst-class:: classref-method
  3257. :ref:`Variant<class_Variant>` **lerp**\ (\ from\: :ref:`Variant<class_Variant>`, to\: :ref:`Variant<class_Variant>`, weight\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_lerp>`
  3258. Linearly interpolates between two values by the factor defined in ``weight``. To perform interpolation, ``weight`` should be between ``0.0`` and ``1.0`` (inclusive). However, values outside this range are allowed and can be used to perform *extrapolation*. If this is not desired, use :ref:`clampf<class_@GlobalScope_method_clampf>` to limit ``weight``.
  3259. Both ``from`` and ``to`` must be the same type. Supported types: :ref:`int<class_int>`, :ref:`float<class_float>`, :ref:`Vector2<class_Vector2>`, :ref:`Vector3<class_Vector3>`, :ref:`Vector4<class_Vector4>`, :ref:`Color<class_Color>`, :ref:`Quaternion<class_Quaternion>`, :ref:`Basis<class_Basis>`, :ref:`Transform2D<class_Transform2D>`, :ref:`Transform3D<class_Transform3D>`.
  3260. ::
  3261. lerp(0, 4, 0.75) # Returns 3.0
  3262. See also :ref:`inverse_lerp<class_@GlobalScope_method_inverse_lerp>` which performs the reverse of this operation. To perform eased interpolation with :ref:`lerp<class_@GlobalScope_method_lerp>`, combine it with :ref:`ease<class_@GlobalScope_method_ease>` or :ref:`smoothstep<class_@GlobalScope_method_smoothstep>`. See also :ref:`remap<class_@GlobalScope_method_remap>` to map a continuous series of values to another.
  3263. \ **Note:** For better type safety, use :ref:`lerpf<class_@GlobalScope_method_lerpf>`, :ref:`Vector2.lerp<class_Vector2_method_lerp>`, :ref:`Vector3.lerp<class_Vector3_method_lerp>`, :ref:`Vector4.lerp<class_Vector4_method_lerp>`, :ref:`Color.lerp<class_Color_method_lerp>`, :ref:`Quaternion.slerp<class_Quaternion_method_slerp>`, :ref:`Basis.slerp<class_Basis_method_slerp>`, :ref:`Transform2D.interpolate_with<class_Transform2D_method_interpolate_with>`, or :ref:`Transform3D.interpolate_with<class_Transform3D_method_interpolate_with>`.
  3264. .. rst-class:: classref-item-separator
  3265. ----
  3266. .. _class_@GlobalScope_method_lerp_angle:
  3267. .. rst-class:: classref-method
  3268. :ref:`float<class_float>` **lerp_angle**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_lerp_angle>`
  3269. Linearly interpolates between two angles (in radians) by a ``weight`` value between 0.0 and 1.0.
  3270. Similar to :ref:`lerp<class_@GlobalScope_method_lerp>`, but interpolates correctly when the angles wrap around :ref:`@GDScript.TAU<class_@GDScript_constant_TAU>`. To perform eased interpolation with :ref:`lerp_angle<class_@GlobalScope_method_lerp_angle>`, combine it with :ref:`ease<class_@GlobalScope_method_ease>` or :ref:`smoothstep<class_@GlobalScope_method_smoothstep>`.
  3271. ::
  3272. extends Sprite
  3273. var elapsed = 0.0
  3274. func _process(delta):
  3275. var min_angle = deg_to_rad(0.0)
  3276. var max_angle = deg_to_rad(90.0)
  3277. rotation = lerp_angle(min_angle, max_angle, elapsed)
  3278. elapsed += delta
  3279. \ **Note:** This function lerps through the shortest path between ``from`` and ``to``. However, when these two angles are approximately ``PI + k * TAU`` apart for any integer ``k``, it's not obvious which way they lerp due to floating-point precision errors. For example, ``lerp_angle(0, PI, weight)`` lerps counter-clockwise, while ``lerp_angle(0, PI + 5 * TAU, weight)`` lerps clockwise.
  3280. .. rst-class:: classref-item-separator
  3281. ----
  3282. .. _class_@GlobalScope_method_lerpf:
  3283. .. rst-class:: classref-method
  3284. :ref:`float<class_float>` **lerpf**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_lerpf>`
  3285. Linearly interpolates between two values by the factor defined in ``weight``. To perform interpolation, ``weight`` should be between ``0.0`` and ``1.0`` (inclusive). However, values outside this range are allowed and can be used to perform *extrapolation*. If this is not desired, use :ref:`clampf<class_@GlobalScope_method_clampf>` on the result of this function.
  3286. ::
  3287. lerpf(0, 4, 0.75) # Returns 3.0
  3288. See also :ref:`inverse_lerp<class_@GlobalScope_method_inverse_lerp>` which performs the reverse of this operation. To perform eased interpolation with :ref:`lerp<class_@GlobalScope_method_lerp>`, combine it with :ref:`ease<class_@GlobalScope_method_ease>` or :ref:`smoothstep<class_@GlobalScope_method_smoothstep>`.
  3289. .. rst-class:: classref-item-separator
  3290. ----
  3291. .. _class_@GlobalScope_method_linear_to_db:
  3292. .. rst-class:: classref-method
  3293. :ref:`float<class_float>` **linear_to_db**\ (\ lin\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_linear_to_db>`
  3294. Converts from linear energy to decibels (audio). Since volume is not normally linear, this can be used to implement volume sliders that behave as expected.
  3295. \ **Example:** Change the Master bus's volume through a :ref:`Slider<class_Slider>` node, which ranges from ``0.0`` to ``1.0``:
  3296. ::
  3297. AudioServer.set_bus_volume_db(AudioServer.get_bus_index("Master"), linear_to_db($Slider.value))
  3298. .. rst-class:: classref-item-separator
  3299. ----
  3300. .. _class_@GlobalScope_method_log:
  3301. .. rst-class:: classref-method
  3302. :ref:`float<class_float>` **log**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_log>`
  3303. Returns the `natural logarithm <https://en.wikipedia.org/wiki/Natural_logarithm>`__ of ``x`` (base `[i]e[/i] <https://en.wikipedia.org/wiki/E_(mathematical_constant)>`__, with *e* being approximately 2.71828). This is the amount of time needed to reach a certain level of continuous growth.
  3304. \ **Note:** This is not the same as the "log" function on most calculators, which uses a base 10 logarithm. To use base 10 logarithm, use ``log(x) / log(10)``.
  3305. ::
  3306. log(10) # Returns 2.302585
  3307. \ **Note:** The logarithm of ``0`` returns ``-inf``, while negative values return ``-nan``.
  3308. .. rst-class:: classref-item-separator
  3309. ----
  3310. .. _class_@GlobalScope_method_max:
  3311. .. rst-class:: classref-method
  3312. :ref:`Variant<class_Variant>` **max**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_max>`
  3313. Returns the maximum of the given numeric values. This function can take any number of arguments.
  3314. ::
  3315. max(1, 7, 3, -6, 5) # Returns 7
  3316. \ **Note:** When using this on vectors it will *not* perform component-wise maximum, and will pick the largest value when compared using ``x < y``. To perform component-wise maximum, use :ref:`Vector2.max<class_Vector2_method_max>`, :ref:`Vector2i.max<class_Vector2i_method_max>`, :ref:`Vector3.max<class_Vector3_method_max>`, :ref:`Vector3i.max<class_Vector3i_method_max>`, :ref:`Vector4.max<class_Vector4_method_max>`, and :ref:`Vector4i.max<class_Vector4i_method_max>`.
  3317. .. rst-class:: classref-item-separator
  3318. ----
  3319. .. _class_@GlobalScope_method_maxf:
  3320. .. rst-class:: classref-method
  3321. :ref:`float<class_float>` **maxf**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_maxf>`
  3322. Returns the maximum of two :ref:`float<class_float>` values.
  3323. ::
  3324. maxf(3.6, 24) # Returns 24.0
  3325. maxf(-3.99, -4) # Returns -3.99
  3326. .. rst-class:: classref-item-separator
  3327. ----
  3328. .. _class_@GlobalScope_method_maxi:
  3329. .. rst-class:: classref-method
  3330. :ref:`int<class_int>` **maxi**\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_maxi>`
  3331. Returns the maximum of two :ref:`int<class_int>` values.
  3332. ::
  3333. maxi(1, 2) # Returns 2
  3334. maxi(-3, -4) # Returns -3
  3335. .. rst-class:: classref-item-separator
  3336. ----
  3337. .. _class_@GlobalScope_method_min:
  3338. .. rst-class:: classref-method
  3339. :ref:`Variant<class_Variant>` **min**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_min>`
  3340. Returns the minimum of the given numeric values. This function can take any number of arguments.
  3341. ::
  3342. min(1, 7, 3, -6, 5) # Returns -6
  3343. \ **Note:** When using this on vectors it will *not* perform component-wise minimum, and will pick the smallest value when compared using ``x < y``. To perform component-wise minimum, use :ref:`Vector2.min<class_Vector2_method_min>`, :ref:`Vector2i.min<class_Vector2i_method_min>`, :ref:`Vector3.min<class_Vector3_method_min>`, :ref:`Vector3i.min<class_Vector3i_method_min>`, :ref:`Vector4.min<class_Vector4_method_min>`, and :ref:`Vector4i.min<class_Vector4i_method_min>`.
  3344. .. rst-class:: classref-item-separator
  3345. ----
  3346. .. _class_@GlobalScope_method_minf:
  3347. .. rst-class:: classref-method
  3348. :ref:`float<class_float>` **minf**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_minf>`
  3349. Returns the minimum of two :ref:`float<class_float>` values.
  3350. ::
  3351. minf(3.6, 24) # Returns 3.6
  3352. minf(-3.99, -4) # Returns -4.0
  3353. .. rst-class:: classref-item-separator
  3354. ----
  3355. .. _class_@GlobalScope_method_mini:
  3356. .. rst-class:: classref-method
  3357. :ref:`int<class_int>` **mini**\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_mini>`
  3358. Returns the minimum of two :ref:`int<class_int>` values.
  3359. ::
  3360. mini(1, 2) # Returns 1
  3361. mini(-3, -4) # Returns -4
  3362. .. rst-class:: classref-item-separator
  3363. ----
  3364. .. _class_@GlobalScope_method_move_toward:
  3365. .. rst-class:: classref-method
  3366. :ref:`float<class_float>` **move_toward**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_move_toward>`
  3367. Moves ``from`` toward ``to`` by the ``delta`` amount. Will not go past ``to``.
  3368. Use a negative ``delta`` value to move away.
  3369. ::
  3370. move_toward(5, 10, 4) # Returns 9
  3371. move_toward(10, 5, 4) # Returns 6
  3372. move_toward(5, 10, 9) # Returns 10
  3373. move_toward(10, 5, -1.5) # Returns 11.5
  3374. .. rst-class:: classref-item-separator
  3375. ----
  3376. .. _class_@GlobalScope_method_nearest_po2:
  3377. .. rst-class:: classref-method
  3378. :ref:`int<class_int>` **nearest_po2**\ (\ value\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_nearest_po2>`
  3379. Returns the smallest integer power of 2 that is greater than or equal to ``value``.
  3380. ::
  3381. nearest_po2(3) # Returns 4
  3382. nearest_po2(4) # Returns 4
  3383. nearest_po2(5) # Returns 8
  3384. nearest_po2(0) # Returns 0 (this may not be expected)
  3385. nearest_po2(-1) # Returns 0 (this may not be expected)
  3386. \ **Warning:** Due to its implementation, this method returns ``0`` rather than ``1`` for values less than or equal to ``0``, with an exception for ``value`` being the smallest negative 64-bit integer (``-9223372036854775808``) in which case the ``value`` is returned unchanged.
  3387. .. rst-class:: classref-item-separator
  3388. ----
  3389. .. _class_@GlobalScope_method_pingpong:
  3390. .. rst-class:: classref-method
  3391. :ref:`float<class_float>` **pingpong**\ (\ value\: :ref:`float<class_float>`, length\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_pingpong>`
  3392. Wraps ``value`` between ``0`` and the ``length``. If the limit is reached, the next value the function returns is decreased to the ``0`` side or increased to the ``length`` side (like a triangle wave). If ``length`` is less than zero, it becomes positive.
  3393. ::
  3394. pingpong(-3.0, 3.0) # Returns 3.0
  3395. pingpong(-2.0, 3.0) # Returns 2.0
  3396. pingpong(-1.0, 3.0) # Returns 1.0
  3397. pingpong(0.0, 3.0) # Returns 0.0
  3398. pingpong(1.0, 3.0) # Returns 1.0
  3399. pingpong(2.0, 3.0) # Returns 2.0
  3400. pingpong(3.0, 3.0) # Returns 3.0
  3401. pingpong(4.0, 3.0) # Returns 2.0
  3402. pingpong(5.0, 3.0) # Returns 1.0
  3403. pingpong(6.0, 3.0) # Returns 0.0
  3404. .. rst-class:: classref-item-separator
  3405. ----
  3406. .. _class_@GlobalScope_method_posmod:
  3407. .. rst-class:: classref-method
  3408. :ref:`int<class_int>` **posmod**\ (\ x\: :ref:`int<class_int>`, y\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_posmod>`
  3409. Returns the integer modulus of ``x`` divided by ``y`` that wraps equally in positive and negative.
  3410. ::
  3411. print("#(i) (i % 3) (posmod(i, 3))")
  3412. for i in range(-3, 4):
  3413. print("%2d %2d | %2d" % [i, i % 3, posmod(i, 3)])
  3414. Prints:
  3415. .. code:: text
  3416. (i) (i % 3) (posmod(i, 3))
  3417. -3 0 | 0
  3418. -2 -2 | 1
  3419. -1 -1 | 2
  3420. 0 0 | 0
  3421. 1 1 | 1
  3422. 2 2 | 2
  3423. 3 0 | 0
  3424. .. rst-class:: classref-item-separator
  3425. ----
  3426. .. _class_@GlobalScope_method_pow:
  3427. .. rst-class:: classref-method
  3428. :ref:`float<class_float>` **pow**\ (\ base\: :ref:`float<class_float>`, exp\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_pow>`
  3429. Returns the result of ``base`` raised to the power of ``exp``.
  3430. In GDScript, this is the equivalent of the ``**`` operator.
  3431. ::
  3432. pow(2, 5) # Returns 32.0
  3433. pow(4, 1.5) # Returns 8.0
  3434. .. rst-class:: classref-item-separator
  3435. ----
  3436. .. _class_@GlobalScope_method_print:
  3437. .. rst-class:: classref-method
  3438. |void| **print**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_print>`
  3439. Converts one or more arguments of any type to string in the best way possible and prints them to the console.
  3440. .. tabs::
  3441. .. code-tab:: gdscript
  3442. var a = [1, 2, 3]
  3443. print("a", "b", a) # Prints ab[1, 2, 3]
  3444. .. code-tab:: csharp
  3445. var a = new Godot.Collections.Array { 1, 2, 3 };
  3446. GD.Print("a", "b", a); // Prints ab[1, 2, 3]
  3447. \ **Note:** Consider using :ref:`push_error<class_@GlobalScope_method_push_error>` and :ref:`push_warning<class_@GlobalScope_method_push_warning>` to print error and warning messages instead of :ref:`print<class_@GlobalScope_method_print>` or :ref:`print_rich<class_@GlobalScope_method_print_rich>`. This distinguishes them from print messages used for debugging purposes, while also displaying a stack trace when an error or warning is printed. See also :ref:`Engine.print_to_stdout<class_Engine_property_print_to_stdout>` and :ref:`ProjectSettings.application/run/disable_stdout<class_ProjectSettings_property_application/run/disable_stdout>`.
  3448. .. rst-class:: classref-item-separator
  3449. ----
  3450. .. _class_@GlobalScope_method_print_rich:
  3451. .. rst-class:: classref-method
  3452. |void| **print_rich**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_print_rich>`
  3453. Converts one or more arguments of any type to string in the best way possible and prints them to the console.
  3454. The following BBCode tags are supported: ``b``, ``i``, ``u``, ``s``, ``indent``, ``code``, ``url``, ``center``, ``right``, ``color``, ``bgcolor``, ``fgcolor``.
  3455. Color tags only support the following named colors: ``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``pink``, ``purple``, ``cyan``, ``white``, ``orange``, ``gray``. Hexadecimal color codes are not supported.
  3456. URL tags only support URLs wrapped by a URL tag, not URLs with a different title.
  3457. When printing to standard output, the supported subset of BBCode is converted to ANSI escape codes for the terminal emulator to display. Support for ANSI escape codes varies across terminal emulators, especially for italic and strikethrough. In standard output, ``code`` is represented with faint text but without any font change. Unsupported tags are left as-is in standard output.
  3458. .. tabs::
  3459. .. code-tab:: gdscript
  3460. print_rich("[color=green][b]Hello world![/b][/color]") # Prints out "Hello world!" in green with a bold font
  3461. .. code-tab:: csharp
  3462. GD.PrintRich("[color=green][b]Hello world![/b][/color]"); // Prints out "Hello world!" in green with a bold font
  3463. \ **Note:** Consider using :ref:`push_error<class_@GlobalScope_method_push_error>` and :ref:`push_warning<class_@GlobalScope_method_push_warning>` to print error and warning messages instead of :ref:`print<class_@GlobalScope_method_print>` or :ref:`print_rich<class_@GlobalScope_method_print_rich>`. This distinguishes them from print messages used for debugging purposes, while also displaying a stack trace when an error or warning is printed.
  3464. \ **Note:** On Windows, only Windows 10 and later correctly displays ANSI escape codes in standard output.
  3465. \ **Note:** Output displayed in the editor supports clickable ``[url=address]text[/url]`` tags. The ``[url]`` tag's ``address`` value is handled by :ref:`OS.shell_open<class_OS_method_shell_open>` when clicked.
  3466. .. rst-class:: classref-item-separator
  3467. ----
  3468. .. _class_@GlobalScope_method_print_verbose:
  3469. .. rst-class:: classref-method
  3470. |void| **print_verbose**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_print_verbose>`
  3471. If verbose mode is enabled (:ref:`OS.is_stdout_verbose<class_OS_method_is_stdout_verbose>` returning ``true``), converts one or more arguments of any type to string in the best way possible and prints them to the console.
  3472. .. rst-class:: classref-item-separator
  3473. ----
  3474. .. _class_@GlobalScope_method_printerr:
  3475. .. rst-class:: classref-method
  3476. |void| **printerr**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_printerr>`
  3477. Prints one or more arguments to strings in the best way possible to standard error line.
  3478. .. tabs::
  3479. .. code-tab:: gdscript
  3480. printerr("prints to stderr")
  3481. .. code-tab:: csharp
  3482. GD.PrintErr("prints to stderr");
  3483. .. rst-class:: classref-item-separator
  3484. ----
  3485. .. _class_@GlobalScope_method_printraw:
  3486. .. rst-class:: classref-method
  3487. |void| **printraw**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_printraw>`
  3488. Prints one or more arguments to strings in the best way possible to the OS terminal. Unlike :ref:`print<class_@GlobalScope_method_print>`, no newline is automatically added at the end.
  3489. \ **Note:** The OS terminal is *not* the same as the editor's Output dock. The output sent to the OS terminal can be seen when running Godot from a terminal. On Windows, this requires using the ``console.exe`` executable.
  3490. .. tabs::
  3491. .. code-tab:: gdscript
  3492. printraw("A")
  3493. printraw("B")
  3494. printraw("C")
  3495. # Prints ABC to terminal
  3496. .. code-tab:: csharp
  3497. GD.PrintRaw("A");
  3498. GD.PrintRaw("B");
  3499. GD.PrintRaw("C");
  3500. // Prints ABC to terminal
  3501. .. rst-class:: classref-item-separator
  3502. ----
  3503. .. _class_@GlobalScope_method_prints:
  3504. .. rst-class:: classref-method
  3505. |void| **prints**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_prints>`
  3506. Prints one or more arguments to the console with a space between each argument.
  3507. .. tabs::
  3508. .. code-tab:: gdscript
  3509. prints("A", "B", "C") # Prints A B C
  3510. .. code-tab:: csharp
  3511. GD.PrintS("A", "B", "C"); // Prints A B C
  3512. .. rst-class:: classref-item-separator
  3513. ----
  3514. .. _class_@GlobalScope_method_printt:
  3515. .. rst-class:: classref-method
  3516. |void| **printt**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_printt>`
  3517. Prints one or more arguments to the console with a tab between each argument.
  3518. .. tabs::
  3519. .. code-tab:: gdscript
  3520. printt("A", "B", "C") # Prints A B C
  3521. .. code-tab:: csharp
  3522. GD.PrintT("A", "B", "C"); // Prints A B C
  3523. .. rst-class:: classref-item-separator
  3524. ----
  3525. .. _class_@GlobalScope_method_push_error:
  3526. .. rst-class:: classref-method
  3527. |void| **push_error**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_push_error>`
  3528. Pushes an error message to Godot's built-in debugger and to the OS terminal.
  3529. .. tabs::
  3530. .. code-tab:: gdscript
  3531. push_error("test error") # Prints "test error" to debugger and terminal as error call
  3532. .. code-tab:: csharp
  3533. GD.PushError("test error"); // Prints "test error" to debugger and terminal as error call
  3534. \ **Note:** This function does not pause project execution. To print an error message and pause project execution in debug builds, use ``assert(false, "test error")`` instead.
  3535. .. rst-class:: classref-item-separator
  3536. ----
  3537. .. _class_@GlobalScope_method_push_warning:
  3538. .. rst-class:: classref-method
  3539. |void| **push_warning**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_push_warning>`
  3540. Pushes a warning message to Godot's built-in debugger and to the OS terminal.
  3541. .. tabs::
  3542. .. code-tab:: gdscript
  3543. push_warning("test warning") # Prints "test warning" to debugger and terminal as warning call
  3544. .. code-tab:: csharp
  3545. GD.PushWarning("test warning"); // Prints "test warning" to debugger and terminal as warning call
  3546. .. rst-class:: classref-item-separator
  3547. ----
  3548. .. _class_@GlobalScope_method_rad_to_deg:
  3549. .. rst-class:: classref-method
  3550. :ref:`float<class_float>` **rad_to_deg**\ (\ rad\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_rad_to_deg>`
  3551. Converts an angle expressed in radians to degrees.
  3552. ::
  3553. rad_to_deg(0.523599) # Returns 30
  3554. rad_to_deg(PI) # Returns 180
  3555. rad_to_deg(PI * 2) # Returns 360
  3556. .. rst-class:: classref-item-separator
  3557. ----
  3558. .. _class_@GlobalScope_method_rand_from_seed:
  3559. .. rst-class:: classref-method
  3560. :ref:`PackedInt64Array<class_PackedInt64Array>` **rand_from_seed**\ (\ seed\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_rand_from_seed>`
  3561. Given a ``seed``, returns a :ref:`PackedInt64Array<class_PackedInt64Array>` of size ``2``, where its first element is the randomized :ref:`int<class_int>` value, and the second element is the same as ``seed``. Passing the same ``seed`` consistently returns the same array.
  3562. \ **Note:** "Seed" here refers to the internal state of the pseudo random number generator, currently implemented as a 64 bit integer.
  3563. ::
  3564. var a = rand_from_seed(4)
  3565. print(a[0]) # Prints 2879024997
  3566. print(a[1]) # Prints 4
  3567. .. rst-class:: classref-item-separator
  3568. ----
  3569. .. _class_@GlobalScope_method_randf:
  3570. .. rst-class:: classref-method
  3571. :ref:`float<class_float>` **randf**\ (\ ) :ref:`🔗<class_@GlobalScope_method_randf>`
  3572. Returns a random floating-point value between ``0.0`` and ``1.0`` (inclusive).
  3573. .. tabs::
  3574. .. code-tab:: gdscript
  3575. randf() # Returns e.g. 0.375671
  3576. .. code-tab:: csharp
  3577. GD.Randf(); // Returns e.g. 0.375671
  3578. .. rst-class:: classref-item-separator
  3579. ----
  3580. .. _class_@GlobalScope_method_randf_range:
  3581. .. rst-class:: classref-method
  3582. :ref:`float<class_float>` **randf_range**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_randf_range>`
  3583. Returns a random floating-point value between ``from`` and ``to`` (inclusive).
  3584. .. tabs::
  3585. .. code-tab:: gdscript
  3586. randf_range(0, 20.5) # Returns e.g. 7.45315
  3587. randf_range(-10, 10) # Returns e.g. -3.844535
  3588. .. code-tab:: csharp
  3589. GD.RandRange(0.0, 20.5); // Returns e.g. 7.45315
  3590. GD.RandRange(-10.0, 10.0); // Returns e.g. -3.844535
  3591. .. rst-class:: classref-item-separator
  3592. ----
  3593. .. _class_@GlobalScope_method_randfn:
  3594. .. rst-class:: classref-method
  3595. :ref:`float<class_float>` **randfn**\ (\ mean\: :ref:`float<class_float>`, deviation\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_randfn>`
  3596. Returns a `normally-distributed <https://en.wikipedia.org/wiki/Normal_distribution>`__, pseudo-random floating-point value from the specified ``mean`` and a standard ``deviation``. This is also known as a Gaussian distribution.
  3597. \ **Note:** This method uses the `Box-Muller transform <https://en.wikipedia.org/wiki/Box%E2%80%93Muller_transform>`__ algorithm.
  3598. .. rst-class:: classref-item-separator
  3599. ----
  3600. .. _class_@GlobalScope_method_randi:
  3601. .. rst-class:: classref-method
  3602. :ref:`int<class_int>` **randi**\ (\ ) :ref:`🔗<class_@GlobalScope_method_randi>`
  3603. Returns a random unsigned 32-bit integer. Use remainder to obtain a random value in the interval ``[0, N - 1]`` (where N is smaller than 2^32).
  3604. .. tabs::
  3605. .. code-tab:: gdscript
  3606. randi() # Returns random integer between 0 and 2^32 - 1
  3607. randi() % 20 # Returns random integer between 0 and 19
  3608. randi() % 100 # Returns random integer between 0 and 99
  3609. randi() % 100 + 1 # Returns random integer between 1 and 100
  3610. .. code-tab:: csharp
  3611. GD.Randi(); // Returns random integer between 0 and 2^32 - 1
  3612. GD.Randi() % 20; // Returns random integer between 0 and 19
  3613. GD.Randi() % 100; // Returns random integer between 0 and 99
  3614. GD.Randi() % 100 + 1; // Returns random integer between 1 and 100
  3615. .. rst-class:: classref-item-separator
  3616. ----
  3617. .. _class_@GlobalScope_method_randi_range:
  3618. .. rst-class:: classref-method
  3619. :ref:`int<class_int>` **randi_range**\ (\ from\: :ref:`int<class_int>`, to\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_randi_range>`
  3620. Returns a random signed 32-bit integer between ``from`` and ``to`` (inclusive). If ``to`` is lesser than ``from``, they are swapped.
  3621. .. tabs::
  3622. .. code-tab:: gdscript
  3623. randi_range(0, 1) # Returns either 0 or 1
  3624. randi_range(-10, 1000) # Returns random integer between -10 and 1000
  3625. .. code-tab:: csharp
  3626. GD.RandRange(0, 1); // Returns either 0 or 1
  3627. GD.RandRange(-10, 1000); // Returns random integer between -10 and 1000
  3628. .. rst-class:: classref-item-separator
  3629. ----
  3630. .. _class_@GlobalScope_method_randomize:
  3631. .. rst-class:: classref-method
  3632. |void| **randomize**\ (\ ) :ref:`🔗<class_@GlobalScope_method_randomize>`
  3633. Randomizes the seed (or the internal state) of the random number generator. The current implementation uses a number based on the device's time.
  3634. \ **Note:** This function is called automatically when the project is run. If you need to fix the seed to have consistent, reproducible results, use :ref:`seed<class_@GlobalScope_method_seed>` to initialize the random number generator.
  3635. .. rst-class:: classref-item-separator
  3636. ----
  3637. .. _class_@GlobalScope_method_remap:
  3638. .. rst-class:: classref-method
  3639. :ref:`float<class_float>` **remap**\ (\ value\: :ref:`float<class_float>`, istart\: :ref:`float<class_float>`, istop\: :ref:`float<class_float>`, ostart\: :ref:`float<class_float>`, ostop\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_remap>`
  3640. Maps a ``value`` from range ``[istart, istop]`` to ``[ostart, ostop]``. See also :ref:`lerp<class_@GlobalScope_method_lerp>` and :ref:`inverse_lerp<class_@GlobalScope_method_inverse_lerp>`. If ``value`` is outside ``[istart, istop]``, then the resulting value will also be outside ``[ostart, ostop]``. If this is not desired, use :ref:`clamp<class_@GlobalScope_method_clamp>` on the result of this function.
  3641. ::
  3642. remap(75, 0, 100, -1, 1) # Returns 0.5
  3643. For complex use cases where multiple ranges are needed, consider using :ref:`Curve<class_Curve>` or :ref:`Gradient<class_Gradient>` instead.
  3644. \ **Note:** If ``istart == istop``, the return value is undefined (most likely NaN, INF, or -INF).
  3645. .. rst-class:: classref-item-separator
  3646. ----
  3647. .. _class_@GlobalScope_method_rid_allocate_id:
  3648. .. rst-class:: classref-method
  3649. :ref:`int<class_int>` **rid_allocate_id**\ (\ ) :ref:`🔗<class_@GlobalScope_method_rid_allocate_id>`
  3650. Allocates a unique ID which can be used by the implementation to construct an RID. This is used mainly from native extensions to implement servers.
  3651. .. rst-class:: classref-item-separator
  3652. ----
  3653. .. _class_@GlobalScope_method_rid_from_int64:
  3654. .. rst-class:: classref-method
  3655. :ref:`RID<class_RID>` **rid_from_int64**\ (\ base\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_rid_from_int64>`
  3656. Creates an RID from a ``base``. This is used mainly from native extensions to build servers.
  3657. .. rst-class:: classref-item-separator
  3658. ----
  3659. .. _class_@GlobalScope_method_rotate_toward:
  3660. .. rst-class:: classref-method
  3661. :ref:`float<class_float>` **rotate_toward**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_rotate_toward>`
  3662. Rotates ``from`` toward ``to`` by the ``delta`` amount. Will not go past ``to``.
  3663. Similar to :ref:`move_toward<class_@GlobalScope_method_move_toward>`, but interpolates correctly when the angles wrap around :ref:`@GDScript.TAU<class_@GDScript_constant_TAU>`.
  3664. If ``delta`` is negative, this function will rotate away from ``to``, toward the opposite angle, and will not go past the opposite angle.
  3665. .. rst-class:: classref-item-separator
  3666. ----
  3667. .. _class_@GlobalScope_method_round:
  3668. .. rst-class:: classref-method
  3669. :ref:`Variant<class_Variant>` **round**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_round>`
  3670. Rounds ``x`` to the nearest whole number, with halfway cases rounded away from 0. Supported types: :ref:`int<class_int>`, :ref:`float<class_float>`, :ref:`Vector2<class_Vector2>`, :ref:`Vector2i<class_Vector2i>`, :ref:`Vector3<class_Vector3>`, :ref:`Vector3i<class_Vector3i>`, :ref:`Vector4<class_Vector4>`, :ref:`Vector4i<class_Vector4i>`.
  3671. ::
  3672. round(2.4) # Returns 2
  3673. round(2.5) # Returns 3
  3674. round(2.6) # Returns 3
  3675. See also :ref:`floor<class_@GlobalScope_method_floor>`, :ref:`ceil<class_@GlobalScope_method_ceil>`, and :ref:`snapped<class_@GlobalScope_method_snapped>`.
  3676. \ **Note:** For better type safety, use :ref:`roundf<class_@GlobalScope_method_roundf>`, :ref:`roundi<class_@GlobalScope_method_roundi>`, :ref:`Vector2.round<class_Vector2_method_round>`, :ref:`Vector3.round<class_Vector3_method_round>`, or :ref:`Vector4.round<class_Vector4_method_round>`.
  3677. .. rst-class:: classref-item-separator
  3678. ----
  3679. .. _class_@GlobalScope_method_roundf:
  3680. .. rst-class:: classref-method
  3681. :ref:`float<class_float>` **roundf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_roundf>`
  3682. Rounds ``x`` to the nearest whole number, with halfway cases rounded away from 0.
  3683. A type-safe version of :ref:`round<class_@GlobalScope_method_round>`, returning a :ref:`float<class_float>`.
  3684. .. rst-class:: classref-item-separator
  3685. ----
  3686. .. _class_@GlobalScope_method_roundi:
  3687. .. rst-class:: classref-method
  3688. :ref:`int<class_int>` **roundi**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_roundi>`
  3689. Rounds ``x`` to the nearest whole number, with halfway cases rounded away from 0.
  3690. A type-safe version of :ref:`round<class_@GlobalScope_method_round>`, returning an :ref:`int<class_int>`.
  3691. .. rst-class:: classref-item-separator
  3692. ----
  3693. .. _class_@GlobalScope_method_seed:
  3694. .. rst-class:: classref-method
  3695. |void| **seed**\ (\ base\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_seed>`
  3696. Sets the seed for the random number generator to ``base``. Setting the seed manually can ensure consistent, repeatable results for most random functions.
  3697. .. tabs::
  3698. .. code-tab:: gdscript
  3699. var my_seed = "Godot Rocks".hash()
  3700. seed(my_seed)
  3701. var a = randf() + randi()
  3702. seed(my_seed)
  3703. var b = randf() + randi()
  3704. # a and b are now identical
  3705. .. code-tab:: csharp
  3706. ulong mySeed = (ulong)GD.Hash("Godot Rocks");
  3707. GD.Seed(mySeed);
  3708. var a = GD.Randf() + GD.Randi();
  3709. GD.Seed(mySeed);
  3710. var b = GD.Randf() + GD.Randi();
  3711. // a and b are now identical
  3712. .. rst-class:: classref-item-separator
  3713. ----
  3714. .. _class_@GlobalScope_method_sign:
  3715. .. rst-class:: classref-method
  3716. :ref:`Variant<class_Variant>` **sign**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_sign>`
  3717. Returns the same type of :ref:`Variant<class_Variant>` as ``x``, with ``-1`` for negative values, ``1`` for positive values, and ``0`` for zeros. For ``nan`` values it returns 0.
  3718. Supported types: :ref:`int<class_int>`, :ref:`float<class_float>`, :ref:`Vector2<class_Vector2>`, :ref:`Vector2i<class_Vector2i>`, :ref:`Vector3<class_Vector3>`, :ref:`Vector3i<class_Vector3i>`, :ref:`Vector4<class_Vector4>`, :ref:`Vector4i<class_Vector4i>`.
  3719. ::
  3720. sign(-6.0) # Returns -1
  3721. sign(0.0) # Returns 0
  3722. sign(6.0) # Returns 1
  3723. sign(NAN) # Returns 0
  3724. sign(Vector3(-6.0, 0.0, 6.0)) # Returns (-1, 0, 1)
  3725. \ **Note:** For better type safety, use :ref:`signf<class_@GlobalScope_method_signf>`, :ref:`signi<class_@GlobalScope_method_signi>`, :ref:`Vector2.sign<class_Vector2_method_sign>`, :ref:`Vector2i.sign<class_Vector2i_method_sign>`, :ref:`Vector3.sign<class_Vector3_method_sign>`, :ref:`Vector3i.sign<class_Vector3i_method_sign>`, :ref:`Vector4.sign<class_Vector4_method_sign>`, or :ref:`Vector4i.sign<class_Vector4i_method_sign>`.
  3726. .. rst-class:: classref-item-separator
  3727. ----
  3728. .. _class_@GlobalScope_method_signf:
  3729. .. rst-class:: classref-method
  3730. :ref:`float<class_float>` **signf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_signf>`
  3731. Returns ``-1.0`` if ``x`` is negative, ``1.0`` if ``x`` is positive, and ``0.0`` if ``x`` is zero. For ``nan`` values of ``x`` it returns 0.0.
  3732. ::
  3733. signf(-6.5) # Returns -1.0
  3734. signf(0.0) # Returns 0.0
  3735. signf(6.5) # Returns 1.0
  3736. signf(NAN) # Returns 0.0
  3737. .. rst-class:: classref-item-separator
  3738. ----
  3739. .. _class_@GlobalScope_method_signi:
  3740. .. rst-class:: classref-method
  3741. :ref:`int<class_int>` **signi**\ (\ x\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_signi>`
  3742. Returns ``-1`` if ``x`` is negative, ``1`` if ``x`` is positive, and ``0`` if ``x`` is zero.
  3743. ::
  3744. signi(-6) # Returns -1
  3745. signi(0) # Returns 0
  3746. signi(6) # Returns 1
  3747. .. rst-class:: classref-item-separator
  3748. ----
  3749. .. _class_@GlobalScope_method_sin:
  3750. .. rst-class:: classref-method
  3751. :ref:`float<class_float>` **sin**\ (\ angle_rad\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_sin>`
  3752. Returns the sine of angle ``angle_rad`` in radians.
  3753. ::
  3754. sin(0.523599) # Returns 0.5
  3755. sin(deg_to_rad(90)) # Returns 1.0
  3756. .. rst-class:: classref-item-separator
  3757. ----
  3758. .. _class_@GlobalScope_method_sinh:
  3759. .. rst-class:: classref-method
  3760. :ref:`float<class_float>` **sinh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_sinh>`
  3761. Returns the hyperbolic sine of ``x``.
  3762. ::
  3763. var a = log(2.0) # Returns 0.693147
  3764. sinh(a) # Returns 0.75
  3765. .. rst-class:: classref-item-separator
  3766. ----
  3767. .. _class_@GlobalScope_method_smoothstep:
  3768. .. rst-class:: classref-method
  3769. :ref:`float<class_float>` **smoothstep**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_smoothstep>`
  3770. Returns a smooth cubic Hermite interpolation between ``0`` and ``1``.
  3771. For positive ranges (when ``from <= to``) the return value is ``0`` when ``x <= from``, and ``1`` when ``x >= to``. If ``x`` lies between ``from`` and ``to``, the return value follows an S-shaped curve that smoothly transitions from ``0`` to ``1``.
  3772. For negative ranges (when ``from > to``) the function is mirrored and returns ``1`` when ``x <= to`` and ``0`` when ``x >= from``.
  3773. This S-shaped curve is the cubic Hermite interpolator, given by ``f(y) = 3*y^2 - 2*y^3`` where ``y = (x-from) / (to-from)``.
  3774. ::
  3775. smoothstep(0, 2, -5.0) # Returns 0.0
  3776. smoothstep(0, 2, 0.5) # Returns 0.15625
  3777. smoothstep(0, 2, 1.0) # Returns 0.5
  3778. smoothstep(0, 2, 2.0) # Returns 1.0
  3779. Compared to :ref:`ease<class_@GlobalScope_method_ease>` with a curve value of ``-1.6521``, :ref:`smoothstep<class_@GlobalScope_method_smoothstep>` returns the smoothest possible curve with no sudden changes in the derivative. If you need to perform more advanced transitions, use :ref:`Tween<class_Tween>` or :ref:`AnimationPlayer<class_AnimationPlayer>`.
  3780. \ `Comparison between smoothstep() and ease(x, -1.6521) return values <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/smoothstep_ease_comparison.png>`__\
  3781. \ `Smoothstep() return values with positive, zero, and negative ranges <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/smoothstep_range.webp>`__
  3782. .. rst-class:: classref-item-separator
  3783. ----
  3784. .. _class_@GlobalScope_method_snapped:
  3785. .. rst-class:: classref-method
  3786. :ref:`Variant<class_Variant>` **snapped**\ (\ x\: :ref:`Variant<class_Variant>`, step\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_snapped>`
  3787. Returns the multiple of ``step`` that is the closest to ``x``. This can also be used to round a floating-point number to an arbitrary number of decimals.
  3788. The returned value is the same type of :ref:`Variant<class_Variant>` as ``step``. Supported types: :ref:`int<class_int>`, :ref:`float<class_float>`, :ref:`Vector2<class_Vector2>`, :ref:`Vector2i<class_Vector2i>`, :ref:`Vector3<class_Vector3>`, :ref:`Vector3i<class_Vector3i>`, :ref:`Vector4<class_Vector4>`, :ref:`Vector4i<class_Vector4i>`.
  3789. ::
  3790. snapped(100, 32) # Returns 96
  3791. snapped(3.14159, 0.01) # Returns 3.14
  3792. snapped(Vector2(34, 70), Vector2(8, 8)) # Returns (32, 72)
  3793. See also :ref:`ceil<class_@GlobalScope_method_ceil>`, :ref:`floor<class_@GlobalScope_method_floor>`, and :ref:`round<class_@GlobalScope_method_round>`.
  3794. \ **Note:** For better type safety, use :ref:`snappedf<class_@GlobalScope_method_snappedf>`, :ref:`snappedi<class_@GlobalScope_method_snappedi>`, :ref:`Vector2.snapped<class_Vector2_method_snapped>`, :ref:`Vector2i.snapped<class_Vector2i_method_snapped>`, :ref:`Vector3.snapped<class_Vector3_method_snapped>`, :ref:`Vector3i.snapped<class_Vector3i_method_snapped>`, :ref:`Vector4.snapped<class_Vector4_method_snapped>`, or :ref:`Vector4i.snapped<class_Vector4i_method_snapped>`.
  3795. .. rst-class:: classref-item-separator
  3796. ----
  3797. .. _class_@GlobalScope_method_snappedf:
  3798. .. rst-class:: classref-method
  3799. :ref:`float<class_float>` **snappedf**\ (\ x\: :ref:`float<class_float>`, step\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_snappedf>`
  3800. Returns the multiple of ``step`` that is the closest to ``x``. This can also be used to round a floating-point number to an arbitrary number of decimals.
  3801. A type-safe version of :ref:`snapped<class_@GlobalScope_method_snapped>`, returning a :ref:`float<class_float>`.
  3802. ::
  3803. snappedf(32.0, 2.5) # Returns 32.5
  3804. snappedf(3.14159, 0.01) # Returns 3.14
  3805. .. rst-class:: classref-item-separator
  3806. ----
  3807. .. _class_@GlobalScope_method_snappedi:
  3808. .. rst-class:: classref-method
  3809. :ref:`int<class_int>` **snappedi**\ (\ x\: :ref:`float<class_float>`, step\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_snappedi>`
  3810. Returns the multiple of ``step`` that is the closest to ``x``.
  3811. A type-safe version of :ref:`snapped<class_@GlobalScope_method_snapped>`, returning an :ref:`int<class_int>`.
  3812. ::
  3813. snappedi(53, 16) # Returns 48
  3814. snappedi(4096, 100) # Returns 4100
  3815. .. rst-class:: classref-item-separator
  3816. ----
  3817. .. _class_@GlobalScope_method_sqrt:
  3818. .. rst-class:: classref-method
  3819. :ref:`float<class_float>` **sqrt**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_sqrt>`
  3820. Returns the square root of ``x``, where ``x`` is a non-negative number.
  3821. ::
  3822. sqrt(9) # Returns 3
  3823. sqrt(10.24) # Returns 3.2
  3824. sqrt(-1) # Returns NaN
  3825. \ **Note:** Negative values of ``x`` return NaN ("Not a Number"). in C#, if you need negative inputs, use ``System.Numerics.Complex``.
  3826. .. rst-class:: classref-item-separator
  3827. ----
  3828. .. _class_@GlobalScope_method_step_decimals:
  3829. .. rst-class:: classref-method
  3830. :ref:`int<class_int>` **step_decimals**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_step_decimals>`
  3831. Returns the position of the first non-zero digit, after the decimal point. Note that the maximum return value is 10, which is a design decision in the implementation.
  3832. ::
  3833. var n = step_decimals(5) # n is 0
  3834. n = step_decimals(1.0005) # n is 4
  3835. n = step_decimals(0.000000005) # n is 9
  3836. .. rst-class:: classref-item-separator
  3837. ----
  3838. .. _class_@GlobalScope_method_str:
  3839. .. rst-class:: classref-method
  3840. :ref:`String<class_String>` **str**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_str>`
  3841. Converts one or more arguments of any :ref:`Variant<class_Variant>` type to a :ref:`String<class_String>` in the best way possible.
  3842. ::
  3843. var a = [10, 20, 30]
  3844. var b = str(a)
  3845. print(len(a)) # Prints 3 (the number of elements in the array).
  3846. print(len(b)) # Prints 12 (the length of the string "[10, 20, 30]").
  3847. .. rst-class:: classref-item-separator
  3848. ----
  3849. .. _class_@GlobalScope_method_str_to_var:
  3850. .. rst-class:: classref-method
  3851. :ref:`Variant<class_Variant>` **str_to_var**\ (\ string\: :ref:`String<class_String>`\ ) :ref:`🔗<class_@GlobalScope_method_str_to_var>`
  3852. Converts a formatted ``string`` that was returned by :ref:`var_to_str<class_@GlobalScope_method_var_to_str>` to the original :ref:`Variant<class_Variant>`.
  3853. .. tabs::
  3854. .. code-tab:: gdscript
  3855. var data = '{ "a": 1, "b": 2 }' # data is a String
  3856. var dict = str_to_var(data) # dict is a Dictionary
  3857. print(dict["a"]) # Prints 1
  3858. .. code-tab:: csharp
  3859. string data = "{ \"a\": 1, \"b\": 2 }"; // data is a string
  3860. var dict = GD.StrToVar(data).AsGodotDictionary(); // dict is a Dictionary
  3861. GD.Print(dict["a"]); // Prints 1
  3862. .. rst-class:: classref-item-separator
  3863. ----
  3864. .. _class_@GlobalScope_method_tan:
  3865. .. rst-class:: classref-method
  3866. :ref:`float<class_float>` **tan**\ (\ angle_rad\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_tan>`
  3867. Returns the tangent of angle ``angle_rad`` in radians.
  3868. ::
  3869. tan(deg_to_rad(45)) # Returns 1
  3870. .. rst-class:: classref-item-separator
  3871. ----
  3872. .. _class_@GlobalScope_method_tanh:
  3873. .. rst-class:: classref-method
  3874. :ref:`float<class_float>` **tanh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_tanh>`
  3875. Returns the hyperbolic tangent of ``x``.
  3876. ::
  3877. var a = log(2.0) # Returns 0.693147
  3878. tanh(a) # Returns 0.6
  3879. .. rst-class:: classref-item-separator
  3880. ----
  3881. .. _class_@GlobalScope_method_type_convert:
  3882. .. rst-class:: classref-method
  3883. :ref:`Variant<class_Variant>` **type_convert**\ (\ variant\: :ref:`Variant<class_Variant>`, type\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_type_convert>`
  3884. Converts the given ``variant`` to the given ``type``, using the :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` values. This method is generous with how it handles types, it can automatically convert between array types, convert numeric :ref:`String<class_String>`\ s to :ref:`int<class_int>`, and converting most things to :ref:`String<class_String>`.
  3885. If the type conversion cannot be done, this method will return the default value for that type, for example converting :ref:`Rect2<class_Rect2>` to :ref:`Vector2<class_Vector2>` will always return :ref:`Vector2.ZERO<class_Vector2_constant_ZERO>`. This method will never show error messages as long as ``type`` is a valid Variant type.
  3886. The returned value is a :ref:`Variant<class_Variant>`, but the data inside and its type will be the same as the requested type.
  3887. ::
  3888. type_convert("Hi!", TYPE_INT) # Returns 0
  3889. type_convert("123", TYPE_INT) # Returns 123
  3890. type_convert(123.4, TYPE_INT) # Returns 123
  3891. type_convert(5, TYPE_VECTOR2) # Returns (0, 0)
  3892. type_convert("Hi!", TYPE_NIL) # Returns null
  3893. .. rst-class:: classref-item-separator
  3894. ----
  3895. .. _class_@GlobalScope_method_type_string:
  3896. .. rst-class:: classref-method
  3897. :ref:`String<class_String>` **type_string**\ (\ type\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_type_string>`
  3898. Returns a human-readable name of the given ``type``, using the :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` values.
  3899. ::
  3900. print(TYPE_INT) # Prints 2.
  3901. print(type_string(TYPE_INT)) # Prints "int".
  3902. print(type_string(TYPE_STRING)) # Prints "String".
  3903. See also :ref:`typeof<class_@GlobalScope_method_typeof>`.
  3904. .. rst-class:: classref-item-separator
  3905. ----
  3906. .. _class_@GlobalScope_method_typeof:
  3907. .. rst-class:: classref-method
  3908. :ref:`int<class_int>` **typeof**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_typeof>`
  3909. Returns the internal type of the given ``variable``, using the :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` values.
  3910. ::
  3911. var json = JSON.new()
  3912. json.parse('["a", "b", "c"]')
  3913. var result = json.get_data()
  3914. if typeof(result) == TYPE_ARRAY:
  3915. print(result[0]) # Prints a
  3916. else:
  3917. print("Unexpected result")
  3918. See also :ref:`type_string<class_@GlobalScope_method_type_string>`.
  3919. .. rst-class:: classref-item-separator
  3920. ----
  3921. .. _class_@GlobalScope_method_var_to_bytes:
  3922. .. rst-class:: classref-method
  3923. :ref:`PackedByteArray<class_PackedByteArray>` **var_to_bytes**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_var_to_bytes>`
  3924. Encodes a :ref:`Variant<class_Variant>` value to a byte array, without encoding objects. Deserialization can be done with :ref:`bytes_to_var<class_@GlobalScope_method_bytes_to_var>`.
  3925. \ **Note:** If you need object serialization, see :ref:`var_to_bytes_with_objects<class_@GlobalScope_method_var_to_bytes_with_objects>`.
  3926. \ **Note:** Encoding :ref:`Callable<class_Callable>` is not supported and will result in an empty value, regardless of the data.
  3927. .. rst-class:: classref-item-separator
  3928. ----
  3929. .. _class_@GlobalScope_method_var_to_bytes_with_objects:
  3930. .. rst-class:: classref-method
  3931. :ref:`PackedByteArray<class_PackedByteArray>` **var_to_bytes_with_objects**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_var_to_bytes_with_objects>`
  3932. Encodes a :ref:`Variant<class_Variant>` value to a byte array. Encoding objects is allowed (and can potentially include executable code). Deserialization can be done with :ref:`bytes_to_var_with_objects<class_@GlobalScope_method_bytes_to_var_with_objects>`.
  3933. \ **Note:** Encoding :ref:`Callable<class_Callable>` is not supported and will result in an empty value, regardless of the data.
  3934. .. rst-class:: classref-item-separator
  3935. ----
  3936. .. _class_@GlobalScope_method_var_to_str:
  3937. .. rst-class:: classref-method
  3938. :ref:`String<class_String>` **var_to_str**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_var_to_str>`
  3939. Converts a :ref:`Variant<class_Variant>` ``variable`` to a formatted :ref:`String<class_String>` that can then be parsed using :ref:`str_to_var<class_@GlobalScope_method_str_to_var>`.
  3940. .. tabs::
  3941. .. code-tab:: gdscript
  3942. var a = { "a": 1, "b": 2 }
  3943. print(var_to_str(a))
  3944. .. code-tab:: csharp
  3945. var a = new Godot.Collections.Dictionary { ["a"] = 1, ["b"] = 2 };
  3946. GD.Print(GD.VarToStr(a));
  3947. Prints:
  3948. .. code:: text
  3949. {
  3950. "a": 1,
  3951. "b": 2
  3952. }
  3953. \ **Note:** Converting :ref:`Signal<class_Signal>` or :ref:`Callable<class_Callable>` is not supported and will result in an empty value for these types, regardless of their data.
  3954. .. rst-class:: classref-item-separator
  3955. ----
  3956. .. _class_@GlobalScope_method_weakref:
  3957. .. rst-class:: classref-method
  3958. :ref:`Variant<class_Variant>` **weakref**\ (\ obj\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_weakref>`
  3959. Returns a :ref:`WeakRef<class_WeakRef>` instance holding a weak reference to ``obj``. Returns an empty :ref:`WeakRef<class_WeakRef>` instance if ``obj`` is ``null``. Prints an error and returns ``null`` if ``obj`` is neither :ref:`Object<class_Object>`-derived nor ``null``.
  3960. A weak reference to an object is not enough to keep the object alive: when the only remaining references to a referent are weak references, garbage collection is free to destroy the referent and reuse its memory for something else. However, until the object is actually destroyed the weak reference may return the object even if there are no strong references to it.
  3961. .. rst-class:: classref-item-separator
  3962. ----
  3963. .. _class_@GlobalScope_method_wrap:
  3964. .. rst-class:: classref-method
  3965. :ref:`Variant<class_Variant>` **wrap**\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_wrap>`
  3966. Wraps the :ref:`Variant<class_Variant>` ``value`` between ``min`` and ``max``. Can be used for creating loop-alike behavior or infinite surfaces.
  3967. Variant types :ref:`int<class_int>` and :ref:`float<class_float>` are supported. If any of the arguments is :ref:`float<class_float>` this function returns a :ref:`float<class_float>`, otherwise it returns an :ref:`int<class_int>`.
  3968. ::
  3969. var a = wrap(4, 5, 10)
  3970. # a is 9 (int)
  3971. var a = wrap(7, 5, 10)
  3972. # a is 7 (int)
  3973. var a = wrap(10.5, 5, 10)
  3974. # a is 5.5 (float)
  3975. .. rst-class:: classref-item-separator
  3976. ----
  3977. .. _class_@GlobalScope_method_wrapf:
  3978. .. rst-class:: classref-method
  3979. :ref:`float<class_float>` **wrapf**\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_wrapf>`
  3980. Wraps the float ``value`` between ``min`` and ``max``. Can be used for creating loop-alike behavior or infinite surfaces.
  3981. ::
  3982. # Infinite loop between 5.0 and 9.9
  3983. value = wrapf(value + 0.1, 5.0, 10.0)
  3984. ::
  3985. # Infinite rotation (in radians)
  3986. angle = wrapf(angle + 0.1, 0.0, TAU)
  3987. ::
  3988. # Infinite rotation (in radians)
  3989. angle = wrapf(angle + 0.1, -PI, PI)
  3990. \ **Note:** If ``min`` is ``0``, this is equivalent to :ref:`fposmod<class_@GlobalScope_method_fposmod>`, so prefer using that instead.
  3991. \ :ref:`wrapf<class_@GlobalScope_method_wrapf>` is more flexible than using the :ref:`fposmod<class_@GlobalScope_method_fposmod>` approach by giving the user control over the minimum value.
  3992. .. rst-class:: classref-item-separator
  3993. ----
  3994. .. _class_@GlobalScope_method_wrapi:
  3995. .. rst-class:: classref-method
  3996. :ref:`int<class_int>` **wrapi**\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_wrapi>`
  3997. Wraps the integer ``value`` between ``min`` and ``max``. Can be used for creating loop-alike behavior or infinite surfaces.
  3998. ::
  3999. # Infinite loop between 5 and 9
  4000. frame = wrapi(frame + 1, 5, 10)
  4001. ::
  4002. # result is -2
  4003. var result = wrapi(-6, -5, -1)
  4004. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  4005. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  4006. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  4007. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  4008. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  4009. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  4010. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  4011. .. |void| replace:: :abbr:`void (No return value.)`