bgfx.cpp 122 KB

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