bgfx.cpp 158 KB

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