bgfx.cpp 148 KB

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