bgfx.cpp 180 KB

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