bgfx.cpp 180 KB

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