bgfx.cpp 188 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991
  1. /*
  2. * Copyright 2011-2018 Branimir Karadzic. All rights reserved.
  3. * License: https://github.com/bkaradzic/bgfx#license-bsd-2-clause
  4. */
  5. #include <bx/platform.h>
  6. #include "bgfx_p.h"
  7. #include <bgfx/embedded_shader.h>
  8. #include <bx/file.h>
  9. #include <bx/mutex.h>
  10. #include "topology.h"
  11. BX_ERROR_RESULT(BGFX_ERROR_TEXTURE_VALIDATION, BX_MAKEFOURCC('b', 'g', 0, 1) );
  12. namespace bgfx
  13. {
  14. #define BGFX_API_THREAD_MAGIC UINT32_C(0x78666762)
  15. #if BGFX_CONFIG_MULTITHREADED
  16. # define BGFX_CHECK_API_THREAD() \
  17. BX_CHECK(NULL != s_ctx, "Library is not initialized yet."); \
  18. BX_CHECK(BGFX_API_THREAD_MAGIC == s_threadIndex, "Must be called from main thread.")
  19. # define BGFX_CHECK_RENDER_THREAD() BX_CHECK(~BGFX_API_THREAD_MAGIC == s_threadIndex, "Must be called from render thread.")
  20. #else
  21. # define BGFX_CHECK_API_THREAD()
  22. # define BGFX_CHECK_RENDER_THREAD()
  23. #endif // BGFX_CONFIG_MULTITHREADED
  24. #define BGFX_CHECK_CAPS(_caps, _msg) \
  25. BX_CHECK(0 != (g_caps.supported & (_caps) ) \
  26. , _msg " Use bgfx::getCaps to check " #_caps " backend renderer capabilities." \
  27. );
  28. #if BGFX_CONFIG_USE_TINYSTL
  29. void* TinyStlAllocator::static_allocate(size_t _bytes)
  30. {
  31. return BX_ALLOC(g_allocator, _bytes);
  32. }
  33. void TinyStlAllocator::static_deallocate(void* _ptr, size_t /*_bytes*/)
  34. {
  35. if (NULL != _ptr)
  36. {
  37. BX_FREE(g_allocator, _ptr);
  38. }
  39. }
  40. #endif // BGFX_CONFIG_USE_TINYSTL
  41. struct CallbackStub : public CallbackI
  42. {
  43. virtual ~CallbackStub()
  44. {
  45. }
  46. virtual void fatal(Fatal::Enum _code, const char* _str) override
  47. {
  48. if (Fatal::DebugCheck == _code)
  49. {
  50. bx::debugBreak();
  51. }
  52. else
  53. {
  54. BX_TRACE("0x%08x: %s", _code, _str);
  55. BX_UNUSED(_code, _str);
  56. abort();
  57. }
  58. }
  59. virtual void traceVargs(const char* _filePath, uint16_t _line, const char* _format, va_list _argList) override
  60. {
  61. char temp[2048];
  62. char* out = temp;
  63. va_list argListCopy;
  64. va_copy(argListCopy, _argList);
  65. int32_t len = bx::snprintf(out, sizeof(temp), "%s (%d): ", _filePath, _line);
  66. int32_t total = len + bx::vsnprintf(out + len, sizeof(temp)-len, _format, argListCopy);
  67. va_end(argListCopy);
  68. if ( (int32_t)sizeof(temp) < total)
  69. {
  70. out = (char*)alloca(total+1);
  71. bx::memCopy(out, temp, len);
  72. bx::vsnprintf(out + len, total-len, _format, _argList);
  73. }
  74. out[total] = '\0';
  75. bx::debugOutput(out);
  76. }
  77. virtual void profilerBegin(const char* /*_name*/, uint32_t /*_abgr*/, const char* /*_filePath*/, uint16_t /*_line*/) override
  78. {
  79. }
  80. virtual void profilerBeginLiteral(const char* /*_name*/, uint32_t /*_abgr*/, const char* /*_filePath*/, uint16_t /*_line*/) override
  81. {
  82. }
  83. virtual void profilerEnd() override
  84. {
  85. }
  86. virtual uint32_t cacheReadSize(uint64_t /*_id*/) override
  87. {
  88. return 0;
  89. }
  90. virtual bool cacheRead(uint64_t /*_id*/, void* /*_data*/, uint32_t /*_size*/) override
  91. {
  92. return false;
  93. }
  94. virtual void cacheWrite(uint64_t /*_id*/, const void* /*_data*/, uint32_t /*_size*/) override
  95. {
  96. }
  97. virtual void screenShot(const char* _filePath, uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _data, uint32_t _size, bool _yflip) override
  98. {
  99. BX_UNUSED(_filePath, _width, _height, _pitch, _data, _size, _yflip);
  100. const int32_t len = bx::strLen(_filePath)+5;
  101. char* filePath = (char*)alloca(len);
  102. bx::strCopy(filePath, len, _filePath);
  103. bx::strCat(filePath, len, ".tga");
  104. bx::FileWriter writer;
  105. if (bx::open(&writer, filePath) )
  106. {
  107. bimg::imageWriteTga(&writer, _width, _height, _pitch, _data, false, _yflip);
  108. bx::close(&writer);
  109. }
  110. }
  111. virtual void captureBegin(uint32_t /*_width*/, uint32_t /*_height*/, uint32_t /*_pitch*/, TextureFormat::Enum /*_format*/, bool /*_yflip*/) override
  112. {
  113. BX_TRACE("Warning: using capture without callback (a.k.a. pointless).");
  114. }
  115. virtual void captureEnd() override
  116. {
  117. }
  118. virtual void captureFrame(const void* /*_data*/, uint32_t /*_size*/) override
  119. {
  120. }
  121. };
  122. #ifndef BGFX_CONFIG_MEMORY_TRACKING
  123. # define BGFX_CONFIG_MEMORY_TRACKING (BGFX_CONFIG_DEBUG && BX_CONFIG_SUPPORTS_THREADING)
  124. #endif // BGFX_CONFIG_MEMORY_TRACKING
  125. const size_t kNaturalAlignment = 8;
  126. class AllocatorStub : public bx::AllocatorI
  127. {
  128. public:
  129. AllocatorStub()
  130. #if BGFX_CONFIG_MEMORY_TRACKING
  131. : m_numBlocks(0)
  132. , m_maxBlocks(0)
  133. #endif // BGFX_CONFIG_MEMORY_TRACKING
  134. {
  135. }
  136. virtual void* realloc(void* _ptr, size_t _size, size_t _align, const char* _file, uint32_t _line) override
  137. {
  138. if (0 == _size)
  139. {
  140. if (NULL != _ptr)
  141. {
  142. if (kNaturalAlignment >= _align)
  143. {
  144. #if BGFX_CONFIG_MEMORY_TRACKING
  145. {
  146. bx::MutexScope scope(m_mutex);
  147. BX_CHECK(m_numBlocks > 0, "Number of blocks is 0. Possible alloc/free mismatch?");
  148. --m_numBlocks;
  149. }
  150. #endif // BGFX_CONFIG_MEMORY_TRACKING
  151. ::free(_ptr);
  152. }
  153. else
  154. {
  155. bx::alignedFree(this, _ptr, _align, _file, _line);
  156. }
  157. }
  158. return NULL;
  159. }
  160. else if (NULL == _ptr)
  161. {
  162. if (kNaturalAlignment >= _align)
  163. {
  164. #if BGFX_CONFIG_MEMORY_TRACKING
  165. {
  166. bx::MutexScope scope(m_mutex);
  167. ++m_numBlocks;
  168. m_maxBlocks = bx::max(m_maxBlocks, m_numBlocks);
  169. }
  170. #endif // BGFX_CONFIG_MEMORY_TRACKING
  171. return ::malloc(_size);
  172. }
  173. return bx::alignedAlloc(this, _size, _align, _file, _line);
  174. }
  175. if (kNaturalAlignment >= _align)
  176. {
  177. #if BGFX_CONFIG_MEMORY_TRACKING
  178. if (NULL == _ptr)
  179. {
  180. bx::MutexScope scope(m_mutex);
  181. ++m_numBlocks;
  182. m_maxBlocks = bx::max(m_maxBlocks, m_numBlocks);
  183. }
  184. #endif // BGFX_CONFIG_MEMORY_TRACKING
  185. return ::realloc(_ptr, _size);
  186. }
  187. return bx::alignedRealloc(this, _ptr, _size, _align, _file, _line);
  188. }
  189. void checkLeaks();
  190. protected:
  191. #if BGFX_CONFIG_MEMORY_TRACKING
  192. bx::Mutex m_mutex;
  193. uint32_t m_numBlocks;
  194. uint32_t m_maxBlocks;
  195. #endif // BGFX_CONFIG_MEMORY_TRACKING
  196. };
  197. static CallbackStub* s_callbackStub = NULL;
  198. static AllocatorStub* s_allocatorStub = NULL;
  199. static bool s_graphicsDebuggerPresent = false;
  200. CallbackI* g_callback = NULL;
  201. bx::AllocatorI* g_allocator = NULL;
  202. Caps g_caps;
  203. #if BGFX_CONFIG_MULTITHREADED && !defined(BX_THREAD_LOCAL)
  204. class ThreadData
  205. {
  206. BX_CLASS(ThreadData
  207. , NO_COPY
  208. , NO_ASSIGNMENT
  209. );
  210. public:
  211. ThreadData(uintptr_t _rhs)
  212. {
  213. union { uintptr_t ui; void* ptr; } cast = { _rhs };
  214. m_tls.set(cast.ptr);
  215. }
  216. operator uintptr_t() const
  217. {
  218. union { uintptr_t ui; void* ptr; } cast;
  219. cast.ptr = m_tls.get();
  220. return cast.ui;
  221. }
  222. uintptr_t operator=(uintptr_t _rhs)
  223. {
  224. union { uintptr_t ui; void* ptr; } cast = { _rhs };
  225. m_tls.set(cast.ptr);
  226. return _rhs;
  227. }
  228. bool operator==(uintptr_t _rhs) const
  229. {
  230. uintptr_t lhs = *this;
  231. return lhs == _rhs;
  232. }
  233. private:
  234. bx::TlsData m_tls;
  235. };
  236. static ThreadData s_threadIndex(0);
  237. #elif !BGFX_CONFIG_MULTITHREADED
  238. static uint32_t s_threadIndex(0);
  239. #else
  240. static BX_THREAD_LOCAL uint32_t s_threadIndex(0);
  241. #endif
  242. static Context* s_ctx = NULL;
  243. static bool s_renderFrameCalled = false;
  244. InternalData g_internalData;
  245. PlatformData g_platformData;
  246. bool g_platformDataChangedSinceReset = false;
  247. void AllocatorStub::checkLeaks()
  248. {
  249. #if BGFX_CONFIG_MEMORY_TRACKING
  250. // BK - CallbackStub will be deleted after printing this info, so there is always one
  251. // leak if CallbackStub is used.
  252. BX_WARN(uint32_t(NULL != s_callbackStub ? 1 : 0) == m_numBlocks
  253. , "MEMORY LEAK: %d (max: %d)"
  254. , m_numBlocks
  255. , m_maxBlocks
  256. );
  257. #endif // BGFX_CONFIG_MEMORY_TRACKING
  258. }
  259. void setPlatformData(const PlatformData& _data)
  260. {
  261. if (NULL != s_ctx)
  262. {
  263. BGFX_FATAL(true
  264. && g_platformData.ndt == _data.ndt
  265. && g_platformData.context == _data.context
  266. , Fatal::UnableToInitialize
  267. , "Only backbuffer pointer and native window handle can be changed after initialization!"
  268. );
  269. }
  270. bx::memCopy(&g_platformData, &_data, sizeof(PlatformData) );
  271. g_platformDataChangedSinceReset = true;
  272. }
  273. const InternalData* getInternalData()
  274. {
  275. BGFX_CHECK_RENDER_THREAD();
  276. return &g_internalData;
  277. }
  278. uintptr_t overrideInternal(TextureHandle _handle, uintptr_t _ptr)
  279. {
  280. BGFX_CHECK_RENDER_THREAD();
  281. RendererContextI* rci = s_ctx->m_renderCtx;
  282. if (0 == rci->getInternal(_handle) )
  283. {
  284. return 0;
  285. }
  286. rci->overrideInternal(_handle, _ptr);
  287. return rci->getInternal(_handle);
  288. }
  289. uintptr_t overrideInternal(TextureHandle _handle, uint16_t _width, uint16_t _height, uint8_t _numMips, TextureFormat::Enum _format, uint32_t _flags)
  290. {
  291. BGFX_CHECK_RENDER_THREAD();
  292. RendererContextI* rci = s_ctx->m_renderCtx;
  293. if (0 == rci->getInternal(_handle) )
  294. {
  295. return 0;
  296. }
  297. uint32_t size = sizeof(uint32_t) + sizeof(TextureCreate);
  298. Memory* mem = const_cast<Memory*>(alloc(size) );
  299. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  300. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  301. bx::write(&writer, magic);
  302. TextureCreate tc;
  303. tc.m_width = _width;
  304. tc.m_height = _height;
  305. tc.m_depth = 0;
  306. tc.m_numLayers = 1;
  307. tc.m_numMips = bx::max<uint8_t>(1, _numMips);
  308. tc.m_format = _format;
  309. tc.m_cubeMap = false;
  310. tc.m_mem = NULL;
  311. bx::write(&writer, tc);
  312. rci->destroyTexture(_handle);
  313. rci->createTexture(_handle, mem, _flags, 0);
  314. release(mem);
  315. return rci->getInternal(_handle);
  316. }
  317. void setGraphicsDebuggerPresent(bool _present)
  318. {
  319. BX_TRACE("Graphics debugger is %spresent.", _present ? "" : "not ");
  320. s_graphicsDebuggerPresent = _present;
  321. }
  322. bool isGraphicsDebuggerPresent()
  323. {
  324. return s_graphicsDebuggerPresent;
  325. }
  326. void fatal(Fatal::Enum _code, const char* _format, ...)
  327. {
  328. va_list argList;
  329. va_start(argList, _format);
  330. if (BX_UNLIKELY(NULL == g_callback) )
  331. {
  332. bx::debugPrintfVargs(_format, argList);
  333. abort();
  334. }
  335. else
  336. {
  337. char temp[8192];
  338. char* out = temp;
  339. int32_t len = bx::vsnprintf(out, sizeof(temp), _format, argList);
  340. if ( (int32_t)sizeof(temp) < len)
  341. {
  342. out = (char*)alloca(len+1);
  343. len = bx::vsnprintf(out, len, _format, argList);
  344. }
  345. out[len] = '\0';
  346. g_callback->fatal(_code, out);
  347. }
  348. va_end(argList);
  349. }
  350. void trace(const char* _filePath, uint16_t _line, const char* _format, ...)
  351. {
  352. va_list argList;
  353. va_start(argList, _format);
  354. if (BX_UNLIKELY(NULL == g_callback) )
  355. {
  356. bx::debugPrintfVargs(_format, argList);
  357. }
  358. else
  359. {
  360. g_callback->traceVargs(_filePath, _line, _format, argList);
  361. }
  362. va_end(argList);
  363. }
  364. #include "vs_debugfont.bin.h"
  365. #include "fs_debugfont.bin.h"
  366. #include "vs_clear.bin.h"
  367. #include "fs_clear0.bin.h"
  368. #include "fs_clear1.bin.h"
  369. #include "fs_clear2.bin.h"
  370. #include "fs_clear3.bin.h"
  371. #include "fs_clear4.bin.h"
  372. #include "fs_clear5.bin.h"
  373. #include "fs_clear6.bin.h"
  374. #include "fs_clear7.bin.h"
  375. static const EmbeddedShader s_embeddedShaders[] =
  376. {
  377. BGFX_EMBEDDED_SHADER(vs_debugfont),
  378. BGFX_EMBEDDED_SHADER(fs_debugfont),
  379. BGFX_EMBEDDED_SHADER(vs_clear),
  380. BGFX_EMBEDDED_SHADER(fs_clear0),
  381. BGFX_EMBEDDED_SHADER(fs_clear1),
  382. BGFX_EMBEDDED_SHADER(fs_clear2),
  383. BGFX_EMBEDDED_SHADER(fs_clear3),
  384. BGFX_EMBEDDED_SHADER(fs_clear4),
  385. BGFX_EMBEDDED_SHADER(fs_clear5),
  386. BGFX_EMBEDDED_SHADER(fs_clear6),
  387. BGFX_EMBEDDED_SHADER(fs_clear7),
  388. BGFX_EMBEDDED_SHADER_END()
  389. };
  390. ShaderHandle createEmbeddedShader(const EmbeddedShader* _es, RendererType::Enum _type, const char* _name)
  391. {
  392. for (const EmbeddedShader* es = _es; NULL != es->name; ++es)
  393. {
  394. if (0 == bx::strCmp(_name, es->name) )
  395. {
  396. for (const EmbeddedShader::Data* esd = es->data; RendererType::Count != esd->type; ++esd)
  397. {
  398. if (_type == esd->type
  399. && 1 < esd->size)
  400. {
  401. ShaderHandle handle = createShader(makeRef(esd->data, esd->size) );
  402. if (isValid(handle) )
  403. {
  404. setName(handle, _name);
  405. }
  406. return handle;
  407. }
  408. }
  409. }
  410. }
  411. ShaderHandle handle = BGFX_INVALID_HANDLE;
  412. return handle;
  413. }
  414. #include "charset.h"
  415. void charsetFillTexture(const uint8_t* _charset, uint8_t* _rgba, uint32_t _height, uint32_t _pitch, uint32_t _bpp)
  416. {
  417. for (uint32_t ii = 0; ii < 256; ++ii)
  418. {
  419. uint8_t* pix = &_rgba[ii*8*_bpp];
  420. for (uint32_t yy = 0; yy < _height; ++yy)
  421. {
  422. for (uint32_t xx = 0; xx < 8; ++xx)
  423. {
  424. uint8_t bit = 1<<(7-xx);
  425. bx::memSet(&pix[xx*_bpp], _charset[ii*_height+yy]&bit ? 255 : 0, _bpp);
  426. }
  427. pix += _pitch;
  428. }
  429. }
  430. }
  431. static uint8_t parseAttrTo(char*& _ptr, char _to, uint8_t _default)
  432. {
  433. const char* str = bx::strFind(_ptr, _to);
  434. if (NULL != str
  435. && 3 > str-_ptr)
  436. {
  437. char tmp[4];
  438. int32_t len = int32_t(str-_ptr);
  439. bx::strCopy(tmp, sizeof(tmp), _ptr, len);
  440. uint8_t attr = uint8_t(atoi(tmp) );
  441. _ptr += len+1;
  442. return attr;
  443. }
  444. return _default;
  445. }
  446. static uint8_t parseAttr(char*& _ptr, uint8_t _default)
  447. {
  448. char* ptr = _ptr;
  449. if (*ptr++ != '[')
  450. {
  451. return _default;
  452. }
  453. if (0 == bx::strCmp(ptr, "0m", 2) )
  454. {
  455. _ptr = ptr + 2;
  456. return _default;
  457. }
  458. uint8_t fg = parseAttrTo(ptr, ';', _default & 0xf);
  459. uint8_t bg = parseAttrTo(ptr, 'm', _default >> 4);
  460. uint8_t attr = (bg<<4) | fg;
  461. _ptr = ptr;
  462. return attr;
  463. }
  464. void TextVideoMem::printfVargs(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, va_list _argList)
  465. {
  466. if (_x < m_width && _y < m_height)
  467. {
  468. va_list argListCopy;
  469. va_copy(argListCopy, _argList);
  470. uint32_t num = bx::vsnprintf(NULL, 0, _format, argListCopy) + 1;
  471. char* temp = (char*)alloca(num);
  472. va_copy(argListCopy, _argList);
  473. num = bx::vsnprintf(temp, num, _format, argListCopy);
  474. uint8_t attr = _attr;
  475. MemSlot* mem = &m_mem[_y*m_width+_x];
  476. for (uint32_t ii = 0, xx = _x; ii < num && xx < m_width; ++ii)
  477. {
  478. char ch = temp[ii];
  479. if (BX_UNLIKELY(ch == '\x1b') )
  480. {
  481. char* ptr = &temp[ii+1];
  482. attr = parseAttr(ptr, _attr);
  483. ii += uint32_t(ptr - &temp[ii+1]);
  484. }
  485. else
  486. {
  487. mem->character = ch;
  488. mem->attribute = attr;
  489. ++mem;
  490. ++xx;
  491. }
  492. }
  493. }
  494. }
  495. static const uint32_t numCharsPerBatch = 1024;
  496. static const uint32_t numBatchVertices = numCharsPerBatch*4;
  497. static const uint32_t numBatchIndices = numCharsPerBatch*6;
  498. void TextVideoMemBlitter::init()
  499. {
  500. BGFX_CHECK_API_THREAD();
  501. m_decl
  502. .begin()
  503. .add(Attrib::Position, 3, AttribType::Float)
  504. .add(Attrib::Color0, 4, AttribType::Uint8, true)
  505. .add(Attrib::Color1, 4, AttribType::Uint8, true)
  506. .add(Attrib::TexCoord0, 2, AttribType::Float)
  507. .end();
  508. uint16_t width = 2048;
  509. uint16_t height = 24;
  510. uint8_t bpp = 1;
  511. uint32_t pitch = width*bpp;
  512. const Memory* mem;
  513. mem = alloc(pitch*height);
  514. uint8_t* rgba = mem->data;
  515. charsetFillTexture(vga8x8, rgba, 8, pitch, bpp);
  516. charsetFillTexture(vga8x16, &rgba[8*pitch], 16, pitch, bpp);
  517. m_texture = createTexture2D(width, height, false, 1, TextureFormat::R8
  518. , BGFX_SAMPLER_MIN_POINT
  519. | BGFX_SAMPLER_MAG_POINT
  520. | BGFX_SAMPLER_MIP_POINT
  521. | BGFX_SAMPLER_U_CLAMP
  522. | BGFX_SAMPLER_V_CLAMP
  523. , mem
  524. );
  525. ShaderHandle vsh = createEmbeddedShader(s_embeddedShaders, g_caps.rendererType, "vs_debugfont");
  526. ShaderHandle fsh = createEmbeddedShader(s_embeddedShaders, g_caps.rendererType, "fs_debugfont");
  527. m_program = createProgram(vsh, fsh, true);
  528. m_vb = s_ctx->createTransientVertexBuffer(numBatchVertices*m_decl.m_stride, &m_decl);
  529. m_ib = s_ctx->createTransientIndexBuffer(numBatchIndices*2);
  530. }
  531. void TextVideoMemBlitter::shutdown()
  532. {
  533. BGFX_CHECK_API_THREAD();
  534. if (isValid(m_program) )
  535. {
  536. destroy(m_program);
  537. }
  538. destroy(m_texture);
  539. s_ctx->destroyTransientVertexBuffer(m_vb);
  540. s_ctx->destroyTransientIndexBuffer(m_ib);
  541. }
  542. void blit(RendererContextI* _renderCtx, TextVideoMemBlitter& _blitter, const TextVideoMem& _mem)
  543. {
  544. struct Vertex
  545. {
  546. float m_x;
  547. float m_y;
  548. float m_z;
  549. uint32_t m_fg;
  550. uint32_t m_bg;
  551. float m_u;
  552. float m_v;
  553. };
  554. static uint32_t palette[] =
  555. {
  556. 0x0, // Black
  557. 0xffa46534, // Blue
  558. 0xff069a4e, // Green
  559. 0xff9a9806, // Cyan
  560. 0xff0000cc, // Red
  561. 0xff7b5075, // Magenta
  562. 0xff00a0c4, // Brown
  563. 0xffcfd7d3, // Light Gray
  564. 0xff535755, // Dark Gray
  565. 0xffcf9f72, // Light Blue
  566. 0xff34e28a, // Light Green
  567. 0xffe2e234, // Light Cyan
  568. 0xff2929ef, // Light Red
  569. 0xffa87fad, // Light Magenta
  570. 0xff4fe9fc, // Yellow
  571. 0xffeceeee, // White
  572. };
  573. BX_STATIC_ASSERT(BX_COUNTOF(palette) == 16);
  574. uint32_t yy = 0;
  575. uint32_t xx = 0;
  576. const float texelWidth = 1.0f/2048.0f;
  577. const float texelWidthHalf = RendererType::Direct3D9 == g_caps.rendererType ? 0.0f : texelWidth*0.5f;
  578. const float texelHeight = 1.0f/24.0f;
  579. const float texelHeightHalf = RendererType::Direct3D9 == g_caps.rendererType ? texelHeight*0.5f : 0.0f;
  580. const float utop = (_mem.m_small ? 0.0f : 8.0f)*texelHeight + texelHeightHalf;
  581. const float ubottom = (_mem.m_small ? 8.0f : 24.0f)*texelHeight + texelHeightHalf;
  582. const float fontHeight = (_mem.m_small ? 8.0f : 16.0f);
  583. _renderCtx->blitSetup(_blitter);
  584. for (;yy < _mem.m_height;)
  585. {
  586. Vertex* vertex = (Vertex*)_blitter.m_vb->data;
  587. uint16_t* indices = (uint16_t*)_blitter.m_ib->data;
  588. uint32_t startVertex = 0;
  589. uint32_t numIndices = 0;
  590. for (; yy < _mem.m_height && numIndices < numBatchIndices; ++yy)
  591. {
  592. xx = xx < _mem.m_width ? xx : 0;
  593. const TextVideoMem::MemSlot* line = &_mem.m_mem[yy*_mem.m_width+xx];
  594. for (; xx < _mem.m_width && numIndices < numBatchIndices; ++xx)
  595. {
  596. uint32_t ch = line->character;
  597. uint8_t attr = line->attribute;
  598. if (ch > 0xff)
  599. ch = 0; // todo: render unicode code point , ch > 255)
  600. if (0 != (ch|attr)
  601. && (' ' != ch || 0 != (attr&0xf0) ) )
  602. {
  603. uint32_t fg = palette[attr&0xf];
  604. uint32_t bg = palette[(attr>>4)&0xf];
  605. Vertex vert[4] =
  606. {
  607. { (xx )*8.0f, (yy )*fontHeight, 0.0f, fg, bg, (ch )*8.0f*texelWidth - texelWidthHalf, utop },
  608. { (xx+1)*8.0f, (yy )*fontHeight, 0.0f, fg, bg, (ch+1)*8.0f*texelWidth - texelWidthHalf, utop },
  609. { (xx+1)*8.0f, (yy+1)*fontHeight, 0.0f, fg, bg, (ch+1)*8.0f*texelWidth - texelWidthHalf, ubottom },
  610. { (xx )*8.0f, (yy+1)*fontHeight, 0.0f, fg, bg, (ch )*8.0f*texelWidth - texelWidthHalf, ubottom },
  611. };
  612. bx::memCopy(vertex, vert, sizeof(vert) );
  613. vertex += 4;
  614. indices[0] = uint16_t(startVertex+0);
  615. indices[1] = uint16_t(startVertex+1);
  616. indices[2] = uint16_t(startVertex+2);
  617. indices[3] = uint16_t(startVertex+2);
  618. indices[4] = uint16_t(startVertex+3);
  619. indices[5] = uint16_t(startVertex+0);
  620. startVertex += 4;
  621. indices += 6;
  622. numIndices += 6;
  623. }
  624. line ++;
  625. }
  626. if (numIndices >= numBatchIndices)
  627. {
  628. break;
  629. }
  630. }
  631. _renderCtx->blitRender(_blitter, numIndices);
  632. }
  633. }
  634. void ClearQuad::init()
  635. {
  636. BGFX_CHECK_API_THREAD();
  637. if (RendererType::Noop != g_caps.rendererType)
  638. {
  639. m_decl
  640. .begin()
  641. .add(Attrib::Position, 3, AttribType::Float)
  642. .end();
  643. ShaderHandle vsh = createEmbeddedShader(s_embeddedShaders, g_caps.rendererType, "vs_clear");
  644. for (uint32_t ii = 0, num = g_caps.limits.maxFBAttachments; ii < num; ++ii)
  645. {
  646. char name[32];
  647. bx::snprintf(name, BX_COUNTOF(name), "fs_clear%d", ii);
  648. ShaderHandle fsh = createEmbeddedShader(s_embeddedShaders, g_caps.rendererType, name);
  649. m_program[ii] = createProgram(vsh, fsh);
  650. BX_CHECK(isValid(m_program[ii]), "Failed to create clear quad program.");
  651. destroy(fsh);
  652. }
  653. destroy(vsh);
  654. m_vb = s_ctx->createTransientVertexBuffer(4*m_decl.m_stride, &m_decl);
  655. }
  656. }
  657. void ClearQuad::shutdown()
  658. {
  659. BGFX_CHECK_API_THREAD();
  660. if (RendererType::Noop != g_caps.rendererType)
  661. {
  662. for (uint32_t ii = 0, num = g_caps.limits.maxFBAttachments; ii < num; ++ii)
  663. {
  664. if (isValid(m_program[ii]) )
  665. {
  666. destroy(m_program[ii]);
  667. m_program[ii].idx = kInvalidHandle;
  668. }
  669. }
  670. s_ctx->destroyTransientVertexBuffer(m_vb);
  671. }
  672. }
  673. const char* s_uniformTypeName[] =
  674. {
  675. "int1",
  676. NULL,
  677. "vec4",
  678. "mat3",
  679. "mat4",
  680. };
  681. BX_STATIC_ASSERT(UniformType::Count == BX_COUNTOF(s_uniformTypeName) );
  682. const char* getUniformTypeName(UniformType::Enum _enum)
  683. {
  684. BX_CHECK(_enum < UniformType::Count, "%d < UniformType::Count %d", _enum, UniformType::Count);
  685. return s_uniformTypeName[_enum];
  686. }
  687. UniformType::Enum nameToUniformTypeEnum(const char* _name)
  688. {
  689. for (uint32_t ii = 0; ii < UniformType::Count; ++ii)
  690. {
  691. if (NULL != s_uniformTypeName[ii]
  692. && 0 == bx::strCmp(_name, s_uniformTypeName[ii]) )
  693. {
  694. return UniformType::Enum(ii);
  695. }
  696. }
  697. return UniformType::Count;
  698. }
  699. static const char* s_predefinedName[PredefinedUniform::Count] =
  700. {
  701. "u_viewRect",
  702. "u_viewTexel",
  703. "u_view",
  704. "u_invView",
  705. "u_proj",
  706. "u_invProj",
  707. "u_viewProj",
  708. "u_invViewProj",
  709. "u_model",
  710. "u_modelView",
  711. "u_modelViewProj",
  712. "u_alphaRef4",
  713. };
  714. const char* getPredefinedUniformName(PredefinedUniform::Enum _enum)
  715. {
  716. return s_predefinedName[_enum];
  717. }
  718. PredefinedUniform::Enum nameToPredefinedUniformEnum(const char* _name)
  719. {
  720. for (uint32_t ii = 0; ii < PredefinedUniform::Count; ++ii)
  721. {
  722. if (0 == bx::strCmp(_name, s_predefinedName[ii]) )
  723. {
  724. return PredefinedUniform::Enum(ii);
  725. }
  726. }
  727. return PredefinedUniform::Count;
  728. }
  729. void EncoderImpl::submit(ViewId _id, ProgramHandle _program, OcclusionQueryHandle _occlusionQuery, int32_t _depth, bool _preserveState)
  730. {
  731. if (BX_ENABLED(BGFX_CONFIG_DEBUG_UNIFORM)
  732. && !_preserveState)
  733. {
  734. m_uniformSet.clear();
  735. }
  736. if (BX_ENABLED(BGFX_CONFIG_DEBUG_OCCLUSION)
  737. && isValid(_occlusionQuery) )
  738. {
  739. BX_CHECK(m_occlusionQuerySet.end() == m_occlusionQuerySet.find(_occlusionQuery.idx)
  740. , "OcclusionQuery %d was already used for this frame."
  741. , _occlusionQuery.idx
  742. );
  743. m_occlusionQuerySet.insert(_occlusionQuery.idx);
  744. }
  745. if (m_discard)
  746. {
  747. discard();
  748. return;
  749. }
  750. if (0 == m_draw.m_numVertices
  751. && 0 == m_draw.m_numIndices)
  752. {
  753. discard();
  754. ++m_numDropped;
  755. return;
  756. }
  757. const uint32_t renderItemIdx = bx::atomicFetchAndAddsat<uint32_t>(&m_frame->m_numRenderItems, 1, BGFX_CONFIG_MAX_DRAW_CALLS);
  758. if (BGFX_CONFIG_MAX_DRAW_CALLS-1 <= renderItemIdx)
  759. {
  760. discard();
  761. ++m_numDropped;
  762. return;
  763. }
  764. ++m_numSubmitted;
  765. UniformBuffer* uniformBuffer = m_frame->m_uniformBuffer[m_uniformIdx];
  766. m_uniformEnd = uniformBuffer->getPos();
  767. m_key.m_program = kInvalidHandle == _program.idx
  768. ? 0
  769. : _program.idx
  770. ;
  771. m_key.m_view = _id;
  772. SortKey::Enum type = SortKey::SortProgram;
  773. switch (s_ctx->m_view[_id].m_mode)
  774. {
  775. case ViewMode::Sequential: m_key.m_seq = s_ctx->getSeqIncr(_id); type = SortKey::SortSequence; break;
  776. case ViewMode::DepthAscending: m_key.m_depth = (uint32_t)_depth; type = SortKey::SortDepth; break;
  777. case ViewMode::DepthDescending: m_key.m_depth = (uint32_t)-_depth; type = SortKey::SortDepth; break;
  778. default: break;
  779. }
  780. uint64_t key = m_key.encodeDraw(type);
  781. m_frame->m_sortKeys[renderItemIdx] = key;
  782. m_frame->m_sortValues[renderItemIdx] = RenderItemCount(renderItemIdx);
  783. m_draw.m_uniformIdx = m_uniformIdx;
  784. m_draw.m_uniformBegin = m_uniformBegin;
  785. m_draw.m_uniformEnd = m_uniformEnd;
  786. if (UINT8_MAX != m_draw.m_streamMask)
  787. {
  788. uint32_t numVertices = UINT32_MAX;
  789. for (uint32_t idx = 0, streamMask = m_draw.m_streamMask, ntz = bx::uint32_cnttz(streamMask)
  790. ; 0 != streamMask
  791. ; streamMask >>= 1, idx += 1, ntz = bx::uint32_cnttz(streamMask)
  792. )
  793. {
  794. streamMask >>= ntz;
  795. idx += ntz;
  796. numVertices = bx::min(numVertices, m_numVertices[idx]);
  797. }
  798. m_draw.m_numVertices = numVertices;
  799. }
  800. else
  801. {
  802. m_draw.m_numVertices = m_numVertices[0];
  803. }
  804. if (isValid(_occlusionQuery) )
  805. {
  806. m_draw.m_stateFlags |= BGFX_STATE_INTERNAL_OCCLUSION_QUERY;
  807. m_draw.m_occlusionQuery = _occlusionQuery;
  808. }
  809. m_frame->m_renderItem[renderItemIdx].draw = m_draw;
  810. m_frame->m_renderItemBind[renderItemIdx] = m_bind;
  811. if (!_preserveState)
  812. {
  813. m_draw.clear();
  814. m_bind.clear();
  815. m_uniformBegin = m_uniformEnd;
  816. }
  817. }
  818. void EncoderImpl::dispatch(ViewId _id, ProgramHandle _handle, uint32_t _numX, uint32_t _numY, uint32_t _numZ, uint8_t _flags)
  819. {
  820. if (BX_ENABLED(BGFX_CONFIG_DEBUG_UNIFORM) )
  821. {
  822. m_uniformSet.clear();
  823. }
  824. if (m_discard)
  825. {
  826. discard();
  827. return;
  828. }
  829. const uint32_t renderItemIdx = bx::atomicFetchAndAddsat<uint32_t>(&m_frame->m_numRenderItems, 1, BGFX_CONFIG_MAX_DRAW_CALLS);
  830. if (BGFX_CONFIG_MAX_DRAW_CALLS-1 <= renderItemIdx)
  831. {
  832. discard();
  833. ++m_numDropped;
  834. return;
  835. }
  836. ++m_numSubmitted;
  837. UniformBuffer* uniformBuffer = m_frame->m_uniformBuffer[m_uniformIdx];
  838. m_uniformEnd = uniformBuffer->getPos();
  839. m_compute.m_startMatrix = m_draw.m_startMatrix;
  840. m_compute.m_numMatrices = m_draw.m_numMatrices;
  841. m_compute.m_numX = bx::max(_numX, 1u);
  842. m_compute.m_numY = bx::max(_numY, 1u);
  843. m_compute.m_numZ = bx::max(_numZ, 1u);
  844. m_compute.m_submitFlags = _flags;
  845. m_key.m_program = _handle.idx;
  846. m_key.m_depth = 0;
  847. m_key.m_view = _id;
  848. m_key.m_seq = s_ctx->getSeqIncr(_id);
  849. uint64_t key = m_key.encodeCompute();
  850. m_frame->m_sortKeys[renderItemIdx] = key;
  851. m_frame->m_sortValues[renderItemIdx] = RenderItemCount(renderItemIdx);
  852. m_compute.m_uniformIdx = m_uniformIdx;
  853. m_compute.m_uniformBegin = m_uniformBegin;
  854. m_compute.m_uniformEnd = m_uniformEnd;
  855. m_frame->m_renderItem[renderItemIdx].compute = m_compute;
  856. m_frame->m_renderItemBind[renderItemIdx] = m_bind;
  857. m_compute.clear();
  858. m_bind.clear();
  859. m_uniformBegin = m_uniformEnd;
  860. }
  861. void EncoderImpl::blit(ViewId _id, TextureHandle _dst, uint8_t _dstMip, uint16_t _dstX, uint16_t _dstY, uint16_t _dstZ, TextureHandle _src, uint8_t _srcMip, uint16_t _srcX, uint16_t _srcY, uint16_t _srcZ, uint16_t _width, uint16_t _height, uint16_t _depth)
  862. {
  863. BX_WARN(m_frame->m_numBlitItems < BGFX_CONFIG_MAX_BLIT_ITEMS
  864. , "Exceed number of available blit items per frame. BGFX_CONFIG_MAX_BLIT_ITEMS is %d. Skipping blit."
  865. , BGFX_CONFIG_MAX_BLIT_ITEMS
  866. );
  867. if (m_frame->m_numBlitItems < BGFX_CONFIG_MAX_BLIT_ITEMS)
  868. {
  869. uint16_t item = m_frame->m_numBlitItems++;
  870. BlitItem& bi = m_frame->m_blitItem[item];
  871. bi.m_srcX = _srcX;
  872. bi.m_srcY = _srcY;
  873. bi.m_srcZ = _srcZ;
  874. bi.m_dstX = _dstX;
  875. bi.m_dstY = _dstY;
  876. bi.m_dstZ = _dstZ;
  877. bi.m_width = _width;
  878. bi.m_height = _height;
  879. bi.m_depth = _depth;
  880. bi.m_srcMip = _srcMip;
  881. bi.m_dstMip = _dstMip;
  882. bi.m_src = _src;
  883. bi.m_dst = _dst;
  884. BlitKey key;
  885. key.m_view = _id;
  886. key.m_item = item;
  887. m_frame->m_blitKeys[item] = key.encode();
  888. }
  889. }
  890. void Frame::sort()
  891. {
  892. BGFX_PROFILER_SCOPE("bgfx/Sort", 0xff2040ff);
  893. ViewId viewRemap[BGFX_CONFIG_MAX_VIEWS];
  894. for (uint32_t ii = 0; ii < BGFX_CONFIG_MAX_VIEWS; ++ii)
  895. {
  896. viewRemap[m_viewRemap[ii] ] = ViewId(ii);
  897. }
  898. for (uint32_t ii = 0, num = m_numRenderItems; ii < num; ++ii)
  899. {
  900. m_sortKeys[ii] = SortKey::remapView(m_sortKeys[ii], viewRemap);
  901. }
  902. bx::radixSort(m_sortKeys, s_ctx->m_tempKeys, m_sortValues, s_ctx->m_tempValues, m_numRenderItems);
  903. for (uint32_t ii = 0, num = m_numBlitItems; ii < num; ++ii)
  904. {
  905. m_blitKeys[ii] = BlitKey::remapView(m_blitKeys[ii], viewRemap);
  906. }
  907. bx::radixSort(m_blitKeys, (uint32_t*)&s_ctx->m_tempKeys, m_numBlitItems);
  908. }
  909. RenderFrame::Enum renderFrame(int32_t _msecs)
  910. {
  911. if (BX_ENABLED(BGFX_CONFIG_MULTITHREADED) )
  912. {
  913. if (s_renderFrameCalled)
  914. {
  915. BGFX_CHECK_RENDER_THREAD();
  916. }
  917. if (NULL == s_ctx)
  918. {
  919. s_renderFrameCalled = true;
  920. s_threadIndex = ~BGFX_API_THREAD_MAGIC;
  921. return RenderFrame::NoContext;
  922. }
  923. int32_t msecs = -1 == _msecs
  924. ? BGFX_CONFIG_API_SEMAPHORE_TIMEOUT
  925. : _msecs
  926. ;
  927. RenderFrame::Enum result = s_ctx->renderFrame(msecs);
  928. if (RenderFrame::Exiting == result)
  929. {
  930. Context* ctx = s_ctx;
  931. ctx->apiSemWait();
  932. s_ctx = NULL;
  933. ctx->renderSemPost();
  934. }
  935. return result;
  936. }
  937. BX_CHECK(false, "This call only makes sense if used with multi-threaded renderer.");
  938. return RenderFrame::NoContext;
  939. }
  940. const uint32_t g_uniformTypeSize[UniformType::Count+1] =
  941. {
  942. sizeof(int32_t),
  943. 0,
  944. 4*sizeof(float),
  945. 3*3*sizeof(float),
  946. 4*4*sizeof(float),
  947. 1,
  948. };
  949. void UniformBuffer::writeUniform(UniformType::Enum _type, uint16_t _loc, const void* _value, uint16_t _num)
  950. {
  951. uint32_t opcode = encodeOpcode(_type, _loc, _num, true);
  952. write(opcode);
  953. write(_value, g_uniformTypeSize[_type]*_num);
  954. }
  955. void UniformBuffer::writeUniformHandle(UniformType::Enum _type, uint16_t _loc, UniformHandle _handle, uint16_t _num)
  956. {
  957. uint32_t opcode = encodeOpcode(_type, _loc, _num, false);
  958. write(opcode);
  959. write(&_handle, sizeof(UniformHandle) );
  960. }
  961. void UniformBuffer::writeMarker(const char* _marker)
  962. {
  963. uint16_t num = (uint16_t)bx::strLen(_marker)+1;
  964. uint32_t opcode = encodeOpcode(bgfx::UniformType::Count, 0, num, true);
  965. write(opcode);
  966. write(_marker, num);
  967. }
  968. struct CapsFlags
  969. {
  970. uint64_t m_flag;
  971. const char* m_str;
  972. };
  973. static const CapsFlags s_capsFlags[] =
  974. {
  975. #define CAPS_FLAGS(_x) { _x, #_x }
  976. CAPS_FLAGS(BGFX_CAPS_ALPHA_TO_COVERAGE),
  977. CAPS_FLAGS(BGFX_CAPS_BLEND_INDEPENDENT),
  978. CAPS_FLAGS(BGFX_CAPS_COMPUTE),
  979. CAPS_FLAGS(BGFX_CAPS_CONSERVATIVE_RASTER),
  980. CAPS_FLAGS(BGFX_CAPS_DRAW_INDIRECT),
  981. CAPS_FLAGS(BGFX_CAPS_FRAGMENT_DEPTH),
  982. CAPS_FLAGS(BGFX_CAPS_FRAGMENT_ORDERING),
  983. CAPS_FLAGS(BGFX_CAPS_GRAPHICS_DEBUGGER),
  984. CAPS_FLAGS(BGFX_CAPS_HDR10),
  985. CAPS_FLAGS(BGFX_CAPS_HIDPI),
  986. CAPS_FLAGS(BGFX_CAPS_INDEX32),
  987. CAPS_FLAGS(BGFX_CAPS_INSTANCING),
  988. CAPS_FLAGS(BGFX_CAPS_OCCLUSION_QUERY),
  989. CAPS_FLAGS(BGFX_CAPS_RENDERER_MULTITHREADED),
  990. CAPS_FLAGS(BGFX_CAPS_SWAP_CHAIN),
  991. CAPS_FLAGS(BGFX_CAPS_TEXTURE_2D_ARRAY),
  992. CAPS_FLAGS(BGFX_CAPS_TEXTURE_3D),
  993. CAPS_FLAGS(BGFX_CAPS_TEXTURE_BLIT),
  994. CAPS_FLAGS(BGFX_CAPS_TEXTURE_COMPARE_ALL),
  995. CAPS_FLAGS(BGFX_CAPS_TEXTURE_COMPARE_LEQUAL),
  996. CAPS_FLAGS(BGFX_CAPS_TEXTURE_CUBE_ARRAY),
  997. CAPS_FLAGS(BGFX_CAPS_TEXTURE_DIRECT_ACCESS),
  998. CAPS_FLAGS(BGFX_CAPS_TEXTURE_READ_BACK),
  999. CAPS_FLAGS(BGFX_CAPS_VERTEX_ATTRIB_HALF),
  1000. CAPS_FLAGS(BGFX_CAPS_VERTEX_ATTRIB_UINT10),
  1001. CAPS_FLAGS(BGFX_CAPS_VERTEX_ID),
  1002. #undef CAPS_FLAGS
  1003. };
  1004. static void dumpCaps()
  1005. {
  1006. BX_TRACE("");
  1007. if (0 < g_caps.numGPUs)
  1008. {
  1009. BX_TRACE("Detected GPUs (%d):", g_caps.numGPUs);
  1010. BX_TRACE("\t +---------------- Index");
  1011. BX_TRACE("\t | +------------- Device ID");
  1012. BX_TRACE("\t | | +-------- Vendor ID");
  1013. for (uint32_t ii = 0; ii < g_caps.numGPUs; ++ii)
  1014. {
  1015. const Caps::GPU& gpu = g_caps.gpu[ii];
  1016. BX_UNUSED(gpu);
  1017. BX_TRACE("\t %d: %04x %04x"
  1018. , ii
  1019. , gpu.deviceId
  1020. , gpu.vendorId
  1021. );
  1022. }
  1023. BX_TRACE("");
  1024. }
  1025. RendererType::Enum renderers[RendererType::Count];
  1026. uint8_t num = getSupportedRenderers(BX_COUNTOF(renderers), renderers);
  1027. BX_TRACE("Supported renderer backends (%d):", num);
  1028. for (uint32_t ii = 0; ii < num; ++ii)
  1029. {
  1030. BX_TRACE("\t - %s", getRendererName(renderers[ii]) );
  1031. }
  1032. BX_TRACE("");
  1033. BX_TRACE("Sort key masks:");
  1034. BX_TRACE("\t View %016" PRIx64, SORT_KEY_VIEW_MASK);
  1035. BX_TRACE("\t Draw bit %016" PRIx64, SORT_KEY_DRAW_BIT);
  1036. BX_TRACE("");
  1037. BX_TRACE("\tD Type %016" PRIx64, SORT_KEY_DRAW_TYPE_MASK);
  1038. BX_TRACE("");
  1039. BX_TRACE("\tD0 Trans %016" PRIx64, SORT_KEY_DRAW_0_TRANS_MASK);
  1040. BX_TRACE("\tD0 Program %016" PRIx64, SORT_KEY_DRAW_0_PROGRAM_MASK);
  1041. BX_TRACE("\tD0 Depth %016" PRIx64, SORT_KEY_DRAW_0_DEPTH_MASK);
  1042. BX_TRACE("");
  1043. BX_TRACE("\tD1 Depth %016" PRIx64, SORT_KEY_DRAW_1_DEPTH_MASK);
  1044. BX_TRACE("\tD1 Trans %016" PRIx64, SORT_KEY_DRAW_1_TRANS_MASK);
  1045. BX_TRACE("\tD1 Program %016" PRIx64, SORT_KEY_DRAW_1_PROGRAM_MASK);
  1046. BX_TRACE("");
  1047. BX_TRACE("\tD2 Seq %016" PRIx64, SORT_KEY_DRAW_2_SEQ_MASK);
  1048. BX_TRACE("\tD2 Trans %016" PRIx64, SORT_KEY_DRAW_2_TRANS_MASK);
  1049. BX_TRACE("\tD2 Program %016" PRIx64, SORT_KEY_DRAW_2_PROGRAM_MASK);
  1050. BX_TRACE("");
  1051. BX_TRACE("\t C Seq %016" PRIx64, SORT_KEY_COMPUTE_SEQ_MASK);
  1052. BX_TRACE("\t C Program %016" PRIx64, SORT_KEY_COMPUTE_PROGRAM_MASK);
  1053. BX_TRACE("");
  1054. BX_TRACE("Supported capabilities (renderer %s, vendor 0x%04x, device 0x%04x):"
  1055. , s_ctx->m_renderCtx->getRendererName()
  1056. , g_caps.vendorId
  1057. , g_caps.deviceId
  1058. );
  1059. for (uint32_t ii = 0; ii < BX_COUNTOF(s_capsFlags); ++ii)
  1060. {
  1061. if (0 != (g_caps.supported & s_capsFlags[ii].m_flag) )
  1062. {
  1063. BX_TRACE("\t%s", s_capsFlags[ii].m_str);
  1064. }
  1065. }
  1066. BX_TRACE("");
  1067. BX_TRACE("Limits:");
  1068. #define LIMITS(_x) BX_TRACE("\t%-24s %d", #_x, g_caps.limits._x)
  1069. LIMITS(maxDrawCalls);
  1070. LIMITS(maxBlits);
  1071. LIMITS(maxTextureSize);
  1072. LIMITS(maxTextureLayers);
  1073. LIMITS(maxViews);
  1074. LIMITS(maxFrameBuffers);
  1075. LIMITS(maxFBAttachments);
  1076. LIMITS(maxPrograms);
  1077. LIMITS(maxShaders);
  1078. LIMITS(maxTextures);
  1079. LIMITS(maxTextureSamplers);
  1080. LIMITS(maxComputeBindings);
  1081. LIMITS(maxVertexDecls);
  1082. LIMITS(maxVertexStreams);
  1083. LIMITS(maxIndexBuffers);
  1084. LIMITS(maxVertexBuffers);
  1085. LIMITS(maxDynamicIndexBuffers);
  1086. LIMITS(maxDynamicVertexBuffers);
  1087. LIMITS(maxUniforms);
  1088. LIMITS(maxOcclusionQueries);
  1089. LIMITS(maxEncoders);
  1090. LIMITS(transientVbSize);
  1091. LIMITS(transientIbSize);
  1092. #undef LIMITS
  1093. BX_TRACE("");
  1094. BX_TRACE("Supported texture formats:");
  1095. BX_TRACE("\t +---------------- 2D: x = supported / * = emulated");
  1096. BX_TRACE("\t |+--------------- 2D: sRGB format");
  1097. BX_TRACE("\t ||+-------------- 3D: x = supported / * = emulated");
  1098. BX_TRACE("\t |||+------------- 3D: sRGB format");
  1099. BX_TRACE("\t ||||+------------ Cube: x = supported / * = emulated");
  1100. BX_TRACE("\t |||||+----------- Cube: sRGB format");
  1101. BX_TRACE("\t ||||||+---------- vertex format");
  1102. BX_TRACE("\t |||||||+--------- image");
  1103. BX_TRACE("\t ||||||||+-------- framebuffer");
  1104. BX_TRACE("\t |||||||||+------- MSAA framebuffer");
  1105. BX_TRACE("\t ||||||||||+------ MSAA texture");
  1106. BX_TRACE("\t |||||||||||+----- Auto-generated mips");
  1107. BX_TRACE("\t |||||||||||| +-- name");
  1108. for (uint32_t ii = 0; ii < TextureFormat::Count; ++ii)
  1109. {
  1110. if (TextureFormat::Unknown != ii
  1111. && TextureFormat::UnknownDepth != ii)
  1112. {
  1113. uint16_t flags = g_caps.formats[ii];
  1114. BX_TRACE("\t[%c%c%c%c%c%c%c%c%c%c%c%c] %s"
  1115. , flags&BGFX_CAPS_FORMAT_TEXTURE_2D ? 'x' : flags&BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED ? '*' : ' '
  1116. , flags&BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB ? 'l' : ' '
  1117. , flags&BGFX_CAPS_FORMAT_TEXTURE_3D ? 'x' : flags&BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED ? '*' : ' '
  1118. , flags&BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB ? 'l' : ' '
  1119. , flags&BGFX_CAPS_FORMAT_TEXTURE_CUBE ? 'x' : flags&BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED ? '*' : ' '
  1120. , flags&BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB ? 'l' : ' '
  1121. , flags&BGFX_CAPS_FORMAT_TEXTURE_VERTEX ? 'v' : ' '
  1122. , flags&BGFX_CAPS_FORMAT_TEXTURE_IMAGE ? 'i' : ' '
  1123. , flags&BGFX_CAPS_FORMAT_TEXTURE_FRAMEBUFFER ? 'f' : ' '
  1124. , flags&BGFX_CAPS_FORMAT_TEXTURE_FRAMEBUFFER_MSAA ? '+' : ' '
  1125. , flags&BGFX_CAPS_FORMAT_TEXTURE_MSAA ? 'm' : ' '
  1126. , flags&BGFX_CAPS_FORMAT_TEXTURE_MIP_AUTOGEN ? 'M' : ' '
  1127. , getName(TextureFormat::Enum(ii) )
  1128. );
  1129. BX_UNUSED(flags);
  1130. }
  1131. }
  1132. BX_TRACE("");
  1133. BX_TRACE("NDC depth [%d, 1], origin %s left."
  1134. , g_caps.homogeneousDepth ? -1 : 0
  1135. , g_caps.originBottomLeft ? "bottom" : "top"
  1136. );
  1137. BX_TRACE("");
  1138. }
  1139. TextureFormat::Enum getViableTextureFormat(const bimg::ImageContainer& _imageContainer)
  1140. {
  1141. const uint32_t formatCaps = g_caps.formats[_imageContainer.m_format];
  1142. bool convert = 0 == formatCaps;
  1143. if (_imageContainer.m_cubeMap)
  1144. {
  1145. convert |= 0 == (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_CUBE)
  1146. && 0 != (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED)
  1147. ;
  1148. }
  1149. else if (_imageContainer.m_depth > 1)
  1150. {
  1151. convert |= 0 == (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_3D)
  1152. && 0 != (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED)
  1153. ;
  1154. }
  1155. else
  1156. {
  1157. convert |= 0 == (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_2D)
  1158. && 0 != (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED)
  1159. ;
  1160. }
  1161. if (convert)
  1162. {
  1163. return TextureFormat::BGRA8;
  1164. }
  1165. return TextureFormat::Enum(_imageContainer.m_format);
  1166. }
  1167. const char* getName(TextureFormat::Enum _fmt)
  1168. {
  1169. return bimg::getName(bimg::TextureFormat::Enum(_fmt));
  1170. }
  1171. const char* getName(UniformHandle _handle)
  1172. {
  1173. return s_ctx->m_uniformRef[_handle.idx].m_name.getPtr();
  1174. }
  1175. static const char* s_topologyName[] =
  1176. {
  1177. "Triangles",
  1178. "TriStrip",
  1179. "Lines",
  1180. "LineStrip",
  1181. "Points",
  1182. };
  1183. BX_STATIC_ASSERT(Topology::Count == BX_COUNTOF(s_topologyName) );
  1184. const char* getName(Topology::Enum _topology)
  1185. {
  1186. return s_topologyName[bx::min(_topology, Topology::PointList)];
  1187. }
  1188. static TextureFormat::Enum s_emulatedFormats[] =
  1189. {
  1190. TextureFormat::BC1,
  1191. TextureFormat::BC2,
  1192. TextureFormat::BC3,
  1193. TextureFormat::BC4,
  1194. TextureFormat::BC5,
  1195. TextureFormat::ETC1,
  1196. TextureFormat::ETC2,
  1197. TextureFormat::ETC2A,
  1198. TextureFormat::ETC2A1,
  1199. TextureFormat::PTC12,
  1200. TextureFormat::PTC14,
  1201. TextureFormat::PTC12A,
  1202. TextureFormat::PTC14A,
  1203. TextureFormat::PTC22,
  1204. TextureFormat::PTC24,
  1205. TextureFormat::ATC,
  1206. TextureFormat::ATCE,
  1207. TextureFormat::ATCI,
  1208. TextureFormat::ASTC4x4,
  1209. TextureFormat::ASTC5x5,
  1210. TextureFormat::ASTC6x6,
  1211. TextureFormat::ASTC8x5,
  1212. TextureFormat::ASTC8x6,
  1213. TextureFormat::ASTC10x5,
  1214. TextureFormat::BGRA8, // GL doesn't support BGRA8 without extensions.
  1215. TextureFormat::RGBA8, // D3D9 doesn't support RGBA8
  1216. };
  1217. bool Context::init(const Init& _init)
  1218. {
  1219. BX_CHECK(!m_rendererInitialized, "Already initialized?");
  1220. m_init = _init;
  1221. m_init.resolution.reset &= ~BGFX_RESET_INTERNAL_FORCE;
  1222. m_exit = false;
  1223. m_flipped = true;
  1224. m_frames = 0;
  1225. m_debug = BGFX_DEBUG_NONE;
  1226. m_frameTimeLast = bx::getHPCounter();
  1227. m_submit->create();
  1228. #if BGFX_CONFIG_MULTITHREADED
  1229. m_render->create();
  1230. if (s_renderFrameCalled)
  1231. {
  1232. // When bgfx::renderFrame is called before init render thread
  1233. // should not be created.
  1234. BX_TRACE("Application called bgfx::renderFrame directly, not creating render thread.");
  1235. m_singleThreaded = true
  1236. && ~BGFX_API_THREAD_MAGIC == s_threadIndex
  1237. ;
  1238. }
  1239. else
  1240. {
  1241. BX_TRACE("Creating rendering thread.");
  1242. m_thread.init(renderThread, this, 0, "bgfx - renderer backend thread");
  1243. m_singleThreaded = false;
  1244. }
  1245. #else
  1246. BX_TRACE("Multithreaded renderer is disabled.");
  1247. m_singleThreaded = true;
  1248. #endif // BGFX_CONFIG_MULTITHREADED
  1249. BX_TRACE("Running in %s-threaded mode", m_singleThreaded ? "single" : "multi");
  1250. s_threadIndex = BGFX_API_THREAD_MAGIC;
  1251. for (uint32_t ii = 0; ii < BX_COUNTOF(m_viewRemap); ++ii)
  1252. {
  1253. m_viewRemap[ii] = ViewId(ii);
  1254. }
  1255. for (uint32_t ii = 0; ii < BGFX_CONFIG_MAX_VIEWS; ++ii)
  1256. {
  1257. resetView(ViewId(ii) );
  1258. }
  1259. for (uint32_t ii = 0; ii < BX_COUNTOF(m_clearColor); ++ii)
  1260. {
  1261. m_clearColor[ii][0] = 0.0f;
  1262. m_clearColor[ii][1] = 0.0f;
  1263. m_clearColor[ii][2] = 0.0f;
  1264. m_clearColor[ii][3] = 1.0f;
  1265. }
  1266. m_declRef.init();
  1267. CommandBuffer& cmdbuf = getCommandBuffer(CommandBuffer::RendererInit);
  1268. cmdbuf.write(_init);
  1269. frameNoRenderWait();
  1270. m_encoderHandle = bx::createHandleAlloc(g_allocator, _init.limits.maxEncoders);
  1271. m_encoder = (EncoderImpl*)BX_ALLOC(g_allocator, sizeof(EncoderImpl)*_init.limits.maxEncoders);
  1272. m_encoderStats = (EncoderStats*)BX_ALLOC(g_allocator, sizeof(EncoderStats)*_init.limits.maxEncoders);
  1273. for (uint32_t ii = 0, num = _init.limits.maxEncoders; ii < num; ++ii)
  1274. {
  1275. BX_PLACEMENT_NEW(&m_encoder[ii], EncoderImpl);
  1276. }
  1277. uint16_t idx = m_encoderHandle->alloc();
  1278. BX_CHECK(0 == idx, "Internal encoder handle is not 0 (idx %d).", idx); BX_UNUSED(idx);
  1279. m_encoder[0].begin(m_submit, 0);
  1280. m_encoder0 = reinterpret_cast<Encoder*>(&m_encoder[0]);
  1281. // Make sure renderer init is called from render thread.
  1282. // g_caps is initialized and available after this point.
  1283. frame();
  1284. if (!m_rendererInitialized)
  1285. {
  1286. getCommandBuffer(CommandBuffer::RendererShutdownEnd);
  1287. frame();
  1288. frame();
  1289. m_declRef.shutdown(m_vertexDeclHandle);
  1290. m_submit->destroy();
  1291. #if BGFX_CONFIG_MULTITHREADED
  1292. m_render->destroy();
  1293. #endif // BGFX_CONFIG_MULTITHREADED
  1294. return false;
  1295. }
  1296. for (uint32_t ii = 0; ii < BX_COUNTOF(s_emulatedFormats); ++ii)
  1297. {
  1298. const uint32_t fmt = s_emulatedFormats[ii];
  1299. g_caps.formats[fmt] |= 0 == (g_caps.formats[fmt] & BGFX_CAPS_FORMAT_TEXTURE_2D ) ? BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED : 0;
  1300. g_caps.formats[fmt] |= 0 == (g_caps.formats[fmt] & BGFX_CAPS_FORMAT_TEXTURE_3D ) ? BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED : 0;
  1301. g_caps.formats[fmt] |= 0 == (g_caps.formats[fmt] & BGFX_CAPS_FORMAT_TEXTURE_CUBE) ? BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED : 0;
  1302. }
  1303. for (uint32_t ii = 0; ii < TextureFormat::UnknownDepth; ++ii)
  1304. {
  1305. bool convertable = bimg::imageConvert(bimg::TextureFormat::BGRA8, bimg::TextureFormat::Enum(ii) );
  1306. g_caps.formats[ii] |= 0 == (g_caps.formats[ii] & BGFX_CAPS_FORMAT_TEXTURE_2D ) && convertable ? BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED : 0;
  1307. g_caps.formats[ii] |= 0 == (g_caps.formats[ii] & BGFX_CAPS_FORMAT_TEXTURE_3D ) && convertable ? BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED : 0;
  1308. g_caps.formats[ii] |= 0 == (g_caps.formats[ii] & BGFX_CAPS_FORMAT_TEXTURE_CUBE) && convertable ? BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED : 0;
  1309. }
  1310. g_caps.rendererType = m_renderCtx->getRendererType();
  1311. initAttribTypeSizeTable(g_caps.rendererType);
  1312. g_caps.supported |= 0
  1313. | (BX_ENABLED(BGFX_CONFIG_MULTITHREADED) && !m_singleThreaded ? BGFX_CAPS_RENDERER_MULTITHREADED : 0)
  1314. | (isGraphicsDebuggerPresent() ? BGFX_CAPS_GRAPHICS_DEBUGGER : 0)
  1315. ;
  1316. dumpCaps();
  1317. m_textVideoMemBlitter.init();
  1318. m_clearQuad.init();
  1319. m_submit->m_transientVb = createTransientVertexBuffer(_init.limits.transientVbSize);
  1320. m_submit->m_transientIb = createTransientIndexBuffer(_init.limits.transientIbSize);
  1321. frame();
  1322. if (BX_ENABLED(BGFX_CONFIG_MULTITHREADED) )
  1323. {
  1324. m_submit->m_transientVb = createTransientVertexBuffer(_init.limits.transientVbSize);
  1325. m_submit->m_transientIb = createTransientIndexBuffer(_init.limits.transientIbSize);
  1326. frame();
  1327. }
  1328. g_internalData.caps = getCaps();
  1329. return true;
  1330. }
  1331. void Context::shutdown()
  1332. {
  1333. getCommandBuffer(CommandBuffer::RendererShutdownBegin);
  1334. frame();
  1335. destroyTransientVertexBuffer(m_submit->m_transientVb);
  1336. destroyTransientIndexBuffer(m_submit->m_transientIb);
  1337. m_textVideoMemBlitter.shutdown();
  1338. m_clearQuad.shutdown();
  1339. frame();
  1340. if (BX_ENABLED(BGFX_CONFIG_MULTITHREADED) )
  1341. {
  1342. destroyTransientVertexBuffer(m_submit->m_transientVb);
  1343. destroyTransientIndexBuffer(m_submit->m_transientIb);
  1344. frame();
  1345. }
  1346. frame(); // If any VertexDecls needs to be destroyed.
  1347. getCommandBuffer(CommandBuffer::RendererShutdownEnd);
  1348. frame();
  1349. m_encoder[0].end(true);
  1350. m_encoderHandle->free(0);
  1351. bx::destroyHandleAlloc(g_allocator, m_encoderHandle);
  1352. m_encoderHandle = NULL;
  1353. for (uint32_t ii = 0, num = g_caps.limits.maxEncoders; ii < num; ++ii)
  1354. {
  1355. m_encoder[ii].~EncoderImpl();
  1356. }
  1357. BX_FREE(g_allocator, m_encoder);
  1358. BX_FREE(g_allocator, m_encoderStats);
  1359. m_dynVertexBufferAllocator.compact();
  1360. m_dynIndexBufferAllocator.compact();
  1361. BX_CHECK(m_vertexDeclHandle.getNumHandles() == m_declRef.m_vertexDeclMap.getNumElements()
  1362. , "VertexDeclRef mismatch, num handles %d, handles in hash map %d."
  1363. , m_vertexDeclHandle.getNumHandles()
  1364. , m_declRef.m_vertexDeclMap.getNumElements()
  1365. );
  1366. m_declRef.shutdown(m_vertexDeclHandle);
  1367. #if BGFX_CONFIG_MULTITHREADED
  1368. // Render thread shutdown sequence.
  1369. renderSemWait(); // Wait for previous frame.
  1370. apiSemPost(); // OK to set context to NULL.
  1371. // s_ctx is NULL here.
  1372. renderSemWait(); // In RenderFrame::Exiting state.
  1373. if (m_thread.isRunning() )
  1374. {
  1375. m_thread.shutdown();
  1376. }
  1377. m_render->destroy();
  1378. #endif // BGFX_CONFIG_MULTITHREADED
  1379. bx::memSet(&g_internalData, 0, sizeof(InternalData) );
  1380. s_ctx = NULL;
  1381. m_submit->destroy();
  1382. if (BX_ENABLED(BGFX_CONFIG_DEBUG) )
  1383. {
  1384. #define CHECK_HANDLE_LEAK(_handleAlloc) \
  1385. BX_MACRO_BLOCK_BEGIN \
  1386. if (0 != _handleAlloc.getNumHandles() ) \
  1387. { \
  1388. BX_TRACE("LEAK: " #_handleAlloc " %d (max: %d)" \
  1389. , _handleAlloc.getNumHandles() \
  1390. , _handleAlloc.getMaxHandles() \
  1391. ); \
  1392. for (uint16_t ii = 0, num = _handleAlloc.getNumHandles(); ii < num; ++ii) \
  1393. { \
  1394. BX_TRACE("\t%3d: %4d", ii, _handleAlloc.getHandleAt(ii) ); \
  1395. } \
  1396. } \
  1397. BX_MACRO_BLOCK_END
  1398. #define CHECK_HANDLE_LEAK_NAME(_handleAlloc, _type, _ref) \
  1399. BX_MACRO_BLOCK_BEGIN \
  1400. if (0 != _handleAlloc.getNumHandles() ) \
  1401. { \
  1402. BX_TRACE("LEAK: " #_handleAlloc " %d (max: %d)" \
  1403. , _handleAlloc.getNumHandles() \
  1404. , _handleAlloc.getMaxHandles() \
  1405. ); \
  1406. for (uint16_t ii = 0, num = _handleAlloc.getNumHandles(); ii < num; ++ii) \
  1407. { \
  1408. uint16_t idx = _handleAlloc.getHandleAt(ii); \
  1409. const _type& ref = _ref[idx]; BX_UNUSED(ref); \
  1410. BX_TRACE("\t%3d: %4d %s (count %d)" \
  1411. , ii \
  1412. , idx \
  1413. , ref.m_name.getPtr() \
  1414. , ref.m_refCount \
  1415. ); \
  1416. } \
  1417. } \
  1418. BX_MACRO_BLOCK_END
  1419. CHECK_HANDLE_LEAK (m_dynamicIndexBufferHandle );
  1420. CHECK_HANDLE_LEAK (m_dynamicVertexBufferHandle );
  1421. CHECK_HANDLE_LEAK (m_indexBufferHandle );
  1422. CHECK_HANDLE_LEAK (m_vertexDeclHandle );
  1423. CHECK_HANDLE_LEAK (m_vertexBufferHandle );
  1424. CHECK_HANDLE_LEAK_NAME(m_shaderHandle, ShaderRef, m_shaderRef );
  1425. CHECK_HANDLE_LEAK (m_programHandle );
  1426. CHECK_HANDLE_LEAK_NAME(m_textureHandle, TextureRef, m_textureRef);
  1427. CHECK_HANDLE_LEAK (m_frameBufferHandle );
  1428. CHECK_HANDLE_LEAK_NAME(m_uniformHandle, UniformRef, m_uniformRef);
  1429. CHECK_HANDLE_LEAK (m_occlusionQueryHandle );
  1430. #undef CHECK_HANDLE_LEAK
  1431. #undef CHECK_HANDLE_LEAK_NAME
  1432. }
  1433. }
  1434. void Context::freeDynamicBuffers()
  1435. {
  1436. for (uint16_t ii = 0, num = m_numFreeDynamicIndexBufferHandles; ii < num; ++ii)
  1437. {
  1438. destroyDynamicIndexBufferInternal(m_freeDynamicIndexBufferHandle[ii]);
  1439. }
  1440. m_numFreeDynamicIndexBufferHandles = 0;
  1441. for (uint16_t ii = 0, num = m_numFreeDynamicVertexBufferHandles; ii < num; ++ii)
  1442. {
  1443. destroyDynamicVertexBufferInternal(m_freeDynamicVertexBufferHandle[ii]);
  1444. }
  1445. m_numFreeDynamicVertexBufferHandles = 0;
  1446. for (uint16_t ii = 0, num = m_numFreeOcclusionQueryHandles; ii < num; ++ii)
  1447. {
  1448. m_occlusionQueryHandle.free(m_freeOcclusionQueryHandle[ii].idx);
  1449. }
  1450. m_numFreeOcclusionQueryHandles = 0;
  1451. }
  1452. void Context::freeAllHandles(Frame* _frame)
  1453. {
  1454. for (uint16_t ii = 0, num = _frame->m_freeIndexBuffer.getNumQueued(); ii < num; ++ii)
  1455. {
  1456. m_indexBufferHandle.free(_frame->m_freeIndexBuffer.get(ii).idx);
  1457. }
  1458. for (uint16_t ii = 0, num = _frame->m_freeVertexBuffer.getNumQueued(); ii < num; ++ii)
  1459. {
  1460. destroyVertexBufferInternal(_frame->m_freeVertexBuffer.get(ii));
  1461. }
  1462. for (uint16_t ii = 0, num = _frame->m_freeVertexDecl.getNumQueued(); ii < num; ++ii)
  1463. {
  1464. m_vertexDeclHandle.free(_frame->m_freeVertexDecl.get(ii).idx);
  1465. }
  1466. for (uint16_t ii = 0, num = _frame->m_freeShader.getNumQueued(); ii < num; ++ii)
  1467. {
  1468. m_shaderHandle.free(_frame->m_freeShader.get(ii).idx);
  1469. }
  1470. for (uint16_t ii = 0, num = _frame->m_freeProgram.getNumQueued(); ii < num; ++ii)
  1471. {
  1472. m_programHandle.free(_frame->m_freeProgram.get(ii).idx);
  1473. }
  1474. for (uint16_t ii = 0, num = _frame->m_freeTexture.getNumQueued(); ii < num; ++ii)
  1475. {
  1476. m_textureHandle.free(_frame->m_freeTexture.get(ii).idx);
  1477. }
  1478. for (uint16_t ii = 0, num = _frame->m_freeFrameBuffer.getNumQueued(); ii < num; ++ii)
  1479. {
  1480. m_frameBufferHandle.free(_frame->m_freeFrameBuffer.get(ii).idx);
  1481. }
  1482. for (uint16_t ii = 0, num = _frame->m_freeUniform.getNumQueued(); ii < num; ++ii)
  1483. {
  1484. m_uniformHandle.free(_frame->m_freeUniform.get(ii).idx);
  1485. }
  1486. }
  1487. Encoder* Context::begin()
  1488. {
  1489. EncoderImpl* encoder = &m_encoder[0];
  1490. #if BGFX_CONFIG_MULTITHREADED
  1491. if (BGFX_API_THREAD_MAGIC != s_threadIndex)
  1492. {
  1493. bx::MutexScope scopeLock(m_encoderApiLock);
  1494. uint16_t idx = m_encoderHandle->alloc();
  1495. if (kInvalidHandle == idx)
  1496. {
  1497. return NULL;
  1498. }
  1499. encoder = &m_encoder[idx];
  1500. encoder->begin(m_submit, uint8_t(idx) );
  1501. }
  1502. #endif // BGFX_CONFIG_MULTITHREADED
  1503. return reinterpret_cast<Encoder*>(encoder);
  1504. }
  1505. void Context::end(Encoder* _encoder)
  1506. {
  1507. #if BGFX_CONFIG_MULTITHREADED
  1508. EncoderImpl* encoder = reinterpret_cast<EncoderImpl*>(_encoder);
  1509. if (encoder != &m_encoder[0])
  1510. {
  1511. encoder->end(true);
  1512. m_encoderEndSem.post();
  1513. }
  1514. #else
  1515. BX_UNUSED(_encoder);
  1516. #endif // BGFX_CONFIG_MULTITHREADED
  1517. }
  1518. uint32_t Context::frame(bool _capture)
  1519. {
  1520. m_encoder[0].end(true);
  1521. #if BGFX_CONFIG_MULTITHREADED
  1522. bx::MutexScope resourceApiScope(m_resourceApiLock);
  1523. encoderApiWait();
  1524. bx::MutexScope encoderApiScope(m_encoderApiLock);
  1525. #else
  1526. encoderApiWait();
  1527. #endif // BGFX_CONFIG_MULTITHREADED
  1528. m_submit->m_capture = _capture;
  1529. BGFX_PROFILER_SCOPE("bgfx/API thread frame", 0xff2040ff);
  1530. // wait for render thread to finish
  1531. renderSemWait();
  1532. frameNoRenderWait();
  1533. m_encoder[0].begin(m_submit, 0);
  1534. return m_frames;
  1535. }
  1536. void Context::frameNoRenderWait()
  1537. {
  1538. swap();
  1539. // release render thread
  1540. apiSemPost();
  1541. }
  1542. void Context::swap()
  1543. {
  1544. freeDynamicBuffers();
  1545. m_submit->m_resolution = m_init.resolution;
  1546. m_init.resolution.reset &= ~BGFX_RESET_INTERNAL_FORCE;
  1547. m_submit->m_debug = m_debug;
  1548. m_submit->m_perfStats.numViews = 0;
  1549. bx::memCopy(m_submit->m_viewRemap, m_viewRemap, sizeof(m_viewRemap) );
  1550. bx::memCopy(m_submit->m_view, m_view, sizeof(m_view) );
  1551. if (m_colorPaletteDirty > 0)
  1552. {
  1553. --m_colorPaletteDirty;
  1554. bx::memCopy(m_submit->m_colorPalette, m_clearColor, sizeof(m_clearColor) );
  1555. }
  1556. freeAllHandles(m_submit);
  1557. m_submit->resetFreeHandles();
  1558. m_submit->finish();
  1559. bx::xchg(m_render, m_submit);
  1560. bx::memCopy(m_render->m_occlusion, m_submit->m_occlusion, sizeof(m_submit->m_occlusion) );
  1561. if (!BX_ENABLED(BGFX_CONFIG_MULTITHREADED)
  1562. || m_singleThreaded)
  1563. {
  1564. renderFrame();
  1565. }
  1566. m_frames++;
  1567. m_submit->start();
  1568. bx::memSet(m_seq, 0, sizeof(m_seq) );
  1569. m_submit->m_textVideoMem->resize(
  1570. m_render->m_textVideoMem->m_small
  1571. , m_init.resolution.width
  1572. , m_init.resolution.height
  1573. );
  1574. int64_t now = bx::getHPCounter();
  1575. m_submit->m_perfStats.cpuTimeFrame = now - m_frameTimeLast;
  1576. m_frameTimeLast = now;
  1577. }
  1578. ///
  1579. RendererContextI* rendererCreate(const Init& _init);
  1580. ///
  1581. void rendererDestroy(RendererContextI* _renderCtx);
  1582. void Context::flip()
  1583. {
  1584. if (m_rendererInitialized
  1585. && !m_flipped)
  1586. {
  1587. m_renderCtx->flip();
  1588. m_flipped = true;
  1589. if (m_renderCtx->isDeviceRemoved() )
  1590. {
  1591. // Something horribly went wrong, fallback to noop renderer.
  1592. rendererDestroy(m_renderCtx);
  1593. Init init;
  1594. init.type = RendererType::Noop;
  1595. m_renderCtx = rendererCreate(init);
  1596. g_caps.rendererType = RendererType::Noop;
  1597. }
  1598. }
  1599. }
  1600. RenderFrame::Enum Context::renderFrame(int32_t _msecs)
  1601. {
  1602. BGFX_PROFILER_SCOPE("bgfx::renderFrame", 0xff2040ff);
  1603. if (!m_flipAfterRender)
  1604. {
  1605. BGFX_PROFILER_SCOPE("bgfx/flip", 0xff2040ff);
  1606. flip();
  1607. }
  1608. if (apiSemWait(_msecs) )
  1609. {
  1610. {
  1611. BGFX_PROFILER_SCOPE("bgfx/Exec commands pre", 0xff2040ff);
  1612. rendererExecCommands(m_render->m_cmdPre);
  1613. }
  1614. if (m_rendererInitialized)
  1615. {
  1616. BGFX_PROFILER_SCOPE("bgfx/Render submit", 0xff2040ff);
  1617. m_renderCtx->submit(m_render, m_clearQuad, m_textVideoMemBlitter);
  1618. m_flipped = false;
  1619. }
  1620. {
  1621. BGFX_PROFILER_SCOPE("bgfx/Exec commands post", 0xff2040ff);
  1622. rendererExecCommands(m_render->m_cmdPost);
  1623. }
  1624. renderSemPost();
  1625. if (m_flipAfterRender)
  1626. {
  1627. BGFX_PROFILER_SCOPE("bgfx/flip", 0xff2040ff);
  1628. flip();
  1629. }
  1630. }
  1631. else
  1632. {
  1633. return RenderFrame::Timeout;
  1634. }
  1635. return m_exit
  1636. ? RenderFrame::Exiting
  1637. : RenderFrame::Render
  1638. ;
  1639. }
  1640. void rendererUpdateUniforms(RendererContextI* _renderCtx, UniformBuffer* _uniformBuffer, uint32_t _begin, uint32_t _end)
  1641. {
  1642. _uniformBuffer->reset(_begin);
  1643. while (_uniformBuffer->getPos() < _end)
  1644. {
  1645. uint32_t opcode = _uniformBuffer->read();
  1646. if (UniformType::End == opcode)
  1647. {
  1648. break;
  1649. }
  1650. UniformType::Enum type;
  1651. uint16_t loc;
  1652. uint16_t num;
  1653. uint16_t copy;
  1654. UniformBuffer::decodeOpcode(opcode, type, loc, num, copy);
  1655. uint32_t size = g_uniformTypeSize[type]*num;
  1656. const char* data = _uniformBuffer->read(size);
  1657. if (UniformType::Count > type)
  1658. {
  1659. if (copy)
  1660. {
  1661. _renderCtx->updateUniform(loc, data, size);
  1662. }
  1663. else
  1664. {
  1665. _renderCtx->updateUniform(loc, *(const char**)(data), size);
  1666. }
  1667. }
  1668. else
  1669. {
  1670. _renderCtx->setMarker(data, size);
  1671. }
  1672. }
  1673. }
  1674. void Context::flushTextureUpdateBatch(CommandBuffer& _cmdbuf)
  1675. {
  1676. if (m_textureUpdateBatch.sort() )
  1677. {
  1678. const uint32_t pos = _cmdbuf.m_pos;
  1679. uint32_t currentKey = UINT32_MAX;
  1680. for (uint32_t ii = 0, num = m_textureUpdateBatch.m_num; ii < num; ++ii)
  1681. {
  1682. _cmdbuf.m_pos = m_textureUpdateBatch.m_values[ii];
  1683. TextureHandle handle;
  1684. _cmdbuf.read(handle);
  1685. uint8_t side;
  1686. _cmdbuf.read(side);
  1687. uint8_t mip;
  1688. _cmdbuf.read(mip);
  1689. Rect rect;
  1690. _cmdbuf.read(rect);
  1691. uint16_t zz;
  1692. _cmdbuf.read(zz);
  1693. uint16_t depth;
  1694. _cmdbuf.read(depth);
  1695. uint16_t pitch;
  1696. _cmdbuf.read(pitch);
  1697. const Memory* mem;
  1698. _cmdbuf.read(mem);
  1699. uint32_t key = m_textureUpdateBatch.m_keys[ii];
  1700. if (key != currentKey)
  1701. {
  1702. if (currentKey != UINT32_MAX)
  1703. {
  1704. m_renderCtx->updateTextureEnd();
  1705. }
  1706. currentKey = key;
  1707. m_renderCtx->updateTextureBegin(handle, side, mip);
  1708. }
  1709. m_renderCtx->updateTexture(handle, side, mip, rect, zz, depth, pitch, mem);
  1710. release(mem);
  1711. }
  1712. if (currentKey != UINT32_MAX)
  1713. {
  1714. m_renderCtx->updateTextureEnd();
  1715. }
  1716. m_textureUpdateBatch.reset();
  1717. _cmdbuf.m_pos = pos;
  1718. }
  1719. }
  1720. typedef RendererContextI* (*RendererCreateFn)(const Init& _init);
  1721. typedef void (*RendererDestroyFn)();
  1722. #define BGFX_RENDERER_CONTEXT(_namespace) \
  1723. namespace _namespace \
  1724. { \
  1725. extern RendererContextI* rendererCreate(const Init& _init); \
  1726. extern void rendererDestroy(); \
  1727. }
  1728. BGFX_RENDERER_CONTEXT(noop);
  1729. BGFX_RENDERER_CONTEXT(d3d9);
  1730. BGFX_RENDERER_CONTEXT(d3d11);
  1731. BGFX_RENDERER_CONTEXT(d3d12);
  1732. BGFX_RENDERER_CONTEXT(mtl);
  1733. BGFX_RENDERER_CONTEXT(gl);
  1734. BGFX_RENDERER_CONTEXT(vk);
  1735. BGFX_RENDERER_CONTEXT(gnm);
  1736. #undef BGFX_RENDERER_CONTEXT
  1737. struct RendererCreator
  1738. {
  1739. RendererCreateFn createFn;
  1740. RendererDestroyFn destroyFn;
  1741. const char* name;
  1742. bool supported;
  1743. };
  1744. static RendererCreator s_rendererCreator[] =
  1745. {
  1746. { noop::rendererCreate, noop::rendererDestroy, BGFX_RENDERER_NOOP_NAME, true }, // Noop
  1747. { d3d9::rendererCreate, d3d9::rendererDestroy, BGFX_RENDERER_DIRECT3D9_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D9 }, // Direct3D9
  1748. { d3d11::rendererCreate, d3d11::rendererDestroy, BGFX_RENDERER_DIRECT3D11_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D11 }, // Direct3D11
  1749. { d3d12::rendererCreate, d3d12::rendererDestroy, BGFX_RENDERER_DIRECT3D12_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D12 }, // Direct3D12
  1750. { gnm::rendererCreate, gnm::rendererDestroy, BGFX_RENDERER_GNM_NAME, !!BGFX_CONFIG_RENDERER_GNM }, // GNM
  1751. #if BX_PLATFORM_OSX || BX_PLATFORM_IOS
  1752. { mtl::rendererCreate, mtl::rendererDestroy, BGFX_RENDERER_METAL_NAME, !!BGFX_CONFIG_RENDERER_METAL }, // Metal
  1753. #else
  1754. { noop::rendererCreate, noop::rendererDestroy, BGFX_RENDERER_NOOP_NAME, false }, // Noop
  1755. #endif // BX_PLATFORM_OSX || BX_PLATFORM_IOS
  1756. { gl::rendererCreate, gl::rendererDestroy, BGFX_RENDERER_OPENGL_NAME, !!BGFX_CONFIG_RENDERER_OPENGLES }, // OpenGLES
  1757. { gl::rendererCreate, gl::rendererDestroy, BGFX_RENDERER_OPENGL_NAME, !!BGFX_CONFIG_RENDERER_OPENGL }, // OpenGL
  1758. { vk::rendererCreate, vk::rendererDestroy, BGFX_RENDERER_VULKAN_NAME, !!BGFX_CONFIG_RENDERER_VULKAN }, // Vulkan
  1759. };
  1760. BX_STATIC_ASSERT(BX_COUNTOF(s_rendererCreator) == RendererType::Count);
  1761. bool windowsVersionIs(Condition::Enum _op, uint32_t _version)
  1762. {
  1763. #if BX_PLATFORM_WINDOWS
  1764. static const uint8_t s_condition[] =
  1765. {
  1766. VER_LESS_EQUAL,
  1767. VER_GREATER_EQUAL,
  1768. };
  1769. OSVERSIONINFOEXA ovi;
  1770. bx::memSet(&ovi, 0, sizeof(ovi) );
  1771. ovi.dwOSVersionInfoSize = sizeof(ovi);
  1772. // _WIN32_WINNT_WINBLUE 0x0603
  1773. // _WIN32_WINNT_WIN8 0x0602
  1774. // _WIN32_WINNT_WIN7 0x0601
  1775. // _WIN32_WINNT_VISTA 0x0600
  1776. ovi.dwMajorVersion = HIBYTE(_version);
  1777. ovi.dwMinorVersion = LOBYTE(_version);
  1778. DWORDLONG cond = 0;
  1779. VER_SET_CONDITION(cond, VER_MAJORVERSION, s_condition[_op]);
  1780. VER_SET_CONDITION(cond, VER_MINORVERSION, s_condition[_op]);
  1781. return !!VerifyVersionInfoA(&ovi, VER_MAJORVERSION | VER_MINORVERSION, cond);
  1782. #else
  1783. BX_UNUSED(_op, _version);
  1784. return false;
  1785. #endif // BX_PLATFORM_WINDOWS
  1786. }
  1787. static int32_t compareDescending(const void* _lhs, const void* _rhs)
  1788. {
  1789. return *(const int32_t*)_rhs - *(const int32_t*)_lhs;
  1790. }
  1791. RendererContextI* rendererCreate(const Init& _init)
  1792. {
  1793. int32_t scores[RendererType::Count];
  1794. uint32_t numScores = 0;
  1795. for (uint32_t ii = 0; ii < RendererType::Count; ++ii)
  1796. {
  1797. RendererType::Enum renderer = RendererType::Enum(ii);
  1798. if (s_rendererCreator[ii].supported)
  1799. {
  1800. int32_t score = 0;
  1801. if (_init.type == renderer)
  1802. {
  1803. score += 1000;
  1804. }
  1805. score += RendererType::Noop != renderer ? 1 : 0;
  1806. if (BX_ENABLED(BX_PLATFORM_WINDOWS) )
  1807. {
  1808. if (windowsVersionIs(Condition::GreaterEqual, 0x0602) )
  1809. {
  1810. score += RendererType::Direct3D11 == renderer ? 20 : 0;
  1811. score += RendererType::Direct3D12 == renderer ? 10 : 0;
  1812. }
  1813. else if (windowsVersionIs(Condition::GreaterEqual, 0x0601) )
  1814. {
  1815. score += RendererType::Direct3D11 == renderer ? 20 : 0;
  1816. score += RendererType::Direct3D9 == renderer ? 10 : 0;
  1817. score += RendererType::Direct3D12 == renderer ? -100 : 0;
  1818. }
  1819. else
  1820. {
  1821. score += RendererType::Direct3D12 == renderer ? -100 : 0;
  1822. }
  1823. }
  1824. else if (BX_ENABLED(BX_PLATFORM_LINUX) )
  1825. {
  1826. score += RendererType::OpenGL == renderer ? 20 : 0;
  1827. score += RendererType::OpenGLES == renderer ? 10 : 0;
  1828. }
  1829. else if (BX_ENABLED(BX_PLATFORM_OSX) )
  1830. {
  1831. score += RendererType::Metal == renderer ? 20 : 0;
  1832. score += RendererType::OpenGL == renderer ? 10 : 0;
  1833. }
  1834. else if (BX_ENABLED(BX_PLATFORM_IOS) )
  1835. {
  1836. score += RendererType::Metal == renderer ? 20 : 0;
  1837. score += RendererType::OpenGLES == renderer ? 10 : 0;
  1838. }
  1839. else if (BX_ENABLED(0
  1840. || BX_PLATFORM_ANDROID
  1841. || BX_PLATFORM_EMSCRIPTEN
  1842. || BX_PLATFORM_RPI
  1843. ) )
  1844. {
  1845. score += RendererType::OpenGLES == renderer ? 20 : 0;
  1846. }
  1847. else if (BX_ENABLED(BX_PLATFORM_PS4) )
  1848. {
  1849. score += RendererType::Gnm == renderer ? 20 : 0;
  1850. }
  1851. else if (BX_ENABLED(0
  1852. || BX_PLATFORM_XBOXONE
  1853. || BX_PLATFORM_WINRT
  1854. ) )
  1855. {
  1856. score += RendererType::Direct3D12 == renderer ? 20 : 0;
  1857. score += RendererType::Direct3D11 == renderer ? 10 : 0;
  1858. }
  1859. scores[numScores++] = (score<<8) | uint8_t(renderer);
  1860. }
  1861. }
  1862. bx::quickSort(scores, numScores, sizeof(int32_t), compareDescending);
  1863. RendererContextI* renderCtx = NULL;
  1864. for (uint32_t ii = 0; ii < numScores; ++ii)
  1865. {
  1866. RendererType::Enum renderer = RendererType::Enum(scores[ii] & 0xff);
  1867. renderCtx = s_rendererCreator[renderer].createFn(_init);
  1868. if (NULL != renderCtx)
  1869. {
  1870. break;
  1871. }
  1872. s_rendererCreator[renderer].supported = false;
  1873. }
  1874. return renderCtx;
  1875. }
  1876. void rendererDestroy(RendererContextI* _renderCtx)
  1877. {
  1878. if (NULL != _renderCtx)
  1879. {
  1880. s_rendererCreator[_renderCtx->getRendererType()].destroyFn();
  1881. }
  1882. }
  1883. void Context::rendererExecCommands(CommandBuffer& _cmdbuf)
  1884. {
  1885. _cmdbuf.reset();
  1886. bool end = false;
  1887. if (NULL == m_renderCtx)
  1888. {
  1889. uint8_t command;
  1890. _cmdbuf.read(command);
  1891. switch (command)
  1892. {
  1893. case CommandBuffer::RendererShutdownEnd:
  1894. m_exit = true;
  1895. return;
  1896. case CommandBuffer::End:
  1897. return;
  1898. default:
  1899. {
  1900. BX_CHECK(CommandBuffer::RendererInit == command
  1901. , "RendererInit must be the first command in command buffer before initialization. Unexpected command %d?"
  1902. , command
  1903. );
  1904. BX_CHECK(!m_rendererInitialized, "This shouldn't happen! Bad synchronization?");
  1905. Init init;
  1906. _cmdbuf.read(init);
  1907. m_renderCtx = rendererCreate(init);
  1908. m_rendererInitialized = NULL != m_renderCtx;
  1909. if (!m_rendererInitialized)
  1910. {
  1911. _cmdbuf.read(command);
  1912. BX_CHECK(CommandBuffer::End == command, "Unexpected command %d?"
  1913. , command
  1914. );
  1915. return;
  1916. }
  1917. }
  1918. break;
  1919. }
  1920. }
  1921. do
  1922. {
  1923. uint8_t command;
  1924. _cmdbuf.read(command);
  1925. switch (command)
  1926. {
  1927. case CommandBuffer::RendererShutdownBegin:
  1928. {
  1929. BX_CHECK(m_rendererInitialized, "This shouldn't happen! Bad synchronization?");
  1930. m_rendererInitialized = false;
  1931. }
  1932. break;
  1933. case CommandBuffer::RendererShutdownEnd:
  1934. {
  1935. BX_CHECK(!m_rendererInitialized && !m_exit, "This shouldn't happen! Bad synchronization?");
  1936. rendererDestroy(m_renderCtx);
  1937. m_renderCtx = NULL;
  1938. m_exit = true;
  1939. }
  1940. BX_FALLTHROUGH;
  1941. case CommandBuffer::End:
  1942. end = true;
  1943. break;
  1944. case CommandBuffer::CreateIndexBuffer:
  1945. {
  1946. IndexBufferHandle handle;
  1947. _cmdbuf.read(handle);
  1948. const Memory* mem;
  1949. _cmdbuf.read(mem);
  1950. uint16_t flags;
  1951. _cmdbuf.read(flags);
  1952. m_renderCtx->createIndexBuffer(handle, mem, flags);
  1953. release(mem);
  1954. }
  1955. break;
  1956. case CommandBuffer::DestroyIndexBuffer:
  1957. {
  1958. IndexBufferHandle handle;
  1959. _cmdbuf.read(handle);
  1960. m_renderCtx->destroyIndexBuffer(handle);
  1961. }
  1962. break;
  1963. case CommandBuffer::CreateVertexDecl:
  1964. {
  1965. VertexDeclHandle handle;
  1966. _cmdbuf.read(handle);
  1967. VertexDecl decl;
  1968. _cmdbuf.read(decl);
  1969. m_renderCtx->createVertexDecl(handle, decl);
  1970. }
  1971. break;
  1972. case CommandBuffer::DestroyVertexDecl:
  1973. {
  1974. VertexDeclHandle handle;
  1975. _cmdbuf.read(handle);
  1976. m_renderCtx->destroyVertexDecl(handle);
  1977. }
  1978. break;
  1979. case CommandBuffer::CreateVertexBuffer:
  1980. {
  1981. VertexBufferHandle handle;
  1982. _cmdbuf.read(handle);
  1983. const Memory* mem;
  1984. _cmdbuf.read(mem);
  1985. VertexDeclHandle declHandle;
  1986. _cmdbuf.read(declHandle);
  1987. uint16_t flags;
  1988. _cmdbuf.read(flags);
  1989. m_renderCtx->createVertexBuffer(handle, mem, declHandle, flags);
  1990. release(mem);
  1991. }
  1992. break;
  1993. case CommandBuffer::DestroyVertexBuffer:
  1994. {
  1995. VertexBufferHandle handle;
  1996. _cmdbuf.read(handle);
  1997. m_renderCtx->destroyVertexBuffer(handle);
  1998. }
  1999. break;
  2000. case CommandBuffer::CreateDynamicIndexBuffer:
  2001. {
  2002. IndexBufferHandle handle;
  2003. _cmdbuf.read(handle);
  2004. uint32_t size;
  2005. _cmdbuf.read(size);
  2006. uint16_t flags;
  2007. _cmdbuf.read(flags);
  2008. m_renderCtx->createDynamicIndexBuffer(handle, size, flags);
  2009. }
  2010. break;
  2011. case CommandBuffer::UpdateDynamicIndexBuffer:
  2012. {
  2013. IndexBufferHandle handle;
  2014. _cmdbuf.read(handle);
  2015. uint32_t offset;
  2016. _cmdbuf.read(offset);
  2017. uint32_t size;
  2018. _cmdbuf.read(size);
  2019. const Memory* mem;
  2020. _cmdbuf.read(mem);
  2021. m_renderCtx->updateDynamicIndexBuffer(handle, offset, size, mem);
  2022. release(mem);
  2023. }
  2024. break;
  2025. case CommandBuffer::DestroyDynamicIndexBuffer:
  2026. {
  2027. IndexBufferHandle handle;
  2028. _cmdbuf.read(handle);
  2029. m_renderCtx->destroyDynamicIndexBuffer(handle);
  2030. }
  2031. break;
  2032. case CommandBuffer::CreateDynamicVertexBuffer:
  2033. {
  2034. VertexBufferHandle handle;
  2035. _cmdbuf.read(handle);
  2036. uint32_t size;
  2037. _cmdbuf.read(size);
  2038. uint16_t flags;
  2039. _cmdbuf.read(flags);
  2040. m_renderCtx->createDynamicVertexBuffer(handle, size, flags);
  2041. }
  2042. break;
  2043. case CommandBuffer::UpdateDynamicVertexBuffer:
  2044. {
  2045. VertexBufferHandle handle;
  2046. _cmdbuf.read(handle);
  2047. uint32_t offset;
  2048. _cmdbuf.read(offset);
  2049. uint32_t size;
  2050. _cmdbuf.read(size);
  2051. const Memory* mem;
  2052. _cmdbuf.read(mem);
  2053. m_renderCtx->updateDynamicVertexBuffer(handle, offset, size, mem);
  2054. release(mem);
  2055. }
  2056. break;
  2057. case CommandBuffer::DestroyDynamicVertexBuffer:
  2058. {
  2059. VertexBufferHandle handle;
  2060. _cmdbuf.read(handle);
  2061. m_renderCtx->destroyDynamicVertexBuffer(handle);
  2062. }
  2063. break;
  2064. case CommandBuffer::CreateShader:
  2065. {
  2066. ShaderHandle handle;
  2067. _cmdbuf.read(handle);
  2068. const Memory* mem;
  2069. _cmdbuf.read(mem);
  2070. m_renderCtx->createShader(handle, mem);
  2071. release(mem);
  2072. }
  2073. break;
  2074. case CommandBuffer::DestroyShader:
  2075. {
  2076. ShaderHandle handle;
  2077. _cmdbuf.read(handle);
  2078. m_renderCtx->destroyShader(handle);
  2079. }
  2080. break;
  2081. case CommandBuffer::CreateProgram:
  2082. {
  2083. ProgramHandle handle;
  2084. _cmdbuf.read(handle);
  2085. ShaderHandle vsh;
  2086. _cmdbuf.read(vsh);
  2087. ShaderHandle fsh;
  2088. _cmdbuf.read(fsh);
  2089. m_renderCtx->createProgram(handle, vsh, fsh);
  2090. }
  2091. break;
  2092. case CommandBuffer::DestroyProgram:
  2093. {
  2094. ProgramHandle handle;
  2095. _cmdbuf.read(handle);
  2096. m_renderCtx->destroyProgram(handle);
  2097. }
  2098. break;
  2099. case CommandBuffer::CreateTexture:
  2100. {
  2101. TextureHandle handle;
  2102. _cmdbuf.read(handle);
  2103. const Memory* mem;
  2104. _cmdbuf.read(mem);
  2105. uint64_t flags;
  2106. _cmdbuf.read(flags);
  2107. uint8_t skip;
  2108. _cmdbuf.read(skip);
  2109. void* ptr = m_renderCtx->createTexture(handle, mem, flags, skip);
  2110. if (NULL != ptr)
  2111. {
  2112. setDirectAccessPtr(handle, ptr);
  2113. }
  2114. bx::MemoryReader reader(mem->data, mem->size);
  2115. uint32_t magic;
  2116. bx::read(&reader, magic);
  2117. if (BGFX_CHUNK_MAGIC_TEX == magic)
  2118. {
  2119. TextureCreate tc;
  2120. bx::read(&reader, tc);
  2121. if (NULL != tc.m_mem)
  2122. {
  2123. release(tc.m_mem);
  2124. }
  2125. }
  2126. release(mem);
  2127. }
  2128. break;
  2129. case CommandBuffer::UpdateTexture:
  2130. {
  2131. if (m_textureUpdateBatch.isFull() )
  2132. {
  2133. flushTextureUpdateBatch(_cmdbuf);
  2134. }
  2135. uint32_t value = _cmdbuf.m_pos;
  2136. TextureHandle handle;
  2137. _cmdbuf.read(handle);
  2138. uint8_t side;
  2139. _cmdbuf.read(side);
  2140. uint8_t mip;
  2141. _cmdbuf.read(mip);
  2142. _cmdbuf.skip<Rect>();
  2143. _cmdbuf.skip<uint16_t>();
  2144. _cmdbuf.skip<uint16_t>();
  2145. _cmdbuf.skip<uint16_t>();
  2146. _cmdbuf.skip<Memory*>();
  2147. uint32_t key = (handle.idx<<16)
  2148. | (side<<8)
  2149. | mip
  2150. ;
  2151. m_textureUpdateBatch.add(key, value);
  2152. }
  2153. break;
  2154. case CommandBuffer::ReadTexture:
  2155. {
  2156. TextureHandle handle;
  2157. _cmdbuf.read(handle);
  2158. void* data;
  2159. _cmdbuf.read(data);
  2160. uint8_t mip;
  2161. _cmdbuf.read(mip);
  2162. m_renderCtx->readTexture(handle, data, mip);
  2163. }
  2164. break;
  2165. case CommandBuffer::ResizeTexture:
  2166. {
  2167. TextureHandle handle;
  2168. _cmdbuf.read(handle);
  2169. uint16_t width;
  2170. _cmdbuf.read(width);
  2171. uint16_t height;
  2172. _cmdbuf.read(height);
  2173. uint8_t numMips;
  2174. _cmdbuf.read(numMips);
  2175. m_renderCtx->resizeTexture(handle, width, height, numMips);
  2176. }
  2177. break;
  2178. case CommandBuffer::DestroyTexture:
  2179. {
  2180. TextureHandle handle;
  2181. _cmdbuf.read(handle);
  2182. m_renderCtx->destroyTexture(handle);
  2183. }
  2184. break;
  2185. case CommandBuffer::CreateFrameBuffer:
  2186. {
  2187. FrameBufferHandle handle;
  2188. _cmdbuf.read(handle);
  2189. bool window;
  2190. _cmdbuf.read(window);
  2191. if (window)
  2192. {
  2193. void* nwh;
  2194. _cmdbuf.read(nwh);
  2195. uint16_t width;
  2196. _cmdbuf.read(width);
  2197. uint16_t height;
  2198. _cmdbuf.read(height);
  2199. TextureFormat::Enum format;
  2200. _cmdbuf.read(format);
  2201. TextureFormat::Enum depthFormat;
  2202. _cmdbuf.read(depthFormat);
  2203. m_renderCtx->createFrameBuffer(handle, nwh, width, height, format, depthFormat);
  2204. }
  2205. else
  2206. {
  2207. uint8_t num;
  2208. _cmdbuf.read(num);
  2209. Attachment attachment[BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS];
  2210. _cmdbuf.read(attachment, sizeof(Attachment) * num);
  2211. m_renderCtx->createFrameBuffer(handle, num, attachment);
  2212. }
  2213. }
  2214. break;
  2215. case CommandBuffer::DestroyFrameBuffer:
  2216. {
  2217. FrameBufferHandle handle;
  2218. _cmdbuf.read(handle);
  2219. m_renderCtx->destroyFrameBuffer(handle);
  2220. }
  2221. break;
  2222. case CommandBuffer::CreateUniform:
  2223. {
  2224. UniformHandle handle;
  2225. _cmdbuf.read(handle);
  2226. UniformType::Enum type;
  2227. _cmdbuf.read(type);
  2228. uint16_t num;
  2229. _cmdbuf.read(num);
  2230. uint8_t len;
  2231. _cmdbuf.read(len);
  2232. const char* name = (const char*)_cmdbuf.skip(len);
  2233. m_renderCtx->createUniform(handle, type, num, name);
  2234. }
  2235. break;
  2236. case CommandBuffer::DestroyUniform:
  2237. {
  2238. UniformHandle handle;
  2239. _cmdbuf.read(handle);
  2240. m_renderCtx->destroyUniform(handle);
  2241. }
  2242. break;
  2243. case CommandBuffer::RequestScreenShot:
  2244. {
  2245. FrameBufferHandle handle;
  2246. _cmdbuf.read(handle);
  2247. uint16_t len;
  2248. _cmdbuf.read(len);
  2249. const char* filePath = (const char*)_cmdbuf.skip(len);
  2250. m_renderCtx->requestScreenShot(handle, filePath);
  2251. }
  2252. break;
  2253. case CommandBuffer::UpdateViewName:
  2254. {
  2255. ViewId id;
  2256. _cmdbuf.read(id);
  2257. uint16_t len;
  2258. _cmdbuf.read(len);
  2259. const char* name = (const char*)_cmdbuf.skip(len);
  2260. m_renderCtx->updateViewName(id, name);
  2261. }
  2262. break;
  2263. case CommandBuffer::InvalidateOcclusionQuery:
  2264. {
  2265. OcclusionQueryHandle handle;
  2266. _cmdbuf.read(handle);
  2267. m_renderCtx->invalidateOcclusionQuery(handle);
  2268. }
  2269. break;
  2270. case CommandBuffer::SetName:
  2271. {
  2272. Handle handle;
  2273. _cmdbuf.read(handle);
  2274. uint16_t len;
  2275. _cmdbuf.read(len);
  2276. const char* name = (const char*)_cmdbuf.skip(len);
  2277. m_renderCtx->setName(handle, name);
  2278. }
  2279. break;
  2280. default:
  2281. BX_CHECK(false, "Invalid command: %d", command);
  2282. break;
  2283. }
  2284. } while (!end);
  2285. flushTextureUpdateBatch(_cmdbuf);
  2286. }
  2287. uint32_t topologyConvert(TopologyConvert::Enum _conversion, void* _dst, uint32_t _dstSize, const void* _indices, uint32_t _numIndices, bool _index32)
  2288. {
  2289. return topologyConvert(_conversion, _dst, _dstSize, _indices, _numIndices, _index32, g_allocator);
  2290. }
  2291. void topologySortTriList(TopologySort::Enum _sort, void* _dst, uint32_t _dstSize, const float _dir[3], const float _pos[3], const void* _vertices, uint32_t _stride, const void* _indices, uint32_t _numIndices, bool _index32)
  2292. {
  2293. topologySortTriList(_sort, _dst, _dstSize, _dir, _pos, _vertices, _stride, _indices, _numIndices, _index32, g_allocator);
  2294. }
  2295. uint8_t getSupportedRenderers(uint8_t _max, RendererType::Enum* _enum)
  2296. {
  2297. _enum = _max == 0 ? NULL : _enum;
  2298. uint8_t num = 0;
  2299. for (uint8_t ii = 0; ii < RendererType::Count; ++ii)
  2300. {
  2301. if ( (RendererType::Direct3D11 == ii || RendererType::Direct3D12 == ii)
  2302. && windowsVersionIs(Condition::LessEqual, 0x0502) )
  2303. {
  2304. continue;
  2305. }
  2306. if (NULL == _enum)
  2307. {
  2308. num++;
  2309. }
  2310. else
  2311. {
  2312. if (num < _max
  2313. && s_rendererCreator[ii].supported)
  2314. {
  2315. _enum[num++] = RendererType::Enum(ii);
  2316. }
  2317. }
  2318. }
  2319. return num;
  2320. }
  2321. const char* getRendererName(RendererType::Enum _type)
  2322. {
  2323. BX_CHECK(_type < RendererType::Count, "Invalid renderer type %d.", _type);
  2324. return s_rendererCreator[_type].name;
  2325. }
  2326. Resolution::Resolution()
  2327. : format(TextureFormat::RGBA8)
  2328. , width(1280)
  2329. , height(720)
  2330. , reset(BGFX_RESET_NONE)
  2331. {
  2332. }
  2333. Init::Init()
  2334. : type(RendererType::Count)
  2335. , vendorId(BGFX_PCI_ID_NONE)
  2336. , deviceId(0)
  2337. , debug(BX_ENABLED(BGFX_CONFIG_DEBUG) )
  2338. , profile(BX_ENABLED(BGFX_CONFIG_DEBUG_PIX) )
  2339. , callback(NULL)
  2340. , allocator(NULL)
  2341. {
  2342. limits.maxEncoders = BGFX_CONFIG_DEFAULT_MAX_ENCODERS;
  2343. limits.transientVbSize = BGFX_CONFIG_TRANSIENT_VERTEX_BUFFER_SIZE;
  2344. limits.transientIbSize = BGFX_CONFIG_TRANSIENT_INDEX_BUFFER_SIZE;
  2345. }
  2346. bool init(const Init& _init)
  2347. {
  2348. if (NULL != s_ctx)
  2349. {
  2350. BX_TRACE("bgfx is already initialized.");
  2351. return false;
  2352. }
  2353. if (1 <= _init.limits.maxEncoders
  2354. && 128 <= _init.limits.maxEncoders)
  2355. {
  2356. BX_TRACE("init.limits.maxEncoders must be between 1 and 128.");
  2357. return false;
  2358. }
  2359. struct ErrorState
  2360. {
  2361. enum Enum
  2362. {
  2363. Default,
  2364. ContextAllocated,
  2365. };
  2366. };
  2367. ErrorState::Enum errorState = ErrorState::Default;
  2368. if (NULL != _init.allocator)
  2369. {
  2370. g_allocator = _init.allocator;
  2371. }
  2372. else
  2373. {
  2374. bx::DefaultAllocator allocator;
  2375. g_allocator =
  2376. s_allocatorStub = BX_NEW(&allocator, AllocatorStub);
  2377. }
  2378. if (NULL != _init.callback)
  2379. {
  2380. g_callback = _init.callback;
  2381. }
  2382. else
  2383. {
  2384. g_callback =
  2385. s_callbackStub = BX_NEW(g_allocator, CallbackStub);
  2386. }
  2387. if (true
  2388. && !BX_ENABLED(BX_PLATFORM_EMSCRIPTEN || BX_PLATFORM_PS4)
  2389. && RendererType::Noop != _init.type
  2390. && NULL == g_platformData.ndt
  2391. && NULL == g_platformData.nwh
  2392. && NULL == g_platformData.context
  2393. && NULL == g_platformData.backBuffer
  2394. && NULL == g_platformData.backBufferDS
  2395. )
  2396. {
  2397. BX_TRACE("bgfx platform data like window handle or backbuffer is not set, creating headless device.");
  2398. }
  2399. bx::memSet(&g_caps, 0, sizeof(g_caps) );
  2400. g_caps.limits.maxDrawCalls = BGFX_CONFIG_MAX_DRAW_CALLS;
  2401. g_caps.limits.maxBlits = BGFX_CONFIG_MAX_BLIT_ITEMS;
  2402. g_caps.limits.maxTextureSize = 0;
  2403. g_caps.limits.maxTextureLayers = 1;
  2404. g_caps.limits.maxViews = BGFX_CONFIG_MAX_VIEWS;
  2405. g_caps.limits.maxFrameBuffers = BGFX_CONFIG_MAX_FRAME_BUFFERS;
  2406. g_caps.limits.maxPrograms = BGFX_CONFIG_MAX_PROGRAMS;
  2407. g_caps.limits.maxShaders = BGFX_CONFIG_MAX_SHADERS;
  2408. g_caps.limits.maxTextures = BGFX_CONFIG_MAX_TEXTURES;
  2409. g_caps.limits.maxTextureSamplers = BGFX_CONFIG_MAX_TEXTURE_SAMPLERS;
  2410. g_caps.limits.maxComputeBindings = 0;
  2411. g_caps.limits.maxVertexDecls = BGFX_CONFIG_MAX_VERTEX_DECLS;
  2412. g_caps.limits.maxVertexStreams = 1;
  2413. g_caps.limits.maxIndexBuffers = BGFX_CONFIG_MAX_INDEX_BUFFERS;
  2414. g_caps.limits.maxVertexBuffers = BGFX_CONFIG_MAX_VERTEX_BUFFERS;
  2415. g_caps.limits.maxDynamicIndexBuffers = BGFX_CONFIG_MAX_DYNAMIC_INDEX_BUFFERS;
  2416. g_caps.limits.maxDynamicVertexBuffers = BGFX_CONFIG_MAX_DYNAMIC_VERTEX_BUFFERS;
  2417. g_caps.limits.maxUniforms = BGFX_CONFIG_MAX_UNIFORMS;
  2418. g_caps.limits.maxOcclusionQueries = BGFX_CONFIG_MAX_OCCLUSION_QUERIES;
  2419. g_caps.limits.maxFBAttachments = 1;
  2420. g_caps.limits.maxEncoders = (0 != BGFX_CONFIG_MULTITHREADED) ? _init.limits.maxEncoders : 1;
  2421. g_caps.limits.transientVbSize = _init.limits.transientVbSize;
  2422. g_caps.limits.transientIbSize = _init.limits.transientIbSize;
  2423. g_caps.vendorId = _init.vendorId;
  2424. g_caps.deviceId = _init.deviceId;
  2425. BX_TRACE("Init...");
  2426. errorState = ErrorState::ContextAllocated;
  2427. s_ctx = BX_ALIGNED_NEW(g_allocator, Context, 64);
  2428. if (s_ctx->init(_init) )
  2429. {
  2430. BX_TRACE("Init complete.");
  2431. return true;
  2432. }
  2433. //error:
  2434. BX_TRACE("Init failed.");
  2435. switch (errorState)
  2436. {
  2437. case ErrorState::ContextAllocated:
  2438. BX_ALIGNED_DELETE(g_allocator, s_ctx, 64);
  2439. s_ctx = NULL;
  2440. BX_FALLTHROUGH;
  2441. case ErrorState::Default:
  2442. if (NULL != s_callbackStub)
  2443. {
  2444. BX_DELETE(g_allocator, s_callbackStub);
  2445. s_callbackStub = NULL;
  2446. }
  2447. if (NULL != s_allocatorStub)
  2448. {
  2449. bx::DefaultAllocator allocator;
  2450. BX_DELETE(&allocator, s_allocatorStub);
  2451. s_allocatorStub = NULL;
  2452. }
  2453. s_renderFrameCalled = false;
  2454. s_threadIndex = 0;
  2455. g_callback = NULL;
  2456. g_allocator = NULL;
  2457. break;
  2458. }
  2459. return false;
  2460. }
  2461. void shutdown()
  2462. {
  2463. BX_TRACE("Shutdown...");
  2464. BGFX_CHECK_API_THREAD();
  2465. Context* ctx = s_ctx; // it's going to be NULLd inside shutdown.
  2466. ctx->shutdown();
  2467. BX_CHECK(NULL == s_ctx, "bgfx is should be uninitialized here.");
  2468. BX_ALIGNED_DELETE(g_allocator, ctx, 16);
  2469. BX_TRACE("Shutdown complete.");
  2470. if (NULL != s_allocatorStub)
  2471. {
  2472. s_allocatorStub->checkLeaks();
  2473. }
  2474. if (NULL != s_callbackStub)
  2475. {
  2476. BX_DELETE(g_allocator, s_callbackStub);
  2477. s_callbackStub = NULL;
  2478. }
  2479. if (NULL != s_allocatorStub)
  2480. {
  2481. bx::DefaultAllocator allocator;
  2482. BX_DELETE(&allocator, s_allocatorStub);
  2483. s_allocatorStub = NULL;
  2484. }
  2485. s_renderFrameCalled = false;
  2486. s_threadIndex = 0;
  2487. g_callback = NULL;
  2488. g_allocator = NULL;
  2489. }
  2490. void reset(uint32_t _width, uint32_t _height, uint32_t _flags, TextureFormat::Enum _format)
  2491. {
  2492. BGFX_CHECK_API_THREAD();
  2493. BX_CHECK(0 == (_flags&BGFX_RESET_RESERVED_MASK), "Do not set reset reserved flags!");
  2494. s_ctx->reset(_width, _height, _flags, _format);
  2495. }
  2496. Encoder* begin()
  2497. {
  2498. return s_ctx->begin();
  2499. }
  2500. #define BGFX_ENCODER(_func) reinterpret_cast<EncoderImpl*>(this)->_func
  2501. void Encoder::setMarker(const char* _marker)
  2502. {
  2503. BGFX_ENCODER(setMarker(_marker) );
  2504. }
  2505. void Encoder::setState(uint64_t _state, uint32_t _rgba)
  2506. {
  2507. BX_CHECK(0 == (_state&BGFX_STATE_RESERVED_MASK), "Do not set state reserved flags!");
  2508. BGFX_ENCODER(setState(_state, _rgba) );
  2509. }
  2510. void Encoder::setCondition(OcclusionQueryHandle _handle, bool _visible)
  2511. {
  2512. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  2513. BGFX_ENCODER(setCondition(_handle, _visible) );
  2514. }
  2515. void Encoder::setStencil(uint32_t _fstencil, uint32_t _bstencil)
  2516. {
  2517. BGFX_ENCODER(setStencil(_fstencil, _bstencil) );
  2518. }
  2519. uint16_t Encoder::setScissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  2520. {
  2521. return BGFX_ENCODER(setScissor(_x, _y, _width, _height) );
  2522. }
  2523. void Encoder::setScissor(uint16_t _cache)
  2524. {
  2525. BGFX_ENCODER(setScissor(_cache) );
  2526. }
  2527. uint32_t Encoder::setTransform(const void* _mtx, uint16_t _num)
  2528. {
  2529. return BGFX_ENCODER(setTransform(_mtx, _num) );
  2530. }
  2531. uint32_t Encoder::allocTransform(Transform* _transform, uint16_t _num)
  2532. {
  2533. return BGFX_ENCODER(allocTransform(_transform, _num) );
  2534. }
  2535. void Encoder::setTransform(uint32_t _cache, uint16_t _num)
  2536. {
  2537. BGFX_ENCODER(setTransform(_cache, _num) );
  2538. }
  2539. void Encoder::setUniform(UniformHandle _handle, const void* _value, uint16_t _num)
  2540. {
  2541. BGFX_CHECK_HANDLE("setUniform", s_ctx->m_uniformHandle, _handle);
  2542. const Context::UniformRef& uniform = s_ctx->m_uniformRef[_handle.idx];
  2543. BX_CHECK(isValid(_handle) && 0 < uniform.m_refCount, "Setting invalid uniform (handle %3d)!", _handle.idx);
  2544. BX_CHECK(_num == UINT16_MAX || uniform.m_num >= _num, "Truncated uniform update. %d (max: %d)", _num, uniform.m_num);
  2545. BGFX_ENCODER(setUniform(uniform.m_type, _handle, _value, UINT16_MAX != _num ? _num : uniform.m_num) );
  2546. }
  2547. void Encoder::setIndexBuffer(IndexBufferHandle _handle)
  2548. {
  2549. setIndexBuffer(_handle, 0, UINT32_MAX);
  2550. }
  2551. void Encoder::setIndexBuffer(IndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  2552. {
  2553. BGFX_CHECK_HANDLE("setIndexBuffer", s_ctx->m_indexBufferHandle, _handle);
  2554. BGFX_ENCODER(setIndexBuffer(_handle, _firstIndex, _numIndices) );
  2555. }
  2556. void Encoder::setIndexBuffer(DynamicIndexBufferHandle _handle)
  2557. {
  2558. setIndexBuffer(_handle, 0, UINT32_MAX);
  2559. }
  2560. void Encoder::setIndexBuffer(DynamicIndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  2561. {
  2562. BGFX_CHECK_HANDLE("setIndexBuffer", s_ctx->m_dynamicIndexBufferHandle, _handle);
  2563. const DynamicIndexBuffer& dib = s_ctx->m_dynamicIndexBuffers[_handle.idx];
  2564. BGFX_ENCODER(setIndexBuffer(dib, _firstIndex, _numIndices) );
  2565. }
  2566. void Encoder::setIndexBuffer(const TransientIndexBuffer* _tib)
  2567. {
  2568. setIndexBuffer(_tib, 0, UINT32_MAX);
  2569. }
  2570. void Encoder::setIndexBuffer(const TransientIndexBuffer* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  2571. {
  2572. BX_CHECK(NULL != _tib, "_tib can't be NULL");
  2573. BGFX_CHECK_HANDLE("setIndexBuffer", s_ctx->m_indexBufferHandle, _tib->handle);
  2574. BGFX_ENCODER(setIndexBuffer(_tib, _firstIndex, _numIndices) );
  2575. }
  2576. void Encoder::setVertexBuffer(uint8_t _stream, VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  2577. {
  2578. BGFX_CHECK_HANDLE("setVertexBuffer", s_ctx->m_vertexBufferHandle, _handle);
  2579. BGFX_ENCODER(setVertexBuffer(_stream, _handle, _startVertex, _numVertices) );
  2580. }
  2581. void Encoder::setVertexBuffer(uint8_t _stream, VertexBufferHandle _handle)
  2582. {
  2583. setVertexBuffer(_stream, _handle, 0, UINT32_MAX);
  2584. }
  2585. void Encoder::setVertexBuffer(uint8_t _stream, DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  2586. {
  2587. BGFX_CHECK_HANDLE("setVertexBuffer", s_ctx->m_dynamicVertexBufferHandle, _handle);
  2588. const DynamicVertexBuffer& dvb = s_ctx->m_dynamicVertexBuffers[_handle.idx];
  2589. BGFX_ENCODER(setVertexBuffer(_stream, dvb, _startVertex, _numVertices) );
  2590. }
  2591. void Encoder::setVertexBuffer(uint8_t _stream, DynamicVertexBufferHandle _handle)
  2592. {
  2593. setVertexBuffer(_stream, _handle, 0, UINT32_MAX);
  2594. }
  2595. void Encoder::setVertexBuffer(uint8_t _stream, const TransientVertexBuffer* _tvb, uint32_t _startVertex, uint32_t _numVertices)
  2596. {
  2597. BX_CHECK(NULL != _tvb, "_tvb can't be NULL");
  2598. BGFX_CHECK_HANDLE("setVertexBuffer", s_ctx->m_vertexBufferHandle, _tvb->handle);
  2599. BGFX_ENCODER(setVertexBuffer(_stream, _tvb, _startVertex, _numVertices) );
  2600. }
  2601. void Encoder::setVertexBuffer(uint8_t _stream, const TransientVertexBuffer* _tvb)
  2602. {
  2603. setVertexBuffer(_stream, _tvb, 0, UINT32_MAX);
  2604. }
  2605. void Encoder::setVertexCount(uint32_t _numVertices)
  2606. {
  2607. BGFX_CHECK_CAPS(BGFX_CAPS_VERTEX_ID, "Auto generated vertices are not supported!");
  2608. BGFX_ENCODER(setVertexCount(_numVertices) );
  2609. }
  2610. void Encoder::setInstanceDataBuffer(const InstanceDataBuffer* _idb)
  2611. {
  2612. setInstanceDataBuffer(_idb, 0, UINT32_MAX);
  2613. }
  2614. void Encoder::setInstanceDataBuffer(const InstanceDataBuffer* _idb, uint32_t _start, uint32_t _num)
  2615. {
  2616. BX_CHECK(NULL != _idb, "_idb can't be NULL");
  2617. BGFX_ENCODER(setInstanceDataBuffer(_idb, _start, _num) );
  2618. }
  2619. void Encoder::setInstanceDataBuffer(VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  2620. {
  2621. BGFX_CHECK_HANDLE("setInstanceDataBuffer", s_ctx->m_vertexBufferHandle, _handle);
  2622. const VertexBuffer& vb = s_ctx->m_vertexBuffers[_handle.idx];
  2623. BGFX_ENCODER(setInstanceDataBuffer(_handle, _startVertex, _num, vb.m_stride) );
  2624. }
  2625. void Encoder::setInstanceDataBuffer(DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  2626. {
  2627. BGFX_CHECK_HANDLE("setInstanceDataBuffer", s_ctx->m_dynamicVertexBufferHandle, _handle);
  2628. const DynamicVertexBuffer& dvb = s_ctx->m_dynamicVertexBuffers[_handle.idx];
  2629. BGFX_ENCODER(setInstanceDataBuffer(dvb.m_handle
  2630. , dvb.m_startVertex + _startVertex
  2631. , _num
  2632. , dvb.m_stride
  2633. ) );
  2634. }
  2635. void Encoder::setInstanceCount(uint32_t _numInstances)
  2636. {
  2637. BGFX_CHECK_CAPS(BGFX_CAPS_VERTEX_ID, "Auto generated instances are not supported!");
  2638. BGFX_ENCODER(setInstanceCount(_numInstances) );
  2639. }
  2640. void Encoder::setTexture(uint8_t _stage, UniformHandle _sampler, TextureHandle _handle, uint32_t _flags)
  2641. {
  2642. BGFX_CHECK_HANDLE("setTexture/UniformHandle", s_ctx->m_uniformHandle, _sampler);
  2643. BGFX_CHECK_HANDLE_INVALID_OK("setTexture/TextureHandle", s_ctx->m_textureHandle, _handle);
  2644. BX_CHECK(_stage < g_caps.limits.maxTextureSamplers, "Invalid stage %d (max %d).", _stage, g_caps.limits.maxTextureSamplers);
  2645. BGFX_ENCODER(setTexture(_stage, _sampler, _handle, _flags) );
  2646. }
  2647. void Encoder::touch(ViewId _id)
  2648. {
  2649. ProgramHandle handle = BGFX_INVALID_HANDLE;
  2650. submit(_id, handle);
  2651. }
  2652. void Encoder::submit(ViewId _id, ProgramHandle _program, int32_t _depth, bool _preserveState)
  2653. {
  2654. OcclusionQueryHandle handle = BGFX_INVALID_HANDLE;
  2655. submit(_id, _program, handle, _depth, _preserveState);
  2656. }
  2657. void Encoder::submit(ViewId _id, ProgramHandle _program, OcclusionQueryHandle _occlusionQuery, int32_t _depth, bool _preserveState)
  2658. {
  2659. BX_CHECK(false
  2660. || !isValid(_occlusionQuery)
  2661. || 0 != (g_caps.supported & BGFX_CAPS_OCCLUSION_QUERY)
  2662. , "Occlusion query is not supported! Use bgfx::getCaps to check BGFX_CAPS_OCCLUSION_QUERY backend renderer capabilities."
  2663. );
  2664. BGFX_CHECK_HANDLE_INVALID_OK("submit", s_ctx->m_programHandle, _program);
  2665. BGFX_CHECK_HANDLE_INVALID_OK("submit", s_ctx->m_occlusionQueryHandle, _occlusionQuery);
  2666. BGFX_ENCODER(submit(_id, _program, _occlusionQuery, _depth, _preserveState) );
  2667. }
  2668. void Encoder::submit(ViewId _id, ProgramHandle _program, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, int32_t _depth, bool _preserveState)
  2669. {
  2670. BGFX_CHECK_HANDLE_INVALID_OK("submit", s_ctx->m_programHandle, _program);
  2671. BGFX_CHECK_HANDLE("submit", s_ctx->m_vertexBufferHandle, _indirectHandle);
  2672. BGFX_CHECK_CAPS(BGFX_CAPS_DRAW_INDIRECT, "Draw indirect is not supported!");
  2673. BGFX_ENCODER(submit(_id, _program, _indirectHandle, _start, _num, _depth, _preserveState) );
  2674. }
  2675. void Encoder::setBuffer(uint8_t _stage, IndexBufferHandle _handle, Access::Enum _access)
  2676. {
  2677. BX_CHECK(_stage < g_caps.limits.maxComputeBindings, "Invalid stage %d (max %d).", _stage, g_caps.limits.maxComputeBindings);
  2678. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_indexBufferHandle, _handle);
  2679. BGFX_ENCODER(setBuffer(_stage, _handle, _access) );
  2680. }
  2681. void Encoder::setBuffer(uint8_t _stage, VertexBufferHandle _handle, Access::Enum _access)
  2682. {
  2683. BX_CHECK(_stage < g_caps.limits.maxComputeBindings, "Invalid stage %d (max %d).", _stage, g_caps.limits.maxComputeBindings);
  2684. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_vertexBufferHandle, _handle);
  2685. BGFX_ENCODER(setBuffer(_stage, _handle, _access) );
  2686. }
  2687. void Encoder::setBuffer(uint8_t _stage, DynamicIndexBufferHandle _handle, Access::Enum _access)
  2688. {
  2689. BX_CHECK(_stage < g_caps.limits.maxComputeBindings, "Invalid stage %d (max %d).", _stage, g_caps.limits.maxComputeBindings);
  2690. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_dynamicIndexBufferHandle, _handle);
  2691. const DynamicIndexBuffer& dib = s_ctx->m_dynamicIndexBuffers[_handle.idx];
  2692. BGFX_ENCODER(setBuffer(_stage, dib.m_handle, _access) );
  2693. }
  2694. void Encoder::setBuffer(uint8_t _stage, DynamicVertexBufferHandle _handle, Access::Enum _access)
  2695. {
  2696. BX_CHECK(_stage < g_caps.limits.maxComputeBindings, "Invalid stage %d (max %d).", _stage, g_caps.limits.maxComputeBindings);
  2697. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_dynamicVertexBufferHandle, _handle);
  2698. const DynamicVertexBuffer& dvb = s_ctx->m_dynamicVertexBuffers[_handle.idx];
  2699. BGFX_ENCODER(setBuffer(_stage, dvb.m_handle, _access) );
  2700. }
  2701. void Encoder::setBuffer(uint8_t _stage, IndirectBufferHandle _handle, Access::Enum _access)
  2702. {
  2703. BX_CHECK(_stage < g_caps.limits.maxComputeBindings, "Invalid stage %d (max %d).", _stage, g_caps.limits.maxComputeBindings);
  2704. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_vertexBufferHandle, _handle);
  2705. VertexBufferHandle handle = { _handle.idx };
  2706. BGFX_ENCODER(setBuffer(_stage, handle, _access) );
  2707. }
  2708. void Encoder::setImage(uint8_t _stage, TextureHandle _handle, uint8_t _mip, Access::Enum _access, TextureFormat::Enum _format)
  2709. {
  2710. BX_CHECK(_stage < g_caps.limits.maxComputeBindings, "Invalid stage %d (max %d).", _stage, g_caps.limits.maxComputeBindings);
  2711. BGFX_CHECK_HANDLE_INVALID_OK("setImage/TextureHandle", s_ctx->m_textureHandle, _handle);
  2712. _format = TextureFormat::Count == _format
  2713. ? TextureFormat::Enum(s_ctx->m_textureRef[_handle.idx].m_format)
  2714. : _format
  2715. ;
  2716. BX_CHECK(_format != TextureFormat::BGRA8
  2717. , "Can't use TextureFormat::BGRA8 with compute, use TextureFormat::RGBA8 instead."
  2718. );
  2719. BGFX_ENCODER(setImage(_stage, _handle, _mip, _access, _format) );
  2720. }
  2721. void Encoder::dispatch(ViewId _id, ProgramHandle _program, uint32_t _numX, uint32_t _numY, uint32_t _numZ, uint8_t _flags)
  2722. {
  2723. BGFX_CHECK_CAPS(BGFX_CAPS_COMPUTE, "Compute is not supported!");
  2724. BGFX_CHECK_HANDLE_INVALID_OK("dispatch", s_ctx->m_programHandle, _program);
  2725. BGFX_ENCODER(dispatch(_id, _program, _numX, _numY, _numZ, _flags) );
  2726. }
  2727. void Encoder::dispatch(ViewId _id, ProgramHandle _program, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, uint8_t _flags)
  2728. {
  2729. BGFX_CHECK_CAPS(BGFX_CAPS_DRAW_INDIRECT, "Dispatch indirect is not supported!");
  2730. BGFX_CHECK_CAPS(BGFX_CAPS_COMPUTE, "Compute is not supported!");
  2731. BGFX_CHECK_HANDLE_INVALID_OK("dispatch", s_ctx->m_programHandle, _program);
  2732. BGFX_CHECK_HANDLE("dispatch", s_ctx->m_vertexBufferHandle, _indirectHandle);
  2733. BGFX_ENCODER(dispatch(_id, _program, _indirectHandle, _start, _num, _flags) );
  2734. }
  2735. void Encoder::discard()
  2736. {
  2737. BGFX_ENCODER(discard() );
  2738. }
  2739. void Encoder::blit(ViewId _id, TextureHandle _dst, uint16_t _dstX, uint16_t _dstY, TextureHandle _src, uint16_t _srcX, uint16_t _srcY, uint16_t _width, uint16_t _height)
  2740. {
  2741. blit(_id, _dst, 0, _dstX, _dstY, 0, _src, 0, _srcX, _srcY, 0, _width, _height, 0);
  2742. }
  2743. void Encoder::blit(ViewId _id, TextureHandle _dst, uint8_t _dstMip, uint16_t _dstX, uint16_t _dstY, uint16_t _dstZ, TextureHandle _src, uint8_t _srcMip, uint16_t _srcX, uint16_t _srcY, uint16_t _srcZ, uint16_t _width, uint16_t _height, uint16_t _depth)
  2744. {
  2745. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_BLIT, "Texture blit is not supported!");
  2746. const Context::TextureRef& src = s_ctx->m_textureRef[_src.idx];
  2747. const Context::TextureRef& dst = s_ctx->m_textureRef[_dst.idx];
  2748. BX_CHECK(src.m_format == dst.m_format
  2749. , "Texture format must match (src %s, dst %s)."
  2750. , bimg::getName(bimg::TextureFormat::Enum(src.m_format) )
  2751. , bimg::getName(bimg::TextureFormat::Enum(dst.m_format) )
  2752. );
  2753. BX_UNUSED(src, dst);
  2754. BGFX_ENCODER(blit(_id, _dst, _dstMip, _dstX, _dstY, _dstZ, _src, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth) );
  2755. }
  2756. #undef BGFX_ENCODER
  2757. void end(Encoder* _encoder)
  2758. {
  2759. s_ctx->end(_encoder);
  2760. }
  2761. uint32_t frame(bool _capture)
  2762. {
  2763. BGFX_CHECK_API_THREAD();
  2764. return s_ctx->frame(_capture);
  2765. }
  2766. const Caps* getCaps()
  2767. {
  2768. return &g_caps;
  2769. }
  2770. const Stats* getStats()
  2771. {
  2772. return s_ctx->getPerfStats();
  2773. }
  2774. RendererType::Enum getRendererType()
  2775. {
  2776. return g_caps.rendererType;
  2777. }
  2778. const Memory* alloc(uint32_t _size)
  2779. {
  2780. BX_CHECK(0 < _size, "Invalid memory operation. _size is 0.");
  2781. Memory* mem = (Memory*)BX_ALLOC(g_allocator, sizeof(Memory) + _size);
  2782. mem->size = _size;
  2783. mem->data = (uint8_t*)mem + sizeof(Memory);
  2784. return mem;
  2785. }
  2786. const Memory* copy(const void* _data, uint32_t _size)
  2787. {
  2788. BX_CHECK(0 < _size, "Invalid memory operation. _size is 0.");
  2789. const Memory* mem = alloc(_size);
  2790. bx::memCopy(mem->data, _data, _size);
  2791. return mem;
  2792. }
  2793. struct MemoryRef
  2794. {
  2795. Memory mem;
  2796. ReleaseFn releaseFn;
  2797. void* userData;
  2798. };
  2799. const Memory* makeRef(const void* _data, uint32_t _size, ReleaseFn _releaseFn, void* _userData)
  2800. {
  2801. MemoryRef* memRef = (MemoryRef*)BX_ALLOC(g_allocator, sizeof(MemoryRef) );
  2802. memRef->mem.size = _size;
  2803. memRef->mem.data = (uint8_t*)_data;
  2804. memRef->releaseFn = _releaseFn;
  2805. memRef->userData = _userData;
  2806. return &memRef->mem;
  2807. }
  2808. bool isMemoryRef(const Memory* _mem)
  2809. {
  2810. return _mem->data != (uint8_t*)_mem + sizeof(Memory);
  2811. }
  2812. void release(const Memory* _mem)
  2813. {
  2814. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2815. Memory* mem = const_cast<Memory*>(_mem);
  2816. if (isMemoryRef(mem) )
  2817. {
  2818. MemoryRef* memRef = reinterpret_cast<MemoryRef*>(mem);
  2819. if (NULL != memRef->releaseFn)
  2820. {
  2821. memRef->releaseFn(mem->data, memRef->userData);
  2822. }
  2823. }
  2824. BX_FREE(g_allocator, mem);
  2825. }
  2826. void setDebug(uint32_t _debug)
  2827. {
  2828. BGFX_CHECK_API_THREAD();
  2829. s_ctx->setDebug(_debug);
  2830. }
  2831. void dbgTextClear(uint8_t _attr, bool _small)
  2832. {
  2833. BGFX_CHECK_API_THREAD();
  2834. s_ctx->dbgTextClear(_attr, _small);
  2835. }
  2836. void dbgTextPrintfVargs(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, va_list _argList)
  2837. {
  2838. s_ctx->dbgTextPrintfVargs(_x, _y, _attr, _format, _argList);
  2839. }
  2840. void dbgTextPrintf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, ...)
  2841. {
  2842. BGFX_CHECK_API_THREAD();
  2843. va_list argList;
  2844. va_start(argList, _format);
  2845. s_ctx->dbgTextPrintfVargs(_x, _y, _attr, _format, argList);
  2846. va_end(argList);
  2847. }
  2848. void dbgTextImage(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const void* _data, uint16_t _pitch)
  2849. {
  2850. BGFX_CHECK_API_THREAD();
  2851. s_ctx->dbgTextImage(_x, _y, _width, _height, _data, _pitch);
  2852. }
  2853. IndexBufferHandle createIndexBuffer(const Memory* _mem, uint16_t _flags)
  2854. {
  2855. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2856. return s_ctx->createIndexBuffer(_mem, _flags);
  2857. }
  2858. void destroy(IndexBufferHandle _handle)
  2859. {
  2860. s_ctx->destroyIndexBuffer(_handle);
  2861. }
  2862. VertexBufferHandle createVertexBuffer(const Memory* _mem, const VertexDecl& _decl, uint16_t _flags)
  2863. {
  2864. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2865. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2866. return s_ctx->createVertexBuffer(_mem, _decl, _flags);
  2867. }
  2868. void destroy(VertexBufferHandle _handle)
  2869. {
  2870. s_ctx->destroyVertexBuffer(_handle);
  2871. }
  2872. DynamicIndexBufferHandle createDynamicIndexBuffer(uint32_t _num, uint16_t _flags)
  2873. {
  2874. return s_ctx->createDynamicIndexBuffer(_num, _flags);
  2875. }
  2876. DynamicIndexBufferHandle createDynamicIndexBuffer(const Memory* _mem, uint16_t _flags)
  2877. {
  2878. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2879. return s_ctx->createDynamicIndexBuffer(_mem, _flags);
  2880. }
  2881. void update(DynamicIndexBufferHandle _handle, uint32_t _startIndex, const Memory* _mem)
  2882. {
  2883. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2884. s_ctx->update(_handle, _startIndex, _mem);
  2885. }
  2886. void destroy(DynamicIndexBufferHandle _handle)
  2887. {
  2888. s_ctx->destroyDynamicIndexBuffer(_handle);
  2889. }
  2890. DynamicVertexBufferHandle createDynamicVertexBuffer(uint32_t _num, const VertexDecl& _decl, uint16_t _flags)
  2891. {
  2892. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2893. return s_ctx->createDynamicVertexBuffer(_num, _decl, _flags);
  2894. }
  2895. DynamicVertexBufferHandle createDynamicVertexBuffer(const Memory* _mem, const VertexDecl& _decl, uint16_t _flags)
  2896. {
  2897. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2898. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2899. return s_ctx->createDynamicVertexBuffer(_mem, _decl, _flags);
  2900. }
  2901. void update(DynamicVertexBufferHandle _handle, uint32_t _startVertex, const Memory* _mem)
  2902. {
  2903. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2904. s_ctx->update(_handle, _startVertex, _mem);
  2905. }
  2906. void destroy(DynamicVertexBufferHandle _handle)
  2907. {
  2908. s_ctx->destroyDynamicVertexBuffer(_handle);
  2909. }
  2910. uint32_t getAvailTransientIndexBuffer(uint32_t _num)
  2911. {
  2912. BX_CHECK(0 < _num, "Requesting 0 indices.");
  2913. return s_ctx->getAvailTransientIndexBuffer(_num);
  2914. }
  2915. uint32_t getAvailTransientVertexBuffer(uint32_t _num, const VertexDecl& _decl)
  2916. {
  2917. BX_CHECK(0 < _num, "Requesting 0 vertices.");
  2918. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2919. return s_ctx->getAvailTransientVertexBuffer(_num, _decl.m_stride);
  2920. }
  2921. uint32_t getAvailInstanceDataBuffer(uint32_t _num, uint16_t _stride)
  2922. {
  2923. BX_CHECK(0 < _num, "Requesting 0 instances.");
  2924. return s_ctx->getAvailTransientVertexBuffer(_num, _stride);
  2925. }
  2926. void allocTransientIndexBuffer(TransientIndexBuffer* _tib, uint32_t _num)
  2927. {
  2928. BX_CHECK(NULL != _tib, "_tib can't be NULL");
  2929. BX_CHECK(0 < _num, "Requesting 0 indices.");
  2930. s_ctx->allocTransientIndexBuffer(_tib, _num);
  2931. BX_CHECK(_num == _tib->size/2
  2932. , "Failed to allocate transient index buffer (requested %d, available %d). "
  2933. "Use bgfx::getAvailTransient* functions to ensure availability."
  2934. , _num
  2935. , _tib->size/2
  2936. );
  2937. }
  2938. void allocTransientVertexBuffer(TransientVertexBuffer* _tvb, uint32_t _num, const VertexDecl& _decl)
  2939. {
  2940. BX_CHECK(NULL != _tvb, "_tvb can't be NULL");
  2941. BX_CHECK(0 < _num, "Requesting 0 vertices.");
  2942. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2943. s_ctx->allocTransientVertexBuffer(_tvb, _num, _decl);
  2944. BX_CHECK(_num == _tvb->size / _decl.m_stride
  2945. , "Failed to allocate transient vertex buffer (requested %d, available %d). "
  2946. "Use bgfx::getAvailTransient* functions to ensure availability."
  2947. , _num
  2948. , _tvb->size / _decl.m_stride
  2949. );
  2950. }
  2951. bool allocTransientBuffers(bgfx::TransientVertexBuffer* _tvb, const bgfx::VertexDecl& _decl, uint32_t _numVertices, bgfx::TransientIndexBuffer* _tib, uint32_t _numIndices)
  2952. {
  2953. BGFX_MUTEX_SCOPE(s_ctx->m_resourceApiLock);
  2954. if (_numVertices == getAvailTransientVertexBuffer(_numVertices, _decl)
  2955. && _numIndices == getAvailTransientIndexBuffer(_numIndices) )
  2956. {
  2957. allocTransientVertexBuffer(_tvb, _numVertices, _decl);
  2958. allocTransientIndexBuffer(_tib, _numIndices);
  2959. return true;
  2960. }
  2961. return false;
  2962. }
  2963. void allocInstanceDataBuffer(InstanceDataBuffer* _idb, uint32_t _num, uint16_t _stride)
  2964. {
  2965. BGFX_CHECK_CAPS(BGFX_CAPS_INSTANCING, "Instancing is not supported!");
  2966. BX_CHECK(_stride == BX_ALIGN_16(_stride), "Stride must be multiple of 16.");
  2967. BX_CHECK(0 < _num, "Requesting 0 instanced data vertices.");
  2968. s_ctx->allocInstanceDataBuffer(_idb, _num, _stride);
  2969. BX_CHECK(_num == _idb->size / _stride
  2970. , "Failed to allocate instance data buffer (requested %d, available %d). "
  2971. "Use bgfx::getAvailTransient* functions to ensure availability."
  2972. , _num
  2973. , _idb->size / _stride
  2974. );
  2975. }
  2976. IndirectBufferHandle createIndirectBuffer(uint32_t _num)
  2977. {
  2978. return s_ctx->createIndirectBuffer(_num);
  2979. }
  2980. void destroy(IndirectBufferHandle _handle)
  2981. {
  2982. s_ctx->destroyIndirectBuffer(_handle);
  2983. }
  2984. ShaderHandle createShader(const Memory* _mem)
  2985. {
  2986. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2987. return s_ctx->createShader(_mem);
  2988. }
  2989. uint16_t getShaderUniforms(ShaderHandle _handle, UniformHandle* _uniforms, uint16_t _max)
  2990. {
  2991. return s_ctx->getShaderUniforms(_handle, _uniforms, _max);
  2992. }
  2993. void setName(ShaderHandle _handle, const char* _name, int32_t _len)
  2994. {
  2995. s_ctx->setName(_handle, bx::StringView(_name, _len) );
  2996. }
  2997. void destroy(ShaderHandle _handle)
  2998. {
  2999. s_ctx->destroyShader(_handle);
  3000. }
  3001. ProgramHandle createProgram(ShaderHandle _vsh, ShaderHandle _fsh, bool _destroyShaders)
  3002. {
  3003. if (!isValid(_fsh) )
  3004. {
  3005. return createProgram(_vsh, _destroyShaders);
  3006. }
  3007. return s_ctx->createProgram(_vsh, _fsh, _destroyShaders);
  3008. }
  3009. ProgramHandle createProgram(ShaderHandle _csh, bool _destroyShader)
  3010. {
  3011. return s_ctx->createProgram(_csh, _destroyShader);
  3012. }
  3013. void destroy(ProgramHandle _handle)
  3014. {
  3015. s_ctx->destroyProgram(_handle);
  3016. }
  3017. static void isTextureValid(uint16_t _depth, bool _cubeMap, uint16_t _numLayers, TextureFormat::Enum _format, uint64_t _flags, bx::Error* _err)
  3018. {
  3019. BX_ERROR_SCOPE(_err);
  3020. const bool is3DTexture = 1 < _depth;
  3021. if (_cubeMap && is3DTexture)
  3022. {
  3023. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  3024. , "Texture can't be depth and cube map at the same time."
  3025. );
  3026. return;
  3027. }
  3028. if (is3DTexture
  3029. && 0 == (g_caps.supported & BGFX_CAPS_TEXTURE_3D) )
  3030. {
  3031. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  3032. , "Texture3D is not supported! "
  3033. "Use bgfx::getCaps to check BGFX_CAPS_TEXTURE_3D backend renderer capabilities."
  3034. );
  3035. return;
  3036. }
  3037. if (0 != (_flags & BGFX_TEXTURE_RT_MASK)
  3038. && 0 != (_flags & BGFX_TEXTURE_READ_BACK) )
  3039. {
  3040. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  3041. , "Can't create render target with BGFX_TEXTURE_READ_BACK flag."
  3042. );
  3043. return;
  3044. }
  3045. if (1 < _numLayers
  3046. && 0 == (g_caps.supported & BGFX_CAPS_TEXTURE_2D_ARRAY) )
  3047. {
  3048. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  3049. , "Texture array is not supported! "
  3050. "Use bgfx::getCaps to check BGFX_CAPS_TEXTURE_2D_ARRAY backend renderer capabilities."
  3051. );
  3052. return;
  3053. }
  3054. bool formatSupported = 0 != (g_caps.formats[_format] & (0
  3055. | BGFX_CAPS_FORMAT_TEXTURE_2D
  3056. | BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED
  3057. | BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB
  3058. ) );
  3059. uint16_t srgbCaps = BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB;
  3060. if (_cubeMap)
  3061. {
  3062. formatSupported = 0 != (g_caps.formats[_format] & (0
  3063. | BGFX_CAPS_FORMAT_TEXTURE_CUBE
  3064. | BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED
  3065. | BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB
  3066. ) );
  3067. srgbCaps = BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB;
  3068. }
  3069. else if (is3DTexture)
  3070. {
  3071. formatSupported = 0 != (g_caps.formats[_format] & (0
  3072. | BGFX_CAPS_FORMAT_TEXTURE_3D
  3073. | BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED
  3074. | BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB
  3075. ) );
  3076. srgbCaps = BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB;
  3077. }
  3078. if (formatSupported
  3079. && 0 != (_flags & BGFX_TEXTURE_RT_MASK) )
  3080. {
  3081. formatSupported = 0 != (g_caps.formats[_format] & (0
  3082. | BGFX_CAPS_FORMAT_TEXTURE_FRAMEBUFFER
  3083. ) );
  3084. }
  3085. if (!formatSupported)
  3086. {
  3087. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  3088. , "Texture format is not supported! "
  3089. "Use bgfx::isTextureValid to check support for texture format before creating it."
  3090. );
  3091. return;
  3092. }
  3093. if (0 != (_flags & BGFX_TEXTURE_MSAA_SAMPLE)
  3094. && 0 == (g_caps.formats[_format] & BGFX_CAPS_FORMAT_TEXTURE_MSAA) )
  3095. {
  3096. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  3097. , "MSAA sampling for this texture format is not supported."
  3098. );
  3099. return;
  3100. }
  3101. if (0 != (_flags & BGFX_TEXTURE_SRGB)
  3102. && 0 == (g_caps.supported & srgbCaps & (0
  3103. | BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB
  3104. | BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB
  3105. | BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB
  3106. ) ) )
  3107. {
  3108. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  3109. , "sRGB sampling for this texture format is not supported."
  3110. );
  3111. return;
  3112. }
  3113. }
  3114. bool isTextureValid(uint16_t _depth, bool _cubeMap, uint16_t _numLayers, TextureFormat::Enum _format, uint64_t _flags)
  3115. {
  3116. bx::Error err;
  3117. isTextureValid(_depth, _cubeMap, _numLayers, _format, _flags, &err);
  3118. return err.isOk();
  3119. }
  3120. void calcTextureSize(TextureInfo& _info, uint16_t _width, uint16_t _height, uint16_t _depth, bool _cubeMap, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format)
  3121. {
  3122. bimg::imageGetSize( (bimg::TextureInfo*)&_info, _width, _height, _depth, _cubeMap, _hasMips, _numLayers, bimg::TextureFormat::Enum(_format) );
  3123. }
  3124. TextureHandle createTexture(const Memory* _mem, uint64_t _flags, uint8_t _skip, TextureInfo* _info)
  3125. {
  3126. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  3127. return s_ctx->createTexture(_mem, _flags, _skip, _info, BackbufferRatio::Count, false);
  3128. }
  3129. void getTextureSizeFromRatio(BackbufferRatio::Enum _ratio, uint16_t& _width, uint16_t& _height)
  3130. {
  3131. switch (_ratio)
  3132. {
  3133. case BackbufferRatio::Half: _width /= 2; _height /= 2; break;
  3134. case BackbufferRatio::Quarter: _width /= 4; _height /= 4; break;
  3135. case BackbufferRatio::Eighth: _width /= 8; _height /= 8; break;
  3136. case BackbufferRatio::Sixteenth: _width /= 16; _height /= 16; break;
  3137. case BackbufferRatio::Double: _width *= 2; _height *= 2; break;
  3138. default:
  3139. break;
  3140. }
  3141. _width = bx::max<uint16_t>(1, _width);
  3142. _height = bx::max<uint16_t>(1, _height);
  3143. }
  3144. static TextureHandle createTexture2D(BackbufferRatio::Enum _ratio, uint16_t _width, uint16_t _height, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint64_t _flags, const Memory* _mem)
  3145. {
  3146. bx::Error err;
  3147. isTextureValid(0, false, _numLayers, _format, _flags, &err);
  3148. BX_CHECK(err.isOk(), "%s (layers %d, format %s)"
  3149. , err.getMessage().getPtr()
  3150. , _numLayers
  3151. , getName(_format)
  3152. );
  3153. if (BackbufferRatio::Count != _ratio)
  3154. {
  3155. _width = uint16_t(s_ctx->m_init.resolution.width);
  3156. _height = uint16_t(s_ctx->m_init.resolution.height);
  3157. getTextureSizeFromRatio(_ratio, _width, _height);
  3158. }
  3159. const uint8_t numMips = calcNumMips(_hasMips, _width, _height);
  3160. _numLayers = bx::max<uint16_t>(_numLayers, 1);
  3161. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  3162. && NULL != _mem)
  3163. {
  3164. TextureInfo ti;
  3165. calcTextureSize(ti, _width, _height, 1, false, _hasMips, _numLayers, _format);
  3166. BX_CHECK(ti.storageSize == _mem->size
  3167. , "createTexture2D: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  3168. , ti.storageSize
  3169. , _mem->size
  3170. );
  3171. }
  3172. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  3173. const Memory* mem = alloc(size);
  3174. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  3175. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  3176. bx::write(&writer, magic);
  3177. TextureCreate tc;
  3178. tc.m_width = _width;
  3179. tc.m_height = _height;
  3180. tc.m_depth = 0;
  3181. tc.m_numLayers = _numLayers;
  3182. tc.m_numMips = numMips;
  3183. tc.m_format = _format;
  3184. tc.m_cubeMap = false;
  3185. tc.m_mem = _mem;
  3186. bx::write(&writer, tc);
  3187. return s_ctx->createTexture(mem, _flags, 0, NULL, _ratio, NULL != _mem);
  3188. }
  3189. TextureHandle createTexture2D(uint16_t _width, uint16_t _height, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint64_t _flags, const Memory* _mem)
  3190. {
  3191. BX_CHECK(_width > 0 && _height > 0, "Invalid texture size (width %d, height %d).", _width, _height);
  3192. return createTexture2D(BackbufferRatio::Count, _width, _height, _hasMips, _numLayers, _format, _flags, _mem);
  3193. }
  3194. TextureHandle createTexture2D(BackbufferRatio::Enum _ratio, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint64_t _flags)
  3195. {
  3196. BX_CHECK(_ratio < BackbufferRatio::Count, "Invalid back buffer ratio.");
  3197. return createTexture2D(_ratio, 0, 0, _hasMips, _numLayers, _format, _flags, NULL);
  3198. }
  3199. TextureHandle createTexture3D(uint16_t _width, uint16_t _height, uint16_t _depth, bool _hasMips, TextureFormat::Enum _format, uint64_t _flags, const Memory* _mem)
  3200. {
  3201. bx::Error err;
  3202. isTextureValid(_depth, false, 1, _format, _flags, &err);
  3203. BX_CHECK(err.isOk(), "%s", err.getMessage().getPtr() );
  3204. const uint8_t numMips = calcNumMips(_hasMips, _width, _height, _depth);
  3205. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  3206. && NULL != _mem)
  3207. {
  3208. TextureInfo ti;
  3209. calcTextureSize(ti, _width, _height, _depth, false, _hasMips, 1, _format);
  3210. BX_CHECK(ti.storageSize == _mem->size
  3211. , "createTexture3D: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  3212. , ti.storageSize
  3213. , _mem->size
  3214. );
  3215. }
  3216. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  3217. const Memory* mem = alloc(size);
  3218. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  3219. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  3220. bx::write(&writer, magic);
  3221. TextureCreate tc;
  3222. tc.m_width = _width;
  3223. tc.m_height = _height;
  3224. tc.m_depth = _depth;
  3225. tc.m_numLayers = 1;
  3226. tc.m_numMips = numMips;
  3227. tc.m_format = _format;
  3228. tc.m_cubeMap = false;
  3229. tc.m_mem = _mem;
  3230. bx::write(&writer, tc);
  3231. return s_ctx->createTexture(mem, _flags, 0, NULL, BackbufferRatio::Count, NULL != _mem);
  3232. }
  3233. TextureHandle createTextureCube(uint16_t _size, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint64_t _flags, const Memory* _mem)
  3234. {
  3235. bx::Error err;
  3236. isTextureValid(0, true, _numLayers, _format, _flags, &err);
  3237. BX_CHECK(err.isOk(), "%s", err.getMessage().getPtr() );
  3238. const uint8_t numMips = calcNumMips(_hasMips, _size, _size);
  3239. _numLayers = bx::max<uint16_t>(_numLayers, 1);
  3240. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  3241. && NULL != _mem)
  3242. {
  3243. TextureInfo ti;
  3244. calcTextureSize(ti, _size, _size, 1, true, _hasMips, _numLayers, _format);
  3245. BX_CHECK(ti.storageSize == _mem->size
  3246. , "createTextureCube: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  3247. , ti.storageSize
  3248. , _mem->size
  3249. );
  3250. }
  3251. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  3252. const Memory* mem = alloc(size);
  3253. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  3254. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  3255. bx::write(&writer, magic);
  3256. TextureCreate tc;
  3257. tc.m_width = _size;
  3258. tc.m_height = _size;
  3259. tc.m_depth = 0;
  3260. tc.m_numLayers = _numLayers;
  3261. tc.m_numMips = numMips;
  3262. tc.m_format = _format;
  3263. tc.m_cubeMap = true;
  3264. tc.m_mem = _mem;
  3265. bx::write(&writer, tc);
  3266. return s_ctx->createTexture(mem, _flags, 0, NULL, BackbufferRatio::Count, NULL != _mem);
  3267. }
  3268. void setName(TextureHandle _handle, const char* _name, int32_t _len)
  3269. {
  3270. s_ctx->setName(_handle, bx::StringView(_name, _len) );
  3271. }
  3272. void* getDirectAccessPtr(TextureHandle _handle)
  3273. {
  3274. return s_ctx->getDirectAccessPtr(_handle);
  3275. }
  3276. void destroy(TextureHandle _handle)
  3277. {
  3278. s_ctx->destroyTexture(_handle);
  3279. }
  3280. void updateTexture2D(TextureHandle _handle, uint16_t _layer, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const Memory* _mem, uint16_t _pitch)
  3281. {
  3282. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  3283. if (_width == 0
  3284. || _height == 0)
  3285. {
  3286. release(_mem);
  3287. }
  3288. else
  3289. {
  3290. s_ctx->updateTexture(_handle, 0, _mip, _x, _y, _layer, _width, _height, 1, _pitch, _mem);
  3291. }
  3292. }
  3293. void updateTexture3D(TextureHandle _handle, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _z, uint16_t _width, uint16_t _height, uint16_t _depth, const Memory* _mem)
  3294. {
  3295. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  3296. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_3D, "Texture3D is not supported!");
  3297. if (0 == _width
  3298. || 0 == _height
  3299. || 0 == _depth)
  3300. {
  3301. release(_mem);
  3302. }
  3303. else
  3304. {
  3305. s_ctx->updateTexture(_handle, 0, _mip, _x, _y, _z, _width, _height, _depth, UINT16_MAX, _mem);
  3306. }
  3307. }
  3308. void updateTextureCube(TextureHandle _handle, uint16_t _layer, uint8_t _side, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const Memory* _mem, uint16_t _pitch)
  3309. {
  3310. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  3311. BX_CHECK(_side <= 5, "Invalid side %d.", _side);
  3312. if (0 == _width
  3313. || 0 == _height)
  3314. {
  3315. release(_mem);
  3316. }
  3317. else
  3318. {
  3319. s_ctx->updateTexture(_handle, _side, _mip, _x, _y, _layer, _width, _height, 1, _pitch, _mem);
  3320. }
  3321. }
  3322. uint32_t readTexture(TextureHandle _handle, void* _data, uint8_t _mip)
  3323. {
  3324. BX_CHECK(NULL != _data, "_data can't be NULL");
  3325. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_READ_BACK, "Texture read-back is not supported!");
  3326. return s_ctx->readTexture(_handle, _data, _mip);
  3327. }
  3328. FrameBufferHandle createFrameBuffer(uint16_t _width, uint16_t _height, TextureFormat::Enum _format, uint64_t _textureFlags)
  3329. {
  3330. _textureFlags |= _textureFlags&BGFX_TEXTURE_RT_MSAA_MASK ? 0 : BGFX_TEXTURE_RT;
  3331. TextureHandle th = createTexture2D(_width, _height, false, 1, _format, _textureFlags);
  3332. return createFrameBuffer(1, &th, true);
  3333. }
  3334. FrameBufferHandle createFrameBuffer(BackbufferRatio::Enum _ratio, TextureFormat::Enum _format, uint64_t _textureFlags)
  3335. {
  3336. BX_CHECK(_ratio < BackbufferRatio::Count, "Invalid back buffer ratio.");
  3337. _textureFlags |= _textureFlags&BGFX_TEXTURE_RT_MSAA_MASK ? 0 : BGFX_TEXTURE_RT;
  3338. TextureHandle th = createTexture2D(_ratio, false, 1, _format, _textureFlags);
  3339. return createFrameBuffer(1, &th, true);
  3340. }
  3341. FrameBufferHandle createFrameBuffer(uint8_t _num, const TextureHandle* _handles, bool _destroyTextures)
  3342. {
  3343. Attachment attachment[BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS];
  3344. for (uint8_t ii = 0; ii < _num; ++ii)
  3345. {
  3346. Attachment& at = attachment[ii];
  3347. at.handle = _handles[ii];
  3348. at.mip = 0;
  3349. at.layer = 0;
  3350. }
  3351. return createFrameBuffer(_num, attachment, _destroyTextures);
  3352. }
  3353. FrameBufferHandle createFrameBuffer(uint8_t _num, const Attachment* _attachment, bool _destroyTextures)
  3354. {
  3355. BX_CHECK(_num != 0, "Number of frame buffer attachments can't be 0.");
  3356. BX_CHECK(_num <= BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS
  3357. , "Number of frame buffer attachments is larger than allowed %d (max: %d)."
  3358. , _num
  3359. , BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS
  3360. );
  3361. BX_CHECK(NULL != _attachment, "_attachment can't be NULL");
  3362. return s_ctx->createFrameBuffer(_num, _attachment, _destroyTextures);
  3363. }
  3364. FrameBufferHandle createFrameBuffer(void* _nwh, uint16_t _width, uint16_t _height, TextureFormat::Enum _format, TextureFormat::Enum _depthFormat)
  3365. {
  3366. BGFX_CHECK_CAPS(BGFX_CAPS_SWAP_CHAIN, "Swap chain is not supported!");
  3367. BX_WARN(_width > 0 && _height > 0
  3368. , "Invalid frame buffer dimensions (width %d, height %d)."
  3369. , _width
  3370. , _height
  3371. );
  3372. BX_CHECK(_format == TextureFormat::Count || bimg::isColor(bimg::TextureFormat::Enum(_format) )
  3373. , "Invalid texture format for color (%s)."
  3374. , bimg::getName(bimg::TextureFormat::Enum(_format) )
  3375. );
  3376. BX_CHECK(_format == TextureFormat::Count || bimg::isDepth(bimg::TextureFormat::Enum(_depthFormat) )
  3377. , "Invalid texture format for depth (%s)."
  3378. , bimg::getName(bimg::TextureFormat::Enum(_depthFormat) )
  3379. );
  3380. return s_ctx->createFrameBuffer(
  3381. _nwh
  3382. , bx::max<uint16_t>(_width, 1)
  3383. , bx::max<uint16_t>(_height, 1)
  3384. , _format
  3385. , _depthFormat
  3386. );
  3387. }
  3388. TextureHandle getTexture(FrameBufferHandle _handle, uint8_t _attachment)
  3389. {
  3390. return s_ctx->getTexture(_handle, _attachment);
  3391. }
  3392. void destroy(FrameBufferHandle _handle)
  3393. {
  3394. s_ctx->destroyFrameBuffer(_handle);
  3395. }
  3396. UniformHandle createUniform(const char* _name, UniformType::Enum _type, uint16_t _num)
  3397. {
  3398. return s_ctx->createUniform(_name, _type, _num);
  3399. }
  3400. void getUniformInfo(UniformHandle _handle, UniformInfo& _info)
  3401. {
  3402. s_ctx->getUniformInfo(_handle, _info);
  3403. }
  3404. void destroy(UniformHandle _handle)
  3405. {
  3406. s_ctx->destroyUniform(_handle);
  3407. }
  3408. OcclusionQueryHandle createOcclusionQuery()
  3409. {
  3410. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  3411. return s_ctx->createOcclusionQuery();
  3412. }
  3413. OcclusionQueryResult::Enum getResult(OcclusionQueryHandle _handle, int32_t* _result)
  3414. {
  3415. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  3416. return s_ctx->getResult(_handle, _result);
  3417. }
  3418. void destroy(OcclusionQueryHandle _handle)
  3419. {
  3420. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  3421. s_ctx->destroyOcclusionQuery(_handle);
  3422. }
  3423. void setPaletteColor(uint8_t _index, uint32_t _rgba)
  3424. {
  3425. const uint8_t rr = uint8_t(_rgba>>24);
  3426. const uint8_t gg = uint8_t(_rgba>>16);
  3427. const uint8_t bb = uint8_t(_rgba>> 8);
  3428. const uint8_t aa = uint8_t(_rgba>> 0);
  3429. const float rgba[4] =
  3430. {
  3431. rr * 1.0f/255.0f,
  3432. gg * 1.0f/255.0f,
  3433. bb * 1.0f/255.0f,
  3434. aa * 1.0f/255.0f,
  3435. };
  3436. s_ctx->setPaletteColor(_index, rgba);
  3437. }
  3438. void setPaletteColor(uint8_t _index, float _r, float _g, float _b, float _a)
  3439. {
  3440. float rgba[4] = { _r, _g, _b, _a };
  3441. s_ctx->setPaletteColor(_index, rgba);
  3442. }
  3443. void setPaletteColor(uint8_t _index, const float _rgba[4])
  3444. {
  3445. s_ctx->setPaletteColor(_index, _rgba);
  3446. }
  3447. bool checkView(ViewId _id)
  3448. {
  3449. // workaround GCC 4.9 type-limit check.
  3450. const uint32_t id = _id;
  3451. return id < BGFX_CONFIG_MAX_VIEWS;
  3452. }
  3453. void setViewName(ViewId _id, const char* _name)
  3454. {
  3455. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3456. s_ctx->setViewName(_id, _name);
  3457. }
  3458. void setViewRect(ViewId _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3459. {
  3460. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3461. s_ctx->setViewRect(_id, _x, _y, _width, _height);
  3462. }
  3463. void setViewRect(ViewId _id, uint16_t _x, uint16_t _y, BackbufferRatio::Enum _ratio)
  3464. {
  3465. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3466. uint16_t width = uint16_t(s_ctx->m_init.resolution.width);
  3467. uint16_t height = uint16_t(s_ctx->m_init.resolution.height);
  3468. getTextureSizeFromRatio(_ratio, width, height);
  3469. setViewRect(_id, _x, _y, width, height);
  3470. }
  3471. void setViewScissor(ViewId _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3472. {
  3473. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3474. s_ctx->setViewScissor(_id, _x, _y, _width, _height);
  3475. }
  3476. void setViewClear(ViewId _id, uint16_t _flags, uint32_t _rgba, float _depth, uint8_t _stencil)
  3477. {
  3478. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3479. s_ctx->setViewClear(_id, _flags, _rgba, _depth, _stencil);
  3480. }
  3481. void setViewClear(ViewId _id, uint16_t _flags, float _depth, uint8_t _stencil, uint8_t _0, uint8_t _1, uint8_t _2, uint8_t _3, uint8_t _4, uint8_t _5, uint8_t _6, uint8_t _7)
  3482. {
  3483. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3484. s_ctx->setViewClear(_id, _flags, _depth, _stencil, _0, _1, _2, _3, _4, _5, _6, _7);
  3485. }
  3486. void setViewMode(ViewId _id, ViewMode::Enum _mode)
  3487. {
  3488. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3489. s_ctx->setViewMode(_id, _mode);
  3490. }
  3491. void setViewFrameBuffer(ViewId _id, FrameBufferHandle _handle)
  3492. {
  3493. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3494. s_ctx->setViewFrameBuffer(_id, _handle);
  3495. }
  3496. void setViewTransform(ViewId _id, const void* _view, const void* _projL, uint8_t _flags, const void* _projR)
  3497. {
  3498. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3499. s_ctx->setViewTransform(_id, _view, _projL, _flags, _projR);
  3500. }
  3501. void setViewOrder(ViewId _id, uint16_t _num, const ViewId* _order)
  3502. {
  3503. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3504. s_ctx->setViewOrder(_id, _num, _order);
  3505. }
  3506. void resetView(ViewId _id)
  3507. {
  3508. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3509. s_ctx->resetView(_id);
  3510. }
  3511. void setMarker(const char* _marker)
  3512. {
  3513. BGFX_CHECK_API_THREAD();
  3514. s_ctx->m_encoder0->setMarker(_marker);
  3515. }
  3516. void setState(uint64_t _state, uint32_t _rgba)
  3517. {
  3518. BGFX_CHECK_API_THREAD();
  3519. s_ctx->m_encoder0->setState(_state, _rgba);
  3520. }
  3521. void setCondition(OcclusionQueryHandle _handle, bool _visible)
  3522. {
  3523. BGFX_CHECK_API_THREAD();
  3524. s_ctx->m_encoder0->setCondition(_handle, _visible);
  3525. }
  3526. void setStencil(uint32_t _fstencil, uint32_t _bstencil)
  3527. {
  3528. BGFX_CHECK_API_THREAD();
  3529. s_ctx->m_encoder0->setStencil(_fstencil, _bstencil);
  3530. }
  3531. uint16_t setScissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3532. {
  3533. BGFX_CHECK_API_THREAD();
  3534. return s_ctx->m_encoder0->setScissor(_x, _y, _width, _height);
  3535. }
  3536. void setScissor(uint16_t _cache)
  3537. {
  3538. BGFX_CHECK_API_THREAD();
  3539. s_ctx->m_encoder0->setScissor(_cache);
  3540. }
  3541. uint32_t setTransform(const void* _mtx, uint16_t _num)
  3542. {
  3543. BGFX_CHECK_API_THREAD();
  3544. return s_ctx->m_encoder0->setTransform(_mtx, _num);
  3545. }
  3546. uint32_t allocTransform(Transform* _transform, uint16_t _num)
  3547. {
  3548. BGFX_CHECK_API_THREAD();
  3549. return s_ctx->m_encoder0->allocTransform(_transform, _num);
  3550. }
  3551. void setTransform(uint32_t _cache, uint16_t _num)
  3552. {
  3553. BGFX_CHECK_API_THREAD();
  3554. s_ctx->m_encoder0->setTransform(_cache, _num);
  3555. }
  3556. void setUniform(UniformHandle _handle, const void* _value, uint16_t _num)
  3557. {
  3558. BGFX_CHECK_API_THREAD();
  3559. s_ctx->m_encoder0->setUniform(_handle, _value, _num);
  3560. }
  3561. void setIndexBuffer(IndexBufferHandle _handle)
  3562. {
  3563. setIndexBuffer(_handle, 0, UINT32_MAX);
  3564. }
  3565. void setIndexBuffer(IndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  3566. {
  3567. BGFX_CHECK_API_THREAD();
  3568. s_ctx->m_encoder0->setIndexBuffer(_handle, _firstIndex, _numIndices);
  3569. }
  3570. void setIndexBuffer(DynamicIndexBufferHandle _handle)
  3571. {
  3572. setIndexBuffer(_handle, 0, UINT32_MAX);
  3573. }
  3574. void setIndexBuffer(DynamicIndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  3575. {
  3576. BGFX_CHECK_API_THREAD();
  3577. s_ctx->m_encoder0->setIndexBuffer(_handle, _firstIndex, _numIndices);
  3578. }
  3579. void setIndexBuffer(const TransientIndexBuffer* _tib)
  3580. {
  3581. setIndexBuffer(_tib, 0, UINT32_MAX);
  3582. }
  3583. void setIndexBuffer(const TransientIndexBuffer* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  3584. {
  3585. BGFX_CHECK_API_THREAD();
  3586. s_ctx->m_encoder0->setIndexBuffer(_tib, _firstIndex, _numIndices);
  3587. }
  3588. void setVertexBuffer(uint8_t _stream, VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  3589. {
  3590. BGFX_CHECK_API_THREAD();
  3591. s_ctx->m_encoder0->setVertexBuffer(_stream, _handle, _startVertex, _numVertices);
  3592. }
  3593. void setVertexBuffer(uint8_t _stream, VertexBufferHandle _handle)
  3594. {
  3595. setVertexBuffer(_stream, _handle, 0, UINT32_MAX);
  3596. }
  3597. void setVertexBuffer(uint8_t _stream, DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  3598. {
  3599. BGFX_CHECK_API_THREAD();
  3600. s_ctx->m_encoder0->setVertexBuffer(_stream, _handle, _startVertex, _numVertices);
  3601. }
  3602. void setVertexBuffer(uint8_t _stream, DynamicVertexBufferHandle _handle)
  3603. {
  3604. setVertexBuffer(_stream, _handle, 0, UINT32_MAX);
  3605. }
  3606. void setVertexBuffer(uint8_t _stream, const TransientVertexBuffer* _tvb, uint32_t _startVertex, uint32_t _numVertices)
  3607. {
  3608. BGFX_CHECK_API_THREAD();
  3609. s_ctx->m_encoder0->setVertexBuffer(_stream, _tvb, _startVertex, _numVertices);
  3610. }
  3611. void setVertexBuffer(uint8_t _stream, const TransientVertexBuffer* _tvb)
  3612. {
  3613. setVertexBuffer(_stream, _tvb, 0, UINT32_MAX);
  3614. }
  3615. void setVertexCount(uint32_t _numVertices)
  3616. {
  3617. BGFX_CHECK_API_THREAD();
  3618. s_ctx->m_encoder0->setVertexCount(_numVertices);
  3619. }
  3620. void setInstanceDataBuffer(const InstanceDataBuffer* _idb)
  3621. {
  3622. BGFX_CHECK_API_THREAD();
  3623. s_ctx->m_encoder0->setInstanceDataBuffer(_idb);
  3624. }
  3625. void setInstanceDataBuffer(const InstanceDataBuffer* _idb, uint32_t _start, uint32_t _num)
  3626. {
  3627. BGFX_CHECK_API_THREAD();
  3628. s_ctx->m_encoder0->setInstanceDataBuffer(_idb, _start, _num);
  3629. }
  3630. void setInstanceDataBuffer(VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  3631. {
  3632. BGFX_CHECK_API_THREAD();
  3633. s_ctx->m_encoder0->setInstanceDataBuffer(_handle, _startVertex, _num);
  3634. }
  3635. void setInstanceDataBuffer(DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  3636. {
  3637. BGFX_CHECK_API_THREAD();
  3638. s_ctx->m_encoder0->setInstanceDataBuffer(_handle, _startVertex, _num);
  3639. }
  3640. void setInstanceCount(uint32_t _numInstances)
  3641. {
  3642. BGFX_CHECK_API_THREAD();
  3643. s_ctx->m_encoder0->setInstanceCount(_numInstances);
  3644. }
  3645. void setTexture(uint8_t _stage, UniformHandle _sampler, TextureHandle _handle, uint32_t _flags)
  3646. {
  3647. BGFX_CHECK_API_THREAD();
  3648. s_ctx->m_encoder0->setTexture(_stage, _sampler, _handle, _flags);
  3649. }
  3650. void touch(ViewId _id)
  3651. {
  3652. ProgramHandle handle = BGFX_INVALID_HANDLE;
  3653. submit(_id, handle);
  3654. }
  3655. void submit(ViewId _id, ProgramHandle _program, int32_t _depth, bool _preserveState)
  3656. {
  3657. OcclusionQueryHandle handle = BGFX_INVALID_HANDLE;
  3658. submit(_id, _program, handle, _depth, _preserveState);
  3659. }
  3660. void submit(ViewId _id, ProgramHandle _program, OcclusionQueryHandle _occlusionQuery, int32_t _depth, bool _preserveState)
  3661. {
  3662. BGFX_CHECK_API_THREAD();
  3663. s_ctx->m_encoder0->submit(_id, _program, _occlusionQuery, _depth, _preserveState);
  3664. }
  3665. void submit(ViewId _id, ProgramHandle _program, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, int32_t _depth, bool _preserveState)
  3666. {
  3667. BGFX_CHECK_API_THREAD();
  3668. s_ctx->m_encoder0->submit(_id, _program, _indirectHandle, _start, _num, _depth, _preserveState);
  3669. }
  3670. void setBuffer(uint8_t _stage, IndexBufferHandle _handle, Access::Enum _access)
  3671. {
  3672. BGFX_CHECK_API_THREAD();
  3673. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3674. }
  3675. void setBuffer(uint8_t _stage, VertexBufferHandle _handle, Access::Enum _access)
  3676. {
  3677. BGFX_CHECK_API_THREAD();
  3678. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3679. }
  3680. void setBuffer(uint8_t _stage, DynamicIndexBufferHandle _handle, Access::Enum _access)
  3681. {
  3682. BGFX_CHECK_API_THREAD();
  3683. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3684. }
  3685. void setBuffer(uint8_t _stage, DynamicVertexBufferHandle _handle, Access::Enum _access)
  3686. {
  3687. BGFX_CHECK_API_THREAD();
  3688. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3689. }
  3690. void setBuffer(uint8_t _stage, IndirectBufferHandle _handle, Access::Enum _access)
  3691. {
  3692. BGFX_CHECK_API_THREAD();
  3693. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3694. }
  3695. void setImage(uint8_t _stage, TextureHandle _handle, uint8_t _mip, Access::Enum _access, TextureFormat::Enum _format)
  3696. {
  3697. BGFX_CHECK_API_THREAD();
  3698. s_ctx->m_encoder0->setImage(_stage, _handle, _mip, _access, _format);
  3699. }
  3700. void dispatch(ViewId _id, ProgramHandle _handle, uint32_t _numX, uint32_t _numY, uint32_t _numZ, uint8_t _flags)
  3701. {
  3702. BGFX_CHECK_API_THREAD();
  3703. s_ctx->m_encoder0->dispatch(_id, _handle, _numX, _numY, _numZ, _flags);
  3704. }
  3705. void dispatch(ViewId _id, ProgramHandle _handle, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, uint8_t _flags)
  3706. {
  3707. BGFX_CHECK_API_THREAD();
  3708. s_ctx->m_encoder0->dispatch(_id, _handle, _indirectHandle, _start, _num, _flags);
  3709. }
  3710. void discard()
  3711. {
  3712. BGFX_CHECK_API_THREAD();
  3713. s_ctx->m_encoder0->discard();
  3714. }
  3715. void blit(ViewId _id, TextureHandle _dst, uint16_t _dstX, uint16_t _dstY, TextureHandle _src, uint16_t _srcX, uint16_t _srcY, uint16_t _width, uint16_t _height)
  3716. {
  3717. blit(_id, _dst, 0, _dstX, _dstY, 0, _src, 0, _srcX, _srcY, 0, _width, _height, 0);
  3718. }
  3719. void blit(ViewId _id, TextureHandle _dst, uint8_t _dstMip, uint16_t _dstX, uint16_t _dstY, uint16_t _dstZ, TextureHandle _src, uint8_t _srcMip, uint16_t _srcX, uint16_t _srcY, uint16_t _srcZ, uint16_t _width, uint16_t _height, uint16_t _depth)
  3720. {
  3721. BGFX_CHECK_API_THREAD();
  3722. s_ctx->m_encoder0->blit(_id, _dst, _dstMip, _dstX, _dstY, _dstZ, _src, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth);
  3723. }
  3724. void requestScreenShot(FrameBufferHandle _handle, const char* _filePath)
  3725. {
  3726. BGFX_CHECK_API_THREAD();
  3727. s_ctx->requestScreenShot(_handle, _filePath);
  3728. }
  3729. } // namespace bgfx
  3730. #if BX_PLATFORM_WINDOWS
  3731. extern "C"
  3732. {
  3733. // When laptop setup has integrated and discrete GPU, following driver workarounds will
  3734. // select discrete GPU:
  3735. // Reference:
  3736. // - https://web.archive.org/web/20180722051003/https://docs.nvidia.com/gameworks/content/technologies/desktop/optimus.htm
  3737. //
  3738. __declspec(dllexport) uint32_t NvOptimusEnablement = UINT32_C(1);
  3739. // Reference:
  3740. // - https://web.archive.org/web/20180722051032/https://gpuopen.com/amdpowerxpressrequesthighperformance/
  3741. //
  3742. __declspec(dllexport) uint32_t AmdPowerXpressRequestHighPerformance = UINT32_C(1);
  3743. }
  3744. #endif // BX_PLATFORM_WINDOWS
  3745. #define BGFX_TEXTURE_FORMAT_BIMG(_fmt) \
  3746. BX_STATIC_ASSERT(uint32_t(bgfx::TextureFormat::_fmt) == uint32_t(bimg::TextureFormat::_fmt) )
  3747. BGFX_TEXTURE_FORMAT_BIMG(BC1);
  3748. BGFX_TEXTURE_FORMAT_BIMG(BC2);
  3749. BGFX_TEXTURE_FORMAT_BIMG(BC3);
  3750. BGFX_TEXTURE_FORMAT_BIMG(BC4);
  3751. BGFX_TEXTURE_FORMAT_BIMG(BC5);
  3752. BGFX_TEXTURE_FORMAT_BIMG(BC6H);
  3753. BGFX_TEXTURE_FORMAT_BIMG(BC7);
  3754. BGFX_TEXTURE_FORMAT_BIMG(ETC1);
  3755. BGFX_TEXTURE_FORMAT_BIMG(ETC2);
  3756. BGFX_TEXTURE_FORMAT_BIMG(ETC2A);
  3757. BGFX_TEXTURE_FORMAT_BIMG(ETC2A1);
  3758. BGFX_TEXTURE_FORMAT_BIMG(PTC12);
  3759. BGFX_TEXTURE_FORMAT_BIMG(PTC14);
  3760. BGFX_TEXTURE_FORMAT_BIMG(PTC12A);
  3761. BGFX_TEXTURE_FORMAT_BIMG(PTC14A);
  3762. BGFX_TEXTURE_FORMAT_BIMG(PTC22);
  3763. BGFX_TEXTURE_FORMAT_BIMG(PTC24);
  3764. BGFX_TEXTURE_FORMAT_BIMG(ATC);
  3765. BGFX_TEXTURE_FORMAT_BIMG(ATCE);
  3766. BGFX_TEXTURE_FORMAT_BIMG(ATCI);
  3767. BGFX_TEXTURE_FORMAT_BIMG(ASTC4x4);
  3768. BGFX_TEXTURE_FORMAT_BIMG(ASTC5x5);
  3769. BGFX_TEXTURE_FORMAT_BIMG(ASTC6x6);
  3770. BGFX_TEXTURE_FORMAT_BIMG(ASTC8x5);
  3771. BGFX_TEXTURE_FORMAT_BIMG(ASTC8x6);
  3772. BGFX_TEXTURE_FORMAT_BIMG(ASTC10x5);
  3773. BGFX_TEXTURE_FORMAT_BIMG(Unknown);
  3774. BGFX_TEXTURE_FORMAT_BIMG(R1);
  3775. BGFX_TEXTURE_FORMAT_BIMG(A8);
  3776. BGFX_TEXTURE_FORMAT_BIMG(R8);
  3777. BGFX_TEXTURE_FORMAT_BIMG(R8I);
  3778. BGFX_TEXTURE_FORMAT_BIMG(R8U);
  3779. BGFX_TEXTURE_FORMAT_BIMG(R8S);
  3780. BGFX_TEXTURE_FORMAT_BIMG(R16);
  3781. BGFX_TEXTURE_FORMAT_BIMG(R16I);
  3782. BGFX_TEXTURE_FORMAT_BIMG(R16U);
  3783. BGFX_TEXTURE_FORMAT_BIMG(R16F);
  3784. BGFX_TEXTURE_FORMAT_BIMG(R16S);
  3785. BGFX_TEXTURE_FORMAT_BIMG(R32I);
  3786. BGFX_TEXTURE_FORMAT_BIMG(R32U);
  3787. BGFX_TEXTURE_FORMAT_BIMG(R32F);
  3788. BGFX_TEXTURE_FORMAT_BIMG(RG8);
  3789. BGFX_TEXTURE_FORMAT_BIMG(RG8I);
  3790. BGFX_TEXTURE_FORMAT_BIMG(RG8U);
  3791. BGFX_TEXTURE_FORMAT_BIMG(RG8S);
  3792. BGFX_TEXTURE_FORMAT_BIMG(RG16);
  3793. BGFX_TEXTURE_FORMAT_BIMG(RG16I);
  3794. BGFX_TEXTURE_FORMAT_BIMG(RG16U);
  3795. BGFX_TEXTURE_FORMAT_BIMG(RG16F);
  3796. BGFX_TEXTURE_FORMAT_BIMG(RG16S);
  3797. BGFX_TEXTURE_FORMAT_BIMG(RG32I);
  3798. BGFX_TEXTURE_FORMAT_BIMG(RG32U);
  3799. BGFX_TEXTURE_FORMAT_BIMG(RG32F);
  3800. BGFX_TEXTURE_FORMAT_BIMG(RGB8);
  3801. BGFX_TEXTURE_FORMAT_BIMG(RGB8I);
  3802. BGFX_TEXTURE_FORMAT_BIMG(RGB8U);
  3803. BGFX_TEXTURE_FORMAT_BIMG(RGB8S);
  3804. BGFX_TEXTURE_FORMAT_BIMG(RGB9E5F);
  3805. BGFX_TEXTURE_FORMAT_BIMG(BGRA8);
  3806. BGFX_TEXTURE_FORMAT_BIMG(RGBA8);
  3807. BGFX_TEXTURE_FORMAT_BIMG(RGBA8I);
  3808. BGFX_TEXTURE_FORMAT_BIMG(RGBA8U);
  3809. BGFX_TEXTURE_FORMAT_BIMG(RGBA8S);
  3810. BGFX_TEXTURE_FORMAT_BIMG(RGBA16);
  3811. BGFX_TEXTURE_FORMAT_BIMG(RGBA16I);
  3812. BGFX_TEXTURE_FORMAT_BIMG(RGBA16U);
  3813. BGFX_TEXTURE_FORMAT_BIMG(RGBA16F);
  3814. BGFX_TEXTURE_FORMAT_BIMG(RGBA16S);
  3815. BGFX_TEXTURE_FORMAT_BIMG(RGBA32I);
  3816. BGFX_TEXTURE_FORMAT_BIMG(RGBA32U);
  3817. BGFX_TEXTURE_FORMAT_BIMG(RGBA32F);
  3818. BGFX_TEXTURE_FORMAT_BIMG(R5G6B5);
  3819. BGFX_TEXTURE_FORMAT_BIMG(RGBA4);
  3820. BGFX_TEXTURE_FORMAT_BIMG(RGB5A1);
  3821. BGFX_TEXTURE_FORMAT_BIMG(RGB10A2);
  3822. BGFX_TEXTURE_FORMAT_BIMG(RG11B10F);
  3823. BGFX_TEXTURE_FORMAT_BIMG(UnknownDepth);
  3824. BGFX_TEXTURE_FORMAT_BIMG(D16);
  3825. BGFX_TEXTURE_FORMAT_BIMG(D24);
  3826. BGFX_TEXTURE_FORMAT_BIMG(D24S8);
  3827. BGFX_TEXTURE_FORMAT_BIMG(D32);
  3828. BGFX_TEXTURE_FORMAT_BIMG(D16F);
  3829. BGFX_TEXTURE_FORMAT_BIMG(D24F);
  3830. BGFX_TEXTURE_FORMAT_BIMG(D32F);
  3831. BGFX_TEXTURE_FORMAT_BIMG(D0S8);
  3832. BGFX_TEXTURE_FORMAT_BIMG(Count);
  3833. #undef BGFX_TEXTURE_FORMAT_BIMG
  3834. #include <bgfx/c99/bgfx.h>
  3835. #include <bgfx/c99/platform.h>
  3836. #define FLAGS_MASK_TEST(_flags, _mask) ( (_flags) == ( (_flags) & (_mask) ) )
  3837. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3838. | BGFX_SAMPLER_INTERNAL_DEFAULT
  3839. | BGFX_SAMPLER_INTERNAL_SHARED
  3840. , BGFX_SAMPLER_RESERVED_MASK
  3841. ) );
  3842. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3843. | BGFX_RESET_INTERNAL_FORCE
  3844. , BGFX_RESET_RESERVED_MASK
  3845. ) );
  3846. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3847. | BGFX_STATE_INTERNAL_SCISSOR
  3848. | BGFX_STATE_INTERNAL_OCCLUSION_QUERY
  3849. , BGFX_STATE_RESERVED_MASK
  3850. ) );
  3851. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3852. | BGFX_SUBMIT_INTERNAL_OCCLUSION_VISIBLE
  3853. , BGFX_SUBMIT_RESERVED_MASK
  3854. ) );
  3855. BX_STATIC_ASSERT( (0
  3856. | BGFX_STATE_WRITE_MASK
  3857. | BGFX_STATE_DEPTH_TEST_MASK
  3858. | BGFX_STATE_BLEND_MASK
  3859. | BGFX_STATE_BLEND_EQUATION_MASK
  3860. | BGFX_STATE_BLEND_INDEPENDENT
  3861. | BGFX_STATE_BLEND_ALPHA_TO_COVERAGE
  3862. | BGFX_STATE_CULL_MASK
  3863. | BGFX_STATE_ALPHA_REF_MASK
  3864. | BGFX_STATE_PT_MASK
  3865. | BGFX_STATE_POINT_SIZE_MASK
  3866. | BGFX_STATE_MSAA
  3867. | BGFX_STATE_LINEAA
  3868. | BGFX_STATE_CONSERVATIVE_RASTER
  3869. | BGFX_STATE_RESERVED_MASK
  3870. ) == (0
  3871. ^ BGFX_STATE_WRITE_MASK
  3872. ^ BGFX_STATE_DEPTH_TEST_MASK
  3873. ^ BGFX_STATE_BLEND_MASK
  3874. ^ BGFX_STATE_BLEND_EQUATION_MASK
  3875. ^ BGFX_STATE_BLEND_INDEPENDENT
  3876. ^ BGFX_STATE_BLEND_ALPHA_TO_COVERAGE
  3877. ^ BGFX_STATE_CULL_MASK
  3878. ^ BGFX_STATE_ALPHA_REF_MASK
  3879. ^ BGFX_STATE_PT_MASK
  3880. ^ BGFX_STATE_POINT_SIZE_MASK
  3881. ^ BGFX_STATE_MSAA
  3882. ^ BGFX_STATE_LINEAA
  3883. ^ BGFX_STATE_CONSERVATIVE_RASTER
  3884. ^ BGFX_STATE_RESERVED_MASK
  3885. ) );
  3886. #undef FLAGS_MASK_TEST
  3887. #define BGFX_C99_ENUM_CHECK(_enum, _c99enumcount) \
  3888. BX_STATIC_ASSERT(_enum::Count == _enum::Enum(_c99enumcount) )
  3889. BGFX_C99_ENUM_CHECK(bgfx::Fatal, BGFX_FATAL_COUNT);
  3890. BGFX_C99_ENUM_CHECK(bgfx::RendererType, BGFX_RENDERER_TYPE_COUNT);
  3891. BGFX_C99_ENUM_CHECK(bgfx::Attrib, BGFX_ATTRIB_COUNT);
  3892. BGFX_C99_ENUM_CHECK(bgfx::AttribType, BGFX_ATTRIB_TYPE_COUNT);
  3893. BGFX_C99_ENUM_CHECK(bgfx::TextureFormat, BGFX_TEXTURE_FORMAT_COUNT);
  3894. BGFX_C99_ENUM_CHECK(bgfx::UniformType, BGFX_UNIFORM_TYPE_COUNT);
  3895. BGFX_C99_ENUM_CHECK(bgfx::BackbufferRatio, BGFX_BACKBUFFER_RATIO_COUNT);
  3896. BGFX_C99_ENUM_CHECK(bgfx::OcclusionQueryResult, BGFX_OCCLUSION_QUERY_RESULT_COUNT);
  3897. BGFX_C99_ENUM_CHECK(bgfx::Topology, BGFX_TOPOLOGY_COUNT);
  3898. BGFX_C99_ENUM_CHECK(bgfx::TopologyConvert, BGFX_TOPOLOGY_CONVERT_COUNT);
  3899. BGFX_C99_ENUM_CHECK(bgfx::RenderFrame, BGFX_RENDER_FRAME_COUNT);
  3900. #undef BGFX_C99_ENUM_CHECK
  3901. #define BGFX_C99_STRUCT_SIZE_CHECK(_cppstruct, _c99struct) \
  3902. BX_STATIC_ASSERT(sizeof(_cppstruct) == sizeof(_c99struct) )
  3903. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Memory, bgfx_memory_t);
  3904. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Transform, bgfx_transform_t);
  3905. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Stats, bgfx_stats_t);
  3906. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::VertexDecl, bgfx_vertex_decl_t);
  3907. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TransientIndexBuffer, bgfx_transient_index_buffer_t);
  3908. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TransientVertexBuffer, bgfx_transient_vertex_buffer_t);
  3909. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::InstanceDataBuffer, bgfx_instance_data_buffer_t);
  3910. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TextureInfo, bgfx_texture_info_t);
  3911. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::UniformInfo, bgfx_uniform_info_t);
  3912. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Attachment, bgfx_attachment_t);
  3913. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Caps::GPU, bgfx_caps_gpu_t);
  3914. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Caps::Limits, bgfx_caps_limits_t);
  3915. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Caps, bgfx_caps_t);
  3916. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::PlatformData, bgfx_platform_data_t);
  3917. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::InternalData, bgfx_internal_data_t);
  3918. #undef BGFX_C99_STRUCT_SIZE_CHECK
  3919. namespace bgfx
  3920. {
  3921. struct CallbackC99 : public CallbackI
  3922. {
  3923. virtual ~CallbackC99()
  3924. {
  3925. }
  3926. virtual void fatal(Fatal::Enum _code, const char* _str) override
  3927. {
  3928. m_interface->vtbl->fatal(m_interface, (bgfx_fatal_t)_code, _str);
  3929. }
  3930. virtual void traceVargs(const char* _filePath, uint16_t _line, const char* _format, va_list _argList) override
  3931. {
  3932. m_interface->vtbl->trace_vargs(m_interface, _filePath, _line, _format, _argList);
  3933. }
  3934. virtual void profilerBegin(const char* _name, uint32_t _abgr, const char* _filePath, uint16_t _line) override
  3935. {
  3936. m_interface->vtbl->profiler_begin(m_interface, _name, _abgr, _filePath, _line);
  3937. }
  3938. virtual void profilerBeginLiteral(const char* _name, uint32_t _abgr, const char* _filePath, uint16_t _line) override
  3939. {
  3940. m_interface->vtbl->profiler_begin_literal(m_interface, _name, _abgr, _filePath, _line);
  3941. }
  3942. virtual void profilerEnd() override
  3943. {
  3944. m_interface->vtbl->profiler_end(m_interface);
  3945. }
  3946. virtual uint32_t cacheReadSize(uint64_t _id) override
  3947. {
  3948. return m_interface->vtbl->cache_read_size(m_interface, _id);
  3949. }
  3950. virtual bool cacheRead(uint64_t _id, void* _data, uint32_t _size) override
  3951. {
  3952. return m_interface->vtbl->cache_read(m_interface, _id, _data, _size);
  3953. }
  3954. virtual void cacheWrite(uint64_t _id, const void* _data, uint32_t _size) override
  3955. {
  3956. m_interface->vtbl->cache_write(m_interface, _id, _data, _size);
  3957. }
  3958. virtual void screenShot(const char* _filePath, uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _data, uint32_t _size, bool _yflip) override
  3959. {
  3960. m_interface->vtbl->screen_shot(m_interface, _filePath, _width, _height, _pitch, _data, _size, _yflip);
  3961. }
  3962. virtual void captureBegin(uint32_t _width, uint32_t _height, uint32_t _pitch, TextureFormat::Enum _format, bool _yflip) override
  3963. {
  3964. m_interface->vtbl->capture_begin(m_interface, _width, _height, _pitch, (bgfx_texture_format_t)_format, _yflip);
  3965. }
  3966. virtual void captureEnd() override
  3967. {
  3968. m_interface->vtbl->capture_end(m_interface);
  3969. }
  3970. virtual void captureFrame(const void* _data, uint32_t _size) override
  3971. {
  3972. m_interface->vtbl->capture_frame(m_interface, _data, _size);
  3973. }
  3974. bgfx_callback_interface_t* m_interface;
  3975. };
  3976. class AllocatorC99 : public bx::AllocatorI
  3977. {
  3978. public:
  3979. virtual ~AllocatorC99()
  3980. {
  3981. }
  3982. virtual void* realloc(void* _ptr, size_t _size, size_t _align, const char* _file, uint32_t _line) override
  3983. {
  3984. return m_interface->vtbl->realloc(m_interface, _ptr, _size, _align, _file, _line);
  3985. }
  3986. bgfx_allocator_interface_t* m_interface;
  3987. };
  3988. } // namespace bgfx
  3989. BGFX_C_API void bgfx_vertex_decl_begin(bgfx_vertex_decl_t* _decl, bgfx_renderer_type_t _renderer)
  3990. {
  3991. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3992. decl->begin(bgfx::RendererType::Enum(_renderer) );
  3993. }
  3994. BGFX_C_API void bgfx_vertex_decl_add(bgfx_vertex_decl_t* _decl, bgfx_attrib_t _attrib, uint8_t _num, bgfx_attrib_type_t _type, bool _normalized, bool _asInt)
  3995. {
  3996. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3997. decl->add(bgfx::Attrib::Enum(_attrib)
  3998. , _num
  3999. , bgfx::AttribType::Enum(_type)
  4000. , _normalized
  4001. , _asInt
  4002. );
  4003. }
  4004. BGFX_C_API void bgfx_vertex_decl_decode(const bgfx_vertex_decl_t* _decl, bgfx_attrib_t _attrib, uint8_t* _num, bgfx_attrib_type_t* _type, bool* _normalized, bool* _asInt)
  4005. {
  4006. bgfx::AttribType::Enum type;
  4007. const bgfx::VertexDecl* decl = (const bgfx::VertexDecl*)_decl;
  4008. decl->decode(
  4009. bgfx::Attrib::Enum(_attrib)
  4010. , *_num
  4011. , type
  4012. , *_normalized
  4013. , *_asInt
  4014. );
  4015. *_type = (bgfx_attrib_type_t)type;
  4016. }
  4017. BGFX_C_API bool bgfx_vertex_decl_has(const bgfx_vertex_decl_t* _decl, bgfx_attrib_t _attrib)
  4018. {
  4019. const bgfx::VertexDecl* decl = (const bgfx::VertexDecl*)_decl;
  4020. return decl->has(bgfx::Attrib::Enum(_attrib));
  4021. }
  4022. BGFX_C_API void bgfx_vertex_decl_skip(bgfx_vertex_decl_t* _decl, uint8_t _num)
  4023. {
  4024. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  4025. decl->skip(_num);
  4026. }
  4027. BGFX_C_API void bgfx_vertex_decl_end(bgfx_vertex_decl_t* _decl)
  4028. {
  4029. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  4030. decl->end();
  4031. }
  4032. BGFX_C_API void bgfx_vertex_pack(const float _input[4], bool _inputNormalized, bgfx_attrib_t _attr, const bgfx_vertex_decl_t* _decl, void* _data, uint32_t _index)
  4033. {
  4034. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  4035. bgfx::vertexPack(_input, _inputNormalized, bgfx::Attrib::Enum(_attr), decl, _data, _index);
  4036. }
  4037. BGFX_C_API void bgfx_vertex_unpack(float _output[4], bgfx_attrib_t _attr, const bgfx_vertex_decl_t* _decl, const void* _data, uint32_t _index)
  4038. {
  4039. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  4040. bgfx::vertexUnpack(_output, bgfx::Attrib::Enum(_attr), decl, _data, _index);
  4041. }
  4042. BGFX_C_API void bgfx_vertex_convert(const bgfx_vertex_decl_t* _destDecl, void* _destData, const bgfx_vertex_decl_t* _srcDecl, const void* _srcData, uint32_t _num)
  4043. {
  4044. bgfx::VertexDecl& destDecl = *(bgfx::VertexDecl*)_destDecl;
  4045. bgfx::VertexDecl& srcDecl = *(bgfx::VertexDecl*)_srcDecl;
  4046. bgfx::vertexConvert(destDecl, _destData, srcDecl, _srcData, _num);
  4047. }
  4048. BGFX_C_API uint16_t bgfx_weld_vertices(uint16_t* _output, const bgfx_vertex_decl_t* _decl, const void* _data, uint16_t _num, float _epsilon)
  4049. {
  4050. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  4051. return bgfx::weldVertices(_output, decl, _data, _num, _epsilon);
  4052. }
  4053. uint32_t bgfx_topology_convert(bgfx_topology_convert_t _conversion, void* _dst, uint32_t _dstSize, const void* _indices, uint32_t _numIndices, bool _index32)
  4054. {
  4055. return bgfx::topologyConvert(bgfx::TopologyConvert::Enum(_conversion), _dst, _dstSize, _indices, _numIndices, _index32);
  4056. }
  4057. void bgfx_topology_sort_tri_list(bgfx_topology_sort_t _sort, void* _dst, uint32_t _dstSize, const float _dir[3], const float _pos[3], const void* _vertices, uint32_t _stride, const void* _indices, uint32_t _numIndices, bool _index32)
  4058. {
  4059. bgfx::topologySortTriList(bgfx::TopologySort::Enum(_sort), _dst, _dstSize, _dir, _pos, _vertices, _stride, _indices, _numIndices, _index32);
  4060. }
  4061. BGFX_C_API uint8_t bgfx_get_supported_renderers(uint8_t _max, bgfx_renderer_type_t* _enum)
  4062. {
  4063. return bgfx::getSupportedRenderers(_max, (bgfx::RendererType::Enum*)_enum);
  4064. }
  4065. BGFX_C_API const char* bgfx_get_renderer_name(bgfx_renderer_type_t _type)
  4066. {
  4067. return bgfx::getRendererName(bgfx::RendererType::Enum(_type) );
  4068. }
  4069. BGFX_C_API void bgfx_init_ctor(bgfx_init_t* _init)
  4070. {
  4071. BX_PLACEMENT_NEW(_init, bgfx::Init);
  4072. }
  4073. BGFX_C_API bool bgfx_init(const bgfx_init_t* _init)
  4074. {
  4075. bgfx_init_t init = *_init;
  4076. if (init.callback != NULL)
  4077. {
  4078. static bgfx::CallbackC99 s_callback;
  4079. s_callback.m_interface = init.callback;
  4080. init.callback = reinterpret_cast<bgfx_callback_interface_t *>(&s_callback);
  4081. }
  4082. if (init.allocator != NULL)
  4083. {
  4084. static bgfx::AllocatorC99 s_allocator;
  4085. s_allocator.m_interface = init.allocator;
  4086. init.allocator = reinterpret_cast<bgfx_allocator_interface_t *>(&s_allocator);
  4087. }
  4088. union { const bgfx_init_t* c; const bgfx::Init* cpp; } in;
  4089. in.c = &init;
  4090. return bgfx::init(*in.cpp);
  4091. }
  4092. BGFX_C_API void bgfx_shutdown(void)
  4093. {
  4094. return bgfx::shutdown();
  4095. }
  4096. BGFX_C_API void bgfx_reset(uint32_t _width, uint32_t _height, uint32_t _flags, bgfx_texture_format_t _format)
  4097. {
  4098. bgfx::reset(_width, _height, _flags, bgfx::TextureFormat::Enum(_format) );
  4099. }
  4100. BGFX_C_API uint32_t bgfx_frame(bool _capture)
  4101. {
  4102. return bgfx::frame(_capture);
  4103. }
  4104. BGFX_C_API bgfx_renderer_type_t bgfx_get_renderer_type(void)
  4105. {
  4106. return bgfx_renderer_type_t(bgfx::getRendererType() );
  4107. }
  4108. BGFX_C_API const bgfx_caps_t* bgfx_get_caps(void)
  4109. {
  4110. return (const bgfx_caps_t*)bgfx::getCaps();
  4111. }
  4112. BGFX_C_API const bgfx_stats_t* bgfx_get_stats(void)
  4113. {
  4114. return (const bgfx_stats_t*)bgfx::getStats();
  4115. }
  4116. BGFX_C_API const bgfx_memory_t* bgfx_alloc(uint32_t _size)
  4117. {
  4118. return (const bgfx_memory_t*)bgfx::alloc(_size);
  4119. }
  4120. BGFX_C_API const bgfx_memory_t* bgfx_copy(const void* _data, uint32_t _size)
  4121. {
  4122. return (const bgfx_memory_t*)bgfx::copy(_data, _size);
  4123. }
  4124. BGFX_C_API const bgfx_memory_t* bgfx_make_ref(const void* _data, uint32_t _size)
  4125. {
  4126. return (const bgfx_memory_t*)bgfx::makeRef(_data, _size);
  4127. }
  4128. BGFX_C_API const bgfx_memory_t* bgfx_make_ref_release(const void* _data, uint32_t _size, bgfx_release_fn_t _releaseFn, void* _userData)
  4129. {
  4130. return (const bgfx_memory_t*)bgfx::makeRef(_data, _size, _releaseFn, _userData);
  4131. }
  4132. BGFX_C_API void bgfx_set_debug(uint32_t _debug)
  4133. {
  4134. bgfx::setDebug(_debug);
  4135. }
  4136. BGFX_C_API void bgfx_dbg_text_clear(uint8_t _attr, bool _small)
  4137. {
  4138. bgfx::dbgTextClear(_attr, _small);
  4139. }
  4140. BGFX_C_API void bgfx_dbg_text_printf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, ...)
  4141. {
  4142. va_list argList;
  4143. va_start(argList, _format);
  4144. bgfx::dbgTextPrintfVargs(_x, _y, _attr, _format, argList);
  4145. va_end(argList);
  4146. }
  4147. BGFX_C_API void bgfx_dbg_text_vprintf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, va_list _argList)
  4148. {
  4149. bgfx::dbgTextPrintfVargs(_x, _y, _attr, _format, _argList);
  4150. }
  4151. BGFX_C_API void bgfx_dbg_text_image(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const void* _data, uint16_t _pitch)
  4152. {
  4153. bgfx::dbgTextImage(_x, _y, _width, _height, _data, _pitch);
  4154. }
  4155. BGFX_C_API bgfx_index_buffer_handle_t bgfx_create_index_buffer(const bgfx_memory_t* _mem, uint16_t _flags)
  4156. {
  4157. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle;
  4158. handle.cpp = bgfx::createIndexBuffer( (const bgfx::Memory*)_mem, _flags);
  4159. return handle.c;
  4160. }
  4161. BGFX_C_API void bgfx_destroy_index_buffer(bgfx_index_buffer_handle_t _handle)
  4162. {
  4163. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4164. bgfx::destroy(handle.cpp);
  4165. }
  4166. BGFX_C_API bgfx_vertex_buffer_handle_t bgfx_create_vertex_buffer(const bgfx_memory_t* _mem, const bgfx_vertex_decl_t* _decl, uint16_t _flags)
  4167. {
  4168. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4169. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle;
  4170. handle.cpp = bgfx::createVertexBuffer( (const bgfx::Memory*)_mem, decl, _flags);
  4171. return handle.c;
  4172. }
  4173. BGFX_C_API void bgfx_destroy_vertex_buffer(bgfx_vertex_buffer_handle_t _handle)
  4174. {
  4175. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4176. bgfx::destroy(handle.cpp);
  4177. }
  4178. BGFX_C_API bgfx_dynamic_index_buffer_handle_t bgfx_create_dynamic_index_buffer(uint32_t _num, uint16_t _flags)
  4179. {
  4180. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle;
  4181. handle.cpp = bgfx::createDynamicIndexBuffer(_num, _flags);
  4182. return handle.c;
  4183. }
  4184. BGFX_C_API bgfx_dynamic_index_buffer_handle_t bgfx_create_dynamic_index_buffer_mem(const bgfx_memory_t* _mem, uint16_t _flags)
  4185. {
  4186. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle;
  4187. handle.cpp = bgfx::createDynamicIndexBuffer( (const bgfx::Memory*)_mem, _flags);
  4188. return handle.c;
  4189. }
  4190. BGFX_C_API void bgfx_update_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _startIndex, const bgfx_memory_t* _mem)
  4191. {
  4192. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4193. bgfx::update(handle.cpp, _startIndex, (const bgfx::Memory*)_mem);
  4194. }
  4195. BGFX_C_API void bgfx_destroy_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle)
  4196. {
  4197. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4198. bgfx::destroy(handle.cpp);
  4199. }
  4200. BGFX_C_API bgfx_dynamic_vertex_buffer_handle_t bgfx_create_dynamic_vertex_buffer(uint32_t _num, const bgfx_vertex_decl_t* _decl, uint16_t _flags)
  4201. {
  4202. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4203. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle;
  4204. handle.cpp = bgfx::createDynamicVertexBuffer(_num, decl, _flags);
  4205. return handle.c;
  4206. }
  4207. BGFX_C_API bgfx_dynamic_vertex_buffer_handle_t bgfx_create_dynamic_vertex_buffer_mem(const bgfx_memory_t* _mem, const bgfx_vertex_decl_t* _decl, uint16_t _flags)
  4208. {
  4209. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4210. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle;
  4211. handle.cpp = bgfx::createDynamicVertexBuffer( (const bgfx::Memory*)_mem, decl, _flags);
  4212. return handle.c;
  4213. }
  4214. BGFX_C_API void bgfx_update_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, const bgfx_memory_t* _mem)
  4215. {
  4216. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4217. bgfx::update(handle.cpp, _startVertex, (const bgfx::Memory*)_mem);
  4218. }
  4219. BGFX_C_API void bgfx_destroy_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle)
  4220. {
  4221. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4222. bgfx::destroy(handle.cpp);
  4223. }
  4224. BGFX_C_API uint32_t bgfx_get_avail_transient_index_buffer(uint32_t _num)
  4225. {
  4226. return bgfx::getAvailTransientIndexBuffer(_num);
  4227. }
  4228. BGFX_C_API uint32_t bgfx_get_avail_transient_vertex_buffer(uint32_t _num, const bgfx_vertex_decl_t* _decl)
  4229. {
  4230. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4231. return bgfx::getAvailTransientVertexBuffer(_num, decl);
  4232. }
  4233. BGFX_C_API uint32_t bgfx_get_avail_instance_data_buffer(uint32_t _num, uint16_t _stride)
  4234. {
  4235. return bgfx::getAvailInstanceDataBuffer(_num, _stride);
  4236. }
  4237. BGFX_C_API void bgfx_alloc_transient_index_buffer(bgfx_transient_index_buffer_t* _tib, uint32_t _num)
  4238. {
  4239. bgfx::allocTransientIndexBuffer( (bgfx::TransientIndexBuffer*)_tib, _num);
  4240. }
  4241. BGFX_C_API void bgfx_alloc_transient_vertex_buffer(bgfx_transient_vertex_buffer_t* _tvb, uint32_t _num, const bgfx_vertex_decl_t* _decl)
  4242. {
  4243. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4244. bgfx::allocTransientVertexBuffer( (bgfx::TransientVertexBuffer*)_tvb, _num, decl);
  4245. }
  4246. BGFX_C_API bool bgfx_alloc_transient_buffers(bgfx_transient_vertex_buffer_t* _tvb, const bgfx_vertex_decl_t* _decl, uint32_t _numVertices, bgfx_transient_index_buffer_t* _tib, uint32_t _numIndices)
  4247. {
  4248. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4249. return bgfx::allocTransientBuffers( (bgfx::TransientVertexBuffer*)_tvb, decl, _numVertices, (bgfx::TransientIndexBuffer*)_tib, _numIndices);
  4250. }
  4251. BGFX_C_API void bgfx_alloc_instance_data_buffer(bgfx_instance_data_buffer_t* _idb, uint32_t _num, uint16_t _stride)
  4252. {
  4253. bgfx::allocInstanceDataBuffer( (bgfx::InstanceDataBuffer*)_idb, _num, _stride);
  4254. }
  4255. BGFX_C_API bgfx_indirect_buffer_handle_t bgfx_create_indirect_buffer(uint32_t _num)
  4256. {
  4257. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle;
  4258. handle.cpp = bgfx::createIndirectBuffer(_num);
  4259. return handle.c;
  4260. }
  4261. BGFX_C_API void bgfx_destroy_indirect_buffer(bgfx_indirect_buffer_handle_t _handle)
  4262. {
  4263. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle = { _handle };
  4264. bgfx::destroy(handle.cpp);
  4265. }
  4266. BGFX_C_API bgfx_shader_handle_t bgfx_create_shader(const bgfx_memory_t* _mem)
  4267. {
  4268. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle;
  4269. handle.cpp = bgfx::createShader( (const bgfx::Memory*)_mem);
  4270. return handle.c;
  4271. }
  4272. BGFX_C_API uint16_t bgfx_get_shader_uniforms(bgfx_shader_handle_t _handle, bgfx_uniform_handle_t* _uniforms, uint16_t _max)
  4273. {
  4274. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle = { _handle };
  4275. return bgfx::getShaderUniforms(handle.cpp, (bgfx::UniformHandle*)_uniforms, _max);
  4276. }
  4277. BGFX_C_API void bgfx_set_shader_name(bgfx_shader_handle_t _handle, const char* _name, int32_t _len)
  4278. {
  4279. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle = { _handle };
  4280. bgfx::setName(handle.cpp, _name, _len);
  4281. }
  4282. BGFX_C_API void bgfx_destroy_shader(bgfx_shader_handle_t _handle)
  4283. {
  4284. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle = { _handle };
  4285. bgfx::destroy(handle.cpp);
  4286. }
  4287. BGFX_C_API bgfx_program_handle_t bgfx_create_program(bgfx_shader_handle_t _vsh, bgfx_shader_handle_t _fsh, bool _destroyShaders)
  4288. {
  4289. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } vsh = { _vsh };
  4290. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } fsh = { _fsh };
  4291. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle;
  4292. handle.cpp = bgfx::createProgram(vsh.cpp, fsh.cpp, _destroyShaders);
  4293. return handle.c;
  4294. }
  4295. BGFX_C_API bgfx_program_handle_t bgfx_create_compute_program(bgfx_shader_handle_t _csh, bool _destroyShaders)
  4296. {
  4297. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } csh = { _csh };
  4298. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle;
  4299. handle.cpp = bgfx::createProgram(csh.cpp, _destroyShaders);
  4300. return handle.c;
  4301. }
  4302. BGFX_C_API void bgfx_destroy_program(bgfx_program_handle_t _handle)
  4303. {
  4304. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4305. bgfx::destroy(handle.cpp);
  4306. }
  4307. BGFX_C_API bool bgfx_is_texture_valid(uint16_t _depth, bool _cubeMap, uint16_t _numLayers, bgfx_texture_format_t _format, uint64_t _flags)
  4308. {
  4309. return bgfx::isTextureValid(_depth, _cubeMap, _numLayers, bgfx::TextureFormat::Enum(_format), _flags);
  4310. }
  4311. BGFX_C_API void bgfx_calc_texture_size(bgfx_texture_info_t* _info, uint16_t _width, uint16_t _height, uint16_t _depth, bool _cubeMap, bool _hasMips, uint16_t _numLayers, bgfx_texture_format_t _format)
  4312. {
  4313. bgfx::TextureInfo& info = *(bgfx::TextureInfo*)_info;
  4314. bgfx::calcTextureSize(info, _width, _height, _depth, _cubeMap, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format) );
  4315. }
  4316. BGFX_C_API bgfx_texture_handle_t bgfx_create_texture(const bgfx_memory_t* _mem, uint64_t _flags, uint8_t _skip, bgfx_texture_info_t* _info)
  4317. {
  4318. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4319. bgfx::TextureInfo* info = (bgfx::TextureInfo*)_info;
  4320. handle.cpp = bgfx::createTexture( (const bgfx::Memory*)_mem, _flags, _skip, info);
  4321. return handle.c;
  4322. }
  4323. BGFX_C_API bgfx_texture_handle_t bgfx_create_texture_2d(uint16_t _width, uint16_t _height, bool _hasMips, uint16_t _numLayers, bgfx_texture_format_t _format, uint64_t _flags, const bgfx_memory_t* _mem)
  4324. {
  4325. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4326. handle.cpp = bgfx::createTexture2D(_width, _height, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  4327. return handle.c;
  4328. }
  4329. BGFX_C_API bgfx_texture_handle_t bgfx_create_texture_2d_scaled(bgfx_backbuffer_ratio_t _ratio, bool _hasMips, uint16_t _numLayers, bgfx_texture_format_t _format, uint64_t _flags)
  4330. {
  4331. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4332. handle.cpp = bgfx::createTexture2D(bgfx::BackbufferRatio::Enum(_ratio), _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags);
  4333. return handle.c;
  4334. }
  4335. BGFX_C_API bgfx_texture_handle_t bgfx_create_texture_3d(uint16_t _width, uint16_t _height, uint16_t _depth, bool _hasMips, bgfx_texture_format_t _format, uint64_t _flags, const bgfx_memory_t* _mem)
  4336. {
  4337. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4338. handle.cpp = bgfx::createTexture3D(_width, _height, _depth, _hasMips, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  4339. return handle.c;
  4340. }
  4341. BGFX_C_API bgfx_texture_handle_t bgfx_create_texture_cube(uint16_t _size, bool _hasMips, uint16_t _numLayers, bgfx_texture_format_t _format, uint64_t _flags, const bgfx_memory_t* _mem)
  4342. {
  4343. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4344. handle.cpp = bgfx::createTextureCube(_size, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  4345. return handle.c;
  4346. }
  4347. BGFX_C_API void bgfx_update_texture_2d(bgfx_texture_handle_t _handle, uint16_t _layer, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const bgfx_memory_t* _mem, uint16_t _pitch)
  4348. {
  4349. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4350. bgfx::updateTexture2D(handle.cpp, _layer, _mip, _x, _y, _width, _height, (const bgfx::Memory*)_mem, _pitch);
  4351. }
  4352. BGFX_C_API void bgfx_update_texture_3d(bgfx_texture_handle_t _handle, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _z, uint16_t _width, uint16_t _height, uint16_t _depth, const bgfx_memory_t* _mem)
  4353. {
  4354. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4355. bgfx::updateTexture3D(handle.cpp, _mip, _x, _y, _z, _width, _height, _depth, (const bgfx::Memory*)_mem);
  4356. }
  4357. BGFX_C_API void bgfx_update_texture_cube(bgfx_texture_handle_t _handle, uint16_t _layer, uint8_t _side, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const bgfx_memory_t* _mem, uint16_t _pitch)
  4358. {
  4359. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4360. bgfx::updateTextureCube(handle.cpp, _layer, _side, _mip, _x, _y, _width, _height, (const bgfx::Memory*)_mem, _pitch);
  4361. }
  4362. BGFX_C_API uint32_t bgfx_read_texture(bgfx_texture_handle_t _handle, void* _data, uint8_t _mip)
  4363. {
  4364. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4365. return bgfx::readTexture(handle.cpp, _data, _mip);
  4366. }
  4367. BGFX_C_API void bgfx_set_texture_name(bgfx_texture_handle_t _handle, const char* _name, int32_t _len)
  4368. {
  4369. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4370. bgfx::setName(handle.cpp, _name, _len);
  4371. }
  4372. BGFX_C_API void* bgfx_get_direct_access_ptr(bgfx_texture_handle_t _handle)
  4373. {
  4374. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4375. return bgfx::getDirectAccessPtr(handle.cpp);
  4376. }
  4377. BGFX_C_API void bgfx_destroy_texture(bgfx_texture_handle_t _handle)
  4378. {
  4379. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4380. bgfx::destroy(handle.cpp);
  4381. }
  4382. BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer(uint16_t _width, uint16_t _height, bgfx_texture_format_t _format, uint64_t _textureFlags)
  4383. {
  4384. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4385. handle.cpp = bgfx::createFrameBuffer(_width, _height, bgfx::TextureFormat::Enum(_format), _textureFlags);
  4386. return handle.c;
  4387. }
  4388. BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_scaled(bgfx_backbuffer_ratio_t _ratio, bgfx_texture_format_t _format, uint64_t _textureFlags)
  4389. {
  4390. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4391. handle.cpp = bgfx::createFrameBuffer(bgfx::BackbufferRatio::Enum(_ratio), bgfx::TextureFormat::Enum(_format), _textureFlags);
  4392. return handle.c;
  4393. }
  4394. BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_from_handles(uint8_t _num, const bgfx_texture_handle_t* _handles, bool _destroyTextures)
  4395. {
  4396. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4397. handle.cpp = bgfx::createFrameBuffer(_num, (const bgfx::TextureHandle*)_handles, _destroyTextures);
  4398. return handle.c;
  4399. }
  4400. BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_from_attachment(uint8_t _num, const bgfx_attachment_t* _attachment, bool _destroyTextures)
  4401. {
  4402. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4403. handle.cpp = bgfx::createFrameBuffer(_num, (const bgfx::Attachment*)_attachment, _destroyTextures);
  4404. return handle.c;
  4405. }
  4406. BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_from_nwh(void* _nwh, uint16_t _width, uint16_t _height, bgfx_texture_format_t _format, bgfx_texture_format_t _depthFormat)
  4407. {
  4408. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4409. handle.cpp = bgfx::createFrameBuffer(_nwh, _width, _height, bgfx::TextureFormat::Enum(_format), bgfx::TextureFormat::Enum(_depthFormat) );
  4410. return handle.c;
  4411. }
  4412. BGFX_C_API bgfx_texture_handle_t bgfx_get_texture(bgfx_frame_buffer_handle_t _handle, uint8_t _attachment)
  4413. {
  4414. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  4415. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } textureHandle;
  4416. textureHandle.cpp = bgfx::getTexture(handle.cpp, _attachment);
  4417. return textureHandle.c;
  4418. }
  4419. BGFX_C_API void bgfx_destroy_frame_buffer(bgfx_frame_buffer_handle_t _handle)
  4420. {
  4421. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  4422. bgfx::destroy(handle.cpp);
  4423. }
  4424. BGFX_C_API bgfx_uniform_handle_t bgfx_create_uniform(const char* _name, bgfx_uniform_type_t _type, uint16_t _num)
  4425. {
  4426. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle;
  4427. handle.cpp = bgfx::createUniform(_name, bgfx::UniformType::Enum(_type), _num);
  4428. return handle.c;
  4429. }
  4430. BGFX_C_API void bgfx_get_uniform_info(bgfx_uniform_handle_t _handle, bgfx_uniform_info_t* _info)
  4431. {
  4432. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  4433. bgfx::UniformInfo& info = *(bgfx::UniformInfo*)_info;
  4434. bgfx::getUniformInfo(handle.cpp, info);
  4435. }
  4436. BGFX_C_API void bgfx_destroy_uniform(bgfx_uniform_handle_t _handle)
  4437. {
  4438. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  4439. bgfx::destroy(handle.cpp);
  4440. }
  4441. BGFX_C_API bgfx_occlusion_query_handle_t bgfx_create_occlusion_query(void)
  4442. {
  4443. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle;
  4444. handle.cpp = bgfx::createOcclusionQuery();
  4445. return handle.c;
  4446. }
  4447. BGFX_C_API bgfx_occlusion_query_result_t bgfx_get_result(bgfx_occlusion_query_handle_t _handle, int32_t* _result)
  4448. {
  4449. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  4450. return bgfx_occlusion_query_result_t(bgfx::getResult(handle.cpp, _result) );
  4451. }
  4452. BGFX_C_API void bgfx_destroy_occlusion_query(bgfx_occlusion_query_handle_t _handle)
  4453. {
  4454. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  4455. bgfx::destroy(handle.cpp);
  4456. }
  4457. BGFX_C_API void bgfx_set_palette_color(uint8_t _index, const float _rgba[4])
  4458. {
  4459. bgfx::setPaletteColor(_index, _rgba);
  4460. }
  4461. BGFX_C_API void bgfx_set_view_name(bgfx_view_id_t _id, const char* _name)
  4462. {
  4463. bgfx::setViewName(_id, _name);
  4464. }
  4465. BGFX_C_API void bgfx_set_view_rect(bgfx_view_id_t _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  4466. {
  4467. bgfx::setViewRect(_id, _x, _y, _width, _height);
  4468. }
  4469. BGFX_C_API void bgfx_set_view_rect_auto(bgfx_view_id_t _id, uint16_t _x, uint16_t _y, bgfx_backbuffer_ratio_t _ratio)
  4470. {
  4471. bgfx::setViewRect(_id, _x, _y, bgfx::BackbufferRatio::Enum(_ratio));
  4472. }
  4473. BGFX_C_API void bgfx_set_view_scissor(bgfx_view_id_t _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  4474. {
  4475. bgfx::setViewScissor(_id, _x, _y, _width, _height);
  4476. }
  4477. BGFX_C_API void bgfx_set_view_clear(bgfx_view_id_t _id, uint16_t _flags, uint32_t _rgba, float _depth, uint8_t _stencil)
  4478. {
  4479. bgfx::setViewClear(_id, _flags, _rgba, _depth, _stencil);
  4480. }
  4481. BGFX_C_API void bgfx_set_view_clear_mrt(bgfx_view_id_t _id, uint16_t _flags, float _depth, uint8_t _stencil, uint8_t _0, uint8_t _1, uint8_t _2, uint8_t _3, uint8_t _4, uint8_t _5, uint8_t _6, uint8_t _7)
  4482. {
  4483. bgfx::setViewClear(_id, _flags, _depth, _stencil, _0, _1, _2, _3, _4, _5, _6, _7);
  4484. }
  4485. BGFX_C_API void bgfx_set_view_mode(bgfx_view_id_t _id, bgfx_view_mode_t _mode)
  4486. {
  4487. bgfx::setViewMode(_id, bgfx::ViewMode::Enum(_mode) );
  4488. }
  4489. BGFX_C_API void bgfx_set_view_frame_buffer(bgfx_view_id_t _id, bgfx_frame_buffer_handle_t _handle)
  4490. {
  4491. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  4492. bgfx::setViewFrameBuffer(_id, handle.cpp);
  4493. }
  4494. BGFX_C_API void bgfx_set_view_transform(bgfx_view_id_t _id, const void* _view, const void* _proj)
  4495. {
  4496. bgfx::setViewTransform(_id, _view, _proj);
  4497. }
  4498. BGFX_C_API void bgfx_set_view_transform_stereo(bgfx_view_id_t _id, const void* _view, const void* _projL, uint8_t _flags, const void* _projR)
  4499. {
  4500. bgfx::setViewTransform(_id, _view, _projL, _flags, _projR);
  4501. }
  4502. BGFX_C_API void bgfx_set_view_order(bgfx_view_id_t _id, uint16_t _num, const bgfx_view_id_t* _order)
  4503. {
  4504. bgfx::setViewOrder(_id, _num, _order);
  4505. }
  4506. BGFX_C_API void bgfx_reset_view(bgfx_view_id_t _id)
  4507. {
  4508. bgfx::resetView(_id);
  4509. }
  4510. BGFX_C_API void bgfx_set_marker(const char* _marker)
  4511. {
  4512. bgfx::setMarker(_marker);
  4513. }
  4514. BGFX_C_API void bgfx_set_state(uint64_t _state, uint32_t _rgba)
  4515. {
  4516. bgfx::setState(_state, _rgba);
  4517. }
  4518. BGFX_C_API void bgfx_set_condition(bgfx_occlusion_query_handle_t _handle, bool _visible)
  4519. {
  4520. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  4521. bgfx::setCondition(handle.cpp, _visible);
  4522. }
  4523. BGFX_C_API void bgfx_set_stencil(uint32_t _fstencil, uint32_t _bstencil)
  4524. {
  4525. bgfx::setStencil(_fstencil, _bstencil);
  4526. }
  4527. BGFX_C_API uint16_t bgfx_set_scissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  4528. {
  4529. return bgfx::setScissor(_x, _y, _width, _height);
  4530. }
  4531. BGFX_C_API void bgfx_set_scissor_cached(uint16_t _cache)
  4532. {
  4533. bgfx::setScissor(_cache);
  4534. }
  4535. BGFX_C_API uint32_t bgfx_set_transform(const void* _mtx, uint16_t _num)
  4536. {
  4537. return bgfx::setTransform(_mtx, _num);
  4538. }
  4539. BGFX_C_API uint32_t bgfx_alloc_transform(bgfx_transform_t* _transform, uint16_t _num)
  4540. {
  4541. return bgfx::allocTransform( (bgfx::Transform*)_transform, _num);
  4542. }
  4543. BGFX_C_API void bgfx_set_transform_cached(uint32_t _cache, uint16_t _num)
  4544. {
  4545. bgfx::setTransform(_cache, _num);
  4546. }
  4547. BGFX_C_API void bgfx_set_uniform(bgfx_uniform_handle_t _handle, const void* _value, uint16_t _num)
  4548. {
  4549. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  4550. bgfx::setUniform(handle.cpp, _value, _num);
  4551. }
  4552. BGFX_C_API void bgfx_set_index_buffer(bgfx_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  4553. {
  4554. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4555. bgfx::setIndexBuffer(handle.cpp, _firstIndex, _numIndices);
  4556. }
  4557. BGFX_C_API void bgfx_set_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  4558. {
  4559. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4560. bgfx::setIndexBuffer(handle.cpp, _firstIndex, _numIndices);
  4561. }
  4562. BGFX_C_API void bgfx_set_transient_index_buffer(const bgfx_transient_index_buffer_t* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  4563. {
  4564. bgfx::setIndexBuffer( (const bgfx::TransientIndexBuffer*)_tib, _firstIndex, _numIndices);
  4565. }
  4566. BGFX_C_API void bgfx_set_vertex_buffer(uint8_t _stream, bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _numVertices)
  4567. {
  4568. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4569. bgfx::setVertexBuffer(_stream, handle.cpp, _startVertex, _numVertices);
  4570. }
  4571. BGFX_C_API void bgfx_set_dynamic_vertex_buffer(uint8_t _stream, bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _numVertices)
  4572. {
  4573. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4574. bgfx::setVertexBuffer(_stream, handle.cpp, _startVertex, _numVertices);
  4575. }
  4576. BGFX_C_API void bgfx_set_transient_vertex_buffer(uint8_t _stream, const bgfx_transient_vertex_buffer_t* _tvb, uint32_t _startVertex, uint32_t _numVertices)
  4577. {
  4578. bgfx::setVertexBuffer(_stream, (const bgfx::TransientVertexBuffer*)_tvb, _startVertex, _numVertices);
  4579. }
  4580. BGFX_C_API void bgfx_set_vertex_count(uint32_t _numVertices)
  4581. {
  4582. bgfx::setVertexCount(_numVertices);
  4583. }
  4584. BGFX_C_API void bgfx_set_instance_data_buffer(const bgfx_instance_data_buffer_t* _idb, uint32_t _start, uint32_t _num)
  4585. {
  4586. bgfx::setInstanceDataBuffer( (const bgfx::InstanceDataBuffer*)_idb, _start, _num);
  4587. }
  4588. BGFX_C_API void bgfx_set_instance_data_from_vertex_buffer(bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _num)
  4589. {
  4590. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4591. bgfx::setInstanceDataBuffer(handle.cpp, _startVertex, _num);
  4592. }
  4593. BGFX_C_API void bgfx_set_instance_data_from_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _num)
  4594. {
  4595. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4596. bgfx::setInstanceDataBuffer(handle.cpp, _startVertex, _num);
  4597. }
  4598. BGFX_C_API void bgfx_set_instance_count(uint32_t _numInstances)
  4599. {
  4600. bgfx::setInstanceCount(_numInstances);
  4601. }
  4602. BGFX_C_API void bgfx_set_texture(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_texture_handle_t _handle, uint32_t _flags)
  4603. {
  4604. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  4605. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4606. bgfx::setTexture(_stage, sampler.cpp, handle.cpp, _flags);
  4607. }
  4608. BGFX_C_API void bgfx_touch(bgfx_view_id_t _id)
  4609. {
  4610. return bgfx::touch(_id);
  4611. }
  4612. BGFX_C_API void bgfx_submit(bgfx_view_id_t _id, bgfx_program_handle_t _handle, int32_t _depth, bool _preserveState)
  4613. {
  4614. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4615. bgfx::submit(_id, handle.cpp, _depth, _preserveState);
  4616. }
  4617. BGFX_C_API void bgfx_submit_occlusion_query(bgfx_view_id_t _id, bgfx_program_handle_t _program, bgfx_occlusion_query_handle_t _occlusionQuery, int32_t _depth, bool _preserveState)
  4618. {
  4619. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } program = { _program };
  4620. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } occlusionQuery = { _occlusionQuery };
  4621. bgfx::submit(_id, program.cpp, occlusionQuery.cpp, _depth, _preserveState);
  4622. }
  4623. BGFX_C_API void bgfx_submit_indirect(bgfx_view_id_t _id, bgfx_program_handle_t _handle, bgfx_indirect_buffer_handle_t _indirectHandle, uint16_t _start, uint16_t _num, int32_t _depth, bool _preserveState)
  4624. {
  4625. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4626. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  4627. bgfx::submit(_id, handle.cpp, indirectHandle.cpp, _start, _num, _depth, _preserveState);
  4628. }
  4629. BGFX_C_API void bgfx_set_image(uint8_t _stage, bgfx_texture_handle_t _handle, uint8_t _mip, bgfx_access_t _access, bgfx_texture_format_t _format)
  4630. {
  4631. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4632. bgfx::setImage(_stage, handle.cpp, _mip, bgfx::Access::Enum(_access), bgfx::TextureFormat::Enum(_format) );
  4633. }
  4634. BGFX_C_API void bgfx_set_compute_index_buffer(uint8_t _stage, bgfx_index_buffer_handle_t _handle, bgfx_access_t _access)
  4635. {
  4636. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4637. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4638. }
  4639. BGFX_C_API void bgfx_set_compute_vertex_buffer(uint8_t _stage, bgfx_vertex_buffer_handle_t _handle, bgfx_access_t _access)
  4640. {
  4641. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4642. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4643. }
  4644. BGFX_C_API void bgfx_set_compute_dynamic_index_buffer(uint8_t _stage, bgfx_dynamic_index_buffer_handle_t _handle, bgfx_access_t _access)
  4645. {
  4646. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4647. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4648. }
  4649. BGFX_C_API void bgfx_set_compute_dynamic_vertex_buffer(uint8_t _stage, bgfx_dynamic_vertex_buffer_handle_t _handle, bgfx_access_t _access)
  4650. {
  4651. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4652. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4653. }
  4654. BGFX_C_API void bgfx_set_compute_indirect_buffer(uint8_t _stage, bgfx_indirect_buffer_handle_t _handle, bgfx_access_t _access)
  4655. {
  4656. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle = { _handle };
  4657. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4658. }
  4659. BGFX_C_API void bgfx_dispatch(bgfx_view_id_t _id, bgfx_program_handle_t _handle, uint32_t _numX, uint32_t _numY, uint32_t _numZ, uint8_t _flags)
  4660. {
  4661. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4662. bgfx::dispatch(_id, handle.cpp, _numX, _numY, _numZ, _flags);
  4663. }
  4664. BGFX_C_API void bgfx_dispatch_indirect(bgfx_view_id_t _id, bgfx_program_handle_t _handle, bgfx_indirect_buffer_handle_t _indirectHandle, uint16_t _start, uint16_t _num, uint8_t _flags)
  4665. {
  4666. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4667. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  4668. bgfx::dispatch(_id, handle.cpp, indirectHandle.cpp, _start, _num, _flags);
  4669. }
  4670. BGFX_C_API void bgfx_discard(void)
  4671. {
  4672. bgfx::discard();
  4673. }
  4674. BGFX_C_API void bgfx_blit(bgfx_view_id_t _id, bgfx_texture_handle_t _dst, uint8_t _dstMip, uint16_t _dstX, uint16_t _dstY, uint16_t _dstZ, bgfx_texture_handle_t _src, uint8_t _srcMip, uint16_t _srcX, uint16_t _srcY, uint16_t _srcZ, uint16_t _width, uint16_t _height, uint16_t _depth)
  4675. {
  4676. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } dst = { _dst };
  4677. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } src = { _src };
  4678. bgfx::blit(_id, dst.cpp, _dstMip, _dstX, _dstY, _dstZ, src.cpp, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth);
  4679. }
  4680. #define BGFX_ENCODER(_func) reinterpret_cast<bgfx::Encoder*>(_encoder)->_func
  4681. BGFX_C_API void bgfx_encoder_set_marker(bgfx_encoder_s* _encoder, const char* _marker)
  4682. {
  4683. BGFX_ENCODER(setMarker(_marker) );
  4684. }
  4685. BGFX_C_API void bgfx_encoder_set_state(bgfx_encoder_s* _encoder, uint64_t _state, uint32_t _rgba)
  4686. {
  4687. BGFX_ENCODER(setState(_state, _rgba) );
  4688. }
  4689. BGFX_C_API void bgfx_encoder_set_condition(bgfx_encoder_s* _encoder, bgfx_occlusion_query_handle_t _handle, bool _visible)
  4690. {
  4691. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  4692. BGFX_ENCODER(setCondition(handle.cpp, _visible) );
  4693. }
  4694. BGFX_C_API void bgfx_encoder_set_stencil(bgfx_encoder_s* _encoder, uint32_t _fstencil, uint32_t _bstencil)
  4695. {
  4696. BGFX_ENCODER(setStencil(_fstencil, _bstencil) );
  4697. }
  4698. BGFX_C_API uint16_t bgfx_encoder_set_scissor(bgfx_encoder_s* _encoder, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  4699. {
  4700. return BGFX_ENCODER(setScissor(_x, _y, _width, _height) );
  4701. }
  4702. BGFX_C_API void bgfx_encoder_set_scissor_cached(bgfx_encoder_s* _encoder, uint16_t _cache)
  4703. {
  4704. BGFX_ENCODER(setScissor(_cache) );
  4705. }
  4706. BGFX_C_API uint32_t bgfx_encoder_set_transform(bgfx_encoder_s* _encoder, const void* _mtx, uint16_t _num)
  4707. {
  4708. return BGFX_ENCODER(setTransform(_mtx, _num) );
  4709. }
  4710. BGFX_C_API uint32_t bgfx_encoder_alloc_transform(bgfx_encoder_s* _encoder, bgfx_transform_t* _transform, uint16_t _num)
  4711. {
  4712. return BGFX_ENCODER(allocTransform( (bgfx::Transform*)_transform, _num) );
  4713. }
  4714. BGFX_C_API void bgfx_encoder_set_transform_cached(bgfx_encoder_s* _encoder, uint32_t _cache, uint16_t _num)
  4715. {
  4716. BGFX_ENCODER(setTransform(_cache, _num) );
  4717. }
  4718. BGFX_C_API void bgfx_encoder_set_uniform(bgfx_encoder_s* _encoder, bgfx_uniform_handle_t _handle, const void* _value, uint16_t _num)
  4719. {
  4720. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  4721. BGFX_ENCODER(setUniform(handle.cpp, _value, _num) );
  4722. }
  4723. BGFX_C_API void bgfx_encoder_set_index_buffer(bgfx_encoder_s* _encoder, bgfx_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  4724. {
  4725. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4726. BGFX_ENCODER(setIndexBuffer(handle.cpp, _firstIndex, _numIndices) );
  4727. }
  4728. BGFX_C_API void bgfx_encoder_set_dynamic_index_buffer(bgfx_encoder_s* _encoder, bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  4729. {
  4730. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4731. BGFX_ENCODER(setIndexBuffer(handle.cpp, _firstIndex, _numIndices) );
  4732. }
  4733. BGFX_C_API void bgfx_encoder_set_transient_index_buffer(bgfx_encoder_s* _encoder, const bgfx_transient_index_buffer_t* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  4734. {
  4735. BGFX_ENCODER(setIndexBuffer( (const bgfx::TransientIndexBuffer*)_tib, _firstIndex, _numIndices) );
  4736. }
  4737. BGFX_C_API void bgfx_encoder_set_vertex_buffer(bgfx_encoder_s* _encoder, uint8_t _stream, bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _numVertices)
  4738. {
  4739. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4740. BGFX_ENCODER(setVertexBuffer(_stream, handle.cpp, _startVertex, _numVertices) );
  4741. }
  4742. BGFX_C_API void bgfx_encoder_set_dynamic_vertex_buffer(bgfx_encoder_s* _encoder, uint8_t _stream, bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _numVertices)
  4743. {
  4744. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4745. BGFX_ENCODER(setVertexBuffer(_stream, handle.cpp, _startVertex, _numVertices) );
  4746. }
  4747. BGFX_C_API void bgfx_encoder_set_transient_vertex_buffer(bgfx_encoder_s* _encoder, uint8_t _stream, const bgfx_transient_vertex_buffer_t* _tvb, uint32_t _startVertex, uint32_t _numVertices)
  4748. {
  4749. BGFX_ENCODER(setVertexBuffer(_stream, (const bgfx::TransientVertexBuffer*)_tvb, _startVertex, _numVertices) );
  4750. }
  4751. BGFX_C_API void bgfx_encoder_set_vertex_count(bgfx_encoder_s* _encoder, uint32_t _numVertices)
  4752. {
  4753. BGFX_ENCODER(setVertexCount(_numVertices) );
  4754. }
  4755. BGFX_C_API void bgfx_encoder_set_instance_data_buffer(bgfx_encoder_s* _encoder, const bgfx_instance_data_buffer_t* _idb, uint32_t _start, uint32_t _num)
  4756. {
  4757. BGFX_ENCODER(setInstanceDataBuffer( (const bgfx::InstanceDataBuffer*)_idb, _start, _num) );
  4758. }
  4759. BGFX_C_API void bgfx_encoder_set_instance_data_from_vertex_buffer(bgfx_encoder_s* _encoder, bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _num)
  4760. {
  4761. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4762. BGFX_ENCODER(setInstanceDataBuffer(handle.cpp, _startVertex, _num) );
  4763. }
  4764. BGFX_C_API void bgfx_encoder_set_instance_data_from_dynamic_vertex_buffer(bgfx_encoder_s* _encoder, bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _num)
  4765. {
  4766. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4767. BGFX_ENCODER(setInstanceDataBuffer(handle.cpp, _startVertex, _num) );
  4768. }
  4769. BGFX_C_API void bgfx_encoder_set_instance_count(bgfx_encoder_s* _encoder, uint32_t _numInstances)
  4770. {
  4771. BGFX_ENCODER(setVertexCount(_numInstances) );
  4772. }
  4773. BGFX_C_API void bgfx_encoder_set_texture(bgfx_encoder_s* _encoder, uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_texture_handle_t _handle, uint32_t _flags)
  4774. {
  4775. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  4776. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4777. BGFX_ENCODER(setTexture(_stage, sampler.cpp, handle.cpp, _flags) );
  4778. }
  4779. BGFX_C_API void bgfx_encoder_touch(bgfx_encoder_s* _encoder, bgfx_view_id_t _id)
  4780. {
  4781. return BGFX_ENCODER(touch(_id) );
  4782. }
  4783. BGFX_C_API void bgfx_encoder_submit(bgfx_encoder_s* _encoder, bgfx_view_id_t _id, bgfx_program_handle_t _handle, int32_t _depth, bool _preserveState)
  4784. {
  4785. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4786. BGFX_ENCODER(submit(_id, handle.cpp, _depth, _preserveState) );
  4787. }
  4788. BGFX_C_API void bgfx_encoder_submit_occlusion_query(bgfx_encoder_s* _encoder, bgfx_view_id_t _id, bgfx_program_handle_t _program, bgfx_occlusion_query_handle_t _occlusionQuery, int32_t _depth, bool _preserveState)
  4789. {
  4790. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } program = { _program };
  4791. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } occlusionQuery = { _occlusionQuery };
  4792. BGFX_ENCODER(submit(_id, program.cpp, occlusionQuery.cpp, _depth, _preserveState) );
  4793. }
  4794. BGFX_C_API void bgfx_encoder_submit_indirect(bgfx_encoder_s* _encoder, bgfx_view_id_t _id, bgfx_program_handle_t _handle, bgfx_indirect_buffer_handle_t _indirectHandle, uint16_t _start, uint16_t _num, int32_t _depth, bool _preserveState)
  4795. {
  4796. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4797. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  4798. BGFX_ENCODER(submit(_id, handle.cpp, indirectHandle.cpp, _start, _num, _depth, _preserveState) );
  4799. }
  4800. BGFX_C_API void bgfx_encoder_set_image(bgfx_encoder_s* _encoder, uint8_t _stage, bgfx_texture_handle_t _handle, uint8_t _mip, bgfx_access_t _access, bgfx_texture_format_t _format)
  4801. {
  4802. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4803. BGFX_ENCODER(setImage(_stage, handle.cpp, _mip, bgfx::Access::Enum(_access), bgfx::TextureFormat::Enum(_format) ) );
  4804. }
  4805. BGFX_C_API void bgfx_encoder_set_compute_index_buffer(bgfx_encoder_s* _encoder, uint8_t _stage, bgfx_index_buffer_handle_t _handle, bgfx_access_t _access)
  4806. {
  4807. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4808. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4809. }
  4810. BGFX_C_API void bgfx_encoder_set_compute_vertex_buffer(bgfx_encoder_s* _encoder, uint8_t _stage, bgfx_vertex_buffer_handle_t _handle, bgfx_access_t _access)
  4811. {
  4812. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4813. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4814. }
  4815. BGFX_C_API void bgfx_encoder_set_compute_dynamic_index_buffer(bgfx_encoder_s* _encoder, uint8_t _stage, bgfx_dynamic_index_buffer_handle_t _handle, bgfx_access_t _access)
  4816. {
  4817. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4818. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4819. }
  4820. BGFX_C_API void bgfx_encoder_set_compute_dynamic_vertex_buffer(bgfx_encoder_s* _encoder, uint8_t _stage, bgfx_dynamic_vertex_buffer_handle_t _handle, bgfx_access_t _access)
  4821. {
  4822. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4823. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4824. }
  4825. BGFX_C_API void bgfx_encoder_set_compute_indirect_buffer(bgfx_encoder_s* _encoder, uint8_t _stage, bgfx_indirect_buffer_handle_t _handle, bgfx_access_t _access)
  4826. {
  4827. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle = { _handle };
  4828. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4829. }
  4830. BGFX_C_API void bgfx_encoder_dispatch(bgfx_encoder_s* _encoder, bgfx_view_id_t _id, bgfx_program_handle_t _handle, uint32_t _numX, uint32_t _numY, uint32_t _numZ, uint8_t _flags)
  4831. {
  4832. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4833. BGFX_ENCODER(dispatch(_id, handle.cpp, _numX, _numY, _numZ, _flags) );
  4834. }
  4835. BGFX_C_API void bgfx_encoder_dispatch_indirect(bgfx_encoder_s* _encoder, bgfx_view_id_t _id, bgfx_program_handle_t _handle, bgfx_indirect_buffer_handle_t _indirectHandle, uint16_t _start, uint16_t _num, uint8_t _flags)
  4836. {
  4837. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4838. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  4839. BGFX_ENCODER(dispatch(_id, handle.cpp, indirectHandle.cpp, _start, _num, _flags) );
  4840. }
  4841. BGFX_C_API void bgfx_encoder_discard(bgfx_encoder_s* _encoder)
  4842. {
  4843. BGFX_ENCODER(discard() );
  4844. }
  4845. BGFX_C_API void bgfx_encoder_blit(bgfx_encoder_s* _encoder, bgfx_view_id_t _id, bgfx_texture_handle_t _dst, uint8_t _dstMip, uint16_t _dstX, uint16_t _dstY, uint16_t _dstZ, bgfx_texture_handle_t _src, uint8_t _srcMip, uint16_t _srcX, uint16_t _srcY, uint16_t _srcZ, uint16_t _width, uint16_t _height, uint16_t _depth)
  4846. {
  4847. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } dst = { _dst };
  4848. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } src = { _src };
  4849. BGFX_ENCODER(blit(_id, dst.cpp, _dstMip, _dstX, _dstY, _dstZ, src.cpp, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth) );
  4850. }
  4851. #undef BGFX_ENCODER
  4852. BGFX_C_API void bgfx_request_screen_shot(bgfx_frame_buffer_handle_t _handle, const char* _filePath)
  4853. {
  4854. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  4855. bgfx::requestScreenShot(handle.cpp, _filePath);
  4856. }
  4857. BGFX_C_API bgfx_render_frame_t bgfx_render_frame(int32_t _msecs)
  4858. {
  4859. return bgfx_render_frame_t(bgfx::renderFrame(_msecs) );
  4860. }
  4861. BGFX_C_API void bgfx_set_platform_data(const bgfx_platform_data_t* _data)
  4862. {
  4863. bgfx::setPlatformData(*(const bgfx::PlatformData*)_data);
  4864. }
  4865. BGFX_C_API const bgfx_internal_data_t* bgfx_get_internal_data()
  4866. {
  4867. return (const bgfx_internal_data_t*)bgfx::getInternalData();
  4868. }
  4869. BGFX_C_API uintptr_t bgfx_override_internal_texture_ptr(bgfx_texture_handle_t _handle, uintptr_t _ptr)
  4870. {
  4871. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4872. return bgfx::overrideInternal(handle.cpp, _ptr);
  4873. }
  4874. BGFX_C_API uintptr_t bgfx_override_internal_texture(bgfx_texture_handle_t _handle, uint16_t _width, uint16_t _height, uint8_t _numMips, bgfx_texture_format_t _format, uint32_t _flags)
  4875. {
  4876. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4877. return bgfx::overrideInternal(handle.cpp, _width, _height, _numMips, bgfx::TextureFormat::Enum(_format), _flags);
  4878. }
  4879. BGFX_C_API bgfx_interface_vtbl_t* bgfx_get_interface(uint32_t _version)
  4880. {
  4881. if (_version == BGFX_API_VERSION)
  4882. {
  4883. #define BGFX_IMPORT \
  4884. BGFX_IMPORT_FUNC(render_frame) \
  4885. BGFX_IMPORT_FUNC(set_platform_data) \
  4886. BGFX_IMPORT_FUNC(get_internal_data) \
  4887. BGFX_IMPORT_FUNC(override_internal_texture_ptr) \
  4888. BGFX_IMPORT_FUNC(override_internal_texture) \
  4889. BGFX_IMPORT_FUNC(vertex_decl_begin) \
  4890. BGFX_IMPORT_FUNC(vertex_decl_add) \
  4891. BGFX_IMPORT_FUNC(vertex_decl_decode) \
  4892. BGFX_IMPORT_FUNC(vertex_decl_has) \
  4893. BGFX_IMPORT_FUNC(vertex_decl_skip) \
  4894. BGFX_IMPORT_FUNC(vertex_decl_end) \
  4895. BGFX_IMPORT_FUNC(vertex_pack) \
  4896. BGFX_IMPORT_FUNC(vertex_unpack) \
  4897. BGFX_IMPORT_FUNC(vertex_convert) \
  4898. BGFX_IMPORT_FUNC(weld_vertices) \
  4899. BGFX_IMPORT_FUNC(topology_convert) \
  4900. BGFX_IMPORT_FUNC(topology_sort_tri_list) \
  4901. BGFX_IMPORT_FUNC(get_supported_renderers) \
  4902. BGFX_IMPORT_FUNC(get_renderer_name) \
  4903. BGFX_IMPORT_FUNC(init_ctor) \
  4904. BGFX_IMPORT_FUNC(init) \
  4905. BGFX_IMPORT_FUNC(shutdown) \
  4906. BGFX_IMPORT_FUNC(reset) \
  4907. BGFX_IMPORT_FUNC(frame) \
  4908. BGFX_IMPORT_FUNC(get_renderer_type) \
  4909. BGFX_IMPORT_FUNC(get_caps) \
  4910. BGFX_IMPORT_FUNC(get_stats) \
  4911. BGFX_IMPORT_FUNC(alloc) \
  4912. BGFX_IMPORT_FUNC(copy) \
  4913. BGFX_IMPORT_FUNC(make_ref) \
  4914. BGFX_IMPORT_FUNC(make_ref_release) \
  4915. BGFX_IMPORT_FUNC(set_debug) \
  4916. BGFX_IMPORT_FUNC(dbg_text_clear) \
  4917. BGFX_IMPORT_FUNC(dbg_text_printf) \
  4918. BGFX_IMPORT_FUNC(dbg_text_vprintf) \
  4919. BGFX_IMPORT_FUNC(dbg_text_image) \
  4920. BGFX_IMPORT_FUNC(create_index_buffer) \
  4921. BGFX_IMPORT_FUNC(destroy_index_buffer) \
  4922. BGFX_IMPORT_FUNC(create_vertex_buffer) \
  4923. BGFX_IMPORT_FUNC(destroy_vertex_buffer) \
  4924. BGFX_IMPORT_FUNC(create_dynamic_index_buffer) \
  4925. BGFX_IMPORT_FUNC(create_dynamic_index_buffer_mem) \
  4926. BGFX_IMPORT_FUNC(update_dynamic_index_buffer) \
  4927. BGFX_IMPORT_FUNC(destroy_dynamic_index_buffer) \
  4928. BGFX_IMPORT_FUNC(create_dynamic_vertex_buffer) \
  4929. BGFX_IMPORT_FUNC(create_dynamic_vertex_buffer_mem) \
  4930. BGFX_IMPORT_FUNC(update_dynamic_vertex_buffer) \
  4931. BGFX_IMPORT_FUNC(destroy_dynamic_vertex_buffer) \
  4932. BGFX_IMPORT_FUNC(get_avail_transient_index_buffer) \
  4933. BGFX_IMPORT_FUNC(get_avail_transient_vertex_buffer) \
  4934. BGFX_IMPORT_FUNC(get_avail_instance_data_buffer) \
  4935. BGFX_IMPORT_FUNC(alloc_transient_index_buffer) \
  4936. BGFX_IMPORT_FUNC(alloc_transient_vertex_buffer) \
  4937. BGFX_IMPORT_FUNC(alloc_transient_buffers) \
  4938. BGFX_IMPORT_FUNC(alloc_instance_data_buffer) \
  4939. BGFX_IMPORT_FUNC(create_indirect_buffer) \
  4940. BGFX_IMPORT_FUNC(destroy_indirect_buffer) \
  4941. BGFX_IMPORT_FUNC(create_shader) \
  4942. BGFX_IMPORT_FUNC(get_shader_uniforms) \
  4943. BGFX_IMPORT_FUNC(set_shader_name) \
  4944. BGFX_IMPORT_FUNC(destroy_shader) \
  4945. BGFX_IMPORT_FUNC(create_program) \
  4946. BGFX_IMPORT_FUNC(create_compute_program) \
  4947. BGFX_IMPORT_FUNC(destroy_program) \
  4948. BGFX_IMPORT_FUNC(is_texture_valid) \
  4949. BGFX_IMPORT_FUNC(calc_texture_size) \
  4950. BGFX_IMPORT_FUNC(create_texture) \
  4951. BGFX_IMPORT_FUNC(create_texture_2d) \
  4952. BGFX_IMPORT_FUNC(create_texture_2d_scaled) \
  4953. BGFX_IMPORT_FUNC(create_texture_3d) \
  4954. BGFX_IMPORT_FUNC(create_texture_cube) \
  4955. BGFX_IMPORT_FUNC(update_texture_2d) \
  4956. BGFX_IMPORT_FUNC(update_texture_3d) \
  4957. BGFX_IMPORT_FUNC(update_texture_cube) \
  4958. BGFX_IMPORT_FUNC(read_texture) \
  4959. BGFX_IMPORT_FUNC(set_texture_name) \
  4960. BGFX_IMPORT_FUNC(get_direct_access_ptr) \
  4961. BGFX_IMPORT_FUNC(destroy_texture) \
  4962. BGFX_IMPORT_FUNC(create_frame_buffer) \
  4963. BGFX_IMPORT_FUNC(create_frame_buffer_scaled) \
  4964. BGFX_IMPORT_FUNC(create_frame_buffer_from_attachment) \
  4965. BGFX_IMPORT_FUNC(create_frame_buffer_from_nwh) \
  4966. BGFX_IMPORT_FUNC(get_texture) \
  4967. BGFX_IMPORT_FUNC(destroy_frame_buffer) \
  4968. BGFX_IMPORT_FUNC(create_uniform) \
  4969. BGFX_IMPORT_FUNC(get_uniform_info) \
  4970. BGFX_IMPORT_FUNC(destroy_uniform) \
  4971. BGFX_IMPORT_FUNC(create_occlusion_query) \
  4972. BGFX_IMPORT_FUNC(get_result) \
  4973. BGFX_IMPORT_FUNC(destroy_occlusion_query) \
  4974. BGFX_IMPORT_FUNC(set_palette_color) \
  4975. BGFX_IMPORT_FUNC(set_view_name) \
  4976. BGFX_IMPORT_FUNC(set_view_rect) \
  4977. BGFX_IMPORT_FUNC(set_view_scissor) \
  4978. BGFX_IMPORT_FUNC(set_view_clear) \
  4979. BGFX_IMPORT_FUNC(set_view_clear_mrt) \
  4980. BGFX_IMPORT_FUNC(set_view_mode) \
  4981. BGFX_IMPORT_FUNC(set_view_frame_buffer) \
  4982. BGFX_IMPORT_FUNC(set_view_transform) \
  4983. BGFX_IMPORT_FUNC(set_view_transform_stereo) \
  4984. BGFX_IMPORT_FUNC(set_view_order) \
  4985. BGFX_IMPORT_FUNC(encoder_set_marker) \
  4986. BGFX_IMPORT_FUNC(encoder_set_state) \
  4987. BGFX_IMPORT_FUNC(encoder_set_condition) \
  4988. BGFX_IMPORT_FUNC(encoder_set_stencil) \
  4989. BGFX_IMPORT_FUNC(encoder_set_scissor) \
  4990. BGFX_IMPORT_FUNC(encoder_set_scissor_cached) \
  4991. BGFX_IMPORT_FUNC(encoder_set_transform) \
  4992. BGFX_IMPORT_FUNC(encoder_alloc_transform) \
  4993. BGFX_IMPORT_FUNC(encoder_set_transform_cached) \
  4994. BGFX_IMPORT_FUNC(encoder_set_uniform) \
  4995. BGFX_IMPORT_FUNC(encoder_set_index_buffer) \
  4996. BGFX_IMPORT_FUNC(encoder_set_dynamic_index_buffer) \
  4997. BGFX_IMPORT_FUNC(encoder_set_transient_index_buffer) \
  4998. BGFX_IMPORT_FUNC(encoder_set_vertex_buffer) \
  4999. BGFX_IMPORT_FUNC(encoder_set_dynamic_vertex_buffer) \
  5000. BGFX_IMPORT_FUNC(encoder_set_transient_vertex_buffer) \
  5001. BGFX_IMPORT_FUNC(encoder_set_vertex_count) \
  5002. BGFX_IMPORT_FUNC(encoder_set_instance_data_buffer) \
  5003. BGFX_IMPORT_FUNC(encoder_set_instance_data_from_vertex_buffer) \
  5004. BGFX_IMPORT_FUNC(encoder_set_instance_data_from_dynamic_vertex_buffer) \
  5005. BGFX_IMPORT_FUNC(encoder_set_instance_count) \
  5006. BGFX_IMPORT_FUNC(encoder_set_texture) \
  5007. BGFX_IMPORT_FUNC(encoder_touch) \
  5008. BGFX_IMPORT_FUNC(encoder_submit) \
  5009. BGFX_IMPORT_FUNC(encoder_submit_occlusion_query) \
  5010. BGFX_IMPORT_FUNC(encoder_submit_indirect) \
  5011. BGFX_IMPORT_FUNC(encoder_set_image) \
  5012. BGFX_IMPORT_FUNC(encoder_set_compute_index_buffer) \
  5013. BGFX_IMPORT_FUNC(encoder_set_compute_vertex_buffer) \
  5014. BGFX_IMPORT_FUNC(encoder_set_compute_dynamic_index_buffer) \
  5015. BGFX_IMPORT_FUNC(encoder_set_compute_dynamic_vertex_buffer) \
  5016. BGFX_IMPORT_FUNC(encoder_set_compute_indirect_buffer) \
  5017. BGFX_IMPORT_FUNC(encoder_dispatch) \
  5018. BGFX_IMPORT_FUNC(encoder_dispatch_indirect) \
  5019. BGFX_IMPORT_FUNC(encoder_discard) \
  5020. BGFX_IMPORT_FUNC(encoder_blit) \
  5021. BGFX_IMPORT_FUNC(request_screen_shot)
  5022. static bgfx_interface_vtbl_t s_bgfx_interface =
  5023. {
  5024. #define BGFX_IMPORT_FUNC(_name) BX_CONCATENATE(bgfx_, _name),
  5025. BGFX_IMPORT
  5026. #undef BGFX_IMPORT_FUNC
  5027. };
  5028. return &s_bgfx_interface;
  5029. }
  5030. return NULL;
  5031. }