bgfx.cpp 145 KB

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