bgfx.cpp 146 KB

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