[email protected] 315 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859686068616862686368646865686668676868686968706871687268736874687568766877687868796880688168826883688468856886688768886889689068916892689368946895689668976898689969006901690269036904690569066907690869096910691169126913691469156916691769186919692069216922692369246925692669276928692969306931693269336934693569366937693869396940694169426943694469456946694769486949695069516952695369546955695669576958695969606961696269636964696569666967696869696970697169726973697469756976697769786979698069816982698369846985698669876988698969906991699269936994699569966997699869997000700170027003700470057006700770087009701070117012701370147015701670177018701970207021702270237024702570267027702870297030703170327033703470357036703770387039704070417042704370447045704670477048704970507051705270537054705570567057705870597060706170627063706470657066706770687069707070717072707370747075707670777078707970807081708270837084708570867087708870897090709170927093709470957096709770987099710071017102710371047105710671077108710971107111711271137114711571167117711871197120712171227123712471257126712771287129713071317132713371347135713671377138713971407141714271437144714571467147714871497150715171527153715471557156715771587159716071617162716371647165716671677168716971707171717271737174717571767177717871797180718171827183718471857186718771887189719071917192719371947195719671977198719972007201720272037204720572067207720872097210721172127213721472157216721772187219722072217222722372247225722672277228722972307231723272337234723572367237723872397240724172427243724472457246724772487249725072517252725372547255725672577258725972607261726272637264726572667267726872697270727172727273727472757276727772787279728072817282728372847285728672877288728972907291729272937294729572967297729872997300730173027303730473057306730773087309731073117312731373147315731673177318731973207321732273237324732573267327732873297330733173327333733473357336733773387339734073417342734373447345734673477348734973507351735273537354735573567357735873597360736173627363736473657366736773687369737073717372737373747375737673777378737973807381738273837384738573867387738873897390739173927393739473957396739773987399740074017402740374047405740674077408740974107411741274137414741574167417741874197420742174227423742474257426742774287429743074317432743374347435743674377438743974407441744274437444744574467447744874497450745174527453745474557456745774587459746074617462746374647465746674677468746974707471747274737474747574767477747874797480748174827483748474857486748774887489749074917492749374947495749674977498749975007501750275037504750575067507
  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 related to GDScript which can be accessed in any script 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:`GodotSharp<class_GodotSharp>` | :ref:`GodotSharp<class_@GlobalScope_property_GodotSharp>` |
  49. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  50. | :ref:`IP<class_IP>` | :ref:`IP<class_@GlobalScope_property_IP>` |
  51. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  52. | :ref:`Input<class_Input>` | :ref:`Input<class_@GlobalScope_property_Input>` |
  53. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  54. | :ref:`InputMap<class_InputMap>` | :ref:`InputMap<class_@GlobalScope_property_InputMap>` |
  55. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  56. | :ref:`JavaClassWrapper<class_JavaClassWrapper>` | :ref:`JavaClassWrapper<class_@GlobalScope_property_JavaClassWrapper>` |
  57. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  58. | :ref:`JavaScriptBridge<class_JavaScriptBridge>` | :ref:`JavaScriptBridge<class_@GlobalScope_property_JavaScriptBridge>` |
  59. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  60. | :ref:`Marshalls<class_Marshalls>` | :ref:`Marshalls<class_@GlobalScope_property_Marshalls>` |
  61. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  62. | :ref:`NativeMenu<class_NativeMenu>` | :ref:`NativeMenu<class_@GlobalScope_property_NativeMenu>` |
  63. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  64. | :ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` | :ref:`NavigationMeshGenerator<class_@GlobalScope_property_NavigationMeshGenerator>` |
  65. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  66. | :ref:`NavigationServer2D<class_NavigationServer2D>` | :ref:`NavigationServer2D<class_@GlobalScope_property_NavigationServer2D>` |
  67. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  68. | :ref:`NavigationServer3D<class_NavigationServer3D>` | :ref:`NavigationServer3D<class_@GlobalScope_property_NavigationServer3D>` |
  69. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  70. | :ref:`OS<class_OS>` | :ref:`OS<class_@GlobalScope_property_OS>` |
  71. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  72. | :ref:`Performance<class_Performance>` | :ref:`Performance<class_@GlobalScope_property_Performance>` |
  73. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  74. | :ref:`PhysicsServer2D<class_PhysicsServer2D>` | :ref:`PhysicsServer2D<class_@GlobalScope_property_PhysicsServer2D>` |
  75. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  76. | :ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` | :ref:`PhysicsServer2DManager<class_@GlobalScope_property_PhysicsServer2DManager>` |
  77. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  78. | :ref:`PhysicsServer3D<class_PhysicsServer3D>` | :ref:`PhysicsServer3D<class_@GlobalScope_property_PhysicsServer3D>` |
  79. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  80. | :ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` | :ref:`PhysicsServer3DManager<class_@GlobalScope_property_PhysicsServer3DManager>` |
  81. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  82. | :ref:`ProjectSettings<class_ProjectSettings>` | :ref:`ProjectSettings<class_@GlobalScope_property_ProjectSettings>` |
  83. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  84. | :ref:`RenderingServer<class_RenderingServer>` | :ref:`RenderingServer<class_@GlobalScope_property_RenderingServer>` |
  85. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  86. | :ref:`ResourceLoader<class_ResourceLoader>` | :ref:`ResourceLoader<class_@GlobalScope_property_ResourceLoader>` |
  87. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  88. | :ref:`ResourceSaver<class_ResourceSaver>` | :ref:`ResourceSaver<class_@GlobalScope_property_ResourceSaver>` |
  89. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  90. | :ref:`ResourceUID<class_ResourceUID>` | :ref:`ResourceUID<class_@GlobalScope_property_ResourceUID>` |
  91. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  92. | :ref:`TextServerManager<class_TextServerManager>` | :ref:`TextServerManager<class_@GlobalScope_property_TextServerManager>` |
  93. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  94. | :ref:`ThemeDB<class_ThemeDB>` | :ref:`ThemeDB<class_@GlobalScope_property_ThemeDB>` |
  95. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  96. | :ref:`Time<class_Time>` | :ref:`Time<class_@GlobalScope_property_Time>` |
  97. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  98. | :ref:`TranslationServer<class_TranslationServer>` | :ref:`TranslationServer<class_@GlobalScope_property_TranslationServer>` |
  99. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  100. | :ref:`WorkerThreadPool<class_WorkerThreadPool>` | :ref:`WorkerThreadPool<class_@GlobalScope_property_WorkerThreadPool>` |
  101. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  102. | :ref:`XRServer<class_XRServer>` | :ref:`XRServer<class_@GlobalScope_property_XRServer>` |
  103. +---------------------------------------------------------------+-------------------------------------------------------------------------------------+
  104. .. rst-class:: classref-reftable-group
  105. Methods
  106. -------
  107. .. table::
  108. :widths: auto
  109. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  110. | :ref:`Variant<class_Variant>` | :ref:`abs<class_@GlobalScope_method_abs>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  111. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  112. | :ref:`float<class_float>` | :ref:`absf<class_@GlobalScope_method_absf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  113. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  114. | :ref:`int<class_int>` | :ref:`absi<class_@GlobalScope_method_absi>`\ (\ x\: :ref:`int<class_int>`\ ) |
  115. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  116. | :ref:`float<class_float>` | :ref:`acos<class_@GlobalScope_method_acos>`\ (\ x\: :ref:`float<class_float>`\ ) |
  117. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  118. | :ref:`float<class_float>` | :ref:`acosh<class_@GlobalScope_method_acosh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  119. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  120. | :ref:`float<class_float>` | :ref:`angle_difference<class_@GlobalScope_method_angle_difference>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) |
  121. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  122. | :ref:`float<class_float>` | :ref:`asin<class_@GlobalScope_method_asin>`\ (\ x\: :ref:`float<class_float>`\ ) |
  123. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  124. | :ref:`float<class_float>` | :ref:`asinh<class_@GlobalScope_method_asinh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  125. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  126. | :ref:`float<class_float>` | :ref:`atan<class_@GlobalScope_method_atan>`\ (\ x\: :ref:`float<class_float>`\ ) |
  127. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  128. | :ref:`float<class_float>` | :ref:`atan2<class_@GlobalScope_method_atan2>`\ (\ y\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) |
  129. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  130. | :ref:`float<class_float>` | :ref:`atanh<class_@GlobalScope_method_atanh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  131. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  132. | :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>`\ ) |
  133. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  134. | :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>`\ ) |
  135. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  136. | :ref:`Variant<class_Variant>` | :ref:`bytes_to_var<class_@GlobalScope_method_bytes_to_var>`\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) |
  137. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  138. | :ref:`Variant<class_Variant>` | :ref:`bytes_to_var_with_objects<class_@GlobalScope_method_bytes_to_var_with_objects>`\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) |
  139. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  140. | :ref:`Variant<class_Variant>` | :ref:`ceil<class_@GlobalScope_method_ceil>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  141. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  142. | :ref:`float<class_float>` | :ref:`ceilf<class_@GlobalScope_method_ceilf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  143. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  144. | :ref:`int<class_int>` | :ref:`ceili<class_@GlobalScope_method_ceili>`\ (\ x\: :ref:`float<class_float>`\ ) |
  145. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  146. | :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>`\ ) |
  147. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  148. | :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>`\ ) |
  149. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  150. | :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>`\ ) |
  151. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  152. | :ref:`float<class_float>` | :ref:`cos<class_@GlobalScope_method_cos>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
  153. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  154. | :ref:`float<class_float>` | :ref:`cosh<class_@GlobalScope_method_cosh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  155. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  156. | :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>`\ ) |
  157. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  158. | :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>`\ ) |
  159. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  160. | :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>`\ ) |
  161. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  162. | :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>`\ ) |
  163. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  164. | :ref:`float<class_float>` | :ref:`db_to_linear<class_@GlobalScope_method_db_to_linear>`\ (\ db\: :ref:`float<class_float>`\ ) |
  165. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  166. | :ref:`float<class_float>` | :ref:`deg_to_rad<class_@GlobalScope_method_deg_to_rad>`\ (\ deg\: :ref:`float<class_float>`\ ) |
  167. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  168. | :ref:`float<class_float>` | :ref:`ease<class_@GlobalScope_method_ease>`\ (\ x\: :ref:`float<class_float>`, curve\: :ref:`float<class_float>`\ ) |
  169. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  170. | :ref:`String<class_String>` | :ref:`error_string<class_@GlobalScope_method_error_string>`\ (\ error\: :ref:`int<class_int>`\ ) |
  171. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  172. | :ref:`float<class_float>` | :ref:`exp<class_@GlobalScope_method_exp>`\ (\ x\: :ref:`float<class_float>`\ ) |
  173. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  174. | :ref:`Variant<class_Variant>` | :ref:`floor<class_@GlobalScope_method_floor>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  175. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  176. | :ref:`float<class_float>` | :ref:`floorf<class_@GlobalScope_method_floorf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  177. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  178. | :ref:`int<class_int>` | :ref:`floori<class_@GlobalScope_method_floori>`\ (\ x\: :ref:`float<class_float>`\ ) |
  179. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  180. | :ref:`float<class_float>` | :ref:`fmod<class_@GlobalScope_method_fmod>`\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) |
  181. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  182. | :ref:`float<class_float>` | :ref:`fposmod<class_@GlobalScope_method_fposmod>`\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) |
  183. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  184. | :ref:`int<class_int>` | :ref:`hash<class_@GlobalScope_method_hash>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  185. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  186. | :ref:`Object<class_Object>` | :ref:`instance_from_id<class_@GlobalScope_method_instance_from_id>`\ (\ instance_id\: :ref:`int<class_int>`\ ) |
  187. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  188. | :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>`\ ) |
  189. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  190. | :ref:`bool<class_bool>` | :ref:`is_equal_approx<class_@GlobalScope_method_is_equal_approx>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
  191. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  192. | :ref:`bool<class_bool>` | :ref:`is_finite<class_@GlobalScope_method_is_finite>`\ (\ x\: :ref:`float<class_float>`\ ) |
  193. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  194. | :ref:`bool<class_bool>` | :ref:`is_inf<class_@GlobalScope_method_is_inf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  195. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  196. | :ref:`bool<class_bool>` | :ref:`is_instance_id_valid<class_@GlobalScope_method_is_instance_id_valid>`\ (\ id\: :ref:`int<class_int>`\ ) |
  197. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  198. | :ref:`bool<class_bool>` | :ref:`is_instance_valid<class_@GlobalScope_method_is_instance_valid>`\ (\ instance\: :ref:`Variant<class_Variant>`\ ) |
  199. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  200. | :ref:`bool<class_bool>` | :ref:`is_nan<class_@GlobalScope_method_is_nan>`\ (\ x\: :ref:`float<class_float>`\ ) |
  201. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  202. | :ref:`bool<class_bool>` | :ref:`is_same<class_@GlobalScope_method_is_same>`\ (\ a\: :ref:`Variant<class_Variant>`, b\: :ref:`Variant<class_Variant>`\ ) |
  203. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  204. | :ref:`bool<class_bool>` | :ref:`is_zero_approx<class_@GlobalScope_method_is_zero_approx>`\ (\ x\: :ref:`float<class_float>`\ ) |
  205. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  206. | :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>`\ ) |
  207. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  208. | :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>`\ ) |
  209. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  210. | :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>`\ ) |
  211. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  212. | :ref:`float<class_float>` | :ref:`linear_to_db<class_@GlobalScope_method_linear_to_db>`\ (\ lin\: :ref:`float<class_float>`\ ) |
  213. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  214. | :ref:`float<class_float>` | :ref:`log<class_@GlobalScope_method_log>`\ (\ x\: :ref:`float<class_float>`\ ) |
  215. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  216. | :ref:`Variant<class_Variant>` | :ref:`max<class_@GlobalScope_method_max>`\ (\ ...\ ) |vararg| |
  217. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  218. | :ref:`float<class_float>` | :ref:`maxf<class_@GlobalScope_method_maxf>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
  219. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  220. | :ref:`int<class_int>` | :ref:`maxi<class_@GlobalScope_method_maxi>`\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) |
  221. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  222. | :ref:`Variant<class_Variant>` | :ref:`min<class_@GlobalScope_method_min>`\ (\ ...\ ) |vararg| |
  223. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  224. | :ref:`float<class_float>` | :ref:`minf<class_@GlobalScope_method_minf>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
  225. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  226. | :ref:`int<class_int>` | :ref:`mini<class_@GlobalScope_method_mini>`\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) |
  227. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  228. | :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>`\ ) |
  229. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  230. | :ref:`int<class_int>` | :ref:`nearest_po2<class_@GlobalScope_method_nearest_po2>`\ (\ value\: :ref:`int<class_int>`\ ) |
  231. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  232. | :ref:`float<class_float>` | :ref:`pingpong<class_@GlobalScope_method_pingpong>`\ (\ value\: :ref:`float<class_float>`, length\: :ref:`float<class_float>`\ ) |
  233. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  234. | :ref:`int<class_int>` | :ref:`posmod<class_@GlobalScope_method_posmod>`\ (\ x\: :ref:`int<class_int>`, y\: :ref:`int<class_int>`\ ) |
  235. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  236. | :ref:`float<class_float>` | :ref:`pow<class_@GlobalScope_method_pow>`\ (\ base\: :ref:`float<class_float>`, exp\: :ref:`float<class_float>`\ ) |
  237. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  238. | |void| | :ref:`print<class_@GlobalScope_method_print>`\ (\ ...\ ) |vararg| |
  239. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  240. | |void| | :ref:`print_rich<class_@GlobalScope_method_print_rich>`\ (\ ...\ ) |vararg| |
  241. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  242. | |void| | :ref:`print_verbose<class_@GlobalScope_method_print_verbose>`\ (\ ...\ ) |vararg| |
  243. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  244. | |void| | :ref:`printerr<class_@GlobalScope_method_printerr>`\ (\ ...\ ) |vararg| |
  245. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  246. | |void| | :ref:`printraw<class_@GlobalScope_method_printraw>`\ (\ ...\ ) |vararg| |
  247. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  248. | |void| | :ref:`prints<class_@GlobalScope_method_prints>`\ (\ ...\ ) |vararg| |
  249. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  250. | |void| | :ref:`printt<class_@GlobalScope_method_printt>`\ (\ ...\ ) |vararg| |
  251. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  252. | |void| | :ref:`push_error<class_@GlobalScope_method_push_error>`\ (\ ...\ ) |vararg| |
  253. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  254. | |void| | :ref:`push_warning<class_@GlobalScope_method_push_warning>`\ (\ ...\ ) |vararg| |
  255. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  256. | :ref:`float<class_float>` | :ref:`rad_to_deg<class_@GlobalScope_method_rad_to_deg>`\ (\ rad\: :ref:`float<class_float>`\ ) |
  257. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  258. | :ref:`PackedInt64Array<class_PackedInt64Array>` | :ref:`rand_from_seed<class_@GlobalScope_method_rand_from_seed>`\ (\ seed\: :ref:`int<class_int>`\ ) |
  259. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  260. | :ref:`float<class_float>` | :ref:`randf<class_@GlobalScope_method_randf>`\ (\ ) |
  261. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  262. | :ref:`float<class_float>` | :ref:`randf_range<class_@GlobalScope_method_randf_range>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) |
  263. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  264. | :ref:`float<class_float>` | :ref:`randfn<class_@GlobalScope_method_randfn>`\ (\ mean\: :ref:`float<class_float>`, deviation\: :ref:`float<class_float>`\ ) |
  265. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  266. | :ref:`int<class_int>` | :ref:`randi<class_@GlobalScope_method_randi>`\ (\ ) |
  267. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  268. | :ref:`int<class_int>` | :ref:`randi_range<class_@GlobalScope_method_randi_range>`\ (\ from\: :ref:`int<class_int>`, to\: :ref:`int<class_int>`\ ) |
  269. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  270. | |void| | :ref:`randomize<class_@GlobalScope_method_randomize>`\ (\ ) |
  271. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  272. | :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>`\ ) |
  273. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  274. | :ref:`int<class_int>` | :ref:`rid_allocate_id<class_@GlobalScope_method_rid_allocate_id>`\ (\ ) |
  275. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  276. | :ref:`RID<class_RID>` | :ref:`rid_from_int64<class_@GlobalScope_method_rid_from_int64>`\ (\ base\: :ref:`int<class_int>`\ ) |
  277. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  278. | :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>`\ ) |
  279. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  280. | :ref:`Variant<class_Variant>` | :ref:`round<class_@GlobalScope_method_round>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  281. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  282. | :ref:`float<class_float>` | :ref:`roundf<class_@GlobalScope_method_roundf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  283. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  284. | :ref:`int<class_int>` | :ref:`roundi<class_@GlobalScope_method_roundi>`\ (\ x\: :ref:`float<class_float>`\ ) |
  285. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  286. | |void| | :ref:`seed<class_@GlobalScope_method_seed>`\ (\ base\: :ref:`int<class_int>`\ ) |
  287. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  288. | :ref:`Variant<class_Variant>` | :ref:`sign<class_@GlobalScope_method_sign>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
  289. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  290. | :ref:`float<class_float>` | :ref:`signf<class_@GlobalScope_method_signf>`\ (\ x\: :ref:`float<class_float>`\ ) |
  291. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  292. | :ref:`int<class_int>` | :ref:`signi<class_@GlobalScope_method_signi>`\ (\ x\: :ref:`int<class_int>`\ ) |
  293. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  294. | :ref:`float<class_float>` | :ref:`sin<class_@GlobalScope_method_sin>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
  295. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  296. | :ref:`float<class_float>` | :ref:`sinh<class_@GlobalScope_method_sinh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  297. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  298. | :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>`\ ) |
  299. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  300. | :ref:`Variant<class_Variant>` | :ref:`snapped<class_@GlobalScope_method_snapped>`\ (\ x\: :ref:`Variant<class_Variant>`, step\: :ref:`Variant<class_Variant>`\ ) |
  301. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  302. | :ref:`float<class_float>` | :ref:`snappedf<class_@GlobalScope_method_snappedf>`\ (\ x\: :ref:`float<class_float>`, step\: :ref:`float<class_float>`\ ) |
  303. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  304. | :ref:`int<class_int>` | :ref:`snappedi<class_@GlobalScope_method_snappedi>`\ (\ x\: :ref:`float<class_float>`, step\: :ref:`int<class_int>`\ ) |
  305. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  306. | :ref:`float<class_float>` | :ref:`sqrt<class_@GlobalScope_method_sqrt>`\ (\ x\: :ref:`float<class_float>`\ ) |
  307. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  308. | :ref:`int<class_int>` | :ref:`step_decimals<class_@GlobalScope_method_step_decimals>`\ (\ x\: :ref:`float<class_float>`\ ) |
  309. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  310. | :ref:`String<class_String>` | :ref:`str<class_@GlobalScope_method_str>`\ (\ ...\ ) |vararg| |
  311. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  312. | :ref:`Variant<class_Variant>` | :ref:`str_to_var<class_@GlobalScope_method_str_to_var>`\ (\ string\: :ref:`String<class_String>`\ ) |
  313. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  314. | :ref:`float<class_float>` | :ref:`tan<class_@GlobalScope_method_tan>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
  315. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  316. | :ref:`float<class_float>` | :ref:`tanh<class_@GlobalScope_method_tanh>`\ (\ x\: :ref:`float<class_float>`\ ) |
  317. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  318. | :ref:`Variant<class_Variant>` | :ref:`type_convert<class_@GlobalScope_method_type_convert>`\ (\ variant\: :ref:`Variant<class_Variant>`, type\: :ref:`int<class_int>`\ ) |
  319. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  320. | :ref:`String<class_String>` | :ref:`type_string<class_@GlobalScope_method_type_string>`\ (\ type\: :ref:`int<class_int>`\ ) |
  321. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  322. | :ref:`int<class_int>` | :ref:`typeof<class_@GlobalScope_method_typeof>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  323. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  324. | :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`var_to_bytes<class_@GlobalScope_method_var_to_bytes>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  325. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  326. | :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`var_to_bytes_with_objects<class_@GlobalScope_method_var_to_bytes_with_objects>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  327. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  328. | :ref:`String<class_String>` | :ref:`var_to_str<class_@GlobalScope_method_var_to_str>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
  329. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  330. | :ref:`Variant<class_Variant>` | :ref:`weakref<class_@GlobalScope_method_weakref>`\ (\ obj\: :ref:`Variant<class_Variant>`\ ) |
  331. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  332. | :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>`\ ) |
  333. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  334. | :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>`\ ) |
  335. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  336. | :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>`\ ) |
  337. +-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  338. .. rst-class:: classref-section-separator
  339. ----
  340. .. rst-class:: classref-descriptions-group
  341. Enumerations
  342. ------------
  343. .. _enum_@GlobalScope_Side:
  344. .. rst-class:: classref-enumeration
  345. enum **Side**:
  346. .. _class_@GlobalScope_constant_SIDE_LEFT:
  347. .. rst-class:: classref-enumeration-constant
  348. :ref:`Side<enum_@GlobalScope_Side>` **SIDE_LEFT** = ``0``
  349. Left side, usually used for :ref:`Control<class_Control>` or :ref:`StyleBox<class_StyleBox>`-derived classes.
  350. .. _class_@GlobalScope_constant_SIDE_TOP:
  351. .. rst-class:: classref-enumeration-constant
  352. :ref:`Side<enum_@GlobalScope_Side>` **SIDE_TOP** = ``1``
  353. Top side, usually used for :ref:`Control<class_Control>` or :ref:`StyleBox<class_StyleBox>`-derived classes.
  354. .. _class_@GlobalScope_constant_SIDE_RIGHT:
  355. .. rst-class:: classref-enumeration-constant
  356. :ref:`Side<enum_@GlobalScope_Side>` **SIDE_RIGHT** = ``2``
  357. Right side, usually used for :ref:`Control<class_Control>` or :ref:`StyleBox<class_StyleBox>`-derived classes.
  358. .. _class_@GlobalScope_constant_SIDE_BOTTOM:
  359. .. rst-class:: classref-enumeration-constant
  360. :ref:`Side<enum_@GlobalScope_Side>` **SIDE_BOTTOM** = ``3``
  361. Bottom side, usually used for :ref:`Control<class_Control>` or :ref:`StyleBox<class_StyleBox>`-derived classes.
  362. .. rst-class:: classref-item-separator
  363. ----
  364. .. _enum_@GlobalScope_Corner:
  365. .. rst-class:: classref-enumeration
  366. enum **Corner**:
  367. .. _class_@GlobalScope_constant_CORNER_TOP_LEFT:
  368. .. rst-class:: classref-enumeration-constant
  369. :ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_TOP_LEFT** = ``0``
  370. Top-left corner.
  371. .. _class_@GlobalScope_constant_CORNER_TOP_RIGHT:
  372. .. rst-class:: classref-enumeration-constant
  373. :ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_TOP_RIGHT** = ``1``
  374. Top-right corner.
  375. .. _class_@GlobalScope_constant_CORNER_BOTTOM_RIGHT:
  376. .. rst-class:: classref-enumeration-constant
  377. :ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_BOTTOM_RIGHT** = ``2``
  378. Bottom-right corner.
  379. .. _class_@GlobalScope_constant_CORNER_BOTTOM_LEFT:
  380. .. rst-class:: classref-enumeration-constant
  381. :ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_BOTTOM_LEFT** = ``3``
  382. Bottom-left corner.
  383. .. rst-class:: classref-item-separator
  384. ----
  385. .. _enum_@GlobalScope_Orientation:
  386. .. rst-class:: classref-enumeration
  387. enum **Orientation**:
  388. .. _class_@GlobalScope_constant_VERTICAL:
  389. .. rst-class:: classref-enumeration-constant
  390. :ref:`Orientation<enum_@GlobalScope_Orientation>` **VERTICAL** = ``1``
  391. General vertical alignment, usually used for :ref:`Separator<class_Separator>`, :ref:`ScrollBar<class_ScrollBar>`, :ref:`Slider<class_Slider>`, etc.
  392. .. _class_@GlobalScope_constant_HORIZONTAL:
  393. .. rst-class:: classref-enumeration-constant
  394. :ref:`Orientation<enum_@GlobalScope_Orientation>` **HORIZONTAL** = ``0``
  395. General horizontal alignment, usually used for :ref:`Separator<class_Separator>`, :ref:`ScrollBar<class_ScrollBar>`, :ref:`Slider<class_Slider>`, etc.
  396. .. rst-class:: classref-item-separator
  397. ----
  398. .. _enum_@GlobalScope_ClockDirection:
  399. .. rst-class:: classref-enumeration
  400. enum **ClockDirection**:
  401. .. _class_@GlobalScope_constant_CLOCKWISE:
  402. .. rst-class:: classref-enumeration-constant
  403. :ref:`ClockDirection<enum_@GlobalScope_ClockDirection>` **CLOCKWISE** = ``0``
  404. Clockwise rotation. Used by some methods (e.g. :ref:`Image.rotate_90<class_Image_method_rotate_90>`).
  405. .. _class_@GlobalScope_constant_COUNTERCLOCKWISE:
  406. .. rst-class:: classref-enumeration-constant
  407. :ref:`ClockDirection<enum_@GlobalScope_ClockDirection>` **COUNTERCLOCKWISE** = ``1``
  408. Counter-clockwise rotation. Used by some methods (e.g. :ref:`Image.rotate_90<class_Image_method_rotate_90>`).
  409. .. rst-class:: classref-item-separator
  410. ----
  411. .. _enum_@GlobalScope_HorizontalAlignment:
  412. .. rst-class:: classref-enumeration
  413. enum **HorizontalAlignment**:
  414. .. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_LEFT:
  415. .. rst-class:: classref-enumeration-constant
  416. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_LEFT** = ``0``
  417. Horizontal left alignment, usually for text-derived classes.
  418. .. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_CENTER:
  419. .. rst-class:: classref-enumeration-constant
  420. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_CENTER** = ``1``
  421. Horizontal center alignment, usually for text-derived classes.
  422. .. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_RIGHT:
  423. .. rst-class:: classref-enumeration-constant
  424. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_RIGHT** = ``2``
  425. Horizontal right alignment, usually for text-derived classes.
  426. .. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_FILL:
  427. .. rst-class:: classref-enumeration-constant
  428. :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_FILL** = ``3``
  429. Expand row to fit width, usually for text-derived classes.
  430. .. rst-class:: classref-item-separator
  431. ----
  432. .. _enum_@GlobalScope_VerticalAlignment:
  433. .. rst-class:: classref-enumeration
  434. enum **VerticalAlignment**:
  435. .. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_TOP:
  436. .. rst-class:: classref-enumeration-constant
  437. :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_TOP** = ``0``
  438. Vertical top alignment, usually for text-derived classes.
  439. .. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_CENTER:
  440. .. rst-class:: classref-enumeration-constant
  441. :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_CENTER** = ``1``
  442. Vertical center alignment, usually for text-derived classes.
  443. .. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_BOTTOM:
  444. .. rst-class:: classref-enumeration-constant
  445. :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_BOTTOM** = ``2``
  446. Vertical bottom alignment, usually for text-derived classes.
  447. .. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_FILL:
  448. .. rst-class:: classref-enumeration-constant
  449. :ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_FILL** = ``3``
  450. Expand rows to fit height, usually for text-derived classes.
  451. .. rst-class:: classref-item-separator
  452. ----
  453. .. _enum_@GlobalScope_InlineAlignment:
  454. .. rst-class:: classref-enumeration
  455. enum **InlineAlignment**:
  456. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TOP_TO:
  457. .. rst-class:: classref-enumeration-constant
  458. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TOP_TO** = ``0``
  459. Aligns the top of the inline object (e.g. image, table) to the position of the text specified by ``INLINE_ALIGNMENT_TO_*`` constant.
  460. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_CENTER_TO:
  461. .. rst-class:: classref-enumeration-constant
  462. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_CENTER_TO** = ``1``
  463. Aligns the center of the inline object (e.g. image, table) to the position of the text specified by ``INLINE_ALIGNMENT_TO_*`` constant.
  464. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BASELINE_TO:
  465. .. rst-class:: classref-enumeration-constant
  466. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BASELINE_TO** = ``3``
  467. 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.
  468. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BOTTOM_TO:
  469. .. rst-class:: classref-enumeration-constant
  470. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BOTTOM_TO** = ``2``
  471. Aligns the bottom of the inline object (e.g. image, table) to the position of the text specified by ``INLINE_ALIGNMENT_TO_*`` constant.
  472. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_TOP:
  473. .. rst-class:: classref-enumeration-constant
  474. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_TOP** = ``0``
  475. Aligns the position of the inline object (e.g. image, table) specified by ``INLINE_ALIGNMENT_*_TO`` constant to the top of the text.
  476. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_CENTER:
  477. .. rst-class:: classref-enumeration-constant
  478. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_CENTER** = ``4``
  479. Aligns the position of the inline object (e.g. image, table) specified by ``INLINE_ALIGNMENT_*_TO`` constant to the center of the text.
  480. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_BASELINE:
  481. .. rst-class:: classref-enumeration-constant
  482. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_BASELINE** = ``8``
  483. Aligns the position of the inline object (e.g. image, table) specified by ``INLINE_ALIGNMENT_*_TO`` constant to the baseline of the text.
  484. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_BOTTOM:
  485. .. rst-class:: classref-enumeration-constant
  486. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_BOTTOM** = ``12``
  487. Aligns inline object (e.g. image, table) to the bottom of the text.
  488. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TOP:
  489. .. rst-class:: classref-enumeration-constant
  490. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TOP** = ``0``
  491. 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``.
  492. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_CENTER:
  493. .. rst-class:: classref-enumeration-constant
  494. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_CENTER** = ``5``
  495. 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``.
  496. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BOTTOM:
  497. .. rst-class:: classref-enumeration-constant
  498. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BOTTOM** = ``14``
  499. 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``.
  500. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_IMAGE_MASK:
  501. .. rst-class:: classref-enumeration-constant
  502. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_IMAGE_MASK** = ``3``
  503. A bit mask for ``INLINE_ALIGNMENT_*_TO`` alignment constants.
  504. .. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TEXT_MASK:
  505. .. rst-class:: classref-enumeration-constant
  506. :ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TEXT_MASK** = ``12``
  507. A bit mask for ``INLINE_ALIGNMENT_TO_*`` alignment constants.
  508. .. rst-class:: classref-item-separator
  509. ----
  510. .. _enum_@GlobalScope_EulerOrder:
  511. .. rst-class:: classref-enumeration
  512. enum **EulerOrder**:
  513. .. _class_@GlobalScope_constant_EULER_ORDER_XYZ:
  514. .. rst-class:: classref-enumeration-constant
  515. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_XYZ** = ``0``
  516. 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.
  517. .. _class_@GlobalScope_constant_EULER_ORDER_XZY:
  518. .. rst-class:: classref-enumeration-constant
  519. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_XZY** = ``1``
  520. 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.
  521. .. _class_@GlobalScope_constant_EULER_ORDER_YXZ:
  522. .. rst-class:: classref-enumeration-constant
  523. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_YXZ** = ``2``
  524. 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.
  525. .. _class_@GlobalScope_constant_EULER_ORDER_YZX:
  526. .. rst-class:: classref-enumeration-constant
  527. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_YZX** = ``3``
  528. 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.
  529. .. _class_@GlobalScope_constant_EULER_ORDER_ZXY:
  530. .. rst-class:: classref-enumeration-constant
  531. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_ZXY** = ``4``
  532. 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.
  533. .. _class_@GlobalScope_constant_EULER_ORDER_ZYX:
  534. .. rst-class:: classref-enumeration-constant
  535. :ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_ZYX** = ``5``
  536. 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.
  537. .. rst-class:: classref-item-separator
  538. ----
  539. .. _enum_@GlobalScope_Key:
  540. .. rst-class:: classref-enumeration
  541. enum **Key**:
  542. .. _class_@GlobalScope_constant_KEY_NONE:
  543. .. rst-class:: classref-enumeration-constant
  544. :ref:`Key<enum_@GlobalScope_Key>` **KEY_NONE** = ``0``
  545. Enum value which doesn't correspond to any key. This is used to initialize :ref:`Key<enum_@GlobalScope_Key>` properties with a generic state.
  546. .. _class_@GlobalScope_constant_KEY_SPECIAL:
  547. .. rst-class:: classref-enumeration-constant
  548. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SPECIAL** = ``4194304``
  549. Keycodes with this bit applied are non-printable.
  550. .. _class_@GlobalScope_constant_KEY_ESCAPE:
  551. .. rst-class:: classref-enumeration-constant
  552. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ESCAPE** = ``4194305``
  553. Escape key.
  554. .. _class_@GlobalScope_constant_KEY_TAB:
  555. .. rst-class:: classref-enumeration-constant
  556. :ref:`Key<enum_@GlobalScope_Key>` **KEY_TAB** = ``4194306``
  557. Tab key.
  558. .. _class_@GlobalScope_constant_KEY_BACKTAB:
  559. .. rst-class:: classref-enumeration-constant
  560. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKTAB** = ``4194307``
  561. Shift + Tab key.
  562. .. _class_@GlobalScope_constant_KEY_BACKSPACE:
  563. .. rst-class:: classref-enumeration-constant
  564. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKSPACE** = ``4194308``
  565. Backspace key.
  566. .. _class_@GlobalScope_constant_KEY_ENTER:
  567. .. rst-class:: classref-enumeration-constant
  568. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ENTER** = ``4194309``
  569. Return key (on the main keyboard).
  570. .. _class_@GlobalScope_constant_KEY_KP_ENTER:
  571. .. rst-class:: classref-enumeration-constant
  572. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_ENTER** = ``4194310``
  573. Enter key on the numeric keypad.
  574. .. _class_@GlobalScope_constant_KEY_INSERT:
  575. .. rst-class:: classref-enumeration-constant
  576. :ref:`Key<enum_@GlobalScope_Key>` **KEY_INSERT** = ``4194311``
  577. Insert key.
  578. .. _class_@GlobalScope_constant_KEY_DELETE:
  579. .. rst-class:: classref-enumeration-constant
  580. :ref:`Key<enum_@GlobalScope_Key>` **KEY_DELETE** = ``4194312``
  581. Delete key.
  582. .. _class_@GlobalScope_constant_KEY_PAUSE:
  583. .. rst-class:: classref-enumeration-constant
  584. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PAUSE** = ``4194313``
  585. Pause key.
  586. .. _class_@GlobalScope_constant_KEY_PRINT:
  587. .. rst-class:: classref-enumeration-constant
  588. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PRINT** = ``4194314``
  589. Print Screen key.
  590. .. _class_@GlobalScope_constant_KEY_SYSREQ:
  591. .. rst-class:: classref-enumeration-constant
  592. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SYSREQ** = ``4194315``
  593. System Request key.
  594. .. _class_@GlobalScope_constant_KEY_CLEAR:
  595. .. rst-class:: classref-enumeration-constant
  596. :ref:`Key<enum_@GlobalScope_Key>` **KEY_CLEAR** = ``4194316``
  597. Clear key.
  598. .. _class_@GlobalScope_constant_KEY_HOME:
  599. .. rst-class:: classref-enumeration-constant
  600. :ref:`Key<enum_@GlobalScope_Key>` **KEY_HOME** = ``4194317``
  601. Home key.
  602. .. _class_@GlobalScope_constant_KEY_END:
  603. .. rst-class:: classref-enumeration-constant
  604. :ref:`Key<enum_@GlobalScope_Key>` **KEY_END** = ``4194318``
  605. End key.
  606. .. _class_@GlobalScope_constant_KEY_LEFT:
  607. .. rst-class:: classref-enumeration-constant
  608. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LEFT** = ``4194319``
  609. Left arrow key.
  610. .. _class_@GlobalScope_constant_KEY_UP:
  611. .. rst-class:: classref-enumeration-constant
  612. :ref:`Key<enum_@GlobalScope_Key>` **KEY_UP** = ``4194320``
  613. Up arrow key.
  614. .. _class_@GlobalScope_constant_KEY_RIGHT:
  615. .. rst-class:: classref-enumeration-constant
  616. :ref:`Key<enum_@GlobalScope_Key>` **KEY_RIGHT** = ``4194321``
  617. Right arrow key.
  618. .. _class_@GlobalScope_constant_KEY_DOWN:
  619. .. rst-class:: classref-enumeration-constant
  620. :ref:`Key<enum_@GlobalScope_Key>` **KEY_DOWN** = ``4194322``
  621. Down arrow key.
  622. .. _class_@GlobalScope_constant_KEY_PAGEUP:
  623. .. rst-class:: classref-enumeration-constant
  624. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PAGEUP** = ``4194323``
  625. Page Up key.
  626. .. _class_@GlobalScope_constant_KEY_PAGEDOWN:
  627. .. rst-class:: classref-enumeration-constant
  628. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PAGEDOWN** = ``4194324``
  629. Page Down key.
  630. .. _class_@GlobalScope_constant_KEY_SHIFT:
  631. .. rst-class:: classref-enumeration-constant
  632. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SHIFT** = ``4194325``
  633. Shift key.
  634. .. _class_@GlobalScope_constant_KEY_CTRL:
  635. .. rst-class:: classref-enumeration-constant
  636. :ref:`Key<enum_@GlobalScope_Key>` **KEY_CTRL** = ``4194326``
  637. Control key.
  638. .. _class_@GlobalScope_constant_KEY_META:
  639. .. rst-class:: classref-enumeration-constant
  640. :ref:`Key<enum_@GlobalScope_Key>` **KEY_META** = ``4194327``
  641. Meta key.
  642. .. _class_@GlobalScope_constant_KEY_ALT:
  643. .. rst-class:: classref-enumeration-constant
  644. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ALT** = ``4194328``
  645. Alt key.
  646. .. _class_@GlobalScope_constant_KEY_CAPSLOCK:
  647. .. rst-class:: classref-enumeration-constant
  648. :ref:`Key<enum_@GlobalScope_Key>` **KEY_CAPSLOCK** = ``4194329``
  649. Caps Lock key.
  650. .. _class_@GlobalScope_constant_KEY_NUMLOCK:
  651. .. rst-class:: classref-enumeration-constant
  652. :ref:`Key<enum_@GlobalScope_Key>` **KEY_NUMLOCK** = ``4194330``
  653. Num Lock key.
  654. .. _class_@GlobalScope_constant_KEY_SCROLLLOCK:
  655. .. rst-class:: classref-enumeration-constant
  656. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SCROLLLOCK** = ``4194331``
  657. Scroll Lock key.
  658. .. _class_@GlobalScope_constant_KEY_F1:
  659. .. rst-class:: classref-enumeration-constant
  660. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F1** = ``4194332``
  661. F1 key.
  662. .. _class_@GlobalScope_constant_KEY_F2:
  663. .. rst-class:: classref-enumeration-constant
  664. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F2** = ``4194333``
  665. F2 key.
  666. .. _class_@GlobalScope_constant_KEY_F3:
  667. .. rst-class:: classref-enumeration-constant
  668. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F3** = ``4194334``
  669. F3 key.
  670. .. _class_@GlobalScope_constant_KEY_F4:
  671. .. rst-class:: classref-enumeration-constant
  672. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F4** = ``4194335``
  673. F4 key.
  674. .. _class_@GlobalScope_constant_KEY_F5:
  675. .. rst-class:: classref-enumeration-constant
  676. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F5** = ``4194336``
  677. F5 key.
  678. .. _class_@GlobalScope_constant_KEY_F6:
  679. .. rst-class:: classref-enumeration-constant
  680. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F6** = ``4194337``
  681. F6 key.
  682. .. _class_@GlobalScope_constant_KEY_F7:
  683. .. rst-class:: classref-enumeration-constant
  684. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F7** = ``4194338``
  685. F7 key.
  686. .. _class_@GlobalScope_constant_KEY_F8:
  687. .. rst-class:: classref-enumeration-constant
  688. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F8** = ``4194339``
  689. F8 key.
  690. .. _class_@GlobalScope_constant_KEY_F9:
  691. .. rst-class:: classref-enumeration-constant
  692. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F9** = ``4194340``
  693. F9 key.
  694. .. _class_@GlobalScope_constant_KEY_F10:
  695. .. rst-class:: classref-enumeration-constant
  696. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F10** = ``4194341``
  697. F10 key.
  698. .. _class_@GlobalScope_constant_KEY_F11:
  699. .. rst-class:: classref-enumeration-constant
  700. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F11** = ``4194342``
  701. F11 key.
  702. .. _class_@GlobalScope_constant_KEY_F12:
  703. .. rst-class:: classref-enumeration-constant
  704. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F12** = ``4194343``
  705. F12 key.
  706. .. _class_@GlobalScope_constant_KEY_F13:
  707. .. rst-class:: classref-enumeration-constant
  708. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F13** = ``4194344``
  709. F13 key.
  710. .. _class_@GlobalScope_constant_KEY_F14:
  711. .. rst-class:: classref-enumeration-constant
  712. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F14** = ``4194345``
  713. F14 key.
  714. .. _class_@GlobalScope_constant_KEY_F15:
  715. .. rst-class:: classref-enumeration-constant
  716. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F15** = ``4194346``
  717. F15 key.
  718. .. _class_@GlobalScope_constant_KEY_F16:
  719. .. rst-class:: classref-enumeration-constant
  720. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F16** = ``4194347``
  721. F16 key.
  722. .. _class_@GlobalScope_constant_KEY_F17:
  723. .. rst-class:: classref-enumeration-constant
  724. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F17** = ``4194348``
  725. F17 key.
  726. .. _class_@GlobalScope_constant_KEY_F18:
  727. .. rst-class:: classref-enumeration-constant
  728. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F18** = ``4194349``
  729. F18 key.
  730. .. _class_@GlobalScope_constant_KEY_F19:
  731. .. rst-class:: classref-enumeration-constant
  732. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F19** = ``4194350``
  733. F19 key.
  734. .. _class_@GlobalScope_constant_KEY_F20:
  735. .. rst-class:: classref-enumeration-constant
  736. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F20** = ``4194351``
  737. F20 key.
  738. .. _class_@GlobalScope_constant_KEY_F21:
  739. .. rst-class:: classref-enumeration-constant
  740. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F21** = ``4194352``
  741. F21 key.
  742. .. _class_@GlobalScope_constant_KEY_F22:
  743. .. rst-class:: classref-enumeration-constant
  744. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F22** = ``4194353``
  745. F22 key.
  746. .. _class_@GlobalScope_constant_KEY_F23:
  747. .. rst-class:: classref-enumeration-constant
  748. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F23** = ``4194354``
  749. F23 key.
  750. .. _class_@GlobalScope_constant_KEY_F24:
  751. .. rst-class:: classref-enumeration-constant
  752. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F24** = ``4194355``
  753. F24 key.
  754. .. _class_@GlobalScope_constant_KEY_F25:
  755. .. rst-class:: classref-enumeration-constant
  756. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F25** = ``4194356``
  757. F25 key. Only supported on macOS and Linux due to a Windows limitation.
  758. .. _class_@GlobalScope_constant_KEY_F26:
  759. .. rst-class:: classref-enumeration-constant
  760. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F26** = ``4194357``
  761. F26 key. Only supported on macOS and Linux due to a Windows limitation.
  762. .. _class_@GlobalScope_constant_KEY_F27:
  763. .. rst-class:: classref-enumeration-constant
  764. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F27** = ``4194358``
  765. F27 key. Only supported on macOS and Linux due to a Windows limitation.
  766. .. _class_@GlobalScope_constant_KEY_F28:
  767. .. rst-class:: classref-enumeration-constant
  768. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F28** = ``4194359``
  769. F28 key. Only supported on macOS and Linux due to a Windows limitation.
  770. .. _class_@GlobalScope_constant_KEY_F29:
  771. .. rst-class:: classref-enumeration-constant
  772. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F29** = ``4194360``
  773. F29 key. Only supported on macOS and Linux due to a Windows limitation.
  774. .. _class_@GlobalScope_constant_KEY_F30:
  775. .. rst-class:: classref-enumeration-constant
  776. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F30** = ``4194361``
  777. F30 key. Only supported on macOS and Linux due to a Windows limitation.
  778. .. _class_@GlobalScope_constant_KEY_F31:
  779. .. rst-class:: classref-enumeration-constant
  780. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F31** = ``4194362``
  781. F31 key. Only supported on macOS and Linux due to a Windows limitation.
  782. .. _class_@GlobalScope_constant_KEY_F32:
  783. .. rst-class:: classref-enumeration-constant
  784. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F32** = ``4194363``
  785. F32 key. Only supported on macOS and Linux due to a Windows limitation.
  786. .. _class_@GlobalScope_constant_KEY_F33:
  787. .. rst-class:: classref-enumeration-constant
  788. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F33** = ``4194364``
  789. F33 key. Only supported on macOS and Linux due to a Windows limitation.
  790. .. _class_@GlobalScope_constant_KEY_F34:
  791. .. rst-class:: classref-enumeration-constant
  792. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F34** = ``4194365``
  793. F34 key. Only supported on macOS and Linux due to a Windows limitation.
  794. .. _class_@GlobalScope_constant_KEY_F35:
  795. .. rst-class:: classref-enumeration-constant
  796. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F35** = ``4194366``
  797. F35 key. Only supported on macOS and Linux due to a Windows limitation.
  798. .. _class_@GlobalScope_constant_KEY_KP_MULTIPLY:
  799. .. rst-class:: classref-enumeration-constant
  800. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_MULTIPLY** = ``4194433``
  801. Multiply (\*) key on the numeric keypad.
  802. .. _class_@GlobalScope_constant_KEY_KP_DIVIDE:
  803. .. rst-class:: classref-enumeration-constant
  804. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_DIVIDE** = ``4194434``
  805. Divide (/) key on the numeric keypad.
  806. .. _class_@GlobalScope_constant_KEY_KP_SUBTRACT:
  807. .. rst-class:: classref-enumeration-constant
  808. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_SUBTRACT** = ``4194435``
  809. Subtract (-) key on the numeric keypad.
  810. .. _class_@GlobalScope_constant_KEY_KP_PERIOD:
  811. .. rst-class:: classref-enumeration-constant
  812. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_PERIOD** = ``4194436``
  813. Period (.) key on the numeric keypad.
  814. .. _class_@GlobalScope_constant_KEY_KP_ADD:
  815. .. rst-class:: classref-enumeration-constant
  816. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_ADD** = ``4194437``
  817. Add (+) key on the numeric keypad.
  818. .. _class_@GlobalScope_constant_KEY_KP_0:
  819. .. rst-class:: classref-enumeration-constant
  820. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_0** = ``4194438``
  821. Number 0 on the numeric keypad.
  822. .. _class_@GlobalScope_constant_KEY_KP_1:
  823. .. rst-class:: classref-enumeration-constant
  824. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_1** = ``4194439``
  825. Number 1 on the numeric keypad.
  826. .. _class_@GlobalScope_constant_KEY_KP_2:
  827. .. rst-class:: classref-enumeration-constant
  828. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_2** = ``4194440``
  829. Number 2 on the numeric keypad.
  830. .. _class_@GlobalScope_constant_KEY_KP_3:
  831. .. rst-class:: classref-enumeration-constant
  832. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_3** = ``4194441``
  833. Number 3 on the numeric keypad.
  834. .. _class_@GlobalScope_constant_KEY_KP_4:
  835. .. rst-class:: classref-enumeration-constant
  836. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_4** = ``4194442``
  837. Number 4 on the numeric keypad.
  838. .. _class_@GlobalScope_constant_KEY_KP_5:
  839. .. rst-class:: classref-enumeration-constant
  840. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_5** = ``4194443``
  841. Number 5 on the numeric keypad.
  842. .. _class_@GlobalScope_constant_KEY_KP_6:
  843. .. rst-class:: classref-enumeration-constant
  844. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_6** = ``4194444``
  845. Number 6 on the numeric keypad.
  846. .. _class_@GlobalScope_constant_KEY_KP_7:
  847. .. rst-class:: classref-enumeration-constant
  848. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_7** = ``4194445``
  849. Number 7 on the numeric keypad.
  850. .. _class_@GlobalScope_constant_KEY_KP_8:
  851. .. rst-class:: classref-enumeration-constant
  852. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_8** = ``4194446``
  853. Number 8 on the numeric keypad.
  854. .. _class_@GlobalScope_constant_KEY_KP_9:
  855. .. rst-class:: classref-enumeration-constant
  856. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_9** = ``4194447``
  857. Number 9 on the numeric keypad.
  858. .. _class_@GlobalScope_constant_KEY_MENU:
  859. .. rst-class:: classref-enumeration-constant
  860. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MENU** = ``4194370``
  861. Context menu key.
  862. .. _class_@GlobalScope_constant_KEY_HYPER:
  863. .. rst-class:: classref-enumeration-constant
  864. :ref:`Key<enum_@GlobalScope_Key>` **KEY_HYPER** = ``4194371``
  865. Hyper key. (On Linux/X11 only).
  866. .. _class_@GlobalScope_constant_KEY_HELP:
  867. .. rst-class:: classref-enumeration-constant
  868. :ref:`Key<enum_@GlobalScope_Key>` **KEY_HELP** = ``4194373``
  869. Help key.
  870. .. _class_@GlobalScope_constant_KEY_BACK:
  871. .. rst-class:: classref-enumeration-constant
  872. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BACK** = ``4194376``
  873. Media back key. Not to be confused with the Back button on an Android device.
  874. .. _class_@GlobalScope_constant_KEY_FORWARD:
  875. .. rst-class:: classref-enumeration-constant
  876. :ref:`Key<enum_@GlobalScope_Key>` **KEY_FORWARD** = ``4194377``
  877. Media forward key.
  878. .. _class_@GlobalScope_constant_KEY_STOP:
  879. .. rst-class:: classref-enumeration-constant
  880. :ref:`Key<enum_@GlobalScope_Key>` **KEY_STOP** = ``4194378``
  881. Media stop key.
  882. .. _class_@GlobalScope_constant_KEY_REFRESH:
  883. .. rst-class:: classref-enumeration-constant
  884. :ref:`Key<enum_@GlobalScope_Key>` **KEY_REFRESH** = ``4194379``
  885. Media refresh key.
  886. .. _class_@GlobalScope_constant_KEY_VOLUMEDOWN:
  887. .. rst-class:: classref-enumeration-constant
  888. :ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEDOWN** = ``4194380``
  889. Volume down key.
  890. .. _class_@GlobalScope_constant_KEY_VOLUMEMUTE:
  891. .. rst-class:: classref-enumeration-constant
  892. :ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEMUTE** = ``4194381``
  893. Mute volume key.
  894. .. _class_@GlobalScope_constant_KEY_VOLUMEUP:
  895. .. rst-class:: classref-enumeration-constant
  896. :ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEUP** = ``4194382``
  897. Volume up key.
  898. .. _class_@GlobalScope_constant_KEY_MEDIAPLAY:
  899. .. rst-class:: classref-enumeration-constant
  900. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIAPLAY** = ``4194388``
  901. Media play key.
  902. .. _class_@GlobalScope_constant_KEY_MEDIASTOP:
  903. .. rst-class:: classref-enumeration-constant
  904. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIASTOP** = ``4194389``
  905. Media stop key.
  906. .. _class_@GlobalScope_constant_KEY_MEDIAPREVIOUS:
  907. .. rst-class:: classref-enumeration-constant
  908. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIAPREVIOUS** = ``4194390``
  909. Previous song key.
  910. .. _class_@GlobalScope_constant_KEY_MEDIANEXT:
  911. .. rst-class:: classref-enumeration-constant
  912. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIANEXT** = ``4194391``
  913. Next song key.
  914. .. _class_@GlobalScope_constant_KEY_MEDIARECORD:
  915. .. rst-class:: classref-enumeration-constant
  916. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIARECORD** = ``4194392``
  917. Media record key.
  918. .. _class_@GlobalScope_constant_KEY_HOMEPAGE:
  919. .. rst-class:: classref-enumeration-constant
  920. :ref:`Key<enum_@GlobalScope_Key>` **KEY_HOMEPAGE** = ``4194393``
  921. Home page key.
  922. .. _class_@GlobalScope_constant_KEY_FAVORITES:
  923. .. rst-class:: classref-enumeration-constant
  924. :ref:`Key<enum_@GlobalScope_Key>` **KEY_FAVORITES** = ``4194394``
  925. Favorites key.
  926. .. _class_@GlobalScope_constant_KEY_SEARCH:
  927. .. rst-class:: classref-enumeration-constant
  928. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SEARCH** = ``4194395``
  929. Search key.
  930. .. _class_@GlobalScope_constant_KEY_STANDBY:
  931. .. rst-class:: classref-enumeration-constant
  932. :ref:`Key<enum_@GlobalScope_Key>` **KEY_STANDBY** = ``4194396``
  933. Standby key.
  934. .. _class_@GlobalScope_constant_KEY_OPENURL:
  935. .. rst-class:: classref-enumeration-constant
  936. :ref:`Key<enum_@GlobalScope_Key>` **KEY_OPENURL** = ``4194397``
  937. Open URL / Launch Browser key.
  938. .. _class_@GlobalScope_constant_KEY_LAUNCHMAIL:
  939. .. rst-class:: classref-enumeration-constant
  940. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHMAIL** = ``4194398``
  941. Launch Mail key.
  942. .. _class_@GlobalScope_constant_KEY_LAUNCHMEDIA:
  943. .. rst-class:: classref-enumeration-constant
  944. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHMEDIA** = ``4194399``
  945. Launch Media key.
  946. .. _class_@GlobalScope_constant_KEY_LAUNCH0:
  947. .. rst-class:: classref-enumeration-constant
  948. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH0** = ``4194400``
  949. Launch Shortcut 0 key.
  950. .. _class_@GlobalScope_constant_KEY_LAUNCH1:
  951. .. rst-class:: classref-enumeration-constant
  952. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH1** = ``4194401``
  953. Launch Shortcut 1 key.
  954. .. _class_@GlobalScope_constant_KEY_LAUNCH2:
  955. .. rst-class:: classref-enumeration-constant
  956. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH2** = ``4194402``
  957. Launch Shortcut 2 key.
  958. .. _class_@GlobalScope_constant_KEY_LAUNCH3:
  959. .. rst-class:: classref-enumeration-constant
  960. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH3** = ``4194403``
  961. Launch Shortcut 3 key.
  962. .. _class_@GlobalScope_constant_KEY_LAUNCH4:
  963. .. rst-class:: classref-enumeration-constant
  964. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH4** = ``4194404``
  965. Launch Shortcut 4 key.
  966. .. _class_@GlobalScope_constant_KEY_LAUNCH5:
  967. .. rst-class:: classref-enumeration-constant
  968. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH5** = ``4194405``
  969. Launch Shortcut 5 key.
  970. .. _class_@GlobalScope_constant_KEY_LAUNCH6:
  971. .. rst-class:: classref-enumeration-constant
  972. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH6** = ``4194406``
  973. Launch Shortcut 6 key.
  974. .. _class_@GlobalScope_constant_KEY_LAUNCH7:
  975. .. rst-class:: classref-enumeration-constant
  976. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH7** = ``4194407``
  977. Launch Shortcut 7 key.
  978. .. _class_@GlobalScope_constant_KEY_LAUNCH8:
  979. .. rst-class:: classref-enumeration-constant
  980. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH8** = ``4194408``
  981. Launch Shortcut 8 key.
  982. .. _class_@GlobalScope_constant_KEY_LAUNCH9:
  983. .. rst-class:: classref-enumeration-constant
  984. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH9** = ``4194409``
  985. Launch Shortcut 9 key.
  986. .. _class_@GlobalScope_constant_KEY_LAUNCHA:
  987. .. rst-class:: classref-enumeration-constant
  988. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHA** = ``4194410``
  989. Launch Shortcut A key.
  990. .. _class_@GlobalScope_constant_KEY_LAUNCHB:
  991. .. rst-class:: classref-enumeration-constant
  992. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHB** = ``4194411``
  993. Launch Shortcut B key.
  994. .. _class_@GlobalScope_constant_KEY_LAUNCHC:
  995. .. rst-class:: classref-enumeration-constant
  996. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHC** = ``4194412``
  997. Launch Shortcut C key.
  998. .. _class_@GlobalScope_constant_KEY_LAUNCHD:
  999. .. rst-class:: classref-enumeration-constant
  1000. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHD** = ``4194413``
  1001. Launch Shortcut D key.
  1002. .. _class_@GlobalScope_constant_KEY_LAUNCHE:
  1003. .. rst-class:: classref-enumeration-constant
  1004. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHE** = ``4194414``
  1005. Launch Shortcut E key.
  1006. .. _class_@GlobalScope_constant_KEY_LAUNCHF:
  1007. .. rst-class:: classref-enumeration-constant
  1008. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHF** = ``4194415``
  1009. Launch Shortcut F key.
  1010. .. _class_@GlobalScope_constant_KEY_GLOBE:
  1011. .. rst-class:: classref-enumeration-constant
  1012. :ref:`Key<enum_@GlobalScope_Key>` **KEY_GLOBE** = ``4194416``
  1013. "Globe" key on Mac / iPad keyboard.
  1014. .. _class_@GlobalScope_constant_KEY_KEYBOARD:
  1015. .. rst-class:: classref-enumeration-constant
  1016. :ref:`Key<enum_@GlobalScope_Key>` **KEY_KEYBOARD** = ``4194417``
  1017. "On-screen keyboard" key on iPad keyboard.
  1018. .. _class_@GlobalScope_constant_KEY_JIS_EISU:
  1019. .. rst-class:: classref-enumeration-constant
  1020. :ref:`Key<enum_@GlobalScope_Key>` **KEY_JIS_EISU** = ``4194418``
  1021. 英数 key on Mac keyboard.
  1022. .. _class_@GlobalScope_constant_KEY_JIS_KANA:
  1023. .. rst-class:: classref-enumeration-constant
  1024. :ref:`Key<enum_@GlobalScope_Key>` **KEY_JIS_KANA** = ``4194419``
  1025. かな key on Mac keyboard.
  1026. .. _class_@GlobalScope_constant_KEY_UNKNOWN:
  1027. .. rst-class:: classref-enumeration-constant
  1028. :ref:`Key<enum_@GlobalScope_Key>` **KEY_UNKNOWN** = ``8388607``
  1029. Unknown key.
  1030. .. _class_@GlobalScope_constant_KEY_SPACE:
  1031. .. rst-class:: classref-enumeration-constant
  1032. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SPACE** = ``32``
  1033. Space key.
  1034. .. _class_@GlobalScope_constant_KEY_EXCLAM:
  1035. .. rst-class:: classref-enumeration-constant
  1036. :ref:`Key<enum_@GlobalScope_Key>` **KEY_EXCLAM** = ``33``
  1037. ! key.
  1038. .. _class_@GlobalScope_constant_KEY_QUOTEDBL:
  1039. .. rst-class:: classref-enumeration-constant
  1040. :ref:`Key<enum_@GlobalScope_Key>` **KEY_QUOTEDBL** = ``34``
  1041. " key.
  1042. .. _class_@GlobalScope_constant_KEY_NUMBERSIGN:
  1043. .. rst-class:: classref-enumeration-constant
  1044. :ref:`Key<enum_@GlobalScope_Key>` **KEY_NUMBERSIGN** = ``35``
  1045. # key.
  1046. .. _class_@GlobalScope_constant_KEY_DOLLAR:
  1047. .. rst-class:: classref-enumeration-constant
  1048. :ref:`Key<enum_@GlobalScope_Key>` **KEY_DOLLAR** = ``36``
  1049. $ key.
  1050. .. _class_@GlobalScope_constant_KEY_PERCENT:
  1051. .. rst-class:: classref-enumeration-constant
  1052. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PERCENT** = ``37``
  1053. % key.
  1054. .. _class_@GlobalScope_constant_KEY_AMPERSAND:
  1055. .. rst-class:: classref-enumeration-constant
  1056. :ref:`Key<enum_@GlobalScope_Key>` **KEY_AMPERSAND** = ``38``
  1057. & key.
  1058. .. _class_@GlobalScope_constant_KEY_APOSTROPHE:
  1059. .. rst-class:: classref-enumeration-constant
  1060. :ref:`Key<enum_@GlobalScope_Key>` **KEY_APOSTROPHE** = ``39``
  1061. ' key.
  1062. .. _class_@GlobalScope_constant_KEY_PARENLEFT:
  1063. .. rst-class:: classref-enumeration-constant
  1064. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PARENLEFT** = ``40``
  1065. ( key.
  1066. .. _class_@GlobalScope_constant_KEY_PARENRIGHT:
  1067. .. rst-class:: classref-enumeration-constant
  1068. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PARENRIGHT** = ``41``
  1069. ) key.
  1070. .. _class_@GlobalScope_constant_KEY_ASTERISK:
  1071. .. rst-class:: classref-enumeration-constant
  1072. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ASTERISK** = ``42``
  1073. \* key.
  1074. .. _class_@GlobalScope_constant_KEY_PLUS:
  1075. .. rst-class:: classref-enumeration-constant
  1076. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PLUS** = ``43``
  1077. + key.
  1078. .. _class_@GlobalScope_constant_KEY_COMMA:
  1079. .. rst-class:: classref-enumeration-constant
  1080. :ref:`Key<enum_@GlobalScope_Key>` **KEY_COMMA** = ``44``
  1081. , key.
  1082. .. _class_@GlobalScope_constant_KEY_MINUS:
  1083. .. rst-class:: classref-enumeration-constant
  1084. :ref:`Key<enum_@GlobalScope_Key>` **KEY_MINUS** = ``45``
  1085. - key.
  1086. .. _class_@GlobalScope_constant_KEY_PERIOD:
  1087. .. rst-class:: classref-enumeration-constant
  1088. :ref:`Key<enum_@GlobalScope_Key>` **KEY_PERIOD** = ``46``
  1089. . key.
  1090. .. _class_@GlobalScope_constant_KEY_SLASH:
  1091. .. rst-class:: classref-enumeration-constant
  1092. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SLASH** = ``47``
  1093. / key.
  1094. .. _class_@GlobalScope_constant_KEY_0:
  1095. .. rst-class:: classref-enumeration-constant
  1096. :ref:`Key<enum_@GlobalScope_Key>` **KEY_0** = ``48``
  1097. Number 0 key.
  1098. .. _class_@GlobalScope_constant_KEY_1:
  1099. .. rst-class:: classref-enumeration-constant
  1100. :ref:`Key<enum_@GlobalScope_Key>` **KEY_1** = ``49``
  1101. Number 1 key.
  1102. .. _class_@GlobalScope_constant_KEY_2:
  1103. .. rst-class:: classref-enumeration-constant
  1104. :ref:`Key<enum_@GlobalScope_Key>` **KEY_2** = ``50``
  1105. Number 2 key.
  1106. .. _class_@GlobalScope_constant_KEY_3:
  1107. .. rst-class:: classref-enumeration-constant
  1108. :ref:`Key<enum_@GlobalScope_Key>` **KEY_3** = ``51``
  1109. Number 3 key.
  1110. .. _class_@GlobalScope_constant_KEY_4:
  1111. .. rst-class:: classref-enumeration-constant
  1112. :ref:`Key<enum_@GlobalScope_Key>` **KEY_4** = ``52``
  1113. Number 4 key.
  1114. .. _class_@GlobalScope_constant_KEY_5:
  1115. .. rst-class:: classref-enumeration-constant
  1116. :ref:`Key<enum_@GlobalScope_Key>` **KEY_5** = ``53``
  1117. Number 5 key.
  1118. .. _class_@GlobalScope_constant_KEY_6:
  1119. .. rst-class:: classref-enumeration-constant
  1120. :ref:`Key<enum_@GlobalScope_Key>` **KEY_6** = ``54``
  1121. Number 6 key.
  1122. .. _class_@GlobalScope_constant_KEY_7:
  1123. .. rst-class:: classref-enumeration-constant
  1124. :ref:`Key<enum_@GlobalScope_Key>` **KEY_7** = ``55``
  1125. Number 7 key.
  1126. .. _class_@GlobalScope_constant_KEY_8:
  1127. .. rst-class:: classref-enumeration-constant
  1128. :ref:`Key<enum_@GlobalScope_Key>` **KEY_8** = ``56``
  1129. Number 8 key.
  1130. .. _class_@GlobalScope_constant_KEY_9:
  1131. .. rst-class:: classref-enumeration-constant
  1132. :ref:`Key<enum_@GlobalScope_Key>` **KEY_9** = ``57``
  1133. Number 9 key.
  1134. .. _class_@GlobalScope_constant_KEY_COLON:
  1135. .. rst-class:: classref-enumeration-constant
  1136. :ref:`Key<enum_@GlobalScope_Key>` **KEY_COLON** = ``58``
  1137. : key.
  1138. .. _class_@GlobalScope_constant_KEY_SEMICOLON:
  1139. .. rst-class:: classref-enumeration-constant
  1140. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SEMICOLON** = ``59``
  1141. ; key.
  1142. .. _class_@GlobalScope_constant_KEY_LESS:
  1143. .. rst-class:: classref-enumeration-constant
  1144. :ref:`Key<enum_@GlobalScope_Key>` **KEY_LESS** = ``60``
  1145. < key.
  1146. .. _class_@GlobalScope_constant_KEY_EQUAL:
  1147. .. rst-class:: classref-enumeration-constant
  1148. :ref:`Key<enum_@GlobalScope_Key>` **KEY_EQUAL** = ``61``
  1149. = key.
  1150. .. _class_@GlobalScope_constant_KEY_GREATER:
  1151. .. rst-class:: classref-enumeration-constant
  1152. :ref:`Key<enum_@GlobalScope_Key>` **KEY_GREATER** = ``62``
  1153. > key.
  1154. .. _class_@GlobalScope_constant_KEY_QUESTION:
  1155. .. rst-class:: classref-enumeration-constant
  1156. :ref:`Key<enum_@GlobalScope_Key>` **KEY_QUESTION** = ``63``
  1157. ? key.
  1158. .. _class_@GlobalScope_constant_KEY_AT:
  1159. .. rst-class:: classref-enumeration-constant
  1160. :ref:`Key<enum_@GlobalScope_Key>` **KEY_AT** = ``64``
  1161. @ key.
  1162. .. _class_@GlobalScope_constant_KEY_A:
  1163. .. rst-class:: classref-enumeration-constant
  1164. :ref:`Key<enum_@GlobalScope_Key>` **KEY_A** = ``65``
  1165. A key.
  1166. .. _class_@GlobalScope_constant_KEY_B:
  1167. .. rst-class:: classref-enumeration-constant
  1168. :ref:`Key<enum_@GlobalScope_Key>` **KEY_B** = ``66``
  1169. B key.
  1170. .. _class_@GlobalScope_constant_KEY_C:
  1171. .. rst-class:: classref-enumeration-constant
  1172. :ref:`Key<enum_@GlobalScope_Key>` **KEY_C** = ``67``
  1173. C key.
  1174. .. _class_@GlobalScope_constant_KEY_D:
  1175. .. rst-class:: classref-enumeration-constant
  1176. :ref:`Key<enum_@GlobalScope_Key>` **KEY_D** = ``68``
  1177. D key.
  1178. .. _class_@GlobalScope_constant_KEY_E:
  1179. .. rst-class:: classref-enumeration-constant
  1180. :ref:`Key<enum_@GlobalScope_Key>` **KEY_E** = ``69``
  1181. E key.
  1182. .. _class_@GlobalScope_constant_KEY_F:
  1183. .. rst-class:: classref-enumeration-constant
  1184. :ref:`Key<enum_@GlobalScope_Key>` **KEY_F** = ``70``
  1185. F key.
  1186. .. _class_@GlobalScope_constant_KEY_G:
  1187. .. rst-class:: classref-enumeration-constant
  1188. :ref:`Key<enum_@GlobalScope_Key>` **KEY_G** = ``71``
  1189. G key.
  1190. .. _class_@GlobalScope_constant_KEY_H:
  1191. .. rst-class:: classref-enumeration-constant
  1192. :ref:`Key<enum_@GlobalScope_Key>` **KEY_H** = ``72``
  1193. H key.
  1194. .. _class_@GlobalScope_constant_KEY_I:
  1195. .. rst-class:: classref-enumeration-constant
  1196. :ref:`Key<enum_@GlobalScope_Key>` **KEY_I** = ``73``
  1197. I key.
  1198. .. _class_@GlobalScope_constant_KEY_J:
  1199. .. rst-class:: classref-enumeration-constant
  1200. :ref:`Key<enum_@GlobalScope_Key>` **KEY_J** = ``74``
  1201. J key.
  1202. .. _class_@GlobalScope_constant_KEY_K:
  1203. .. rst-class:: classref-enumeration-constant
  1204. :ref:`Key<enum_@GlobalScope_Key>` **KEY_K** = ``75``
  1205. K key.
  1206. .. _class_@GlobalScope_constant_KEY_L:
  1207. .. rst-class:: classref-enumeration-constant
  1208. :ref:`Key<enum_@GlobalScope_Key>` **KEY_L** = ``76``
  1209. L key.
  1210. .. _class_@GlobalScope_constant_KEY_M:
  1211. .. rst-class:: classref-enumeration-constant
  1212. :ref:`Key<enum_@GlobalScope_Key>` **KEY_M** = ``77``
  1213. M key.
  1214. .. _class_@GlobalScope_constant_KEY_N:
  1215. .. rst-class:: classref-enumeration-constant
  1216. :ref:`Key<enum_@GlobalScope_Key>` **KEY_N** = ``78``
  1217. N key.
  1218. .. _class_@GlobalScope_constant_KEY_O:
  1219. .. rst-class:: classref-enumeration-constant
  1220. :ref:`Key<enum_@GlobalScope_Key>` **KEY_O** = ``79``
  1221. O key.
  1222. .. _class_@GlobalScope_constant_KEY_P:
  1223. .. rst-class:: classref-enumeration-constant
  1224. :ref:`Key<enum_@GlobalScope_Key>` **KEY_P** = ``80``
  1225. P key.
  1226. .. _class_@GlobalScope_constant_KEY_Q:
  1227. .. rst-class:: classref-enumeration-constant
  1228. :ref:`Key<enum_@GlobalScope_Key>` **KEY_Q** = ``81``
  1229. Q key.
  1230. .. _class_@GlobalScope_constant_KEY_R:
  1231. .. rst-class:: classref-enumeration-constant
  1232. :ref:`Key<enum_@GlobalScope_Key>` **KEY_R** = ``82``
  1233. R key.
  1234. .. _class_@GlobalScope_constant_KEY_S:
  1235. .. rst-class:: classref-enumeration-constant
  1236. :ref:`Key<enum_@GlobalScope_Key>` **KEY_S** = ``83``
  1237. S key.
  1238. .. _class_@GlobalScope_constant_KEY_T:
  1239. .. rst-class:: classref-enumeration-constant
  1240. :ref:`Key<enum_@GlobalScope_Key>` **KEY_T** = ``84``
  1241. T key.
  1242. .. _class_@GlobalScope_constant_KEY_U:
  1243. .. rst-class:: classref-enumeration-constant
  1244. :ref:`Key<enum_@GlobalScope_Key>` **KEY_U** = ``85``
  1245. U key.
  1246. .. _class_@GlobalScope_constant_KEY_V:
  1247. .. rst-class:: classref-enumeration-constant
  1248. :ref:`Key<enum_@GlobalScope_Key>` **KEY_V** = ``86``
  1249. V key.
  1250. .. _class_@GlobalScope_constant_KEY_W:
  1251. .. rst-class:: classref-enumeration-constant
  1252. :ref:`Key<enum_@GlobalScope_Key>` **KEY_W** = ``87``
  1253. W key.
  1254. .. _class_@GlobalScope_constant_KEY_X:
  1255. .. rst-class:: classref-enumeration-constant
  1256. :ref:`Key<enum_@GlobalScope_Key>` **KEY_X** = ``88``
  1257. X key.
  1258. .. _class_@GlobalScope_constant_KEY_Y:
  1259. .. rst-class:: classref-enumeration-constant
  1260. :ref:`Key<enum_@GlobalScope_Key>` **KEY_Y** = ``89``
  1261. Y key.
  1262. .. _class_@GlobalScope_constant_KEY_Z:
  1263. .. rst-class:: classref-enumeration-constant
  1264. :ref:`Key<enum_@GlobalScope_Key>` **KEY_Z** = ``90``
  1265. Z key.
  1266. .. _class_@GlobalScope_constant_KEY_BRACKETLEFT:
  1267. .. rst-class:: classref-enumeration-constant
  1268. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACKETLEFT** = ``91``
  1269. [ key.
  1270. .. _class_@GlobalScope_constant_KEY_BACKSLASH:
  1271. .. rst-class:: classref-enumeration-constant
  1272. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKSLASH** = ``92``
  1273. \\ key.
  1274. .. _class_@GlobalScope_constant_KEY_BRACKETRIGHT:
  1275. .. rst-class:: classref-enumeration-constant
  1276. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACKETRIGHT** = ``93``
  1277. ] key.
  1278. .. _class_@GlobalScope_constant_KEY_ASCIICIRCUM:
  1279. .. rst-class:: classref-enumeration-constant
  1280. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ASCIICIRCUM** = ``94``
  1281. ^ key.
  1282. .. _class_@GlobalScope_constant_KEY_UNDERSCORE:
  1283. .. rst-class:: classref-enumeration-constant
  1284. :ref:`Key<enum_@GlobalScope_Key>` **KEY_UNDERSCORE** = ``95``
  1285. \_ key.
  1286. .. _class_@GlobalScope_constant_KEY_QUOTELEFT:
  1287. .. rst-class:: classref-enumeration-constant
  1288. :ref:`Key<enum_@GlobalScope_Key>` **KEY_QUOTELEFT** = ``96``
  1289. ` key.
  1290. .. _class_@GlobalScope_constant_KEY_BRACELEFT:
  1291. .. rst-class:: classref-enumeration-constant
  1292. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACELEFT** = ``123``
  1293. { key.
  1294. .. _class_@GlobalScope_constant_KEY_BAR:
  1295. .. rst-class:: classref-enumeration-constant
  1296. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BAR** = ``124``
  1297. | key.
  1298. .. _class_@GlobalScope_constant_KEY_BRACERIGHT:
  1299. .. rst-class:: classref-enumeration-constant
  1300. :ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACERIGHT** = ``125``
  1301. } key.
  1302. .. _class_@GlobalScope_constant_KEY_ASCIITILDE:
  1303. .. rst-class:: classref-enumeration-constant
  1304. :ref:`Key<enum_@GlobalScope_Key>` **KEY_ASCIITILDE** = ``126``
  1305. ~ key.
  1306. .. _class_@GlobalScope_constant_KEY_YEN:
  1307. .. rst-class:: classref-enumeration-constant
  1308. :ref:`Key<enum_@GlobalScope_Key>` **KEY_YEN** = ``165``
  1309. ¥ key.
  1310. .. _class_@GlobalScope_constant_KEY_SECTION:
  1311. .. rst-class:: classref-enumeration-constant
  1312. :ref:`Key<enum_@GlobalScope_Key>` **KEY_SECTION** = ``167``
  1313. § key.
  1314. .. rst-class:: classref-item-separator
  1315. ----
  1316. .. _enum_@GlobalScope_KeyModifierMask:
  1317. .. rst-class:: classref-enumeration
  1318. flags **KeyModifierMask**:
  1319. .. _class_@GlobalScope_constant_KEY_CODE_MASK:
  1320. .. rst-class:: classref-enumeration-constant
  1321. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_CODE_MASK** = ``8388607``
  1322. Key Code mask.
  1323. .. _class_@GlobalScope_constant_KEY_MODIFIER_MASK:
  1324. .. rst-class:: classref-enumeration-constant
  1325. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MODIFIER_MASK** = ``532676608``
  1326. Modifier key mask.
  1327. .. _class_@GlobalScope_constant_KEY_MASK_CMD_OR_CTRL:
  1328. .. rst-class:: classref-enumeration-constant
  1329. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_CMD_OR_CTRL** = ``16777216``
  1330. 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.
  1331. .. _class_@GlobalScope_constant_KEY_MASK_SHIFT:
  1332. .. rst-class:: classref-enumeration-constant
  1333. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_SHIFT** = ``33554432``
  1334. Shift key mask.
  1335. .. _class_@GlobalScope_constant_KEY_MASK_ALT:
  1336. .. rst-class:: classref-enumeration-constant
  1337. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_ALT** = ``67108864``
  1338. Alt or Option (on macOS) key mask.
  1339. .. _class_@GlobalScope_constant_KEY_MASK_META:
  1340. .. rst-class:: classref-enumeration-constant
  1341. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_META** = ``134217728``
  1342. Command (on macOS) or Meta/Windows key mask.
  1343. .. _class_@GlobalScope_constant_KEY_MASK_CTRL:
  1344. .. rst-class:: classref-enumeration-constant
  1345. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_CTRL** = ``268435456``
  1346. Control key mask.
  1347. .. _class_@GlobalScope_constant_KEY_MASK_KPAD:
  1348. .. rst-class:: classref-enumeration-constant
  1349. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_KPAD** = ``536870912``
  1350. Keypad key mask.
  1351. .. _class_@GlobalScope_constant_KEY_MASK_GROUP_SWITCH:
  1352. .. rst-class:: classref-enumeration-constant
  1353. :ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_GROUP_SWITCH** = ``1073741824``
  1354. Group Switch key mask.
  1355. .. rst-class:: classref-item-separator
  1356. ----
  1357. .. _enum_@GlobalScope_KeyLocation:
  1358. .. rst-class:: classref-enumeration
  1359. enum **KeyLocation**:
  1360. .. _class_@GlobalScope_constant_KEY_LOCATION_UNSPECIFIED:
  1361. .. rst-class:: classref-enumeration-constant
  1362. :ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_UNSPECIFIED** = ``0``
  1363. Used for keys which only appear once, or when a comparison doesn't need to differentiate the ``LEFT`` and ``RIGHT`` versions.
  1364. 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.
  1365. .. _class_@GlobalScope_constant_KEY_LOCATION_LEFT:
  1366. .. rst-class:: classref-enumeration-constant
  1367. :ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_LEFT** = ``1``
  1368. A key which is to the left of its twin.
  1369. .. _class_@GlobalScope_constant_KEY_LOCATION_RIGHT:
  1370. .. rst-class:: classref-enumeration-constant
  1371. :ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_RIGHT** = ``2``
  1372. A key which is to the right of its twin.
  1373. .. rst-class:: classref-item-separator
  1374. ----
  1375. .. _enum_@GlobalScope_MouseButton:
  1376. .. rst-class:: classref-enumeration
  1377. enum **MouseButton**:
  1378. .. _class_@GlobalScope_constant_MOUSE_BUTTON_NONE:
  1379. .. rst-class:: classref-enumeration-constant
  1380. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_NONE** = ``0``
  1381. 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.
  1382. .. _class_@GlobalScope_constant_MOUSE_BUTTON_LEFT:
  1383. .. rst-class:: classref-enumeration-constant
  1384. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_LEFT** = ``1``
  1385. Primary mouse button, usually assigned to the left button.
  1386. .. _class_@GlobalScope_constant_MOUSE_BUTTON_RIGHT:
  1387. .. rst-class:: classref-enumeration-constant
  1388. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_RIGHT** = ``2``
  1389. Secondary mouse button, usually assigned to the right button.
  1390. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MIDDLE:
  1391. .. rst-class:: classref-enumeration-constant
  1392. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_MIDDLE** = ``3``
  1393. Middle mouse button.
  1394. .. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_UP:
  1395. .. rst-class:: classref-enumeration-constant
  1396. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_UP** = ``4``
  1397. Mouse wheel scrolling up.
  1398. .. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_DOWN:
  1399. .. rst-class:: classref-enumeration-constant
  1400. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_DOWN** = ``5``
  1401. Mouse wheel scrolling down.
  1402. .. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_LEFT:
  1403. .. rst-class:: classref-enumeration-constant
  1404. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_LEFT** = ``6``
  1405. Mouse wheel left button (only present on some mice).
  1406. .. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_RIGHT:
  1407. .. rst-class:: classref-enumeration-constant
  1408. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_RIGHT** = ``7``
  1409. Mouse wheel right button (only present on some mice).
  1410. .. _class_@GlobalScope_constant_MOUSE_BUTTON_XBUTTON1:
  1411. .. rst-class:: classref-enumeration-constant
  1412. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_XBUTTON1** = ``8``
  1413. Extra mouse button 1. This is sometimes present, usually to the sides of the mouse.
  1414. .. _class_@GlobalScope_constant_MOUSE_BUTTON_XBUTTON2:
  1415. .. rst-class:: classref-enumeration-constant
  1416. :ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_XBUTTON2** = ``9``
  1417. Extra mouse button 2. This is sometimes present, usually to the sides of the mouse.
  1418. .. rst-class:: classref-item-separator
  1419. ----
  1420. .. _enum_@GlobalScope_MouseButtonMask:
  1421. .. rst-class:: classref-enumeration
  1422. flags **MouseButtonMask**:
  1423. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_LEFT:
  1424. .. rst-class:: classref-enumeration-constant
  1425. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_LEFT** = ``1``
  1426. Primary mouse button mask, usually for the left button.
  1427. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_RIGHT:
  1428. .. rst-class:: classref-enumeration-constant
  1429. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_RIGHT** = ``2``
  1430. Secondary mouse button mask, usually for the right button.
  1431. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MIDDLE:
  1432. .. rst-class:: classref-enumeration-constant
  1433. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MIDDLE** = ``4``
  1434. Middle mouse button mask.
  1435. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MB_XBUTTON1:
  1436. .. rst-class:: classref-enumeration-constant
  1437. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MB_XBUTTON1** = ``128``
  1438. Extra mouse button 1 mask.
  1439. .. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MB_XBUTTON2:
  1440. .. rst-class:: classref-enumeration-constant
  1441. :ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MB_XBUTTON2** = ``256``
  1442. Extra mouse button 2 mask.
  1443. .. rst-class:: classref-item-separator
  1444. ----
  1445. .. _enum_@GlobalScope_JoyButton:
  1446. .. rst-class:: classref-enumeration
  1447. enum **JoyButton**:
  1448. .. _class_@GlobalScope_constant_JOY_BUTTON_INVALID:
  1449. .. rst-class:: classref-enumeration-constant
  1450. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_INVALID** = ``-1``
  1451. An invalid game controller button.
  1452. .. _class_@GlobalScope_constant_JOY_BUTTON_A:
  1453. .. rst-class:: classref-enumeration-constant
  1454. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_A** = ``0``
  1455. Game controller SDL button A. Corresponds to the bottom action button: Sony Cross, Xbox A, Nintendo B.
  1456. .. _class_@GlobalScope_constant_JOY_BUTTON_B:
  1457. .. rst-class:: classref-enumeration-constant
  1458. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_B** = ``1``
  1459. Game controller SDL button B. Corresponds to the right action button: Sony Circle, Xbox B, Nintendo A.
  1460. .. _class_@GlobalScope_constant_JOY_BUTTON_X:
  1461. .. rst-class:: classref-enumeration-constant
  1462. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_X** = ``2``
  1463. Game controller SDL button X. Corresponds to the left action button: Sony Square, Xbox X, Nintendo Y.
  1464. .. _class_@GlobalScope_constant_JOY_BUTTON_Y:
  1465. .. rst-class:: classref-enumeration-constant
  1466. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_Y** = ``3``
  1467. Game controller SDL button Y. Corresponds to the top action button: Sony Triangle, Xbox Y, Nintendo X.
  1468. .. _class_@GlobalScope_constant_JOY_BUTTON_BACK:
  1469. .. rst-class:: classref-enumeration-constant
  1470. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_BACK** = ``4``
  1471. Game controller SDL back button. Corresponds to the Sony Select, Xbox Back, Nintendo - button.
  1472. .. _class_@GlobalScope_constant_JOY_BUTTON_GUIDE:
  1473. .. rst-class:: classref-enumeration-constant
  1474. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_GUIDE** = ``5``
  1475. Game controller SDL guide button. Corresponds to the Sony PS, Xbox Home button.
  1476. .. _class_@GlobalScope_constant_JOY_BUTTON_START:
  1477. .. rst-class:: classref-enumeration-constant
  1478. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_START** = ``6``
  1479. Game controller SDL start button. Corresponds to the Sony Options, Xbox Menu, Nintendo + button.
  1480. .. _class_@GlobalScope_constant_JOY_BUTTON_LEFT_STICK:
  1481. .. rst-class:: classref-enumeration-constant
  1482. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_LEFT_STICK** = ``7``
  1483. Game controller SDL left stick button. Corresponds to the Sony L3, Xbox L/LS button.
  1484. .. _class_@GlobalScope_constant_JOY_BUTTON_RIGHT_STICK:
  1485. .. rst-class:: classref-enumeration-constant
  1486. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_RIGHT_STICK** = ``8``
  1487. Game controller SDL right stick button. Corresponds to the Sony R3, Xbox R/RS button.
  1488. .. _class_@GlobalScope_constant_JOY_BUTTON_LEFT_SHOULDER:
  1489. .. rst-class:: classref-enumeration-constant
  1490. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_LEFT_SHOULDER** = ``9``
  1491. Game controller SDL left shoulder button. Corresponds to the Sony L1, Xbox LB button.
  1492. .. _class_@GlobalScope_constant_JOY_BUTTON_RIGHT_SHOULDER:
  1493. .. rst-class:: classref-enumeration-constant
  1494. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_RIGHT_SHOULDER** = ``10``
  1495. Game controller SDL right shoulder button. Corresponds to the Sony R1, Xbox RB button.
  1496. .. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_UP:
  1497. .. rst-class:: classref-enumeration-constant
  1498. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_UP** = ``11``
  1499. Game controller D-pad up button.
  1500. .. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_DOWN:
  1501. .. rst-class:: classref-enumeration-constant
  1502. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_DOWN** = ``12``
  1503. Game controller D-pad down button.
  1504. .. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_LEFT:
  1505. .. rst-class:: classref-enumeration-constant
  1506. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_LEFT** = ``13``
  1507. Game controller D-pad left button.
  1508. .. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_RIGHT:
  1509. .. rst-class:: classref-enumeration-constant
  1510. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_RIGHT** = ``14``
  1511. Game controller D-pad right button.
  1512. .. _class_@GlobalScope_constant_JOY_BUTTON_MISC1:
  1513. .. rst-class:: classref-enumeration-constant
  1514. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_MISC1** = ``15``
  1515. Game controller SDL miscellaneous button. Corresponds to Xbox share button, PS5 microphone button, Nintendo Switch capture button.
  1516. .. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE1:
  1517. .. rst-class:: classref-enumeration-constant
  1518. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE1** = ``16``
  1519. Game controller SDL paddle 1 button.
  1520. .. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE2:
  1521. .. rst-class:: classref-enumeration-constant
  1522. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE2** = ``17``
  1523. Game controller SDL paddle 2 button.
  1524. .. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE3:
  1525. .. rst-class:: classref-enumeration-constant
  1526. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE3** = ``18``
  1527. Game controller SDL paddle 3 button.
  1528. .. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE4:
  1529. .. rst-class:: classref-enumeration-constant
  1530. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE4** = ``19``
  1531. Game controller SDL paddle 4 button.
  1532. .. _class_@GlobalScope_constant_JOY_BUTTON_TOUCHPAD:
  1533. .. rst-class:: classref-enumeration-constant
  1534. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_TOUCHPAD** = ``20``
  1535. Game controller SDL touchpad button.
  1536. .. _class_@GlobalScope_constant_JOY_BUTTON_SDL_MAX:
  1537. .. rst-class:: classref-enumeration-constant
  1538. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_SDL_MAX** = ``21``
  1539. The number of SDL game controller buttons.
  1540. .. _class_@GlobalScope_constant_JOY_BUTTON_MAX:
  1541. .. rst-class:: classref-enumeration-constant
  1542. :ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_MAX** = ``128``
  1543. The maximum number of game controller buttons supported by the engine. The actual limit may be lower on specific platforms:
  1544. - **Android:** Up to 36 buttons.
  1545. - **Linux:** Up to 80 buttons.
  1546. - **Windows** and **macOS:** Up to 128 buttons.
  1547. .. rst-class:: classref-item-separator
  1548. ----
  1549. .. _enum_@GlobalScope_JoyAxis:
  1550. .. rst-class:: classref-enumeration
  1551. enum **JoyAxis**:
  1552. .. _class_@GlobalScope_constant_JOY_AXIS_INVALID:
  1553. .. rst-class:: classref-enumeration-constant
  1554. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_INVALID** = ``-1``
  1555. An invalid game controller axis.
  1556. .. _class_@GlobalScope_constant_JOY_AXIS_LEFT_X:
  1557. .. rst-class:: classref-enumeration-constant
  1558. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_LEFT_X** = ``0``
  1559. Game controller left joystick x-axis.
  1560. .. _class_@GlobalScope_constant_JOY_AXIS_LEFT_Y:
  1561. .. rst-class:: classref-enumeration-constant
  1562. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_LEFT_Y** = ``1``
  1563. Game controller left joystick y-axis.
  1564. .. _class_@GlobalScope_constant_JOY_AXIS_RIGHT_X:
  1565. .. rst-class:: classref-enumeration-constant
  1566. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_RIGHT_X** = ``2``
  1567. Game controller right joystick x-axis.
  1568. .. _class_@GlobalScope_constant_JOY_AXIS_RIGHT_Y:
  1569. .. rst-class:: classref-enumeration-constant
  1570. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_RIGHT_Y** = ``3``
  1571. Game controller right joystick y-axis.
  1572. .. _class_@GlobalScope_constant_JOY_AXIS_TRIGGER_LEFT:
  1573. .. rst-class:: classref-enumeration-constant
  1574. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_TRIGGER_LEFT** = ``4``
  1575. Game controller left trigger axis.
  1576. .. _class_@GlobalScope_constant_JOY_AXIS_TRIGGER_RIGHT:
  1577. .. rst-class:: classref-enumeration-constant
  1578. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_TRIGGER_RIGHT** = ``5``
  1579. Game controller right trigger axis.
  1580. .. _class_@GlobalScope_constant_JOY_AXIS_SDL_MAX:
  1581. .. rst-class:: classref-enumeration-constant
  1582. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_SDL_MAX** = ``6``
  1583. The number of SDL game controller axes.
  1584. .. _class_@GlobalScope_constant_JOY_AXIS_MAX:
  1585. .. rst-class:: classref-enumeration-constant
  1586. :ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_MAX** = ``10``
  1587. The maximum number of game controller axes: OpenVR supports up to 5 Joysticks making a total of 10 axes.
  1588. .. rst-class:: classref-item-separator
  1589. ----
  1590. .. _enum_@GlobalScope_MIDIMessage:
  1591. .. rst-class:: classref-enumeration
  1592. enum **MIDIMessage**:
  1593. .. _class_@GlobalScope_constant_MIDI_MESSAGE_NONE:
  1594. .. rst-class:: classref-enumeration-constant
  1595. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NONE** = ``0``
  1596. Does not correspond to any MIDI message. This is the default value of :ref:`InputEventMIDI.message<class_InputEventMIDI_property_message>`.
  1597. .. _class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_OFF:
  1598. .. rst-class:: classref-enumeration-constant
  1599. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NOTE_OFF** = ``8``
  1600. MIDI message sent when a note is released.
  1601. \ **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``.
  1602. .. _class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_ON:
  1603. .. rst-class:: classref-enumeration-constant
  1604. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NOTE_ON** = ``9``
  1605. MIDI message sent when a note is pressed.
  1606. .. _class_@GlobalScope_constant_MIDI_MESSAGE_AFTERTOUCH:
  1607. .. rst-class:: classref-enumeration-constant
  1608. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_AFTERTOUCH** = ``10``
  1609. MIDI message sent to indicate a change in pressure while a note is being pressed down, also called aftertouch.
  1610. .. _class_@GlobalScope_constant_MIDI_MESSAGE_CONTROL_CHANGE:
  1611. .. rst-class:: classref-enumeration-constant
  1612. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CONTROL_CHANGE** = ``11``
  1613. 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.
  1614. .. _class_@GlobalScope_constant_MIDI_MESSAGE_PROGRAM_CHANGE:
  1615. .. rst-class:: classref-enumeration-constant
  1616. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_PROGRAM_CHANGE** = ``12``
  1617. MIDI message sent when the MIDI device changes its current instrument (also called *program* or *preset*).
  1618. .. _class_@GlobalScope_constant_MIDI_MESSAGE_CHANNEL_PRESSURE:
  1619. .. rst-class:: classref-enumeration-constant
  1620. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CHANNEL_PRESSURE** = ``13``
  1621. 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>`.
  1622. .. _class_@GlobalScope_constant_MIDI_MESSAGE_PITCH_BEND:
  1623. .. rst-class:: classref-enumeration-constant
  1624. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_PITCH_BEND** = ``14``
  1625. MIDI message sent when the value of the pitch bender changes, usually a wheel on the MIDI device.
  1626. .. _class_@GlobalScope_constant_MIDI_MESSAGE_SYSTEM_EXCLUSIVE:
  1627. .. rst-class:: classref-enumeration-constant
  1628. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SYSTEM_EXCLUSIVE** = ``240``
  1629. MIDI system exclusive (SysEx) message. This type of message is not standardized and it's highly dependent on the MIDI device sending it.
  1630. \ **Note:** Getting this message's data from :ref:`InputEventMIDI<class_InputEventMIDI>` is not implemented.
  1631. .. _class_@GlobalScope_constant_MIDI_MESSAGE_QUARTER_FRAME:
  1632. .. rst-class:: classref-enumeration-constant
  1633. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_QUARTER_FRAME** = ``241``
  1634. 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>`.
  1635. \ **Note:** Getting this message's data from :ref:`InputEventMIDI<class_InputEventMIDI>` is not implemented.
  1636. .. _class_@GlobalScope_constant_MIDI_MESSAGE_SONG_POSITION_POINTER:
  1637. .. rst-class:: classref-enumeration-constant
  1638. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SONG_POSITION_POINTER** = ``242``
  1639. MIDI message sent to jump onto a new position in the current sequence or song.
  1640. \ **Note:** Getting this message's data from :ref:`InputEventMIDI<class_InputEventMIDI>` is not implemented.
  1641. .. _class_@GlobalScope_constant_MIDI_MESSAGE_SONG_SELECT:
  1642. .. rst-class:: classref-enumeration-constant
  1643. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SONG_SELECT** = ``243``
  1644. MIDI message sent to select a sequence or song to play.
  1645. \ **Note:** Getting this message's data from :ref:`InputEventMIDI<class_InputEventMIDI>` is not implemented.
  1646. .. _class_@GlobalScope_constant_MIDI_MESSAGE_TUNE_REQUEST:
  1647. .. rst-class:: classref-enumeration-constant
  1648. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_TUNE_REQUEST** = ``246``
  1649. MIDI message sent to request a tuning calibration. Used on analog synthesizers. Most modern MIDI devices do not need this message.
  1650. .. _class_@GlobalScope_constant_MIDI_MESSAGE_TIMING_CLOCK:
  1651. .. rst-class:: classref-enumeration-constant
  1652. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_TIMING_CLOCK** = ``248``
  1653. MIDI message sent 24 times after :ref:`MIDI_MESSAGE_QUARTER_FRAME<class_@GlobalScope_constant_MIDI_MESSAGE_QUARTER_FRAME>`, to keep connected MIDI devices synchronized.
  1654. .. _class_@GlobalScope_constant_MIDI_MESSAGE_START:
  1655. .. rst-class:: classref-enumeration-constant
  1656. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_START** = ``250``
  1657. MIDI message sent to start the current sequence or song from the beginning.
  1658. .. _class_@GlobalScope_constant_MIDI_MESSAGE_CONTINUE:
  1659. .. rst-class:: classref-enumeration-constant
  1660. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CONTINUE** = ``251``
  1661. MIDI message sent to resume from the point the current sequence or song was paused.
  1662. .. _class_@GlobalScope_constant_MIDI_MESSAGE_STOP:
  1663. .. rst-class:: classref-enumeration-constant
  1664. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_STOP** = ``252``
  1665. MIDI message sent to pause the current sequence or song.
  1666. .. _class_@GlobalScope_constant_MIDI_MESSAGE_ACTIVE_SENSING:
  1667. .. rst-class:: classref-enumeration-constant
  1668. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_ACTIVE_SENSING** = ``254``
  1669. 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.
  1670. .. _class_@GlobalScope_constant_MIDI_MESSAGE_SYSTEM_RESET:
  1671. .. rst-class:: classref-enumeration-constant
  1672. :ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SYSTEM_RESET** = ``255``
  1673. 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.
  1674. .. rst-class:: classref-item-separator
  1675. ----
  1676. .. _enum_@GlobalScope_Error:
  1677. .. rst-class:: classref-enumeration
  1678. enum **Error**:
  1679. .. _class_@GlobalScope_constant_OK:
  1680. .. rst-class:: classref-enumeration-constant
  1681. :ref:`Error<enum_@GlobalScope_Error>` **OK** = ``0``
  1682. Methods that return :ref:`Error<enum_@GlobalScope_Error>` return :ref:`OK<class_@GlobalScope_constant_OK>` when no error occurred.
  1683. 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.
  1684. \ **Example:**\
  1685. ::
  1686. var error = method_that_returns_error()
  1687. if error != OK:
  1688. printerr("Failure!")
  1689. # Or, alternatively:
  1690. if error:
  1691. printerr("Still failing!")
  1692. \ **Note:** Many functions do not return an error code, but will print error messages to standard output.
  1693. .. _class_@GlobalScope_constant_FAILED:
  1694. .. rst-class:: classref-enumeration-constant
  1695. :ref:`Error<enum_@GlobalScope_Error>` **FAILED** = ``1``
  1696. Generic error.
  1697. .. _class_@GlobalScope_constant_ERR_UNAVAILABLE:
  1698. .. rst-class:: classref-enumeration-constant
  1699. :ref:`Error<enum_@GlobalScope_Error>` **ERR_UNAVAILABLE** = ``2``
  1700. Unavailable error.
  1701. .. _class_@GlobalScope_constant_ERR_UNCONFIGURED:
  1702. .. rst-class:: classref-enumeration-constant
  1703. :ref:`Error<enum_@GlobalScope_Error>` **ERR_UNCONFIGURED** = ``3``
  1704. Unconfigured error.
  1705. .. _class_@GlobalScope_constant_ERR_UNAUTHORIZED:
  1706. .. rst-class:: classref-enumeration-constant
  1707. :ref:`Error<enum_@GlobalScope_Error>` **ERR_UNAUTHORIZED** = ``4``
  1708. Unauthorized error.
  1709. .. _class_@GlobalScope_constant_ERR_PARAMETER_RANGE_ERROR:
  1710. .. rst-class:: classref-enumeration-constant
  1711. :ref:`Error<enum_@GlobalScope_Error>` **ERR_PARAMETER_RANGE_ERROR** = ``5``
  1712. Parameter range error.
  1713. .. _class_@GlobalScope_constant_ERR_OUT_OF_MEMORY:
  1714. .. rst-class:: classref-enumeration-constant
  1715. :ref:`Error<enum_@GlobalScope_Error>` **ERR_OUT_OF_MEMORY** = ``6``
  1716. Out of memory (OOM) error.
  1717. .. _class_@GlobalScope_constant_ERR_FILE_NOT_FOUND:
  1718. .. rst-class:: classref-enumeration-constant
  1719. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_NOT_FOUND** = ``7``
  1720. File: Not found error.
  1721. .. _class_@GlobalScope_constant_ERR_FILE_BAD_DRIVE:
  1722. .. rst-class:: classref-enumeration-constant
  1723. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_BAD_DRIVE** = ``8``
  1724. File: Bad drive error.
  1725. .. _class_@GlobalScope_constant_ERR_FILE_BAD_PATH:
  1726. .. rst-class:: classref-enumeration-constant
  1727. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_BAD_PATH** = ``9``
  1728. File: Bad path error.
  1729. .. _class_@GlobalScope_constant_ERR_FILE_NO_PERMISSION:
  1730. .. rst-class:: classref-enumeration-constant
  1731. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_NO_PERMISSION** = ``10``
  1732. File: No permission error.
  1733. .. _class_@GlobalScope_constant_ERR_FILE_ALREADY_IN_USE:
  1734. .. rst-class:: classref-enumeration-constant
  1735. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_ALREADY_IN_USE** = ``11``
  1736. File: Already in use error.
  1737. .. _class_@GlobalScope_constant_ERR_FILE_CANT_OPEN:
  1738. .. rst-class:: classref-enumeration-constant
  1739. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_OPEN** = ``12``
  1740. File: Can't open error.
  1741. .. _class_@GlobalScope_constant_ERR_FILE_CANT_WRITE:
  1742. .. rst-class:: classref-enumeration-constant
  1743. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_WRITE** = ``13``
  1744. File: Can't write error.
  1745. .. _class_@GlobalScope_constant_ERR_FILE_CANT_READ:
  1746. .. rst-class:: classref-enumeration-constant
  1747. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_READ** = ``14``
  1748. File: Can't read error.
  1749. .. _class_@GlobalScope_constant_ERR_FILE_UNRECOGNIZED:
  1750. .. rst-class:: classref-enumeration-constant
  1751. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_UNRECOGNIZED** = ``15``
  1752. File: Unrecognized error.
  1753. .. _class_@GlobalScope_constant_ERR_FILE_CORRUPT:
  1754. .. rst-class:: classref-enumeration-constant
  1755. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CORRUPT** = ``16``
  1756. File: Corrupt error.
  1757. .. _class_@GlobalScope_constant_ERR_FILE_MISSING_DEPENDENCIES:
  1758. .. rst-class:: classref-enumeration-constant
  1759. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_MISSING_DEPENDENCIES** = ``17``
  1760. File: Missing dependencies error.
  1761. .. _class_@GlobalScope_constant_ERR_FILE_EOF:
  1762. .. rst-class:: classref-enumeration-constant
  1763. :ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_EOF** = ``18``
  1764. File: End of file (EOF) error.
  1765. .. _class_@GlobalScope_constant_ERR_CANT_OPEN:
  1766. .. rst-class:: classref-enumeration-constant
  1767. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_OPEN** = ``19``
  1768. Can't open error.
  1769. .. _class_@GlobalScope_constant_ERR_CANT_CREATE:
  1770. .. rst-class:: classref-enumeration-constant
  1771. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_CREATE** = ``20``
  1772. Can't create error.
  1773. .. _class_@GlobalScope_constant_ERR_QUERY_FAILED:
  1774. .. rst-class:: classref-enumeration-constant
  1775. :ref:`Error<enum_@GlobalScope_Error>` **ERR_QUERY_FAILED** = ``21``
  1776. Query failed error.
  1777. .. _class_@GlobalScope_constant_ERR_ALREADY_IN_USE:
  1778. .. rst-class:: classref-enumeration-constant
  1779. :ref:`Error<enum_@GlobalScope_Error>` **ERR_ALREADY_IN_USE** = ``22``
  1780. Already in use error.
  1781. .. _class_@GlobalScope_constant_ERR_LOCKED:
  1782. .. rst-class:: classref-enumeration-constant
  1783. :ref:`Error<enum_@GlobalScope_Error>` **ERR_LOCKED** = ``23``
  1784. Locked error.
  1785. .. _class_@GlobalScope_constant_ERR_TIMEOUT:
  1786. .. rst-class:: classref-enumeration-constant
  1787. :ref:`Error<enum_@GlobalScope_Error>` **ERR_TIMEOUT** = ``24``
  1788. Timeout error.
  1789. .. _class_@GlobalScope_constant_ERR_CANT_CONNECT:
  1790. .. rst-class:: classref-enumeration-constant
  1791. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_CONNECT** = ``25``
  1792. Can't connect error.
  1793. .. _class_@GlobalScope_constant_ERR_CANT_RESOLVE:
  1794. .. rst-class:: classref-enumeration-constant
  1795. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_RESOLVE** = ``26``
  1796. Can't resolve error.
  1797. .. _class_@GlobalScope_constant_ERR_CONNECTION_ERROR:
  1798. .. rst-class:: classref-enumeration-constant
  1799. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CONNECTION_ERROR** = ``27``
  1800. Connection error.
  1801. .. _class_@GlobalScope_constant_ERR_CANT_ACQUIRE_RESOURCE:
  1802. .. rst-class:: classref-enumeration-constant
  1803. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_ACQUIRE_RESOURCE** = ``28``
  1804. Can't acquire resource error.
  1805. .. _class_@GlobalScope_constant_ERR_CANT_FORK:
  1806. .. rst-class:: classref-enumeration-constant
  1807. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_FORK** = ``29``
  1808. Can't fork process error.
  1809. .. _class_@GlobalScope_constant_ERR_INVALID_DATA:
  1810. .. rst-class:: classref-enumeration-constant
  1811. :ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_DATA** = ``30``
  1812. Invalid data error.
  1813. .. _class_@GlobalScope_constant_ERR_INVALID_PARAMETER:
  1814. .. rst-class:: classref-enumeration-constant
  1815. :ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_PARAMETER** = ``31``
  1816. Invalid parameter error.
  1817. .. _class_@GlobalScope_constant_ERR_ALREADY_EXISTS:
  1818. .. rst-class:: classref-enumeration-constant
  1819. :ref:`Error<enum_@GlobalScope_Error>` **ERR_ALREADY_EXISTS** = ``32``
  1820. Already exists error.
  1821. .. _class_@GlobalScope_constant_ERR_DOES_NOT_EXIST:
  1822. .. rst-class:: classref-enumeration-constant
  1823. :ref:`Error<enum_@GlobalScope_Error>` **ERR_DOES_NOT_EXIST** = ``33``
  1824. Does not exist error.
  1825. .. _class_@GlobalScope_constant_ERR_DATABASE_CANT_READ:
  1826. .. rst-class:: classref-enumeration-constant
  1827. :ref:`Error<enum_@GlobalScope_Error>` **ERR_DATABASE_CANT_READ** = ``34``
  1828. Database: Read error.
  1829. .. _class_@GlobalScope_constant_ERR_DATABASE_CANT_WRITE:
  1830. .. rst-class:: classref-enumeration-constant
  1831. :ref:`Error<enum_@GlobalScope_Error>` **ERR_DATABASE_CANT_WRITE** = ``35``
  1832. Database: Write error.
  1833. .. _class_@GlobalScope_constant_ERR_COMPILATION_FAILED:
  1834. .. rst-class:: classref-enumeration-constant
  1835. :ref:`Error<enum_@GlobalScope_Error>` **ERR_COMPILATION_FAILED** = ``36``
  1836. Compilation failed error.
  1837. .. _class_@GlobalScope_constant_ERR_METHOD_NOT_FOUND:
  1838. .. rst-class:: classref-enumeration-constant
  1839. :ref:`Error<enum_@GlobalScope_Error>` **ERR_METHOD_NOT_FOUND** = ``37``
  1840. Method not found error.
  1841. .. _class_@GlobalScope_constant_ERR_LINK_FAILED:
  1842. .. rst-class:: classref-enumeration-constant
  1843. :ref:`Error<enum_@GlobalScope_Error>` **ERR_LINK_FAILED** = ``38``
  1844. Linking failed error.
  1845. .. _class_@GlobalScope_constant_ERR_SCRIPT_FAILED:
  1846. .. rst-class:: classref-enumeration-constant
  1847. :ref:`Error<enum_@GlobalScope_Error>` **ERR_SCRIPT_FAILED** = ``39``
  1848. Script failed error.
  1849. .. _class_@GlobalScope_constant_ERR_CYCLIC_LINK:
  1850. .. rst-class:: classref-enumeration-constant
  1851. :ref:`Error<enum_@GlobalScope_Error>` **ERR_CYCLIC_LINK** = ``40``
  1852. Cycling link (import cycle) error.
  1853. .. _class_@GlobalScope_constant_ERR_INVALID_DECLARATION:
  1854. .. rst-class:: classref-enumeration-constant
  1855. :ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_DECLARATION** = ``41``
  1856. Invalid declaration error.
  1857. .. _class_@GlobalScope_constant_ERR_DUPLICATE_SYMBOL:
  1858. .. rst-class:: classref-enumeration-constant
  1859. :ref:`Error<enum_@GlobalScope_Error>` **ERR_DUPLICATE_SYMBOL** = ``42``
  1860. Duplicate symbol error.
  1861. .. _class_@GlobalScope_constant_ERR_PARSE_ERROR:
  1862. .. rst-class:: classref-enumeration-constant
  1863. :ref:`Error<enum_@GlobalScope_Error>` **ERR_PARSE_ERROR** = ``43``
  1864. Parse error.
  1865. .. _class_@GlobalScope_constant_ERR_BUSY:
  1866. .. rst-class:: classref-enumeration-constant
  1867. :ref:`Error<enum_@GlobalScope_Error>` **ERR_BUSY** = ``44``
  1868. Busy error.
  1869. .. _class_@GlobalScope_constant_ERR_SKIP:
  1870. .. rst-class:: classref-enumeration-constant
  1871. :ref:`Error<enum_@GlobalScope_Error>` **ERR_SKIP** = ``45``
  1872. Skip error.
  1873. .. _class_@GlobalScope_constant_ERR_HELP:
  1874. .. rst-class:: classref-enumeration-constant
  1875. :ref:`Error<enum_@GlobalScope_Error>` **ERR_HELP** = ``46``
  1876. Help error. Used internally when passing ``--version`` or ``--help`` as executable options.
  1877. .. _class_@GlobalScope_constant_ERR_BUG:
  1878. .. rst-class:: classref-enumeration-constant
  1879. :ref:`Error<enum_@GlobalScope_Error>` **ERR_BUG** = ``47``
  1880. Bug error, caused by an implementation issue in the method.
  1881. \ **Note:** If a built-in method returns this code, please open an issue on `the GitHub Issue Tracker <https://github.com/godotengine/godot/issues>`__.
  1882. .. _class_@GlobalScope_constant_ERR_PRINTER_ON_FIRE:
  1883. .. rst-class:: classref-enumeration-constant
  1884. :ref:`Error<enum_@GlobalScope_Error>` **ERR_PRINTER_ON_FIRE** = ``48``
  1885. Printer on fire error (This is an easter egg, no built-in methods return this error code).
  1886. .. rst-class:: classref-item-separator
  1887. ----
  1888. .. _enum_@GlobalScope_PropertyHint:
  1889. .. rst-class:: classref-enumeration
  1890. enum **PropertyHint**:
  1891. .. _class_@GlobalScope_constant_PROPERTY_HINT_NONE:
  1892. .. rst-class:: classref-enumeration-constant
  1893. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NONE** = ``0``
  1894. The property has no hint for the editor.
  1895. .. _class_@GlobalScope_constant_PROPERTY_HINT_RANGE:
  1896. .. rst-class:: classref-enumeration-constant
  1897. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_RANGE** = ``1``
  1898. 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.
  1899. \ **Example:** ``"-360,360,1,or_greater,or_less"``.
  1900. 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.
  1901. .. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM:
  1902. .. rst-class:: classref-enumeration-constant
  1903. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ENUM** = ``2``
  1904. 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.
  1905. 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"``.
  1906. .. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM_SUGGESTION:
  1907. .. rst-class:: classref-enumeration-constant
  1908. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ENUM_SUGGESTION** = ``3``
  1909. 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"``.
  1910. 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.
  1911. .. _class_@GlobalScope_constant_PROPERTY_HINT_EXP_EASING:
  1912. .. rst-class:: classref-enumeration-constant
  1913. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_EXP_EASING** = ``4``
  1914. 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.
  1915. .. _class_@GlobalScope_constant_PROPERTY_HINT_LINK:
  1916. .. rst-class:: classref-enumeration-constant
  1917. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LINK** = ``5``
  1918. 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.
  1919. .. _class_@GlobalScope_constant_PROPERTY_HINT_FLAGS:
  1920. .. rst-class:: classref-enumeration-constant
  1921. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_FLAGS** = ``6``
  1922. Hints that an :ref:`int<class_int>` property is a bitmask with named bit flags.
  1923. 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"``).
  1924. \ **Note:** A flag value must be at least ``1`` and at most ``2 ** 32 - 1``.
  1925. \ **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.
  1926. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_RENDER:
  1927. .. rst-class:: classref-enumeration-constant
  1928. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_RENDER** = ``7``
  1929. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 2D render layers.
  1930. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_PHYSICS:
  1931. .. rst-class:: classref-enumeration-constant
  1932. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_PHYSICS** = ``8``
  1933. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 2D physics layers.
  1934. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_NAVIGATION:
  1935. .. rst-class:: classref-enumeration-constant
  1936. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_NAVIGATION** = ``9``
  1937. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 2D navigation layers.
  1938. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_RENDER:
  1939. .. rst-class:: classref-enumeration-constant
  1940. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_RENDER** = ``10``
  1941. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 3D render layers.
  1942. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_PHYSICS:
  1943. .. rst-class:: classref-enumeration-constant
  1944. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_PHYSICS** = ``11``
  1945. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 3D physics layers.
  1946. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_NAVIGATION:
  1947. .. rst-class:: classref-enumeration-constant
  1948. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_NAVIGATION** = ``12``
  1949. Hints that an :ref:`int<class_int>` property is a bitmask using the optionally named 3D navigation layers.
  1950. .. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_AVOIDANCE:
  1951. .. rst-class:: classref-enumeration-constant
  1952. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_AVOIDANCE** = ``37``
  1953. Hints that an integer property is a bitmask using the optionally named avoidance layers.
  1954. .. _class_@GlobalScope_constant_PROPERTY_HINT_FILE:
  1955. .. rst-class:: classref-enumeration-constant
  1956. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_FILE** = ``13``
  1957. 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"``.
  1958. .. _class_@GlobalScope_constant_PROPERTY_HINT_DIR:
  1959. .. rst-class:: classref-enumeration-constant
  1960. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_DIR** = ``14``
  1961. 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.
  1962. .. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_FILE:
  1963. .. rst-class:: classref-enumeration-constant
  1964. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_FILE** = ``15``
  1965. 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"``.
  1966. .. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_DIR:
  1967. .. rst-class:: classref-enumeration-constant
  1968. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_DIR** = ``16``
  1969. 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.
  1970. .. _class_@GlobalScope_constant_PROPERTY_HINT_RESOURCE_TYPE:
  1971. .. rst-class:: classref-enumeration-constant
  1972. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_RESOURCE_TYPE** = ``17``
  1973. 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.
  1974. .. _class_@GlobalScope_constant_PROPERTY_HINT_MULTILINE_TEXT:
  1975. .. rst-class:: classref-enumeration-constant
  1976. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_MULTILINE_TEXT** = ``18``
  1977. 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.
  1978. .. _class_@GlobalScope_constant_PROPERTY_HINT_EXPRESSION:
  1979. .. rst-class:: classref-enumeration-constant
  1980. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_EXPRESSION** = ``19``
  1981. Hints that a :ref:`String<class_String>` property is an :ref:`Expression<class_Expression>`.
  1982. .. _class_@GlobalScope_constant_PROPERTY_HINT_PLACEHOLDER_TEXT:
  1983. .. rst-class:: classref-enumeration-constant
  1984. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_PLACEHOLDER_TEXT** = ``20``
  1985. 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.
  1986. .. _class_@GlobalScope_constant_PROPERTY_HINT_COLOR_NO_ALPHA:
  1987. .. rst-class:: classref-enumeration-constant
  1988. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_COLOR_NO_ALPHA** = ``21``
  1989. 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).
  1990. .. _class_@GlobalScope_constant_PROPERTY_HINT_OBJECT_ID:
  1991. .. rst-class:: classref-enumeration-constant
  1992. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_OBJECT_ID** = ``22``
  1993. 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.
  1994. .. _class_@GlobalScope_constant_PROPERTY_HINT_TYPE_STRING:
  1995. .. rst-class:: classref-enumeration-constant
  1996. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_TYPE_STRING** = ``23``
  1997. 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.
  1998. If a property is :ref:`Array<class_Array>`, hints the editor how to show elements. The ``hint_string`` must encode nested types using ``":"`` and ``"/"``.
  1999. .. tabs::
  2000. .. code-tab:: gdscript
  2001. # Array of elem_type.
  2002. hint_string = "%d:" % [elem_type]
  2003. hint_string = "%d/%d:%s" % [elem_type, elem_hint, elem_hint_string]
  2004. # Two-dimensional array of elem_type (array of arrays of elem_type).
  2005. hint_string = "%d:%d:" % [TYPE_ARRAY, elem_type]
  2006. hint_string = "%d:%d/%d:%s" % [TYPE_ARRAY, elem_type, elem_hint, elem_hint_string]
  2007. # Three-dimensional array of elem_type (array of arrays of arrays of elem_type).
  2008. hint_string = "%d:%d:%d:" % [TYPE_ARRAY, TYPE_ARRAY, elem_type]
  2009. hint_string = "%d:%d:%d/%d:%s" % [TYPE_ARRAY, TYPE_ARRAY, elem_type, elem_hint, elem_hint_string]
  2010. .. code-tab:: csharp
  2011. // Array of elemType.
  2012. hintString = $"{elemType:D}:";
  2013. hintString = $"{elemType:}/{elemHint:D}:{elemHintString}";
  2014. // Two-dimensional array of elemType (array of arrays of elemType).
  2015. hintString = $"{Variant.Type.Array:D}:{elemType:D}:";
  2016. hintString = $"{Variant.Type.Array:D}:{elemType:D}/{elemHint:D}:{elemHintString}";
  2017. // Three-dimensional array of elemType (array of arrays of arrays of elemType).
  2018. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Array:D}:{elemType:D}:";
  2019. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Array:D}:{elemType:D}/{elemHint:D}:{elemHintString}";
  2020. Examples:
  2021. .. tabs::
  2022. .. code-tab:: gdscript
  2023. hint_string = "%d:" % [TYPE_INT] # Array of integers.
  2024. hint_string = "%d/%d:1,10,1" % [TYPE_INT, PROPERTY_HINT_RANGE] # Array of integers (in range from 1 to 10).
  2025. hint_string = "%d/%d:Zero,One,Two" % [TYPE_INT, PROPERTY_HINT_ENUM] # Array of integers (an enum).
  2026. hint_string = "%d/%d:Zero,One,Three:3,Six:6" % [TYPE_INT, PROPERTY_HINT_ENUM] # Array of integers (an enum).
  2027. hint_string = "%d/%d:*.png" % [TYPE_STRING, PROPERTY_HINT_FILE] # Array of strings (file paths).
  2028. hint_string = "%d/%d:Texture2D" % [TYPE_OBJECT, PROPERTY_HINT_RESOURCE_TYPE] # Array of textures.
  2029. hint_string = "%d:%d:" % [TYPE_ARRAY, TYPE_FLOAT] # Two-dimensional array of floats.
  2030. hint_string = "%d:%d/%d:" % [TYPE_ARRAY, TYPE_STRING, PROPERTY_HINT_MULTILINE_TEXT] # Two-dimensional array of multiline strings.
  2031. 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).
  2032. hint_string = "%d:%d/%d:Texture2D" % [TYPE_ARRAY, TYPE_OBJECT, PROPERTY_HINT_RESOURCE_TYPE] # Two-dimensional array of textures.
  2033. .. code-tab:: csharp
  2034. hintString = $"{Variant.Type.Int:D}/{PropertyHint.Range:D}:1,10,1"; // Array of integers (in range from 1 to 10).
  2035. hintString = $"{Variant.Type.Int:D}/{PropertyHint.Enum:D}:Zero,One,Two"; // Array of integers (an enum).
  2036. hintString = $"{Variant.Type.Int:D}/{PropertyHint.Enum:D}:Zero,One,Three:3,Six:6"; // Array of integers (an enum).
  2037. hintString = $"{Variant.Type.String:D}/{PropertyHint.File:D}:*.png"; // Array of strings (file paths).
  2038. hintString = $"{Variant.Type.Object:D}/{PropertyHint.ResourceType:D}:Texture2D"; // Array of textures.
  2039. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Float:D}:"; // Two-dimensional array of floats.
  2040. hintString = $"{Variant.Type.Array:D}:{Variant.Type.String:D}/{PropertyHint.MultilineText:D}:"; // Two-dimensional array of multiline strings.
  2041. 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).
  2042. hintString = $"{Variant.Type.Array:D}:{Variant.Type.Object:D}/{PropertyHint.ResourceType:D}:Texture2D"; // Two-dimensional array of textures.
  2043. \ **Note:** The trailing colon is required for properly detecting built-in types.
  2044. .. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_PATH_TO_EDITED_NODE:
  2045. .. rst-class:: classref-enumeration-constant
  2046. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_PATH_TO_EDITED_NODE** = ``24``
  2047. **Deprecated:** This hint is not used by the engine.
  2048. .. _class_@GlobalScope_constant_PROPERTY_HINT_OBJECT_TOO_BIG:
  2049. .. rst-class:: classref-enumeration-constant
  2050. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_OBJECT_TOO_BIG** = ``25``
  2051. Hints that an object is too big to be sent via the debugger.
  2052. .. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_PATH_VALID_TYPES:
  2053. .. rst-class:: classref-enumeration-constant
  2054. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_PATH_VALID_TYPES** = ``26``
  2055. Hints that the hint string specifies valid node types for property of type :ref:`NodePath<class_NodePath>`.
  2056. .. _class_@GlobalScope_constant_PROPERTY_HINT_SAVE_FILE:
  2057. .. rst-class:: classref-enumeration-constant
  2058. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_SAVE_FILE** = ``27``
  2059. 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>`.
  2060. .. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_SAVE_FILE:
  2061. .. rst-class:: classref-enumeration-constant
  2062. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_SAVE_FILE** = ``28``
  2063. 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>`.
  2064. .. _class_@GlobalScope_constant_PROPERTY_HINT_INT_IS_OBJECTID:
  2065. .. rst-class:: classref-enumeration-constant
  2066. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_INT_IS_OBJECTID** = ``29``
  2067. **Deprecated:** This hint is not used by the engine.
  2068. .. _class_@GlobalScope_constant_PROPERTY_HINT_INT_IS_POINTER:
  2069. .. rst-class:: classref-enumeration-constant
  2070. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_INT_IS_POINTER** = ``30``
  2071. Hints that an :ref:`int<class_int>` property is a pointer. Used by GDExtension.
  2072. .. _class_@GlobalScope_constant_PROPERTY_HINT_ARRAY_TYPE:
  2073. .. rst-class:: classref-enumeration-constant
  2074. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ARRAY_TYPE** = ``31``
  2075. Hints that a property is an :ref:`Array<class_Array>` with the stored type specified in the hint string.
  2076. .. _class_@GlobalScope_constant_PROPERTY_HINT_LOCALE_ID:
  2077. .. rst-class:: classref-enumeration-constant
  2078. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LOCALE_ID** = ``32``
  2079. Hints that a string property is a locale code. Editing it will show a locale dialog for picking language and country.
  2080. .. _class_@GlobalScope_constant_PROPERTY_HINT_LOCALIZABLE_STRING:
  2081. .. rst-class:: classref-enumeration-constant
  2082. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LOCALIZABLE_STRING** = ``33``
  2083. Hints that a dictionary property is string translation map. Dictionary keys are locale codes and, values are translated strings.
  2084. .. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_TYPE:
  2085. .. rst-class:: classref-enumeration-constant
  2086. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_TYPE** = ``34``
  2087. 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.
  2088. .. _class_@GlobalScope_constant_PROPERTY_HINT_HIDE_QUATERNION_EDIT:
  2089. .. rst-class:: classref-enumeration-constant
  2090. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_HIDE_QUATERNION_EDIT** = ``35``
  2091. Hints that a quaternion property should disable the temporary euler editor.
  2092. .. _class_@GlobalScope_constant_PROPERTY_HINT_PASSWORD:
  2093. .. rst-class:: classref-enumeration-constant
  2094. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_PASSWORD** = ``36``
  2095. Hints that a string property is a password, and every character is replaced with the secret character.
  2096. .. _class_@GlobalScope_constant_PROPERTY_HINT_MAX:
  2097. .. rst-class:: classref-enumeration-constant
  2098. :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_MAX** = ``38``
  2099. Represents the size of the :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` enum.
  2100. .. rst-class:: classref-item-separator
  2101. ----
  2102. .. _enum_@GlobalScope_PropertyUsageFlags:
  2103. .. rst-class:: classref-enumeration
  2104. flags **PropertyUsageFlags**:
  2105. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NONE:
  2106. .. rst-class:: classref-enumeration-constant
  2107. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NONE** = ``0``
  2108. The property is not stored, and does not display in the editor. This is the default for non-exported properties.
  2109. .. _class_@GlobalScope_constant_PROPERTY_USAGE_STORAGE:
  2110. .. rst-class:: classref-enumeration-constant
  2111. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_STORAGE** = ``2``
  2112. The property is serialized and saved in the scene file (default).
  2113. .. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR:
  2114. .. rst-class:: classref-enumeration-constant
  2115. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR** = ``4``
  2116. The property is shown in the :ref:`EditorInspector<class_EditorInspector>` (default).
  2117. .. _class_@GlobalScope_constant_PROPERTY_USAGE_INTERNAL:
  2118. .. rst-class:: classref-enumeration-constant
  2119. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_INTERNAL** = ``8``
  2120. The property is excluded from the class reference.
  2121. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CHECKABLE:
  2122. .. rst-class:: classref-enumeration-constant
  2123. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CHECKABLE** = ``16``
  2124. The property can be checked in the :ref:`EditorInspector<class_EditorInspector>`.
  2125. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CHECKED:
  2126. .. rst-class:: classref-enumeration-constant
  2127. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CHECKED** = ``32``
  2128. The property is checked in the :ref:`EditorInspector<class_EditorInspector>`.
  2129. .. _class_@GlobalScope_constant_PROPERTY_USAGE_GROUP:
  2130. .. rst-class:: classref-enumeration-constant
  2131. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_GROUP** = ``64``
  2132. Used to group properties together in the editor. See :ref:`EditorInspector<class_EditorInspector>`.
  2133. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CATEGORY:
  2134. .. rst-class:: classref-enumeration-constant
  2135. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CATEGORY** = ``128``
  2136. Used to categorize properties together in the editor.
  2137. .. _class_@GlobalScope_constant_PROPERTY_USAGE_SUBGROUP:
  2138. .. rst-class:: classref-enumeration-constant
  2139. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SUBGROUP** = ``256``
  2140. Used to group properties together in the editor in a subgroup (under a group). See :ref:`EditorInspector<class_EditorInspector>`.
  2141. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CLASS_IS_BITFIELD:
  2142. .. rst-class:: classref-enumeration-constant
  2143. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CLASS_IS_BITFIELD** = ``512``
  2144. The property is a bitfield, i.e. it contains multiple flags represented as bits.
  2145. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NO_INSTANCE_STATE:
  2146. .. rst-class:: classref-enumeration-constant
  2147. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NO_INSTANCE_STATE** = ``1024``
  2148. The property does not save its state in :ref:`PackedScene<class_PackedScene>`.
  2149. .. _class_@GlobalScope_constant_PROPERTY_USAGE_RESTART_IF_CHANGED:
  2150. .. rst-class:: classref-enumeration-constant
  2151. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_RESTART_IF_CHANGED** = ``2048``
  2152. Editing the property prompts the user for restarting the editor.
  2153. .. _class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_VARIABLE:
  2154. .. rst-class:: classref-enumeration-constant
  2155. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SCRIPT_VARIABLE** = ``4096``
  2156. The property is a script variable which should be serialized and saved in the scene file.
  2157. .. _class_@GlobalScope_constant_PROPERTY_USAGE_STORE_IF_NULL:
  2158. .. rst-class:: classref-enumeration-constant
  2159. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_STORE_IF_NULL** = ``8192``
  2160. The property value of type :ref:`Object<class_Object>` will be stored even if its value is ``null``.
  2161. .. _class_@GlobalScope_constant_PROPERTY_USAGE_UPDATE_ALL_IF_MODIFIED:
  2162. .. rst-class:: classref-enumeration-constant
  2163. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_UPDATE_ALL_IF_MODIFIED** = ``16384``
  2164. If this property is modified, all inspector fields will be refreshed.
  2165. .. _class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_DEFAULT_VALUE:
  2166. .. rst-class:: classref-enumeration-constant
  2167. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SCRIPT_DEFAULT_VALUE** = ``32768``
  2168. **Deprecated:** This flag is not used by the engine.
  2169. .. _class_@GlobalScope_constant_PROPERTY_USAGE_CLASS_IS_ENUM:
  2170. .. rst-class:: classref-enumeration-constant
  2171. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CLASS_IS_ENUM** = ``65536``
  2172. The property is an enum, i.e. it only takes named integer constants from its associated enumeration.
  2173. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NIL_IS_VARIANT:
  2174. .. rst-class:: classref-enumeration-constant
  2175. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NIL_IS_VARIANT** = ``131072``
  2176. If property has ``nil`` as default value, its type will be :ref:`Variant<class_Variant>`.
  2177. .. _class_@GlobalScope_constant_PROPERTY_USAGE_ARRAY:
  2178. .. rst-class:: classref-enumeration-constant
  2179. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_ARRAY** = ``262144``
  2180. The property is an array.
  2181. .. _class_@GlobalScope_constant_PROPERTY_USAGE_ALWAYS_DUPLICATE:
  2182. .. rst-class:: classref-enumeration-constant
  2183. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_ALWAYS_DUPLICATE** = ``524288``
  2184. 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.
  2185. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NEVER_DUPLICATE:
  2186. .. rst-class:: classref-enumeration-constant
  2187. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NEVER_DUPLICATE** = ``1048576``
  2188. 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.
  2189. .. _class_@GlobalScope_constant_PROPERTY_USAGE_HIGH_END_GFX:
  2190. .. rst-class:: classref-enumeration-constant
  2191. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_HIGH_END_GFX** = ``2097152``
  2192. The property is only shown in the editor if modern renderers are supported (the Compatibility rendering method is excluded).
  2193. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NODE_PATH_FROM_SCENE_ROOT:
  2194. .. rst-class:: classref-enumeration-constant
  2195. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NODE_PATH_FROM_SCENE_ROOT** = ``4194304``
  2196. The :ref:`NodePath<class_NodePath>` property will always be relative to the scene's root. Mostly useful for local resources.
  2197. .. _class_@GlobalScope_constant_PROPERTY_USAGE_RESOURCE_NOT_PERSISTENT:
  2198. .. rst-class:: classref-enumeration-constant
  2199. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_RESOURCE_NOT_PERSISTENT** = ``8388608``
  2200. 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.
  2201. .. _class_@GlobalScope_constant_PROPERTY_USAGE_KEYING_INCREMENTS:
  2202. .. rst-class:: classref-enumeration-constant
  2203. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_KEYING_INCREMENTS** = ``16777216``
  2204. Inserting an animation key frame of this property will automatically increment the value, allowing to easily keyframe multiple values in a row.
  2205. .. _class_@GlobalScope_constant_PROPERTY_USAGE_DEFERRED_SET_RESOURCE:
  2206. .. rst-class:: classref-enumeration-constant
  2207. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_DEFERRED_SET_RESOURCE** = ``33554432``
  2208. **Deprecated:** This flag is not used by the engine.
  2209. .. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR_INSTANTIATE_OBJECT:
  2210. .. rst-class:: classref-enumeration-constant
  2211. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR_INSTANTIATE_OBJECT** = ``67108864``
  2212. 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.
  2213. .. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR_BASIC_SETTING:
  2214. .. rst-class:: classref-enumeration-constant
  2215. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR_BASIC_SETTING** = ``134217728``
  2216. The property is considered a basic setting and will appear even when advanced mode is disabled. Used for project settings.
  2217. .. _class_@GlobalScope_constant_PROPERTY_USAGE_READ_ONLY:
  2218. .. rst-class:: classref-enumeration-constant
  2219. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_READ_ONLY** = ``268435456``
  2220. The property is read-only in the :ref:`EditorInspector<class_EditorInspector>`.
  2221. .. _class_@GlobalScope_constant_PROPERTY_USAGE_SECRET:
  2222. .. rst-class:: classref-enumeration-constant
  2223. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SECRET** = ``536870912``
  2224. An export preset property with this flag contains confidential information and is stored separately from the rest of the export preset configuration.
  2225. .. _class_@GlobalScope_constant_PROPERTY_USAGE_DEFAULT:
  2226. .. rst-class:: classref-enumeration-constant
  2227. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_DEFAULT** = ``6``
  2228. Default usage (storage and editor).
  2229. .. _class_@GlobalScope_constant_PROPERTY_USAGE_NO_EDITOR:
  2230. .. rst-class:: classref-enumeration-constant
  2231. :ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NO_EDITOR** = ``2``
  2232. Default usage but without showing the property in the editor (storage).
  2233. .. rst-class:: classref-item-separator
  2234. ----
  2235. .. _enum_@GlobalScope_MethodFlags:
  2236. .. rst-class:: classref-enumeration
  2237. flags **MethodFlags**:
  2238. .. _class_@GlobalScope_constant_METHOD_FLAG_NORMAL:
  2239. .. rst-class:: classref-enumeration-constant
  2240. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_NORMAL** = ``1``
  2241. Flag for a normal method.
  2242. .. _class_@GlobalScope_constant_METHOD_FLAG_EDITOR:
  2243. .. rst-class:: classref-enumeration-constant
  2244. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_EDITOR** = ``2``
  2245. Flag for an editor method.
  2246. .. _class_@GlobalScope_constant_METHOD_FLAG_CONST:
  2247. .. rst-class:: classref-enumeration-constant
  2248. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_CONST** = ``4``
  2249. Flag for a constant method.
  2250. .. _class_@GlobalScope_constant_METHOD_FLAG_VIRTUAL:
  2251. .. rst-class:: classref-enumeration-constant
  2252. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_VIRTUAL** = ``8``
  2253. Flag for a virtual method.
  2254. .. _class_@GlobalScope_constant_METHOD_FLAG_VARARG:
  2255. .. rst-class:: classref-enumeration-constant
  2256. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_VARARG** = ``16``
  2257. Flag for a method with a variable number of arguments.
  2258. .. _class_@GlobalScope_constant_METHOD_FLAG_STATIC:
  2259. .. rst-class:: classref-enumeration-constant
  2260. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_STATIC** = ``32``
  2261. Flag for a static method.
  2262. .. _class_@GlobalScope_constant_METHOD_FLAG_OBJECT_CORE:
  2263. .. rst-class:: classref-enumeration-constant
  2264. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_OBJECT_CORE** = ``64``
  2265. Used internally. Allows to not dump core virtual methods (such as :ref:`Object._notification<class_Object_private_method__notification>`) to the JSON API.
  2266. .. _class_@GlobalScope_constant_METHOD_FLAGS_DEFAULT:
  2267. .. rst-class:: classref-enumeration-constant
  2268. :ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAGS_DEFAULT** = ``1``
  2269. Default method flags (normal).
  2270. .. rst-class:: classref-item-separator
  2271. ----
  2272. .. _enum_@GlobalScope_Variant.Type:
  2273. .. rst-class:: classref-enumeration
  2274. enum **Variant.Type**:
  2275. .. _class_@GlobalScope_constant_TYPE_NIL:
  2276. .. rst-class:: classref-enumeration-constant
  2277. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_NIL** = ``0``
  2278. Variable is ``null``.
  2279. .. _class_@GlobalScope_constant_TYPE_BOOL:
  2280. .. rst-class:: classref-enumeration-constant
  2281. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_BOOL** = ``1``
  2282. Variable is of type :ref:`bool<class_bool>`.
  2283. .. _class_@GlobalScope_constant_TYPE_INT:
  2284. .. rst-class:: classref-enumeration-constant
  2285. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_INT** = ``2``
  2286. Variable is of type :ref:`int<class_int>`.
  2287. .. _class_@GlobalScope_constant_TYPE_FLOAT:
  2288. .. rst-class:: classref-enumeration-constant
  2289. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_FLOAT** = ``3``
  2290. Variable is of type :ref:`float<class_float>`.
  2291. .. _class_@GlobalScope_constant_TYPE_STRING:
  2292. .. rst-class:: classref-enumeration-constant
  2293. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_STRING** = ``4``
  2294. Variable is of type :ref:`String<class_String>`.
  2295. .. _class_@GlobalScope_constant_TYPE_VECTOR2:
  2296. .. rst-class:: classref-enumeration-constant
  2297. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR2** = ``5``
  2298. Variable is of type :ref:`Vector2<class_Vector2>`.
  2299. .. _class_@GlobalScope_constant_TYPE_VECTOR2I:
  2300. .. rst-class:: classref-enumeration-constant
  2301. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR2I** = ``6``
  2302. Variable is of type :ref:`Vector2i<class_Vector2i>`.
  2303. .. _class_@GlobalScope_constant_TYPE_RECT2:
  2304. .. rst-class:: classref-enumeration-constant
  2305. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RECT2** = ``7``
  2306. Variable is of type :ref:`Rect2<class_Rect2>`.
  2307. .. _class_@GlobalScope_constant_TYPE_RECT2I:
  2308. .. rst-class:: classref-enumeration-constant
  2309. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RECT2I** = ``8``
  2310. Variable is of type :ref:`Rect2i<class_Rect2i>`.
  2311. .. _class_@GlobalScope_constant_TYPE_VECTOR3:
  2312. .. rst-class:: classref-enumeration-constant
  2313. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR3** = ``9``
  2314. Variable is of type :ref:`Vector3<class_Vector3>`.
  2315. .. _class_@GlobalScope_constant_TYPE_VECTOR3I:
  2316. .. rst-class:: classref-enumeration-constant
  2317. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR3I** = ``10``
  2318. Variable is of type :ref:`Vector3i<class_Vector3i>`.
  2319. .. _class_@GlobalScope_constant_TYPE_TRANSFORM2D:
  2320. .. rst-class:: classref-enumeration-constant
  2321. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_TRANSFORM2D** = ``11``
  2322. Variable is of type :ref:`Transform2D<class_Transform2D>`.
  2323. .. _class_@GlobalScope_constant_TYPE_VECTOR4:
  2324. .. rst-class:: classref-enumeration-constant
  2325. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR4** = ``12``
  2326. Variable is of type :ref:`Vector4<class_Vector4>`.
  2327. .. _class_@GlobalScope_constant_TYPE_VECTOR4I:
  2328. .. rst-class:: classref-enumeration-constant
  2329. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR4I** = ``13``
  2330. Variable is of type :ref:`Vector4i<class_Vector4i>`.
  2331. .. _class_@GlobalScope_constant_TYPE_PLANE:
  2332. .. rst-class:: classref-enumeration-constant
  2333. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PLANE** = ``14``
  2334. Variable is of type :ref:`Plane<class_Plane>`.
  2335. .. _class_@GlobalScope_constant_TYPE_QUATERNION:
  2336. .. rst-class:: classref-enumeration-constant
  2337. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_QUATERNION** = ``15``
  2338. Variable is of type :ref:`Quaternion<class_Quaternion>`.
  2339. .. _class_@GlobalScope_constant_TYPE_AABB:
  2340. .. rst-class:: classref-enumeration-constant
  2341. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_AABB** = ``16``
  2342. Variable is of type :ref:`AABB<class_AABB>`.
  2343. .. _class_@GlobalScope_constant_TYPE_BASIS:
  2344. .. rst-class:: classref-enumeration-constant
  2345. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_BASIS** = ``17``
  2346. Variable is of type :ref:`Basis<class_Basis>`.
  2347. .. _class_@GlobalScope_constant_TYPE_TRANSFORM3D:
  2348. .. rst-class:: classref-enumeration-constant
  2349. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_TRANSFORM3D** = ``18``
  2350. Variable is of type :ref:`Transform3D<class_Transform3D>`.
  2351. .. _class_@GlobalScope_constant_TYPE_PROJECTION:
  2352. .. rst-class:: classref-enumeration-constant
  2353. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PROJECTION** = ``19``
  2354. Variable is of type :ref:`Projection<class_Projection>`.
  2355. .. _class_@GlobalScope_constant_TYPE_COLOR:
  2356. .. rst-class:: classref-enumeration-constant
  2357. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_COLOR** = ``20``
  2358. Variable is of type :ref:`Color<class_Color>`.
  2359. .. _class_@GlobalScope_constant_TYPE_STRING_NAME:
  2360. .. rst-class:: classref-enumeration-constant
  2361. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_STRING_NAME** = ``21``
  2362. Variable is of type :ref:`StringName<class_StringName>`.
  2363. .. _class_@GlobalScope_constant_TYPE_NODE_PATH:
  2364. .. rst-class:: classref-enumeration-constant
  2365. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_NODE_PATH** = ``22``
  2366. Variable is of type :ref:`NodePath<class_NodePath>`.
  2367. .. _class_@GlobalScope_constant_TYPE_RID:
  2368. .. rst-class:: classref-enumeration-constant
  2369. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RID** = ``23``
  2370. Variable is of type :ref:`RID<class_RID>`.
  2371. .. _class_@GlobalScope_constant_TYPE_OBJECT:
  2372. .. rst-class:: classref-enumeration-constant
  2373. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_OBJECT** = ``24``
  2374. Variable is of type :ref:`Object<class_Object>`.
  2375. .. _class_@GlobalScope_constant_TYPE_CALLABLE:
  2376. .. rst-class:: classref-enumeration-constant
  2377. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_CALLABLE** = ``25``
  2378. Variable is of type :ref:`Callable<class_Callable>`.
  2379. .. _class_@GlobalScope_constant_TYPE_SIGNAL:
  2380. .. rst-class:: classref-enumeration-constant
  2381. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_SIGNAL** = ``26``
  2382. Variable is of type :ref:`Signal<class_Signal>`.
  2383. .. _class_@GlobalScope_constant_TYPE_DICTIONARY:
  2384. .. rst-class:: classref-enumeration-constant
  2385. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_DICTIONARY** = ``27``
  2386. Variable is of type :ref:`Dictionary<class_Dictionary>`.
  2387. .. _class_@GlobalScope_constant_TYPE_ARRAY:
  2388. .. rst-class:: classref-enumeration-constant
  2389. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_ARRAY** = ``28``
  2390. Variable is of type :ref:`Array<class_Array>`.
  2391. .. _class_@GlobalScope_constant_TYPE_PACKED_BYTE_ARRAY:
  2392. .. rst-class:: classref-enumeration-constant
  2393. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_BYTE_ARRAY** = ``29``
  2394. Variable is of type :ref:`PackedByteArray<class_PackedByteArray>`.
  2395. .. _class_@GlobalScope_constant_TYPE_PACKED_INT32_ARRAY:
  2396. .. rst-class:: classref-enumeration-constant
  2397. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_INT32_ARRAY** = ``30``
  2398. Variable is of type :ref:`PackedInt32Array<class_PackedInt32Array>`.
  2399. .. _class_@GlobalScope_constant_TYPE_PACKED_INT64_ARRAY:
  2400. .. rst-class:: classref-enumeration-constant
  2401. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_INT64_ARRAY** = ``31``
  2402. Variable is of type :ref:`PackedInt64Array<class_PackedInt64Array>`.
  2403. .. _class_@GlobalScope_constant_TYPE_PACKED_FLOAT32_ARRAY:
  2404. .. rst-class:: classref-enumeration-constant
  2405. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_FLOAT32_ARRAY** = ``32``
  2406. Variable is of type :ref:`PackedFloat32Array<class_PackedFloat32Array>`.
  2407. .. _class_@GlobalScope_constant_TYPE_PACKED_FLOAT64_ARRAY:
  2408. .. rst-class:: classref-enumeration-constant
  2409. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_FLOAT64_ARRAY** = ``33``
  2410. Variable is of type :ref:`PackedFloat64Array<class_PackedFloat64Array>`.
  2411. .. _class_@GlobalScope_constant_TYPE_PACKED_STRING_ARRAY:
  2412. .. rst-class:: classref-enumeration-constant
  2413. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_STRING_ARRAY** = ``34``
  2414. Variable is of type :ref:`PackedStringArray<class_PackedStringArray>`.
  2415. .. _class_@GlobalScope_constant_TYPE_PACKED_VECTOR2_ARRAY:
  2416. .. rst-class:: classref-enumeration-constant
  2417. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_VECTOR2_ARRAY** = ``35``
  2418. Variable is of type :ref:`PackedVector2Array<class_PackedVector2Array>`.
  2419. .. _class_@GlobalScope_constant_TYPE_PACKED_VECTOR3_ARRAY:
  2420. .. rst-class:: classref-enumeration-constant
  2421. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_VECTOR3_ARRAY** = ``36``
  2422. Variable is of type :ref:`PackedVector3Array<class_PackedVector3Array>`.
  2423. .. _class_@GlobalScope_constant_TYPE_PACKED_COLOR_ARRAY:
  2424. .. rst-class:: classref-enumeration-constant
  2425. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_COLOR_ARRAY** = ``37``
  2426. Variable is of type :ref:`PackedColorArray<class_PackedColorArray>`.
  2427. .. _class_@GlobalScope_constant_TYPE_MAX:
  2428. .. rst-class:: classref-enumeration-constant
  2429. :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_MAX** = ``38``
  2430. Represents the size of the :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` enum.
  2431. .. rst-class:: classref-item-separator
  2432. ----
  2433. .. _enum_@GlobalScope_Variant.Operator:
  2434. .. rst-class:: classref-enumeration
  2435. enum **Variant.Operator**:
  2436. .. _class_@GlobalScope_constant_OP_EQUAL:
  2437. .. rst-class:: classref-enumeration-constant
  2438. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_EQUAL** = ``0``
  2439. Equality operator (``==``).
  2440. .. _class_@GlobalScope_constant_OP_NOT_EQUAL:
  2441. .. rst-class:: classref-enumeration-constant
  2442. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NOT_EQUAL** = ``1``
  2443. Inequality operator (``!=``).
  2444. .. _class_@GlobalScope_constant_OP_LESS:
  2445. .. rst-class:: classref-enumeration-constant
  2446. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_LESS** = ``2``
  2447. Less than operator (``<``).
  2448. .. _class_@GlobalScope_constant_OP_LESS_EQUAL:
  2449. .. rst-class:: classref-enumeration-constant
  2450. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_LESS_EQUAL** = ``3``
  2451. Less than or equal operator (``<=``).
  2452. .. _class_@GlobalScope_constant_OP_GREATER:
  2453. .. rst-class:: classref-enumeration-constant
  2454. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_GREATER** = ``4``
  2455. Greater than operator (``>``).
  2456. .. _class_@GlobalScope_constant_OP_GREATER_EQUAL:
  2457. .. rst-class:: classref-enumeration-constant
  2458. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_GREATER_EQUAL** = ``5``
  2459. Greater than or equal operator (``>=``).
  2460. .. _class_@GlobalScope_constant_OP_ADD:
  2461. .. rst-class:: classref-enumeration-constant
  2462. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_ADD** = ``6``
  2463. Addition operator (``+``).
  2464. .. _class_@GlobalScope_constant_OP_SUBTRACT:
  2465. .. rst-class:: classref-enumeration-constant
  2466. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SUBTRACT** = ``7``
  2467. Subtraction operator (``-``).
  2468. .. _class_@GlobalScope_constant_OP_MULTIPLY:
  2469. .. rst-class:: classref-enumeration-constant
  2470. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MULTIPLY** = ``8``
  2471. Multiplication operator (``*``).
  2472. .. _class_@GlobalScope_constant_OP_DIVIDE:
  2473. .. rst-class:: classref-enumeration-constant
  2474. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_DIVIDE** = ``9``
  2475. Division operator (``/``).
  2476. .. _class_@GlobalScope_constant_OP_NEGATE:
  2477. .. rst-class:: classref-enumeration-constant
  2478. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NEGATE** = ``10``
  2479. Unary negation operator (``-``).
  2480. .. _class_@GlobalScope_constant_OP_POSITIVE:
  2481. .. rst-class:: classref-enumeration-constant
  2482. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_POSITIVE** = ``11``
  2483. Unary plus operator (``+``).
  2484. .. _class_@GlobalScope_constant_OP_MODULE:
  2485. .. rst-class:: classref-enumeration-constant
  2486. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MODULE** = ``12``
  2487. Remainder/modulo operator (``%``).
  2488. .. _class_@GlobalScope_constant_OP_POWER:
  2489. .. rst-class:: classref-enumeration-constant
  2490. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_POWER** = ``13``
  2491. Power operator (``**``).
  2492. .. _class_@GlobalScope_constant_OP_SHIFT_LEFT:
  2493. .. rst-class:: classref-enumeration-constant
  2494. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SHIFT_LEFT** = ``14``
  2495. Left shift operator (``<<``).
  2496. .. _class_@GlobalScope_constant_OP_SHIFT_RIGHT:
  2497. .. rst-class:: classref-enumeration-constant
  2498. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SHIFT_RIGHT** = ``15``
  2499. Right shift operator (``>>``).
  2500. .. _class_@GlobalScope_constant_OP_BIT_AND:
  2501. .. rst-class:: classref-enumeration-constant
  2502. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_AND** = ``16``
  2503. Bitwise AND operator (``&``).
  2504. .. _class_@GlobalScope_constant_OP_BIT_OR:
  2505. .. rst-class:: classref-enumeration-constant
  2506. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_OR** = ``17``
  2507. Bitwise OR operator (``|``).
  2508. .. _class_@GlobalScope_constant_OP_BIT_XOR:
  2509. .. rst-class:: classref-enumeration-constant
  2510. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_XOR** = ``18``
  2511. Bitwise XOR operator (``^``).
  2512. .. _class_@GlobalScope_constant_OP_BIT_NEGATE:
  2513. .. rst-class:: classref-enumeration-constant
  2514. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_NEGATE** = ``19``
  2515. Bitwise NOT operator (``~``).
  2516. .. _class_@GlobalScope_constant_OP_AND:
  2517. .. rst-class:: classref-enumeration-constant
  2518. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_AND** = ``20``
  2519. Logical AND operator (``and`` or ``&&``).
  2520. .. _class_@GlobalScope_constant_OP_OR:
  2521. .. rst-class:: classref-enumeration-constant
  2522. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_OR** = ``21``
  2523. Logical OR operator (``or`` or ``||``).
  2524. .. _class_@GlobalScope_constant_OP_XOR:
  2525. .. rst-class:: classref-enumeration-constant
  2526. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_XOR** = ``22``
  2527. Logical XOR operator (not implemented in GDScript).
  2528. .. _class_@GlobalScope_constant_OP_NOT:
  2529. .. rst-class:: classref-enumeration-constant
  2530. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NOT** = ``23``
  2531. Logical NOT operator (``not`` or ``!``).
  2532. .. _class_@GlobalScope_constant_OP_IN:
  2533. .. rst-class:: classref-enumeration-constant
  2534. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_IN** = ``24``
  2535. Logical IN operator (``in``).
  2536. .. _class_@GlobalScope_constant_OP_MAX:
  2537. .. rst-class:: classref-enumeration-constant
  2538. :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MAX** = ``25``
  2539. Represents the size of the :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` enum.
  2540. .. rst-class:: classref-section-separator
  2541. ----
  2542. .. rst-class:: classref-descriptions-group
  2543. Property Descriptions
  2544. ---------------------
  2545. .. _class_@GlobalScope_property_AudioServer:
  2546. .. rst-class:: classref-property
  2547. :ref:`AudioServer<class_AudioServer>` **AudioServer**
  2548. The :ref:`AudioServer<class_AudioServer>` singleton.
  2549. .. rst-class:: classref-item-separator
  2550. ----
  2551. .. _class_@GlobalScope_property_CameraServer:
  2552. .. rst-class:: classref-property
  2553. :ref:`CameraServer<class_CameraServer>` **CameraServer**
  2554. The :ref:`CameraServer<class_CameraServer>` singleton.
  2555. .. rst-class:: classref-item-separator
  2556. ----
  2557. .. _class_@GlobalScope_property_ClassDB:
  2558. .. rst-class:: classref-property
  2559. :ref:`ClassDB<class_ClassDB>` **ClassDB**
  2560. The :ref:`ClassDB<class_ClassDB>` singleton.
  2561. .. rst-class:: classref-item-separator
  2562. ----
  2563. .. _class_@GlobalScope_property_DisplayServer:
  2564. .. rst-class:: classref-property
  2565. :ref:`DisplayServer<class_DisplayServer>` **DisplayServer**
  2566. The :ref:`DisplayServer<class_DisplayServer>` singleton.
  2567. .. rst-class:: classref-item-separator
  2568. ----
  2569. .. _class_@GlobalScope_property_EditorInterface:
  2570. .. rst-class:: classref-property
  2571. :ref:`EditorInterface<class_EditorInterface>` **EditorInterface**
  2572. The :ref:`EditorInterface<class_EditorInterface>` singleton.
  2573. \ **Note:** Only available in editor builds.
  2574. .. rst-class:: classref-item-separator
  2575. ----
  2576. .. _class_@GlobalScope_property_Engine:
  2577. .. rst-class:: classref-property
  2578. :ref:`Engine<class_Engine>` **Engine**
  2579. The :ref:`Engine<class_Engine>` singleton.
  2580. .. rst-class:: classref-item-separator
  2581. ----
  2582. .. _class_@GlobalScope_property_EngineDebugger:
  2583. .. rst-class:: classref-property
  2584. :ref:`EngineDebugger<class_EngineDebugger>` **EngineDebugger**
  2585. The :ref:`EngineDebugger<class_EngineDebugger>` singleton.
  2586. .. rst-class:: classref-item-separator
  2587. ----
  2588. .. _class_@GlobalScope_property_GDExtensionManager:
  2589. .. rst-class:: classref-property
  2590. :ref:`GDExtensionManager<class_GDExtensionManager>` **GDExtensionManager**
  2591. The :ref:`GDExtensionManager<class_GDExtensionManager>` singleton.
  2592. .. rst-class:: classref-item-separator
  2593. ----
  2594. .. _class_@GlobalScope_property_Geometry2D:
  2595. .. rst-class:: classref-property
  2596. :ref:`Geometry2D<class_Geometry2D>` **Geometry2D**
  2597. The :ref:`Geometry2D<class_Geometry2D>` singleton.
  2598. .. rst-class:: classref-item-separator
  2599. ----
  2600. .. _class_@GlobalScope_property_Geometry3D:
  2601. .. rst-class:: classref-property
  2602. :ref:`Geometry3D<class_Geometry3D>` **Geometry3D**
  2603. The :ref:`Geometry3D<class_Geometry3D>` singleton.
  2604. .. rst-class:: classref-item-separator
  2605. ----
  2606. .. _class_@GlobalScope_property_GodotSharp:
  2607. .. rst-class:: classref-property
  2608. :ref:`GodotSharp<class_GodotSharp>` **GodotSharp**
  2609. The :ref:`GodotSharp<class_GodotSharp>` singleton.
  2610. .. rst-class:: classref-item-separator
  2611. ----
  2612. .. _class_@GlobalScope_property_IP:
  2613. .. rst-class:: classref-property
  2614. :ref:`IP<class_IP>` **IP**
  2615. The :ref:`IP<class_IP>` singleton.
  2616. .. rst-class:: classref-item-separator
  2617. ----
  2618. .. _class_@GlobalScope_property_Input:
  2619. .. rst-class:: classref-property
  2620. :ref:`Input<class_Input>` **Input**
  2621. The :ref:`Input<class_Input>` singleton.
  2622. .. rst-class:: classref-item-separator
  2623. ----
  2624. .. _class_@GlobalScope_property_InputMap:
  2625. .. rst-class:: classref-property
  2626. :ref:`InputMap<class_InputMap>` **InputMap**
  2627. The :ref:`InputMap<class_InputMap>` singleton.
  2628. .. rst-class:: classref-item-separator
  2629. ----
  2630. .. _class_@GlobalScope_property_JavaClassWrapper:
  2631. .. rst-class:: classref-property
  2632. :ref:`JavaClassWrapper<class_JavaClassWrapper>` **JavaClassWrapper**
  2633. The :ref:`JavaClassWrapper<class_JavaClassWrapper>` singleton.
  2634. \ **Note:** Only implemented on Android.
  2635. .. rst-class:: classref-item-separator
  2636. ----
  2637. .. _class_@GlobalScope_property_JavaScriptBridge:
  2638. .. rst-class:: classref-property
  2639. :ref:`JavaScriptBridge<class_JavaScriptBridge>` **JavaScriptBridge**
  2640. The :ref:`JavaScriptBridge<class_JavaScriptBridge>` singleton.
  2641. \ **Note:** Only implemented on the Web platform.
  2642. .. rst-class:: classref-item-separator
  2643. ----
  2644. .. _class_@GlobalScope_property_Marshalls:
  2645. .. rst-class:: classref-property
  2646. :ref:`Marshalls<class_Marshalls>` **Marshalls**
  2647. The :ref:`Marshalls<class_Marshalls>` singleton.
  2648. .. rst-class:: classref-item-separator
  2649. ----
  2650. .. _class_@GlobalScope_property_NativeMenu:
  2651. .. rst-class:: classref-property
  2652. :ref:`NativeMenu<class_NativeMenu>` **NativeMenu**
  2653. The :ref:`NativeMenu<class_NativeMenu>` singleton.
  2654. \ **Note:** Only implemented on macOS.
  2655. .. rst-class:: classref-item-separator
  2656. ----
  2657. .. _class_@GlobalScope_property_NavigationMeshGenerator:
  2658. .. rst-class:: classref-property
  2659. :ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` **NavigationMeshGenerator**
  2660. The :ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` singleton.
  2661. .. rst-class:: classref-item-separator
  2662. ----
  2663. .. _class_@GlobalScope_property_NavigationServer2D:
  2664. .. rst-class:: classref-property
  2665. :ref:`NavigationServer2D<class_NavigationServer2D>` **NavigationServer2D**
  2666. The :ref:`NavigationServer2D<class_NavigationServer2D>` singleton.
  2667. .. rst-class:: classref-item-separator
  2668. ----
  2669. .. _class_@GlobalScope_property_NavigationServer3D:
  2670. .. rst-class:: classref-property
  2671. :ref:`NavigationServer3D<class_NavigationServer3D>` **NavigationServer3D**
  2672. The :ref:`NavigationServer3D<class_NavigationServer3D>` singleton.
  2673. .. rst-class:: classref-item-separator
  2674. ----
  2675. .. _class_@GlobalScope_property_OS:
  2676. .. rst-class:: classref-property
  2677. :ref:`OS<class_OS>` **OS**
  2678. The :ref:`OS<class_OS>` singleton.
  2679. .. rst-class:: classref-item-separator
  2680. ----
  2681. .. _class_@GlobalScope_property_Performance:
  2682. .. rst-class:: classref-property
  2683. :ref:`Performance<class_Performance>` **Performance**
  2684. The :ref:`Performance<class_Performance>` singleton.
  2685. .. rst-class:: classref-item-separator
  2686. ----
  2687. .. _class_@GlobalScope_property_PhysicsServer2D:
  2688. .. rst-class:: classref-property
  2689. :ref:`PhysicsServer2D<class_PhysicsServer2D>` **PhysicsServer2D**
  2690. The :ref:`PhysicsServer2D<class_PhysicsServer2D>` singleton.
  2691. .. rst-class:: classref-item-separator
  2692. ----
  2693. .. _class_@GlobalScope_property_PhysicsServer2DManager:
  2694. .. rst-class:: classref-property
  2695. :ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` **PhysicsServer2DManager**
  2696. The :ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` singleton.
  2697. .. rst-class:: classref-item-separator
  2698. ----
  2699. .. _class_@GlobalScope_property_PhysicsServer3D:
  2700. .. rst-class:: classref-property
  2701. :ref:`PhysicsServer3D<class_PhysicsServer3D>` **PhysicsServer3D**
  2702. The :ref:`PhysicsServer3D<class_PhysicsServer3D>` singleton.
  2703. .. rst-class:: classref-item-separator
  2704. ----
  2705. .. _class_@GlobalScope_property_PhysicsServer3DManager:
  2706. .. rst-class:: classref-property
  2707. :ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` **PhysicsServer3DManager**
  2708. The :ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` singleton.
  2709. .. rst-class:: classref-item-separator
  2710. ----
  2711. .. _class_@GlobalScope_property_ProjectSettings:
  2712. .. rst-class:: classref-property
  2713. :ref:`ProjectSettings<class_ProjectSettings>` **ProjectSettings**
  2714. The :ref:`ProjectSettings<class_ProjectSettings>` singleton.
  2715. .. rst-class:: classref-item-separator
  2716. ----
  2717. .. _class_@GlobalScope_property_RenderingServer:
  2718. .. rst-class:: classref-property
  2719. :ref:`RenderingServer<class_RenderingServer>` **RenderingServer**
  2720. The :ref:`RenderingServer<class_RenderingServer>` singleton.
  2721. .. rst-class:: classref-item-separator
  2722. ----
  2723. .. _class_@GlobalScope_property_ResourceLoader:
  2724. .. rst-class:: classref-property
  2725. :ref:`ResourceLoader<class_ResourceLoader>` **ResourceLoader**
  2726. The :ref:`ResourceLoader<class_ResourceLoader>` singleton.
  2727. .. rst-class:: classref-item-separator
  2728. ----
  2729. .. _class_@GlobalScope_property_ResourceSaver:
  2730. .. rst-class:: classref-property
  2731. :ref:`ResourceSaver<class_ResourceSaver>` **ResourceSaver**
  2732. The :ref:`ResourceSaver<class_ResourceSaver>` singleton.
  2733. .. rst-class:: classref-item-separator
  2734. ----
  2735. .. _class_@GlobalScope_property_ResourceUID:
  2736. .. rst-class:: classref-property
  2737. :ref:`ResourceUID<class_ResourceUID>` **ResourceUID**
  2738. The :ref:`ResourceUID<class_ResourceUID>` singleton.
  2739. .. rst-class:: classref-item-separator
  2740. ----
  2741. .. _class_@GlobalScope_property_TextServerManager:
  2742. .. rst-class:: classref-property
  2743. :ref:`TextServerManager<class_TextServerManager>` **TextServerManager**
  2744. The :ref:`TextServerManager<class_TextServerManager>` singleton.
  2745. .. rst-class:: classref-item-separator
  2746. ----
  2747. .. _class_@GlobalScope_property_ThemeDB:
  2748. .. rst-class:: classref-property
  2749. :ref:`ThemeDB<class_ThemeDB>` **ThemeDB**
  2750. The :ref:`ThemeDB<class_ThemeDB>` singleton.
  2751. .. rst-class:: classref-item-separator
  2752. ----
  2753. .. _class_@GlobalScope_property_Time:
  2754. .. rst-class:: classref-property
  2755. :ref:`Time<class_Time>` **Time**
  2756. The :ref:`Time<class_Time>` singleton.
  2757. .. rst-class:: classref-item-separator
  2758. ----
  2759. .. _class_@GlobalScope_property_TranslationServer:
  2760. .. rst-class:: classref-property
  2761. :ref:`TranslationServer<class_TranslationServer>` **TranslationServer**
  2762. The :ref:`TranslationServer<class_TranslationServer>` singleton.
  2763. .. rst-class:: classref-item-separator
  2764. ----
  2765. .. _class_@GlobalScope_property_WorkerThreadPool:
  2766. .. rst-class:: classref-property
  2767. :ref:`WorkerThreadPool<class_WorkerThreadPool>` **WorkerThreadPool**
  2768. The :ref:`WorkerThreadPool<class_WorkerThreadPool>` singleton.
  2769. .. rst-class:: classref-item-separator
  2770. ----
  2771. .. _class_@GlobalScope_property_XRServer:
  2772. .. rst-class:: classref-property
  2773. :ref:`XRServer<class_XRServer>` **XRServer**
  2774. The :ref:`XRServer<class_XRServer>` singleton.
  2775. .. rst-class:: classref-section-separator
  2776. ----
  2777. .. rst-class:: classref-descriptions-group
  2778. Method Descriptions
  2779. -------------------
  2780. .. _class_@GlobalScope_method_abs:
  2781. .. rst-class:: classref-method
  2782. :ref:`Variant<class_Variant>` **abs**\ (\ x\: :ref:`Variant<class_Variant>`\ )
  2783. 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>`.
  2784. ::
  2785. var a = abs(-1)
  2786. # a is 1
  2787. var b = abs(-1.2)
  2788. # b is 1.2
  2789. var c = abs(Vector2(-3.5, -4))
  2790. # c is (3.5, 4)
  2791. var d = abs(Vector2i(-5, -6))
  2792. # d is (5, 6)
  2793. var e = abs(Vector3(-7, 8.5, -3.8))
  2794. # e is (7, 8.5, 3.8)
  2795. var f = abs(Vector3i(-7, -8, -9))
  2796. # f is (7, 8, 9)
  2797. \ **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>`.
  2798. .. rst-class:: classref-item-separator
  2799. ----
  2800. .. _class_@GlobalScope_method_absf:
  2801. .. rst-class:: classref-method
  2802. :ref:`float<class_float>` **absf**\ (\ x\: :ref:`float<class_float>`\ )
  2803. Returns the absolute value of float parameter ``x`` (i.e. positive value).
  2804. ::
  2805. # a is 1.2
  2806. var a = absf(-1.2)
  2807. .. rst-class:: classref-item-separator
  2808. ----
  2809. .. _class_@GlobalScope_method_absi:
  2810. .. rst-class:: classref-method
  2811. :ref:`int<class_int>` **absi**\ (\ x\: :ref:`int<class_int>`\ )
  2812. Returns the absolute value of int parameter ``x`` (i.e. positive value).
  2813. ::
  2814. # a is 1
  2815. var a = absi(-1)
  2816. .. rst-class:: classref-item-separator
  2817. ----
  2818. .. _class_@GlobalScope_method_acos:
  2819. .. rst-class:: classref-method
  2820. :ref:`float<class_float>` **acos**\ (\ x\: :ref:`float<class_float>`\ )
  2821. 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>`.
  2822. ::
  2823. # c is 0.523599 or 30 degrees if converted with rad_to_deg(c)
  2824. var c = acos(0.866025)
  2825. .. rst-class:: classref-item-separator
  2826. ----
  2827. .. _class_@GlobalScope_method_acosh:
  2828. .. rst-class:: classref-method
  2829. :ref:`float<class_float>` **acosh**\ (\ x\: :ref:`float<class_float>`\ )
  2830. 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>`.
  2831. ::
  2832. var a = acosh(2) # Returns 1.31695789692482
  2833. cosh(a) # Returns 2
  2834. var b = acosh(-1) # Returns 0
  2835. .. rst-class:: classref-item-separator
  2836. ----
  2837. .. _class_@GlobalScope_method_angle_difference:
  2838. .. rst-class:: classref-method
  2839. :ref:`float<class_float>` **angle_difference**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ )
  2840. Returns the difference between the two angles, in the range of ``[-PI, +PI]``. When ``from`` and ``to`` are opposite, returns ``-PI`` if ``from`` is smaller than ``to``, or ``PI`` otherwise.
  2841. .. rst-class:: classref-item-separator
  2842. ----
  2843. .. _class_@GlobalScope_method_asin:
  2844. .. rst-class:: classref-method
  2845. :ref:`float<class_float>` **asin**\ (\ x\: :ref:`float<class_float>`\ )
  2846. 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>`.
  2847. ::
  2848. # s is 0.523599 or 30 degrees if converted with rad_to_deg(s)
  2849. var s = asin(0.5)
  2850. .. rst-class:: classref-item-separator
  2851. ----
  2852. .. _class_@GlobalScope_method_asinh:
  2853. .. rst-class:: classref-method
  2854. :ref:`float<class_float>` **asinh**\ (\ x\: :ref:`float<class_float>`\ )
  2855. 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.
  2856. ::
  2857. var a = asinh(0.9) # Returns 0.8088669356527824
  2858. sinh(a) # Returns 0.9
  2859. .. rst-class:: classref-item-separator
  2860. ----
  2861. .. _class_@GlobalScope_method_atan:
  2862. .. rst-class:: classref-method
  2863. :ref:`float<class_float>` **atan**\ (\ x\: :ref:`float<class_float>`\ )
  2864. Returns the arc tangent of ``x`` in radians. Use it to get the angle from an angle's tangent in trigonometry.
  2865. 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``.
  2866. ::
  2867. var a = atan(0.5) # a is 0.463648
  2868. If ``x`` is between ``-PI / 2`` and ``PI / 2`` (inclusive), ``atan(tan(x))`` is equal to ``x``.
  2869. .. rst-class:: classref-item-separator
  2870. ----
  2871. .. _class_@GlobalScope_method_atan2:
  2872. .. rst-class:: classref-method
  2873. :ref:`float<class_float>` **atan2**\ (\ y\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ )
  2874. 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.
  2875. Important note: The Y coordinate comes first, by convention.
  2876. ::
  2877. var a = atan2(0, -1) # a is 3.141593
  2878. .. rst-class:: classref-item-separator
  2879. ----
  2880. .. _class_@GlobalScope_method_atanh:
  2881. .. rst-class:: classref-method
  2882. :ref:`float<class_float>` **atanh**\ (\ x\: :ref:`float<class_float>`\ )
  2883. 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).
  2884. 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>`.
  2885. ::
  2886. var a = atanh(0.9) # Returns 1.47221948958322
  2887. tanh(a) # Returns 0.9
  2888. var b = atanh(-2) # Returns -inf
  2889. tanh(b) # Returns -1
  2890. .. rst-class:: classref-item-separator
  2891. ----
  2892. .. _class_@GlobalScope_method_bezier_derivative:
  2893. .. rst-class:: classref-method
  2894. :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>`\ )
  2895. 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.
  2896. .. rst-class:: classref-item-separator
  2897. ----
  2898. .. _class_@GlobalScope_method_bezier_interpolate:
  2899. .. rst-class:: classref-method
  2900. :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>`\ )
  2901. 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.
  2902. .. rst-class:: classref-item-separator
  2903. ----
  2904. .. _class_@GlobalScope_method_bytes_to_var:
  2905. .. rst-class:: classref-method
  2906. :ref:`Variant<class_Variant>` **bytes_to_var**\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ )
  2907. Decodes a byte array back to a :ref:`Variant<class_Variant>` value, without decoding objects.
  2908. \ **Note:** If you need object deserialization, see :ref:`bytes_to_var_with_objects<class_@GlobalScope_method_bytes_to_var_with_objects>`.
  2909. .. rst-class:: classref-item-separator
  2910. ----
  2911. .. _class_@GlobalScope_method_bytes_to_var_with_objects:
  2912. .. rst-class:: classref-method
  2913. :ref:`Variant<class_Variant>` **bytes_to_var_with_objects**\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ )
  2914. Decodes a byte array back to a :ref:`Variant<class_Variant>` value. Decoding objects is allowed.
  2915. \ **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).
  2916. .. rst-class:: classref-item-separator
  2917. ----
  2918. .. _class_@GlobalScope_method_ceil:
  2919. .. rst-class:: classref-method
  2920. :ref:`Variant<class_Variant>` **ceil**\ (\ x\: :ref:`Variant<class_Variant>`\ )
  2921. 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>`.
  2922. ::
  2923. var i = ceil(1.45) # i is 2.0
  2924. i = ceil(1.001) # i is 2.0
  2925. See also :ref:`floor<class_@GlobalScope_method_floor>`, :ref:`round<class_@GlobalScope_method_round>`, and :ref:`snapped<class_@GlobalScope_method_snapped>`.
  2926. \ **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>`.
  2927. .. rst-class:: classref-item-separator
  2928. ----
  2929. .. _class_@GlobalScope_method_ceilf:
  2930. .. rst-class:: classref-method
  2931. :ref:`float<class_float>` **ceilf**\ (\ x\: :ref:`float<class_float>`\ )
  2932. Rounds ``x`` upward (towards positive infinity), returning the smallest whole number that is not less than ``x``.
  2933. A type-safe version of :ref:`ceil<class_@GlobalScope_method_ceil>`, returning a :ref:`float<class_float>`.
  2934. .. rst-class:: classref-item-separator
  2935. ----
  2936. .. _class_@GlobalScope_method_ceili:
  2937. .. rst-class:: classref-method
  2938. :ref:`int<class_int>` **ceili**\ (\ x\: :ref:`float<class_float>`\ )
  2939. Rounds ``x`` upward (towards positive infinity), returning the smallest whole number that is not less than ``x``.
  2940. A type-safe version of :ref:`ceil<class_@GlobalScope_method_ceil>`, returning an :ref:`int<class_int>`.
  2941. .. rst-class:: classref-item-separator
  2942. ----
  2943. .. _class_@GlobalScope_method_clamp:
  2944. .. rst-class:: classref-method
  2945. :ref:`Variant<class_Variant>` **clamp**\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ )
  2946. 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.
  2947. ::
  2948. var a = clamp(-10, -1, 5)
  2949. # a is -1
  2950. var b = clamp(8.1, 0.9, 5.5)
  2951. # b is 5.5
  2952. \ **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).
  2953. \ **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.
  2954. .. rst-class:: classref-item-separator
  2955. ----
  2956. .. _class_@GlobalScope_method_clampf:
  2957. .. rst-class:: classref-method
  2958. :ref:`float<class_float>` **clampf**\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ )
  2959. Clamps the ``value``, returning a :ref:`float<class_float>` not less than ``min`` and not more than ``max``.
  2960. ::
  2961. var speed = 42.1
  2962. var a = clampf(speed, 1.0, 20.5) # a is 20.5
  2963. speed = -10.0
  2964. var b = clampf(speed, -1.0, 1.0) # b is -1.0
  2965. .. rst-class:: classref-item-separator
  2966. ----
  2967. .. _class_@GlobalScope_method_clampi:
  2968. .. rst-class:: classref-method
  2969. :ref:`int<class_int>` **clampi**\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ )
  2970. Clamps the ``value``, returning an :ref:`int<class_int>` not less than ``min`` and not more than ``max``.
  2971. ::
  2972. var speed = 42
  2973. var a = clampi(speed, 1, 20) # a is 20
  2974. speed = -10
  2975. var b = clampi(speed, -1, 1) # b is -1
  2976. .. rst-class:: classref-item-separator
  2977. ----
  2978. .. _class_@GlobalScope_method_cos:
  2979. .. rst-class:: classref-method
  2980. :ref:`float<class_float>` **cos**\ (\ angle_rad\: :ref:`float<class_float>`\ )
  2981. Returns the cosine of angle ``angle_rad`` in radians.
  2982. ::
  2983. cos(PI * 2) # Returns 1.0
  2984. cos(PI) # Returns -1.0
  2985. cos(deg_to_rad(90)) # Returns 0.0
  2986. .. rst-class:: classref-item-separator
  2987. ----
  2988. .. _class_@GlobalScope_method_cosh:
  2989. .. rst-class:: classref-method
  2990. :ref:`float<class_float>` **cosh**\ (\ x\: :ref:`float<class_float>`\ )
  2991. Returns the hyperbolic cosine of ``x`` in radians.
  2992. ::
  2993. print(cosh(1)) # Prints 1.543081
  2994. .. rst-class:: classref-item-separator
  2995. ----
  2996. .. _class_@GlobalScope_method_cubic_interpolate:
  2997. .. rst-class:: classref-method
  2998. :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>`\ )
  2999. Cubic interpolates between two values by the factor defined in ``weight`` with ``pre`` and ``post`` values.
  3000. .. rst-class:: classref-item-separator
  3001. ----
  3002. .. _class_@GlobalScope_method_cubic_interpolate_angle:
  3003. .. rst-class:: classref-method
  3004. :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>`\ )
  3005. 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>`.
  3006. .. rst-class:: classref-item-separator
  3007. ----
  3008. .. _class_@GlobalScope_method_cubic_interpolate_angle_in_time:
  3009. .. rst-class:: classref-method
  3010. :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>`\ )
  3011. 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>`.
  3012. It can perform smoother interpolation than :ref:`cubic_interpolate<class_@GlobalScope_method_cubic_interpolate>` by the time values.
  3013. .. rst-class:: classref-item-separator
  3014. ----
  3015. .. _class_@GlobalScope_method_cubic_interpolate_in_time:
  3016. .. rst-class:: classref-method
  3017. :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>`\ )
  3018. Cubic interpolates between two values by the factor defined in ``weight`` with ``pre`` and ``post`` values.
  3019. It can perform smoother interpolation than :ref:`cubic_interpolate<class_@GlobalScope_method_cubic_interpolate>` by the time values.
  3020. .. rst-class:: classref-item-separator
  3021. ----
  3022. .. _class_@GlobalScope_method_db_to_linear:
  3023. .. rst-class:: classref-method
  3024. :ref:`float<class_float>` **db_to_linear**\ (\ db\: :ref:`float<class_float>`\ )
  3025. Converts from decibels to linear energy (audio).
  3026. .. rst-class:: classref-item-separator
  3027. ----
  3028. .. _class_@GlobalScope_method_deg_to_rad:
  3029. .. rst-class:: classref-method
  3030. :ref:`float<class_float>` **deg_to_rad**\ (\ deg\: :ref:`float<class_float>`\ )
  3031. Converts an angle expressed in degrees to radians.
  3032. ::
  3033. var r = deg_to_rad(180) # r is 3.141593
  3034. .. rst-class:: classref-item-separator
  3035. ----
  3036. .. _class_@GlobalScope_method_ease:
  3037. .. rst-class:: classref-method
  3038. :ref:`float<class_float>` **ease**\ (\ x\: :ref:`float<class_float>`, curve\: :ref:`float<class_float>`\ )
  3039. 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:
  3040. ::
  3041. - Lower than -1.0 (exclusive): Ease in-out
  3042. - 1.0: Linear
  3043. - Between -1.0 and 0.0 (exclusive): Ease out-in
  3044. - 0.0: Constant
  3045. - Between 0.0 to 1.0 (exclusive): Ease out
  3046. - 1.0: Linear
  3047. - Greater than 1.0 (exclusive): Ease in
  3048. \ `ease() curve values cheatsheet <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/ease_cheatsheet.png>`__\
  3049. 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>`.
  3050. .. rst-class:: classref-item-separator
  3051. ----
  3052. .. _class_@GlobalScope_method_error_string:
  3053. .. rst-class:: classref-method
  3054. :ref:`String<class_String>` **error_string**\ (\ error\: :ref:`int<class_int>`\ )
  3055. Returns a human-readable name for the given :ref:`Error<enum_@GlobalScope_Error>` code.
  3056. ::
  3057. print(OK) # Prints 0
  3058. print(error_string(OK)) # Prints OK
  3059. print(error_string(ERR_BUSY)) # Prints Busy
  3060. print(error_string(ERR_OUT_OF_MEMORY)) # Prints Out of memory
  3061. .. rst-class:: classref-item-separator
  3062. ----
  3063. .. _class_@GlobalScope_method_exp:
  3064. .. rst-class:: classref-method
  3065. :ref:`float<class_float>` **exp**\ (\ x\: :ref:`float<class_float>`\ )
  3066. The natural exponential function. It raises the mathematical constant *e* to the power of ``x`` and returns it.
  3067. \ *e* has an approximate value of 2.71828, and can be obtained with ``exp(1)``.
  3068. For exponents to other bases use the method :ref:`pow<class_@GlobalScope_method_pow>`.
  3069. ::
  3070. var a = exp(2) # Approximately 7.39
  3071. .. rst-class:: classref-item-separator
  3072. ----
  3073. .. _class_@GlobalScope_method_floor:
  3074. .. rst-class:: classref-method
  3075. :ref:`Variant<class_Variant>` **floor**\ (\ x\: :ref:`Variant<class_Variant>`\ )
  3076. 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>`.
  3077. ::
  3078. var a = floor(2.99) # a is 2.0
  3079. a = floor(-2.99) # a is -3.0
  3080. See also :ref:`ceil<class_@GlobalScope_method_ceil>`, :ref:`round<class_@GlobalScope_method_round>`, and :ref:`snapped<class_@GlobalScope_method_snapped>`.
  3081. \ **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>`.
  3082. .. rst-class:: classref-item-separator
  3083. ----
  3084. .. _class_@GlobalScope_method_floorf:
  3085. .. rst-class:: classref-method
  3086. :ref:`float<class_float>` **floorf**\ (\ x\: :ref:`float<class_float>`\ )
  3087. Rounds ``x`` downward (towards negative infinity), returning the largest whole number that is not more than ``x``.
  3088. A type-safe version of :ref:`floor<class_@GlobalScope_method_floor>`, returning a :ref:`float<class_float>`.
  3089. .. rst-class:: classref-item-separator
  3090. ----
  3091. .. _class_@GlobalScope_method_floori:
  3092. .. rst-class:: classref-method
  3093. :ref:`int<class_int>` **floori**\ (\ x\: :ref:`float<class_float>`\ )
  3094. Rounds ``x`` downward (towards negative infinity), returning the largest whole number that is not more than ``x``.
  3095. A type-safe version of :ref:`floor<class_@GlobalScope_method_floor>`, returning an :ref:`int<class_int>`.
  3096. \ **Note:** This function is *not* the same as ``int(x)``, which rounds towards 0.
  3097. .. rst-class:: classref-item-separator
  3098. ----
  3099. .. _class_@GlobalScope_method_fmod:
  3100. .. rst-class:: classref-method
  3101. :ref:`float<class_float>` **fmod**\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ )
  3102. Returns the floating-point remainder of ``x`` divided by ``y``, keeping the sign of ``x``.
  3103. ::
  3104. var remainder = fmod(7, 5.5) # remainder is 1.5
  3105. For the integer remainder operation, use the ``%`` operator.
  3106. .. rst-class:: classref-item-separator
  3107. ----
  3108. .. _class_@GlobalScope_method_fposmod:
  3109. .. rst-class:: classref-method
  3110. :ref:`float<class_float>` **fposmod**\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ )
  3111. Returns the floating-point modulus of ``x`` divided by ``y``, wrapping equally in positive and negative.
  3112. ::
  3113. print(" (x) (fmod(x, 1.5)) (fposmod(x, 1.5))")
  3114. for i in 7:
  3115. var x = i * 0.5 - 1.5
  3116. print("%4.1f %4.1f | %4.1f" % [x, fmod(x, 1.5), fposmod(x, 1.5)])
  3117. Produces:
  3118. ::
  3119. (x) (fmod(x, 1.5)) (fposmod(x, 1.5))
  3120. -1.5 -0.0 | 0.0
  3121. -1.0 -1.0 | 0.5
  3122. -0.5 -0.5 | 1.0
  3123. 0.0 0.0 | 0.0
  3124. 0.5 0.5 | 0.5
  3125. 1.0 1.0 | 1.0
  3126. 1.5 0.0 | 0.0
  3127. .. rst-class:: classref-item-separator
  3128. ----
  3129. .. _class_@GlobalScope_method_hash:
  3130. .. rst-class:: classref-method
  3131. :ref:`int<class_int>` **hash**\ (\ variable\: :ref:`Variant<class_Variant>`\ )
  3132. Returns the integer hash of the passed ``variable``.
  3133. .. tabs::
  3134. .. code-tab:: gdscript
  3135. print(hash("a")) # Prints 177670
  3136. .. code-tab:: csharp
  3137. GD.Print(GD.Hash("a")); // Prints 177670
  3138. .. rst-class:: classref-item-separator
  3139. ----
  3140. .. _class_@GlobalScope_method_instance_from_id:
  3141. .. rst-class:: classref-method
  3142. :ref:`Object<class_Object>` **instance_from_id**\ (\ instance_id\: :ref:`int<class_int>`\ )
  3143. 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>`.
  3144. .. tabs::
  3145. .. code-tab:: gdscript
  3146. var foo = "bar"
  3147. func _ready():
  3148. var id = get_instance_id()
  3149. var inst = instance_from_id(id)
  3150. print(inst.foo) # Prints bar
  3151. .. code-tab:: csharp
  3152. public partial class MyNode : Node
  3153. {
  3154. public string Foo { get; set; } = "bar";
  3155. public override void _Ready()
  3156. {
  3157. ulong id = GetInstanceId();
  3158. var inst = (MyNode)InstanceFromId(Id);
  3159. GD.Print(inst.Foo); // Prints bar
  3160. }
  3161. }
  3162. .. rst-class:: classref-item-separator
  3163. ----
  3164. .. _class_@GlobalScope_method_inverse_lerp:
  3165. .. rst-class:: classref-method
  3166. :ref:`float<class_float>` **inverse_lerp**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ )
  3167. 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.
  3168. ::
  3169. # The interpolation ratio in the `lerp()` call below is 0.75.
  3170. var middle = lerp(20, 30, 0.75)
  3171. # middle is now 27.5.
  3172. # Now, we pretend to have forgotten the original ratio and want to get it back.
  3173. var ratio = inverse_lerp(20, 30, 27.5)
  3174. # ratio is now 0.75.
  3175. 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.
  3176. .. rst-class:: classref-item-separator
  3177. ----
  3178. .. _class_@GlobalScope_method_is_equal_approx:
  3179. .. rst-class:: classref-method
  3180. :ref:`bool<class_bool>` **is_equal_approx**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ )
  3181. Returns ``true`` if ``a`` and ``b`` are approximately equal to each other.
  3182. 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.
  3183. Infinity values of the same sign are considered equal.
  3184. .. rst-class:: classref-item-separator
  3185. ----
  3186. .. _class_@GlobalScope_method_is_finite:
  3187. .. rst-class:: classref-method
  3188. :ref:`bool<class_bool>` **is_finite**\ (\ x\: :ref:`float<class_float>`\ )
  3189. Returns whether ``x`` is a finite value, i.e. it is not :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`, positive infinity, or negative infinity.
  3190. .. rst-class:: classref-item-separator
  3191. ----
  3192. .. _class_@GlobalScope_method_is_inf:
  3193. .. rst-class:: classref-method
  3194. :ref:`bool<class_bool>` **is_inf**\ (\ x\: :ref:`float<class_float>`\ )
  3195. Returns ``true`` if ``x`` is either positive infinity or negative infinity.
  3196. .. rst-class:: classref-item-separator
  3197. ----
  3198. .. _class_@GlobalScope_method_is_instance_id_valid:
  3199. .. rst-class:: classref-method
  3200. :ref:`bool<class_bool>` **is_instance_id_valid**\ (\ id\: :ref:`int<class_int>`\ )
  3201. 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.
  3202. .. rst-class:: classref-item-separator
  3203. ----
  3204. .. _class_@GlobalScope_method_is_instance_valid:
  3205. .. rst-class:: classref-method
  3206. :ref:`bool<class_bool>` **is_instance_valid**\ (\ instance\: :ref:`Variant<class_Variant>`\ )
  3207. Returns ``true`` if ``instance`` is a valid Object (e.g. has not been deleted from memory).
  3208. .. rst-class:: classref-item-separator
  3209. ----
  3210. .. _class_@GlobalScope_method_is_nan:
  3211. .. rst-class:: classref-method
  3212. :ref:`bool<class_bool>` **is_nan**\ (\ x\: :ref:`float<class_float>`\ )
  3213. Returns ``true`` if ``x`` is a NaN ("Not a Number" or invalid) value.
  3214. .. rst-class:: classref-item-separator
  3215. ----
  3216. .. _class_@GlobalScope_method_is_same:
  3217. .. rst-class:: classref-method
  3218. :ref:`bool<class_bool>` **is_same**\ (\ a\: :ref:`Variant<class_Variant>`, b\: :ref:`Variant<class_Variant>`\ )
  3219. 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.
  3220. ::
  3221. # Vector2 is a value type
  3222. var vec2_a = Vector2(0, 0)
  3223. var vec2_b = Vector2(0, 0)
  3224. var vec2_c = Vector2(1, 1)
  3225. is_same(vec2_a, vec2_a) # true
  3226. is_same(vec2_a, vec2_b) # true
  3227. is_same(vec2_a, vec2_c) # false
  3228. # Array is a reference type
  3229. var arr_a = []
  3230. var arr_b = []
  3231. is_same(arr_a, arr_a) # true
  3232. is_same(arr_a, arr_b) # false
  3233. 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>`.
  3234. 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>` and :ref:`PackedColorArray<class_PackedColorArray>`.
  3235. .. rst-class:: classref-item-separator
  3236. ----
  3237. .. _class_@GlobalScope_method_is_zero_approx:
  3238. .. rst-class:: classref-method
  3239. :ref:`bool<class_bool>` **is_zero_approx**\ (\ x\: :ref:`float<class_float>`\ )
  3240. Returns ``true`` if ``x`` is zero or almost zero. The comparison is done using a tolerance calculation with a small internal epsilon.
  3241. This function is faster than using :ref:`is_equal_approx<class_@GlobalScope_method_is_equal_approx>` with one value as zero.
  3242. .. rst-class:: classref-item-separator
  3243. ----
  3244. .. _class_@GlobalScope_method_lerp:
  3245. .. rst-class:: classref-method
  3246. :ref:`Variant<class_Variant>` **lerp**\ (\ from\: :ref:`Variant<class_Variant>`, to\: :ref:`Variant<class_Variant>`, weight\: :ref:`Variant<class_Variant>`\ )
  3247. 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:`clamp<class_@GlobalScope_method_clamp>` on the result of this function.
  3248. 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>`.
  3249. ::
  3250. lerp(0, 4, 0.75) # Returns 3.0
  3251. 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.
  3252. \ **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>` or :ref:`Basis.slerp<class_Basis_method_slerp>`.
  3253. .. rst-class:: classref-item-separator
  3254. ----
  3255. .. _class_@GlobalScope_method_lerp_angle:
  3256. .. rst-class:: classref-method
  3257. :ref:`float<class_float>` **lerp_angle**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ )
  3258. Linearly interpolates between two angles (in radians) by a ``weight`` value between 0.0 and 1.0.
  3259. 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>`.
  3260. ::
  3261. extends Sprite
  3262. var elapsed = 0.0
  3263. func _process(delta):
  3264. var min_angle = deg_to_rad(0.0)
  3265. var max_angle = deg_to_rad(90.0)
  3266. rotation = lerp_angle(min_angle, max_angle, elapsed)
  3267. elapsed += delta
  3268. \ **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.
  3269. .. rst-class:: classref-item-separator
  3270. ----
  3271. .. _class_@GlobalScope_method_lerpf:
  3272. .. rst-class:: classref-method
  3273. :ref:`float<class_float>` **lerpf**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ )
  3274. 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.
  3275. ::
  3276. lerpf(0, 4, 0.75) # Returns 3.0
  3277. 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>`.
  3278. .. rst-class:: classref-item-separator
  3279. ----
  3280. .. _class_@GlobalScope_method_linear_to_db:
  3281. .. rst-class:: classref-method
  3282. :ref:`float<class_float>` **linear_to_db**\ (\ lin\: :ref:`float<class_float>`\ )
  3283. Converts from linear energy to decibels (audio). This can be used to implement volume sliders that behave as expected (since volume isn't linear).
  3284. \ **Example:**\
  3285. ::
  3286. # "Slider" refers to a node that inherits Range such as HSlider or VSlider.
  3287. # Its range must be configured to go from 0 to 1.
  3288. # Change the bus name if you'd like to change the volume of a specific bus only.
  3289. AudioServer.set_bus_volume_db(AudioServer.get_bus_index("Master"), linear_to_db($Slider.value))
  3290. .. rst-class:: classref-item-separator
  3291. ----
  3292. .. _class_@GlobalScope_method_log:
  3293. .. rst-class:: classref-method
  3294. :ref:`float<class_float>` **log**\ (\ x\: :ref:`float<class_float>`\ )
  3295. 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.
  3296. \ **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)``.
  3297. ::
  3298. log(10) # Returns 2.302585
  3299. \ **Note:** The logarithm of ``0`` returns ``-inf``, while negative values return ``-nan``.
  3300. .. rst-class:: classref-item-separator
  3301. ----
  3302. .. _class_@GlobalScope_method_max:
  3303. .. rst-class:: classref-method
  3304. :ref:`Variant<class_Variant>` **max**\ (\ ...\ ) |vararg|
  3305. Returns the maximum of the given numeric values. This function can take any number of arguments.
  3306. ::
  3307. max(1, 7, 3, -6, 5) # Returns 7
  3308. .. rst-class:: classref-item-separator
  3309. ----
  3310. .. _class_@GlobalScope_method_maxf:
  3311. .. rst-class:: classref-method
  3312. :ref:`float<class_float>` **maxf**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ )
  3313. Returns the maximum of two :ref:`float<class_float>` values.
  3314. ::
  3315. maxf(3.6, 24) # Returns 24.0
  3316. maxf(-3.99, -4) # Returns -3.99
  3317. .. rst-class:: classref-item-separator
  3318. ----
  3319. .. _class_@GlobalScope_method_maxi:
  3320. .. rst-class:: classref-method
  3321. :ref:`int<class_int>` **maxi**\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ )
  3322. Returns the maximum of two :ref:`int<class_int>` values.
  3323. ::
  3324. maxi(1, 2) # Returns 2
  3325. maxi(-3, -4) # Returns -3
  3326. .. rst-class:: classref-item-separator
  3327. ----
  3328. .. _class_@GlobalScope_method_min:
  3329. .. rst-class:: classref-method
  3330. :ref:`Variant<class_Variant>` **min**\ (\ ...\ ) |vararg|
  3331. Returns the minimum of the given numeric values. This function can take any number of arguments.
  3332. ::
  3333. min(1, 7, 3, -6, 5) # Returns -6
  3334. .. rst-class:: classref-item-separator
  3335. ----
  3336. .. _class_@GlobalScope_method_minf:
  3337. .. rst-class:: classref-method
  3338. :ref:`float<class_float>` **minf**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ )
  3339. Returns the minimum of two :ref:`float<class_float>` values.
  3340. ::
  3341. minf(3.6, 24) # Returns 3.6
  3342. minf(-3.99, -4) # Returns -4.0
  3343. .. rst-class:: classref-item-separator
  3344. ----
  3345. .. _class_@GlobalScope_method_mini:
  3346. .. rst-class:: classref-method
  3347. :ref:`int<class_int>` **mini**\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ )
  3348. Returns the minimum of two :ref:`int<class_int>` values.
  3349. ::
  3350. mini(1, 2) # Returns 1
  3351. mini(-3, -4) # Returns -4
  3352. .. rst-class:: classref-item-separator
  3353. ----
  3354. .. _class_@GlobalScope_method_move_toward:
  3355. .. rst-class:: classref-method
  3356. :ref:`float<class_float>` **move_toward**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ )
  3357. Moves ``from`` toward ``to`` by the ``delta`` amount. Will not go past ``to``.
  3358. Use a negative ``delta`` value to move away.
  3359. ::
  3360. move_toward(5, 10, 4) # Returns 9
  3361. move_toward(10, 5, 4) # Returns 6
  3362. move_toward(5, 10, 9) # Returns 10
  3363. move_toward(10, 5, -1.5) # Returns 11.5
  3364. .. rst-class:: classref-item-separator
  3365. ----
  3366. .. _class_@GlobalScope_method_nearest_po2:
  3367. .. rst-class:: classref-method
  3368. :ref:`int<class_int>` **nearest_po2**\ (\ value\: :ref:`int<class_int>`\ )
  3369. Returns the smallest integer power of 2 that is greater than or equal to ``value``.
  3370. ::
  3371. nearest_po2(3) # Returns 4
  3372. nearest_po2(4) # Returns 4
  3373. nearest_po2(5) # Returns 8
  3374. nearest_po2(0) # Returns 0 (this may not be expected)
  3375. nearest_po2(-1) # Returns 0 (this may not be expected)
  3376. \ **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.
  3377. .. rst-class:: classref-item-separator
  3378. ----
  3379. .. _class_@GlobalScope_method_pingpong:
  3380. .. rst-class:: classref-method
  3381. :ref:`float<class_float>` **pingpong**\ (\ value\: :ref:`float<class_float>`, length\: :ref:`float<class_float>`\ )
  3382. 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.
  3383. ::
  3384. pingpong(-3.0, 3.0) # Returns 3.0
  3385. pingpong(-2.0, 3.0) # Returns 2.0
  3386. pingpong(-1.0, 3.0) # Returns 1.0
  3387. pingpong(0.0, 3.0) # Returns 0.0
  3388. pingpong(1.0, 3.0) # Returns 1.0
  3389. pingpong(2.0, 3.0) # Returns 2.0
  3390. pingpong(3.0, 3.0) # Returns 3.0
  3391. pingpong(4.0, 3.0) # Returns 2.0
  3392. pingpong(5.0, 3.0) # Returns 1.0
  3393. pingpong(6.0, 3.0) # Returns 0.0
  3394. .. rst-class:: classref-item-separator
  3395. ----
  3396. .. _class_@GlobalScope_method_posmod:
  3397. .. rst-class:: classref-method
  3398. :ref:`int<class_int>` **posmod**\ (\ x\: :ref:`int<class_int>`, y\: :ref:`int<class_int>`\ )
  3399. Returns the integer modulus of ``x`` divided by ``y`` that wraps equally in positive and negative.
  3400. ::
  3401. print("#(i) (i % 3) (posmod(i, 3))")
  3402. for i in range(-3, 4):
  3403. print("%2d %2d | %2d" % [i, i % 3, posmod(i, 3)])
  3404. Produces:
  3405. ::
  3406. (i) (i % 3) (posmod(i, 3))
  3407. -3 0 | 0
  3408. -2 -2 | 1
  3409. -1 -1 | 2
  3410. 0 0 | 0
  3411. 1 1 | 1
  3412. 2 2 | 2
  3413. 3 0 | 0
  3414. .. rst-class:: classref-item-separator
  3415. ----
  3416. .. _class_@GlobalScope_method_pow:
  3417. .. rst-class:: classref-method
  3418. :ref:`float<class_float>` **pow**\ (\ base\: :ref:`float<class_float>`, exp\: :ref:`float<class_float>`\ )
  3419. Returns the result of ``base`` raised to the power of ``exp``.
  3420. In GDScript, this is the equivalent of the ``**`` operator.
  3421. ::
  3422. pow(2, 5) # Returns 32.0
  3423. pow(4, 1.5) # Returns 8.0
  3424. .. rst-class:: classref-item-separator
  3425. ----
  3426. .. _class_@GlobalScope_method_print:
  3427. .. rst-class:: classref-method
  3428. |void| **print**\ (\ ...\ ) |vararg|
  3429. Converts one or more arguments of any type to string in the best way possible and prints them to the console.
  3430. .. tabs::
  3431. .. code-tab:: gdscript
  3432. var a = [1, 2, 3]
  3433. print("a", "b", a) # Prints ab[1, 2, 3]
  3434. .. code-tab:: csharp
  3435. var a = new Godot.Collections.Array { 1, 2, 3 };
  3436. GD.Print("a", "b", a); // Prints ab[1, 2, 3]
  3437. \ **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.
  3438. .. rst-class:: classref-item-separator
  3439. ----
  3440. .. _class_@GlobalScope_method_print_rich:
  3441. .. rst-class:: classref-method
  3442. |void| **print_rich**\ (\ ...\ ) |vararg|
  3443. Converts one or more arguments of any type to string in the best way possible and prints them to the console.
  3444. The following BBCode tags are supported: ``b``, ``i``, ``u``, ``s``, ``indent``, ``code``, ``url``, ``center``, ``right``, ``color``, ``bgcolor``, ``fgcolor``.
  3445. 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.
  3446. URL tags only support URLs wrapped by a URL tag, not URLs with a different title.
  3447. 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.
  3448. .. tabs::
  3449. .. code-tab:: gdscript
  3450. print_rich("[color=green][b]Hello world![/b][/color]") # Prints out "Hello world!" in green with a bold font
  3451. .. code-tab:: csharp
  3452. GD.PrintRich("[color=green][b]Hello world![/b][/color]"); // Prints out "Hello world!" in green with a bold font
  3453. \ **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.
  3454. \ **Note:** On Windows, only Windows 10 and later correctly displays ANSI escape codes in standard output.
  3455. \ **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.
  3456. .. rst-class:: classref-item-separator
  3457. ----
  3458. .. _class_@GlobalScope_method_print_verbose:
  3459. .. rst-class:: classref-method
  3460. |void| **print_verbose**\ (\ ...\ ) |vararg|
  3461. 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.
  3462. .. rst-class:: classref-item-separator
  3463. ----
  3464. .. _class_@GlobalScope_method_printerr:
  3465. .. rst-class:: classref-method
  3466. |void| **printerr**\ (\ ...\ ) |vararg|
  3467. Prints one or more arguments to strings in the best way possible to standard error line.
  3468. .. tabs::
  3469. .. code-tab:: gdscript
  3470. printerr("prints to stderr")
  3471. .. code-tab:: csharp
  3472. GD.PrintErr("prints to stderr");
  3473. .. rst-class:: classref-item-separator
  3474. ----
  3475. .. _class_@GlobalScope_method_printraw:
  3476. .. rst-class:: classref-method
  3477. |void| **printraw**\ (\ ...\ ) |vararg|
  3478. 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.
  3479. .. tabs::
  3480. .. code-tab:: gdscript
  3481. printraw("A")
  3482. printraw("B")
  3483. printraw("C")
  3484. # Prints ABC to terminal
  3485. .. code-tab:: csharp
  3486. GD.PrintRaw("A");
  3487. GD.PrintRaw("B");
  3488. GD.PrintRaw("C");
  3489. // Prints ABC to terminal
  3490. .. rst-class:: classref-item-separator
  3491. ----
  3492. .. _class_@GlobalScope_method_prints:
  3493. .. rst-class:: classref-method
  3494. |void| **prints**\ (\ ...\ ) |vararg|
  3495. Prints one or more arguments to the console with a space between each argument.
  3496. .. tabs::
  3497. .. code-tab:: gdscript
  3498. prints("A", "B", "C") # Prints A B C
  3499. .. code-tab:: csharp
  3500. GD.PrintS("A", "B", "C"); // Prints A B C
  3501. .. rst-class:: classref-item-separator
  3502. ----
  3503. .. _class_@GlobalScope_method_printt:
  3504. .. rst-class:: classref-method
  3505. |void| **printt**\ (\ ...\ ) |vararg|
  3506. Prints one or more arguments to the console with a tab between each argument.
  3507. .. tabs::
  3508. .. code-tab:: gdscript
  3509. printt("A", "B", "C") # Prints A B C
  3510. .. code-tab:: csharp
  3511. GD.PrintT("A", "B", "C"); // Prints A B C
  3512. .. rst-class:: classref-item-separator
  3513. ----
  3514. .. _class_@GlobalScope_method_push_error:
  3515. .. rst-class:: classref-method
  3516. |void| **push_error**\ (\ ...\ ) |vararg|
  3517. Pushes an error message to Godot's built-in debugger and to the OS terminal.
  3518. .. tabs::
  3519. .. code-tab:: gdscript
  3520. push_error("test error") # Prints "test error" to debugger and terminal as error call
  3521. .. code-tab:: csharp
  3522. GD.PushError("test error"); // Prints "test error" to debugger and terminal as error call
  3523. \ **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.
  3524. .. rst-class:: classref-item-separator
  3525. ----
  3526. .. _class_@GlobalScope_method_push_warning:
  3527. .. rst-class:: classref-method
  3528. |void| **push_warning**\ (\ ...\ ) |vararg|
  3529. Pushes a warning message to Godot's built-in debugger and to the OS terminal.
  3530. .. tabs::
  3531. .. code-tab:: gdscript
  3532. push_warning("test warning") # Prints "test warning" to debugger and terminal as warning call
  3533. .. code-tab:: csharp
  3534. GD.PushWarning("test warning"); // Prints "test warning" to debugger and terminal as warning call
  3535. .. rst-class:: classref-item-separator
  3536. ----
  3537. .. _class_@GlobalScope_method_rad_to_deg:
  3538. .. rst-class:: classref-method
  3539. :ref:`float<class_float>` **rad_to_deg**\ (\ rad\: :ref:`float<class_float>`\ )
  3540. Converts an angle expressed in radians to degrees.
  3541. ::
  3542. rad_to_deg(0.523599) # Returns 30
  3543. rad_to_deg(PI) # Returns 180
  3544. rad_to_deg(PI * 2) # Returns 360
  3545. .. rst-class:: classref-item-separator
  3546. ----
  3547. .. _class_@GlobalScope_method_rand_from_seed:
  3548. .. rst-class:: classref-method
  3549. :ref:`PackedInt64Array<class_PackedInt64Array>` **rand_from_seed**\ (\ seed\: :ref:`int<class_int>`\ )
  3550. 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.
  3551. \ **Note:** "Seed" here refers to the internal state of the pseudo random number generator, currently implemented as a 64 bit integer.
  3552. ::
  3553. var a = rand_from_seed(4)
  3554. print(a[0]) # Prints 2879024997
  3555. print(a[1]) # Prints 4
  3556. .. rst-class:: classref-item-separator
  3557. ----
  3558. .. _class_@GlobalScope_method_randf:
  3559. .. rst-class:: classref-method
  3560. :ref:`float<class_float>` **randf**\ (\ )
  3561. Returns a random floating-point value between ``0.0`` and ``1.0`` (inclusive).
  3562. .. tabs::
  3563. .. code-tab:: gdscript
  3564. randf() # Returns e.g. 0.375671
  3565. .. code-tab:: csharp
  3566. GD.Randf(); // Returns e.g. 0.375671
  3567. .. rst-class:: classref-item-separator
  3568. ----
  3569. .. _class_@GlobalScope_method_randf_range:
  3570. .. rst-class:: classref-method
  3571. :ref:`float<class_float>` **randf_range**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ )
  3572. Returns a random floating-point value between ``from`` and ``to`` (inclusive).
  3573. .. tabs::
  3574. .. code-tab:: gdscript
  3575. randf_range(0, 20.5) # Returns e.g. 7.45315
  3576. randf_range(-10, 10) # Returns e.g. -3.844535
  3577. .. code-tab:: csharp
  3578. GD.RandRange(0.0, 20.5); // Returns e.g. 7.45315
  3579. GD.RandRange(-10.0, 10.0); // Returns e.g. -3.844535
  3580. .. rst-class:: classref-item-separator
  3581. ----
  3582. .. _class_@GlobalScope_method_randfn:
  3583. .. rst-class:: classref-method
  3584. :ref:`float<class_float>` **randfn**\ (\ mean\: :ref:`float<class_float>`, deviation\: :ref:`float<class_float>`\ )
  3585. 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.
  3586. \ **Note:** This method uses the `Box-Muller transform <https://en.wikipedia.org/wiki/Box%E2%80%93Muller_transform>`__ algorithm.
  3587. .. rst-class:: classref-item-separator
  3588. ----
  3589. .. _class_@GlobalScope_method_randi:
  3590. .. rst-class:: classref-method
  3591. :ref:`int<class_int>` **randi**\ (\ )
  3592. 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).
  3593. .. tabs::
  3594. .. code-tab:: gdscript
  3595. randi() # Returns random integer between 0 and 2^32 - 1
  3596. randi() % 20 # Returns random integer between 0 and 19
  3597. randi() % 100 # Returns random integer between 0 and 99
  3598. randi() % 100 + 1 # Returns random integer between 1 and 100
  3599. .. code-tab:: csharp
  3600. GD.Randi(); // Returns random integer between 0 and 2^32 - 1
  3601. GD.Randi() % 20; // Returns random integer between 0 and 19
  3602. GD.Randi() % 100; // Returns random integer between 0 and 99
  3603. GD.Randi() % 100 + 1; // Returns random integer between 1 and 100
  3604. .. rst-class:: classref-item-separator
  3605. ----
  3606. .. _class_@GlobalScope_method_randi_range:
  3607. .. rst-class:: classref-method
  3608. :ref:`int<class_int>` **randi_range**\ (\ from\: :ref:`int<class_int>`, to\: :ref:`int<class_int>`\ )
  3609. Returns a random signed 32-bit integer between ``from`` and ``to`` (inclusive). If ``to`` is lesser than ``from``, they are swapped.
  3610. .. tabs::
  3611. .. code-tab:: gdscript
  3612. randi_range(0, 1) # Returns either 0 or 1
  3613. randi_range(-10, 1000) # Returns random integer between -10 and 1000
  3614. .. code-tab:: csharp
  3615. GD.RandRange(0, 1); // Returns either 0 or 1
  3616. GD.RandRange(-10, 1000); // Returns random integer between -10 and 1000
  3617. .. rst-class:: classref-item-separator
  3618. ----
  3619. .. _class_@GlobalScope_method_randomize:
  3620. .. rst-class:: classref-method
  3621. |void| **randomize**\ (\ )
  3622. Randomizes the seed (or the internal state) of the random number generator. The current implementation uses a number based on the device's time.
  3623. \ **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.
  3624. .. rst-class:: classref-item-separator
  3625. ----
  3626. .. _class_@GlobalScope_method_remap:
  3627. .. rst-class:: classref-method
  3628. :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>`\ )
  3629. 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.
  3630. ::
  3631. remap(75, 0, 100, -1, 1) # Returns 0.5
  3632. For complex use cases where multiple ranges are needed, consider using :ref:`Curve<class_Curve>` or :ref:`Gradient<class_Gradient>` instead.
  3633. .. rst-class:: classref-item-separator
  3634. ----
  3635. .. _class_@GlobalScope_method_rid_allocate_id:
  3636. .. rst-class:: classref-method
  3637. :ref:`int<class_int>` **rid_allocate_id**\ (\ )
  3638. 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.
  3639. .. rst-class:: classref-item-separator
  3640. ----
  3641. .. _class_@GlobalScope_method_rid_from_int64:
  3642. .. rst-class:: classref-method
  3643. :ref:`RID<class_RID>` **rid_from_int64**\ (\ base\: :ref:`int<class_int>`\ )
  3644. Creates an RID from a ``base``. This is used mainly from native extensions to build servers.
  3645. .. rst-class:: classref-item-separator
  3646. ----
  3647. .. _class_@GlobalScope_method_rotate_toward:
  3648. .. rst-class:: classref-method
  3649. :ref:`float<class_float>` **rotate_toward**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ )
  3650. Rotates ``from`` toward ``to`` by the ``delta`` amount. Will not go past ``to``.
  3651. 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>`.
  3652. If ``delta`` is negative, this function will rotate away from ``to``, toward the opposite angle, and will not go past the opposite angle.
  3653. .. rst-class:: classref-item-separator
  3654. ----
  3655. .. _class_@GlobalScope_method_round:
  3656. .. rst-class:: classref-method
  3657. :ref:`Variant<class_Variant>` **round**\ (\ x\: :ref:`Variant<class_Variant>`\ )
  3658. 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>`.
  3659. ::
  3660. round(2.4) # Returns 2
  3661. round(2.5) # Returns 3
  3662. round(2.6) # Returns 3
  3663. See also :ref:`floor<class_@GlobalScope_method_floor>`, :ref:`ceil<class_@GlobalScope_method_ceil>`, and :ref:`snapped<class_@GlobalScope_method_snapped>`.
  3664. \ **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>`.
  3665. .. rst-class:: classref-item-separator
  3666. ----
  3667. .. _class_@GlobalScope_method_roundf:
  3668. .. rst-class:: classref-method
  3669. :ref:`float<class_float>` **roundf**\ (\ x\: :ref:`float<class_float>`\ )
  3670. Rounds ``x`` to the nearest whole number, with halfway cases rounded away from 0.
  3671. A type-safe version of :ref:`round<class_@GlobalScope_method_round>`, returning a :ref:`float<class_float>`.
  3672. .. rst-class:: classref-item-separator
  3673. ----
  3674. .. _class_@GlobalScope_method_roundi:
  3675. .. rst-class:: classref-method
  3676. :ref:`int<class_int>` **roundi**\ (\ x\: :ref:`float<class_float>`\ )
  3677. Rounds ``x`` to the nearest whole number, with halfway cases rounded away from 0.
  3678. A type-safe version of :ref:`round<class_@GlobalScope_method_round>`, returning an :ref:`int<class_int>`.
  3679. .. rst-class:: classref-item-separator
  3680. ----
  3681. .. _class_@GlobalScope_method_seed:
  3682. .. rst-class:: classref-method
  3683. |void| **seed**\ (\ base\: :ref:`int<class_int>`\ )
  3684. Sets the seed for the random number generator to ``base``. Setting the seed manually can ensure consistent, repeatable results for most random functions.
  3685. .. tabs::
  3686. .. code-tab:: gdscript
  3687. var my_seed = "Godot Rocks".hash()
  3688. seed(my_seed)
  3689. var a = randf() + randi()
  3690. seed(my_seed)
  3691. var b = randf() + randi()
  3692. # a and b are now identical
  3693. .. code-tab:: csharp
  3694. ulong mySeed = (ulong)GD.Hash("Godot Rocks");
  3695. GD.Seed(mySeed);
  3696. var a = GD.Randf() + GD.Randi();
  3697. GD.Seed(mySeed);
  3698. var b = GD.Randf() + GD.Randi();
  3699. // a and b are now identical
  3700. .. rst-class:: classref-item-separator
  3701. ----
  3702. .. _class_@GlobalScope_method_sign:
  3703. .. rst-class:: classref-method
  3704. :ref:`Variant<class_Variant>` **sign**\ (\ x\: :ref:`Variant<class_Variant>`\ )
  3705. 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.
  3706. 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>`.
  3707. ::
  3708. sign(-6.0) # Returns -1
  3709. sign(0.0) # Returns 0
  3710. sign(6.0) # Returns 1
  3711. sign(NAN) # Returns 0
  3712. sign(Vector3(-6.0, 0.0, 6.0)) # Returns (-1, 0, 1)
  3713. \ **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>`.
  3714. .. rst-class:: classref-item-separator
  3715. ----
  3716. .. _class_@GlobalScope_method_signf:
  3717. .. rst-class:: classref-method
  3718. :ref:`float<class_float>` **signf**\ (\ x\: :ref:`float<class_float>`\ )
  3719. 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.
  3720. ::
  3721. signf(-6.5) # Returns -1.0
  3722. signf(0.0) # Returns 0.0
  3723. signf(6.5) # Returns 1.0
  3724. signf(NAN) # Returns 0.0
  3725. .. rst-class:: classref-item-separator
  3726. ----
  3727. .. _class_@GlobalScope_method_signi:
  3728. .. rst-class:: classref-method
  3729. :ref:`int<class_int>` **signi**\ (\ x\: :ref:`int<class_int>`\ )
  3730. Returns ``-1`` if ``x`` is negative, ``1`` if ``x`` is positive, and ``0`` if if ``x`` is zero.
  3731. ::
  3732. signi(-6) # Returns -1
  3733. signi(0) # Returns 0
  3734. signi(6) # Returns 1
  3735. .. rst-class:: classref-item-separator
  3736. ----
  3737. .. _class_@GlobalScope_method_sin:
  3738. .. rst-class:: classref-method
  3739. :ref:`float<class_float>` **sin**\ (\ angle_rad\: :ref:`float<class_float>`\ )
  3740. Returns the sine of angle ``angle_rad`` in radians.
  3741. ::
  3742. sin(0.523599) # Returns 0.5
  3743. sin(deg_to_rad(90)) # Returns 1.0
  3744. .. rst-class:: classref-item-separator
  3745. ----
  3746. .. _class_@GlobalScope_method_sinh:
  3747. .. rst-class:: classref-method
  3748. :ref:`float<class_float>` **sinh**\ (\ x\: :ref:`float<class_float>`\ )
  3749. Returns the hyperbolic sine of ``x``.
  3750. ::
  3751. var a = log(2.0) # Returns 0.693147
  3752. sinh(a) # Returns 0.75
  3753. .. rst-class:: classref-item-separator
  3754. ----
  3755. .. _class_@GlobalScope_method_smoothstep:
  3756. .. rst-class:: classref-method
  3757. :ref:`float<class_float>` **smoothstep**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ )
  3758. Returns the result of smoothly interpolating the value of ``x`` between ``0`` and ``1``, based on the where ``x`` lies with respect to the edges ``from`` and ``to``.
  3759. The return value is ``0`` if ``x <= from``, and ``1`` if ``x >= to``. If ``x`` lies between ``from`` and ``to``, the returned value follows an S-shaped curve that maps ``x`` between ``0`` and ``1``.
  3760. 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)``.
  3761. ::
  3762. smoothstep(0, 2, -5.0) # Returns 0.0
  3763. smoothstep(0, 2, 0.5) # Returns 0.15625
  3764. smoothstep(0, 2, 1.0) # Returns 0.5
  3765. smoothstep(0, 2, 2.0) # Returns 1.0
  3766. 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>`.
  3767. \ `Comparison between smoothstep() and ease(x, -1.6521) return values <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/smoothstep_ease_comparison.png>`__
  3768. .. rst-class:: classref-item-separator
  3769. ----
  3770. .. _class_@GlobalScope_method_snapped:
  3771. .. rst-class:: classref-method
  3772. :ref:`Variant<class_Variant>` **snapped**\ (\ x\: :ref:`Variant<class_Variant>`, step\: :ref:`Variant<class_Variant>`\ )
  3773. 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.
  3774. 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>`.
  3775. ::
  3776. snapped(100, 32) # Returns 96
  3777. snapped(3.14159, 0.01) # Returns 3.14
  3778. snapped(Vector2(34, 70), Vector2(8, 8)) # Returns (32, 72)
  3779. See also :ref:`ceil<class_@GlobalScope_method_ceil>`, :ref:`floor<class_@GlobalScope_method_floor>`, and :ref:`round<class_@GlobalScope_method_round>`.
  3780. \ **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>`.
  3781. .. rst-class:: classref-item-separator
  3782. ----
  3783. .. _class_@GlobalScope_method_snappedf:
  3784. .. rst-class:: classref-method
  3785. :ref:`float<class_float>` **snappedf**\ (\ x\: :ref:`float<class_float>`, step\: :ref:`float<class_float>`\ )
  3786. 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.
  3787. A type-safe version of :ref:`snapped<class_@GlobalScope_method_snapped>`, returning a :ref:`float<class_float>`.
  3788. ::
  3789. snappedf(32.0, 2.5) # Returns 32.5
  3790. snappedf(3.14159, 0.01) # Returns 3.14
  3791. .. rst-class:: classref-item-separator
  3792. ----
  3793. .. _class_@GlobalScope_method_snappedi:
  3794. .. rst-class:: classref-method
  3795. :ref:`int<class_int>` **snappedi**\ (\ x\: :ref:`float<class_float>`, step\: :ref:`int<class_int>`\ )
  3796. Returns the multiple of ``step`` that is the closest to ``x``.
  3797. A type-safe version of :ref:`snapped<class_@GlobalScope_method_snapped>`, returning an :ref:`int<class_int>`.
  3798. ::
  3799. snappedi(53, 16) # Returns 48
  3800. snappedi(4096, 100) # Returns 4100
  3801. .. rst-class:: classref-item-separator
  3802. ----
  3803. .. _class_@GlobalScope_method_sqrt:
  3804. .. rst-class:: classref-method
  3805. :ref:`float<class_float>` **sqrt**\ (\ x\: :ref:`float<class_float>`\ )
  3806. Returns the square root of ``x``, where ``x`` is a non-negative number.
  3807. ::
  3808. sqrt(9) # Returns 3
  3809. sqrt(10.24) # Returns 3.2
  3810. sqrt(-1) # Returns NaN
  3811. \ **Note:** Negative values of ``x`` return NaN ("Not a Number"). in C#, if you need negative inputs, use ``System.Numerics.Complex``.
  3812. .. rst-class:: classref-item-separator
  3813. ----
  3814. .. _class_@GlobalScope_method_step_decimals:
  3815. .. rst-class:: classref-method
  3816. :ref:`int<class_int>` **step_decimals**\ (\ x\: :ref:`float<class_float>`\ )
  3817. 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.
  3818. ::
  3819. var n = step_decimals(5) # n is 0
  3820. n = step_decimals(1.0005) # n is 4
  3821. n = step_decimals(0.000000005) # n is 9
  3822. .. rst-class:: classref-item-separator
  3823. ----
  3824. .. _class_@GlobalScope_method_str:
  3825. .. rst-class:: classref-method
  3826. :ref:`String<class_String>` **str**\ (\ ...\ ) |vararg|
  3827. Converts one or more arguments of any :ref:`Variant<class_Variant>` type to a :ref:`String<class_String>` in the best way possible.
  3828. ::
  3829. var a = [10, 20, 30]
  3830. var b = str(a)
  3831. print(len(a)) # Prints 3 (the number of elements in the array).
  3832. print(len(b)) # Prints 12 (the length of the string "[10, 20, 30]").
  3833. .. rst-class:: classref-item-separator
  3834. ----
  3835. .. _class_@GlobalScope_method_str_to_var:
  3836. .. rst-class:: classref-method
  3837. :ref:`Variant<class_Variant>` **str_to_var**\ (\ string\: :ref:`String<class_String>`\ )
  3838. 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>`.
  3839. .. tabs::
  3840. .. code-tab:: gdscript
  3841. var data = '{ "a": 1, "b": 2 }' # data is a String
  3842. var dict = str_to_var(data) # dict is a Dictionary
  3843. print(dict["a"]) # Prints 1
  3844. .. code-tab:: csharp
  3845. string data = "{ \"a\": 1, \"b\": 2 }"; // data is a string
  3846. var dict = GD.StrToVar(data).AsGodotDictionary(); // dict is a Dictionary
  3847. GD.Print(dict["a"]); // Prints 1
  3848. .. rst-class:: classref-item-separator
  3849. ----
  3850. .. _class_@GlobalScope_method_tan:
  3851. .. rst-class:: classref-method
  3852. :ref:`float<class_float>` **tan**\ (\ angle_rad\: :ref:`float<class_float>`\ )
  3853. Returns the tangent of angle ``angle_rad`` in radians.
  3854. ::
  3855. tan(deg_to_rad(45)) # Returns 1
  3856. .. rst-class:: classref-item-separator
  3857. ----
  3858. .. _class_@GlobalScope_method_tanh:
  3859. .. rst-class:: classref-method
  3860. :ref:`float<class_float>` **tanh**\ (\ x\: :ref:`float<class_float>`\ )
  3861. Returns the hyperbolic tangent of ``x``.
  3862. ::
  3863. var a = log(2.0) # Returns 0.693147
  3864. tanh(a) # Returns 0.6
  3865. .. rst-class:: classref-item-separator
  3866. ----
  3867. .. _class_@GlobalScope_method_type_convert:
  3868. .. rst-class:: classref-method
  3869. :ref:`Variant<class_Variant>` **type_convert**\ (\ variant\: :ref:`Variant<class_Variant>`, type\: :ref:`int<class_int>`\ )
  3870. 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>`.
  3871. 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.
  3872. The returned value is a :ref:`Variant<class_Variant>`, but the data inside and its type will be the same as the requested type.
  3873. ::
  3874. type_convert("Hi!", TYPE_INT) # Returns 0
  3875. type_convert("123", TYPE_INT) # Returns 123
  3876. type_convert(123.4, TYPE_INT) # Returns 123
  3877. type_convert(5, TYPE_VECTOR2) # Returns (0, 0)
  3878. type_convert("Hi!", TYPE_NIL) # Returns null
  3879. .. rst-class:: classref-item-separator
  3880. ----
  3881. .. _class_@GlobalScope_method_type_string:
  3882. .. rst-class:: classref-method
  3883. :ref:`String<class_String>` **type_string**\ (\ type\: :ref:`int<class_int>`\ )
  3884. Returns a human-readable name of the given ``type``, using the :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` values.
  3885. ::
  3886. print(TYPE_INT) # Prints 2.
  3887. print(type_string(TYPE_INT)) # Prints "int".
  3888. print(type_string(TYPE_STRING)) # Prints "String".
  3889. See also :ref:`typeof<class_@GlobalScope_method_typeof>`.
  3890. .. rst-class:: classref-item-separator
  3891. ----
  3892. .. _class_@GlobalScope_method_typeof:
  3893. .. rst-class:: classref-method
  3894. :ref:`int<class_int>` **typeof**\ (\ variable\: :ref:`Variant<class_Variant>`\ )
  3895. Returns the internal type of the given ``variable``, using the :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` values.
  3896. ::
  3897. var json = JSON.new()
  3898. json.parse('["a", "b", "c"]')
  3899. var result = json.get_data()
  3900. if typeof(result) == TYPE_ARRAY:
  3901. print(result[0]) # Prints a
  3902. else:
  3903. print("Unexpected result")
  3904. See also :ref:`type_string<class_@GlobalScope_method_type_string>`.
  3905. .. rst-class:: classref-item-separator
  3906. ----
  3907. .. _class_@GlobalScope_method_var_to_bytes:
  3908. .. rst-class:: classref-method
  3909. :ref:`PackedByteArray<class_PackedByteArray>` **var_to_bytes**\ (\ variable\: :ref:`Variant<class_Variant>`\ )
  3910. 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>`.
  3911. \ **Note:** If you need object serialization, see :ref:`var_to_bytes_with_objects<class_@GlobalScope_method_var_to_bytes_with_objects>`.
  3912. \ **Note:** Encoding :ref:`Callable<class_Callable>` is not supported and will result in an empty value, regardless of the data.
  3913. .. rst-class:: classref-item-separator
  3914. ----
  3915. .. _class_@GlobalScope_method_var_to_bytes_with_objects:
  3916. .. rst-class:: classref-method
  3917. :ref:`PackedByteArray<class_PackedByteArray>` **var_to_bytes_with_objects**\ (\ variable\: :ref:`Variant<class_Variant>`\ )
  3918. 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>`.
  3919. \ **Note:** Encoding :ref:`Callable<class_Callable>` is not supported and will result in an empty value, regardless of the data.
  3920. .. rst-class:: classref-item-separator
  3921. ----
  3922. .. _class_@GlobalScope_method_var_to_str:
  3923. .. rst-class:: classref-method
  3924. :ref:`String<class_String>` **var_to_str**\ (\ variable\: :ref:`Variant<class_Variant>`\ )
  3925. 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>`.
  3926. .. tabs::
  3927. .. code-tab:: gdscript
  3928. var a = { "a": 1, "b": 2 }
  3929. print(var_to_str(a))
  3930. .. code-tab:: csharp
  3931. var a = new Godot.Collections.Dictionary { ["a"] = 1, ["b"] = 2 };
  3932. GD.Print(GD.VarToStr(a));
  3933. Prints:
  3934. ::
  3935. {
  3936. "a": 1,
  3937. "b": 2
  3938. }
  3939. \ **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.
  3940. .. rst-class:: classref-item-separator
  3941. ----
  3942. .. _class_@GlobalScope_method_weakref:
  3943. .. rst-class:: classref-method
  3944. :ref:`Variant<class_Variant>` **weakref**\ (\ obj\: :ref:`Variant<class_Variant>`\ )
  3945. 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``.
  3946. 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.
  3947. .. rst-class:: classref-item-separator
  3948. ----
  3949. .. _class_@GlobalScope_method_wrap:
  3950. .. rst-class:: classref-method
  3951. :ref:`Variant<class_Variant>` **wrap**\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ )
  3952. Wraps the :ref:`Variant<class_Variant>` ``value`` between ``min`` and ``max``. Can be used for creating loop-alike behavior or infinite surfaces.
  3953. 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>`.
  3954. ::
  3955. var a = wrap(4, 5, 10)
  3956. # a is 9 (int)
  3957. var a = wrap(7, 5, 10)
  3958. # a is 7 (int)
  3959. var a = wrap(10.5, 5, 10)
  3960. # a is 5.5 (float)
  3961. .. rst-class:: classref-item-separator
  3962. ----
  3963. .. _class_@GlobalScope_method_wrapf:
  3964. .. rst-class:: classref-method
  3965. :ref:`float<class_float>` **wrapf**\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ )
  3966. Wraps the float ``value`` between ``min`` and ``max``. Can be used for creating loop-alike behavior or infinite surfaces.
  3967. ::
  3968. # Infinite loop between 5.0 and 9.9
  3969. value = wrapf(value + 0.1, 5.0, 10.0)
  3970. ::
  3971. # Infinite rotation (in radians)
  3972. angle = wrapf(angle + 0.1, 0.0, TAU)
  3973. ::
  3974. # Infinite rotation (in radians)
  3975. angle = wrapf(angle + 0.1, -PI, PI)
  3976. \ **Note:** If ``min`` is ``0``, this is equivalent to :ref:`fposmod<class_@GlobalScope_method_fposmod>`, so prefer using that instead.
  3977. \ :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.
  3978. .. rst-class:: classref-item-separator
  3979. ----
  3980. .. _class_@GlobalScope_method_wrapi:
  3981. .. rst-class:: classref-method
  3982. :ref:`int<class_int>` **wrapi**\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ )
  3983. Wraps the integer ``value`` between ``min`` and ``max``. Can be used for creating loop-alike behavior or infinite surfaces.
  3984. ::
  3985. # Infinite loop between 5 and 9
  3986. frame = wrapi(frame + 1, 5, 10)
  3987. ::
  3988. # result is -2
  3989. var result = wrapi(-6, -5, -1)
  3990. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  3991. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  3992. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  3993. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  3994. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  3995. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  3996. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  3997. .. |void| replace:: :abbr:`void (No return value.)`