bgfx.cpp 154 KB

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