bgfx.cpp 143 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803
  1. /*
  2. * Copyright 2011-2016 Branimir Karadzic. All rights reserved.
  3. * License: https://github.com/bkaradzic/bgfx#license-bsd-2-clause
  4. */
  5. #include <bx/platform.h>
  6. #if BX_PLATFORM_WINDOWS
  7. // BK - Remotery needs WinSock, but on VS2015/Win10 build
  8. // fails if WinSock2 is included after Windows.h?!
  9. # include <winsock2.h>
  10. #endif // BX_PLATFORM_WINDOWS
  11. #include "bgfx_p.h"
  12. #if BGFX_CONFIG_PROFILER_REMOTERY_BUILD_LIB
  13. # define RMT_USE_D3D11 BGFX_CONFIG_RENDERER_DIRECT3D11
  14. # define RMT_USE_OPENGL BGFX_CONFIG_RENDERER_OPENGL
  15. # include <remotery/lib/Remotery.c>
  16. #endif // BGFX_CONFIG_PROFILER_REMOTERY_BUILD_LIB
  17. #include <bx/crtimpl.h>
  18. #include "topology.h"
  19. namespace bgfx
  20. {
  21. #define BGFX_MAIN_THREAD_MAGIC UINT32_C(0x78666762)
  22. #if BGFX_CONFIG_MULTITHREADED
  23. # define BGFX_CHECK_MAIN_THREAD() \
  24. BX_CHECK(NULL != s_ctx, "Library is not initialized yet."); \
  25. BX_CHECK(BGFX_MAIN_THREAD_MAGIC == s_threadIndex, "Must be called from main thread.")
  26. # define BGFX_CHECK_RENDER_THREAD() BX_CHECK(BGFX_MAIN_THREAD_MAGIC != s_threadIndex, "Must be called from render thread.")
  27. #else
  28. # define BGFX_CHECK_MAIN_THREAD()
  29. # define BGFX_CHECK_RENDER_THREAD()
  30. #endif // BGFX_CONFIG_MULTITHREADED
  31. #define BGFX_CHECK_CAPS(_caps, _msg) \
  32. BX_CHECK(0 != (g_caps.supported & (_caps) ) \
  33. , _msg " Use bgfx::getCaps to check " #_caps " backend renderer capabilities." \
  34. );
  35. #if BGFX_CONFIG_USE_TINYSTL
  36. void* TinyStlAllocator::static_allocate(size_t _bytes)
  37. {
  38. return BX_ALLOC(g_allocator, _bytes);
  39. }
  40. void TinyStlAllocator::static_deallocate(void* _ptr, size_t /*_bytes*/)
  41. {
  42. if (NULL != _ptr)
  43. {
  44. BX_FREE(g_allocator, _ptr);
  45. }
  46. }
  47. #endif // BGFX_CONFIG_USE_TINYSTL
  48. struct CallbackStub : public CallbackI
  49. {
  50. virtual ~CallbackStub()
  51. {
  52. }
  53. virtual void traceVargs(const char* _filePath, uint16_t _line, const char* _format, va_list _argList) BX_OVERRIDE
  54. {
  55. char temp[2048];
  56. char* out = temp;
  57. va_list argListCopy;
  58. va_copy(argListCopy, _argList);
  59. int32_t len = bx::snprintf(out, sizeof(temp), "%s (%d): ", _filePath, _line);
  60. int32_t total = len + bx::vsnprintf(out + len, sizeof(temp)-len, _format, argListCopy);
  61. va_end(argListCopy);
  62. if ( (int32_t)sizeof(temp) < total)
  63. {
  64. out = (char*)alloca(total+1);
  65. memcpy(out, temp, len);
  66. bx::vsnprintf(out + len, total-len, _format, _argList);
  67. }
  68. out[total] = '\0';
  69. bx::debugOutput(out);
  70. }
  71. virtual void fatal(Fatal::Enum _code, const char* _str) BX_OVERRIDE
  72. {
  73. if (Fatal::DebugCheck == _code)
  74. {
  75. bx::debugBreak();
  76. }
  77. else
  78. {
  79. BX_TRACE("0x%08x: %s", _code, _str);
  80. BX_UNUSED(_code, _str);
  81. abort();
  82. }
  83. }
  84. virtual uint32_t cacheReadSize(uint64_t /*_id*/) BX_OVERRIDE
  85. {
  86. return 0;
  87. }
  88. virtual bool cacheRead(uint64_t /*_id*/, void* /*_data*/, uint32_t /*_size*/) BX_OVERRIDE
  89. {
  90. return false;
  91. }
  92. virtual void cacheWrite(uint64_t /*_id*/, const void* /*_data*/, uint32_t /*_size*/) BX_OVERRIDE
  93. {
  94. }
  95. virtual void screenShot(const char* _filePath, uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _data, uint32_t _size, bool _yflip) BX_OVERRIDE
  96. {
  97. BX_UNUSED(_filePath, _width, _height, _pitch, _data, _size, _yflip);
  98. #if BX_CONFIG_CRT_FILE_READER_WRITER
  99. char* filePath = (char*)alloca(strlen(_filePath)+5);
  100. strcpy(filePath, _filePath);
  101. strcat(filePath, ".tga");
  102. bx::CrtFileWriter writer;
  103. if (bx::open(&writer, filePath) )
  104. {
  105. imageWriteTga(&writer, _width, _height, _pitch, _data, false, _yflip);
  106. bx::close(&writer);
  107. }
  108. #endif // BX_CONFIG_CRT_FILE_READER_WRITER
  109. }
  110. virtual void captureBegin(uint32_t /*_width*/, uint32_t /*_height*/, uint32_t /*_pitch*/, TextureFormat::Enum /*_format*/, bool /*_yflip*/) BX_OVERRIDE
  111. {
  112. BX_TRACE("Warning: using capture without callback (a.k.a. pointless).");
  113. }
  114. virtual void captureEnd() BX_OVERRIDE
  115. {
  116. }
  117. virtual void captureFrame(const void* /*_data*/, uint32_t /*_size*/) BX_OVERRIDE
  118. {
  119. }
  120. };
  121. #ifndef BGFX_CONFIG_MEMORY_TRACKING
  122. # define BGFX_CONFIG_MEMORY_TRACKING (BGFX_CONFIG_DEBUG && BX_CONFIG_SUPPORTS_THREADING)
  123. #endif // BGFX_CONFIG_MEMORY_TRACKING
  124. class AllocatorStub : public bx::AllocatorI
  125. {
  126. public:
  127. AllocatorStub()
  128. #if BGFX_CONFIG_MEMORY_TRACKING
  129. : m_numBlocks(0)
  130. , m_maxBlocks(0)
  131. #endif // BGFX_CONFIG_MEMORY_TRACKING
  132. {
  133. }
  134. virtual void* realloc(void* _ptr, size_t _size, size_t _align, const char* _file, uint32_t _line) BX_OVERRIDE
  135. {
  136. if (0 == _size)
  137. {
  138. if (NULL != _ptr)
  139. {
  140. if (BX_CONFIG_ALLOCATOR_NATURAL_ALIGNMENT >= _align)
  141. {
  142. #if BGFX_CONFIG_MEMORY_TRACKING
  143. {
  144. bx::LwMutexScope scope(m_mutex);
  145. BX_CHECK(m_numBlocks > 0, "Number of blocks is 0. Possible alloc/free mismatch?");
  146. --m_numBlocks;
  147. }
  148. #endif // BGFX_CONFIG_MEMORY_TRACKING
  149. ::free(_ptr);
  150. }
  151. else
  152. {
  153. bx::alignedFree(this, _ptr, _align, _file, _line);
  154. }
  155. }
  156. return NULL;
  157. }
  158. else if (NULL == _ptr)
  159. {
  160. if (BX_CONFIG_ALLOCATOR_NATURAL_ALIGNMENT >= _align)
  161. {
  162. #if BGFX_CONFIG_MEMORY_TRACKING
  163. {
  164. bx::LwMutexScope scope(m_mutex);
  165. ++m_numBlocks;
  166. m_maxBlocks = bx::uint32_max(m_maxBlocks, m_numBlocks);
  167. }
  168. #endif // BGFX_CONFIG_MEMORY_TRACKING
  169. return ::malloc(_size);
  170. }
  171. return bx::alignedAlloc(this, _size, _align, _file, _line);
  172. }
  173. if (BX_CONFIG_ALLOCATOR_NATURAL_ALIGNMENT >= _align)
  174. {
  175. #if BGFX_CONFIG_MEMORY_TRACKING
  176. if (NULL == _ptr)
  177. {
  178. bx::LwMutexScope scope(m_mutex);
  179. ++m_numBlocks;
  180. m_maxBlocks = bx::uint32_max(m_maxBlocks, m_numBlocks);
  181. }
  182. #endif // BGFX_CONFIG_MEMORY_TRACKING
  183. return ::realloc(_ptr, _size);
  184. }
  185. return bx::alignedRealloc(this, _ptr, _size, _align, _file, _line);
  186. }
  187. void checkLeaks();
  188. protected:
  189. #if BGFX_CONFIG_MEMORY_TRACKING
  190. bx::LwMutex m_mutex;
  191. uint32_t m_numBlocks;
  192. uint32_t m_maxBlocks;
  193. #endif // BGFX_CONFIG_MEMORY_TRACKING
  194. };
  195. static CallbackStub* s_callbackStub = NULL;
  196. static AllocatorStub* s_allocatorStub = NULL;
  197. static bool s_graphicsDebuggerPresent = false;
  198. CallbackI* g_callback = NULL;
  199. bx::AllocatorI* g_allocator = NULL;
  200. Caps g_caps;
  201. #if BGFX_CONFIG_MULTITHREADED && !defined(BX_THREAD_LOCAL)
  202. class ThreadData
  203. {
  204. BX_CLASS(ThreadData
  205. , NO_COPY
  206. , NO_ASSIGNMENT
  207. );
  208. public:
  209. ThreadData(uintptr_t _rhs)
  210. {
  211. union { uintptr_t ui; void* ptr; } cast = { _rhs };
  212. m_tls.set(cast.ptr);
  213. }
  214. operator uintptr_t() const
  215. {
  216. union { uintptr_t ui; void* ptr; } cast;
  217. cast.ptr = m_tls.get();
  218. return cast.ui;
  219. }
  220. uintptr_t operator=(uintptr_t _rhs)
  221. {
  222. union { uintptr_t ui; void* ptr; } cast = { _rhs };
  223. m_tls.set(cast.ptr);
  224. return _rhs;
  225. }
  226. bool operator==(uintptr_t _rhs) const
  227. {
  228. uintptr_t lhs = *this;
  229. return lhs == _rhs;
  230. }
  231. private:
  232. bx::TlsData m_tls;
  233. };
  234. static ThreadData s_threadIndex(0);
  235. #elif !BGFX_CONFIG_MULTITHREADED
  236. static uint32_t s_threadIndex(0);
  237. #else
  238. static BX_THREAD_LOCAL uint32_t s_threadIndex(0);
  239. #endif
  240. static Context* s_ctx = NULL;
  241. static bool s_renderFrameCalled = false;
  242. InternalData g_internalData;
  243. PlatformData g_platformData;
  244. bool g_platformDataChangedSinceReset = false;
  245. void AllocatorStub::checkLeaks()
  246. {
  247. #if BGFX_CONFIG_MEMORY_TRACKING
  248. // BK - CallbackStub will be deleted after printing this info, so there is always one
  249. // leak if CallbackStub is used.
  250. BX_WARN(uint32_t(NULL != s_callbackStub ? 1 : 0) == m_numBlocks
  251. , "MEMORY LEAK: %d (max: %d)"
  252. , m_numBlocks
  253. , m_maxBlocks
  254. );
  255. #endif // BGFX_CONFIG_MEMORY_TRACKING
  256. }
  257. void setPlatformData(const PlatformData& _data)
  258. {
  259. if (NULL != s_ctx)
  260. {
  261. BGFX_FATAL(true
  262. && g_platformData.ndt == _data.ndt
  263. && g_platformData.context == _data.context
  264. , Fatal::UnableToInitialize
  265. , "Only backbuffer pointer and native window handle can be changed after initialization!"
  266. );
  267. }
  268. memcpy(&g_platformData, &_data, sizeof(PlatformData) );
  269. g_platformDataChangedSinceReset = true;
  270. }
  271. const InternalData* getInternalData()
  272. {
  273. BGFX_CHECK_RENDER_THREAD();
  274. return &g_internalData;
  275. }
  276. uintptr_t overrideInternal(TextureHandle _handle, uintptr_t _ptr)
  277. {
  278. BGFX_CHECK_RENDER_THREAD();
  279. RendererContextI* rci = s_ctx->m_renderCtx;
  280. if (0 == rci->getInternal(_handle) )
  281. {
  282. return 0;
  283. }
  284. rci->overrideInternal(_handle, _ptr);
  285. return rci->getInternal(_handle);
  286. }
  287. uintptr_t overrideInternal(TextureHandle _handle, uint16_t _width, uint16_t _height, uint8_t _numMips, TextureFormat::Enum _format, uint32_t _flags)
  288. {
  289. BGFX_CHECK_RENDER_THREAD();
  290. RendererContextI* rci = s_ctx->m_renderCtx;
  291. if (0 == rci->getInternal(_handle) )
  292. {
  293. return 0;
  294. }
  295. uint32_t size = sizeof(uint32_t) + sizeof(TextureCreate);
  296. Memory* mem = const_cast<Memory*>(alloc(size) );
  297. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  298. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  299. bx::write(&writer, magic);
  300. TextureCreate tc;
  301. tc.m_width = _width;
  302. tc.m_height = _height;
  303. tc.m_depth = 0;
  304. tc.m_numLayers = 1;
  305. tc.m_numMips = uint8_t(bx::uint16_max(1, _numMips) );
  306. tc.m_format = _format;
  307. tc.m_cubeMap = false;
  308. tc.m_mem = NULL;
  309. bx::write(&writer, tc);
  310. rci->destroyTexture(_handle);
  311. rci->createTexture(_handle, mem, _flags, 0);
  312. release(mem);
  313. return rci->getInternal(_handle);
  314. }
  315. void setGraphicsDebuggerPresent(bool _present)
  316. {
  317. BX_TRACE("Graphics debugger is %spresent.", _present ? "" : "not ");
  318. s_graphicsDebuggerPresent = _present;
  319. }
  320. bool isGraphicsDebuggerPresent()
  321. {
  322. return s_graphicsDebuggerPresent;
  323. }
  324. void fatal(Fatal::Enum _code, const char* _format, ...)
  325. {
  326. va_list argList;
  327. va_start(argList, _format);
  328. if (BX_UNLIKELY(NULL == g_callback) )
  329. {
  330. dbgPrintfVargs(_format, argList);
  331. abort();
  332. }
  333. else
  334. {
  335. char temp[8192];
  336. char* out = temp;
  337. int32_t len = bx::vsnprintf(out, sizeof(temp), _format, argList);
  338. if ( (int32_t)sizeof(temp) < len)
  339. {
  340. out = (char*)alloca(len+1);
  341. len = bx::vsnprintf(out, len, _format, argList);
  342. }
  343. out[len] = '\0';
  344. g_callback->fatal(_code, out);
  345. }
  346. va_end(argList);
  347. }
  348. void trace(const char* _filePath, uint16_t _line, const char* _format, ...)
  349. {
  350. va_list argList;
  351. va_start(argList, _format);
  352. if (BX_UNLIKELY(NULL == g_callback) )
  353. {
  354. dbgPrintfVargs(_format, argList);
  355. }
  356. else
  357. {
  358. g_callback->traceVargs(_filePath, _line, _format, argList);
  359. }
  360. va_end(argList);
  361. }
  362. #include "charset.h"
  363. void charsetFillTexture(const uint8_t* _charset, uint8_t* _rgba, uint32_t _height, uint32_t _pitch, uint32_t _bpp)
  364. {
  365. for (uint32_t ii = 0; ii < 256; ++ii)
  366. {
  367. uint8_t* pix = &_rgba[ii*8*_bpp];
  368. for (uint32_t yy = 0; yy < _height; ++yy)
  369. {
  370. for (uint32_t xx = 0; xx < 8; ++xx)
  371. {
  372. uint8_t bit = 1<<(7-xx);
  373. memset(&pix[xx*_bpp], _charset[ii*_height+yy]&bit ? 255 : 0, _bpp);
  374. }
  375. pix += _pitch;
  376. }
  377. }
  378. }
  379. static const uint32_t numCharsPerBatch = 1024;
  380. static const uint32_t numBatchVertices = numCharsPerBatch*4;
  381. static const uint32_t numBatchIndices = numCharsPerBatch*6;
  382. void TextVideoMemBlitter::init()
  383. {
  384. BGFX_CHECK_MAIN_THREAD();
  385. m_decl
  386. .begin()
  387. .add(Attrib::Position, 3, AttribType::Float)
  388. .add(Attrib::Color0, 4, AttribType::Uint8, true)
  389. .add(Attrib::Color1, 4, AttribType::Uint8, true)
  390. .add(Attrib::TexCoord0, 2, AttribType::Float)
  391. .end();
  392. uint16_t width = 2048;
  393. uint16_t height = 24;
  394. uint8_t bpp = 1;
  395. uint32_t pitch = width*bpp;
  396. const Memory* mem;
  397. mem = alloc(pitch*height);
  398. uint8_t* rgba = mem->data;
  399. charsetFillTexture(vga8x8, rgba, 8, pitch, bpp);
  400. charsetFillTexture(vga8x16, &rgba[8*pitch], 16, pitch, bpp);
  401. m_texture = createTexture2D(width, height, false, 1, TextureFormat::R8
  402. , BGFX_TEXTURE_MIN_POINT
  403. | BGFX_TEXTURE_MAG_POINT
  404. | BGFX_TEXTURE_MIP_POINT
  405. | BGFX_TEXTURE_U_CLAMP
  406. | BGFX_TEXTURE_V_CLAMP
  407. , mem
  408. );
  409. switch (g_caps.rendererType)
  410. {
  411. case RendererType::Direct3D9:
  412. mem = makeRef(vs_debugfont_dx9, sizeof(vs_debugfont_dx9) );
  413. break;
  414. case RendererType::Direct3D11:
  415. case RendererType::Direct3D12:
  416. mem = makeRef(vs_debugfont_dx11, sizeof(vs_debugfont_dx11) );
  417. break;
  418. case RendererType::Metal:
  419. mem = makeRef(vs_debugfont_mtl, sizeof(vs_debugfont_mtl) );
  420. break;
  421. default:
  422. mem = makeRef(vs_debugfont_glsl, sizeof(vs_debugfont_glsl) );
  423. break;
  424. }
  425. ShaderHandle vsh = createShader(mem);
  426. switch (g_caps.rendererType)
  427. {
  428. case RendererType::Direct3D9:
  429. mem = makeRef(fs_debugfont_dx9, sizeof(fs_debugfont_dx9) );
  430. break;
  431. case RendererType::Direct3D11:
  432. case RendererType::Direct3D12:
  433. mem = makeRef(fs_debugfont_dx11, sizeof(fs_debugfont_dx11) );
  434. break;
  435. case RendererType::Metal:
  436. mem = makeRef(fs_debugfont_mtl, sizeof(fs_debugfont_mtl) );
  437. break;
  438. default:
  439. mem = makeRef(fs_debugfont_glsl, sizeof(fs_debugfont_glsl) );
  440. break;
  441. }
  442. ShaderHandle fsh = createShader(mem);
  443. m_program = createProgram(vsh, fsh, true);
  444. m_vb = s_ctx->createTransientVertexBuffer(numBatchVertices*m_decl.m_stride, &m_decl);
  445. m_ib = s_ctx->createTransientIndexBuffer(numBatchIndices*2);
  446. }
  447. void TextVideoMemBlitter::shutdown()
  448. {
  449. BGFX_CHECK_MAIN_THREAD();
  450. destroyProgram(m_program);
  451. destroyTexture(m_texture);
  452. s_ctx->destroyTransientVertexBuffer(m_vb);
  453. s_ctx->destroyTransientIndexBuffer(m_ib);
  454. }
  455. void blit(RendererContextI* _renderCtx, TextVideoMemBlitter& _blitter, const TextVideoMem& _mem)
  456. {
  457. struct Vertex
  458. {
  459. float m_x;
  460. float m_y;
  461. float m_z;
  462. uint32_t m_fg;
  463. uint32_t m_bg;
  464. float m_u;
  465. float m_v;
  466. };
  467. static uint32_t palette[16] =
  468. {
  469. 0x0,
  470. 0xff0000cc,
  471. 0xff069a4e,
  472. 0xff00a0c4,
  473. 0xffa46534,
  474. 0xff7b5075,
  475. 0xff9a9806,
  476. 0xffcfd7d3,
  477. 0xff535755,
  478. 0xff2929ef,
  479. 0xff34e28a,
  480. 0xff4fe9fc,
  481. 0xffcf9f72,
  482. 0xffa87fad,
  483. 0xffe2e234,
  484. 0xffeceeee,
  485. };
  486. uint32_t yy = 0;
  487. uint32_t xx = 0;
  488. const float texelWidth = 1.0f/2048.0f;
  489. const float texelWidthHalf = RendererType::Direct3D9 == g_caps.rendererType ? 0.0f : texelWidth*0.5f;
  490. const float texelHeight = 1.0f/24.0f;
  491. const float texelHeightHalf = RendererType::Direct3D9 == g_caps.rendererType ? texelHeight*0.5f : 0.0f;
  492. const float utop = (_mem.m_small ? 0.0f : 8.0f)*texelHeight + texelHeightHalf;
  493. const float ubottom = (_mem.m_small ? 8.0f : 24.0f)*texelHeight + texelHeightHalf;
  494. const float fontHeight = (_mem.m_small ? 8.0f : 16.0f);
  495. _renderCtx->blitSetup(_blitter);
  496. for (;yy < _mem.m_height;)
  497. {
  498. Vertex* vertex = (Vertex*)_blitter.m_vb->data;
  499. uint16_t* indices = (uint16_t*)_blitter.m_ib->data;
  500. uint32_t startVertex = 0;
  501. uint32_t numIndices = 0;
  502. for (; yy < _mem.m_height && numIndices < numBatchIndices; ++yy)
  503. {
  504. xx = xx < _mem.m_width ? xx : 0;
  505. const uint8_t* line = &_mem.m_mem[(yy*_mem.m_width+xx)*2];
  506. for (; xx < _mem.m_width && numIndices < numBatchIndices; ++xx)
  507. {
  508. uint8_t ch = line[0];
  509. uint8_t attr = line[1];
  510. if (0 != (ch|attr)
  511. && (' ' != ch || 0 != (attr&0xf0) ) )
  512. {
  513. uint32_t fg = palette[attr&0xf];
  514. uint32_t bg = palette[(attr>>4)&0xf];
  515. Vertex vert[4] =
  516. {
  517. { (xx )*8.0f, (yy )*fontHeight, 0.0f, fg, bg, (ch )*8.0f*texelWidth - texelWidthHalf, utop },
  518. { (xx+1)*8.0f, (yy )*fontHeight, 0.0f, fg, bg, (ch+1)*8.0f*texelWidth - texelWidthHalf, utop },
  519. { (xx+1)*8.0f, (yy+1)*fontHeight, 0.0f, fg, bg, (ch+1)*8.0f*texelWidth - texelWidthHalf, ubottom },
  520. { (xx )*8.0f, (yy+1)*fontHeight, 0.0f, fg, bg, (ch )*8.0f*texelWidth - texelWidthHalf, ubottom },
  521. };
  522. memcpy(vertex, vert, sizeof(vert) );
  523. vertex += 4;
  524. indices[0] = uint16_t(startVertex+0);
  525. indices[1] = uint16_t(startVertex+1);
  526. indices[2] = uint16_t(startVertex+2);
  527. indices[3] = uint16_t(startVertex+2);
  528. indices[4] = uint16_t(startVertex+3);
  529. indices[5] = uint16_t(startVertex+0);
  530. startVertex += 4;
  531. indices += 6;
  532. numIndices += 6;
  533. }
  534. line += 2;
  535. }
  536. if (numIndices >= numBatchIndices)
  537. {
  538. break;
  539. }
  540. }
  541. _renderCtx->blitRender(_blitter, numIndices);
  542. }
  543. }
  544. void ClearQuad::init()
  545. {
  546. BGFX_CHECK_MAIN_THREAD();
  547. if (RendererType::Null != g_caps.rendererType)
  548. {
  549. m_decl
  550. .begin()
  551. .add(Attrib::Position, 3, AttribType::Float)
  552. .end();
  553. ShaderHandle vsh = BGFX_INVALID_HANDLE;
  554. struct Mem
  555. {
  556. Mem(const void* _data, size_t _size)
  557. : data(_data)
  558. , size(_size)
  559. {
  560. }
  561. const void* data;
  562. size_t size;
  563. };
  564. const Memory* fragMem[BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS];
  565. if (RendererType::Direct3D9 == g_caps.rendererType)
  566. {
  567. vsh = createShader(makeRef(vs_clear_dx9, sizeof(vs_clear_dx9) ) );
  568. const Mem mem[] =
  569. {
  570. Mem(fs_clear0_dx9, sizeof(fs_clear0_dx9) ),
  571. Mem(fs_clear1_dx9, sizeof(fs_clear1_dx9) ),
  572. Mem(fs_clear2_dx9, sizeof(fs_clear2_dx9) ),
  573. Mem(fs_clear3_dx9, sizeof(fs_clear3_dx9) ),
  574. Mem(fs_clear4_dx9, sizeof(fs_clear4_dx9) ),
  575. Mem(fs_clear5_dx9, sizeof(fs_clear5_dx9) ),
  576. Mem(fs_clear6_dx9, sizeof(fs_clear6_dx9) ),
  577. Mem(fs_clear7_dx9, sizeof(fs_clear7_dx9) ),
  578. };
  579. for (uint32_t ii = 0, num = g_caps.maxFBAttachments; ii < num; ++ii)
  580. {
  581. fragMem[ii] = makeRef(mem[ii].data, uint32_t(mem[ii].size) );
  582. }
  583. }
  584. else if (RendererType::Direct3D11 == g_caps.rendererType
  585. || RendererType::Direct3D12 == g_caps.rendererType)
  586. {
  587. vsh = createShader(makeRef(vs_clear_dx11, sizeof(vs_clear_dx11) ) );
  588. const Mem mem[] =
  589. {
  590. Mem(fs_clear0_dx11, sizeof(fs_clear0_dx11) ),
  591. Mem(fs_clear1_dx11, sizeof(fs_clear1_dx11) ),
  592. Mem(fs_clear2_dx11, sizeof(fs_clear2_dx11) ),
  593. Mem(fs_clear3_dx11, sizeof(fs_clear3_dx11) ),
  594. Mem(fs_clear4_dx11, sizeof(fs_clear4_dx11) ),
  595. Mem(fs_clear5_dx11, sizeof(fs_clear5_dx11) ),
  596. Mem(fs_clear6_dx11, sizeof(fs_clear6_dx11) ),
  597. Mem(fs_clear7_dx11, sizeof(fs_clear7_dx11) ),
  598. };
  599. for (uint32_t ii = 0, num = g_caps.maxFBAttachments; ii < num; ++ii)
  600. {
  601. fragMem[ii] = makeRef(mem[ii].data, uint32_t(mem[ii].size) );
  602. }
  603. }
  604. else if (RendererType::OpenGLES == g_caps.rendererType
  605. || RendererType::OpenGL == g_caps.rendererType
  606. || RendererType::Vulkan == g_caps.rendererType)
  607. {
  608. vsh = createShader(makeRef(vs_clear_glsl, sizeof(vs_clear_glsl) ) );
  609. const Mem mem[] =
  610. {
  611. Mem(fs_clear0_glsl, sizeof(fs_clear0_glsl) ),
  612. Mem(fs_clear1_glsl, sizeof(fs_clear1_glsl) ),
  613. Mem(fs_clear2_glsl, sizeof(fs_clear2_glsl) ),
  614. Mem(fs_clear3_glsl, sizeof(fs_clear3_glsl) ),
  615. Mem(fs_clear4_glsl, sizeof(fs_clear4_glsl) ),
  616. Mem(fs_clear5_glsl, sizeof(fs_clear5_glsl) ),
  617. Mem(fs_clear6_glsl, sizeof(fs_clear6_glsl) ),
  618. Mem(fs_clear7_glsl, sizeof(fs_clear7_glsl) ),
  619. };
  620. for (uint32_t ii = 0, num = g_caps.maxFBAttachments; ii < num; ++ii)
  621. {
  622. fragMem[ii] = makeRef(mem[ii].data, uint32_t(mem[ii].size) );
  623. }
  624. }
  625. else if (RendererType::Metal == g_caps.rendererType)
  626. {
  627. vsh = createShader(makeRef(vs_clear_mtl, sizeof(vs_clear_mtl) ) );
  628. const Mem mem[] =
  629. {
  630. Mem(fs_clear0_mtl, sizeof(fs_clear0_mtl) ),
  631. Mem(fs_clear1_mtl, sizeof(fs_clear1_mtl) ),
  632. Mem(fs_clear2_mtl, sizeof(fs_clear2_mtl) ),
  633. Mem(fs_clear3_mtl, sizeof(fs_clear3_mtl) ),
  634. Mem(fs_clear4_mtl, sizeof(fs_clear4_mtl) ),
  635. Mem(fs_clear5_mtl, sizeof(fs_clear5_mtl) ),
  636. Mem(fs_clear6_mtl, sizeof(fs_clear6_mtl) ),
  637. Mem(fs_clear7_mtl, sizeof(fs_clear7_mtl) ),
  638. };
  639. for (uint32_t ii = 0, num = g_caps.maxFBAttachments; ii < num; ++ii)
  640. {
  641. fragMem[ii] = makeRef(mem[ii].data, uint32_t(mem[ii].size) );
  642. }
  643. }
  644. else
  645. {
  646. BGFX_FATAL(false, Fatal::UnableToInitialize, "Unknown renderer type %d", g_caps.rendererType);
  647. }
  648. for (uint32_t ii = 0, num = g_caps.maxFBAttachments; ii < num; ++ii)
  649. {
  650. ShaderHandle fsh = createShader(fragMem[ii]);
  651. m_program[ii] = createProgram(vsh, fsh);
  652. BX_CHECK(isValid(m_program[ii]), "Failed to create clear quad program.");
  653. destroyShader(fsh);
  654. }
  655. destroyShader(vsh);
  656. m_vb = s_ctx->createTransientVertexBuffer(4*m_decl.m_stride, &m_decl);
  657. }
  658. }
  659. void ClearQuad::shutdown()
  660. {
  661. BGFX_CHECK_MAIN_THREAD();
  662. if (RendererType::Null != g_caps.rendererType)
  663. {
  664. for (uint32_t ii = 0, num = g_caps.maxFBAttachments; ii < num; ++ii)
  665. {
  666. if (isValid(m_program[ii]) )
  667. {
  668. destroyProgram(m_program[ii]);
  669. m_program[ii].idx = invalidHandle;
  670. }
  671. }
  672. s_ctx->destroyTransientVertexBuffer(m_vb);
  673. }
  674. }
  675. const char* s_uniformTypeName[] =
  676. {
  677. "int1",
  678. NULL,
  679. "vec4",
  680. "mat3",
  681. "mat4",
  682. };
  683. BX_STATIC_ASSERT(UniformType::Count == BX_COUNTOF(s_uniformTypeName) );
  684. const char* getUniformTypeName(UniformType::Enum _enum)
  685. {
  686. BX_CHECK(_enum < UniformType::Count, "%d < UniformType::Count %d", _enum, UniformType::Count);
  687. return s_uniformTypeName[_enum];
  688. }
  689. UniformType::Enum nameToUniformTypeEnum(const char* _name)
  690. {
  691. for (uint32_t ii = 0; ii < UniformType::Count; ++ii)
  692. {
  693. if (NULL != s_uniformTypeName[ii]
  694. && 0 == strcmp(_name, s_uniformTypeName[ii]) )
  695. {
  696. return UniformType::Enum(ii);
  697. }
  698. }
  699. return UniformType::Count;
  700. }
  701. static const char* s_predefinedName[PredefinedUniform::Count] =
  702. {
  703. "u_viewRect",
  704. "u_viewTexel",
  705. "u_view",
  706. "u_invView",
  707. "u_proj",
  708. "u_invProj",
  709. "u_viewProj",
  710. "u_invViewProj",
  711. "u_model",
  712. "u_modelView",
  713. "u_modelViewProj",
  714. "u_alphaRef4",
  715. };
  716. const char* getPredefinedUniformName(PredefinedUniform::Enum _enum)
  717. {
  718. return s_predefinedName[_enum];
  719. }
  720. PredefinedUniform::Enum nameToPredefinedUniformEnum(const char* _name)
  721. {
  722. for (uint32_t ii = 0; ii < PredefinedUniform::Count; ++ii)
  723. {
  724. if (0 == strcmp(_name, s_predefinedName[ii]) )
  725. {
  726. return PredefinedUniform::Enum(ii);
  727. }
  728. }
  729. return PredefinedUniform::Count;
  730. }
  731. uint32_t Frame::submit(uint8_t _id, ProgramHandle _program, OcclusionQueryHandle _occlusionQuery, int32_t _depth, bool _preserveState)
  732. {
  733. if (m_discard)
  734. {
  735. discard();
  736. return m_num;
  737. }
  738. if (BGFX_CONFIG_MAX_DRAW_CALLS-1 <= m_num
  739. || (0 == m_draw.m_numVertices && 0 == m_draw.m_numIndices) )
  740. {
  741. ++m_numDropped;
  742. return m_num;
  743. }
  744. m_uniformEnd = m_uniformBuffer->getPos();
  745. m_key.m_program = invalidHandle == _program.idx
  746. ? 0
  747. : _program.idx
  748. ;
  749. m_key.m_depth = (uint32_t)_depth;
  750. m_key.m_view = _id;
  751. m_key.m_seq = s_ctx->m_seq[_id] & s_ctx->m_seqMask[_id];
  752. s_ctx->m_seq[_id]++;
  753. uint64_t key = m_key.encodeDraw();
  754. m_sortKeys[m_num] = key;
  755. m_sortValues[m_num] = m_numRenderItems;
  756. ++m_num;
  757. m_draw.m_constBegin = m_uniformBegin;
  758. m_draw.m_constEnd = m_uniformEnd;
  759. m_draw.m_stateFlags |= m_stateFlags;
  760. if (isValid(_occlusionQuery) )
  761. {
  762. BX_CHECK(!isValid(m_draw.m_occlusionQuery), "");
  763. m_draw.m_stateFlags |= BGFX_STATE_INTERNAL_OCCLUSION_QUERY;
  764. m_draw.m_occlusionQuery = _occlusionQuery;
  765. }
  766. m_renderItem[m_numRenderItems].draw = m_draw;
  767. ++m_numRenderItems;
  768. if (!_preserveState)
  769. {
  770. m_draw.clear();
  771. m_uniformBegin = m_uniformEnd;
  772. m_stateFlags = BGFX_STATE_NONE;
  773. }
  774. return m_num;
  775. }
  776. uint32_t Frame::dispatch(uint8_t _id, ProgramHandle _handle, uint16_t _numX, uint16_t _numY, uint16_t _numZ, uint8_t _flags)
  777. {
  778. if (m_discard)
  779. {
  780. discard();
  781. return m_num;
  782. }
  783. if (BGFX_CONFIG_MAX_DRAW_CALLS-1 <= m_num)
  784. {
  785. ++m_numDropped;
  786. return m_num;
  787. }
  788. m_uniformEnd = m_uniformBuffer->getPos();
  789. m_compute.m_matrix = m_draw.m_matrix;
  790. m_compute.m_num = m_draw.m_num;
  791. m_compute.m_numX = bx::uint16_max(_numX, 1);
  792. m_compute.m_numY = bx::uint16_max(_numY, 1);
  793. m_compute.m_numZ = bx::uint16_max(_numZ, 1);
  794. m_compute.m_submitFlags = _flags;
  795. m_key.m_program = _handle.idx;
  796. m_key.m_depth = 0;
  797. m_key.m_view = _id;
  798. m_key.m_seq = s_ctx->m_seq[_id];
  799. s_ctx->m_seq[_id]++;
  800. uint64_t key = m_key.encodeCompute();
  801. m_sortKeys[m_num] = key;
  802. m_sortValues[m_num] = m_numRenderItems;
  803. ++m_num;
  804. m_compute.m_constBegin = m_uniformBegin;
  805. m_compute.m_constEnd = m_uniformEnd;
  806. m_renderItem[m_numRenderItems].compute = m_compute;
  807. ++m_numRenderItems;
  808. m_compute.clear();
  809. m_uniformBegin = m_uniformEnd;
  810. return m_num;
  811. }
  812. 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)
  813. {
  814. BX_WARN(m_numBlitItems < BGFX_CONFIG_MAX_BLIT_ITEMS
  815. , "Exceed number of available blit items per frame. BGFX_CONFIG_MAX_BLIT_ITEMS is %d. Skipping blit."
  816. , BGFX_CONFIG_MAX_BLIT_ITEMS
  817. );
  818. if (m_numBlitItems < BGFX_CONFIG_MAX_BLIT_ITEMS)
  819. {
  820. uint16_t item = m_numBlitItems++;
  821. BlitItem& bi = m_blitItem[item];
  822. bi.m_srcX = _srcX;
  823. bi.m_srcY = _srcY;
  824. bi.m_srcZ = _srcZ;
  825. bi.m_dstX = _dstX;
  826. bi.m_dstY = _dstY;
  827. bi.m_dstZ = _dstZ;
  828. bi.m_width = _width;
  829. bi.m_height = _height;
  830. bi.m_depth = _depth;
  831. bi.m_srcMip = _srcMip;
  832. bi.m_dstMip = _dstMip;
  833. bi.m_src = _src;
  834. bi.m_dst = _dst;
  835. BlitKey key;
  836. key.m_view = _id;
  837. key.m_item = item;
  838. m_blitKeys[item] = key.encode();
  839. }
  840. }
  841. void Frame::sort()
  842. {
  843. for (uint32_t ii = 0, num = m_num; ii < num; ++ii)
  844. {
  845. m_sortKeys[ii] = SortKey::remapView(m_sortKeys[ii], m_viewRemap);
  846. }
  847. bx::radixSort(m_sortKeys, s_ctx->m_tempKeys, m_sortValues, s_ctx->m_tempValues, m_num);
  848. for (uint32_t ii = 0, num = m_num; ii < num; ++ii)
  849. {
  850. m_blitKeys[ii] = BlitKey::remapView(m_blitKeys[ii], m_viewRemap);
  851. }
  852. bx::radixSort(m_blitKeys, (uint32_t*)&s_ctx->m_tempKeys, m_numBlitItems);
  853. }
  854. RenderFrame::Enum renderFrame()
  855. {
  856. if (BX_ENABLED(BGFX_CONFIG_MULTITHREADED) )
  857. {
  858. if (NULL == s_ctx)
  859. {
  860. s_renderFrameCalled = true;
  861. s_threadIndex = ~BGFX_MAIN_THREAD_MAGIC;
  862. return RenderFrame::NoContext;
  863. }
  864. BGFX_CHECK_RENDER_THREAD();
  865. if (s_ctx->renderFrame() )
  866. {
  867. Context* ctx = s_ctx;
  868. ctx->gameSemWait();
  869. s_ctx = NULL;
  870. ctx->renderSemPost();
  871. return RenderFrame::Exiting;
  872. }
  873. return RenderFrame::Render;
  874. }
  875. BX_CHECK(false, "This call only makes sense if used with multi-threaded renderer.");
  876. return RenderFrame::NoContext;
  877. }
  878. const uint32_t g_uniformTypeSize[UniformType::Count+1] =
  879. {
  880. sizeof(int32_t),
  881. 0,
  882. 4*sizeof(float),
  883. 3*3*sizeof(float),
  884. 4*4*sizeof(float),
  885. 1,
  886. };
  887. void UniformBuffer::writeUniform(UniformType::Enum _type, uint16_t _loc, const void* _value, uint16_t _num)
  888. {
  889. uint32_t opcode = encodeOpcode(_type, _loc, _num, true);
  890. write(opcode);
  891. write(_value, g_uniformTypeSize[_type]*_num);
  892. }
  893. void UniformBuffer::writeUniformHandle(UniformType::Enum _type, uint16_t _loc, UniformHandle _handle, uint16_t _num)
  894. {
  895. uint32_t opcode = encodeOpcode(_type, _loc, _num, false);
  896. write(opcode);
  897. write(&_handle, sizeof(UniformHandle) );
  898. }
  899. void UniformBuffer::writeMarker(const char* _marker)
  900. {
  901. uint16_t num = (uint16_t)strlen(_marker)+1;
  902. uint32_t opcode = encodeOpcode(bgfx::UniformType::Count, 0, num, true);
  903. write(opcode);
  904. write(_marker, num);
  905. }
  906. struct CapsFlags
  907. {
  908. uint64_t m_flag;
  909. const char* m_str;
  910. };
  911. static const CapsFlags s_capsFlags[] =
  912. {
  913. #define CAPS_FLAGS(_x) { _x, #_x }
  914. CAPS_FLAGS(BGFX_CAPS_TEXTURE_COMPARE_LEQUAL),
  915. CAPS_FLAGS(BGFX_CAPS_TEXTURE_COMPARE_ALL),
  916. CAPS_FLAGS(BGFX_CAPS_TEXTURE_3D),
  917. CAPS_FLAGS(BGFX_CAPS_VERTEX_ATTRIB_HALF),
  918. CAPS_FLAGS(BGFX_CAPS_VERTEX_ATTRIB_UINT10),
  919. CAPS_FLAGS(BGFX_CAPS_INSTANCING),
  920. CAPS_FLAGS(BGFX_CAPS_RENDERER_MULTITHREADED),
  921. CAPS_FLAGS(BGFX_CAPS_FRAGMENT_DEPTH),
  922. CAPS_FLAGS(BGFX_CAPS_BLEND_INDEPENDENT),
  923. CAPS_FLAGS(BGFX_CAPS_COMPUTE),
  924. CAPS_FLAGS(BGFX_CAPS_FRAGMENT_ORDERING),
  925. CAPS_FLAGS(BGFX_CAPS_SWAP_CHAIN),
  926. CAPS_FLAGS(BGFX_CAPS_HMD),
  927. CAPS_FLAGS(BGFX_CAPS_INDEX32),
  928. CAPS_FLAGS(BGFX_CAPS_DRAW_INDIRECT),
  929. CAPS_FLAGS(BGFX_CAPS_HIDPI),
  930. CAPS_FLAGS(BGFX_CAPS_TEXTURE_BLIT),
  931. CAPS_FLAGS(BGFX_CAPS_TEXTURE_READ_BACK),
  932. CAPS_FLAGS(BGFX_CAPS_OCCLUSION_QUERY),
  933. CAPS_FLAGS(BGFX_CAPS_ALPHA_TO_COVERAGE),
  934. CAPS_FLAGS(BGFX_CAPS_CONSERVATIVE_RASTER),
  935. CAPS_FLAGS(BGFX_CAPS_TEXTURE_2D_ARRAY),
  936. CAPS_FLAGS(BGFX_CAPS_TEXTURE_CUBE_ARRAY),
  937. #undef CAPS_FLAGS
  938. };
  939. static void dumpCaps()
  940. {
  941. BX_TRACE("Sort key masks:");
  942. BX_TRACE("\t View %016" PRIx64, SORT_KEY_VIEW_MASK);
  943. BX_TRACE("\t Draw bit %016" PRIx64, SORT_KEY_DRAW_BIT);
  944. BX_TRACE("\t Seq %016" PRIx64, SORT_KEY_SEQ_MASK);
  945. BX_TRACE("\tD Trans %016" PRIx64, SORT_KEY_DRAW_TRANS_MASK);
  946. BX_TRACE("\tD Program %016" PRIx64, SORT_KEY_DRAW_PROGRAM_MASK);
  947. BX_TRACE("\tC Program %016" PRIx64, SORT_KEY_COMPUTE_PROGRAM_MASK);
  948. BX_TRACE("\tD Depth %016" PRIx64, SORT_KEY_DRAW_DEPTH_MASK);
  949. BX_TRACE("Supported capabilities (renderer %s, vendor 0x%04x, device 0x%04x):"
  950. , s_ctx->m_renderCtx->getRendererName()
  951. , g_caps.vendorId
  952. , g_caps.deviceId
  953. );
  954. for (uint32_t ii = 0; ii < BX_COUNTOF(s_capsFlags); ++ii)
  955. {
  956. if (0 != (g_caps.supported & s_capsFlags[ii].m_flag) )
  957. {
  958. BX_TRACE("\t%s", s_capsFlags[ii].m_str);
  959. }
  960. }
  961. BX_TRACE("Supported texture formats:");
  962. BX_TRACE("\t +---------------- 2D: x = supported / * = emulated");
  963. BX_TRACE("\t |+--------------- 2D: sRGB format");
  964. BX_TRACE("\t ||+-------------- 3D: x = supported / * = emulated");
  965. BX_TRACE("\t |||+------------- 3D: sRGB format");
  966. BX_TRACE("\t ||||+------------ Cube: x = supported / * = emulated");
  967. BX_TRACE("\t |||||+----------- Cube: sRGB format");
  968. BX_TRACE("\t ||||||+---------- vertex format");
  969. BX_TRACE("\t |||||||+--------- image");
  970. BX_TRACE("\t ||||||||+-------- framebuffer");
  971. BX_TRACE("\t |||||||||+------- MSAA framebuffer");
  972. BX_TRACE("\t ||||||||||+------ MSAA texture");
  973. BX_TRACE("\t |||||||||||+----- Auto-generated mips");
  974. BX_TRACE("\t |||||||||||| +-- name");
  975. for (uint32_t ii = 0; ii < TextureFormat::Count; ++ii)
  976. {
  977. if (TextureFormat::Unknown != ii
  978. && TextureFormat::UnknownDepth != ii)
  979. {
  980. uint16_t flags = g_caps.formats[ii];
  981. BX_TRACE("\t[%c%c%c%c%c%c%c%c%c%c%c%c] %s"
  982. , flags&BGFX_CAPS_FORMAT_TEXTURE_2D ? 'x' : flags&BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED ? '*' : ' '
  983. , flags&BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB ? 'l' : ' '
  984. , flags&BGFX_CAPS_FORMAT_TEXTURE_3D ? 'x' : flags&BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED ? '*' : ' '
  985. , flags&BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB ? 'l' : ' '
  986. , flags&BGFX_CAPS_FORMAT_TEXTURE_CUBE ? 'x' : flags&BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED ? '*' : ' '
  987. , flags&BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB ? 'l' : ' '
  988. , flags&BGFX_CAPS_FORMAT_TEXTURE_VERTEX ? 'v' : ' '
  989. , flags&BGFX_CAPS_FORMAT_TEXTURE_IMAGE ? 'i' : ' '
  990. , flags&BGFX_CAPS_FORMAT_TEXTURE_FRAMEBUFFER ? 'f' : ' '
  991. , flags&BGFX_CAPS_FORMAT_TEXTURE_FRAMEBUFFER_MSAA ? '+' : ' '
  992. , flags&BGFX_CAPS_FORMAT_TEXTURE_MSAA ? 'm' : ' '
  993. , flags&BGFX_CAPS_FORMAT_TEXTURE_MIP_AUTOGEN ? 'M' : ' '
  994. , getName(TextureFormat::Enum(ii) )
  995. );
  996. BX_UNUSED(flags);
  997. }
  998. }
  999. BX_TRACE("Max FB attachments: %d", g_caps.maxFBAttachments);
  1000. BX_TRACE("NDC depth [%d, 1], origin %s left."
  1001. , g_caps.homogeneousDepth ? -1 : 0
  1002. , g_caps.originBottomLeft ? "bottom" : "top"
  1003. );
  1004. }
  1005. TextureFormat::Enum getViableTextureFormat(const ImageContainer& _imageContainer)
  1006. {
  1007. const uint32_t formatCaps = g_caps.formats[_imageContainer.m_format];
  1008. bool convert = 0 == formatCaps;
  1009. if (_imageContainer.m_cubeMap)
  1010. {
  1011. convert |= 0 == (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_CUBE)
  1012. && 0 != (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED)
  1013. ;
  1014. }
  1015. else if (_imageContainer.m_depth > 1)
  1016. {
  1017. convert |= 0 == (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_3D)
  1018. && 0 != (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED)
  1019. ;
  1020. }
  1021. else
  1022. {
  1023. convert |= 0 == (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_2D)
  1024. && 0 != (formatCaps & BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED)
  1025. ;
  1026. }
  1027. if (convert)
  1028. {
  1029. return TextureFormat::BGRA8;
  1030. }
  1031. return _imageContainer.m_format;
  1032. }
  1033. static TextureFormat::Enum s_emulatedFormats[] =
  1034. {
  1035. TextureFormat::BC1,
  1036. TextureFormat::BC2,
  1037. TextureFormat::BC3,
  1038. TextureFormat::BC4,
  1039. TextureFormat::BC5,
  1040. TextureFormat::ETC1,
  1041. TextureFormat::ETC2,
  1042. TextureFormat::ETC2A,
  1043. TextureFormat::ETC2A1,
  1044. TextureFormat::PTC14,
  1045. TextureFormat::PTC14A,
  1046. TextureFormat::BGRA8, // GL doesn't support BGRA8 without extensions.
  1047. TextureFormat::RGBA8, // D3D9 doesn't support RGBA8
  1048. };
  1049. bool Context::init(RendererType::Enum _type)
  1050. {
  1051. BX_CHECK(!m_rendererInitialized, "Already initialized?");
  1052. m_exit = false;
  1053. m_frames = 0;
  1054. m_debug = BGFX_DEBUG_NONE;
  1055. m_submit->create();
  1056. #if BGFX_CONFIG_MULTITHREADED
  1057. m_render->create();
  1058. if (s_renderFrameCalled)
  1059. {
  1060. // When bgfx::renderFrame is called before init render thread
  1061. // should not be created.
  1062. BX_TRACE("Application called bgfx::renderFrame directly, not creating render thread.");
  1063. m_singleThreaded = true
  1064. && ~BGFX_MAIN_THREAD_MAGIC == s_threadIndex
  1065. ;
  1066. }
  1067. else
  1068. {
  1069. BX_TRACE("Creating rendering thread.");
  1070. m_thread.init(renderThread, this, 0, "bgfx - renderer backend thread");
  1071. m_singleThreaded = false;
  1072. }
  1073. #else
  1074. BX_TRACE("Multithreaded renderer is disabled.");
  1075. m_singleThreaded = true;
  1076. #endif // BGFX_CONFIG_MULTITHREADED
  1077. BX_TRACE("Running in %s-threaded mode", m_singleThreaded ? "single" : "multi");
  1078. s_threadIndex = BGFX_MAIN_THREAD_MAGIC;
  1079. for (uint32_t ii = 0; ii < BX_COUNTOF(m_viewRemap); ++ii)
  1080. {
  1081. m_viewRemap[ii] = uint8_t(ii);
  1082. }
  1083. for (uint32_t ii = 0; ii < BGFX_CONFIG_MAX_VIEWS; ++ii)
  1084. {
  1085. resetView(uint8_t(ii) );
  1086. }
  1087. for (uint32_t ii = 0; ii < BX_COUNTOF(m_clearColor); ++ii)
  1088. {
  1089. m_clearColor[ii][0] = 0.0f;
  1090. m_clearColor[ii][1] = 0.0f;
  1091. m_clearColor[ii][2] = 0.0f;
  1092. m_clearColor[ii][3] = 1.0f;
  1093. }
  1094. m_declRef.init();
  1095. CommandBuffer& cmdbuf = getCommandBuffer(CommandBuffer::RendererInit);
  1096. cmdbuf.write(_type);
  1097. frameNoRenderWait();
  1098. // Make sure renderer init is called from render thread.
  1099. // g_caps is initialized and available after this point.
  1100. frame();
  1101. if (!m_rendererInitialized)
  1102. {
  1103. getCommandBuffer(CommandBuffer::RendererShutdownEnd);
  1104. frame();
  1105. frame();
  1106. m_declRef.shutdown(m_vertexDeclHandle);
  1107. m_submit->destroy();
  1108. #if BGFX_CONFIG_MULTITHREADED
  1109. m_render->destroy();
  1110. #endif // BGFX_CONFIG_MULTITHREADED
  1111. return false;
  1112. }
  1113. for (uint32_t ii = 0; ii < BX_COUNTOF(s_emulatedFormats); ++ii)
  1114. {
  1115. const uint32_t fmt = s_emulatedFormats[ii];
  1116. g_caps.formats[fmt] |= 0 == (g_caps.formats[fmt] & BGFX_CAPS_FORMAT_TEXTURE_2D ) ? BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED : 0;
  1117. g_caps.formats[fmt] |= 0 == (g_caps.formats[fmt] & BGFX_CAPS_FORMAT_TEXTURE_3D ) ? BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED : 0;
  1118. g_caps.formats[fmt] |= 0 == (g_caps.formats[fmt] & BGFX_CAPS_FORMAT_TEXTURE_CUBE) ? BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED : 0;
  1119. }
  1120. for (uint32_t ii = 0; ii < TextureFormat::Count; ++ii)
  1121. {
  1122. bool convertable = imageConvert(TextureFormat::BGRA8, TextureFormat::Enum(ii) );
  1123. g_caps.formats[ii] |= 0 == (g_caps.formats[ii] & BGFX_CAPS_FORMAT_TEXTURE_2D ) && convertable ? BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED : 0;
  1124. g_caps.formats[ii] |= 0 == (g_caps.formats[ii] & BGFX_CAPS_FORMAT_TEXTURE_3D ) && convertable ? BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED : 0;
  1125. g_caps.formats[ii] |= 0 == (g_caps.formats[ii] & BGFX_CAPS_FORMAT_TEXTURE_CUBE) && convertable ? BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED : 0;
  1126. }
  1127. g_caps.rendererType = m_renderCtx->getRendererType();
  1128. initAttribTypeSizeTable(g_caps.rendererType);
  1129. g_caps.supported |= 0
  1130. | (BX_ENABLED(BGFX_CONFIG_MULTITHREADED) && !m_singleThreaded ? BGFX_CAPS_RENDERER_MULTITHREADED : 0)
  1131. ;
  1132. dumpCaps();
  1133. m_textVideoMemBlitter.init();
  1134. m_clearQuad.init();
  1135. m_submit->m_transientVb = createTransientVertexBuffer(BGFX_CONFIG_TRANSIENT_VERTEX_BUFFER_SIZE);
  1136. m_submit->m_transientIb = createTransientIndexBuffer(BGFX_CONFIG_TRANSIENT_INDEX_BUFFER_SIZE);
  1137. frame();
  1138. if (BX_ENABLED(BGFX_CONFIG_MULTITHREADED) )
  1139. {
  1140. m_submit->m_transientVb = createTransientVertexBuffer(BGFX_CONFIG_TRANSIENT_VERTEX_BUFFER_SIZE);
  1141. m_submit->m_transientIb = createTransientIndexBuffer(BGFX_CONFIG_TRANSIENT_INDEX_BUFFER_SIZE);
  1142. frame();
  1143. }
  1144. g_internalData.caps = getCaps();
  1145. return true;
  1146. }
  1147. void Context::shutdown()
  1148. {
  1149. getCommandBuffer(CommandBuffer::RendererShutdownBegin);
  1150. frame();
  1151. destroyTransientVertexBuffer(m_submit->m_transientVb);
  1152. destroyTransientIndexBuffer(m_submit->m_transientIb);
  1153. m_textVideoMemBlitter.shutdown();
  1154. m_clearQuad.shutdown();
  1155. frame();
  1156. if (BX_ENABLED(BGFX_CONFIG_MULTITHREADED) )
  1157. {
  1158. destroyTransientVertexBuffer(m_submit->m_transientVb);
  1159. destroyTransientIndexBuffer(m_submit->m_transientIb);
  1160. frame();
  1161. }
  1162. frame(); // If any VertexDecls needs to be destroyed.
  1163. getCommandBuffer(CommandBuffer::RendererShutdownEnd);
  1164. frame();
  1165. m_dynVertexBufferAllocator.compact();
  1166. m_dynIndexBufferAllocator.compact();
  1167. BX_CHECK(m_vertexDeclHandle.getNumHandles() == m_declRef.m_vertexDeclMap.getNumElements()
  1168. , "VertexDeclRef mismatch, num handles %d, handles in hash map %d."
  1169. , m_vertexDeclHandle.getNumHandles()
  1170. , m_declRef.m_vertexDeclMap.getNumElements()
  1171. );
  1172. m_declRef.shutdown(m_vertexDeclHandle);
  1173. #if BGFX_CONFIG_MULTITHREADED
  1174. // Render thread shutdown sequence.
  1175. renderSemWait(); // Wait for previous frame.
  1176. gameSemPost(); // OK to set context to NULL.
  1177. // s_ctx is NULL here.
  1178. renderSemWait(); // In RenderFrame::Exiting state.
  1179. if (m_thread.isRunning() )
  1180. {
  1181. m_thread.shutdown();
  1182. }
  1183. m_render->destroy();
  1184. #endif // BGFX_CONFIG_MULTITHREADED
  1185. memset(&g_internalData, 0, sizeof(InternalData) );
  1186. s_ctx = NULL;
  1187. m_submit->destroy();
  1188. if (BX_ENABLED(BGFX_CONFIG_DEBUG) )
  1189. {
  1190. #define CHECK_HANDLE_LEAK(_handleAlloc) \
  1191. BX_MACRO_BLOCK_BEGIN \
  1192. BX_WARN(0 == _handleAlloc.getNumHandles() \
  1193. , "LEAK: " #_handleAlloc " %d (max: %d)" \
  1194. , _handleAlloc.getNumHandles() \
  1195. , _handleAlloc.getMaxHandles() \
  1196. ); \
  1197. BX_MACRO_BLOCK_END
  1198. CHECK_HANDLE_LEAK(m_dynamicIndexBufferHandle);
  1199. CHECK_HANDLE_LEAK(m_dynamicVertexBufferHandle);
  1200. CHECK_HANDLE_LEAK(m_indexBufferHandle);
  1201. CHECK_HANDLE_LEAK(m_vertexDeclHandle);
  1202. CHECK_HANDLE_LEAK(m_vertexBufferHandle);
  1203. CHECK_HANDLE_LEAK(m_shaderHandle);
  1204. CHECK_HANDLE_LEAK(m_programHandle);
  1205. CHECK_HANDLE_LEAK(m_textureHandle);
  1206. CHECK_HANDLE_LEAK(m_frameBufferHandle);
  1207. CHECK_HANDLE_LEAK(m_uniformHandle);
  1208. CHECK_HANDLE_LEAK(m_occlusionQueryHandle);
  1209. #undef CHECK_HANDLE_LEAK
  1210. }
  1211. }
  1212. void Context::freeDynamicBuffers()
  1213. {
  1214. for (uint16_t ii = 0, num = m_numFreeDynamicIndexBufferHandles; ii < num; ++ii)
  1215. {
  1216. destroyDynamicIndexBufferInternal(m_freeDynamicIndexBufferHandle[ii]);
  1217. }
  1218. m_numFreeDynamicIndexBufferHandles = 0;
  1219. for (uint16_t ii = 0, num = m_numFreeDynamicVertexBufferHandles; ii < num; ++ii)
  1220. {
  1221. destroyDynamicVertexBufferInternal(m_freeDynamicVertexBufferHandle[ii]);
  1222. }
  1223. m_numFreeDynamicVertexBufferHandles = 0;
  1224. }
  1225. void Context::freeAllHandles(Frame* _frame)
  1226. {
  1227. for (uint16_t ii = 0, num = _frame->m_numFreeIndexBufferHandles; ii < num; ++ii)
  1228. {
  1229. m_indexBufferHandle.free(_frame->m_freeIndexBufferHandle[ii].idx);
  1230. }
  1231. for (uint16_t ii = 0, num = _frame->m_numFreeVertexBufferHandles; ii < num; ++ii)
  1232. {
  1233. destroyVertexBufferInternal(_frame->m_freeVertexBufferHandle[ii]);
  1234. }
  1235. for (uint16_t ii = 0, num = _frame->m_numFreeVertexDeclHandles; ii < num; ++ii)
  1236. {
  1237. m_vertexDeclHandle.free(_frame->m_freeVertexDeclHandle[ii].idx);
  1238. }
  1239. for (uint16_t ii = 0, num = _frame->m_numFreeShaderHandles; ii < num; ++ii)
  1240. {
  1241. m_shaderHandle.free(_frame->m_freeShaderHandle[ii].idx);
  1242. }
  1243. for (uint16_t ii = 0, num = _frame->m_numFreeProgramHandles; ii < num; ++ii)
  1244. {
  1245. m_programHandle.free(_frame->m_freeProgramHandle[ii].idx);
  1246. }
  1247. for (uint16_t ii = 0, num = _frame->m_numFreeTextureHandles; ii < num; ++ii)
  1248. {
  1249. m_textureHandle.free(_frame->m_freeTextureHandle[ii].idx);
  1250. }
  1251. for (uint16_t ii = 0, num = _frame->m_numFreeFrameBufferHandles; ii < num; ++ii)
  1252. {
  1253. m_frameBufferHandle.free(_frame->m_freeFrameBufferHandle[ii].idx);
  1254. }
  1255. for (uint16_t ii = 0, num = _frame->m_numFreeUniformHandles; ii < num; ++ii)
  1256. {
  1257. m_uniformHandle.free(_frame->m_freeUniformHandle[ii].idx);
  1258. }
  1259. }
  1260. uint32_t Context::frame(bool _capture)
  1261. {
  1262. BX_CHECK(0 == m_instBufferCount, "Instance buffer allocated, but not used. This is incorrect, and causes memory leak.");
  1263. if (BX_ENABLED(BGFX_CONFIG_DEBUG_OCCLUSION) )
  1264. {
  1265. m_occlusionQuerySet.clear();
  1266. }
  1267. m_submit->m_capture = _capture;
  1268. BGFX_PROFILER_SCOPE(bgfx, main_thread_frame, 0xff2040ff);
  1269. // wait for render thread to finish
  1270. renderSemWait();
  1271. frameNoRenderWait();
  1272. return m_frames;
  1273. }
  1274. void Context::frameNoRenderWait()
  1275. {
  1276. swap();
  1277. // release render thread
  1278. gameSemPost();
  1279. }
  1280. void Context::swap()
  1281. {
  1282. freeDynamicBuffers();
  1283. m_submit->m_resolution = m_resolution;
  1284. m_resolution.m_flags &= ~BGFX_RESET_INTERNAL_FORCE;
  1285. m_submit->m_debug = m_debug;
  1286. memcpy(m_submit->m_viewRemap, m_viewRemap, sizeof(m_viewRemap) );
  1287. memcpy(m_submit->m_fb, m_fb, sizeof(m_fb) );
  1288. memcpy(m_submit->m_clear, m_clear, sizeof(m_clear) );
  1289. memcpy(m_submit->m_rect, m_rect, sizeof(m_rect) );
  1290. memcpy(m_submit->m_scissor, m_scissor, sizeof(m_scissor) );
  1291. memcpy(m_submit->m_view, m_view, sizeof(m_view) );
  1292. memcpy(m_submit->m_proj, m_proj, sizeof(m_proj) );
  1293. memcpy(m_submit->m_viewFlags, m_viewFlags, sizeof(m_viewFlags) );
  1294. if (m_colorPaletteDirty > 0)
  1295. {
  1296. --m_colorPaletteDirty;
  1297. memcpy(m_submit->m_colorPalette, m_clearColor, sizeof(m_clearColor) );
  1298. }
  1299. m_submit->finish();
  1300. bx::xchg(m_render, m_submit);
  1301. memcpy(m_render->m_occlusion, m_submit->m_occlusion, sizeof(m_submit->m_occlusion) );
  1302. if (!BX_ENABLED(BGFX_CONFIG_MULTITHREADED)
  1303. || m_singleThreaded)
  1304. {
  1305. renderFrame();
  1306. }
  1307. m_frames++;
  1308. m_submit->start();
  1309. memset(m_seq, 0, sizeof(m_seq) );
  1310. freeAllHandles(m_submit);
  1311. m_submit->resetFreeHandles();
  1312. m_submit->m_textVideoMem->resize(m_render->m_textVideoMem->m_small
  1313. , m_resolution.m_width
  1314. , m_resolution.m_height
  1315. );
  1316. }
  1317. const char* Context::getName(UniformHandle _handle) const
  1318. {
  1319. return m_uniformRef[_handle.idx].m_name.getPtr();
  1320. }
  1321. bool Context::renderFrame()
  1322. {
  1323. BGFX_PROFILER_SCOPE(bgfx, render_frame, 0xff2040ff);
  1324. if (m_rendererInitialized
  1325. && !m_flipAfterRender)
  1326. {
  1327. m_renderCtx->flip(m_render->m_hmd);
  1328. }
  1329. gameSemWait();
  1330. rendererExecCommands(m_render->m_cmdPre);
  1331. if (m_rendererInitialized)
  1332. {
  1333. BGFX_PROFILER_SCOPE(bgfx, render_submit, 0xff2040ff);
  1334. m_renderCtx->submit(m_render, m_clearQuad, m_textVideoMemBlitter);
  1335. }
  1336. rendererExecCommands(m_render->m_cmdPost);
  1337. renderSemPost();
  1338. if (m_rendererInitialized
  1339. && m_flipAfterRender)
  1340. {
  1341. m_renderCtx->flip(m_render->m_hmd);
  1342. }
  1343. return m_exit;
  1344. }
  1345. void rendererUpdateUniforms(RendererContextI* _renderCtx, UniformBuffer* _uniformBuffer, uint32_t _begin, uint32_t _end)
  1346. {
  1347. _uniformBuffer->reset(_begin);
  1348. while (_uniformBuffer->getPos() < _end)
  1349. {
  1350. uint32_t opcode = _uniformBuffer->read();
  1351. if (UniformType::End == opcode)
  1352. {
  1353. break;
  1354. }
  1355. UniformType::Enum type;
  1356. uint16_t loc;
  1357. uint16_t num;
  1358. uint16_t copy;
  1359. UniformBuffer::decodeOpcode(opcode, type, loc, num, copy);
  1360. uint32_t size = g_uniformTypeSize[type]*num;
  1361. const char* data = _uniformBuffer->read(size);
  1362. if (UniformType::Count > type)
  1363. {
  1364. if (copy)
  1365. {
  1366. _renderCtx->updateUniform(loc, data, size);
  1367. }
  1368. else
  1369. {
  1370. _renderCtx->updateUniform(loc, *(const char**)(data), size);
  1371. }
  1372. }
  1373. else
  1374. {
  1375. _renderCtx->setMarker(data, size);
  1376. }
  1377. }
  1378. }
  1379. void Context::flushTextureUpdateBatch(CommandBuffer& _cmdbuf)
  1380. {
  1381. if (m_textureUpdateBatch.sort() )
  1382. {
  1383. const uint32_t pos = _cmdbuf.m_pos;
  1384. uint32_t currentKey = UINT32_MAX;
  1385. for (uint32_t ii = 0, num = m_textureUpdateBatch.m_num; ii < num; ++ii)
  1386. {
  1387. _cmdbuf.m_pos = m_textureUpdateBatch.m_values[ii];
  1388. TextureHandle handle;
  1389. _cmdbuf.read(handle);
  1390. uint8_t side;
  1391. _cmdbuf.read(side);
  1392. uint8_t mip;
  1393. _cmdbuf.read(mip);
  1394. Rect rect;
  1395. _cmdbuf.read(rect);
  1396. uint16_t zz;
  1397. _cmdbuf.read(zz);
  1398. uint16_t depth;
  1399. _cmdbuf.read(depth);
  1400. uint16_t pitch;
  1401. _cmdbuf.read(pitch);
  1402. Memory* mem;
  1403. _cmdbuf.read(mem);
  1404. uint32_t key = m_textureUpdateBatch.m_keys[ii];
  1405. if (key != currentKey)
  1406. {
  1407. if (currentKey != UINT32_MAX)
  1408. {
  1409. m_renderCtx->updateTextureEnd();
  1410. }
  1411. currentKey = key;
  1412. m_renderCtx->updateTextureBegin(handle, side, mip);
  1413. }
  1414. m_renderCtx->updateTexture(handle, side, mip, rect, zz, depth, pitch, mem);
  1415. release(mem);
  1416. }
  1417. if (currentKey != UINT32_MAX)
  1418. {
  1419. m_renderCtx->updateTextureEnd();
  1420. }
  1421. m_textureUpdateBatch.reset();
  1422. _cmdbuf.m_pos = pos;
  1423. }
  1424. }
  1425. typedef RendererContextI* (*RendererCreateFn)();
  1426. typedef void (*RendererDestroyFn)();
  1427. #define BGFX_RENDERER_CONTEXT(_namespace) \
  1428. namespace _namespace \
  1429. { \
  1430. extern RendererContextI* rendererCreate(); \
  1431. extern void rendererDestroy(); \
  1432. }
  1433. BGFX_RENDERER_CONTEXT(noop);
  1434. BGFX_RENDERER_CONTEXT(d3d9);
  1435. BGFX_RENDERER_CONTEXT(d3d11);
  1436. BGFX_RENDERER_CONTEXT(d3d12);
  1437. BGFX_RENDERER_CONTEXT(mtl);
  1438. BGFX_RENDERER_CONTEXT(gl);
  1439. BGFX_RENDERER_CONTEXT(vk);
  1440. #undef BGFX_RENDERER_CONTEXT
  1441. struct RendererCreator
  1442. {
  1443. RendererCreateFn createFn;
  1444. RendererDestroyFn destroyFn;
  1445. const char* name;
  1446. bool supported;
  1447. };
  1448. static RendererCreator s_rendererCreator[] =
  1449. {
  1450. { noop::rendererCreate, noop::rendererDestroy, BGFX_RENDERER_NULL_NAME, !!BGFX_CONFIG_RENDERER_NULL }, // Noop
  1451. { d3d9::rendererCreate, d3d9::rendererDestroy, BGFX_RENDERER_DIRECT3D9_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D9 }, // Direct3D9
  1452. { d3d11::rendererCreate, d3d11::rendererDestroy, BGFX_RENDERER_DIRECT3D11_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D11 }, // Direct3D11
  1453. { d3d12::rendererCreate, d3d12::rendererDestroy, BGFX_RENDERER_DIRECT3D12_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D12 }, // Direct3D12
  1454. #if BX_PLATFORM_OSX || BX_PLATFORM_IOS
  1455. { mtl::rendererCreate, mtl::rendererDestroy, BGFX_RENDERER_METAL_NAME, !!BGFX_CONFIG_RENDERER_METAL }, // Metal
  1456. #else
  1457. { noop::rendererCreate, noop::rendererDestroy, BGFX_RENDERER_NULL_NAME, !!BGFX_CONFIG_RENDERER_NULL }, // Noop
  1458. #endif // BX_PLATFORM_OSX || BX_PLATFORM_IOS
  1459. { gl::rendererCreate, gl::rendererDestroy, BGFX_RENDERER_OPENGL_NAME, !!BGFX_CONFIG_RENDERER_OPENGLES }, // OpenGLES
  1460. { gl::rendererCreate, gl::rendererDestroy, BGFX_RENDERER_OPENGL_NAME, !!BGFX_CONFIG_RENDERER_OPENGL }, // OpenGL
  1461. { vk::rendererCreate, vk::rendererDestroy, BGFX_RENDERER_VULKAN_NAME, !!BGFX_CONFIG_RENDERER_VULKAN }, // Vulkan
  1462. };
  1463. BX_STATIC_ASSERT(BX_COUNTOF(s_rendererCreator) == RendererType::Count);
  1464. static RendererDestroyFn s_rendererDestroyFn;
  1465. struct Condition
  1466. {
  1467. enum Enum
  1468. {
  1469. LessEqual,
  1470. GreaterEqual,
  1471. };
  1472. };
  1473. bool windowsVersionIs(Condition::Enum _op, uint32_t _version)
  1474. {
  1475. #if BX_PLATFORM_WINDOWS
  1476. static const uint8_t s_condition[] =
  1477. {
  1478. VER_LESS_EQUAL,
  1479. VER_GREATER_EQUAL,
  1480. };
  1481. OSVERSIONINFOEXA ovi;
  1482. memset(&ovi, 0, sizeof(ovi) );
  1483. ovi.dwOSVersionInfoSize = sizeof(ovi);
  1484. // _WIN32_WINNT_WINBLUE 0x0603
  1485. // _WIN32_WINNT_WIN8 0x0602
  1486. // _WIN32_WINNT_WIN7 0x0601
  1487. // _WIN32_WINNT_VISTA 0x0600
  1488. ovi.dwMajorVersion = HIBYTE(_version);
  1489. ovi.dwMinorVersion = LOBYTE(_version);
  1490. DWORDLONG cond = 0;
  1491. VER_SET_CONDITION(cond, VER_MAJORVERSION, s_condition[_op]);
  1492. VER_SET_CONDITION(cond, VER_MINORVERSION, s_condition[_op]);
  1493. return !!VerifyVersionInfoA(&ovi, VER_MAJORVERSION | VER_MINORVERSION, cond);
  1494. #else
  1495. BX_UNUSED(_op, _version);
  1496. return false;
  1497. #endif // BX_PLATFORM_WINDOWS
  1498. }
  1499. static int32_t compareDescending(const void* _lhs, const void* _rhs)
  1500. {
  1501. return *(const int32_t*)_rhs - *(const int32_t*)_lhs;
  1502. }
  1503. RendererContextI* rendererCreate(RendererType::Enum _type)
  1504. {
  1505. int32_t scores[RendererType::Count];
  1506. uint32_t numScores = 0;
  1507. for (uint32_t ii = 0; ii < RendererType::Count; ++ii)
  1508. {
  1509. RendererType::Enum renderer = RendererType::Enum(ii);
  1510. if (s_rendererCreator[ii].supported)
  1511. {
  1512. int32_t score = 0;
  1513. if (_type == renderer)
  1514. {
  1515. score += 1000;
  1516. }
  1517. score += RendererType::Null != renderer ? 1 : 0;
  1518. if (BX_ENABLED(BX_PLATFORM_WINDOWS) )
  1519. {
  1520. if (windowsVersionIs(Condition::GreaterEqual, 0x0602) )
  1521. {
  1522. score += RendererType::Direct3D11 == renderer ? 20 : 0;
  1523. score += RendererType::Direct3D12 == renderer ? 10 : 0;
  1524. }
  1525. else if (windowsVersionIs(Condition::GreaterEqual, 0x0601) )
  1526. {
  1527. score += RendererType::Direct3D11 == renderer ? 20 : 0;
  1528. score += RendererType::Direct3D9 == renderer ? 10 : 0;
  1529. score += RendererType::Direct3D12 == renderer ? -100 : 0;
  1530. }
  1531. else
  1532. {
  1533. score += RendererType::Direct3D12 == renderer ? -100 : 0;
  1534. }
  1535. }
  1536. else if (BX_ENABLED(0
  1537. || BX_PLATFORM_ANDROID
  1538. || BX_PLATFORM_EMSCRIPTEN
  1539. || BX_PLATFORM_IOS
  1540. || BX_PLATFORM_NACL
  1541. || BX_PLATFORM_RPI
  1542. ) )
  1543. {
  1544. score += RendererType::OpenGLES == renderer ? 20 : 0;
  1545. }
  1546. else if (BX_ENABLED(0
  1547. || BX_PLATFORM_XBOXONE
  1548. || BX_PLATFORM_WINRT
  1549. ) )
  1550. {
  1551. score += RendererType::Direct3D11 == renderer ? 20 : 0;
  1552. }
  1553. scores[numScores++] = (score<<8) | uint8_t(renderer);
  1554. }
  1555. }
  1556. qsort(scores, numScores, sizeof(int32_t), compareDescending);
  1557. RendererContextI* renderCtx = NULL;
  1558. for (uint32_t ii = 0; ii < numScores; ++ii)
  1559. {
  1560. RendererType::Enum renderer = RendererType::Enum(scores[ii] & 0xff);
  1561. renderCtx = s_rendererCreator[renderer].createFn();
  1562. if (NULL != renderCtx)
  1563. {
  1564. s_rendererDestroyFn = s_rendererCreator[renderer].destroyFn;
  1565. break;
  1566. }
  1567. s_rendererCreator[renderer].supported = false;
  1568. }
  1569. return renderCtx;
  1570. }
  1571. void rendererDestroy()
  1572. {
  1573. s_rendererDestroyFn();
  1574. }
  1575. void Context::rendererExecCommands(CommandBuffer& _cmdbuf)
  1576. {
  1577. _cmdbuf.reset();
  1578. bool end = false;
  1579. if (NULL == m_renderCtx)
  1580. {
  1581. uint8_t command;
  1582. _cmdbuf.read(command);
  1583. switch (command)
  1584. {
  1585. case CommandBuffer::RendererShutdownEnd:
  1586. m_exit = true;
  1587. return;
  1588. case CommandBuffer::End:
  1589. return;
  1590. default:
  1591. {
  1592. BX_CHECK(CommandBuffer::RendererInit == command
  1593. , "RendererInit must be the first command in command buffer before initialization. Unexpected command %d?"
  1594. , command
  1595. );
  1596. BX_CHECK(!m_rendererInitialized, "This shouldn't happen! Bad synchronization?");
  1597. RendererType::Enum type;
  1598. _cmdbuf.read(type);
  1599. m_renderCtx = rendererCreate(type);
  1600. m_rendererInitialized = NULL != m_renderCtx;
  1601. if (!m_rendererInitialized)
  1602. {
  1603. _cmdbuf.read(command);
  1604. BX_CHECK(CommandBuffer::End == command, "Unexpected command %d?"
  1605. , command
  1606. );
  1607. return;
  1608. }
  1609. }
  1610. break;
  1611. }
  1612. }
  1613. do
  1614. {
  1615. uint8_t command;
  1616. _cmdbuf.read(command);
  1617. switch (command)
  1618. {
  1619. case CommandBuffer::RendererShutdownBegin:
  1620. {
  1621. BX_CHECK(m_rendererInitialized, "This shouldn't happen! Bad synchronization?");
  1622. m_rendererInitialized = false;
  1623. }
  1624. break;
  1625. case CommandBuffer::RendererShutdownEnd:
  1626. {
  1627. BX_CHECK(!m_rendererInitialized && !m_exit, "This shouldn't happen! Bad synchronization?");
  1628. rendererDestroy();
  1629. m_renderCtx = NULL;
  1630. m_exit = true;
  1631. }
  1632. // fall through
  1633. case CommandBuffer::End:
  1634. end = true;
  1635. break;
  1636. case CommandBuffer::CreateIndexBuffer:
  1637. {
  1638. IndexBufferHandle handle;
  1639. _cmdbuf.read(handle);
  1640. Memory* mem;
  1641. _cmdbuf.read(mem);
  1642. uint16_t flags;
  1643. _cmdbuf.read(flags);
  1644. m_renderCtx->createIndexBuffer(handle, mem, flags);
  1645. release(mem);
  1646. }
  1647. break;
  1648. case CommandBuffer::DestroyIndexBuffer:
  1649. {
  1650. IndexBufferHandle handle;
  1651. _cmdbuf.read(handle);
  1652. m_renderCtx->destroyIndexBuffer(handle);
  1653. }
  1654. break;
  1655. case CommandBuffer::CreateVertexDecl:
  1656. {
  1657. VertexDeclHandle handle;
  1658. _cmdbuf.read(handle);
  1659. VertexDecl decl;
  1660. _cmdbuf.read(decl);
  1661. m_renderCtx->createVertexDecl(handle, decl);
  1662. }
  1663. break;
  1664. case CommandBuffer::DestroyVertexDecl:
  1665. {
  1666. VertexDeclHandle handle;
  1667. _cmdbuf.read(handle);
  1668. m_renderCtx->destroyVertexDecl(handle);
  1669. }
  1670. break;
  1671. case CommandBuffer::CreateVertexBuffer:
  1672. {
  1673. VertexBufferHandle handle;
  1674. _cmdbuf.read(handle);
  1675. Memory* mem;
  1676. _cmdbuf.read(mem);
  1677. VertexDeclHandle declHandle;
  1678. _cmdbuf.read(declHandle);
  1679. uint16_t flags;
  1680. _cmdbuf.read(flags);
  1681. m_renderCtx->createVertexBuffer(handle, mem, declHandle, flags);
  1682. release(mem);
  1683. }
  1684. break;
  1685. case CommandBuffer::DestroyVertexBuffer:
  1686. {
  1687. VertexBufferHandle handle;
  1688. _cmdbuf.read(handle);
  1689. m_renderCtx->destroyVertexBuffer(handle);
  1690. }
  1691. break;
  1692. case CommandBuffer::CreateDynamicIndexBuffer:
  1693. {
  1694. IndexBufferHandle handle;
  1695. _cmdbuf.read(handle);
  1696. uint32_t size;
  1697. _cmdbuf.read(size);
  1698. uint16_t flags;
  1699. _cmdbuf.read(flags);
  1700. m_renderCtx->createDynamicIndexBuffer(handle, size, flags);
  1701. }
  1702. break;
  1703. case CommandBuffer::UpdateDynamicIndexBuffer:
  1704. {
  1705. IndexBufferHandle handle;
  1706. _cmdbuf.read(handle);
  1707. uint32_t offset;
  1708. _cmdbuf.read(offset);
  1709. uint32_t size;
  1710. _cmdbuf.read(size);
  1711. Memory* mem;
  1712. _cmdbuf.read(mem);
  1713. m_renderCtx->updateDynamicIndexBuffer(handle, offset, size, mem);
  1714. release(mem);
  1715. }
  1716. break;
  1717. case CommandBuffer::DestroyDynamicIndexBuffer:
  1718. {
  1719. IndexBufferHandle handle;
  1720. _cmdbuf.read(handle);
  1721. m_renderCtx->destroyDynamicIndexBuffer(handle);
  1722. }
  1723. break;
  1724. case CommandBuffer::CreateDynamicVertexBuffer:
  1725. {
  1726. VertexBufferHandle handle;
  1727. _cmdbuf.read(handle);
  1728. uint32_t size;
  1729. _cmdbuf.read(size);
  1730. uint16_t flags;
  1731. _cmdbuf.read(flags);
  1732. m_renderCtx->createDynamicVertexBuffer(handle, size, flags);
  1733. }
  1734. break;
  1735. case CommandBuffer::UpdateDynamicVertexBuffer:
  1736. {
  1737. VertexBufferHandle handle;
  1738. _cmdbuf.read(handle);
  1739. uint32_t offset;
  1740. _cmdbuf.read(offset);
  1741. uint32_t size;
  1742. _cmdbuf.read(size);
  1743. Memory* mem;
  1744. _cmdbuf.read(mem);
  1745. m_renderCtx->updateDynamicVertexBuffer(handle, offset, size, mem);
  1746. release(mem);
  1747. }
  1748. break;
  1749. case CommandBuffer::DestroyDynamicVertexBuffer:
  1750. {
  1751. VertexBufferHandle handle;
  1752. _cmdbuf.read(handle);
  1753. m_renderCtx->destroyDynamicVertexBuffer(handle);
  1754. }
  1755. break;
  1756. case CommandBuffer::CreateShader:
  1757. {
  1758. ShaderHandle handle;
  1759. _cmdbuf.read(handle);
  1760. Memory* mem;
  1761. _cmdbuf.read(mem);
  1762. m_renderCtx->createShader(handle, mem);
  1763. release(mem);
  1764. }
  1765. break;
  1766. case CommandBuffer::DestroyShader:
  1767. {
  1768. ShaderHandle handle;
  1769. _cmdbuf.read(handle);
  1770. m_renderCtx->destroyShader(handle);
  1771. }
  1772. break;
  1773. case CommandBuffer::CreateProgram:
  1774. {
  1775. ProgramHandle handle;
  1776. _cmdbuf.read(handle);
  1777. ShaderHandle vsh;
  1778. _cmdbuf.read(vsh);
  1779. ShaderHandle fsh;
  1780. _cmdbuf.read(fsh);
  1781. m_renderCtx->createProgram(handle, vsh, fsh);
  1782. }
  1783. break;
  1784. case CommandBuffer::DestroyProgram:
  1785. {
  1786. ProgramHandle handle;
  1787. _cmdbuf.read(handle);
  1788. m_renderCtx->destroyProgram(handle);
  1789. }
  1790. break;
  1791. case CommandBuffer::CreateTexture:
  1792. {
  1793. TextureHandle handle;
  1794. _cmdbuf.read(handle);
  1795. Memory* mem;
  1796. _cmdbuf.read(mem);
  1797. uint32_t flags;
  1798. _cmdbuf.read(flags);
  1799. uint8_t skip;
  1800. _cmdbuf.read(skip);
  1801. m_renderCtx->createTexture(handle, mem, flags, skip);
  1802. bx::MemoryReader reader(mem->data, mem->size);
  1803. uint32_t magic;
  1804. bx::read(&reader, magic);
  1805. if (BGFX_CHUNK_MAGIC_TEX == magic)
  1806. {
  1807. TextureCreate tc;
  1808. bx::read(&reader, tc);
  1809. if (NULL != tc.m_mem)
  1810. {
  1811. release(tc.m_mem);
  1812. }
  1813. }
  1814. release(mem);
  1815. }
  1816. break;
  1817. case CommandBuffer::UpdateTexture:
  1818. {
  1819. if (m_textureUpdateBatch.isFull() )
  1820. {
  1821. flushTextureUpdateBatch(_cmdbuf);
  1822. }
  1823. uint32_t value = _cmdbuf.m_pos;
  1824. TextureHandle handle;
  1825. _cmdbuf.read(handle);
  1826. uint8_t side;
  1827. _cmdbuf.read(side);
  1828. uint8_t mip;
  1829. _cmdbuf.read(mip);
  1830. _cmdbuf.skip<Rect>();
  1831. _cmdbuf.skip<uint16_t>();
  1832. _cmdbuf.skip<uint16_t>();
  1833. _cmdbuf.skip<uint16_t>();
  1834. _cmdbuf.skip<Memory*>();
  1835. uint32_t key = (handle.idx<<16)
  1836. | (side<<8)
  1837. | mip
  1838. ;
  1839. m_textureUpdateBatch.add(key, value);
  1840. }
  1841. break;
  1842. case CommandBuffer::ReadTexture:
  1843. {
  1844. TextureHandle handle;
  1845. _cmdbuf.read(handle);
  1846. void* data;
  1847. _cmdbuf.read(data);
  1848. m_renderCtx->readTexture(handle, data);
  1849. }
  1850. break;
  1851. case CommandBuffer::ResizeTexture:
  1852. {
  1853. TextureHandle handle;
  1854. _cmdbuf.read(handle);
  1855. uint16_t width;
  1856. _cmdbuf.read(width);
  1857. uint16_t height;
  1858. _cmdbuf.read(height);
  1859. uint8_t numMips;
  1860. _cmdbuf.read(numMips);
  1861. m_renderCtx->resizeTexture(handle, width, height, numMips);
  1862. }
  1863. break;
  1864. case CommandBuffer::DestroyTexture:
  1865. {
  1866. TextureHandle handle;
  1867. _cmdbuf.read(handle);
  1868. m_renderCtx->destroyTexture(handle);
  1869. }
  1870. break;
  1871. case CommandBuffer::CreateFrameBuffer:
  1872. {
  1873. FrameBufferHandle handle;
  1874. _cmdbuf.read(handle);
  1875. bool window;
  1876. _cmdbuf.read(window);
  1877. if (window)
  1878. {
  1879. void* nwh;
  1880. _cmdbuf.read(nwh);
  1881. uint16_t width;
  1882. _cmdbuf.read(width);
  1883. uint16_t height;
  1884. _cmdbuf.read(height);
  1885. TextureFormat::Enum depthFormat;
  1886. _cmdbuf.read(depthFormat);
  1887. m_renderCtx->createFrameBuffer(handle, nwh, width, height, depthFormat);
  1888. }
  1889. else
  1890. {
  1891. uint8_t num;
  1892. _cmdbuf.read(num);
  1893. Attachment attachment[BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS];
  1894. _cmdbuf.read(attachment, sizeof(Attachment) * num);
  1895. m_renderCtx->createFrameBuffer(handle, num, attachment);
  1896. }
  1897. }
  1898. break;
  1899. case CommandBuffer::DestroyFrameBuffer:
  1900. {
  1901. FrameBufferHandle handle;
  1902. _cmdbuf.read(handle);
  1903. m_renderCtx->destroyFrameBuffer(handle);
  1904. }
  1905. break;
  1906. case CommandBuffer::CreateUniform:
  1907. {
  1908. UniformHandle handle;
  1909. _cmdbuf.read(handle);
  1910. UniformType::Enum type;
  1911. _cmdbuf.read(type);
  1912. uint16_t num;
  1913. _cmdbuf.read(num);
  1914. uint8_t len;
  1915. _cmdbuf.read(len);
  1916. const char* name = (const char*)_cmdbuf.skip(len);
  1917. m_renderCtx->createUniform(handle, type, num, name);
  1918. }
  1919. break;
  1920. case CommandBuffer::DestroyUniform:
  1921. {
  1922. UniformHandle handle;
  1923. _cmdbuf.read(handle);
  1924. m_renderCtx->destroyUniform(handle);
  1925. }
  1926. break;
  1927. case CommandBuffer::SaveScreenShot:
  1928. {
  1929. uint16_t len;
  1930. _cmdbuf.read(len);
  1931. const char* filePath = (const char*)_cmdbuf.skip(len);
  1932. m_renderCtx->saveScreenShot(filePath);
  1933. }
  1934. break;
  1935. case CommandBuffer::UpdateViewName:
  1936. {
  1937. uint8_t id;
  1938. _cmdbuf.read(id);
  1939. uint16_t len;
  1940. _cmdbuf.read(len);
  1941. const char* name = (const char*)_cmdbuf.skip(len);
  1942. m_renderCtx->updateViewName(id, name);
  1943. }
  1944. break;
  1945. default:
  1946. BX_CHECK(false, "Invalid command: %d", command);
  1947. break;
  1948. }
  1949. } while (!end);
  1950. flushTextureUpdateBatch(_cmdbuf);
  1951. }
  1952. uint32_t topologyConvert(TopologyConvert::Enum _conversion, void* _dst, uint32_t _dstSize, const void* _indices, uint32_t _numIndices, bool _index32)
  1953. {
  1954. return topologyConvert(_conversion, _dst, _dstSize, _indices, _numIndices, _index32, g_allocator);
  1955. }
  1956. 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)
  1957. {
  1958. topologySortTriList(_sort, _dst, _dstSize, _dir, _pos, _vertices, _stride, _indices, _numIndices, _index32, g_allocator);
  1959. }
  1960. uint8_t getSupportedRenderers(RendererType::Enum _enum[RendererType::Count])
  1961. {
  1962. uint8_t num = 0;
  1963. for (uint8_t ii = 0; ii < uint8_t(RendererType::Count); ++ii)
  1964. {
  1965. if ( (RendererType::Direct3D11 == ii || RendererType::Direct3D12 == ii)
  1966. && windowsVersionIs(Condition::LessEqual, 0x0502) )
  1967. {
  1968. continue;
  1969. }
  1970. if (s_rendererCreator[ii].supported)
  1971. {
  1972. _enum[num++] = RendererType::Enum(ii);
  1973. }
  1974. }
  1975. return num;
  1976. }
  1977. const char* getRendererName(RendererType::Enum _type)
  1978. {
  1979. BX_CHECK(_type < RendererType::Count, "Invalid renderer type %d.", _type);
  1980. return s_rendererCreator[_type].name;
  1981. }
  1982. bool init(RendererType::Enum _type, uint16_t _vendorId, uint16_t _deviceId, CallbackI* _callback, bx::AllocatorI* _allocator)
  1983. {
  1984. if (NULL != s_ctx)
  1985. {
  1986. BX_TRACE("bgfx is already initialized.");
  1987. return false;
  1988. }
  1989. struct ErrorState
  1990. {
  1991. enum Enum
  1992. {
  1993. Default,
  1994. ContextAllocated,
  1995. };
  1996. };
  1997. ErrorState::Enum errorState = ErrorState::Default;
  1998. if (NULL != _allocator)
  1999. {
  2000. g_allocator = _allocator;
  2001. }
  2002. else
  2003. {
  2004. bx::CrtAllocator allocator;
  2005. g_allocator =
  2006. s_allocatorStub = BX_NEW(&allocator, AllocatorStub);
  2007. }
  2008. if (NULL != _callback)
  2009. {
  2010. g_callback = _callback;
  2011. }
  2012. else
  2013. {
  2014. g_callback =
  2015. s_callbackStub = BX_NEW(g_allocator, CallbackStub);
  2016. }
  2017. if (!BX_ENABLED(BX_PLATFORM_EMSCRIPTEN || BX_PLATFORM_NACL)
  2018. && NULL == g_platformData.ndt
  2019. && NULL == g_platformData.nwh
  2020. && NULL == g_platformData.context
  2021. && NULL == g_platformData.backBuffer
  2022. && NULL == g_platformData.backBufferDS)
  2023. {
  2024. BX_TRACE("bgfx platform data like window handle or backbuffer must be set.");
  2025. goto error;
  2026. }
  2027. memset(&g_caps, 0, sizeof(g_caps) );
  2028. g_caps.maxViews = BGFX_CONFIG_MAX_VIEWS;
  2029. g_caps.maxDrawCalls = BGFX_CONFIG_MAX_DRAW_CALLS;
  2030. g_caps.maxFBAttachments = 1;
  2031. g_caps.vendorId = _vendorId;
  2032. g_caps.deviceId = _deviceId;
  2033. BX_TRACE("Init...");
  2034. errorState = ErrorState::ContextAllocated;
  2035. s_ctx = BX_ALIGNED_NEW(g_allocator, Context, 16);
  2036. if (s_ctx->init(_type) )
  2037. {
  2038. BX_TRACE("Init complete.");
  2039. return true;
  2040. }
  2041. error:
  2042. BX_TRACE("Init failed.");
  2043. switch (errorState)
  2044. {
  2045. case ErrorState::ContextAllocated:
  2046. BX_ALIGNED_DELETE(g_allocator, s_ctx, 16);
  2047. s_ctx = NULL;
  2048. case ErrorState::Default:
  2049. if (NULL != s_callbackStub)
  2050. {
  2051. BX_DELETE(g_allocator, s_callbackStub);
  2052. s_callbackStub = NULL;
  2053. }
  2054. if (NULL != s_allocatorStub)
  2055. {
  2056. bx::CrtAllocator allocator;
  2057. BX_DELETE(&allocator, s_allocatorStub);
  2058. s_allocatorStub = NULL;
  2059. }
  2060. s_threadIndex = 0;
  2061. g_callback = NULL;
  2062. g_allocator = NULL;
  2063. break;
  2064. }
  2065. return false;
  2066. }
  2067. void shutdown()
  2068. {
  2069. BX_TRACE("Shutdown...");
  2070. BGFX_CHECK_MAIN_THREAD();
  2071. Context* ctx = s_ctx; // it's going to be NULLd inside shutdown.
  2072. ctx->shutdown();
  2073. BX_CHECK(NULL == s_ctx, "bgfx is should be uninitialized here.");
  2074. BX_ALIGNED_DELETE(g_allocator, ctx, 16);
  2075. BX_TRACE("Shutdown complete.");
  2076. if (NULL != s_allocatorStub)
  2077. {
  2078. s_allocatorStub->checkLeaks();
  2079. }
  2080. if (NULL != s_callbackStub)
  2081. {
  2082. BX_DELETE(g_allocator, s_callbackStub);
  2083. s_callbackStub = NULL;
  2084. }
  2085. if (NULL != s_allocatorStub)
  2086. {
  2087. bx::CrtAllocator allocator;
  2088. BX_DELETE(&allocator, s_allocatorStub);
  2089. s_allocatorStub = NULL;
  2090. }
  2091. s_threadIndex = 0;
  2092. g_callback = NULL;
  2093. g_allocator = NULL;
  2094. }
  2095. void reset(uint32_t _width, uint32_t _height, uint32_t _flags)
  2096. {
  2097. BGFX_CHECK_MAIN_THREAD();
  2098. BX_CHECK(0 == (_flags&BGFX_RESET_RESERVED_MASK), "Do not set reset reserved flags!");
  2099. s_ctx->reset(_width, _height, _flags);
  2100. }
  2101. uint32_t frame(bool _capture)
  2102. {
  2103. BGFX_CHECK_MAIN_THREAD();
  2104. return s_ctx->frame(_capture);
  2105. }
  2106. const Caps* getCaps()
  2107. {
  2108. return &g_caps;
  2109. }
  2110. const HMD* getHMD()
  2111. {
  2112. return s_ctx->getHMD();
  2113. }
  2114. const Stats* getStats()
  2115. {
  2116. return s_ctx->getPerfStats();
  2117. }
  2118. RendererType::Enum getRendererType()
  2119. {
  2120. return g_caps.rendererType;
  2121. }
  2122. const Memory* alloc(uint32_t _size)
  2123. {
  2124. BX_CHECK(0 < _size, "Invalid memory operation. _size is 0.");
  2125. Memory* mem = (Memory*)BX_ALLOC(g_allocator, sizeof(Memory) + _size);
  2126. mem->size = _size;
  2127. mem->data = (uint8_t*)mem + sizeof(Memory);
  2128. return mem;
  2129. }
  2130. const Memory* copy(const void* _data, uint32_t _size)
  2131. {
  2132. BX_CHECK(0 < _size, "Invalid memory operation. _size is 0.");
  2133. const Memory* mem = alloc(_size);
  2134. memcpy(mem->data, _data, _size);
  2135. return mem;
  2136. }
  2137. struct MemoryRef
  2138. {
  2139. Memory mem;
  2140. ReleaseFn releaseFn;
  2141. void* userData;
  2142. };
  2143. const Memory* makeRef(const void* _data, uint32_t _size, ReleaseFn _releaseFn, void* _userData)
  2144. {
  2145. MemoryRef* memRef = (MemoryRef*)BX_ALLOC(g_allocator, sizeof(MemoryRef) );
  2146. memRef->mem.size = _size;
  2147. memRef->mem.data = (uint8_t*)_data;
  2148. memRef->releaseFn = _releaseFn;
  2149. memRef->userData = _userData;
  2150. return &memRef->mem;
  2151. }
  2152. bool isMemoryRef(const Memory* _mem)
  2153. {
  2154. return _mem->data != (uint8_t*)_mem + sizeof(Memory);
  2155. }
  2156. void release(const Memory* _mem)
  2157. {
  2158. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2159. Memory* mem = const_cast<Memory*>(_mem);
  2160. if (isMemoryRef(mem) )
  2161. {
  2162. MemoryRef* memRef = reinterpret_cast<MemoryRef*>(mem);
  2163. if (NULL != memRef->releaseFn)
  2164. {
  2165. memRef->releaseFn(mem->data, memRef->userData);
  2166. }
  2167. }
  2168. BX_FREE(g_allocator, mem);
  2169. }
  2170. void setDebug(uint32_t _debug)
  2171. {
  2172. BGFX_CHECK_MAIN_THREAD();
  2173. s_ctx->setDebug(_debug);
  2174. }
  2175. void dbgTextClear(uint8_t _attr, bool _small)
  2176. {
  2177. BGFX_CHECK_MAIN_THREAD();
  2178. s_ctx->dbgTextClear(_attr, _small);
  2179. }
  2180. void dbgTextPrintfVargs(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, va_list _argList)
  2181. {
  2182. s_ctx->dbgTextPrintfVargs(_x, _y, _attr, _format, _argList);
  2183. }
  2184. void dbgTextPrintf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, ...)
  2185. {
  2186. BGFX_CHECK_MAIN_THREAD();
  2187. va_list argList;
  2188. va_start(argList, _format);
  2189. s_ctx->dbgTextPrintfVargs(_x, _y, _attr, _format, argList);
  2190. va_end(argList);
  2191. }
  2192. void dbgTextImage(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const void* _data, uint16_t _pitch)
  2193. {
  2194. BGFX_CHECK_MAIN_THREAD();
  2195. s_ctx->dbgTextImage(_x, _y, _width, _height, _data, _pitch);
  2196. }
  2197. IndexBufferHandle createIndexBuffer(const Memory* _mem, uint16_t _flags)
  2198. {
  2199. BGFX_CHECK_MAIN_THREAD();
  2200. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2201. return s_ctx->createIndexBuffer(_mem, _flags);
  2202. }
  2203. void destroyIndexBuffer(IndexBufferHandle _handle)
  2204. {
  2205. BGFX_CHECK_MAIN_THREAD();
  2206. s_ctx->destroyIndexBuffer(_handle);
  2207. }
  2208. VertexBufferHandle createVertexBuffer(const Memory* _mem, const VertexDecl& _decl, uint16_t _flags)
  2209. {
  2210. BGFX_CHECK_MAIN_THREAD();
  2211. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2212. BX_CHECK(0 != _decl.m_stride, "Invalid VertexDecl.");
  2213. return s_ctx->createVertexBuffer(_mem, _decl, _flags);
  2214. }
  2215. void destroyVertexBuffer(VertexBufferHandle _handle)
  2216. {
  2217. BGFX_CHECK_MAIN_THREAD();
  2218. s_ctx->destroyVertexBuffer(_handle);
  2219. }
  2220. DynamicIndexBufferHandle createDynamicIndexBuffer(uint32_t _num, uint16_t _flags)
  2221. {
  2222. BGFX_CHECK_MAIN_THREAD();
  2223. return s_ctx->createDynamicIndexBuffer(_num, _flags);
  2224. }
  2225. DynamicIndexBufferHandle createDynamicIndexBuffer(const Memory* _mem, uint16_t _flags)
  2226. {
  2227. BGFX_CHECK_MAIN_THREAD();
  2228. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2229. return s_ctx->createDynamicIndexBuffer(_mem, _flags);
  2230. }
  2231. void updateDynamicIndexBuffer(DynamicIndexBufferHandle _handle, uint32_t _startIndex, const Memory* _mem)
  2232. {
  2233. BGFX_CHECK_MAIN_THREAD();
  2234. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2235. s_ctx->updateDynamicIndexBuffer(_handle, _startIndex, _mem);
  2236. }
  2237. void destroyDynamicIndexBuffer(DynamicIndexBufferHandle _handle)
  2238. {
  2239. BGFX_CHECK_MAIN_THREAD();
  2240. s_ctx->destroyDynamicIndexBuffer(_handle);
  2241. }
  2242. DynamicVertexBufferHandle createDynamicVertexBuffer(uint32_t _num, const VertexDecl& _decl, uint16_t _flags)
  2243. {
  2244. BGFX_CHECK_MAIN_THREAD();
  2245. BX_CHECK(0 != _decl.m_stride, "Invalid VertexDecl.");
  2246. return s_ctx->createDynamicVertexBuffer(_num, _decl, _flags);
  2247. }
  2248. DynamicVertexBufferHandle createDynamicVertexBuffer(const Memory* _mem, const VertexDecl& _decl, uint16_t _flags)
  2249. {
  2250. BGFX_CHECK_MAIN_THREAD();
  2251. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2252. BX_CHECK(0 != _decl.m_stride, "Invalid VertexDecl.");
  2253. return s_ctx->createDynamicVertexBuffer(_mem, _decl, _flags);
  2254. }
  2255. void updateDynamicVertexBuffer(DynamicVertexBufferHandle _handle, uint32_t _startVertex, const Memory* _mem)
  2256. {
  2257. BGFX_CHECK_MAIN_THREAD();
  2258. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2259. s_ctx->updateDynamicVertexBuffer(_handle, _startVertex, _mem);
  2260. }
  2261. void destroyDynamicVertexBuffer(DynamicVertexBufferHandle _handle)
  2262. {
  2263. BGFX_CHECK_MAIN_THREAD();
  2264. s_ctx->destroyDynamicVertexBuffer(_handle);
  2265. }
  2266. bool checkAvailTransientIndexBuffer(uint32_t _num)
  2267. {
  2268. BGFX_CHECK_MAIN_THREAD();
  2269. BX_CHECK(0 < _num, "Requesting 0 indices.");
  2270. return s_ctx->checkAvailTransientIndexBuffer(_num);
  2271. }
  2272. bool checkAvailTransientVertexBuffer(uint32_t _num, const VertexDecl& _decl)
  2273. {
  2274. BGFX_CHECK_MAIN_THREAD();
  2275. BX_CHECK(0 < _num, "Requesting 0 vertices.");
  2276. BX_CHECK(0 != _decl.m_stride, "Invalid VertexDecl.");
  2277. return s_ctx->checkAvailTransientVertexBuffer(_num, _decl.m_stride);
  2278. }
  2279. bool checkAvailInstanceDataBuffer(uint32_t _num, uint16_t _stride)
  2280. {
  2281. BGFX_CHECK_MAIN_THREAD();
  2282. BX_CHECK(0 < _num, "Requesting 0 instances.");
  2283. return s_ctx->checkAvailTransientVertexBuffer(_num, _stride);
  2284. }
  2285. bool checkAvailTransientBuffers(uint32_t _numVertices, const VertexDecl& _decl, uint32_t _numIndices)
  2286. {
  2287. BX_CHECK(0 != _decl.m_stride, "Invalid VertexDecl.");
  2288. return checkAvailTransientVertexBuffer(_numVertices, _decl)
  2289. && checkAvailTransientIndexBuffer(_numIndices)
  2290. ;
  2291. }
  2292. void allocTransientIndexBuffer(TransientIndexBuffer* _tib, uint32_t _num)
  2293. {
  2294. BGFX_CHECK_MAIN_THREAD();
  2295. BX_CHECK(NULL != _tib, "_tib can't be NULL");
  2296. BX_CHECK(0 < _num, "Requesting 0 indices.");
  2297. s_ctx->allocTransientIndexBuffer(_tib, _num);
  2298. BX_CHECK(_num == _tib->size/2, "Failed to allocate transient index buffer (requested %d, available %d). Use bgfx::checkAvailTransient* functions to ensure availability."
  2299. , _num
  2300. , _tib->size/2
  2301. );
  2302. }
  2303. void allocTransientVertexBuffer(TransientVertexBuffer* _tvb, uint32_t _num, const VertexDecl& _decl)
  2304. {
  2305. BGFX_CHECK_MAIN_THREAD();
  2306. BX_CHECK(NULL != _tvb, "_tvb can't be NULL");
  2307. BX_CHECK(0 < _num, "Requesting 0 vertices.");
  2308. BX_CHECK(UINT16_MAX >= _num, "Requesting %d vertices (max: %d).", _num, UINT16_MAX);
  2309. BX_CHECK(0 != _decl.m_stride, "Invalid VertexDecl.");
  2310. s_ctx->allocTransientVertexBuffer(_tvb, _num, _decl);
  2311. 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."
  2312. , _num
  2313. , _tvb->size / _decl.m_stride
  2314. );
  2315. }
  2316. bool allocTransientBuffers(bgfx::TransientVertexBuffer* _tvb, const bgfx::VertexDecl& _decl, uint32_t _numVertices, bgfx::TransientIndexBuffer* _tib, uint32_t _numIndices)
  2317. {
  2318. if (checkAvailTransientBuffers(_numVertices, _decl, _numIndices) )
  2319. {
  2320. allocTransientVertexBuffer(_tvb, _numVertices, _decl);
  2321. allocTransientIndexBuffer(_tib, _numIndices);
  2322. return true;
  2323. }
  2324. return false;
  2325. }
  2326. const InstanceDataBuffer* allocInstanceDataBuffer(uint32_t _num, uint16_t _stride)
  2327. {
  2328. BGFX_CHECK_MAIN_THREAD();
  2329. BGFX_CHECK_CAPS(BGFX_CAPS_INSTANCING, "Instancing is not supported!");
  2330. BX_CHECK(0 < _num, "Requesting 0 instanced data vertices.");
  2331. const InstanceDataBuffer* idb = s_ctx->allocInstanceDataBuffer(_num, _stride);
  2332. BX_CHECK(_num == idb->size / _stride, "Failed to allocate instance data buffer (requested %d, available %d). Use bgfx::checkAvailTransient* functions to ensure availability."
  2333. , _num
  2334. , idb->size / _stride
  2335. );
  2336. return idb;
  2337. }
  2338. IndirectBufferHandle createIndirectBuffer(uint32_t _num)
  2339. {
  2340. BGFX_CHECK_MAIN_THREAD();
  2341. return s_ctx->createIndirectBuffer(_num);
  2342. }
  2343. void destroyIndirectBuffer(IndirectBufferHandle _handle)
  2344. {
  2345. BGFX_CHECK_MAIN_THREAD();
  2346. s_ctx->destroyIndirectBuffer(_handle);
  2347. }
  2348. ShaderHandle createShader(const Memory* _mem)
  2349. {
  2350. BGFX_CHECK_MAIN_THREAD();
  2351. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2352. return s_ctx->createShader(_mem);
  2353. }
  2354. uint16_t getShaderUniforms(ShaderHandle _handle, UniformHandle* _uniforms, uint16_t _max)
  2355. {
  2356. BGFX_CHECK_MAIN_THREAD();
  2357. return s_ctx->getShaderUniforms(_handle, _uniforms, _max);
  2358. }
  2359. void destroyShader(ShaderHandle _handle)
  2360. {
  2361. BGFX_CHECK_MAIN_THREAD();
  2362. s_ctx->destroyShader(_handle);
  2363. }
  2364. ProgramHandle createProgram(ShaderHandle _vsh, ShaderHandle _fsh, bool _destroyShaders)
  2365. {
  2366. BGFX_CHECK_MAIN_THREAD();
  2367. if (!isValid(_fsh) )
  2368. {
  2369. return createProgram(_vsh, _destroyShaders);
  2370. }
  2371. return s_ctx->createProgram(_vsh, _fsh, _destroyShaders);
  2372. }
  2373. ProgramHandle createProgram(ShaderHandle _csh, bool _destroyShader)
  2374. {
  2375. BGFX_CHECK_MAIN_THREAD();
  2376. return s_ctx->createProgram(_csh, _destroyShader);
  2377. }
  2378. void destroyProgram(ProgramHandle _handle)
  2379. {
  2380. BGFX_CHECK_MAIN_THREAD();
  2381. s_ctx->destroyProgram(_handle);
  2382. }
  2383. void calcTextureSize(TextureInfo& _info, uint16_t _width, uint16_t _height, uint16_t _depth, bool _cubeMap, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format)
  2384. {
  2385. const ImageBlockInfo& blockInfo = getBlockInfo(_format);
  2386. const uint8_t bpp = blockInfo.bitsPerPixel;
  2387. const uint16_t blockWidth = blockInfo.blockWidth;
  2388. const uint16_t blockHeight = blockInfo.blockHeight;
  2389. const uint16_t minBlockX = blockInfo.minBlockX;
  2390. const uint16_t minBlockY = blockInfo.minBlockY;
  2391. _width = bx::uint16_max(blockWidth * minBlockX, ( (_width + blockWidth - 1) / blockWidth)*blockWidth);
  2392. _height = bx::uint16_max(blockHeight * minBlockY, ( (_height + blockHeight - 1) / blockHeight)*blockHeight);
  2393. _depth = bx::uint16_max(1, _depth);
  2394. const uint8_t numMips = calcNumMips(_hasMips, _width, _height, _depth);
  2395. const uint32_t sides = _cubeMap ? 6 : 1;
  2396. uint32_t width = _width;
  2397. uint32_t height = _height;
  2398. uint32_t depth = _depth;
  2399. uint32_t size = 0;
  2400. for (uint32_t lod = 0; lod < numMips; ++lod)
  2401. {
  2402. width = bx::uint32_max(blockWidth * minBlockX, ( (width + blockWidth - 1) / blockWidth )*blockWidth);
  2403. height = bx::uint32_max(blockHeight * minBlockY, ( (height + blockHeight - 1) / blockHeight)*blockHeight);
  2404. depth = bx::uint32_max(1, depth);
  2405. size += width*height*depth*bpp/8 * sides;
  2406. width >>= 1;
  2407. height >>= 1;
  2408. depth >>= 1;
  2409. }
  2410. size *= _numLayers;
  2411. _info.format = _format;
  2412. _info.width = _width;
  2413. _info.height = _height;
  2414. _info.depth = _depth;
  2415. _info.numMips = numMips;
  2416. _info.numLayers = _numLayers;
  2417. _info.cubeMap = _cubeMap;
  2418. _info.storageSize = size;
  2419. _info.bitsPerPixel = bpp;
  2420. }
  2421. TextureHandle createTexture(const Memory* _mem, uint32_t _flags, uint8_t _skip, TextureInfo* _info)
  2422. {
  2423. BGFX_CHECK_MAIN_THREAD();
  2424. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2425. return s_ctx->createTexture(_mem, _flags, _skip, _info, BackbufferRatio::Count);
  2426. }
  2427. void getTextureSizeFromRatio(BackbufferRatio::Enum _ratio, uint16_t& _width, uint16_t& _height)
  2428. {
  2429. switch (_ratio)
  2430. {
  2431. case BackbufferRatio::Half: _width /= 2; _height /= 2; break;
  2432. case BackbufferRatio::Quarter: _width /= 4; _height /= 4; break;
  2433. case BackbufferRatio::Eighth: _width /= 8; _height /= 8; break;
  2434. case BackbufferRatio::Sixteenth: _width /= 16; _height /= 16; break;
  2435. case BackbufferRatio::Double: _width *= 2; _height *= 2; break;
  2436. default:
  2437. break;
  2438. }
  2439. _width = bx::uint16_max(1, _width);
  2440. _height = bx::uint16_max(1, _height);
  2441. }
  2442. 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)
  2443. {
  2444. BGFX_CHECK_MAIN_THREAD();
  2445. BX_CHECK(0 == (_flags & BGFX_TEXTURE_RT_MASK) || 0 == (_flags & BGFX_TEXTURE_READ_BACK)
  2446. , "Can't create render target with BGFX_TEXTURE_READ_BACK flag."
  2447. );
  2448. BX_CHECK(0 != (g_caps.formats[_format] & (BGFX_CAPS_FORMAT_TEXTURE_2D|BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED|BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB) )
  2449. , "Format %s is not supported for 2D texture. Use bgfx::getCaps to check available texture formats."
  2450. , getName(_format)
  2451. );
  2452. BX_CHECK(false
  2453. || 1 >= _numLayers
  2454. || 0 != (g_caps.supported & BGFX_CAPS_TEXTURE_2D_ARRAY)
  2455. , "_numLayers is %d. Texture 2D array is not supported! Use bgfx::getCaps to check BGFX_CAPS_TEXTURE_2D_ARRAY backend renderer capabilities."
  2456. , _numLayers
  2457. );
  2458. if (BackbufferRatio::Count != _ratio)
  2459. {
  2460. _width = uint16_t(s_ctx->m_resolution.m_width);
  2461. _height = uint16_t(s_ctx->m_resolution.m_height);
  2462. getTextureSizeFromRatio(_ratio, _width, _height);
  2463. }
  2464. const uint8_t numMips = calcNumMips(_hasMips, _width, _height);
  2465. _numLayers = bx::uint16_max(_numLayers, 1);
  2466. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  2467. && NULL != _mem)
  2468. {
  2469. TextureInfo ti;
  2470. calcTextureSize(ti, _width, _height, 1, false, _hasMips, _numLayers, _format);
  2471. BX_CHECK(ti.storageSize == _mem->size
  2472. , "createTexture2D: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  2473. , ti.storageSize
  2474. , _mem->size
  2475. );
  2476. }
  2477. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  2478. const Memory* mem = alloc(size);
  2479. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  2480. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  2481. bx::write(&writer, magic);
  2482. TextureCreate tc;
  2483. tc.m_width = _width;
  2484. tc.m_height = _height;
  2485. tc.m_depth = 0;
  2486. tc.m_numLayers = _numLayers;
  2487. tc.m_numMips = numMips;
  2488. tc.m_format = _format;
  2489. tc.m_cubeMap = false;
  2490. tc.m_mem = _mem;
  2491. bx::write(&writer, tc);
  2492. return s_ctx->createTexture(mem, _flags, 0, NULL, _ratio);
  2493. }
  2494. TextureHandle createTexture2D(uint16_t _width, uint16_t _height, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint32_t _flags, const Memory* _mem)
  2495. {
  2496. BX_CHECK(_width > 0 && _height > 0, "Invalid texture size (width %d, height %d).", _width, _height);
  2497. return createTexture2D(BackbufferRatio::Count, _width, _height, _hasMips, _numLayers, _format, _flags, _mem);
  2498. }
  2499. TextureHandle createTexture2D(BackbufferRatio::Enum _ratio, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint32_t _flags)
  2500. {
  2501. BX_CHECK(_ratio < BackbufferRatio::Count, "Invalid back buffer ratio.");
  2502. return createTexture2D(_ratio, 0, 0, _hasMips, _numLayers, _format, _flags, NULL);
  2503. }
  2504. TextureHandle createTexture3D(uint16_t _width, uint16_t _height, uint16_t _depth, bool _hasMips, TextureFormat::Enum _format, uint32_t _flags, const Memory* _mem)
  2505. {
  2506. BGFX_CHECK_MAIN_THREAD();
  2507. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_3D, "Texture3D is not supported!");
  2508. BX_CHECK(0 != (g_caps.formats[_format] & (BGFX_CAPS_FORMAT_TEXTURE_3D|BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED|BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB) )
  2509. , "Format %s is not supported for 3D texture. Use bgfx::getCaps to check available texture formats."
  2510. , getName(_format)
  2511. );
  2512. const uint8_t numMips = calcNumMips(_hasMips, _width, _height, _depth);
  2513. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  2514. && NULL != _mem)
  2515. {
  2516. TextureInfo ti;
  2517. calcTextureSize(ti, _width, _height, _depth, false, _hasMips, 1, _format);
  2518. BX_CHECK(ti.storageSize == _mem->size
  2519. , "createTexture3D: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  2520. , ti.storageSize
  2521. , _mem->size
  2522. );
  2523. }
  2524. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  2525. const Memory* mem = alloc(size);
  2526. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  2527. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  2528. bx::write(&writer, magic);
  2529. TextureCreate tc;
  2530. tc.m_width = _width;
  2531. tc.m_height = _height;
  2532. tc.m_depth = _depth;
  2533. tc.m_numLayers = 1;
  2534. tc.m_numMips = numMips;
  2535. tc.m_format = _format;
  2536. tc.m_cubeMap = false;
  2537. tc.m_mem = _mem;
  2538. bx::write(&writer, tc);
  2539. return s_ctx->createTexture(mem, _flags, 0, NULL, BackbufferRatio::Count);
  2540. }
  2541. TextureHandle createTextureCube(uint16_t _size, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint32_t _flags, const Memory* _mem)
  2542. {
  2543. BGFX_CHECK_MAIN_THREAD();
  2544. BX_CHECK(0 != (g_caps.formats[_format] & (BGFX_CAPS_FORMAT_TEXTURE_CUBE|BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED|BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB) )
  2545. , "Format %s is not supported for cube texture. Use bgfx::getCaps to check available texture formats."
  2546. , getName(_format)
  2547. );
  2548. BX_CHECK(false
  2549. || 1 >= _numLayers
  2550. || 0 != (g_caps.supported & BGFX_CAPS_TEXTURE_CUBE_ARRAY)
  2551. , "_numLayers is %d. Texture cube array is not supported! Use bgfx::getCaps to check BGFX_CAPS_TEXTURE_CUBE_ARRAY backend renderer capabilities."
  2552. , _numLayers
  2553. );
  2554. const uint8_t numMips = calcNumMips(_hasMips, _size, _size);
  2555. _numLayers = bx::uint16_max(_numLayers, 1);
  2556. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  2557. && NULL != _mem)
  2558. {
  2559. TextureInfo ti;
  2560. calcTextureSize(ti, _size, _size, 1, true, _hasMips, _numLayers, _format);
  2561. BX_CHECK(ti.storageSize == _mem->size
  2562. , "createTextureCube: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  2563. , ti.storageSize
  2564. , _mem->size
  2565. );
  2566. }
  2567. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  2568. const Memory* mem = alloc(size);
  2569. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  2570. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  2571. bx::write(&writer, magic);
  2572. TextureCreate tc;
  2573. tc.m_width = _size;
  2574. tc.m_height = _size;
  2575. tc.m_depth = 0;
  2576. tc.m_numLayers = _numLayers;
  2577. tc.m_numMips = numMips;
  2578. tc.m_format = _format;
  2579. tc.m_cubeMap = true;
  2580. tc.m_mem = _mem;
  2581. bx::write(&writer, tc);
  2582. return s_ctx->createTexture(mem, _flags, 0, NULL, BackbufferRatio::Count);
  2583. }
  2584. void destroyTexture(TextureHandle _handle)
  2585. {
  2586. BGFX_CHECK_MAIN_THREAD();
  2587. s_ctx->destroyTexture(_handle);
  2588. }
  2589. 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)
  2590. {
  2591. BGFX_CHECK_MAIN_THREAD();
  2592. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2593. if (_width == 0
  2594. || _height == 0)
  2595. {
  2596. release(_mem);
  2597. }
  2598. else
  2599. {
  2600. s_ctx->updateTexture(_handle, 0, _mip, _x, _y, _layer, _width, _height, 1, _pitch, _mem);
  2601. }
  2602. }
  2603. 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)
  2604. {
  2605. BGFX_CHECK_MAIN_THREAD();
  2606. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2607. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_3D, "Texture3D is not supported!");
  2608. if (0 == _width
  2609. || 0 == _height
  2610. || 0 == _depth)
  2611. {
  2612. release(_mem);
  2613. }
  2614. else
  2615. {
  2616. s_ctx->updateTexture(_handle, 0, _mip, _x, _y, _z, _width, _height, _depth, UINT16_MAX, _mem);
  2617. }
  2618. }
  2619. 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)
  2620. {
  2621. BGFX_CHECK_MAIN_THREAD();
  2622. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2623. BX_CHECK(_side <= 5, "Invalid side %d.", _side);
  2624. if (0 == _width
  2625. || 0 == _height)
  2626. {
  2627. release(_mem);
  2628. }
  2629. else
  2630. {
  2631. s_ctx->updateTexture(_handle, _side, _mip, _x, _y, _layer, _width, _height, 1, _pitch, _mem);
  2632. }
  2633. }
  2634. uint32_t readTexture(TextureHandle _handle, void* _data)
  2635. {
  2636. BGFX_CHECK_MAIN_THREAD();
  2637. BX_CHECK(NULL != _data, "_data can't be NULL");
  2638. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_READ_BACK, "Texture read-back is not supported!");
  2639. return s_ctx->readTexture(_handle, _data);
  2640. }
  2641. uint32_t readTexture(FrameBufferHandle _handle, uint8_t _attachment, void* _data)
  2642. {
  2643. BGFX_CHECK_MAIN_THREAD();
  2644. BX_CHECK(NULL != _data, "_data can't be NULL");
  2645. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_READ_BACK, "Texture read-back is not supported!");
  2646. return s_ctx->readTexture(_handle, _attachment, _data);
  2647. }
  2648. FrameBufferHandle createFrameBuffer(uint16_t _width, uint16_t _height, TextureFormat::Enum _format, uint32_t _textureFlags)
  2649. {
  2650. _textureFlags |= _textureFlags&BGFX_TEXTURE_RT_MSAA_MASK ? 0 : BGFX_TEXTURE_RT;
  2651. TextureHandle th = createTexture2D(_width, _height, false, 1, _format, _textureFlags);
  2652. return createFrameBuffer(1, &th, true);
  2653. }
  2654. FrameBufferHandle createFrameBuffer(BackbufferRatio::Enum _ratio, TextureFormat::Enum _format, uint32_t _textureFlags)
  2655. {
  2656. BX_CHECK(_ratio < BackbufferRatio::Count, "Invalid back buffer ratio.");
  2657. _textureFlags |= _textureFlags&BGFX_TEXTURE_RT_MSAA_MASK ? 0 : BGFX_TEXTURE_RT;
  2658. TextureHandle th = createTexture2D(_ratio, false, 1, _format, _textureFlags);
  2659. return createFrameBuffer(1, &th, true);
  2660. }
  2661. FrameBufferHandle createFrameBuffer(uint8_t _num, const TextureHandle* _handles, bool _destroyTextures)
  2662. {
  2663. Attachment attachment[BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS];
  2664. for (uint8_t ii = 0; ii < _num; ++ii)
  2665. {
  2666. Attachment& at = attachment[ii];
  2667. at.handle = _handles[ii];
  2668. at.mip = 0;
  2669. at.layer = 0;
  2670. }
  2671. return createFrameBuffer(_num, attachment, _destroyTextures);
  2672. }
  2673. FrameBufferHandle createFrameBuffer(uint8_t _num, const Attachment* _attachment, bool _destroyTextures)
  2674. {
  2675. BGFX_CHECK_MAIN_THREAD();
  2676. BX_CHECK(_num != 0, "Number of frame buffer attachments can't be 0.");
  2677. BX_CHECK(_num <= BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS, "Number of frame buffer attachments is larger than allowed %d (max: %d)."
  2678. , _num
  2679. , BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS
  2680. );
  2681. BX_CHECK(NULL != _attachment, "_attachment can't be NULL");
  2682. return s_ctx->createFrameBuffer(_num, _attachment, _destroyTextures);
  2683. }
  2684. FrameBufferHandle createFrameBuffer(void* _nwh, uint16_t _width, uint16_t _height, TextureFormat::Enum _depthFormat)
  2685. {
  2686. BGFX_CHECK_MAIN_THREAD();
  2687. return s_ctx->createFrameBuffer(_nwh, _width, _height, _depthFormat);
  2688. }
  2689. void destroyFrameBuffer(FrameBufferHandle _handle)
  2690. {
  2691. BGFX_CHECK_MAIN_THREAD();
  2692. s_ctx->destroyFrameBuffer(_handle);
  2693. }
  2694. UniformHandle createUniform(const char* _name, UniformType::Enum _type, uint16_t _num)
  2695. {
  2696. BGFX_CHECK_MAIN_THREAD();
  2697. return s_ctx->createUniform(_name, _type, _num);
  2698. }
  2699. void destroyUniform(UniformHandle _handle)
  2700. {
  2701. BGFX_CHECK_MAIN_THREAD();
  2702. s_ctx->destroyUniform(_handle);
  2703. }
  2704. OcclusionQueryHandle createOcclusionQuery()
  2705. {
  2706. BGFX_CHECK_MAIN_THREAD();
  2707. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  2708. return s_ctx->createOcclusionQuery();
  2709. }
  2710. OcclusionQueryResult::Enum getResult(OcclusionQueryHandle _handle)
  2711. {
  2712. BGFX_CHECK_MAIN_THREAD();
  2713. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  2714. return s_ctx->getResult(_handle);
  2715. }
  2716. void destroyOcclusionQuery(OcclusionQueryHandle _handle)
  2717. {
  2718. BGFX_CHECK_MAIN_THREAD();
  2719. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  2720. s_ctx->destroyOcclusionQuery(_handle);
  2721. }
  2722. void setPaletteColor(uint8_t _index, uint32_t _rgba)
  2723. {
  2724. BGFX_CHECK_MAIN_THREAD();
  2725. const uint8_t rr = uint8_t(_rgba>>24);
  2726. const uint8_t gg = uint8_t(_rgba>>16);
  2727. const uint8_t bb = uint8_t(_rgba>> 8);
  2728. const uint8_t aa = uint8_t(_rgba>> 0);
  2729. float rgba[4] =
  2730. {
  2731. rr * 1.0f/255.0f,
  2732. gg * 1.0f/255.0f,
  2733. bb * 1.0f/255.0f,
  2734. aa * 1.0f/255.0f,
  2735. };
  2736. s_ctx->setPaletteColor(_index, rgba);
  2737. }
  2738. void setPaletteColor(uint8_t _index, float _r, float _g, float _b, float _a)
  2739. {
  2740. BGFX_CHECK_MAIN_THREAD();
  2741. float rgba[4] = { _r, _g, _b, _a };
  2742. s_ctx->setPaletteColor(_index, rgba);
  2743. }
  2744. void setPaletteColor(uint8_t _index, const float _rgba[4])
  2745. {
  2746. BGFX_CHECK_MAIN_THREAD();
  2747. s_ctx->setPaletteColor(_index, _rgba);
  2748. }
  2749. bool checkView(uint8_t _id)
  2750. {
  2751. // workaround GCC 4.9 type-limit check.
  2752. const uint32_t id = _id;
  2753. return id < BGFX_CONFIG_MAX_VIEWS;
  2754. }
  2755. void setViewName(uint8_t _id, const char* _name)
  2756. {
  2757. BGFX_CHECK_MAIN_THREAD();
  2758. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2759. s_ctx->setViewName(_id, _name);
  2760. }
  2761. void setViewRect(uint8_t _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  2762. {
  2763. BGFX_CHECK_MAIN_THREAD();
  2764. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2765. s_ctx->setViewRect(_id, _x, _y, _width, _height);
  2766. }
  2767. void setViewRect(uint8_t _id, uint16_t _x, uint16_t _y, BackbufferRatio::Enum _ratio)
  2768. {
  2769. BGFX_CHECK_MAIN_THREAD();
  2770. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2771. uint16_t width = uint16_t(s_ctx->m_resolution.m_width);
  2772. uint16_t height = uint16_t(s_ctx->m_resolution.m_height);
  2773. getTextureSizeFromRatio(_ratio, width, height);
  2774. setViewRect(_id, _x, _y, width, height);
  2775. }
  2776. void setViewScissor(uint8_t _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  2777. {
  2778. BGFX_CHECK_MAIN_THREAD();
  2779. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2780. s_ctx->setViewScissor(_id, _x, _y, _width, _height);
  2781. }
  2782. void setViewClear(uint8_t _id, uint16_t _flags, uint32_t _rgba, float _depth, uint8_t _stencil)
  2783. {
  2784. BGFX_CHECK_MAIN_THREAD();
  2785. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2786. s_ctx->setViewClear(_id, _flags, _rgba, _depth, _stencil);
  2787. }
  2788. 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)
  2789. {
  2790. BGFX_CHECK_MAIN_THREAD();
  2791. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2792. s_ctx->setViewClear(_id, _flags, _depth, _stencil, _0, _1, _2, _3, _4, _5, _6, _7);
  2793. }
  2794. void setViewSeq(uint8_t _id, bool _enabled)
  2795. {
  2796. BGFX_CHECK_MAIN_THREAD();
  2797. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2798. s_ctx->setViewSeq(_id, _enabled);
  2799. }
  2800. void setViewFrameBuffer(uint8_t _id, FrameBufferHandle _handle)
  2801. {
  2802. BGFX_CHECK_MAIN_THREAD();
  2803. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2804. s_ctx->setViewFrameBuffer(_id, _handle);
  2805. }
  2806. void setViewTransform(uint8_t _id, const void* _view, const void* _projL, uint8_t _flags, const void* _projR)
  2807. {
  2808. BGFX_CHECK_MAIN_THREAD();
  2809. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2810. s_ctx->setViewTransform(_id, _view, _projL, _flags, _projR);
  2811. }
  2812. void setViewRemap(uint8_t _id, uint8_t _num, const void* _remap)
  2813. {
  2814. BGFX_CHECK_MAIN_THREAD();
  2815. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2816. s_ctx->setViewRemap(_id, _num, _remap);
  2817. }
  2818. void resetView(uint8_t _id)
  2819. {
  2820. BGFX_CHECK_MAIN_THREAD();
  2821. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  2822. s_ctx->resetView(_id);
  2823. }
  2824. void setMarker(const char* _marker)
  2825. {
  2826. BGFX_CHECK_MAIN_THREAD();
  2827. s_ctx->setMarker(_marker);
  2828. }
  2829. void setState(uint64_t _state, uint32_t _rgba)
  2830. {
  2831. BGFX_CHECK_MAIN_THREAD();
  2832. BX_CHECK(0 == (_state&BGFX_STATE_RESERVED_MASK), "Do not set state reserved flags!");
  2833. s_ctx->setState(_state, _rgba);
  2834. }
  2835. void setCondition(OcclusionQueryHandle _handle, bool _visible)
  2836. {
  2837. BGFX_CHECK_MAIN_THREAD();
  2838. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  2839. s_ctx->setCondition(_handle, _visible);
  2840. }
  2841. void setStencil(uint32_t _fstencil, uint32_t _bstencil)
  2842. {
  2843. BGFX_CHECK_MAIN_THREAD();
  2844. s_ctx->setStencil(_fstencil, _bstencil);
  2845. }
  2846. uint16_t setScissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  2847. {
  2848. BGFX_CHECK_MAIN_THREAD();
  2849. return s_ctx->setScissor(_x, _y, _width, _height);
  2850. }
  2851. void setScissor(uint16_t _cache)
  2852. {
  2853. BGFX_CHECK_MAIN_THREAD();
  2854. s_ctx->setScissor(_cache);
  2855. }
  2856. uint32_t setTransform(const void* _mtx, uint16_t _num)
  2857. {
  2858. BGFX_CHECK_MAIN_THREAD();
  2859. return s_ctx->setTransform(_mtx, _num);
  2860. }
  2861. uint32_t allocTransform(Transform* _transform, uint16_t _num)
  2862. {
  2863. BGFX_CHECK_MAIN_THREAD();
  2864. return s_ctx->allocTransform(_transform, _num);
  2865. }
  2866. void setTransform(uint32_t _cache, uint16_t _num)
  2867. {
  2868. BGFX_CHECK_MAIN_THREAD();
  2869. s_ctx->setTransform(_cache, _num);
  2870. }
  2871. void setUniform(UniformHandle _handle, const void* _value, uint16_t _num)
  2872. {
  2873. BGFX_CHECK_MAIN_THREAD();
  2874. s_ctx->setUniform(_handle, _value, _num);
  2875. }
  2876. void setIndexBuffer(IndexBufferHandle _handle)
  2877. {
  2878. setIndexBuffer(_handle, 0, UINT32_MAX);
  2879. }
  2880. void setIndexBuffer(IndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  2881. {
  2882. BGFX_CHECK_MAIN_THREAD();
  2883. s_ctx->setIndexBuffer(_handle, _firstIndex, _numIndices);
  2884. }
  2885. void setIndexBuffer(DynamicIndexBufferHandle _handle)
  2886. {
  2887. setIndexBuffer(_handle, 0, UINT32_MAX);
  2888. }
  2889. void setIndexBuffer(DynamicIndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  2890. {
  2891. BGFX_CHECK_MAIN_THREAD();
  2892. s_ctx->setIndexBuffer(_handle, _firstIndex, _numIndices);
  2893. }
  2894. void setIndexBuffer(const TransientIndexBuffer* _tib)
  2895. {
  2896. setIndexBuffer(_tib, 0, UINT32_MAX);
  2897. }
  2898. void setIndexBuffer(const TransientIndexBuffer* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  2899. {
  2900. BGFX_CHECK_MAIN_THREAD();
  2901. BX_CHECK(NULL != _tib, "_tib can't be NULL");
  2902. uint32_t numIndices = bx::uint32_min(_numIndices, _tib->size/2);
  2903. s_ctx->setIndexBuffer(_tib, _tib->startIndex + _firstIndex, numIndices);
  2904. }
  2905. void setVertexBuffer(VertexBufferHandle _handle)
  2906. {
  2907. setVertexBuffer(_handle, 0, UINT32_MAX);
  2908. }
  2909. void setVertexBuffer(VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  2910. {
  2911. BGFX_CHECK_MAIN_THREAD();
  2912. s_ctx->setVertexBuffer(0, _handle, _startVertex, _numVertices);
  2913. }
  2914. void setVertexBuffer(DynamicVertexBufferHandle _handle)
  2915. {
  2916. setVertexBuffer(_handle, 0, UINT32_MAX);
  2917. }
  2918. void setVertexBuffer(DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  2919. {
  2920. BGFX_CHECK_MAIN_THREAD();
  2921. s_ctx->setVertexBuffer(0, _handle, _startVertex, _numVertices);
  2922. }
  2923. void setVertexBuffer(const TransientVertexBuffer* _tvb)
  2924. {
  2925. setVertexBuffer(_tvb, 0, UINT32_MAX);
  2926. }
  2927. void setVertexBuffer(const TransientVertexBuffer* _tvb, uint32_t _startVertex, uint32_t _numVertices)
  2928. {
  2929. BGFX_CHECK_MAIN_THREAD();
  2930. BX_CHECK(NULL != _tvb, "_tvb can't be NULL");
  2931. s_ctx->setVertexBuffer(0, _tvb, _startVertex, _numVertices);
  2932. }
  2933. void setInstanceDataBuffer(const InstanceDataBuffer* _idb, uint32_t _num)
  2934. {
  2935. BGFX_CHECK_MAIN_THREAD();
  2936. BX_CHECK(NULL != _idb, "_idb can't be NULL");
  2937. s_ctx->setInstanceDataBuffer(_idb, _num);
  2938. }
  2939. void setInstanceDataBuffer(VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  2940. {
  2941. BGFX_CHECK_MAIN_THREAD();
  2942. s_ctx->setInstanceDataBuffer(_handle, _startVertex, _num);
  2943. }
  2944. void setInstanceDataBuffer(DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  2945. {
  2946. BGFX_CHECK_MAIN_THREAD();
  2947. s_ctx->setInstanceDataBuffer(_handle, _startVertex, _num);
  2948. }
  2949. void setTexture(uint8_t _stage, UniformHandle _sampler, TextureHandle _handle, uint32_t _flags)
  2950. {
  2951. BGFX_CHECK_MAIN_THREAD();
  2952. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2953. s_ctx->setTexture(_stage, _sampler, _handle, _flags);
  2954. }
  2955. void setTexture(uint8_t _stage, UniformHandle _sampler, FrameBufferHandle _handle, uint8_t _attachment, uint32_t _flags)
  2956. {
  2957. BGFX_CHECK_MAIN_THREAD();
  2958. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2959. BX_CHECK(_attachment < g_caps.maxFBAttachments, "Frame buffer attachment index %d is invalid.", _attachment);
  2960. s_ctx->setTexture(_stage, _sampler, _handle, _attachment, _flags);
  2961. }
  2962. uint32_t touch(uint8_t _id)
  2963. {
  2964. ProgramHandle handle = BGFX_INVALID_HANDLE;
  2965. return submit(_id, handle);
  2966. }
  2967. uint32_t submit(uint8_t _id, ProgramHandle _program, int32_t _depth, bool _preserveState)
  2968. {
  2969. OcclusionQueryHandle handle = BGFX_INVALID_HANDLE;
  2970. return submit(_id, _program, handle, _depth, _preserveState);
  2971. }
  2972. uint32_t submit(uint8_t _id, ProgramHandle _program, OcclusionQueryHandle _occlusionQuery, int32_t _depth, bool _preserveState)
  2973. {
  2974. BGFX_CHECK_MAIN_THREAD();
  2975. BX_CHECK(false
  2976. || !isValid(_occlusionQuery)
  2977. || 0 != (g_caps.supported & BGFX_CAPS_OCCLUSION_QUERY)
  2978. , "Occlusion query is not supported! Use bgfx::getCaps to check BGFX_CAPS_OCCLUSION_QUERY backend renderer capabilities."
  2979. );
  2980. return s_ctx->submit(_id, _program, _occlusionQuery, _depth, _preserveState);
  2981. }
  2982. uint32_t submit(uint8_t _id, ProgramHandle _program, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, int32_t _depth, bool _preserveState)
  2983. {
  2984. BGFX_CHECK_MAIN_THREAD();
  2985. return s_ctx->submit(_id, _program, _indirectHandle, _start, _num, _depth, _preserveState);
  2986. }
  2987. void setBuffer(uint8_t _stage, IndexBufferHandle _handle, Access::Enum _access)
  2988. {
  2989. BGFX_CHECK_MAIN_THREAD();
  2990. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2991. s_ctx->setBuffer(_stage, _handle, _access);
  2992. }
  2993. void setBuffer(uint8_t _stage, VertexBufferHandle _handle, Access::Enum _access)
  2994. {
  2995. BGFX_CHECK_MAIN_THREAD();
  2996. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2997. s_ctx->setBuffer(_stage, _handle, _access);
  2998. }
  2999. void setBuffer(uint8_t _stage, DynamicIndexBufferHandle _handle, Access::Enum _access)
  3000. {
  3001. BGFX_CHECK_MAIN_THREAD();
  3002. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  3003. s_ctx->setBuffer(_stage, _handle, _access);
  3004. }
  3005. void setBuffer(uint8_t _stage, DynamicVertexBufferHandle _handle, Access::Enum _access)
  3006. {
  3007. BGFX_CHECK_MAIN_THREAD();
  3008. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  3009. s_ctx->setBuffer(_stage, _handle, _access);
  3010. }
  3011. void setBuffer(uint8_t _stage, IndirectBufferHandle _handle, Access::Enum _access)
  3012. {
  3013. BGFX_CHECK_MAIN_THREAD();
  3014. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  3015. s_ctx->setBuffer(_stage, _handle, _access);
  3016. }
  3017. void setImage(uint8_t _stage, UniformHandle _sampler, TextureHandle _handle, uint8_t _mip, Access::Enum _access, TextureFormat::Enum _format)
  3018. {
  3019. BGFX_CHECK_MAIN_THREAD();
  3020. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  3021. s_ctx->setImage(_stage, _sampler, _handle, _mip, _access, _format);
  3022. }
  3023. void setImage(uint8_t _stage, UniformHandle _sampler, FrameBufferHandle _handle, uint8_t _attachment, Access::Enum _access, TextureFormat::Enum _format)
  3024. {
  3025. BGFX_CHECK_MAIN_THREAD();
  3026. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  3027. BX_CHECK(_attachment < g_caps.maxFBAttachments, "Frame buffer attachment index %d is invalid.", _attachment);
  3028. s_ctx->setImage(_stage, _sampler, _handle, _attachment, _access, _format);
  3029. }
  3030. uint32_t dispatch(uint8_t _id, ProgramHandle _handle, uint16_t _numX, uint16_t _numY, uint16_t _numZ, uint8_t _flags)
  3031. {
  3032. BGFX_CHECK_MAIN_THREAD();
  3033. return s_ctx->dispatch(_id, _handle, _numX, _numY, _numZ, _flags);
  3034. }
  3035. uint32_t dispatch(uint8_t _id, ProgramHandle _handle, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, uint8_t _flags)
  3036. {
  3037. BGFX_CHECK_MAIN_THREAD();
  3038. return s_ctx->dispatch(_id, _handle, _indirectHandle, _start, _num, _flags);
  3039. }
  3040. void discard()
  3041. {
  3042. BGFX_CHECK_MAIN_THREAD();
  3043. s_ctx->discard();
  3044. }
  3045. 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)
  3046. {
  3047. blit(_id, _dst, 0, _dstX, _dstY, 0, _src, 0, _srcX, _srcY, 0, _width, _height, 0);
  3048. }
  3049. void blit(uint8_t _id, TextureHandle _dst, uint16_t _dstX, uint16_t _dstY, FrameBufferHandle _src, uint8_t _attachment, uint16_t _srcX, uint16_t _srcY, uint16_t _width, uint16_t _height)
  3050. {
  3051. blit(_id, _dst, 0, _dstX, _dstY, 0, _src, _attachment, 0, _srcX, _srcY, 0, _width, _height, 0);
  3052. }
  3053. 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)
  3054. {
  3055. BGFX_CHECK_MAIN_THREAD();
  3056. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_BLIT, "Texture blit is not supported!");
  3057. s_ctx->blit(_id, _dst, _dstMip, _dstX, _dstY, _dstZ, _src, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth);
  3058. }
  3059. void blit(uint8_t _id, TextureHandle _dst, uint8_t _dstMip, uint16_t _dstX, uint16_t _dstY, uint16_t _dstZ, FrameBufferHandle _src, uint8_t _attachment, uint8_t _srcMip, uint16_t _srcX, uint16_t _srcY, uint16_t _srcZ, uint16_t _width, uint16_t _height, uint16_t _depth)
  3060. {
  3061. BGFX_CHECK_MAIN_THREAD();
  3062. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_BLIT, "Texture blit is not supported!");
  3063. BX_CHECK(_attachment < g_caps.maxFBAttachments, "Frame buffer attachment index %d is invalid.", _attachment);
  3064. s_ctx->blit(_id, _dst, _dstMip, _dstX, _dstY, _dstZ, _src, _attachment, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth);
  3065. }
  3066. void saveScreenShot(const char* _filePath)
  3067. {
  3068. BGFX_CHECK_MAIN_THREAD();
  3069. s_ctx->saveScreenShot(_filePath);
  3070. }
  3071. } // namespace bgfx
  3072. #include <bgfx/c99/bgfx.h>
  3073. #include <bgfx/c99/bgfxplatform.h>
  3074. #define FLAGS_MASK_TEST(_flags, _mask) ( (_flags) == ( (_flags) & (_mask) ) )
  3075. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3076. | BGFX_TEXTURE_INTERNAL_DEFAULT_SAMPLER
  3077. | BGFX_TEXTURE_INTERNAL_SHARED
  3078. , BGFX_TEXTURE_RESERVED_MASK
  3079. ) );
  3080. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3081. | BGFX_RESET_INTERNAL_FORCE
  3082. , BGFX_RESET_RESERVED_MASK
  3083. ) );
  3084. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3085. | BGFX_STATE_INTERNAL_SCISSOR
  3086. | BGFX_STATE_INTERNAL_OCCLUSION_QUERY
  3087. , BGFX_STATE_RESERVED_MASK
  3088. ) );
  3089. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3090. | BGFX_SUBMIT_INTERNAL_OCCLUSION_VISIBLE
  3091. , BGFX_SUBMIT_RESERVED_MASK
  3092. ) );
  3093. #undef FLAGS_MASK_TEST
  3094. #define BGFX_C99_ENUM_CHECK(_enum, _c99enumcount) \
  3095. BX_STATIC_ASSERT(_enum::Count == _enum::Enum(_c99enumcount) )
  3096. BGFX_C99_ENUM_CHECK(bgfx::Fatal, BGFX_FATAL_COUNT);
  3097. BGFX_C99_ENUM_CHECK(bgfx::RendererType, BGFX_RENDERER_TYPE_COUNT);
  3098. BGFX_C99_ENUM_CHECK(bgfx::Attrib, BGFX_ATTRIB_COUNT);
  3099. BGFX_C99_ENUM_CHECK(bgfx::AttribType, BGFX_ATTRIB_TYPE_COUNT);
  3100. BGFX_C99_ENUM_CHECK(bgfx::TextureFormat, BGFX_TEXTURE_FORMAT_COUNT);
  3101. BGFX_C99_ENUM_CHECK(bgfx::UniformType, BGFX_UNIFORM_TYPE_COUNT);
  3102. BGFX_C99_ENUM_CHECK(bgfx::BackbufferRatio, BGFX_BACKBUFFER_RATIO_COUNT);
  3103. BGFX_C99_ENUM_CHECK(bgfx::OcclusionQueryResult, BGFX_OCCLUSION_QUERY_RESULT_COUNT);
  3104. BGFX_C99_ENUM_CHECK(bgfx::TopologyConvert, BGFX_TOPOLOGY_CONVERT_COUNT);
  3105. BGFX_C99_ENUM_CHECK(bgfx::RenderFrame, BGFX_RENDER_FRAME_COUNT);
  3106. #undef BGFX_C99_ENUM_CHECK
  3107. #define BGFX_C99_STRUCT_SIZE_CHECK(_cppstruct, _c99struct) \
  3108. BX_STATIC_ASSERT(sizeof(_cppstruct) == sizeof(_c99struct) )
  3109. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Memory, bgfx_memory_t);
  3110. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Transform, bgfx_transform_t);
  3111. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::HMD::Eye, bgfx_hmd_eye_t);
  3112. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::HMD, bgfx_hmd_t);
  3113. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Stats, bgfx_stats_t);
  3114. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::VertexDecl, bgfx_vertex_decl_t);
  3115. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TransientIndexBuffer, bgfx_transient_index_buffer_t);
  3116. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TransientVertexBuffer, bgfx_transient_vertex_buffer_t);
  3117. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::InstanceDataBuffer, bgfx_instance_data_buffer_t);
  3118. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TextureInfo, bgfx_texture_info_t);
  3119. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Attachment, bgfx_attachment_t);
  3120. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Caps::GPU, bgfx_caps_gpu_t);
  3121. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Caps, bgfx_caps_t);
  3122. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::PlatformData, bgfx_platform_data_t);
  3123. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::InternalData, bgfx_internal_data_t);
  3124. #undef BGFX_C99_STRUCT_SIZE_CHECK
  3125. namespace bgfx
  3126. {
  3127. struct CallbackC99 : public CallbackI
  3128. {
  3129. virtual ~CallbackC99()
  3130. {
  3131. }
  3132. virtual void fatal(Fatal::Enum _code, const char* _str) BX_OVERRIDE
  3133. {
  3134. m_interface->vtbl->fatal(m_interface, (bgfx_fatal_t)_code, _str);
  3135. }
  3136. virtual void traceVargs(const char* _filePath, uint16_t _line, const char* _format, va_list _argList) BX_OVERRIDE
  3137. {
  3138. m_interface->vtbl->trace_vargs(m_interface, _filePath, _line, _format, _argList);
  3139. }
  3140. virtual uint32_t cacheReadSize(uint64_t _id) BX_OVERRIDE
  3141. {
  3142. return m_interface->vtbl->cache_read_size(m_interface, _id);
  3143. }
  3144. virtual bool cacheRead(uint64_t _id, void* _data, uint32_t _size) BX_OVERRIDE
  3145. {
  3146. return m_interface->vtbl->cache_read(m_interface, _id, _data, _size);
  3147. }
  3148. virtual void cacheWrite(uint64_t _id, const void* _data, uint32_t _size) BX_OVERRIDE
  3149. {
  3150. m_interface->vtbl->cache_write(m_interface, _id, _data, _size);
  3151. }
  3152. virtual void screenShot(const char* _filePath, uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _data, uint32_t _size, bool _yflip) BX_OVERRIDE
  3153. {
  3154. m_interface->vtbl->screen_shot(m_interface, _filePath, _width, _height, _pitch, _data, _size, _yflip);
  3155. }
  3156. virtual void captureBegin(uint32_t _width, uint32_t _height, uint32_t _pitch, TextureFormat::Enum _format, bool _yflip) BX_OVERRIDE
  3157. {
  3158. m_interface->vtbl->capture_begin(m_interface, _width, _height, _pitch, (bgfx_texture_format_t)_format, _yflip);
  3159. }
  3160. virtual void captureEnd() BX_OVERRIDE
  3161. {
  3162. m_interface->vtbl->capture_end(m_interface);
  3163. }
  3164. virtual void captureFrame(const void* _data, uint32_t _size) BX_OVERRIDE
  3165. {
  3166. m_interface->vtbl->capture_frame(m_interface, _data, _size);
  3167. }
  3168. bgfx_callback_interface_t* m_interface;
  3169. };
  3170. class AllocatorC99 : public bx::AllocatorI
  3171. {
  3172. public:
  3173. virtual ~AllocatorC99()
  3174. {
  3175. }
  3176. virtual void* realloc(void* _ptr, size_t _size, size_t _align, const char* _file, uint32_t _line) BX_OVERRIDE
  3177. {
  3178. return m_interface->vtbl->realloc(m_interface, _ptr, _size, _align, _file, _line);
  3179. }
  3180. bgfx_allocator_interface_t* m_interface;
  3181. };
  3182. } // namespace bgfx
  3183. BGFX_C_API void bgfx_vertex_decl_begin(bgfx_vertex_decl_t* _decl, bgfx_renderer_type_t _renderer)
  3184. {
  3185. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3186. decl->begin(bgfx::RendererType::Enum(_renderer) );
  3187. }
  3188. 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)
  3189. {
  3190. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3191. decl->add(bgfx::Attrib::Enum(_attrib)
  3192. , _num
  3193. , bgfx::AttribType::Enum(_type)
  3194. , _normalized
  3195. , _asInt
  3196. );
  3197. }
  3198. BGFX_C_API void bgfx_vertex_decl_skip(bgfx_vertex_decl_t* _decl, uint8_t _num)
  3199. {
  3200. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3201. decl->skip(_num);
  3202. }
  3203. BGFX_C_API void bgfx_vertex_decl_end(bgfx_vertex_decl_t* _decl)
  3204. {
  3205. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3206. decl->end();
  3207. }
  3208. 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)
  3209. {
  3210. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  3211. bgfx::vertexPack(_input, _inputNormalized, bgfx::Attrib::Enum(_attr), decl, _data, _index);
  3212. }
  3213. 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)
  3214. {
  3215. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  3216. bgfx::vertexUnpack(_output, bgfx::Attrib::Enum(_attr), decl, _data, _index);
  3217. }
  3218. 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)
  3219. {
  3220. bgfx::VertexDecl& destDecl = *(bgfx::VertexDecl*)_destDecl;
  3221. bgfx::VertexDecl& srcDecl = *(bgfx::VertexDecl*)_srcDecl;
  3222. bgfx::vertexConvert(destDecl, _destData, srcDecl, _srcData, _num);
  3223. }
  3224. 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)
  3225. {
  3226. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  3227. return bgfx::weldVertices(_output, decl, _data, _num, _epsilon);
  3228. }
  3229. uint32_t bgfx_topology_convert(bgfx_topology_convert_t _conversion, void* _dst, uint32_t _dstSize, const void* _indices, uint32_t _numIndices, bool _index32)
  3230. {
  3231. return bgfx::topologyConvert(bgfx::TopologyConvert::Enum(_conversion), _dst, _dstSize, _indices, _numIndices, _index32);
  3232. }
  3233. 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)
  3234. {
  3235. bgfx::topologySortTriList(bgfx::TopologySort::Enum(_sort), _dst, _dstSize, _dir, _pos, _vertices, _stride, _indices, _numIndices, _index32);
  3236. }
  3237. BGFX_C_API void bgfx_image_swizzle_bgra8(uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _src, void* _dst)
  3238. {
  3239. bgfx::imageSwizzleBgra8(_width, _height, _pitch, _src, _dst);
  3240. }
  3241. BGFX_C_API void bgfx_image_rgba8_downsample_2x2(uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _src, void* _dst)
  3242. {
  3243. bgfx::imageRgba8Downsample2x2(_width, _height, _pitch, _src, _dst);
  3244. }
  3245. BGFX_C_API uint8_t bgfx_get_supported_renderers(bgfx_renderer_type_t _enum[BGFX_RENDERER_TYPE_COUNT])
  3246. {
  3247. return bgfx::getSupportedRenderers( (bgfx::RendererType::Enum*)_enum);
  3248. }
  3249. BGFX_C_API const char* bgfx_get_renderer_name(bgfx_renderer_type_t _type)
  3250. {
  3251. return bgfx::getRendererName(bgfx::RendererType::Enum(_type) );
  3252. }
  3253. 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)
  3254. {
  3255. static bgfx::CallbackC99 s_callback;
  3256. s_callback.m_interface = _callback;
  3257. static bgfx::AllocatorC99 s_allocator;
  3258. s_allocator.m_interface = _allocator;
  3259. return bgfx::init(bgfx::RendererType::Enum(_type)
  3260. , _vendorId
  3261. , _deviceId
  3262. , NULL == _callback ? NULL : &s_callback
  3263. , NULL == _allocator ? NULL : &s_allocator
  3264. );
  3265. }
  3266. BGFX_C_API void bgfx_shutdown()
  3267. {
  3268. return bgfx::shutdown();
  3269. }
  3270. BGFX_C_API void bgfx_reset(uint32_t _width, uint32_t _height, uint32_t _flags)
  3271. {
  3272. bgfx::reset(_width, _height, _flags);
  3273. }
  3274. BGFX_C_API uint32_t bgfx_frame(bool _capture)
  3275. {
  3276. return bgfx::frame(_capture);
  3277. }
  3278. BGFX_C_API bgfx_renderer_type_t bgfx_get_renderer_type()
  3279. {
  3280. return bgfx_renderer_type_t(bgfx::getRendererType() );
  3281. }
  3282. BGFX_C_API const bgfx_caps_t* bgfx_get_caps()
  3283. {
  3284. return (const bgfx_caps_t*)bgfx::getCaps();
  3285. }
  3286. BGFX_C_API const bgfx_hmd_t* bgfx_get_hmd()
  3287. {
  3288. return (const bgfx_hmd_t*)bgfx::getHMD();
  3289. }
  3290. BGFX_C_API const bgfx_stats_t* bgfx_get_stats()
  3291. {
  3292. return (const bgfx_stats_t*)bgfx::getStats();
  3293. }
  3294. BGFX_C_API const bgfx_memory_t* bgfx_alloc(uint32_t _size)
  3295. {
  3296. return (const bgfx_memory_t*)bgfx::alloc(_size);
  3297. }
  3298. BGFX_C_API const bgfx_memory_t* bgfx_copy(const void* _data, uint32_t _size)
  3299. {
  3300. return (const bgfx_memory_t*)bgfx::copy(_data, _size);
  3301. }
  3302. BGFX_C_API const bgfx_memory_t* bgfx_make_ref(const void* _data, uint32_t _size)
  3303. {
  3304. return (const bgfx_memory_t*)bgfx::makeRef(_data, _size);
  3305. }
  3306. BGFX_C_API const bgfx_memory_t* bgfx_make_ref_release(const void* _data, uint32_t _size, bgfx_release_fn_t _releaseFn, void* _userData)
  3307. {
  3308. return (const bgfx_memory_t*)bgfx::makeRef(_data, _size, _releaseFn, _userData);
  3309. }
  3310. BGFX_C_API void bgfx_set_debug(uint32_t _debug)
  3311. {
  3312. bgfx::setDebug(_debug);
  3313. }
  3314. BGFX_C_API void bgfx_dbg_text_clear(uint8_t _attr, bool _small)
  3315. {
  3316. bgfx::dbgTextClear(_attr, _small);
  3317. }
  3318. BGFX_C_API void bgfx_dbg_text_printf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, ...)
  3319. {
  3320. va_list argList;
  3321. va_start(argList, _format);
  3322. bgfx::dbgTextPrintfVargs(_x, _y, _attr, _format, argList);
  3323. va_end(argList);
  3324. }
  3325. BGFX_C_API void bgfx_dbg_text_vprintf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, va_list _argList)
  3326. {
  3327. bgfx::dbgTextPrintfVargs(_x, _y, _attr, _format, _argList);
  3328. }
  3329. 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)
  3330. {
  3331. bgfx::dbgTextImage(_x, _y, _width, _height, _data, _pitch);
  3332. }
  3333. BGFX_C_API bgfx_index_buffer_handle_t bgfx_create_index_buffer(const bgfx_memory_t* _mem, uint16_t _flags)
  3334. {
  3335. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle;
  3336. handle.cpp = bgfx::createIndexBuffer( (const bgfx::Memory*)_mem, _flags);
  3337. return handle.c;
  3338. }
  3339. BGFX_C_API void bgfx_destroy_index_buffer(bgfx_index_buffer_handle_t _handle)
  3340. {
  3341. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  3342. bgfx::destroyIndexBuffer(handle.cpp);
  3343. }
  3344. 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)
  3345. {
  3346. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3347. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle;
  3348. handle.cpp = bgfx::createVertexBuffer( (const bgfx::Memory*)_mem, decl, _flags);
  3349. return handle.c;
  3350. }
  3351. BGFX_C_API void bgfx_destroy_vertex_buffer(bgfx_vertex_buffer_handle_t _handle)
  3352. {
  3353. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  3354. bgfx::destroyVertexBuffer(handle.cpp);
  3355. }
  3356. BGFX_C_API bgfx_dynamic_index_buffer_handle_t bgfx_create_dynamic_index_buffer(uint32_t _num, uint16_t _flags)
  3357. {
  3358. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle;
  3359. handle.cpp = bgfx::createDynamicIndexBuffer(_num, _flags);
  3360. return handle.c;
  3361. }
  3362. BGFX_C_API bgfx_dynamic_index_buffer_handle_t bgfx_create_dynamic_index_buffer_mem(const bgfx_memory_t* _mem, uint16_t _flags)
  3363. {
  3364. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle;
  3365. handle.cpp = bgfx::createDynamicIndexBuffer( (const bgfx::Memory*)_mem, _flags);
  3366. return handle.c;
  3367. }
  3368. BGFX_C_API void bgfx_update_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _startIndex, const bgfx_memory_t* _mem)
  3369. {
  3370. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  3371. bgfx::updateDynamicIndexBuffer(handle.cpp, _startIndex, (const bgfx::Memory*)_mem);
  3372. }
  3373. BGFX_C_API void bgfx_destroy_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle)
  3374. {
  3375. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  3376. bgfx::destroyDynamicIndexBuffer(handle.cpp);
  3377. }
  3378. 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)
  3379. {
  3380. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3381. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle;
  3382. handle.cpp = bgfx::createDynamicVertexBuffer(_num, decl, _flags);
  3383. return handle.c;
  3384. }
  3385. 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)
  3386. {
  3387. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3388. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle;
  3389. handle.cpp = bgfx::createDynamicVertexBuffer( (const bgfx::Memory*)_mem, decl, _flags);
  3390. return handle.c;
  3391. }
  3392. BGFX_C_API void bgfx_update_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, const bgfx_memory_t* _mem)
  3393. {
  3394. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  3395. bgfx::updateDynamicVertexBuffer(handle.cpp, _startVertex, (const bgfx::Memory*)_mem);
  3396. }
  3397. BGFX_C_API void bgfx_destroy_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle)
  3398. {
  3399. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  3400. bgfx::destroyDynamicVertexBuffer(handle.cpp);
  3401. }
  3402. BGFX_C_API bool bgfx_check_avail_transient_index_buffer(uint32_t _num)
  3403. {
  3404. return bgfx::checkAvailTransientIndexBuffer(_num);
  3405. }
  3406. BGFX_C_API bool bgfx_check_avail_transient_vertex_buffer(uint32_t _num, const bgfx_vertex_decl_t* _decl)
  3407. {
  3408. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3409. return bgfx::checkAvailTransientVertexBuffer(_num, decl);
  3410. }
  3411. BGFX_C_API bool bgfx_check_avail_instance_data_buffer(uint32_t _num, uint16_t _stride)
  3412. {
  3413. return bgfx::checkAvailInstanceDataBuffer(_num, _stride);
  3414. }
  3415. BGFX_C_API bool bgfx_check_avail_transient_buffers(uint32_t _numVertices, const bgfx_vertex_decl_t* _decl, uint32_t _numIndices)
  3416. {
  3417. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3418. return bgfx::checkAvailTransientBuffers(_numVertices, decl, _numIndices);
  3419. }
  3420. BGFX_C_API void bgfx_alloc_transient_index_buffer(bgfx_transient_index_buffer_t* _tib, uint32_t _num)
  3421. {
  3422. bgfx::allocTransientIndexBuffer( (bgfx::TransientIndexBuffer*)_tib, _num);
  3423. }
  3424. BGFX_C_API void bgfx_alloc_transient_vertex_buffer(bgfx_transient_vertex_buffer_t* _tvb, uint32_t _num, const bgfx_vertex_decl_t* _decl)
  3425. {
  3426. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3427. bgfx::allocTransientVertexBuffer( (bgfx::TransientVertexBuffer*)_tvb, _num, decl);
  3428. }
  3429. 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)
  3430. {
  3431. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3432. return bgfx::allocTransientBuffers( (bgfx::TransientVertexBuffer*)_tvb, decl, _numVertices, (bgfx::TransientIndexBuffer*)_tib, _numIndices);
  3433. }
  3434. BGFX_C_API const bgfx_instance_data_buffer_t* bgfx_alloc_instance_data_buffer(uint32_t _num, uint16_t _stride)
  3435. {
  3436. return (bgfx_instance_data_buffer_t*)bgfx::allocInstanceDataBuffer(_num, _stride);
  3437. }
  3438. BGFX_C_API bgfx_indirect_buffer_handle_t bgfx_create_indirect_buffer(uint32_t _num)
  3439. {
  3440. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle;
  3441. handle.cpp = bgfx::createIndirectBuffer(_num);
  3442. return handle.c;
  3443. }
  3444. BGFX_C_API void bgfx_destroy_indirect_buffer(bgfx_indirect_buffer_handle_t _handle)
  3445. {
  3446. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle = { _handle };
  3447. bgfx::destroyIndirectBuffer(handle.cpp);
  3448. }
  3449. BGFX_C_API bgfx_shader_handle_t bgfx_create_shader(const bgfx_memory_t* _mem)
  3450. {
  3451. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle;
  3452. handle.cpp = bgfx::createShader( (const bgfx::Memory*)_mem);
  3453. return handle.c;
  3454. }
  3455. BGFX_C_API uint16_t bgfx_get_shader_uniforms(bgfx_shader_handle_t _handle, bgfx_uniform_handle_t* _uniforms, uint16_t _max)
  3456. {
  3457. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle = { _handle };
  3458. return bgfx::getShaderUniforms(handle.cpp, (bgfx::UniformHandle*)_uniforms, _max);
  3459. }
  3460. BGFX_C_API void bgfx_destroy_shader(bgfx_shader_handle_t _handle)
  3461. {
  3462. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle = { _handle };
  3463. bgfx::destroyShader(handle.cpp);
  3464. }
  3465. BGFX_C_API bgfx_program_handle_t bgfx_create_program(bgfx_shader_handle_t _vsh, bgfx_shader_handle_t _fsh, bool _destroyShaders)
  3466. {
  3467. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } vsh = { _vsh };
  3468. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } fsh = { _fsh };
  3469. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle;
  3470. handle.cpp = bgfx::createProgram(vsh.cpp, fsh.cpp, _destroyShaders);
  3471. return handle.c;
  3472. }
  3473. BGFX_C_API bgfx_program_handle_t bgfx_create_compute_program(bgfx_shader_handle_t _csh, bool _destroyShaders)
  3474. {
  3475. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } csh = { _csh };
  3476. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle;
  3477. handle.cpp = bgfx::createProgram(csh.cpp, _destroyShaders);
  3478. return handle.c;
  3479. }
  3480. BGFX_C_API void bgfx_destroy_program(bgfx_program_handle_t _handle)
  3481. {
  3482. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  3483. bgfx::destroyProgram(handle.cpp);
  3484. }
  3485. 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)
  3486. {
  3487. bgfx::TextureInfo& info = *(bgfx::TextureInfo*)_info;
  3488. bgfx::calcTextureSize(info, _width, _height, _depth, _cubeMap, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format) );
  3489. }
  3490. 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)
  3491. {
  3492. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  3493. bgfx::TextureInfo* info = (bgfx::TextureInfo*)_info;
  3494. handle.cpp = bgfx::createTexture( (const bgfx::Memory*)_mem, _flags, _skip, info);
  3495. return handle.c;
  3496. }
  3497. 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)
  3498. {
  3499. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  3500. handle.cpp = bgfx::createTexture2D(_width, _height, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  3501. return handle.c;
  3502. }
  3503. 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)
  3504. {
  3505. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  3506. handle.cpp = bgfx::createTexture2D(bgfx::BackbufferRatio::Enum(_ratio), _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags);
  3507. return handle.c;
  3508. }
  3509. 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)
  3510. {
  3511. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  3512. handle.cpp = bgfx::createTexture3D(_width, _height, _depth, _hasMips, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  3513. return handle.c;
  3514. }
  3515. 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)
  3516. {
  3517. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  3518. handle.cpp = bgfx::createTextureCube(_size, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  3519. return handle.c;
  3520. }
  3521. 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)
  3522. {
  3523. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3524. bgfx::updateTexture2D(handle.cpp, _layer, _mip, _x, _y, _width, _height, (const bgfx::Memory*)_mem, _pitch);
  3525. }
  3526. 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)
  3527. {
  3528. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3529. bgfx::updateTexture3D(handle.cpp, _mip, _x, _y, _z, _width, _height, _depth, (const bgfx::Memory*)_mem);
  3530. }
  3531. 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)
  3532. {
  3533. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3534. bgfx::updateTextureCube(handle.cpp, _layer, _side, _mip, _x, _y, _width, _height, (const bgfx::Memory*)_mem, _pitch);
  3535. }
  3536. BGFX_C_API uint32_t bgfx_read_texture(bgfx_texture_handle_t _handle, void* _data)
  3537. {
  3538. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3539. return bgfx::readTexture(handle.cpp, _data);
  3540. }
  3541. BGFX_C_API uint32_t bgfx_read_frame_buffer(bgfx_frame_buffer_handle_t _handle, uint8_t _attachment, void* _data)
  3542. {
  3543. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  3544. return bgfx::readTexture(handle.cpp, _attachment, _data);
  3545. }
  3546. BGFX_C_API void bgfx_destroy_texture(bgfx_texture_handle_t _handle)
  3547. {
  3548. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3549. bgfx::destroyTexture(handle.cpp);
  3550. }
  3551. 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)
  3552. {
  3553. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  3554. handle.cpp = bgfx::createFrameBuffer(_width, _height, bgfx::TextureFormat::Enum(_format), _textureFlags);
  3555. return handle.c;
  3556. }
  3557. 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)
  3558. {
  3559. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  3560. handle.cpp = bgfx::createFrameBuffer(bgfx::BackbufferRatio::Enum(_ratio), bgfx::TextureFormat::Enum(_format), _textureFlags);
  3561. return handle.c;
  3562. }
  3563. 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)
  3564. {
  3565. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  3566. handle.cpp = bgfx::createFrameBuffer(_num, (const bgfx::TextureHandle*)_handles, _destroyTextures);
  3567. return handle.c;
  3568. }
  3569. BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_from_attachment(uint8_t _num, const bgfx_attachment_t* _attachment, bool _destroyTextures)
  3570. {
  3571. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  3572. handle.cpp = bgfx::createFrameBuffer(_num, (const bgfx::Attachment*)_attachment, _destroyTextures);
  3573. return handle.c;
  3574. }
  3575. 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)
  3576. {
  3577. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  3578. handle.cpp = bgfx::createFrameBuffer(_nwh, _width, _height, bgfx::TextureFormat::Enum(_depthFormat) );
  3579. return handle.c;
  3580. }
  3581. BGFX_C_API void bgfx_destroy_frame_buffer(bgfx_frame_buffer_handle_t _handle)
  3582. {
  3583. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  3584. bgfx::destroyFrameBuffer(handle.cpp);
  3585. }
  3586. BGFX_C_API bgfx_uniform_handle_t bgfx_create_uniform(const char* _name, bgfx_uniform_type_t _type, uint16_t _num)
  3587. {
  3588. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle;
  3589. handle.cpp = bgfx::createUniform(_name, bgfx::UniformType::Enum(_type), _num);
  3590. return handle.c;
  3591. }
  3592. BGFX_C_API void bgfx_destroy_uniform(bgfx_uniform_handle_t _handle)
  3593. {
  3594. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  3595. bgfx::destroyUniform(handle.cpp);
  3596. }
  3597. BGFX_C_API bgfx_occlusion_query_handle_t bgfx_create_occlusion_query()
  3598. {
  3599. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle;
  3600. handle.cpp = bgfx::createOcclusionQuery();
  3601. return handle.c;
  3602. }
  3603. BGFX_C_API bgfx_occlusion_query_result_t bgfx_get_result(bgfx_occlusion_query_handle_t _handle)
  3604. {
  3605. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  3606. return bgfx_occlusion_query_result_t(bgfx::getResult(handle.cpp) );
  3607. }
  3608. BGFX_C_API void bgfx_destroy_occlusion_query(bgfx_occlusion_query_handle_t _handle)
  3609. {
  3610. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  3611. bgfx::destroyOcclusionQuery(handle.cpp);
  3612. }
  3613. BGFX_C_API void bgfx_set_palette_color(uint8_t _index, const float _rgba[4])
  3614. {
  3615. bgfx::setPaletteColor(_index, _rgba);
  3616. }
  3617. BGFX_C_API void bgfx_set_view_name(uint8_t _id, const char* _name)
  3618. {
  3619. bgfx::setViewName(_id, _name);
  3620. }
  3621. BGFX_C_API void bgfx_set_view_rect(uint8_t _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3622. {
  3623. bgfx::setViewRect(_id, _x, _y, _width, _height);
  3624. }
  3625. BGFX_C_API void bgfx_set_view_rect_auto(uint8_t _id, uint16_t _x, uint16_t _y, bgfx_backbuffer_ratio_t _ratio)
  3626. {
  3627. bgfx::setViewRect(_id, _x, _y, bgfx::BackbufferRatio::Enum(_ratio));
  3628. }
  3629. BGFX_C_API void bgfx_set_view_scissor(uint8_t _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3630. {
  3631. bgfx::setViewScissor(_id, _x, _y, _width, _height);
  3632. }
  3633. BGFX_C_API void bgfx_set_view_clear(uint8_t _id, uint16_t _flags, uint32_t _rgba, float _depth, uint8_t _stencil)
  3634. {
  3635. bgfx::setViewClear(_id, _flags, _rgba, _depth, _stencil);
  3636. }
  3637. 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)
  3638. {
  3639. bgfx::setViewClear(_id, _flags, _depth, _stencil, _0, _1, _2, _3, _4, _5, _6, _7);
  3640. }
  3641. BGFX_C_API void bgfx_set_view_seq(uint8_t _id, bool _enabled)
  3642. {
  3643. bgfx::setViewSeq(_id, _enabled);
  3644. }
  3645. BGFX_C_API void bgfx_set_view_frame_buffer(uint8_t _id, bgfx_frame_buffer_handle_t _handle)
  3646. {
  3647. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  3648. bgfx::setViewFrameBuffer(_id, handle.cpp);
  3649. }
  3650. BGFX_C_API void bgfx_set_view_transform(uint8_t _id, const void* _view, const void* _proj)
  3651. {
  3652. bgfx::setViewTransform(_id, _view, _proj);
  3653. }
  3654. BGFX_C_API void bgfx_set_view_transform_stereo(uint8_t _id, const void* _view, const void* _projL, uint8_t _flags, const void* _projR)
  3655. {
  3656. bgfx::setViewTransform(_id, _view, _projL, _flags, _projR);
  3657. }
  3658. BGFX_C_API void bgfx_set_view_remap(uint8_t _id, uint8_t _num, const void* _remap)
  3659. {
  3660. bgfx::setViewRemap(_id, _num, _remap);
  3661. }
  3662. BGFX_C_API void bgfx_reset_view(uint8_t _id)
  3663. {
  3664. bgfx::resetView(_id);
  3665. }
  3666. BGFX_C_API void bgfx_set_marker(const char* _marker)
  3667. {
  3668. bgfx::setMarker(_marker);
  3669. }
  3670. BGFX_C_API void bgfx_set_state(uint64_t _state, uint32_t _rgba)
  3671. {
  3672. bgfx::setState(_state, _rgba);
  3673. }
  3674. BGFX_C_API void bgfx_set_condition(bgfx_occlusion_query_handle_t _handle, bool _visible)
  3675. {
  3676. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  3677. bgfx::setCondition(handle.cpp, _visible);
  3678. }
  3679. BGFX_C_API void bgfx_set_stencil(uint32_t _fstencil, uint32_t _bstencil)
  3680. {
  3681. bgfx::setStencil(_fstencil, _bstencil);
  3682. }
  3683. BGFX_C_API uint16_t bgfx_set_scissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3684. {
  3685. return bgfx::setScissor(_x, _y, _width, _height);
  3686. }
  3687. BGFX_C_API void bgfx_set_scissor_cached(uint16_t _cache)
  3688. {
  3689. bgfx::setScissor(_cache);
  3690. }
  3691. BGFX_C_API uint32_t bgfx_set_transform(const void* _mtx, uint16_t _num)
  3692. {
  3693. return bgfx::setTransform(_mtx, _num);
  3694. }
  3695. BGFX_C_API uint32_t bgfx_alloc_transform(bgfx_transform_t* _transform, uint16_t _num)
  3696. {
  3697. return bgfx::allocTransform( (bgfx::Transform*)_transform, _num);
  3698. }
  3699. BGFX_C_API void bgfx_set_transform_cached(uint32_t _cache, uint16_t _num)
  3700. {
  3701. bgfx::setTransform(_cache, _num);
  3702. }
  3703. BGFX_C_API void bgfx_set_uniform(bgfx_uniform_handle_t _handle, const void* _value, uint16_t _num)
  3704. {
  3705. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  3706. bgfx::setUniform(handle.cpp, _value, _num);
  3707. }
  3708. BGFX_C_API void bgfx_set_index_buffer(bgfx_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  3709. {
  3710. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  3711. bgfx::setIndexBuffer(handle.cpp, _firstIndex, _numIndices);
  3712. }
  3713. BGFX_C_API void bgfx_set_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  3714. {
  3715. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  3716. bgfx::setIndexBuffer(handle.cpp, _firstIndex, _numIndices);
  3717. }
  3718. BGFX_C_API void bgfx_set_transient_index_buffer(const bgfx_transient_index_buffer_t* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  3719. {
  3720. bgfx::setIndexBuffer( (const bgfx::TransientIndexBuffer*)_tib, _firstIndex, _numIndices);
  3721. }
  3722. BGFX_C_API void bgfx_set_vertex_buffer(bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _numVertices)
  3723. {
  3724. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  3725. bgfx::setVertexBuffer(handle.cpp, _startVertex, _numVertices);
  3726. }
  3727. BGFX_C_API void bgfx_set_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _numVertices)
  3728. {
  3729. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  3730. bgfx::setVertexBuffer(handle.cpp, _startVertex, _numVertices);
  3731. }
  3732. BGFX_C_API void bgfx_set_transient_vertex_buffer(const bgfx_transient_vertex_buffer_t* _tvb, uint32_t _startVertex, uint32_t _numVertices)
  3733. {
  3734. bgfx::setVertexBuffer( (const bgfx::TransientVertexBuffer*)_tvb, _startVertex, _numVertices);
  3735. }
  3736. BGFX_C_API void bgfx_set_instance_data_buffer(const bgfx_instance_data_buffer_t* _idb, uint32_t _num)
  3737. {
  3738. bgfx::setInstanceDataBuffer( (const bgfx::InstanceDataBuffer*)_idb, _num);
  3739. }
  3740. BGFX_C_API void bgfx_set_instance_data_from_vertex_buffer(bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _num)
  3741. {
  3742. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  3743. bgfx::setInstanceDataBuffer(handle.cpp, _startVertex, _num);
  3744. }
  3745. 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)
  3746. {
  3747. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  3748. bgfx::setInstanceDataBuffer(handle.cpp, _startVertex, _num);
  3749. }
  3750. BGFX_C_API void bgfx_set_texture(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_texture_handle_t _handle, uint32_t _flags)
  3751. {
  3752. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  3753. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3754. bgfx::setTexture(_stage, sampler.cpp, handle.cpp, _flags);
  3755. }
  3756. BGFX_C_API void bgfx_set_texture_from_frame_buffer(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_frame_buffer_handle_t _handle, uint8_t _attachment, uint32_t _flags)
  3757. {
  3758. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  3759. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  3760. bgfx::setTexture(_stage, sampler.cpp, handle.cpp, _attachment, _flags);
  3761. }
  3762. BGFX_C_API uint32_t bgfx_touch(uint8_t _id)
  3763. {
  3764. return bgfx::touch(_id);
  3765. }
  3766. BGFX_C_API uint32_t bgfx_submit(uint8_t _id, bgfx_program_handle_t _handle, int32_t _depth, bool _preserveState)
  3767. {
  3768. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  3769. return bgfx::submit(_id, handle.cpp, _depth, _preserveState);
  3770. }
  3771. 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)
  3772. {
  3773. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } program = { _program };
  3774. union { bgfx_occlusion_query_handle c; bgfx::OcclusionQueryHandle cpp; } occlusionQuery = { _occlusionQuery };
  3775. return bgfx::submit(_id, program.cpp, occlusionQuery.cpp, _depth, _preserveState);
  3776. }
  3777. 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)
  3778. {
  3779. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  3780. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  3781. return bgfx::submit(_id, handle.cpp, indirectHandle.cpp, _start, _num, _depth, _preserveState);
  3782. }
  3783. 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)
  3784. {
  3785. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  3786. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3787. bgfx::setImage(_stage, sampler.cpp, handle.cpp, _mip, bgfx::Access::Enum(_access), bgfx::TextureFormat::Enum(_format) );
  3788. }
  3789. BGFX_C_API void bgfx_set_image_from_frame_buffer(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_frame_buffer_handle_t _handle, uint8_t _attachment, bgfx_access_t _access, bgfx_texture_format_t _format)
  3790. {
  3791. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  3792. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  3793. bgfx::setImage(_stage, sampler.cpp, handle.cpp, _attachment, bgfx::Access::Enum(_access), bgfx::TextureFormat::Enum(_format) );
  3794. }
  3795. BGFX_C_API void bgfx_set_compute_index_buffer(uint8_t _stage, bgfx_index_buffer_handle_t _handle, bgfx_access_t _access)
  3796. {
  3797. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  3798. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  3799. }
  3800. BGFX_C_API void bgfx_set_compute_vertex_buffer(uint8_t _stage, bgfx_vertex_buffer_handle_t _handle, bgfx_access_t _access)
  3801. {
  3802. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  3803. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  3804. }
  3805. BGFX_C_API void bgfx_set_compute_dynamic_index_buffer(uint8_t _stage, bgfx_dynamic_index_buffer_handle_t _handle, bgfx_access_t _access)
  3806. {
  3807. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  3808. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  3809. }
  3810. BGFX_C_API void bgfx_set_compute_dynamic_vertex_buffer(uint8_t _stage, bgfx_dynamic_vertex_buffer_handle_t _handle, bgfx_access_t _access)
  3811. {
  3812. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  3813. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  3814. }
  3815. BGFX_C_API void bgfx_set_compute_indirect_buffer(uint8_t _stage, bgfx_indirect_buffer_handle_t _handle, bgfx_access_t _access)
  3816. {
  3817. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle = { _handle };
  3818. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  3819. }
  3820. BGFX_C_API uint32_t bgfx_dispatch(uint8_t _id, bgfx_program_handle_t _handle, uint16_t _numX, uint16_t _numY, uint16_t _numZ, uint8_t _flags)
  3821. {
  3822. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  3823. return bgfx::dispatch(_id, handle.cpp, _numX, _numY, _numZ, _flags);
  3824. }
  3825. 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)
  3826. {
  3827. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  3828. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  3829. return bgfx::dispatch(_id, handle.cpp, indirectHandle.cpp, _start, _num, _flags);
  3830. }
  3831. BGFX_C_API void bgfx_discard()
  3832. {
  3833. bgfx::discard();
  3834. }
  3835. 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)
  3836. {
  3837. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } dst = { _dst };
  3838. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } src = { _src };
  3839. bgfx::blit(_id, dst.cpp, _dstMip, _dstX, _dstY, _dstZ, src.cpp, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth);
  3840. }
  3841. BGFX_C_API void bgfx_blit_frame_buffer(uint8_t _id, bgfx_texture_handle_t _dst, uint8_t _dstMip, uint16_t _dstX, uint16_t _dstY, uint16_t _dstZ, bgfx_frame_buffer_handle_t _src, uint8_t _attachment, uint8_t _srcMip, uint16_t _srcX, uint16_t _srcY, uint16_t _srcZ, uint16_t _width, uint16_t _height, uint16_t _depth)
  3842. {
  3843. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } dst = { _dst };
  3844. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } src = { _src };
  3845. bgfx::blit(_id, dst.cpp, _dstMip, _dstX, _dstY, _dstZ, src.cpp, _attachment, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth);
  3846. }
  3847. BGFX_C_API void bgfx_save_screen_shot(const char* _filePath)
  3848. {
  3849. bgfx::saveScreenShot(_filePath);
  3850. }
  3851. BGFX_C_API bgfx_render_frame_t bgfx_render_frame()
  3852. {
  3853. return bgfx_render_frame_t(bgfx::renderFrame() );
  3854. }
  3855. BGFX_C_API void bgfx_set_platform_data(const bgfx_platform_data_t* _data)
  3856. {
  3857. bgfx::setPlatformData(*(const bgfx::PlatformData*)_data);
  3858. }
  3859. BGFX_C_API const bgfx_internal_data_t* bgfx_get_internal_data()
  3860. {
  3861. return (const bgfx_internal_data_t*)bgfx::getInternalData();
  3862. }
  3863. BGFX_C_API uintptr_t bgfx_override_internal_texture_ptr(bgfx_texture_handle_t _handle, uintptr_t _ptr)
  3864. {
  3865. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3866. return bgfx::overrideInternal(handle.cpp, _ptr);
  3867. }
  3868. 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)
  3869. {
  3870. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  3871. return bgfx::overrideInternal(handle.cpp, _width, _height, _numMips, bgfx::TextureFormat::Enum(_format), _flags);
  3872. }
  3873. BGFX_C_API bgfx_interface_vtbl_t* bgfx_get_interface(uint32_t _version)
  3874. {
  3875. if (_version == BGFX_API_VERSION)
  3876. {
  3877. #define BGFX_IMPORT \
  3878. BGFX_IMPORT_FUNC(render_frame) \
  3879. BGFX_IMPORT_FUNC(set_platform_data) \
  3880. BGFX_IMPORT_FUNC(get_internal_data) \
  3881. BGFX_IMPORT_FUNC(override_internal_texture_ptr) \
  3882. BGFX_IMPORT_FUNC(override_internal_texture) \
  3883. BGFX_IMPORT_FUNC(vertex_decl_begin) \
  3884. BGFX_IMPORT_FUNC(vertex_decl_add) \
  3885. BGFX_IMPORT_FUNC(vertex_decl_skip) \
  3886. BGFX_IMPORT_FUNC(vertex_decl_end) \
  3887. BGFX_IMPORT_FUNC(vertex_pack) \
  3888. BGFX_IMPORT_FUNC(vertex_unpack) \
  3889. BGFX_IMPORT_FUNC(vertex_convert) \
  3890. BGFX_IMPORT_FUNC(weld_vertices) \
  3891. BGFX_IMPORT_FUNC(topology_convert) \
  3892. BGFX_IMPORT_FUNC(topology_sort_tri_list) \
  3893. BGFX_IMPORT_FUNC(image_swizzle_bgra8) \
  3894. BGFX_IMPORT_FUNC(image_rgba8_downsample_2x2) \
  3895. BGFX_IMPORT_FUNC(get_supported_renderers) \
  3896. BGFX_IMPORT_FUNC(get_renderer_name) \
  3897. BGFX_IMPORT_FUNC(init) \
  3898. BGFX_IMPORT_FUNC(shutdown) \
  3899. BGFX_IMPORT_FUNC(reset) \
  3900. BGFX_IMPORT_FUNC(frame) \
  3901. BGFX_IMPORT_FUNC(get_renderer_type) \
  3902. BGFX_IMPORT_FUNC(get_caps) \
  3903. BGFX_IMPORT_FUNC(get_hmd) \
  3904. BGFX_IMPORT_FUNC(get_stats) \
  3905. BGFX_IMPORT_FUNC(alloc) \
  3906. BGFX_IMPORT_FUNC(copy) \
  3907. BGFX_IMPORT_FUNC(make_ref) \
  3908. BGFX_IMPORT_FUNC(make_ref_release) \
  3909. BGFX_IMPORT_FUNC(set_debug) \
  3910. BGFX_IMPORT_FUNC(dbg_text_clear) \
  3911. BGFX_IMPORT_FUNC(dbg_text_printf) \
  3912. BGFX_IMPORT_FUNC(dbg_text_vprintf) \
  3913. BGFX_IMPORT_FUNC(dbg_text_image) \
  3914. BGFX_IMPORT_FUNC(create_index_buffer) \
  3915. BGFX_IMPORT_FUNC(destroy_index_buffer) \
  3916. BGFX_IMPORT_FUNC(create_vertex_buffer) \
  3917. BGFX_IMPORT_FUNC(destroy_vertex_buffer) \
  3918. BGFX_IMPORT_FUNC(create_dynamic_index_buffer) \
  3919. BGFX_IMPORT_FUNC(create_dynamic_index_buffer_mem) \
  3920. BGFX_IMPORT_FUNC(update_dynamic_index_buffer) \
  3921. BGFX_IMPORT_FUNC(destroy_dynamic_index_buffer) \
  3922. BGFX_IMPORT_FUNC(create_dynamic_vertex_buffer) \
  3923. BGFX_IMPORT_FUNC(create_dynamic_vertex_buffer_mem) \
  3924. BGFX_IMPORT_FUNC(update_dynamic_vertex_buffer) \
  3925. BGFX_IMPORT_FUNC(destroy_dynamic_vertex_buffer) \
  3926. BGFX_IMPORT_FUNC(check_avail_transient_index_buffer) \
  3927. BGFX_IMPORT_FUNC(check_avail_transient_vertex_buffer) \
  3928. BGFX_IMPORT_FUNC(check_avail_instance_data_buffer) \
  3929. BGFX_IMPORT_FUNC(check_avail_transient_buffers) \
  3930. BGFX_IMPORT_FUNC(alloc_transient_index_buffer) \
  3931. BGFX_IMPORT_FUNC(alloc_transient_vertex_buffer) \
  3932. BGFX_IMPORT_FUNC(alloc_transient_buffers) \
  3933. BGFX_IMPORT_FUNC(alloc_instance_data_buffer) \
  3934. BGFX_IMPORT_FUNC(create_indirect_buffer) \
  3935. BGFX_IMPORT_FUNC(destroy_indirect_buffer) \
  3936. BGFX_IMPORT_FUNC(create_shader) \
  3937. BGFX_IMPORT_FUNC(get_shader_uniforms) \
  3938. BGFX_IMPORT_FUNC(destroy_shader) \
  3939. BGFX_IMPORT_FUNC(create_program) \
  3940. BGFX_IMPORT_FUNC(create_compute_program) \
  3941. BGFX_IMPORT_FUNC(destroy_program) \
  3942. BGFX_IMPORT_FUNC(calc_texture_size) \
  3943. BGFX_IMPORT_FUNC(create_texture) \
  3944. BGFX_IMPORT_FUNC(create_texture_2d) \
  3945. BGFX_IMPORT_FUNC(create_texture_2d_scaled) \
  3946. BGFX_IMPORT_FUNC(create_texture_3d) \
  3947. BGFX_IMPORT_FUNC(create_texture_cube) \
  3948. BGFX_IMPORT_FUNC(update_texture_2d) \
  3949. BGFX_IMPORT_FUNC(update_texture_3d) \
  3950. BGFX_IMPORT_FUNC(update_texture_cube) \
  3951. BGFX_IMPORT_FUNC(destroy_texture) \
  3952. BGFX_IMPORT_FUNC(create_frame_buffer) \
  3953. BGFX_IMPORT_FUNC(create_frame_buffer_scaled) \
  3954. BGFX_IMPORT_FUNC(create_frame_buffer_from_attachment) \
  3955. BGFX_IMPORT_FUNC(create_frame_buffer_from_nwh) \
  3956. BGFX_IMPORT_FUNC(destroy_frame_buffer) \
  3957. BGFX_IMPORT_FUNC(create_uniform) \
  3958. BGFX_IMPORT_FUNC(destroy_uniform) \
  3959. BGFX_IMPORT_FUNC(create_occlusion_query) \
  3960. BGFX_IMPORT_FUNC(get_result) \
  3961. BGFX_IMPORT_FUNC(destroy_occlusion_query) \
  3962. BGFX_IMPORT_FUNC(set_palette_color) \
  3963. BGFX_IMPORT_FUNC(set_view_name) \
  3964. BGFX_IMPORT_FUNC(set_view_rect) \
  3965. BGFX_IMPORT_FUNC(set_view_scissor) \
  3966. BGFX_IMPORT_FUNC(set_view_clear) \
  3967. BGFX_IMPORT_FUNC(set_view_clear_mrt) \
  3968. BGFX_IMPORT_FUNC(set_view_seq) \
  3969. BGFX_IMPORT_FUNC(set_view_frame_buffer) \
  3970. BGFX_IMPORT_FUNC(set_view_transform) \
  3971. BGFX_IMPORT_FUNC(set_view_transform_stereo) \
  3972. BGFX_IMPORT_FUNC(set_view_remap) \
  3973. BGFX_IMPORT_FUNC(set_marker) \
  3974. BGFX_IMPORT_FUNC(set_state) \
  3975. BGFX_IMPORT_FUNC(set_condition) \
  3976. BGFX_IMPORT_FUNC(set_stencil) \
  3977. BGFX_IMPORT_FUNC(set_scissor) \
  3978. BGFX_IMPORT_FUNC(set_scissor_cached) \
  3979. BGFX_IMPORT_FUNC(set_transform) \
  3980. BGFX_IMPORT_FUNC(alloc_transform) \
  3981. BGFX_IMPORT_FUNC(set_transform_cached) \
  3982. BGFX_IMPORT_FUNC(set_uniform) \
  3983. BGFX_IMPORT_FUNC(set_index_buffer) \
  3984. BGFX_IMPORT_FUNC(set_dynamic_index_buffer) \
  3985. BGFX_IMPORT_FUNC(set_transient_index_buffer) \
  3986. BGFX_IMPORT_FUNC(set_vertex_buffer) \
  3987. BGFX_IMPORT_FUNC(set_dynamic_vertex_buffer) \
  3988. BGFX_IMPORT_FUNC(set_transient_vertex_buffer) \
  3989. BGFX_IMPORT_FUNC(set_instance_data_buffer) \
  3990. BGFX_IMPORT_FUNC(set_instance_data_from_vertex_buffer) \
  3991. BGFX_IMPORT_FUNC(set_instance_data_from_dynamic_vertex_buffer) \
  3992. BGFX_IMPORT_FUNC(set_texture) \
  3993. BGFX_IMPORT_FUNC(set_texture_from_frame_buffer) \
  3994. BGFX_IMPORT_FUNC(touch) \
  3995. BGFX_IMPORT_FUNC(submit) \
  3996. BGFX_IMPORT_FUNC(submit_occlusion_query) \
  3997. BGFX_IMPORT_FUNC(submit_indirect) \
  3998. BGFX_IMPORT_FUNC(set_image) \
  3999. BGFX_IMPORT_FUNC(set_image_from_frame_buffer) \
  4000. BGFX_IMPORT_FUNC(set_compute_index_buffer) \
  4001. BGFX_IMPORT_FUNC(set_compute_vertex_buffer) \
  4002. BGFX_IMPORT_FUNC(set_compute_dynamic_index_buffer) \
  4003. BGFX_IMPORT_FUNC(set_compute_dynamic_vertex_buffer) \
  4004. BGFX_IMPORT_FUNC(set_compute_indirect_buffer) \
  4005. BGFX_IMPORT_FUNC(dispatch) \
  4006. BGFX_IMPORT_FUNC(dispatch_indirect) \
  4007. BGFX_IMPORT_FUNC(discard) \
  4008. BGFX_IMPORT_FUNC(blit) \
  4009. BGFX_IMPORT_FUNC(save_screen_shot)
  4010. static bgfx_interface_vtbl_t s_bgfx_interface =
  4011. {
  4012. #define BGFX_IMPORT_FUNC(_name) bgfx_##_name,
  4013. BGFX_IMPORT
  4014. #undef BGFX_IMPORT_FUNC
  4015. };
  4016. return &s_bgfx_interface;
  4017. }
  4018. return NULL;
  4019. }