bgfx.cpp 180 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743
  1. /*
  2. * Copyright 2011-2017 Branimir Karadzic. All rights reserved.
  3. * License: https://github.com/bkaradzic/bgfx#license-bsd-2-clause
  4. */
  5. #include <bx/platform.h>
  6. #include "bgfx_p.h"
  7. #include <bgfx/embedded_shader.h>
  8. #include <bx/file.h>
  9. #include <bx/mutex.h>
  10. #include "topology.h"
  11. BX_ERROR_RESULT(BGFX_ERROR_TEXTURE_VALIDATION, BX_MAKEFOURCC('b', 'g', 0, 1) );
  12. namespace bgfx
  13. {
  14. #define BGFX_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. m_submit->finish();
  1499. bx::xchg(m_render, m_submit);
  1500. bx::memCopy(m_render->m_occlusion, m_submit->m_occlusion, sizeof(m_submit->m_occlusion) );
  1501. if (!BX_ENABLED(BGFX_CONFIG_MULTITHREADED)
  1502. || m_singleThreaded)
  1503. {
  1504. renderFrame();
  1505. }
  1506. m_frames++;
  1507. m_submit->start();
  1508. bx::memSet(m_seq, 0, sizeof(m_seq) );
  1509. freeAllHandles(m_submit);
  1510. m_submit->resetFreeHandles();
  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. RendererContextI* rendererCreate(RendererType::Enum _type);
  1520. void rendererDestroy(RendererContextI* _renderCtx);
  1521. void Context::flip()
  1522. {
  1523. if (m_rendererInitialized
  1524. && !m_flipped)
  1525. {
  1526. m_renderCtx->flip(m_render->m_hmd);
  1527. m_flipped = true;
  1528. if (m_renderCtx->isDeviceRemoved() )
  1529. {
  1530. // Something horribly went wrong, fallback to noop renderer.
  1531. rendererDestroy(m_renderCtx);
  1532. m_renderCtx = rendererCreate(RendererType::Noop);
  1533. g_caps.rendererType = RendererType::Noop;
  1534. }
  1535. }
  1536. }
  1537. RenderFrame::Enum Context::renderFrame(int32_t _msecs)
  1538. {
  1539. BGFX_PROFILER_SCOPE("bgfx::renderFrame", 0xff2040ff);
  1540. if (!m_flipAfterRender)
  1541. {
  1542. BGFX_PROFILER_SCOPE("bgfx/flip", 0xff2040ff);
  1543. flip();
  1544. }
  1545. if (apiSemWait(_msecs) )
  1546. {
  1547. {
  1548. BGFX_PROFILER_SCOPE("bgfx/Exec commands pre", 0xff2040ff);
  1549. rendererExecCommands(m_render->m_cmdPre);
  1550. }
  1551. if (m_rendererInitialized)
  1552. {
  1553. BGFX_PROFILER_SCOPE("bgfx/Render submit", 0xff2040ff);
  1554. m_renderCtx->submit(m_render, m_clearQuad, m_textVideoMemBlitter);
  1555. m_flipped = false;
  1556. }
  1557. {
  1558. BGFX_PROFILER_SCOPE("bgfx/Exec commands post", 0xff2040ff);
  1559. rendererExecCommands(m_render->m_cmdPost);
  1560. }
  1561. renderSemPost();
  1562. if (m_flipAfterRender)
  1563. {
  1564. BGFX_PROFILER_SCOPE("bgfx/flip", 0xff2040ff);
  1565. flip();
  1566. }
  1567. }
  1568. else
  1569. {
  1570. return RenderFrame::Timeout;
  1571. }
  1572. return m_exit
  1573. ? RenderFrame::Exiting
  1574. : RenderFrame::Render
  1575. ;
  1576. }
  1577. void rendererUpdateUniforms(RendererContextI* _renderCtx, UniformBuffer* _uniformBuffer, uint32_t _begin, uint32_t _end)
  1578. {
  1579. _uniformBuffer->reset(_begin);
  1580. while (_uniformBuffer->getPos() < _end)
  1581. {
  1582. uint32_t opcode = _uniformBuffer->read();
  1583. if (UniformType::End == opcode)
  1584. {
  1585. break;
  1586. }
  1587. UniformType::Enum type;
  1588. uint16_t loc;
  1589. uint16_t num;
  1590. uint16_t copy;
  1591. UniformBuffer::decodeOpcode(opcode, type, loc, num, copy);
  1592. uint32_t size = g_uniformTypeSize[type]*num;
  1593. const char* data = _uniformBuffer->read(size);
  1594. if (UniformType::Count > type)
  1595. {
  1596. if (copy)
  1597. {
  1598. _renderCtx->updateUniform(loc, data, size);
  1599. }
  1600. else
  1601. {
  1602. _renderCtx->updateUniform(loc, *(const char**)(data), size);
  1603. }
  1604. }
  1605. else
  1606. {
  1607. _renderCtx->setMarker(data, size);
  1608. }
  1609. }
  1610. }
  1611. void Context::flushTextureUpdateBatch(CommandBuffer& _cmdbuf)
  1612. {
  1613. if (m_textureUpdateBatch.sort() )
  1614. {
  1615. const uint32_t pos = _cmdbuf.m_pos;
  1616. uint32_t currentKey = UINT32_MAX;
  1617. for (uint32_t ii = 0, num = m_textureUpdateBatch.m_num; ii < num; ++ii)
  1618. {
  1619. _cmdbuf.m_pos = m_textureUpdateBatch.m_values[ii];
  1620. TextureHandle handle;
  1621. _cmdbuf.read(handle);
  1622. uint8_t side;
  1623. _cmdbuf.read(side);
  1624. uint8_t mip;
  1625. _cmdbuf.read(mip);
  1626. Rect rect;
  1627. _cmdbuf.read(rect);
  1628. uint16_t zz;
  1629. _cmdbuf.read(zz);
  1630. uint16_t depth;
  1631. _cmdbuf.read(depth);
  1632. uint16_t pitch;
  1633. _cmdbuf.read(pitch);
  1634. Memory* mem;
  1635. _cmdbuf.read(mem);
  1636. uint32_t key = m_textureUpdateBatch.m_keys[ii];
  1637. if (key != currentKey)
  1638. {
  1639. if (currentKey != UINT32_MAX)
  1640. {
  1641. m_renderCtx->updateTextureEnd();
  1642. }
  1643. currentKey = key;
  1644. m_renderCtx->updateTextureBegin(handle, side, mip);
  1645. }
  1646. m_renderCtx->updateTexture(handle, side, mip, rect, zz, depth, pitch, mem);
  1647. release(mem);
  1648. }
  1649. if (currentKey != UINT32_MAX)
  1650. {
  1651. m_renderCtx->updateTextureEnd();
  1652. }
  1653. m_textureUpdateBatch.reset();
  1654. _cmdbuf.m_pos = pos;
  1655. }
  1656. }
  1657. typedef RendererContextI* (*RendererCreateFn)();
  1658. typedef void (*RendererDestroyFn)();
  1659. #define BGFX_RENDERER_CONTEXT(_namespace) \
  1660. namespace _namespace \
  1661. { \
  1662. extern RendererContextI* rendererCreate(); \
  1663. extern void rendererDestroy(); \
  1664. }
  1665. BGFX_RENDERER_CONTEXT(noop);
  1666. BGFX_RENDERER_CONTEXT(d3d9);
  1667. BGFX_RENDERER_CONTEXT(d3d11);
  1668. BGFX_RENDERER_CONTEXT(d3d12);
  1669. BGFX_RENDERER_CONTEXT(mtl);
  1670. BGFX_RENDERER_CONTEXT(gl);
  1671. BGFX_RENDERER_CONTEXT(vk);
  1672. BGFX_RENDERER_CONTEXT(gnm);
  1673. #undef BGFX_RENDERER_CONTEXT
  1674. struct RendererCreator
  1675. {
  1676. RendererCreateFn createFn;
  1677. RendererDestroyFn destroyFn;
  1678. const char* name;
  1679. bool supported;
  1680. };
  1681. static RendererCreator s_rendererCreator[] =
  1682. {
  1683. { noop::rendererCreate, noop::rendererDestroy, BGFX_RENDERER_NOOP_NAME, true }, // Noop
  1684. { d3d9::rendererCreate, d3d9::rendererDestroy, BGFX_RENDERER_DIRECT3D9_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D9 }, // Direct3D9
  1685. { d3d11::rendererCreate, d3d11::rendererDestroy, BGFX_RENDERER_DIRECT3D11_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D11 }, // Direct3D11
  1686. { d3d12::rendererCreate, d3d12::rendererDestroy, BGFX_RENDERER_DIRECT3D12_NAME, !!BGFX_CONFIG_RENDERER_DIRECT3D12 }, // Direct3D12
  1687. { gnm::rendererCreate, gnm::rendererDestroy, BGFX_RENDERER_GNM_NAME, !!BGFX_CONFIG_RENDERER_GNM }, // GNM
  1688. #if BX_PLATFORM_OSX || BX_PLATFORM_IOS
  1689. { mtl::rendererCreate, mtl::rendererDestroy, BGFX_RENDERER_METAL_NAME, !!BGFX_CONFIG_RENDERER_METAL }, // Metal
  1690. #else
  1691. { noop::rendererCreate, noop::rendererDestroy, BGFX_RENDERER_NOOP_NAME, false }, // Noop
  1692. #endif // BX_PLATFORM_OSX || BX_PLATFORM_IOS
  1693. { gl::rendererCreate, gl::rendererDestroy, BGFX_RENDERER_OPENGL_NAME, !!BGFX_CONFIG_RENDERER_OPENGLES }, // OpenGLES
  1694. { gl::rendererCreate, gl::rendererDestroy, BGFX_RENDERER_OPENGL_NAME, !!BGFX_CONFIG_RENDERER_OPENGL }, // OpenGL
  1695. { vk::rendererCreate, vk::rendererDestroy, BGFX_RENDERER_VULKAN_NAME, !!BGFX_CONFIG_RENDERER_VULKAN }, // Vulkan
  1696. };
  1697. BX_STATIC_ASSERT(BX_COUNTOF(s_rendererCreator) == RendererType::Count);
  1698. struct Condition
  1699. {
  1700. enum Enum
  1701. {
  1702. LessEqual,
  1703. GreaterEqual,
  1704. };
  1705. };
  1706. bool windowsVersionIs(Condition::Enum _op, uint32_t _version)
  1707. {
  1708. #if BX_PLATFORM_WINDOWS
  1709. static const uint8_t s_condition[] =
  1710. {
  1711. VER_LESS_EQUAL,
  1712. VER_GREATER_EQUAL,
  1713. };
  1714. OSVERSIONINFOEXA ovi;
  1715. bx::memSet(&ovi, 0, sizeof(ovi) );
  1716. ovi.dwOSVersionInfoSize = sizeof(ovi);
  1717. // _WIN32_WINNT_WINBLUE 0x0603
  1718. // _WIN32_WINNT_WIN8 0x0602
  1719. // _WIN32_WINNT_WIN7 0x0601
  1720. // _WIN32_WINNT_VISTA 0x0600
  1721. ovi.dwMajorVersion = HIBYTE(_version);
  1722. ovi.dwMinorVersion = LOBYTE(_version);
  1723. DWORDLONG cond = 0;
  1724. VER_SET_CONDITION(cond, VER_MAJORVERSION, s_condition[_op]);
  1725. VER_SET_CONDITION(cond, VER_MINORVERSION, s_condition[_op]);
  1726. return !!VerifyVersionInfoA(&ovi, VER_MAJORVERSION | VER_MINORVERSION, cond);
  1727. #else
  1728. BX_UNUSED(_op, _version);
  1729. return false;
  1730. #endif // BX_PLATFORM_WINDOWS
  1731. }
  1732. static int32_t compareDescending(const void* _lhs, const void* _rhs)
  1733. {
  1734. return *(const int32_t*)_rhs - *(const int32_t*)_lhs;
  1735. }
  1736. RendererContextI* rendererCreate(RendererType::Enum _type)
  1737. {
  1738. int32_t scores[RendererType::Count];
  1739. uint32_t numScores = 0;
  1740. for (uint32_t ii = 0; ii < RendererType::Count; ++ii)
  1741. {
  1742. RendererType::Enum renderer = RendererType::Enum(ii);
  1743. if (s_rendererCreator[ii].supported)
  1744. {
  1745. int32_t score = 0;
  1746. if (_type == renderer)
  1747. {
  1748. score += 1000;
  1749. }
  1750. score += RendererType::Noop != renderer ? 1 : 0;
  1751. if (BX_ENABLED(BX_PLATFORM_WINDOWS) )
  1752. {
  1753. if (windowsVersionIs(Condition::GreaterEqual, 0x0602) )
  1754. {
  1755. score += RendererType::Direct3D11 == renderer ? 20 : 0;
  1756. score += RendererType::Direct3D12 == renderer ? 10 : 0;
  1757. }
  1758. else if (windowsVersionIs(Condition::GreaterEqual, 0x0601) )
  1759. {
  1760. score += RendererType::Direct3D11 == renderer ? 20 : 0;
  1761. score += RendererType::Direct3D9 == renderer ? 10 : 0;
  1762. score += RendererType::Direct3D12 == renderer ? -100 : 0;
  1763. }
  1764. else
  1765. {
  1766. score += RendererType::Direct3D12 == renderer ? -100 : 0;
  1767. }
  1768. }
  1769. else if (BX_ENABLED(BX_PLATFORM_LINUX) )
  1770. {
  1771. score += RendererType::OpenGL == renderer ? 20 : 0;
  1772. score += RendererType::OpenGLES == renderer ? 10 : 0;
  1773. }
  1774. else if (BX_ENABLED(BX_PLATFORM_OSX) )
  1775. {
  1776. score += RendererType::OpenGL == renderer ? 20 : 0;
  1777. }
  1778. else if (BX_ENABLED(0
  1779. || BX_PLATFORM_ANDROID
  1780. || BX_PLATFORM_EMSCRIPTEN
  1781. || BX_PLATFORM_IOS
  1782. || BX_PLATFORM_RPI
  1783. ) )
  1784. {
  1785. score += RendererType::OpenGLES == renderer ? 20 : 0;
  1786. }
  1787. else if (BX_ENABLED(BX_PLATFORM_PS4) )
  1788. {
  1789. score += RendererType::Gnm == renderer ? 20 : 0;
  1790. }
  1791. else if (BX_ENABLED(0
  1792. || BX_PLATFORM_XBOXONE
  1793. || BX_PLATFORM_WINRT
  1794. ) )
  1795. {
  1796. score += RendererType::Direct3D11 == renderer ? 20 : 0;
  1797. }
  1798. scores[numScores++] = (score<<8) | uint8_t(renderer);
  1799. }
  1800. }
  1801. bx::quickSort(scores, numScores, sizeof(int32_t), compareDescending);
  1802. RendererContextI* renderCtx = NULL;
  1803. for (uint32_t ii = 0; ii < numScores; ++ii)
  1804. {
  1805. RendererType::Enum renderer = RendererType::Enum(scores[ii] & 0xff);
  1806. renderCtx = s_rendererCreator[renderer].createFn();
  1807. if (NULL != renderCtx)
  1808. {
  1809. break;
  1810. }
  1811. s_rendererCreator[renderer].supported = false;
  1812. }
  1813. return renderCtx;
  1814. }
  1815. void rendererDestroy(RendererContextI* _renderCtx)
  1816. {
  1817. if (NULL != _renderCtx)
  1818. {
  1819. s_rendererCreator[_renderCtx->getRendererType()].destroyFn();
  1820. }
  1821. }
  1822. void Context::rendererExecCommands(CommandBuffer& _cmdbuf)
  1823. {
  1824. _cmdbuf.reset();
  1825. bool end = false;
  1826. if (NULL == m_renderCtx)
  1827. {
  1828. uint8_t command;
  1829. _cmdbuf.read(command);
  1830. switch (command)
  1831. {
  1832. case CommandBuffer::RendererShutdownEnd:
  1833. m_exit = true;
  1834. return;
  1835. case CommandBuffer::End:
  1836. return;
  1837. default:
  1838. {
  1839. BX_CHECK(CommandBuffer::RendererInit == command
  1840. , "RendererInit must be the first command in command buffer before initialization. Unexpected command %d?"
  1841. , command
  1842. );
  1843. BX_CHECK(!m_rendererInitialized, "This shouldn't happen! Bad synchronization?");
  1844. RendererType::Enum type;
  1845. _cmdbuf.read(type);
  1846. m_renderCtx = rendererCreate(type);
  1847. m_rendererInitialized = NULL != m_renderCtx;
  1848. if (!m_rendererInitialized)
  1849. {
  1850. _cmdbuf.read(command);
  1851. BX_CHECK(CommandBuffer::End == command, "Unexpected command %d?"
  1852. , command
  1853. );
  1854. return;
  1855. }
  1856. }
  1857. break;
  1858. }
  1859. }
  1860. do
  1861. {
  1862. uint8_t command;
  1863. _cmdbuf.read(command);
  1864. switch (command)
  1865. {
  1866. case CommandBuffer::RendererShutdownBegin:
  1867. {
  1868. BX_CHECK(m_rendererInitialized, "This shouldn't happen! Bad synchronization?");
  1869. m_rendererInitialized = false;
  1870. }
  1871. break;
  1872. case CommandBuffer::RendererShutdownEnd:
  1873. {
  1874. BX_CHECK(!m_rendererInitialized && !m_exit, "This shouldn't happen! Bad synchronization?");
  1875. rendererDestroy(m_renderCtx);
  1876. m_renderCtx = NULL;
  1877. m_exit = true;
  1878. }
  1879. BX_FALLTHROUGH;
  1880. case CommandBuffer::End:
  1881. end = true;
  1882. break;
  1883. case CommandBuffer::CreateIndexBuffer:
  1884. {
  1885. IndexBufferHandle handle;
  1886. _cmdbuf.read(handle);
  1887. Memory* mem;
  1888. _cmdbuf.read(mem);
  1889. uint16_t flags;
  1890. _cmdbuf.read(flags);
  1891. m_renderCtx->createIndexBuffer(handle, mem, flags);
  1892. release(mem);
  1893. }
  1894. break;
  1895. case CommandBuffer::DestroyIndexBuffer:
  1896. {
  1897. IndexBufferHandle handle;
  1898. _cmdbuf.read(handle);
  1899. m_renderCtx->destroyIndexBuffer(handle);
  1900. }
  1901. break;
  1902. case CommandBuffer::CreateVertexDecl:
  1903. {
  1904. VertexDeclHandle handle;
  1905. _cmdbuf.read(handle);
  1906. VertexDecl decl;
  1907. _cmdbuf.read(decl);
  1908. m_renderCtx->createVertexDecl(handle, decl);
  1909. }
  1910. break;
  1911. case CommandBuffer::DestroyVertexDecl:
  1912. {
  1913. VertexDeclHandle handle;
  1914. _cmdbuf.read(handle);
  1915. m_renderCtx->destroyVertexDecl(handle);
  1916. }
  1917. break;
  1918. case CommandBuffer::CreateVertexBuffer:
  1919. {
  1920. VertexBufferHandle handle;
  1921. _cmdbuf.read(handle);
  1922. Memory* mem;
  1923. _cmdbuf.read(mem);
  1924. VertexDeclHandle declHandle;
  1925. _cmdbuf.read(declHandle);
  1926. uint16_t flags;
  1927. _cmdbuf.read(flags);
  1928. m_renderCtx->createVertexBuffer(handle, mem, declHandle, flags);
  1929. release(mem);
  1930. }
  1931. break;
  1932. case CommandBuffer::DestroyVertexBuffer:
  1933. {
  1934. VertexBufferHandle handle;
  1935. _cmdbuf.read(handle);
  1936. m_renderCtx->destroyVertexBuffer(handle);
  1937. }
  1938. break;
  1939. case CommandBuffer::CreateDynamicIndexBuffer:
  1940. {
  1941. IndexBufferHandle handle;
  1942. _cmdbuf.read(handle);
  1943. uint32_t size;
  1944. _cmdbuf.read(size);
  1945. uint16_t flags;
  1946. _cmdbuf.read(flags);
  1947. m_renderCtx->createDynamicIndexBuffer(handle, size, flags);
  1948. }
  1949. break;
  1950. case CommandBuffer::UpdateDynamicIndexBuffer:
  1951. {
  1952. IndexBufferHandle handle;
  1953. _cmdbuf.read(handle);
  1954. uint32_t offset;
  1955. _cmdbuf.read(offset);
  1956. uint32_t size;
  1957. _cmdbuf.read(size);
  1958. Memory* mem;
  1959. _cmdbuf.read(mem);
  1960. m_renderCtx->updateDynamicIndexBuffer(handle, offset, size, mem);
  1961. release(mem);
  1962. }
  1963. break;
  1964. case CommandBuffer::DestroyDynamicIndexBuffer:
  1965. {
  1966. IndexBufferHandle handle;
  1967. _cmdbuf.read(handle);
  1968. m_renderCtx->destroyDynamicIndexBuffer(handle);
  1969. }
  1970. break;
  1971. case CommandBuffer::CreateDynamicVertexBuffer:
  1972. {
  1973. VertexBufferHandle handle;
  1974. _cmdbuf.read(handle);
  1975. uint32_t size;
  1976. _cmdbuf.read(size);
  1977. uint16_t flags;
  1978. _cmdbuf.read(flags);
  1979. m_renderCtx->createDynamicVertexBuffer(handle, size, flags);
  1980. }
  1981. break;
  1982. case CommandBuffer::UpdateDynamicVertexBuffer:
  1983. {
  1984. VertexBufferHandle handle;
  1985. _cmdbuf.read(handle);
  1986. uint32_t offset;
  1987. _cmdbuf.read(offset);
  1988. uint32_t size;
  1989. _cmdbuf.read(size);
  1990. Memory* mem;
  1991. _cmdbuf.read(mem);
  1992. m_renderCtx->updateDynamicVertexBuffer(handle, offset, size, mem);
  1993. release(mem);
  1994. }
  1995. break;
  1996. case CommandBuffer::DestroyDynamicVertexBuffer:
  1997. {
  1998. VertexBufferHandle handle;
  1999. _cmdbuf.read(handle);
  2000. m_renderCtx->destroyDynamicVertexBuffer(handle);
  2001. }
  2002. break;
  2003. case CommandBuffer::CreateShader:
  2004. {
  2005. ShaderHandle handle;
  2006. _cmdbuf.read(handle);
  2007. Memory* mem;
  2008. _cmdbuf.read(mem);
  2009. m_renderCtx->createShader(handle, mem);
  2010. release(mem);
  2011. }
  2012. break;
  2013. case CommandBuffer::DestroyShader:
  2014. {
  2015. ShaderHandle handle;
  2016. _cmdbuf.read(handle);
  2017. m_renderCtx->destroyShader(handle);
  2018. }
  2019. break;
  2020. case CommandBuffer::CreateProgram:
  2021. {
  2022. ProgramHandle handle;
  2023. _cmdbuf.read(handle);
  2024. ShaderHandle vsh;
  2025. _cmdbuf.read(vsh);
  2026. ShaderHandle fsh;
  2027. _cmdbuf.read(fsh);
  2028. m_renderCtx->createProgram(handle, vsh, fsh);
  2029. }
  2030. break;
  2031. case CommandBuffer::DestroyProgram:
  2032. {
  2033. ProgramHandle handle;
  2034. _cmdbuf.read(handle);
  2035. m_renderCtx->destroyProgram(handle);
  2036. }
  2037. break;
  2038. case CommandBuffer::CreateTexture:
  2039. {
  2040. TextureHandle handle;
  2041. _cmdbuf.read(handle);
  2042. Memory* mem;
  2043. _cmdbuf.read(mem);
  2044. uint32_t flags;
  2045. _cmdbuf.read(flags);
  2046. uint8_t skip;
  2047. _cmdbuf.read(skip);
  2048. void* ptr = m_renderCtx->createTexture(handle, mem, flags, skip);
  2049. if (NULL != ptr)
  2050. {
  2051. setDirectAccessPtr(handle, ptr);
  2052. }
  2053. bx::MemoryReader reader(mem->data, mem->size);
  2054. uint32_t magic;
  2055. bx::read(&reader, magic);
  2056. if (BGFX_CHUNK_MAGIC_TEX == magic)
  2057. {
  2058. TextureCreate tc;
  2059. bx::read(&reader, tc);
  2060. if (NULL != tc.m_mem)
  2061. {
  2062. release(tc.m_mem);
  2063. }
  2064. }
  2065. release(mem);
  2066. }
  2067. break;
  2068. case CommandBuffer::UpdateTexture:
  2069. {
  2070. if (m_textureUpdateBatch.isFull() )
  2071. {
  2072. flushTextureUpdateBatch(_cmdbuf);
  2073. }
  2074. uint32_t value = _cmdbuf.m_pos;
  2075. TextureHandle handle;
  2076. _cmdbuf.read(handle);
  2077. uint8_t side;
  2078. _cmdbuf.read(side);
  2079. uint8_t mip;
  2080. _cmdbuf.read(mip);
  2081. _cmdbuf.skip<Rect>();
  2082. _cmdbuf.skip<uint16_t>();
  2083. _cmdbuf.skip<uint16_t>();
  2084. _cmdbuf.skip<uint16_t>();
  2085. _cmdbuf.skip<Memory*>();
  2086. uint32_t key = (handle.idx<<16)
  2087. | (side<<8)
  2088. | mip
  2089. ;
  2090. m_textureUpdateBatch.add(key, value);
  2091. }
  2092. break;
  2093. case CommandBuffer::ReadTexture:
  2094. {
  2095. TextureHandle handle;
  2096. _cmdbuf.read(handle);
  2097. void* data;
  2098. _cmdbuf.read(data);
  2099. uint8_t mip;
  2100. _cmdbuf.read(mip);
  2101. m_renderCtx->readTexture(handle, data, mip);
  2102. }
  2103. break;
  2104. case CommandBuffer::ResizeTexture:
  2105. {
  2106. TextureHandle handle;
  2107. _cmdbuf.read(handle);
  2108. uint16_t width;
  2109. _cmdbuf.read(width);
  2110. uint16_t height;
  2111. _cmdbuf.read(height);
  2112. uint8_t numMips;
  2113. _cmdbuf.read(numMips);
  2114. m_renderCtx->resizeTexture(handle, width, height, numMips);
  2115. }
  2116. break;
  2117. case CommandBuffer::DestroyTexture:
  2118. {
  2119. TextureHandle handle;
  2120. _cmdbuf.read(handle);
  2121. m_renderCtx->destroyTexture(handle);
  2122. }
  2123. break;
  2124. case CommandBuffer::CreateFrameBuffer:
  2125. {
  2126. FrameBufferHandle handle;
  2127. _cmdbuf.read(handle);
  2128. bool window;
  2129. _cmdbuf.read(window);
  2130. if (window)
  2131. {
  2132. void* nwh;
  2133. _cmdbuf.read(nwh);
  2134. uint16_t width;
  2135. _cmdbuf.read(width);
  2136. uint16_t height;
  2137. _cmdbuf.read(height);
  2138. TextureFormat::Enum depthFormat;
  2139. _cmdbuf.read(depthFormat);
  2140. m_renderCtx->createFrameBuffer(handle, nwh, width, height, depthFormat);
  2141. }
  2142. else
  2143. {
  2144. uint8_t num;
  2145. _cmdbuf.read(num);
  2146. Attachment attachment[BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS];
  2147. _cmdbuf.read(attachment, sizeof(Attachment) * num);
  2148. m_renderCtx->createFrameBuffer(handle, num, attachment);
  2149. }
  2150. }
  2151. break;
  2152. case CommandBuffer::DestroyFrameBuffer:
  2153. {
  2154. FrameBufferHandle handle;
  2155. _cmdbuf.read(handle);
  2156. m_renderCtx->destroyFrameBuffer(handle);
  2157. }
  2158. break;
  2159. case CommandBuffer::CreateUniform:
  2160. {
  2161. UniformHandle handle;
  2162. _cmdbuf.read(handle);
  2163. UniformType::Enum type;
  2164. _cmdbuf.read(type);
  2165. uint16_t num;
  2166. _cmdbuf.read(num);
  2167. uint8_t len;
  2168. _cmdbuf.read(len);
  2169. const char* name = (const char*)_cmdbuf.skip(len);
  2170. m_renderCtx->createUniform(handle, type, num, name);
  2171. }
  2172. break;
  2173. case CommandBuffer::DestroyUniform:
  2174. {
  2175. UniformHandle handle;
  2176. _cmdbuf.read(handle);
  2177. m_renderCtx->destroyUniform(handle);
  2178. }
  2179. break;
  2180. case CommandBuffer::RequestScreenShot:
  2181. {
  2182. FrameBufferHandle handle;
  2183. _cmdbuf.read(handle);
  2184. uint16_t len;
  2185. _cmdbuf.read(len);
  2186. const char* filePath = (const char*)_cmdbuf.skip(len);
  2187. m_renderCtx->requestScreenShot(handle, filePath);
  2188. }
  2189. break;
  2190. case CommandBuffer::UpdateViewName:
  2191. {
  2192. ViewId id;
  2193. _cmdbuf.read(id);
  2194. uint16_t len;
  2195. _cmdbuf.read(len);
  2196. const char* name = (const char*)_cmdbuf.skip(len);
  2197. m_renderCtx->updateViewName(id, name);
  2198. }
  2199. break;
  2200. case CommandBuffer::InvalidateOcclusionQuery:
  2201. {
  2202. OcclusionQueryHandle handle;
  2203. _cmdbuf.read(handle);
  2204. m_renderCtx->invalidateOcclusionQuery(handle);
  2205. }
  2206. break;
  2207. case CommandBuffer::SetName:
  2208. {
  2209. Handle handle;
  2210. _cmdbuf.read(handle);
  2211. uint16_t len;
  2212. _cmdbuf.read(len);
  2213. const char* name = (const char*)_cmdbuf.skip(len);
  2214. m_renderCtx->setName(handle, name);
  2215. }
  2216. break;
  2217. default:
  2218. BX_CHECK(false, "Invalid command: %d", command);
  2219. break;
  2220. }
  2221. } while (!end);
  2222. flushTextureUpdateBatch(_cmdbuf);
  2223. }
  2224. uint32_t topologyConvert(TopologyConvert::Enum _conversion, void* _dst, uint32_t _dstSize, const void* _indices, uint32_t _numIndices, bool _index32)
  2225. {
  2226. return topologyConvert(_conversion, _dst, _dstSize, _indices, _numIndices, _index32, g_allocator);
  2227. }
  2228. 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)
  2229. {
  2230. topologySortTriList(_sort, _dst, _dstSize, _dir, _pos, _vertices, _stride, _indices, _numIndices, _index32, g_allocator);
  2231. }
  2232. uint8_t getSupportedRenderers(uint8_t _max, RendererType::Enum* _enum)
  2233. {
  2234. _enum = _max == 0 ? NULL : _enum;
  2235. uint8_t num = 0;
  2236. for (uint8_t ii = 0; ii < RendererType::Count; ++ii)
  2237. {
  2238. if ( (RendererType::Direct3D11 == ii || RendererType::Direct3D12 == ii)
  2239. && windowsVersionIs(Condition::LessEqual, 0x0502) )
  2240. {
  2241. continue;
  2242. }
  2243. if (NULL == _enum)
  2244. {
  2245. num++;
  2246. }
  2247. else
  2248. {
  2249. if (num < _max
  2250. && s_rendererCreator[ii].supported)
  2251. {
  2252. _enum[num++] = RendererType::Enum(ii);
  2253. }
  2254. }
  2255. }
  2256. return num;
  2257. }
  2258. const char* getRendererName(RendererType::Enum _type)
  2259. {
  2260. BX_CHECK(_type < RendererType::Count, "Invalid renderer type %d.", _type);
  2261. return s_rendererCreator[_type].name;
  2262. }
  2263. bool init(RendererType::Enum _type, uint16_t _vendorId, uint16_t _deviceId, CallbackI* _callback, bx::AllocatorI* _allocator)
  2264. {
  2265. if (NULL != s_ctx)
  2266. {
  2267. BX_TRACE("bgfx is already initialized.");
  2268. return false;
  2269. }
  2270. struct ErrorState
  2271. {
  2272. enum Enum
  2273. {
  2274. Default,
  2275. ContextAllocated,
  2276. };
  2277. };
  2278. ErrorState::Enum errorState = ErrorState::Default;
  2279. if (NULL != _allocator)
  2280. {
  2281. g_allocator = _allocator;
  2282. }
  2283. else
  2284. {
  2285. bx::DefaultAllocator allocator;
  2286. g_allocator =
  2287. s_allocatorStub = BX_NEW(&allocator, AllocatorStub);
  2288. }
  2289. if (NULL != _callback)
  2290. {
  2291. g_callback = _callback;
  2292. }
  2293. else
  2294. {
  2295. g_callback =
  2296. s_callbackStub = BX_NEW(g_allocator, CallbackStub);
  2297. }
  2298. if (true
  2299. && !BX_ENABLED(BX_PLATFORM_EMSCRIPTEN || BX_PLATFORM_PS4)
  2300. && RendererType::Noop != _type
  2301. && NULL == g_platformData.ndt
  2302. && NULL == g_platformData.nwh
  2303. && NULL == g_platformData.context
  2304. && NULL == g_platformData.backBuffer
  2305. && NULL == g_platformData.backBufferDS
  2306. )
  2307. {
  2308. BX_TRACE("bgfx platform data like window handle or backbuffer must be set.");
  2309. goto error;
  2310. }
  2311. bx::memSet(&g_caps, 0, sizeof(g_caps) );
  2312. g_caps.limits.maxDrawCalls = BGFX_CONFIG_MAX_DRAW_CALLS;
  2313. g_caps.limits.maxBlits = BGFX_CONFIG_MAX_BLIT_ITEMS;
  2314. g_caps.limits.maxViews = BGFX_CONFIG_MAX_VIEWS;
  2315. g_caps.limits.maxFrameBuffers = BGFX_CONFIG_MAX_FRAME_BUFFERS;
  2316. g_caps.limits.maxPrograms = BGFX_CONFIG_MAX_PROGRAMS;
  2317. g_caps.limits.maxShaders = BGFX_CONFIG_MAX_SHADERS;
  2318. g_caps.limits.maxTextures = BGFX_CONFIG_MAX_TEXTURES;
  2319. g_caps.limits.maxTextureSamplers = BGFX_CONFIG_MAX_TEXTURE_SAMPLERS;
  2320. g_caps.limits.maxVertexDecls = BGFX_CONFIG_MAX_VERTEX_DECLS;
  2321. g_caps.limits.maxVertexStreams = 1;
  2322. g_caps.limits.maxIndexBuffers = BGFX_CONFIG_MAX_INDEX_BUFFERS;
  2323. g_caps.limits.maxVertexBuffers = BGFX_CONFIG_MAX_VERTEX_BUFFERS;
  2324. g_caps.limits.maxDynamicIndexBuffers = BGFX_CONFIG_MAX_DYNAMIC_INDEX_BUFFERS;
  2325. g_caps.limits.maxDynamicVertexBuffers = BGFX_CONFIG_MAX_DYNAMIC_VERTEX_BUFFERS;
  2326. g_caps.limits.maxUniforms = BGFX_CONFIG_MAX_UNIFORMS;
  2327. g_caps.limits.maxOcclusionQueries = BGFX_CONFIG_MAX_OCCLUSION_QUERIES;
  2328. g_caps.limits.maxFBAttachments = 1;
  2329. g_caps.limits.maxEncoders = BGFX_CONFIG_MAX_ENCODERS;
  2330. g_caps.vendorId = _vendorId;
  2331. g_caps.deviceId = _deviceId;
  2332. BX_TRACE("Init...");
  2333. errorState = ErrorState::ContextAllocated;
  2334. s_ctx = BX_ALIGNED_NEW(g_allocator, Context, 64);
  2335. if (s_ctx->init(_type) )
  2336. {
  2337. BX_TRACE("Init complete.");
  2338. return true;
  2339. }
  2340. error:
  2341. BX_TRACE("Init failed.");
  2342. switch (errorState)
  2343. {
  2344. case ErrorState::ContextAllocated:
  2345. BX_ALIGNED_DELETE(g_allocator, s_ctx, 64);
  2346. s_ctx = NULL;
  2347. case ErrorState::Default:
  2348. if (NULL != s_callbackStub)
  2349. {
  2350. BX_DELETE(g_allocator, s_callbackStub);
  2351. s_callbackStub = NULL;
  2352. }
  2353. if (NULL != s_allocatorStub)
  2354. {
  2355. bx::DefaultAllocator allocator;
  2356. BX_DELETE(&allocator, s_allocatorStub);
  2357. s_allocatorStub = NULL;
  2358. }
  2359. s_threadIndex = 0;
  2360. g_callback = NULL;
  2361. g_allocator = NULL;
  2362. break;
  2363. }
  2364. return false;
  2365. }
  2366. void shutdown()
  2367. {
  2368. BX_TRACE("Shutdown...");
  2369. BGFX_CHECK_API_THREAD();
  2370. Context* ctx = s_ctx; // it's going to be NULLd inside shutdown.
  2371. ctx->shutdown();
  2372. BX_CHECK(NULL == s_ctx, "bgfx is should be uninitialized here.");
  2373. BX_ALIGNED_DELETE(g_allocator, ctx, 16);
  2374. BX_TRACE("Shutdown complete.");
  2375. if (NULL != s_allocatorStub)
  2376. {
  2377. s_allocatorStub->checkLeaks();
  2378. }
  2379. if (NULL != s_callbackStub)
  2380. {
  2381. BX_DELETE(g_allocator, s_callbackStub);
  2382. s_callbackStub = NULL;
  2383. }
  2384. if (NULL != s_allocatorStub)
  2385. {
  2386. bx::DefaultAllocator allocator;
  2387. BX_DELETE(&allocator, s_allocatorStub);
  2388. s_allocatorStub = NULL;
  2389. }
  2390. s_threadIndex = 0;
  2391. g_callback = NULL;
  2392. g_allocator = NULL;
  2393. }
  2394. void reset(uint32_t _width, uint32_t _height, uint32_t _flags)
  2395. {
  2396. BGFX_CHECK_API_THREAD();
  2397. BX_CHECK(0 == (_flags&BGFX_RESET_RESERVED_MASK), "Do not set reset reserved flags!");
  2398. s_ctx->reset(_width, _height, _flags);
  2399. }
  2400. Encoder* begin()
  2401. {
  2402. return s_ctx->begin();
  2403. }
  2404. #define BGFX_ENCODER(_func) reinterpret_cast<EncoderImpl*>(this)->_func
  2405. void Encoder::setMarker(const char* _marker)
  2406. {
  2407. BGFX_ENCODER(setMarker(_marker) );
  2408. }
  2409. void Encoder::setState(uint64_t _state, uint32_t _rgba)
  2410. {
  2411. BX_CHECK(0 == (_state&BGFX_STATE_RESERVED_MASK), "Do not set state reserved flags!");
  2412. BGFX_ENCODER(setState(_state, _rgba) );
  2413. }
  2414. void Encoder::setCondition(OcclusionQueryHandle _handle, bool _visible)
  2415. {
  2416. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  2417. BGFX_ENCODER(setCondition(_handle, _visible) );
  2418. }
  2419. void Encoder::setStencil(uint32_t _fstencil, uint32_t _bstencil)
  2420. {
  2421. BGFX_ENCODER(setStencil(_fstencil, _bstencil) );
  2422. }
  2423. uint16_t Encoder::setScissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  2424. {
  2425. return BGFX_ENCODER(setScissor(_x, _y, _width, _height) );
  2426. }
  2427. void Encoder::setScissor(uint16_t _cache)
  2428. {
  2429. BGFX_ENCODER(setScissor(_cache) );
  2430. }
  2431. uint32_t Encoder::setTransform(const void* _mtx, uint16_t _num)
  2432. {
  2433. return BGFX_ENCODER(setTransform(_mtx, _num) );
  2434. }
  2435. uint32_t Encoder::allocTransform(Transform* _transform, uint16_t _num)
  2436. {
  2437. return BGFX_ENCODER(allocTransform(_transform, _num) );
  2438. }
  2439. void Encoder::setTransform(uint32_t _cache, uint16_t _num)
  2440. {
  2441. BGFX_ENCODER(setTransform(_cache, _num) );
  2442. }
  2443. void Encoder::setUniform(UniformHandle _handle, const void* _value, uint16_t _num)
  2444. {
  2445. BGFX_CHECK_HANDLE("setUniform", s_ctx->m_uniformHandle, _handle);
  2446. const Context::UniformRef& uniform = s_ctx->m_uniformRef[_handle.idx];
  2447. BX_CHECK(isValid(_handle) && 0 < uniform.m_refCount, "Setting invalid uniform (handle %3d)!", _handle.idx);
  2448. BX_CHECK(_num == UINT16_MAX || uniform.m_num >= _num, "Truncated uniform update. %d (max: %d)", _num, uniform.m_num);
  2449. BGFX_ENCODER(setUniform(uniform.m_type, _handle, _value, _num) );
  2450. }
  2451. void Encoder::setIndexBuffer(IndexBufferHandle _handle)
  2452. {
  2453. setIndexBuffer(_handle, 0, UINT32_MAX);
  2454. }
  2455. void Encoder::setIndexBuffer(IndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  2456. {
  2457. BGFX_CHECK_HANDLE("setIndexBuffer", s_ctx->m_indexBufferHandle, _handle);
  2458. BGFX_ENCODER(setIndexBuffer(_handle, _firstIndex, _numIndices) );
  2459. }
  2460. void Encoder::setIndexBuffer(DynamicIndexBufferHandle _handle)
  2461. {
  2462. setIndexBuffer(_handle, 0, UINT32_MAX);
  2463. }
  2464. void Encoder::setIndexBuffer(DynamicIndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  2465. {
  2466. BGFX_CHECK_HANDLE("setIndexBuffer", s_ctx->m_dynamicIndexBufferHandle, _handle);
  2467. const DynamicIndexBuffer& dib = s_ctx->m_dynamicIndexBuffers[_handle.idx];
  2468. BGFX_ENCODER(setIndexBuffer(dib, _firstIndex, _numIndices) );
  2469. }
  2470. void Encoder::setIndexBuffer(const TransientIndexBuffer* _tib)
  2471. {
  2472. setIndexBuffer(_tib, 0, UINT32_MAX);
  2473. }
  2474. void Encoder::setIndexBuffer(const TransientIndexBuffer* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  2475. {
  2476. BX_CHECK(NULL != _tib, "_tib can't be NULL");
  2477. BGFX_CHECK_HANDLE("setIndexBuffer", s_ctx->m_indexBufferHandle, _tib->handle);
  2478. BGFX_ENCODER(setIndexBuffer(_tib, _firstIndex, _numIndices) );
  2479. }
  2480. void Encoder::setVertexBuffer(uint8_t _stream, VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  2481. {
  2482. BGFX_CHECK_HANDLE("setVertexBuffer", s_ctx->m_vertexBufferHandle, _handle);
  2483. BGFX_ENCODER(setVertexBuffer(_stream, _handle, _startVertex, _numVertices) );
  2484. }
  2485. void Encoder::setVertexBuffer(uint8_t _stream, VertexBufferHandle _handle)
  2486. {
  2487. setVertexBuffer(_stream, _handle, 0, UINT32_MAX);
  2488. }
  2489. void Encoder::setVertexBuffer(uint8_t _stream, DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  2490. {
  2491. BGFX_CHECK_HANDLE("setVertexBuffer", s_ctx->m_dynamicVertexBufferHandle, _handle);
  2492. const DynamicVertexBuffer& dvb = s_ctx->m_dynamicVertexBuffers[_handle.idx];
  2493. BGFX_ENCODER(setVertexBuffer(_stream, dvb, _startVertex, _numVertices) );
  2494. }
  2495. void Encoder::setVertexBuffer(uint8_t _stream, DynamicVertexBufferHandle _handle)
  2496. {
  2497. setVertexBuffer(_stream, _handle, 0, UINT32_MAX);
  2498. }
  2499. void Encoder::setVertexBuffer(uint8_t _stream, const TransientVertexBuffer* _tvb, uint32_t _startVertex, uint32_t _numVertices)
  2500. {
  2501. BX_CHECK(NULL != _tvb, "_tvb can't be NULL");
  2502. BGFX_CHECK_HANDLE("setVertexBuffer", s_ctx->m_vertexBufferHandle, _tvb->handle);
  2503. BGFX_ENCODER(setVertexBuffer(_stream, _tvb, _startVertex, _numVertices) );
  2504. }
  2505. void Encoder::setVertexBuffer(uint8_t _stream, const TransientVertexBuffer* _tvb)
  2506. {
  2507. setVertexBuffer(_stream, _tvb, 0, UINT32_MAX);
  2508. }
  2509. void Encoder::setInstanceDataBuffer(const InstanceDataBuffer* _idb, uint32_t _num)
  2510. {
  2511. BX_CHECK(NULL != _idb, "_idb can't be NULL");
  2512. BGFX_ENCODER(setInstanceDataBuffer(_idb, _num) );
  2513. }
  2514. void Encoder::setInstanceDataBuffer(VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  2515. {
  2516. BGFX_CHECK_HANDLE("setInstanceDataBuffer", s_ctx->m_vertexBufferHandle, _handle);
  2517. const VertexBuffer& vb = s_ctx->m_vertexBuffers[_handle.idx];
  2518. BGFX_ENCODER(setInstanceDataBuffer(_handle, _startVertex, _num, vb.m_stride) );
  2519. }
  2520. void Encoder::setInstanceDataBuffer(DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  2521. {
  2522. BGFX_CHECK_HANDLE("setInstanceDataBuffer", s_ctx->m_dynamicVertexBufferHandle, _handle);
  2523. const DynamicVertexBuffer& dvb = s_ctx->m_dynamicVertexBuffers[_handle.idx];
  2524. BGFX_ENCODER(setInstanceDataBuffer(dvb.m_handle
  2525. , dvb.m_startVertex + _startVertex
  2526. , _num
  2527. , dvb.m_stride
  2528. ) );
  2529. }
  2530. void Encoder::setTexture(uint8_t _stage, UniformHandle _sampler, TextureHandle _handle, uint32_t _flags)
  2531. {
  2532. BGFX_CHECK_HANDLE_INVALID_OK("setTexture/TextureHandle", s_ctx->m_textureHandle, _handle);
  2533. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2534. BGFX_ENCODER(setTexture(_stage, _sampler, _handle, _flags) );
  2535. }
  2536. void Encoder::touch(ViewId _id)
  2537. {
  2538. ProgramHandle handle = BGFX_INVALID_HANDLE;
  2539. submit(_id, handle);
  2540. }
  2541. void Encoder::submit(ViewId _id, ProgramHandle _program, int32_t _depth, bool _preserveState)
  2542. {
  2543. OcclusionQueryHandle handle = BGFX_INVALID_HANDLE;
  2544. submit(_id, _program, handle, _depth, _preserveState);
  2545. }
  2546. void Encoder::submit(ViewId _id, ProgramHandle _program, OcclusionQueryHandle _occlusionQuery, int32_t _depth, bool _preserveState)
  2547. {
  2548. BX_CHECK(false
  2549. || !isValid(_occlusionQuery)
  2550. || 0 != (g_caps.supported & BGFX_CAPS_OCCLUSION_QUERY)
  2551. , "Occlusion query is not supported! Use bgfx::getCaps to check BGFX_CAPS_OCCLUSION_QUERY backend renderer capabilities."
  2552. );
  2553. BGFX_CHECK_HANDLE_INVALID_OK("submit", s_ctx->m_programHandle, _program);
  2554. BGFX_CHECK_HANDLE_INVALID_OK("submit", s_ctx->m_occlusionQueryHandle, _occlusionQuery);
  2555. BGFX_ENCODER(submit(_id, _program, _occlusionQuery, _depth, _preserveState) );
  2556. }
  2557. void Encoder::submit(ViewId _id, ProgramHandle _program, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, int32_t _depth, bool _preserveState)
  2558. {
  2559. BGFX_CHECK_HANDLE_INVALID_OK("submit", s_ctx->m_programHandle, _program);
  2560. BGFX_CHECK_HANDLE("submit", s_ctx->m_vertexBufferHandle, _indirectHandle);
  2561. BGFX_CHECK_CAPS(BGFX_CAPS_DRAW_INDIRECT, "Draw indirect is not supported!");
  2562. BGFX_ENCODER(submit(_id, _program, _indirectHandle, _start, _num, _depth, _preserveState) );
  2563. }
  2564. void Encoder::setBuffer(uint8_t _stage, IndexBufferHandle _handle, Access::Enum _access)
  2565. {
  2566. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2567. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_indexBufferHandle, _handle);
  2568. BGFX_ENCODER(setBuffer(_stage, _handle, _access) );
  2569. }
  2570. void Encoder::setBuffer(uint8_t _stage, VertexBufferHandle _handle, Access::Enum _access)
  2571. {
  2572. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2573. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_vertexBufferHandle, _handle);
  2574. BGFX_ENCODER(setBuffer(_stage, _handle, _access) );
  2575. }
  2576. void Encoder::setBuffer(uint8_t _stage, DynamicIndexBufferHandle _handle, Access::Enum _access)
  2577. {
  2578. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2579. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_dynamicIndexBufferHandle, _handle);
  2580. const DynamicIndexBuffer& dib = s_ctx->m_dynamicIndexBuffers[_handle.idx];
  2581. BGFX_ENCODER(setBuffer(_stage, dib.m_handle, _access) );
  2582. }
  2583. void Encoder::setBuffer(uint8_t _stage, DynamicVertexBufferHandle _handle, Access::Enum _access)
  2584. {
  2585. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2586. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_dynamicVertexBufferHandle, _handle);
  2587. const DynamicVertexBuffer& dvb = s_ctx->m_dynamicVertexBuffers[_handle.idx];
  2588. BGFX_ENCODER(setBuffer(_stage, dvb.m_handle, _access) );
  2589. }
  2590. void Encoder::setBuffer(uint8_t _stage, IndirectBufferHandle _handle, Access::Enum _access)
  2591. {
  2592. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2593. BGFX_CHECK_HANDLE("setBuffer", s_ctx->m_vertexBufferHandle, _handle);
  2594. VertexBufferHandle handle = { _handle.idx };
  2595. BGFX_ENCODER(setBuffer(_stage, handle, _access) );
  2596. }
  2597. void Encoder::setImage(uint8_t _stage, UniformHandle _sampler, TextureHandle _handle, uint8_t _mip, Access::Enum _access, TextureFormat::Enum _format)
  2598. {
  2599. BX_CHECK(_stage < BGFX_CONFIG_MAX_TEXTURE_SAMPLERS, "Invalid stage %d (max %d).", _stage, BGFX_CONFIG_MAX_TEXTURE_SAMPLERS);
  2600. _format = TextureFormat::Count == _format
  2601. ? TextureFormat::Enum(s_ctx->m_textureRef[_handle.idx].m_format)
  2602. : _format
  2603. ;
  2604. BX_CHECK(_format != TextureFormat::BGRA8
  2605. , "Can't use TextureFormat::BGRA8 with compute, use TextureFormat::RGBA8 instead."
  2606. );
  2607. BGFX_ENCODER(setImage(_stage, _sampler, _handle, _mip, _access, _format) );
  2608. }
  2609. void Encoder::dispatch(ViewId _id, ProgramHandle _program, uint32_t _numX, uint32_t _numY, uint32_t _numZ, uint8_t _flags)
  2610. {
  2611. BGFX_CHECK_CAPS(BGFX_CAPS_COMPUTE, "Compute is not supported!");
  2612. BGFX_CHECK_HANDLE_INVALID_OK("dispatch", s_ctx->m_programHandle, _program);
  2613. BGFX_ENCODER(dispatch(_id, _program, _numX, _numY, _numZ, _flags) );
  2614. }
  2615. void Encoder::dispatch(ViewId _id, ProgramHandle _program, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, uint8_t _flags)
  2616. {
  2617. BGFX_CHECK_CAPS(BGFX_CAPS_DRAW_INDIRECT, "Dispatch indirect is not supported!");
  2618. BGFX_CHECK_CAPS(BGFX_CAPS_COMPUTE, "Compute is not supported!");
  2619. BGFX_CHECK_HANDLE_INVALID_OK("dispatch", s_ctx->m_programHandle, _program);
  2620. BGFX_CHECK_HANDLE("dispatch", s_ctx->m_vertexBufferHandle, _indirectHandle);
  2621. BGFX_ENCODER(dispatch(_id, _program, _indirectHandle, _start, _num, _flags) );
  2622. }
  2623. void Encoder::discard()
  2624. {
  2625. BGFX_ENCODER(discard() );
  2626. }
  2627. 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)
  2628. {
  2629. blit(_id, _dst, 0, _dstX, _dstY, 0, _src, 0, _srcX, _srcY, 0, _width, _height, 0);
  2630. }
  2631. 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)
  2632. {
  2633. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_BLIT, "Texture blit is not supported!");
  2634. const Context::TextureRef& src = s_ctx->m_textureRef[_src.idx];
  2635. const Context::TextureRef& dst = s_ctx->m_textureRef[_dst.idx];
  2636. BX_CHECK(src.m_format == dst.m_format
  2637. , "Texture format must match (src %s, dst %s)."
  2638. , bimg::getName(bimg::TextureFormat::Enum(src.m_format) )
  2639. , bimg::getName(bimg::TextureFormat::Enum(dst.m_format) )
  2640. );
  2641. BX_UNUSED(src, dst);
  2642. BGFX_ENCODER(blit(_id, _dst, _dstMip, _dstX, _dstY, _dstZ, _src, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth) );
  2643. }
  2644. #undef BGFX_ENCODER
  2645. void end(Encoder* _encoder)
  2646. {
  2647. s_ctx->end(_encoder);
  2648. }
  2649. uint32_t frame(bool _capture)
  2650. {
  2651. BGFX_CHECK_API_THREAD();
  2652. return s_ctx->frame(_capture);
  2653. }
  2654. const Caps* getCaps()
  2655. {
  2656. return &g_caps;
  2657. }
  2658. const HMD* getHMD()
  2659. {
  2660. return s_ctx->getHMD();
  2661. }
  2662. const Stats* getStats()
  2663. {
  2664. return s_ctx->getPerfStats();
  2665. }
  2666. RendererType::Enum getRendererType()
  2667. {
  2668. return g_caps.rendererType;
  2669. }
  2670. const Memory* alloc(uint32_t _size)
  2671. {
  2672. BX_CHECK(0 < _size, "Invalid memory operation. _size is 0.");
  2673. Memory* mem = (Memory*)BX_ALLOC(g_allocator, sizeof(Memory) + _size);
  2674. mem->size = _size;
  2675. mem->data = (uint8_t*)mem + sizeof(Memory);
  2676. return mem;
  2677. }
  2678. const Memory* copy(const void* _data, uint32_t _size)
  2679. {
  2680. BX_CHECK(0 < _size, "Invalid memory operation. _size is 0.");
  2681. const Memory* mem = alloc(_size);
  2682. bx::memCopy(mem->data, _data, _size);
  2683. return mem;
  2684. }
  2685. struct MemoryRef
  2686. {
  2687. Memory mem;
  2688. ReleaseFn releaseFn;
  2689. void* userData;
  2690. };
  2691. const Memory* makeRef(const void* _data, uint32_t _size, ReleaseFn _releaseFn, void* _userData)
  2692. {
  2693. MemoryRef* memRef = (MemoryRef*)BX_ALLOC(g_allocator, sizeof(MemoryRef) );
  2694. memRef->mem.size = _size;
  2695. memRef->mem.data = (uint8_t*)_data;
  2696. memRef->releaseFn = _releaseFn;
  2697. memRef->userData = _userData;
  2698. return &memRef->mem;
  2699. }
  2700. bool isMemoryRef(const Memory* _mem)
  2701. {
  2702. return _mem->data != (uint8_t*)_mem + sizeof(Memory);
  2703. }
  2704. void release(const Memory* _mem)
  2705. {
  2706. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2707. Memory* mem = const_cast<Memory*>(_mem);
  2708. if (isMemoryRef(mem) )
  2709. {
  2710. MemoryRef* memRef = reinterpret_cast<MemoryRef*>(mem);
  2711. if (NULL != memRef->releaseFn)
  2712. {
  2713. memRef->releaseFn(mem->data, memRef->userData);
  2714. }
  2715. }
  2716. BX_FREE(g_allocator, mem);
  2717. }
  2718. void setDebug(uint32_t _debug)
  2719. {
  2720. BGFX_CHECK_API_THREAD();
  2721. s_ctx->setDebug(_debug);
  2722. }
  2723. void dbgTextClear(uint8_t _attr, bool _small)
  2724. {
  2725. BGFX_CHECK_API_THREAD();
  2726. s_ctx->dbgTextClear(_attr, _small);
  2727. }
  2728. void dbgTextPrintfVargs(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, va_list _argList)
  2729. {
  2730. s_ctx->dbgTextPrintfVargs(_x, _y, _attr, _format, _argList);
  2731. }
  2732. void dbgTextPrintf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, ...)
  2733. {
  2734. BGFX_CHECK_API_THREAD();
  2735. va_list argList;
  2736. va_start(argList, _format);
  2737. s_ctx->dbgTextPrintfVargs(_x, _y, _attr, _format, argList);
  2738. va_end(argList);
  2739. }
  2740. void dbgTextImage(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const void* _data, uint16_t _pitch)
  2741. {
  2742. BGFX_CHECK_API_THREAD();
  2743. s_ctx->dbgTextImage(_x, _y, _width, _height, _data, _pitch);
  2744. }
  2745. IndexBufferHandle createIndexBuffer(const Memory* _mem, uint16_t _flags)
  2746. {
  2747. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2748. return s_ctx->createIndexBuffer(_mem, _flags);
  2749. }
  2750. void destroy(IndexBufferHandle _handle)
  2751. {
  2752. s_ctx->destroyIndexBuffer(_handle);
  2753. }
  2754. VertexBufferHandle createVertexBuffer(const Memory* _mem, const VertexDecl& _decl, uint16_t _flags)
  2755. {
  2756. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2757. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2758. return s_ctx->createVertexBuffer(_mem, _decl, _flags);
  2759. }
  2760. void destroy(VertexBufferHandle _handle)
  2761. {
  2762. s_ctx->destroyVertexBuffer(_handle);
  2763. }
  2764. DynamicIndexBufferHandle createDynamicIndexBuffer(uint32_t _num, uint16_t _flags)
  2765. {
  2766. return s_ctx->createDynamicIndexBuffer(_num, _flags);
  2767. }
  2768. DynamicIndexBufferHandle createDynamicIndexBuffer(const Memory* _mem, uint16_t _flags)
  2769. {
  2770. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2771. return s_ctx->createDynamicIndexBuffer(_mem, _flags);
  2772. }
  2773. void updateDynamicIndexBuffer(DynamicIndexBufferHandle _handle, uint32_t _startIndex, const Memory* _mem)
  2774. {
  2775. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2776. s_ctx->updateDynamicIndexBuffer(_handle, _startIndex, _mem);
  2777. }
  2778. void destroy(DynamicIndexBufferHandle _handle)
  2779. {
  2780. s_ctx->destroyDynamicIndexBuffer(_handle);
  2781. }
  2782. DynamicVertexBufferHandle createDynamicVertexBuffer(uint32_t _num, const VertexDecl& _decl, uint16_t _flags)
  2783. {
  2784. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2785. return s_ctx->createDynamicVertexBuffer(_num, _decl, _flags);
  2786. }
  2787. DynamicVertexBufferHandle createDynamicVertexBuffer(const Memory* _mem, const VertexDecl& _decl, uint16_t _flags)
  2788. {
  2789. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2790. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2791. return s_ctx->createDynamicVertexBuffer(_mem, _decl, _flags);
  2792. }
  2793. void updateDynamicVertexBuffer(DynamicVertexBufferHandle _handle, uint32_t _startVertex, const Memory* _mem)
  2794. {
  2795. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2796. s_ctx->updateDynamicVertexBuffer(_handle, _startVertex, _mem);
  2797. }
  2798. void destroy(DynamicVertexBufferHandle _handle)
  2799. {
  2800. s_ctx->destroyDynamicVertexBuffer(_handle);
  2801. }
  2802. uint32_t getAvailTransientIndexBuffer(uint32_t _num)
  2803. {
  2804. BX_CHECK(0 < _num, "Requesting 0 indices.");
  2805. return s_ctx->getAvailTransientIndexBuffer(_num);
  2806. }
  2807. uint32_t getAvailTransientVertexBuffer(uint32_t _num, const VertexDecl& _decl)
  2808. {
  2809. BX_CHECK(0 < _num, "Requesting 0 vertices.");
  2810. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2811. return s_ctx->getAvailTransientVertexBuffer(_num, _decl.m_stride);
  2812. }
  2813. uint32_t getAvailInstanceDataBuffer(uint32_t _num, uint16_t _stride)
  2814. {
  2815. BX_CHECK(0 < _num, "Requesting 0 instances.");
  2816. return s_ctx->getAvailTransientVertexBuffer(_num, _stride);
  2817. }
  2818. void allocTransientIndexBuffer(TransientIndexBuffer* _tib, uint32_t _num)
  2819. {
  2820. BX_CHECK(NULL != _tib, "_tib can't be NULL");
  2821. BX_CHECK(0 < _num, "Requesting 0 indices.");
  2822. s_ctx->allocTransientIndexBuffer(_tib, _num);
  2823. BX_CHECK(_num == _tib->size/2, "Failed to allocate transient index buffer (requested %d, available %d). Use bgfx::checkAvailTransient* functions to ensure availability."
  2824. , _num
  2825. , _tib->size/2
  2826. );
  2827. }
  2828. void allocTransientVertexBuffer(TransientVertexBuffer* _tvb, uint32_t _num, const VertexDecl& _decl)
  2829. {
  2830. BX_CHECK(NULL != _tvb, "_tvb can't be NULL");
  2831. BX_CHECK(0 < _num, "Requesting 0 vertices.");
  2832. BX_CHECK(UINT16_MAX >= _num, "Requesting %d vertices (max: %d).", _num, UINT16_MAX);
  2833. BX_CHECK(isValid(_decl), "Invalid VertexDecl.");
  2834. s_ctx->allocTransientVertexBuffer(_tvb, _num, _decl);
  2835. 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."
  2836. , _num
  2837. , _tvb->size / _decl.m_stride
  2838. );
  2839. }
  2840. bool allocTransientBuffers(bgfx::TransientVertexBuffer* _tvb, const bgfx::VertexDecl& _decl, uint32_t _numVertices, bgfx::TransientIndexBuffer* _tib, uint32_t _numIndices)
  2841. {
  2842. BGFX_MUTEX_SCOPE(s_ctx->m_resourceApiLock);
  2843. if (_numVertices == getAvailTransientVertexBuffer(_numVertices, _decl)
  2844. && _numIndices == getAvailTransientIndexBuffer(_numIndices) )
  2845. {
  2846. allocTransientVertexBuffer(_tvb, _numVertices, _decl);
  2847. allocTransientIndexBuffer(_tib, _numIndices);
  2848. return true;
  2849. }
  2850. return false;
  2851. }
  2852. void allocInstanceDataBuffer(InstanceDataBuffer* _idb, uint32_t _num, uint16_t _stride)
  2853. {
  2854. BGFX_CHECK_CAPS(BGFX_CAPS_INSTANCING, "Instancing is not supported!");
  2855. BX_CHECK(_stride == BX_ALIGN_16(_stride), "Stride must be multiple of 16.");
  2856. BX_CHECK(0 < _num, "Requesting 0 instanced data vertices.");
  2857. s_ctx->allocInstanceDataBuffer(_idb, _num, _stride);
  2858. BX_CHECK(_num == _idb->size / _stride, "Failed to allocate instance data buffer (requested %d, available %d). Use bgfx::checkAvailTransient* functions to ensure availability."
  2859. , _num
  2860. , _idb->size / _stride
  2861. );
  2862. }
  2863. IndirectBufferHandle createIndirectBuffer(uint32_t _num)
  2864. {
  2865. return s_ctx->createIndirectBuffer(_num);
  2866. }
  2867. void destroy(IndirectBufferHandle _handle)
  2868. {
  2869. s_ctx->destroyIndirectBuffer(_handle);
  2870. }
  2871. ShaderHandle createShader(const Memory* _mem)
  2872. {
  2873. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  2874. return s_ctx->createShader(_mem);
  2875. }
  2876. uint16_t getShaderUniforms(ShaderHandle _handle, UniformHandle* _uniforms, uint16_t _max)
  2877. {
  2878. return s_ctx->getShaderUniforms(_handle, _uniforms, _max);
  2879. }
  2880. void setName(ShaderHandle _handle, const char* _name)
  2881. {
  2882. s_ctx->setName(_handle, _name);
  2883. }
  2884. void destroy(ShaderHandle _handle)
  2885. {
  2886. s_ctx->destroyShader(_handle);
  2887. }
  2888. ProgramHandle createProgram(ShaderHandle _vsh, ShaderHandle _fsh, bool _destroyShaders)
  2889. {
  2890. if (!isValid(_fsh) )
  2891. {
  2892. return createProgram(_vsh, _destroyShaders);
  2893. }
  2894. return s_ctx->createProgram(_vsh, _fsh, _destroyShaders);
  2895. }
  2896. ProgramHandle createProgram(ShaderHandle _csh, bool _destroyShader)
  2897. {
  2898. return s_ctx->createProgram(_csh, _destroyShader);
  2899. }
  2900. void destroy(ProgramHandle _handle)
  2901. {
  2902. s_ctx->destroyProgram(_handle);
  2903. }
  2904. static void isTextureValid(uint16_t _depth, bool _cubeMap, uint16_t _numLayers, TextureFormat::Enum _format, uint32_t _flags, bx::Error* _err)
  2905. {
  2906. BX_ERROR_SCOPE(_err);
  2907. const bool is3DTexture = 1 < _depth;
  2908. if (_cubeMap && is3DTexture)
  2909. {
  2910. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  2911. , "Texture can't be depth and cube map at the same time."
  2912. );
  2913. return;
  2914. }
  2915. if (is3DTexture
  2916. && 0 == (g_caps.supported & BGFX_CAPS_TEXTURE_3D) )
  2917. {
  2918. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  2919. , "Texture3D is not supported! "
  2920. "Use bgfx::getCaps to check BGFX_CAPS_TEXTURE_3D backend renderer capabilities."
  2921. );
  2922. return;
  2923. }
  2924. if (0 != (_flags & BGFX_TEXTURE_RT_MASK)
  2925. && 0 != (_flags & BGFX_TEXTURE_READ_BACK) )
  2926. {
  2927. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  2928. , "Can't create render target with BGFX_TEXTURE_READ_BACK flag."
  2929. );
  2930. return;
  2931. }
  2932. if (1 < _numLayers
  2933. && 0 == (g_caps.supported & BGFX_CAPS_TEXTURE_2D_ARRAY) )
  2934. {
  2935. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  2936. , "Texture array is not supported! "
  2937. "Use bgfx::getCaps to check BGFX_CAPS_TEXTURE_2D_ARRAY backend renderer capabilities."
  2938. );
  2939. return;
  2940. }
  2941. bool formatSupported = 0 != (g_caps.formats[_format] & (0
  2942. | BGFX_CAPS_FORMAT_TEXTURE_2D
  2943. | BGFX_CAPS_FORMAT_TEXTURE_2D_EMULATED
  2944. | BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB
  2945. ) );
  2946. uint16_t srgbCaps = BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB;
  2947. if (_cubeMap)
  2948. {
  2949. formatSupported = 0 != (g_caps.formats[_format] & (0
  2950. | BGFX_CAPS_FORMAT_TEXTURE_CUBE
  2951. | BGFX_CAPS_FORMAT_TEXTURE_CUBE_EMULATED
  2952. | BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB
  2953. ) );
  2954. srgbCaps = BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB;
  2955. }
  2956. else if (is3DTexture)
  2957. {
  2958. formatSupported = 0 != (g_caps.formats[_format] & (0
  2959. | BGFX_CAPS_FORMAT_TEXTURE_3D
  2960. | BGFX_CAPS_FORMAT_TEXTURE_3D_EMULATED
  2961. | BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB
  2962. ) );
  2963. srgbCaps = BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB;
  2964. }
  2965. if (formatSupported
  2966. && 0 != (_flags & BGFX_TEXTURE_RT_MASK) )
  2967. {
  2968. formatSupported = 0 != (g_caps.formats[_format] & (0
  2969. | BGFX_CAPS_FORMAT_TEXTURE_FRAMEBUFFER
  2970. ) );
  2971. }
  2972. if (!formatSupported)
  2973. {
  2974. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  2975. , "Texture format is not supported! "
  2976. "Use bgfx::isTextureValid to check support for texture format before creating it."
  2977. );
  2978. return;
  2979. }
  2980. if (0 != (_flags & BGFX_TEXTURE_MSAA_SAMPLE)
  2981. && 0 == (g_caps.formats[_format] & BGFX_CAPS_FORMAT_TEXTURE_MSAA) )
  2982. {
  2983. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  2984. , "MSAA sampling for this texture format is not supported."
  2985. );
  2986. return;
  2987. }
  2988. if (0 != (_flags & BGFX_TEXTURE_SRGB)
  2989. && 0 == (g_caps.supported & srgbCaps & (0
  2990. | BGFX_CAPS_FORMAT_TEXTURE_2D_SRGB
  2991. | BGFX_CAPS_FORMAT_TEXTURE_3D_SRGB
  2992. | BGFX_CAPS_FORMAT_TEXTURE_CUBE_SRGB
  2993. ) ) )
  2994. {
  2995. _err->setError(BGFX_ERROR_TEXTURE_VALIDATION
  2996. , "sRGB sampling for this texture format is not supported."
  2997. );
  2998. return;
  2999. }
  3000. }
  3001. bool isTextureValid(uint16_t _depth, bool _cubeMap, uint16_t _numLayers, TextureFormat::Enum _format, uint32_t _flags)
  3002. {
  3003. bx::Error err;
  3004. isTextureValid(_depth, _cubeMap, _numLayers, _format, _flags, &err);
  3005. return err.isOk();
  3006. }
  3007. void calcTextureSize(TextureInfo& _info, uint16_t _width, uint16_t _height, uint16_t _depth, bool _cubeMap, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format)
  3008. {
  3009. bimg::imageGetSize( (bimg::TextureInfo*)&_info, _width, _height, _depth, _cubeMap, _hasMips, _numLayers, bimg::TextureFormat::Enum(_format) );
  3010. }
  3011. TextureHandle createTexture(const Memory* _mem, uint32_t _flags, uint8_t _skip, TextureInfo* _info)
  3012. {
  3013. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  3014. return s_ctx->createTexture(_mem, _flags, _skip, _info, BackbufferRatio::Count);
  3015. }
  3016. void getTextureSizeFromRatio(BackbufferRatio::Enum _ratio, uint16_t& _width, uint16_t& _height)
  3017. {
  3018. switch (_ratio)
  3019. {
  3020. case BackbufferRatio::Half: _width /= 2; _height /= 2; break;
  3021. case BackbufferRatio::Quarter: _width /= 4; _height /= 4; break;
  3022. case BackbufferRatio::Eighth: _width /= 8; _height /= 8; break;
  3023. case BackbufferRatio::Sixteenth: _width /= 16; _height /= 16; break;
  3024. case BackbufferRatio::Double: _width *= 2; _height *= 2; break;
  3025. default:
  3026. break;
  3027. }
  3028. _width = bx::uint16_max(1, _width);
  3029. _height = bx::uint16_max(1, _height);
  3030. }
  3031. 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)
  3032. {
  3033. bx::Error err;
  3034. isTextureValid(0, false, _numLayers, _format, _flags, &err);
  3035. BX_CHECK(err.isOk(), "%s (layers %d, format %s)"
  3036. , err.getMessage().getPtr()
  3037. , _numLayers
  3038. , getName(_format)
  3039. );
  3040. if (BackbufferRatio::Count != _ratio)
  3041. {
  3042. _width = uint16_t(s_ctx->m_resolution.m_width);
  3043. _height = uint16_t(s_ctx->m_resolution.m_height);
  3044. getTextureSizeFromRatio(_ratio, _width, _height);
  3045. }
  3046. const uint8_t numMips = calcNumMips(_hasMips, _width, _height);
  3047. _numLayers = bx::uint16_max(_numLayers, 1);
  3048. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  3049. && NULL != _mem)
  3050. {
  3051. TextureInfo ti;
  3052. calcTextureSize(ti, _width, _height, 1, false, _hasMips, _numLayers, _format);
  3053. BX_CHECK(ti.storageSize == _mem->size
  3054. , "createTexture2D: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  3055. , ti.storageSize
  3056. , _mem->size
  3057. );
  3058. }
  3059. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  3060. const Memory* mem = alloc(size);
  3061. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  3062. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  3063. bx::write(&writer, magic);
  3064. TextureCreate tc;
  3065. tc.m_width = _width;
  3066. tc.m_height = _height;
  3067. tc.m_depth = 0;
  3068. tc.m_numLayers = _numLayers;
  3069. tc.m_numMips = numMips;
  3070. tc.m_format = _format;
  3071. tc.m_cubeMap = false;
  3072. tc.m_mem = _mem;
  3073. bx::write(&writer, tc);
  3074. return s_ctx->createTexture(mem, _flags, 0, NULL, _ratio);
  3075. }
  3076. TextureHandle createTexture2D(uint16_t _width, uint16_t _height, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint32_t _flags, const Memory* _mem)
  3077. {
  3078. BX_CHECK(_width > 0 && _height > 0, "Invalid texture size (width %d, height %d).", _width, _height);
  3079. return createTexture2D(BackbufferRatio::Count, _width, _height, _hasMips, _numLayers, _format, _flags, _mem);
  3080. }
  3081. TextureHandle createTexture2D(BackbufferRatio::Enum _ratio, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint32_t _flags)
  3082. {
  3083. BX_CHECK(_ratio < BackbufferRatio::Count, "Invalid back buffer ratio.");
  3084. return createTexture2D(_ratio, 0, 0, _hasMips, _numLayers, _format, _flags, NULL);
  3085. }
  3086. TextureHandle createTexture3D(uint16_t _width, uint16_t _height, uint16_t _depth, bool _hasMips, TextureFormat::Enum _format, uint32_t _flags, const Memory* _mem)
  3087. {
  3088. bx::Error err;
  3089. isTextureValid(_depth, false, 1, _format, _flags, &err);
  3090. BX_CHECK(err.isOk(), "%s", err.getMessage().getPtr() );
  3091. const uint8_t numMips = calcNumMips(_hasMips, _width, _height, _depth);
  3092. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  3093. && NULL != _mem)
  3094. {
  3095. TextureInfo ti;
  3096. calcTextureSize(ti, _width, _height, _depth, false, _hasMips, 1, _format);
  3097. BX_CHECK(ti.storageSize == _mem->size
  3098. , "createTexture3D: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  3099. , ti.storageSize
  3100. , _mem->size
  3101. );
  3102. }
  3103. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  3104. const Memory* mem = alloc(size);
  3105. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  3106. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  3107. bx::write(&writer, magic);
  3108. TextureCreate tc;
  3109. tc.m_width = _width;
  3110. tc.m_height = _height;
  3111. tc.m_depth = _depth;
  3112. tc.m_numLayers = 1;
  3113. tc.m_numMips = numMips;
  3114. tc.m_format = _format;
  3115. tc.m_cubeMap = false;
  3116. tc.m_mem = _mem;
  3117. bx::write(&writer, tc);
  3118. return s_ctx->createTexture(mem, _flags, 0, NULL, BackbufferRatio::Count);
  3119. }
  3120. TextureHandle createTextureCube(uint16_t _size, bool _hasMips, uint16_t _numLayers, TextureFormat::Enum _format, uint32_t _flags, const Memory* _mem)
  3121. {
  3122. bx::Error err;
  3123. isTextureValid(0, true, _numLayers, _format, _flags, &err);
  3124. BX_CHECK(err.isOk(), "%s", err.getMessage().getPtr() );
  3125. const uint8_t numMips = calcNumMips(_hasMips, _size, _size);
  3126. _numLayers = bx::uint16_max(_numLayers, 1);
  3127. if (BX_ENABLED(BGFX_CONFIG_DEBUG)
  3128. && NULL != _mem)
  3129. {
  3130. TextureInfo ti;
  3131. calcTextureSize(ti, _size, _size, 1, true, _hasMips, _numLayers, _format);
  3132. BX_CHECK(ti.storageSize == _mem->size
  3133. , "createTextureCube: Texture storage size doesn't match passed memory size (storage size: %d, memory size: %d)"
  3134. , ti.storageSize
  3135. , _mem->size
  3136. );
  3137. }
  3138. uint32_t size = sizeof(uint32_t)+sizeof(TextureCreate);
  3139. const Memory* mem = alloc(size);
  3140. bx::StaticMemoryBlockWriter writer(mem->data, mem->size);
  3141. uint32_t magic = BGFX_CHUNK_MAGIC_TEX;
  3142. bx::write(&writer, magic);
  3143. TextureCreate tc;
  3144. tc.m_width = _size;
  3145. tc.m_height = _size;
  3146. tc.m_depth = 0;
  3147. tc.m_numLayers = _numLayers;
  3148. tc.m_numMips = numMips;
  3149. tc.m_format = _format;
  3150. tc.m_cubeMap = true;
  3151. tc.m_mem = _mem;
  3152. bx::write(&writer, tc);
  3153. return s_ctx->createTexture(mem, _flags, 0, NULL, BackbufferRatio::Count);
  3154. }
  3155. void setName(TextureHandle _handle, const char* _name)
  3156. {
  3157. s_ctx->setName(_handle, _name);
  3158. }
  3159. void* getDirectAccessPtr(TextureHandle _handle)
  3160. {
  3161. return s_ctx->getDirectAccessPtr(_handle);
  3162. }
  3163. void destroy(TextureHandle _handle)
  3164. {
  3165. s_ctx->destroyTexture(_handle);
  3166. }
  3167. 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)
  3168. {
  3169. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  3170. if (_width == 0
  3171. || _height == 0)
  3172. {
  3173. release(_mem);
  3174. }
  3175. else
  3176. {
  3177. s_ctx->updateTexture(_handle, 0, _mip, _x, _y, _layer, _width, _height, 1, _pitch, _mem);
  3178. }
  3179. }
  3180. 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)
  3181. {
  3182. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  3183. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_3D, "Texture3D is not supported!");
  3184. if (0 == _width
  3185. || 0 == _height
  3186. || 0 == _depth)
  3187. {
  3188. release(_mem);
  3189. }
  3190. else
  3191. {
  3192. s_ctx->updateTexture(_handle, 0, _mip, _x, _y, _z, _width, _height, _depth, UINT16_MAX, _mem);
  3193. }
  3194. }
  3195. 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)
  3196. {
  3197. BX_CHECK(NULL != _mem, "_mem can't be NULL");
  3198. BX_CHECK(_side <= 5, "Invalid side %d.", _side);
  3199. if (0 == _width
  3200. || 0 == _height)
  3201. {
  3202. release(_mem);
  3203. }
  3204. else
  3205. {
  3206. s_ctx->updateTexture(_handle, _side, _mip, _x, _y, _layer, _width, _height, 1, _pitch, _mem);
  3207. }
  3208. }
  3209. uint32_t readTexture(TextureHandle _handle, void* _data, uint8_t _mip)
  3210. {
  3211. BX_CHECK(NULL != _data, "_data can't be NULL");
  3212. BGFX_CHECK_CAPS(BGFX_CAPS_TEXTURE_READ_BACK, "Texture read-back is not supported!");
  3213. return s_ctx->readTexture(_handle, _data, _mip);
  3214. }
  3215. FrameBufferHandle createFrameBuffer(uint16_t _width, uint16_t _height, TextureFormat::Enum _format, uint32_t _textureFlags)
  3216. {
  3217. _textureFlags |= _textureFlags&BGFX_TEXTURE_RT_MSAA_MASK ? 0 : BGFX_TEXTURE_RT;
  3218. TextureHandle th = createTexture2D(_width, _height, false, 1, _format, _textureFlags);
  3219. return createFrameBuffer(1, &th, true);
  3220. }
  3221. FrameBufferHandle createFrameBuffer(BackbufferRatio::Enum _ratio, TextureFormat::Enum _format, uint32_t _textureFlags)
  3222. {
  3223. BX_CHECK(_ratio < BackbufferRatio::Count, "Invalid back buffer ratio.");
  3224. _textureFlags |= _textureFlags&BGFX_TEXTURE_RT_MSAA_MASK ? 0 : BGFX_TEXTURE_RT;
  3225. TextureHandle th = createTexture2D(_ratio, false, 1, _format, _textureFlags);
  3226. return createFrameBuffer(1, &th, true);
  3227. }
  3228. FrameBufferHandle createFrameBuffer(uint8_t _num, const TextureHandle* _handles, bool _destroyTextures)
  3229. {
  3230. Attachment attachment[BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS];
  3231. for (uint8_t ii = 0; ii < _num; ++ii)
  3232. {
  3233. Attachment& at = attachment[ii];
  3234. at.handle = _handles[ii];
  3235. at.mip = 0;
  3236. at.layer = 0;
  3237. }
  3238. return createFrameBuffer(_num, attachment, _destroyTextures);
  3239. }
  3240. FrameBufferHandle createFrameBuffer(uint8_t _num, const Attachment* _attachment, bool _destroyTextures)
  3241. {
  3242. BX_CHECK(_num != 0, "Number of frame buffer attachments can't be 0.");
  3243. BX_CHECK(_num <= BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS
  3244. , "Number of frame buffer attachments is larger than allowed %d (max: %d)."
  3245. , _num
  3246. , BGFX_CONFIG_MAX_FRAME_BUFFER_ATTACHMENTS
  3247. );
  3248. BX_CHECK(NULL != _attachment, "_attachment can't be NULL");
  3249. return s_ctx->createFrameBuffer(_num, _attachment, _destroyTextures);
  3250. }
  3251. FrameBufferHandle createFrameBuffer(void* _nwh, uint16_t _width, uint16_t _height, TextureFormat::Enum _depthFormat)
  3252. {
  3253. BGFX_CHECK_CAPS(BGFX_CAPS_SWAP_CHAIN, "Swap chain is not supported!");
  3254. BX_WARN(_width > 0 && _height > 0
  3255. , "Invalid frame buffer dimensions (width %d, height %d)."
  3256. , _width
  3257. , _height
  3258. );
  3259. return s_ctx->createFrameBuffer(
  3260. _nwh
  3261. , bx::uint16_max(_width, 1)
  3262. , bx::uint16_max(_height, 1)
  3263. , _depthFormat
  3264. );
  3265. }
  3266. TextureHandle getTexture(FrameBufferHandle _handle, uint8_t _attachment)
  3267. {
  3268. return s_ctx->getTexture(_handle, _attachment);
  3269. }
  3270. void destroy(FrameBufferHandle _handle)
  3271. {
  3272. s_ctx->destroyFrameBuffer(_handle);
  3273. }
  3274. UniformHandle createUniform(const char* _name, UniformType::Enum _type, uint16_t _num)
  3275. {
  3276. return s_ctx->createUniform(_name, _type, _num);
  3277. }
  3278. void getUniformInfo(UniformHandle _handle, UniformInfo& _info)
  3279. {
  3280. s_ctx->getUniformInfo(_handle, _info);
  3281. }
  3282. void destroy(UniformHandle _handle)
  3283. {
  3284. s_ctx->destroyUniform(_handle);
  3285. }
  3286. OcclusionQueryHandle createOcclusionQuery()
  3287. {
  3288. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  3289. return s_ctx->createOcclusionQuery();
  3290. }
  3291. OcclusionQueryResult::Enum getResult(OcclusionQueryHandle _handle, int32_t* _result)
  3292. {
  3293. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  3294. return s_ctx->getResult(_handle, _result);
  3295. }
  3296. void destroy(OcclusionQueryHandle _handle)
  3297. {
  3298. BGFX_CHECK_CAPS(BGFX_CAPS_OCCLUSION_QUERY, "Occlusion query is not supported!");
  3299. s_ctx->destroyOcclusionQuery(_handle);
  3300. }
  3301. void setPaletteColor(uint8_t _index, uint32_t _rgba)
  3302. {
  3303. const uint8_t rr = uint8_t(_rgba>>24);
  3304. const uint8_t gg = uint8_t(_rgba>>16);
  3305. const uint8_t bb = uint8_t(_rgba>> 8);
  3306. const uint8_t aa = uint8_t(_rgba>> 0);
  3307. const float rgba[4] =
  3308. {
  3309. rr * 1.0f/255.0f,
  3310. gg * 1.0f/255.0f,
  3311. bb * 1.0f/255.0f,
  3312. aa * 1.0f/255.0f,
  3313. };
  3314. s_ctx->setPaletteColor(_index, rgba);
  3315. }
  3316. void setPaletteColor(uint8_t _index, float _r, float _g, float _b, float _a)
  3317. {
  3318. float rgba[4] = { _r, _g, _b, _a };
  3319. s_ctx->setPaletteColor(_index, rgba);
  3320. }
  3321. void setPaletteColor(uint8_t _index, const float _rgba[4])
  3322. {
  3323. s_ctx->setPaletteColor(_index, _rgba);
  3324. }
  3325. bool checkView(ViewId _id)
  3326. {
  3327. // workaround GCC 4.9 type-limit check.
  3328. const uint32_t id = _id;
  3329. return id < BGFX_CONFIG_MAX_VIEWS;
  3330. }
  3331. void setViewName(ViewId _id, const char* _name)
  3332. {
  3333. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3334. s_ctx->setViewName(_id, _name);
  3335. }
  3336. void setViewRect(ViewId _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3337. {
  3338. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3339. s_ctx->setViewRect(_id, _x, _y, _width, _height);
  3340. }
  3341. void setViewRect(ViewId _id, uint16_t _x, uint16_t _y, BackbufferRatio::Enum _ratio)
  3342. {
  3343. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3344. uint16_t width = uint16_t(s_ctx->m_resolution.m_width);
  3345. uint16_t height = uint16_t(s_ctx->m_resolution.m_height);
  3346. getTextureSizeFromRatio(_ratio, width, height);
  3347. setViewRect(_id, _x, _y, width, height);
  3348. }
  3349. void setViewScissor(ViewId _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3350. {
  3351. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3352. s_ctx->setViewScissor(_id, _x, _y, _width, _height);
  3353. }
  3354. void setViewClear(ViewId _id, uint16_t _flags, uint32_t _rgba, float _depth, uint8_t _stencil)
  3355. {
  3356. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3357. s_ctx->setViewClear(_id, _flags, _rgba, _depth, _stencil);
  3358. }
  3359. 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)
  3360. {
  3361. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3362. s_ctx->setViewClear(_id, _flags, _depth, _stencil, _0, _1, _2, _3, _4, _5, _6, _7);
  3363. }
  3364. void setViewMode(ViewId _id, ViewMode::Enum _mode)
  3365. {
  3366. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3367. s_ctx->setViewMode(_id, _mode);
  3368. }
  3369. void setViewFrameBuffer(ViewId _id, FrameBufferHandle _handle)
  3370. {
  3371. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3372. s_ctx->setViewFrameBuffer(_id, _handle);
  3373. }
  3374. void setViewTransform(ViewId _id, const void* _view, const void* _projL, uint8_t _flags, const void* _projR)
  3375. {
  3376. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3377. s_ctx->setViewTransform(_id, _view, _projL, _flags, _projR);
  3378. }
  3379. void setViewOrder(ViewId _id, uint16_t _num, const ViewId* _order)
  3380. {
  3381. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3382. s_ctx->setViewOrder(_id, _num, _order);
  3383. }
  3384. void resetView(ViewId _id)
  3385. {
  3386. BX_CHECK(checkView(_id), "Invalid view id: %d", _id);
  3387. s_ctx->resetView(_id);
  3388. }
  3389. void setMarker(const char* _marker)
  3390. {
  3391. BGFX_CHECK_API_THREAD();
  3392. s_ctx->m_encoder0->setMarker(_marker);
  3393. }
  3394. void setState(uint64_t _state, uint32_t _rgba)
  3395. {
  3396. BGFX_CHECK_API_THREAD();
  3397. s_ctx->m_encoder0->setState(_state, _rgba);
  3398. }
  3399. void setCondition(OcclusionQueryHandle _handle, bool _visible)
  3400. {
  3401. BGFX_CHECK_API_THREAD();
  3402. s_ctx->m_encoder0->setCondition(_handle, _visible);
  3403. }
  3404. void setStencil(uint32_t _fstencil, uint32_t _bstencil)
  3405. {
  3406. BGFX_CHECK_API_THREAD();
  3407. s_ctx->m_encoder0->setStencil(_fstencil, _bstencil);
  3408. }
  3409. uint16_t setScissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  3410. {
  3411. BGFX_CHECK_API_THREAD();
  3412. return s_ctx->m_encoder0->setScissor(_x, _y, _width, _height);
  3413. }
  3414. void setScissor(uint16_t _cache)
  3415. {
  3416. BGFX_CHECK_API_THREAD();
  3417. s_ctx->m_encoder0->setScissor(_cache);
  3418. }
  3419. uint32_t setTransform(const void* _mtx, uint16_t _num)
  3420. {
  3421. BGFX_CHECK_API_THREAD();
  3422. return s_ctx->m_encoder0->setTransform(_mtx, _num);
  3423. }
  3424. uint32_t allocTransform(Transform* _transform, uint16_t _num)
  3425. {
  3426. BGFX_CHECK_API_THREAD();
  3427. return s_ctx->m_encoder0->allocTransform(_transform, _num);
  3428. }
  3429. void setTransform(uint32_t _cache, uint16_t _num)
  3430. {
  3431. BGFX_CHECK_API_THREAD();
  3432. s_ctx->m_encoder0->setTransform(_cache, _num);
  3433. }
  3434. void setUniform(UniformHandle _handle, const void* _value, uint16_t _num)
  3435. {
  3436. BGFX_CHECK_API_THREAD();
  3437. s_ctx->m_encoder0->setUniform(_handle, _value, _num);
  3438. }
  3439. void setIndexBuffer(IndexBufferHandle _handle)
  3440. {
  3441. setIndexBuffer(_handle, 0, UINT32_MAX);
  3442. }
  3443. void setIndexBuffer(IndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  3444. {
  3445. BGFX_CHECK_API_THREAD();
  3446. s_ctx->m_encoder0->setIndexBuffer(_handle, _firstIndex, _numIndices);
  3447. }
  3448. void setIndexBuffer(DynamicIndexBufferHandle _handle)
  3449. {
  3450. setIndexBuffer(_handle, 0, UINT32_MAX);
  3451. }
  3452. void setIndexBuffer(DynamicIndexBufferHandle _handle, uint32_t _firstIndex, uint32_t _numIndices)
  3453. {
  3454. BGFX_CHECK_API_THREAD();
  3455. s_ctx->m_encoder0->setIndexBuffer(_handle, _firstIndex, _numIndices);
  3456. }
  3457. void setIndexBuffer(const TransientIndexBuffer* _tib)
  3458. {
  3459. setIndexBuffer(_tib, 0, UINT32_MAX);
  3460. }
  3461. void setIndexBuffer(const TransientIndexBuffer* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  3462. {
  3463. BGFX_CHECK_API_THREAD();
  3464. s_ctx->m_encoder0->setIndexBuffer(_tib, _firstIndex, _numIndices);
  3465. }
  3466. void setVertexBuffer(uint8_t _stream, VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  3467. {
  3468. BGFX_CHECK_API_THREAD();
  3469. s_ctx->m_encoder0->setVertexBuffer(_stream, _handle, _startVertex, _numVertices);
  3470. }
  3471. void setVertexBuffer(uint8_t _stream, VertexBufferHandle _handle)
  3472. {
  3473. setVertexBuffer(_stream, _handle, 0, UINT32_MAX);
  3474. }
  3475. void setVertexBuffer(uint8_t _stream, DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _numVertices)
  3476. {
  3477. BGFX_CHECK_API_THREAD();
  3478. s_ctx->m_encoder0->setVertexBuffer(_stream, _handle, _startVertex, _numVertices);
  3479. }
  3480. void setVertexBuffer(uint8_t _stream, DynamicVertexBufferHandle _handle)
  3481. {
  3482. setVertexBuffer(_stream, _handle, 0, UINT32_MAX);
  3483. }
  3484. void setVertexBuffer(uint8_t _stream, const TransientVertexBuffer* _tvb, uint32_t _startVertex, uint32_t _numVertices)
  3485. {
  3486. BGFX_CHECK_API_THREAD();
  3487. s_ctx->m_encoder0->setVertexBuffer(_stream, _tvb, _startVertex, _numVertices);
  3488. }
  3489. void setVertexBuffer(uint8_t _stream, const TransientVertexBuffer* _tvb)
  3490. {
  3491. setVertexBuffer(_stream, _tvb, 0, UINT32_MAX);
  3492. }
  3493. void setInstanceDataBuffer(const InstanceDataBuffer* _idb, uint32_t _num)
  3494. {
  3495. BGFX_CHECK_API_THREAD();
  3496. s_ctx->m_encoder0->setInstanceDataBuffer(_idb, _num);
  3497. }
  3498. void setInstanceDataBuffer(VertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  3499. {
  3500. BGFX_CHECK_API_THREAD();
  3501. s_ctx->m_encoder0->setInstanceDataBuffer(_handle, _startVertex, _num);
  3502. }
  3503. void setInstanceDataBuffer(DynamicVertexBufferHandle _handle, uint32_t _startVertex, uint32_t _num)
  3504. {
  3505. BGFX_CHECK_API_THREAD();
  3506. s_ctx->m_encoder0->setInstanceDataBuffer(_handle, _startVertex, _num);
  3507. }
  3508. void setTexture(uint8_t _stage, UniformHandle _sampler, TextureHandle _handle, uint32_t _flags)
  3509. {
  3510. BGFX_CHECK_API_THREAD();
  3511. s_ctx->m_encoder0->setTexture(_stage, _sampler, _handle, _flags);
  3512. }
  3513. void touch(ViewId _id)
  3514. {
  3515. ProgramHandle handle = BGFX_INVALID_HANDLE;
  3516. submit(_id, handle);
  3517. }
  3518. void submit(ViewId _id, ProgramHandle _program, int32_t _depth, bool _preserveState)
  3519. {
  3520. OcclusionQueryHandle handle = BGFX_INVALID_HANDLE;
  3521. submit(_id, _program, handle, _depth, _preserveState);
  3522. }
  3523. void submit(ViewId _id, ProgramHandle _program, OcclusionQueryHandle _occlusionQuery, int32_t _depth, bool _preserveState)
  3524. {
  3525. BGFX_CHECK_API_THREAD();
  3526. s_ctx->m_encoder0->submit(_id, _program, _occlusionQuery, _depth, _preserveState);
  3527. }
  3528. void submit(ViewId _id, ProgramHandle _program, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, int32_t _depth, bool _preserveState)
  3529. {
  3530. BGFX_CHECK_API_THREAD();
  3531. s_ctx->m_encoder0->submit(_id, _program, _indirectHandle, _start, _num, _depth, _preserveState);
  3532. }
  3533. void setBuffer(uint8_t _stage, IndexBufferHandle _handle, Access::Enum _access)
  3534. {
  3535. BGFX_CHECK_API_THREAD();
  3536. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3537. }
  3538. void setBuffer(uint8_t _stage, VertexBufferHandle _handle, Access::Enum _access)
  3539. {
  3540. BGFX_CHECK_API_THREAD();
  3541. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3542. }
  3543. void setBuffer(uint8_t _stage, DynamicIndexBufferHandle _handle, Access::Enum _access)
  3544. {
  3545. BGFX_CHECK_API_THREAD();
  3546. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3547. }
  3548. void setBuffer(uint8_t _stage, DynamicVertexBufferHandle _handle, Access::Enum _access)
  3549. {
  3550. BGFX_CHECK_API_THREAD();
  3551. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3552. }
  3553. void setBuffer(uint8_t _stage, IndirectBufferHandle _handle, Access::Enum _access)
  3554. {
  3555. BGFX_CHECK_API_THREAD();
  3556. s_ctx->m_encoder0->setBuffer(_stage, _handle, _access);
  3557. }
  3558. void setImage(uint8_t _stage, UniformHandle _sampler, TextureHandle _handle, uint8_t _mip, Access::Enum _access, TextureFormat::Enum _format)
  3559. {
  3560. BGFX_CHECK_API_THREAD();
  3561. s_ctx->m_encoder0->setImage(_stage, _sampler, _handle, _mip, _access, _format);
  3562. }
  3563. void dispatch(ViewId _id, ProgramHandle _handle, uint32_t _numX, uint32_t _numY, uint32_t _numZ, uint8_t _flags)
  3564. {
  3565. BGFX_CHECK_API_THREAD();
  3566. s_ctx->m_encoder0->dispatch(_id, _handle, _numX, _numY, _numZ, _flags);
  3567. }
  3568. void dispatch(ViewId _id, ProgramHandle _handle, IndirectBufferHandle _indirectHandle, uint16_t _start, uint16_t _num, uint8_t _flags)
  3569. {
  3570. BGFX_CHECK_API_THREAD();
  3571. s_ctx->m_encoder0->dispatch(_id, _handle, _indirectHandle, _start, _num, _flags);
  3572. }
  3573. void discard()
  3574. {
  3575. BGFX_CHECK_API_THREAD();
  3576. s_ctx->m_encoder0->discard();
  3577. }
  3578. 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)
  3579. {
  3580. blit(_id, _dst, 0, _dstX, _dstY, 0, _src, 0, _srcX, _srcY, 0, _width, _height, 0);
  3581. }
  3582. 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)
  3583. {
  3584. BGFX_CHECK_API_THREAD();
  3585. s_ctx->m_encoder0->blit(_id, _dst, _dstMip, _dstX, _dstY, _dstZ, _src, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth);
  3586. }
  3587. void requestScreenShot(FrameBufferHandle _handle, const char* _filePath)
  3588. {
  3589. BGFX_CHECK_API_THREAD();
  3590. s_ctx->requestScreenShot(_handle, _filePath);
  3591. }
  3592. } // namespace bgfx
  3593. #if BX_PLATFORM_WINDOWS
  3594. extern "C"
  3595. {
  3596. // When laptop setup has integrated and discrete GPU, following driver workarounds will
  3597. // select discrete GPU:
  3598. // Reference: https://docs.nvidia.com/gameworks/content/technologies/desktop/optimus.htm
  3599. __declspec(dllexport) uint32_t NvOptimusEnablement = UINT32_C(1);
  3600. // Reference: http://gpuopen.com/amdpowerxpressrequesthighperformance/
  3601. __declspec(dllexport) uint32_t AmdPowerXpressRequestHighPerformance = UINT32_C(1);
  3602. }
  3603. #endif // BX_PLATFORM_WINDOWS
  3604. #define BGFX_TEXTURE_FORMAT_BIMG(_fmt) \
  3605. BX_STATIC_ASSERT(uint32_t(bgfx::TextureFormat::_fmt) == uint32_t(bimg::TextureFormat::_fmt) )
  3606. BGFX_TEXTURE_FORMAT_BIMG(BC1);
  3607. BGFX_TEXTURE_FORMAT_BIMG(BC2);
  3608. BGFX_TEXTURE_FORMAT_BIMG(BC3);
  3609. BGFX_TEXTURE_FORMAT_BIMG(BC4);
  3610. BGFX_TEXTURE_FORMAT_BIMG(BC5);
  3611. BGFX_TEXTURE_FORMAT_BIMG(BC6H);
  3612. BGFX_TEXTURE_FORMAT_BIMG(BC7);
  3613. BGFX_TEXTURE_FORMAT_BIMG(ETC1);
  3614. BGFX_TEXTURE_FORMAT_BIMG(ETC2);
  3615. BGFX_TEXTURE_FORMAT_BIMG(ETC2A);
  3616. BGFX_TEXTURE_FORMAT_BIMG(ETC2A1);
  3617. BGFX_TEXTURE_FORMAT_BIMG(PTC12);
  3618. BGFX_TEXTURE_FORMAT_BIMG(PTC14);
  3619. BGFX_TEXTURE_FORMAT_BIMG(PTC12A);
  3620. BGFX_TEXTURE_FORMAT_BIMG(PTC14A);
  3621. BGFX_TEXTURE_FORMAT_BIMG(PTC22);
  3622. BGFX_TEXTURE_FORMAT_BIMG(PTC24);
  3623. BGFX_TEXTURE_FORMAT_BIMG(Unknown);
  3624. BGFX_TEXTURE_FORMAT_BIMG(R1);
  3625. BGFX_TEXTURE_FORMAT_BIMG(A8);
  3626. BGFX_TEXTURE_FORMAT_BIMG(R8);
  3627. BGFX_TEXTURE_FORMAT_BIMG(R8I);
  3628. BGFX_TEXTURE_FORMAT_BIMG(R8U);
  3629. BGFX_TEXTURE_FORMAT_BIMG(R8S);
  3630. BGFX_TEXTURE_FORMAT_BIMG(R16);
  3631. BGFX_TEXTURE_FORMAT_BIMG(R16I);
  3632. BGFX_TEXTURE_FORMAT_BIMG(R16U);
  3633. BGFX_TEXTURE_FORMAT_BIMG(R16F);
  3634. BGFX_TEXTURE_FORMAT_BIMG(R16S);
  3635. BGFX_TEXTURE_FORMAT_BIMG(R32I);
  3636. BGFX_TEXTURE_FORMAT_BIMG(R32U);
  3637. BGFX_TEXTURE_FORMAT_BIMG(R32F);
  3638. BGFX_TEXTURE_FORMAT_BIMG(RG8);
  3639. BGFX_TEXTURE_FORMAT_BIMG(RG8I);
  3640. BGFX_TEXTURE_FORMAT_BIMG(RG8U);
  3641. BGFX_TEXTURE_FORMAT_BIMG(RG8S);
  3642. BGFX_TEXTURE_FORMAT_BIMG(RG16);
  3643. BGFX_TEXTURE_FORMAT_BIMG(RG16I);
  3644. BGFX_TEXTURE_FORMAT_BIMG(RG16U);
  3645. BGFX_TEXTURE_FORMAT_BIMG(RG16F);
  3646. BGFX_TEXTURE_FORMAT_BIMG(RG16S);
  3647. BGFX_TEXTURE_FORMAT_BIMG(RG32I);
  3648. BGFX_TEXTURE_FORMAT_BIMG(RG32U);
  3649. BGFX_TEXTURE_FORMAT_BIMG(RG32F);
  3650. BGFX_TEXTURE_FORMAT_BIMG(RGB8);
  3651. BGFX_TEXTURE_FORMAT_BIMG(RGB8I);
  3652. BGFX_TEXTURE_FORMAT_BIMG(RGB8U);
  3653. BGFX_TEXTURE_FORMAT_BIMG(RGB8S);
  3654. BGFX_TEXTURE_FORMAT_BIMG(RGB9E5F);
  3655. BGFX_TEXTURE_FORMAT_BIMG(BGRA8);
  3656. BGFX_TEXTURE_FORMAT_BIMG(RGBA8);
  3657. BGFX_TEXTURE_FORMAT_BIMG(RGBA8I);
  3658. BGFX_TEXTURE_FORMAT_BIMG(RGBA8U);
  3659. BGFX_TEXTURE_FORMAT_BIMG(RGBA8S);
  3660. BGFX_TEXTURE_FORMAT_BIMG(RGBA16);
  3661. BGFX_TEXTURE_FORMAT_BIMG(RGBA16I);
  3662. BGFX_TEXTURE_FORMAT_BIMG(RGBA16U);
  3663. BGFX_TEXTURE_FORMAT_BIMG(RGBA16F);
  3664. BGFX_TEXTURE_FORMAT_BIMG(RGBA16S);
  3665. BGFX_TEXTURE_FORMAT_BIMG(RGBA32I);
  3666. BGFX_TEXTURE_FORMAT_BIMG(RGBA32U);
  3667. BGFX_TEXTURE_FORMAT_BIMG(RGBA32F);
  3668. BGFX_TEXTURE_FORMAT_BIMG(R5G6B5);
  3669. BGFX_TEXTURE_FORMAT_BIMG(RGBA4);
  3670. BGFX_TEXTURE_FORMAT_BIMG(RGB5A1);
  3671. BGFX_TEXTURE_FORMAT_BIMG(RGB10A2);
  3672. BGFX_TEXTURE_FORMAT_BIMG(RG11B10F);
  3673. BGFX_TEXTURE_FORMAT_BIMG(UnknownDepth);
  3674. BGFX_TEXTURE_FORMAT_BIMG(D16);
  3675. BGFX_TEXTURE_FORMAT_BIMG(D24);
  3676. BGFX_TEXTURE_FORMAT_BIMG(D24S8);
  3677. BGFX_TEXTURE_FORMAT_BIMG(D32);
  3678. BGFX_TEXTURE_FORMAT_BIMG(D16F);
  3679. BGFX_TEXTURE_FORMAT_BIMG(D24F);
  3680. BGFX_TEXTURE_FORMAT_BIMG(D32F);
  3681. BGFX_TEXTURE_FORMAT_BIMG(D0S8);
  3682. BGFX_TEXTURE_FORMAT_BIMG(Count);
  3683. #undef BGFX_TEXTURE_FORMAT_BIMG
  3684. #include <bgfx/c99/bgfx.h>
  3685. #include <bgfx/c99/platform.h>
  3686. #define FLAGS_MASK_TEST(_flags, _mask) ( (_flags) == ( (_flags) & (_mask) ) )
  3687. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3688. | BGFX_TEXTURE_INTERNAL_DEFAULT_SAMPLER
  3689. | BGFX_TEXTURE_INTERNAL_SHARED
  3690. , BGFX_TEXTURE_RESERVED_MASK
  3691. ) );
  3692. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3693. | BGFX_RESET_INTERNAL_FORCE
  3694. , BGFX_RESET_RESERVED_MASK
  3695. ) );
  3696. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3697. | BGFX_STATE_INTERNAL_SCISSOR
  3698. | BGFX_STATE_INTERNAL_OCCLUSION_QUERY
  3699. , BGFX_STATE_RESERVED_MASK
  3700. ) );
  3701. BX_STATIC_ASSERT(FLAGS_MASK_TEST(0
  3702. | BGFX_SUBMIT_INTERNAL_OCCLUSION_VISIBLE
  3703. , BGFX_SUBMIT_RESERVED_MASK
  3704. ) );
  3705. #undef FLAGS_MASK_TEST
  3706. #define BGFX_C99_ENUM_CHECK(_enum, _c99enumcount) \
  3707. BX_STATIC_ASSERT(_enum::Count == _enum::Enum(_c99enumcount) )
  3708. BGFX_C99_ENUM_CHECK(bgfx::Fatal, BGFX_FATAL_COUNT);
  3709. BGFX_C99_ENUM_CHECK(bgfx::RendererType, BGFX_RENDERER_TYPE_COUNT);
  3710. BGFX_C99_ENUM_CHECK(bgfx::Attrib, BGFX_ATTRIB_COUNT);
  3711. BGFX_C99_ENUM_CHECK(bgfx::AttribType, BGFX_ATTRIB_TYPE_COUNT);
  3712. BGFX_C99_ENUM_CHECK(bgfx::TextureFormat, BGFX_TEXTURE_FORMAT_COUNT);
  3713. BGFX_C99_ENUM_CHECK(bgfx::UniformType, BGFX_UNIFORM_TYPE_COUNT);
  3714. BGFX_C99_ENUM_CHECK(bgfx::BackbufferRatio, BGFX_BACKBUFFER_RATIO_COUNT);
  3715. BGFX_C99_ENUM_CHECK(bgfx::OcclusionQueryResult, BGFX_OCCLUSION_QUERY_RESULT_COUNT);
  3716. BGFX_C99_ENUM_CHECK(bgfx::TopologyConvert, BGFX_TOPOLOGY_CONVERT_COUNT);
  3717. BGFX_C99_ENUM_CHECK(bgfx::RenderFrame, BGFX_RENDER_FRAME_COUNT);
  3718. #undef BGFX_C99_ENUM_CHECK
  3719. #define BGFX_C99_STRUCT_SIZE_CHECK(_cppstruct, _c99struct) \
  3720. BX_STATIC_ASSERT(sizeof(_cppstruct) == sizeof(_c99struct) )
  3721. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Memory, bgfx_memory_t);
  3722. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Transform, bgfx_transform_t);
  3723. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::HMD::Eye, bgfx_hmd_eye_t);
  3724. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::HMD, bgfx_hmd_t);
  3725. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Stats, bgfx_stats_t);
  3726. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::VertexDecl, bgfx_vertex_decl_t);
  3727. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TransientIndexBuffer, bgfx_transient_index_buffer_t);
  3728. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TransientVertexBuffer, bgfx_transient_vertex_buffer_t);
  3729. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::InstanceDataBuffer, bgfx_instance_data_buffer_t);
  3730. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::TextureInfo, bgfx_texture_info_t);
  3731. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::UniformInfo, bgfx_uniform_info_t);
  3732. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Attachment, bgfx_attachment_t);
  3733. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Caps::GPU, bgfx_caps_gpu_t);
  3734. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Caps::Limits, bgfx_caps_limits_t);
  3735. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::Caps, bgfx_caps_t);
  3736. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::PlatformData, bgfx_platform_data_t);
  3737. BGFX_C99_STRUCT_SIZE_CHECK(bgfx::InternalData, bgfx_internal_data_t);
  3738. #undef BGFX_C99_STRUCT_SIZE_CHECK
  3739. namespace bgfx
  3740. {
  3741. struct CallbackC99 : public CallbackI
  3742. {
  3743. virtual ~CallbackC99()
  3744. {
  3745. }
  3746. virtual void fatal(Fatal::Enum _code, const char* _str) override
  3747. {
  3748. m_interface->vtbl->fatal(m_interface, (bgfx_fatal_t)_code, _str);
  3749. }
  3750. virtual void traceVargs(const char* _filePath, uint16_t _line, const char* _format, va_list _argList) override
  3751. {
  3752. m_interface->vtbl->trace_vargs(m_interface, _filePath, _line, _format, _argList);
  3753. }
  3754. virtual void profilerBegin(const char* _name, uint32_t _abgr, const char* _filePath, uint16_t _line) override
  3755. {
  3756. m_interface->vtbl->profiler_begin(m_interface, _name, _abgr, _filePath, _line);
  3757. }
  3758. virtual void profilerBeginLiteral(const char* _name, uint32_t _abgr, const char* _filePath, uint16_t _line) override
  3759. {
  3760. m_interface->vtbl->profiler_begin_literal(m_interface, _name, _abgr, _filePath, _line);
  3761. }
  3762. virtual void profilerEnd() override
  3763. {
  3764. m_interface->vtbl->profiler_end(m_interface);
  3765. }
  3766. virtual uint32_t cacheReadSize(uint64_t _id) override
  3767. {
  3768. return m_interface->vtbl->cache_read_size(m_interface, _id);
  3769. }
  3770. virtual bool cacheRead(uint64_t _id, void* _data, uint32_t _size) override
  3771. {
  3772. return m_interface->vtbl->cache_read(m_interface, _id, _data, _size);
  3773. }
  3774. virtual void cacheWrite(uint64_t _id, const void* _data, uint32_t _size) override
  3775. {
  3776. m_interface->vtbl->cache_write(m_interface, _id, _data, _size);
  3777. }
  3778. virtual void screenShot(const char* _filePath, uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _data, uint32_t _size, bool _yflip) override
  3779. {
  3780. m_interface->vtbl->screen_shot(m_interface, _filePath, _width, _height, _pitch, _data, _size, _yflip);
  3781. }
  3782. virtual void captureBegin(uint32_t _width, uint32_t _height, uint32_t _pitch, TextureFormat::Enum _format, bool _yflip) override
  3783. {
  3784. m_interface->vtbl->capture_begin(m_interface, _width, _height, _pitch, (bgfx_texture_format_t)_format, _yflip);
  3785. }
  3786. virtual void captureEnd() override
  3787. {
  3788. m_interface->vtbl->capture_end(m_interface);
  3789. }
  3790. virtual void captureFrame(const void* _data, uint32_t _size) override
  3791. {
  3792. m_interface->vtbl->capture_frame(m_interface, _data, _size);
  3793. }
  3794. bgfx_callback_interface_t* m_interface;
  3795. };
  3796. class AllocatorC99 : public bx::AllocatorI
  3797. {
  3798. public:
  3799. virtual ~AllocatorC99()
  3800. {
  3801. }
  3802. virtual void* realloc(void* _ptr, size_t _size, size_t _align, const char* _file, uint32_t _line) override
  3803. {
  3804. return m_interface->vtbl->realloc(m_interface, _ptr, _size, _align, _file, _line);
  3805. }
  3806. bgfx_allocator_interface_t* m_interface;
  3807. };
  3808. } // namespace bgfx
  3809. BGFX_C_API void bgfx_vertex_decl_begin(bgfx_vertex_decl_t* _decl, bgfx_renderer_type_t _renderer)
  3810. {
  3811. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3812. decl->begin(bgfx::RendererType::Enum(_renderer) );
  3813. }
  3814. 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)
  3815. {
  3816. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3817. decl->add(bgfx::Attrib::Enum(_attrib)
  3818. , _num
  3819. , bgfx::AttribType::Enum(_type)
  3820. , _normalized
  3821. , _asInt
  3822. );
  3823. }
  3824. BGFX_C_API void bgfx_vertex_decl_skip(bgfx_vertex_decl_t* _decl, uint8_t _num)
  3825. {
  3826. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3827. decl->skip(_num);
  3828. }
  3829. BGFX_C_API void bgfx_vertex_decl_end(bgfx_vertex_decl_t* _decl)
  3830. {
  3831. bgfx::VertexDecl* decl = (bgfx::VertexDecl*)_decl;
  3832. decl->end();
  3833. }
  3834. 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)
  3835. {
  3836. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  3837. bgfx::vertexPack(_input, _inputNormalized, bgfx::Attrib::Enum(_attr), decl, _data, _index);
  3838. }
  3839. 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)
  3840. {
  3841. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  3842. bgfx::vertexUnpack(_output, bgfx::Attrib::Enum(_attr), decl, _data, _index);
  3843. }
  3844. 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)
  3845. {
  3846. bgfx::VertexDecl& destDecl = *(bgfx::VertexDecl*)_destDecl;
  3847. bgfx::VertexDecl& srcDecl = *(bgfx::VertexDecl*)_srcDecl;
  3848. bgfx::vertexConvert(destDecl, _destData, srcDecl, _srcData, _num);
  3849. }
  3850. 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)
  3851. {
  3852. bgfx::VertexDecl& decl = *(bgfx::VertexDecl*)_decl;
  3853. return bgfx::weldVertices(_output, decl, _data, _num, _epsilon);
  3854. }
  3855. uint32_t bgfx_topology_convert(bgfx_topology_convert_t _conversion, void* _dst, uint32_t _dstSize, const void* _indices, uint32_t _numIndices, bool _index32)
  3856. {
  3857. return bgfx::topologyConvert(bgfx::TopologyConvert::Enum(_conversion), _dst, _dstSize, _indices, _numIndices, _index32);
  3858. }
  3859. 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)
  3860. {
  3861. bgfx::topologySortTriList(bgfx::TopologySort::Enum(_sort), _dst, _dstSize, _dir, _pos, _vertices, _stride, _indices, _numIndices, _index32);
  3862. }
  3863. BGFX_C_API uint8_t bgfx_get_supported_renderers(uint8_t _max, bgfx_renderer_type_t* _enum)
  3864. {
  3865. return bgfx::getSupportedRenderers(_max, (bgfx::RendererType::Enum*)_enum);
  3866. }
  3867. BGFX_C_API const char* bgfx_get_renderer_name(bgfx_renderer_type_t _type)
  3868. {
  3869. return bgfx::getRendererName(bgfx::RendererType::Enum(_type) );
  3870. }
  3871. 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)
  3872. {
  3873. static bgfx::CallbackC99 s_callback;
  3874. s_callback.m_interface = _callback;
  3875. static bgfx::AllocatorC99 s_allocator;
  3876. s_allocator.m_interface = _allocator;
  3877. return bgfx::init(bgfx::RendererType::Enum(_type)
  3878. , _vendorId
  3879. , _deviceId
  3880. , NULL == _callback ? NULL : &s_callback
  3881. , NULL == _allocator ? NULL : &s_allocator
  3882. );
  3883. }
  3884. BGFX_C_API void bgfx_shutdown()
  3885. {
  3886. return bgfx::shutdown();
  3887. }
  3888. BGFX_C_API void bgfx_reset(uint32_t _width, uint32_t _height, uint32_t _flags)
  3889. {
  3890. bgfx::reset(_width, _height, _flags);
  3891. }
  3892. BGFX_C_API uint32_t bgfx_frame(bool _capture)
  3893. {
  3894. return bgfx::frame(_capture);
  3895. }
  3896. BGFX_C_API bgfx_renderer_type_t bgfx_get_renderer_type()
  3897. {
  3898. return bgfx_renderer_type_t(bgfx::getRendererType() );
  3899. }
  3900. BGFX_C_API const bgfx_caps_t* bgfx_get_caps()
  3901. {
  3902. return (const bgfx_caps_t*)bgfx::getCaps();
  3903. }
  3904. BGFX_C_API const bgfx_hmd_t* bgfx_get_hmd()
  3905. {
  3906. return (const bgfx_hmd_t*)bgfx::getHMD();
  3907. }
  3908. BGFX_C_API const bgfx_stats_t* bgfx_get_stats()
  3909. {
  3910. return (const bgfx_stats_t*)bgfx::getStats();
  3911. }
  3912. BGFX_C_API const bgfx_memory_t* bgfx_alloc(uint32_t _size)
  3913. {
  3914. return (const bgfx_memory_t*)bgfx::alloc(_size);
  3915. }
  3916. BGFX_C_API const bgfx_memory_t* bgfx_copy(const void* _data, uint32_t _size)
  3917. {
  3918. return (const bgfx_memory_t*)bgfx::copy(_data, _size);
  3919. }
  3920. BGFX_C_API const bgfx_memory_t* bgfx_make_ref(const void* _data, uint32_t _size)
  3921. {
  3922. return (const bgfx_memory_t*)bgfx::makeRef(_data, _size);
  3923. }
  3924. BGFX_C_API const bgfx_memory_t* bgfx_make_ref_release(const void* _data, uint32_t _size, bgfx_release_fn_t _releaseFn, void* _userData)
  3925. {
  3926. return (const bgfx_memory_t*)bgfx::makeRef(_data, _size, _releaseFn, _userData);
  3927. }
  3928. BGFX_C_API void bgfx_set_debug(uint32_t _debug)
  3929. {
  3930. bgfx::setDebug(_debug);
  3931. }
  3932. BGFX_C_API void bgfx_dbg_text_clear(uint8_t _attr, bool _small)
  3933. {
  3934. bgfx::dbgTextClear(_attr, _small);
  3935. }
  3936. BGFX_C_API void bgfx_dbg_text_printf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, ...)
  3937. {
  3938. va_list argList;
  3939. va_start(argList, _format);
  3940. bgfx::dbgTextPrintfVargs(_x, _y, _attr, _format, argList);
  3941. va_end(argList);
  3942. }
  3943. BGFX_C_API void bgfx_dbg_text_vprintf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, va_list _argList)
  3944. {
  3945. bgfx::dbgTextPrintfVargs(_x, _y, _attr, _format, _argList);
  3946. }
  3947. 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)
  3948. {
  3949. bgfx::dbgTextImage(_x, _y, _width, _height, _data, _pitch);
  3950. }
  3951. BGFX_C_API bgfx_index_buffer_handle_t bgfx_create_index_buffer(const bgfx_memory_t* _mem, uint16_t _flags)
  3952. {
  3953. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle;
  3954. handle.cpp = bgfx::createIndexBuffer( (const bgfx::Memory*)_mem, _flags);
  3955. return handle.c;
  3956. }
  3957. BGFX_C_API void bgfx_destroy_index_buffer(bgfx_index_buffer_handle_t _handle)
  3958. {
  3959. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  3960. bgfx::destroy(handle.cpp);
  3961. }
  3962. 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)
  3963. {
  3964. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3965. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle;
  3966. handle.cpp = bgfx::createVertexBuffer( (const bgfx::Memory*)_mem, decl, _flags);
  3967. return handle.c;
  3968. }
  3969. BGFX_C_API void bgfx_destroy_vertex_buffer(bgfx_vertex_buffer_handle_t _handle)
  3970. {
  3971. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  3972. bgfx::destroy(handle.cpp);
  3973. }
  3974. BGFX_C_API bgfx_dynamic_index_buffer_handle_t bgfx_create_dynamic_index_buffer(uint32_t _num, uint16_t _flags)
  3975. {
  3976. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle;
  3977. handle.cpp = bgfx::createDynamicIndexBuffer(_num, _flags);
  3978. return handle.c;
  3979. }
  3980. BGFX_C_API bgfx_dynamic_index_buffer_handle_t bgfx_create_dynamic_index_buffer_mem(const bgfx_memory_t* _mem, uint16_t _flags)
  3981. {
  3982. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle;
  3983. handle.cpp = bgfx::createDynamicIndexBuffer( (const bgfx::Memory*)_mem, _flags);
  3984. return handle.c;
  3985. }
  3986. BGFX_C_API void bgfx_update_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _startIndex, const bgfx_memory_t* _mem)
  3987. {
  3988. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  3989. bgfx::updateDynamicIndexBuffer(handle.cpp, _startIndex, (const bgfx::Memory*)_mem);
  3990. }
  3991. BGFX_C_API void bgfx_destroy_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle)
  3992. {
  3993. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  3994. bgfx::destroy(handle.cpp);
  3995. }
  3996. 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)
  3997. {
  3998. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  3999. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle;
  4000. handle.cpp = bgfx::createDynamicVertexBuffer(_num, decl, _flags);
  4001. return handle.c;
  4002. }
  4003. 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)
  4004. {
  4005. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4006. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle;
  4007. handle.cpp = bgfx::createDynamicVertexBuffer( (const bgfx::Memory*)_mem, decl, _flags);
  4008. return handle.c;
  4009. }
  4010. BGFX_C_API void bgfx_update_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, const bgfx_memory_t* _mem)
  4011. {
  4012. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4013. bgfx::updateDynamicVertexBuffer(handle.cpp, _startVertex, (const bgfx::Memory*)_mem);
  4014. }
  4015. BGFX_C_API void bgfx_destroy_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle)
  4016. {
  4017. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4018. bgfx::destroy(handle.cpp);
  4019. }
  4020. BGFX_C_API uint32_t bgfx_get_avail_transient_index_buffer(uint32_t _num)
  4021. {
  4022. return bgfx::getAvailTransientIndexBuffer(_num);
  4023. }
  4024. BGFX_C_API uint32_t bgfx_get_avail_transient_vertex_buffer(uint32_t _num, const bgfx_vertex_decl_t* _decl)
  4025. {
  4026. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4027. return bgfx::getAvailTransientVertexBuffer(_num, decl);
  4028. }
  4029. BGFX_C_API uint32_t bgfx_get_avail_instance_data_buffer(uint32_t _num, uint16_t _stride)
  4030. {
  4031. return bgfx::getAvailInstanceDataBuffer(_num, _stride);
  4032. }
  4033. BGFX_C_API void bgfx_alloc_transient_index_buffer(bgfx_transient_index_buffer_t* _tib, uint32_t _num)
  4034. {
  4035. bgfx::allocTransientIndexBuffer( (bgfx::TransientIndexBuffer*)_tib, _num);
  4036. }
  4037. BGFX_C_API void bgfx_alloc_transient_vertex_buffer(bgfx_transient_vertex_buffer_t* _tvb, uint32_t _num, const bgfx_vertex_decl_t* _decl)
  4038. {
  4039. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4040. bgfx::allocTransientVertexBuffer( (bgfx::TransientVertexBuffer*)_tvb, _num, decl);
  4041. }
  4042. 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)
  4043. {
  4044. const bgfx::VertexDecl& decl = *(const bgfx::VertexDecl*)_decl;
  4045. return bgfx::allocTransientBuffers( (bgfx::TransientVertexBuffer*)_tvb, decl, _numVertices, (bgfx::TransientIndexBuffer*)_tib, _numIndices);
  4046. }
  4047. BGFX_C_API void bgfx_alloc_instance_data_buffer(bgfx_instance_data_buffer_t* _idb, uint32_t _num, uint16_t _stride)
  4048. {
  4049. bgfx::allocInstanceDataBuffer( (bgfx::InstanceDataBuffer*)_idb, _num, _stride);
  4050. }
  4051. BGFX_C_API bgfx_indirect_buffer_handle_t bgfx_create_indirect_buffer(uint32_t _num)
  4052. {
  4053. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle;
  4054. handle.cpp = bgfx::createIndirectBuffer(_num);
  4055. return handle.c;
  4056. }
  4057. BGFX_C_API void bgfx_destroy_indirect_buffer(bgfx_indirect_buffer_handle_t _handle)
  4058. {
  4059. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle = { _handle };
  4060. bgfx::destroy(handle.cpp);
  4061. }
  4062. BGFX_C_API bgfx_shader_handle_t bgfx_create_shader(const bgfx_memory_t* _mem)
  4063. {
  4064. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle;
  4065. handle.cpp = bgfx::createShader( (const bgfx::Memory*)_mem);
  4066. return handle.c;
  4067. }
  4068. BGFX_C_API uint16_t bgfx_get_shader_uniforms(bgfx_shader_handle_t _handle, bgfx_uniform_handle_t* _uniforms, uint16_t _max)
  4069. {
  4070. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle = { _handle };
  4071. return bgfx::getShaderUniforms(handle.cpp, (bgfx::UniformHandle*)_uniforms, _max);
  4072. }
  4073. BGFX_C_API void bgfx_set_shader_name(bgfx_shader_handle_t _handle, const char* _name)
  4074. {
  4075. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle = { _handle };
  4076. bgfx::setName(handle.cpp, _name);
  4077. }
  4078. BGFX_C_API void bgfx_destroy_shader(bgfx_shader_handle_t _handle)
  4079. {
  4080. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } handle = { _handle };
  4081. bgfx::destroy(handle.cpp);
  4082. }
  4083. BGFX_C_API bgfx_program_handle_t bgfx_create_program(bgfx_shader_handle_t _vsh, bgfx_shader_handle_t _fsh, bool _destroyShaders)
  4084. {
  4085. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } vsh = { _vsh };
  4086. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } fsh = { _fsh };
  4087. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle;
  4088. handle.cpp = bgfx::createProgram(vsh.cpp, fsh.cpp, _destroyShaders);
  4089. return handle.c;
  4090. }
  4091. BGFX_C_API bgfx_program_handle_t bgfx_create_compute_program(bgfx_shader_handle_t _csh, bool _destroyShaders)
  4092. {
  4093. union { bgfx_shader_handle_t c; bgfx::ShaderHandle cpp; } csh = { _csh };
  4094. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle;
  4095. handle.cpp = bgfx::createProgram(csh.cpp, _destroyShaders);
  4096. return handle.c;
  4097. }
  4098. BGFX_C_API void bgfx_destroy_program(bgfx_program_handle_t _handle)
  4099. {
  4100. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4101. bgfx::destroy(handle.cpp);
  4102. }
  4103. BGFX_C_API bool bgfx_is_texture_valid(uint16_t _depth, bool _cubeMap, uint16_t _numLayers, bgfx_texture_format_t _format, uint32_t _flags)
  4104. {
  4105. return bgfx::isTextureValid(_depth, _cubeMap, _numLayers, bgfx::TextureFormat::Enum(_format), _flags);
  4106. }
  4107. 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)
  4108. {
  4109. bgfx::TextureInfo& info = *(bgfx::TextureInfo*)_info;
  4110. bgfx::calcTextureSize(info, _width, _height, _depth, _cubeMap, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format) );
  4111. }
  4112. 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)
  4113. {
  4114. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4115. bgfx::TextureInfo* info = (bgfx::TextureInfo*)_info;
  4116. handle.cpp = bgfx::createTexture( (const bgfx::Memory*)_mem, _flags, _skip, info);
  4117. return handle.c;
  4118. }
  4119. 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)
  4120. {
  4121. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4122. handle.cpp = bgfx::createTexture2D(_width, _height, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  4123. return handle.c;
  4124. }
  4125. 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)
  4126. {
  4127. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4128. handle.cpp = bgfx::createTexture2D(bgfx::BackbufferRatio::Enum(_ratio), _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags);
  4129. return handle.c;
  4130. }
  4131. 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)
  4132. {
  4133. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4134. handle.cpp = bgfx::createTexture3D(_width, _height, _depth, _hasMips, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  4135. return handle.c;
  4136. }
  4137. 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)
  4138. {
  4139. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle;
  4140. handle.cpp = bgfx::createTextureCube(_size, _hasMips, _numLayers, bgfx::TextureFormat::Enum(_format), _flags, (const bgfx::Memory*)_mem);
  4141. return handle.c;
  4142. }
  4143. 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)
  4144. {
  4145. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4146. bgfx::updateTexture2D(handle.cpp, _layer, _mip, _x, _y, _width, _height, (const bgfx::Memory*)_mem, _pitch);
  4147. }
  4148. 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)
  4149. {
  4150. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4151. bgfx::updateTexture3D(handle.cpp, _mip, _x, _y, _z, _width, _height, _depth, (const bgfx::Memory*)_mem);
  4152. }
  4153. 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)
  4154. {
  4155. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4156. bgfx::updateTextureCube(handle.cpp, _layer, _side, _mip, _x, _y, _width, _height, (const bgfx::Memory*)_mem, _pitch);
  4157. }
  4158. BGFX_C_API uint32_t bgfx_read_texture(bgfx_texture_handle_t _handle, void* _data, uint8_t _mip)
  4159. {
  4160. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4161. return bgfx::readTexture(handle.cpp, _data, _mip);
  4162. }
  4163. BGFX_C_API void bgfx_set_texture_name(bgfx_texture_handle_t _handle, const char* _name)
  4164. {
  4165. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4166. bgfx::setName(handle.cpp, _name);
  4167. }
  4168. BGFX_C_API void* bgfx_get_direct_access_ptr(bgfx_texture_handle_t _handle)
  4169. {
  4170. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4171. return bgfx::getDirectAccessPtr(handle.cpp);
  4172. }
  4173. BGFX_C_API void bgfx_destroy_texture(bgfx_texture_handle_t _handle)
  4174. {
  4175. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4176. bgfx::destroy(handle.cpp);
  4177. }
  4178. 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)
  4179. {
  4180. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4181. handle.cpp = bgfx::createFrameBuffer(_width, _height, bgfx::TextureFormat::Enum(_format), _textureFlags);
  4182. return handle.c;
  4183. }
  4184. 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)
  4185. {
  4186. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4187. handle.cpp = bgfx::createFrameBuffer(bgfx::BackbufferRatio::Enum(_ratio), bgfx::TextureFormat::Enum(_format), _textureFlags);
  4188. return handle.c;
  4189. }
  4190. 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)
  4191. {
  4192. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4193. handle.cpp = bgfx::createFrameBuffer(_num, (const bgfx::TextureHandle*)_handles, _destroyTextures);
  4194. return handle.c;
  4195. }
  4196. BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_from_attachment(uint8_t _num, const bgfx_attachment_t* _attachment, bool _destroyTextures)
  4197. {
  4198. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4199. handle.cpp = bgfx::createFrameBuffer(_num, (const bgfx::Attachment*)_attachment, _destroyTextures);
  4200. return handle.c;
  4201. }
  4202. 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)
  4203. {
  4204. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle;
  4205. handle.cpp = bgfx::createFrameBuffer(_nwh, _width, _height, bgfx::TextureFormat::Enum(_depthFormat) );
  4206. return handle.c;
  4207. }
  4208. BGFX_C_API bgfx_texture_handle_t bgfx_get_texture(bgfx_frame_buffer_handle_t _handle, uint8_t _attachment)
  4209. {
  4210. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  4211. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } textureHandle;
  4212. textureHandle.cpp = bgfx::getTexture(handle.cpp, _attachment);
  4213. return textureHandle.c;
  4214. }
  4215. BGFX_C_API void bgfx_destroy_frame_buffer(bgfx_frame_buffer_handle_t _handle)
  4216. {
  4217. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  4218. bgfx::destroy(handle.cpp);
  4219. }
  4220. BGFX_C_API bgfx_uniform_handle_t bgfx_create_uniform(const char* _name, bgfx_uniform_type_t _type, uint16_t _num)
  4221. {
  4222. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle;
  4223. handle.cpp = bgfx::createUniform(_name, bgfx::UniformType::Enum(_type), _num);
  4224. return handle.c;
  4225. }
  4226. BGFX_C_API void bgfx_get_uniform_info(bgfx_uniform_handle_t _handle, bgfx_uniform_info_t* _info)
  4227. {
  4228. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  4229. bgfx::UniformInfo& info = *(bgfx::UniformInfo*)_info;
  4230. bgfx::getUniformInfo(handle.cpp, info);
  4231. }
  4232. BGFX_C_API void bgfx_destroy_uniform(bgfx_uniform_handle_t _handle)
  4233. {
  4234. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  4235. bgfx::destroy(handle.cpp);
  4236. }
  4237. BGFX_C_API bgfx_occlusion_query_handle_t bgfx_create_occlusion_query()
  4238. {
  4239. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle;
  4240. handle.cpp = bgfx::createOcclusionQuery();
  4241. return handle.c;
  4242. }
  4243. BGFX_C_API bgfx_occlusion_query_result_t bgfx_get_result(bgfx_occlusion_query_handle_t _handle, int32_t* _result)
  4244. {
  4245. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  4246. return bgfx_occlusion_query_result_t(bgfx::getResult(handle.cpp, _result) );
  4247. }
  4248. BGFX_C_API void bgfx_destroy_occlusion_query(bgfx_occlusion_query_handle_t _handle)
  4249. {
  4250. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  4251. bgfx::destroy(handle.cpp);
  4252. }
  4253. BGFX_C_API void bgfx_set_palette_color(uint8_t _index, const float _rgba[4])
  4254. {
  4255. bgfx::setPaletteColor(_index, _rgba);
  4256. }
  4257. BGFX_C_API void bgfx_set_view_name(bgfx_view_id_t _id, const char* _name)
  4258. {
  4259. bgfx::setViewName(_id, _name);
  4260. }
  4261. 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)
  4262. {
  4263. bgfx::setViewRect(_id, _x, _y, _width, _height);
  4264. }
  4265. 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)
  4266. {
  4267. bgfx::setViewRect(_id, _x, _y, bgfx::BackbufferRatio::Enum(_ratio));
  4268. }
  4269. 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)
  4270. {
  4271. bgfx::setViewScissor(_id, _x, _y, _width, _height);
  4272. }
  4273. BGFX_C_API void bgfx_set_view_clear(bgfx_view_id_t _id, uint16_t _flags, uint32_t _rgba, float _depth, uint8_t _stencil)
  4274. {
  4275. bgfx::setViewClear(_id, _flags, _rgba, _depth, _stencil);
  4276. }
  4277. 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)
  4278. {
  4279. bgfx::setViewClear(_id, _flags, _depth, _stencil, _0, _1, _2, _3, _4, _5, _6, _7);
  4280. }
  4281. BGFX_C_API void bgfx_set_view_mode(bgfx_view_id_t _id, bgfx_view_mode_t _mode)
  4282. {
  4283. bgfx::setViewMode(_id, bgfx::ViewMode::Enum(_mode) );
  4284. }
  4285. BGFX_C_API void bgfx_set_view_frame_buffer(bgfx_view_id_t _id, bgfx_frame_buffer_handle_t _handle)
  4286. {
  4287. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  4288. bgfx::setViewFrameBuffer(_id, handle.cpp);
  4289. }
  4290. BGFX_C_API void bgfx_set_view_transform(bgfx_view_id_t _id, const void* _view, const void* _proj)
  4291. {
  4292. bgfx::setViewTransform(_id, _view, _proj);
  4293. }
  4294. 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)
  4295. {
  4296. bgfx::setViewTransform(_id, _view, _projL, _flags, _projR);
  4297. }
  4298. BGFX_C_API void bgfx_set_view_order(bgfx_view_id_t _id, uint16_t _num, const bgfx_view_id_t* _order)
  4299. {
  4300. bgfx::setViewOrder(_id, _num, _order);
  4301. }
  4302. BGFX_C_API void bgfx_reset_view(bgfx_view_id_t _id)
  4303. {
  4304. bgfx::resetView(_id);
  4305. }
  4306. BGFX_C_API void bgfx_set_marker(const char* _marker)
  4307. {
  4308. bgfx::setMarker(_marker);
  4309. }
  4310. BGFX_C_API void bgfx_set_state(uint64_t _state, uint32_t _rgba)
  4311. {
  4312. bgfx::setState(_state, _rgba);
  4313. }
  4314. BGFX_C_API void bgfx_set_condition(bgfx_occlusion_query_handle_t _handle, bool _visible)
  4315. {
  4316. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  4317. bgfx::setCondition(handle.cpp, _visible);
  4318. }
  4319. BGFX_C_API void bgfx_set_stencil(uint32_t _fstencil, uint32_t _bstencil)
  4320. {
  4321. bgfx::setStencil(_fstencil, _bstencil);
  4322. }
  4323. BGFX_C_API uint16_t bgfx_set_scissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  4324. {
  4325. return bgfx::setScissor(_x, _y, _width, _height);
  4326. }
  4327. BGFX_C_API void bgfx_set_scissor_cached(uint16_t _cache)
  4328. {
  4329. bgfx::setScissor(_cache);
  4330. }
  4331. BGFX_C_API uint32_t bgfx_set_transform(const void* _mtx, uint16_t _num)
  4332. {
  4333. return bgfx::setTransform(_mtx, _num);
  4334. }
  4335. BGFX_C_API uint32_t bgfx_alloc_transform(bgfx_transform_t* _transform, uint16_t _num)
  4336. {
  4337. return bgfx::allocTransform( (bgfx::Transform*)_transform, _num);
  4338. }
  4339. BGFX_C_API void bgfx_set_transform_cached(uint32_t _cache, uint16_t _num)
  4340. {
  4341. bgfx::setTransform(_cache, _num);
  4342. }
  4343. BGFX_C_API void bgfx_set_uniform(bgfx_uniform_handle_t _handle, const void* _value, uint16_t _num)
  4344. {
  4345. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  4346. bgfx::setUniform(handle.cpp, _value, _num);
  4347. }
  4348. BGFX_C_API void bgfx_set_index_buffer(bgfx_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  4349. {
  4350. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4351. bgfx::setIndexBuffer(handle.cpp, _firstIndex, _numIndices);
  4352. }
  4353. BGFX_C_API void bgfx_set_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  4354. {
  4355. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4356. bgfx::setIndexBuffer(handle.cpp, _firstIndex, _numIndices);
  4357. }
  4358. BGFX_C_API void bgfx_set_transient_index_buffer(const bgfx_transient_index_buffer_t* _tib, uint32_t _firstIndex, uint32_t _numIndices)
  4359. {
  4360. bgfx::setIndexBuffer( (const bgfx::TransientIndexBuffer*)_tib, _firstIndex, _numIndices);
  4361. }
  4362. BGFX_C_API void bgfx_set_vertex_buffer(uint8_t _stream, bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _numVertices)
  4363. {
  4364. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4365. bgfx::setVertexBuffer(_stream, handle.cpp, _startVertex, _numVertices);
  4366. }
  4367. 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)
  4368. {
  4369. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4370. bgfx::setVertexBuffer(_stream, handle.cpp, _startVertex, _numVertices);
  4371. }
  4372. 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)
  4373. {
  4374. bgfx::setVertexBuffer(_stream, (const bgfx::TransientVertexBuffer*)_tvb, _startVertex, _numVertices);
  4375. }
  4376. BGFX_C_API void bgfx_set_instance_data_buffer(const bgfx_instance_data_buffer_t* _idb, uint32_t _num)
  4377. {
  4378. bgfx::setInstanceDataBuffer( (const bgfx::InstanceDataBuffer*)_idb, _num);
  4379. }
  4380. BGFX_C_API void bgfx_set_instance_data_from_vertex_buffer(bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _num)
  4381. {
  4382. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4383. bgfx::setInstanceDataBuffer(handle.cpp, _startVertex, _num);
  4384. }
  4385. 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)
  4386. {
  4387. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4388. bgfx::setInstanceDataBuffer(handle.cpp, _startVertex, _num);
  4389. }
  4390. BGFX_C_API void bgfx_set_texture(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_texture_handle_t _handle, uint32_t _flags)
  4391. {
  4392. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  4393. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4394. bgfx::setTexture(_stage, sampler.cpp, handle.cpp, _flags);
  4395. }
  4396. BGFX_C_API void bgfx_touch(bgfx_view_id_t _id)
  4397. {
  4398. return bgfx::touch(_id);
  4399. }
  4400. BGFX_C_API void bgfx_submit(bgfx_view_id_t _id, bgfx_program_handle_t _handle, int32_t _depth, bool _preserveState)
  4401. {
  4402. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4403. bgfx::submit(_id, handle.cpp, _depth, _preserveState);
  4404. }
  4405. 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)
  4406. {
  4407. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } program = { _program };
  4408. union { bgfx_occlusion_query_handle c; bgfx::OcclusionQueryHandle cpp; } occlusionQuery = { _occlusionQuery };
  4409. bgfx::submit(_id, program.cpp, occlusionQuery.cpp, _depth, _preserveState);
  4410. }
  4411. 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)
  4412. {
  4413. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4414. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  4415. bgfx::submit(_id, handle.cpp, indirectHandle.cpp, _start, _num, _depth, _preserveState);
  4416. }
  4417. BGFX_C_API void bgfx_set_image(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_texture_handle_t _handle, uint8_t _mip, bgfx_access_t _access, bgfx_texture_format_t _format)
  4418. {
  4419. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  4420. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4421. bgfx::setImage(_stage, sampler.cpp, handle.cpp, _mip, bgfx::Access::Enum(_access), bgfx::TextureFormat::Enum(_format) );
  4422. }
  4423. BGFX_C_API void bgfx_set_compute_index_buffer(uint8_t _stage, bgfx_index_buffer_handle_t _handle, bgfx_access_t _access)
  4424. {
  4425. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4426. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4427. }
  4428. BGFX_C_API void bgfx_set_compute_vertex_buffer(uint8_t _stage, bgfx_vertex_buffer_handle_t _handle, bgfx_access_t _access)
  4429. {
  4430. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4431. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4432. }
  4433. BGFX_C_API void bgfx_set_compute_dynamic_index_buffer(uint8_t _stage, bgfx_dynamic_index_buffer_handle_t _handle, bgfx_access_t _access)
  4434. {
  4435. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4436. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4437. }
  4438. BGFX_C_API void bgfx_set_compute_dynamic_vertex_buffer(uint8_t _stage, bgfx_dynamic_vertex_buffer_handle_t _handle, bgfx_access_t _access)
  4439. {
  4440. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4441. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4442. }
  4443. BGFX_C_API void bgfx_set_compute_indirect_buffer(uint8_t _stage, bgfx_indirect_buffer_handle_t _handle, bgfx_access_t _access)
  4444. {
  4445. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle = { _handle };
  4446. bgfx::setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) );
  4447. }
  4448. 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)
  4449. {
  4450. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4451. bgfx::dispatch(_id, handle.cpp, _numX, _numY, _numZ, _flags);
  4452. }
  4453. 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)
  4454. {
  4455. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4456. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  4457. bgfx::dispatch(_id, handle.cpp, indirectHandle.cpp, _start, _num, _flags);
  4458. }
  4459. BGFX_C_API void bgfx_discard()
  4460. {
  4461. bgfx::discard();
  4462. }
  4463. 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)
  4464. {
  4465. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } dst = { _dst };
  4466. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } src = { _src };
  4467. bgfx::blit(_id, dst.cpp, _dstMip, _dstX, _dstY, _dstZ, src.cpp, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth);
  4468. }
  4469. #define BGFX_ENCODER(_func) reinterpret_cast<bgfx::Encoder*>(_encoder)->_func
  4470. BGFX_C_API void bgfx_encoder_set_marker(bgfx_encoder* _encoder, const char* _marker)
  4471. {
  4472. BGFX_ENCODER(setMarker(_marker) );
  4473. }
  4474. BGFX_C_API void bgfx_encoder_set_state(bgfx_encoder* _encoder, uint64_t _state, uint32_t _rgba)
  4475. {
  4476. BGFX_ENCODER(setState(_state, _rgba) );
  4477. }
  4478. BGFX_C_API void bgfx_encoder_set_condition(bgfx_encoder* _encoder, bgfx_occlusion_query_handle_t _handle, bool _visible)
  4479. {
  4480. union { bgfx_occlusion_query_handle_t c; bgfx::OcclusionQueryHandle cpp; } handle = { _handle };
  4481. BGFX_ENCODER(setCondition(handle.cpp, _visible) );
  4482. }
  4483. BGFX_C_API void bgfx_encoder_set_stencil(bgfx_encoder* _encoder, uint32_t _fstencil, uint32_t _bstencil)
  4484. {
  4485. BGFX_ENCODER(setStencil(_fstencil, _bstencil) );
  4486. }
  4487. BGFX_C_API uint16_t bgfx_encoder_set_scissor(bgfx_encoder* _encoder, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height)
  4488. {
  4489. return BGFX_ENCODER(setScissor(_x, _y, _width, _height) );
  4490. }
  4491. BGFX_C_API void bgfx_encoder_set_scissor_cached(bgfx_encoder* _encoder, uint16_t _cache)
  4492. {
  4493. BGFX_ENCODER(setScissor(_cache) );
  4494. }
  4495. BGFX_C_API uint32_t bgfx_encoder_set_transform(bgfx_encoder* _encoder, const void* _mtx, uint16_t _num)
  4496. {
  4497. return BGFX_ENCODER(setTransform(_mtx, _num) );
  4498. }
  4499. BGFX_C_API uint32_t bgfx_encoder_alloc_transform(bgfx_encoder* _encoder, bgfx_transform_t* _transform, uint16_t _num)
  4500. {
  4501. return BGFX_ENCODER(allocTransform( (bgfx::Transform*)_transform, _num) );
  4502. }
  4503. BGFX_C_API void bgfx_encoder_set_transform_cached(bgfx_encoder* _encoder, uint32_t _cache, uint16_t _num)
  4504. {
  4505. BGFX_ENCODER(setTransform(_cache, _num) );
  4506. }
  4507. BGFX_C_API void bgfx_encoder_set_uniform(bgfx_encoder* _encoder, bgfx_uniform_handle_t _handle, const void* _value, uint16_t _num)
  4508. {
  4509. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } handle = { _handle };
  4510. BGFX_ENCODER(setUniform(handle.cpp, _value, _num) );
  4511. }
  4512. BGFX_C_API void bgfx_encoder_set_index_buffer(bgfx_encoder* _encoder, bgfx_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices)
  4513. {
  4514. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4515. BGFX_ENCODER(setIndexBuffer(handle.cpp, _firstIndex, _numIndices) );
  4516. }
  4517. 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)
  4518. {
  4519. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4520. BGFX_ENCODER(setIndexBuffer(handle.cpp, _firstIndex, _numIndices) );
  4521. }
  4522. 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)
  4523. {
  4524. BGFX_ENCODER(setIndexBuffer( (const bgfx::TransientIndexBuffer*)_tib, _firstIndex, _numIndices) );
  4525. }
  4526. 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)
  4527. {
  4528. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4529. BGFX_ENCODER(setVertexBuffer(_stream, handle.cpp, _startVertex, _numVertices) );
  4530. }
  4531. 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)
  4532. {
  4533. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4534. BGFX_ENCODER(setVertexBuffer(_stream, handle.cpp, _startVertex, _numVertices) );
  4535. }
  4536. 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)
  4537. {
  4538. BGFX_ENCODER(setVertexBuffer(_stream, (const bgfx::TransientVertexBuffer*)_tvb, _startVertex, _numVertices) );
  4539. }
  4540. BGFX_C_API void bgfx_encoder_set_instance_data_buffer(bgfx_encoder* _encoder, const bgfx_instance_data_buffer_t* _idb, uint32_t _num)
  4541. {
  4542. BGFX_ENCODER(setInstanceDataBuffer( (const bgfx::InstanceDataBuffer*)_idb, _num) );
  4543. }
  4544. 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)
  4545. {
  4546. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4547. BGFX_ENCODER(setInstanceDataBuffer(handle.cpp, _startVertex, _num) );
  4548. }
  4549. 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)
  4550. {
  4551. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4552. BGFX_ENCODER(setInstanceDataBuffer(handle.cpp, _startVertex, _num) );
  4553. }
  4554. 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)
  4555. {
  4556. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  4557. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4558. BGFX_ENCODER(setTexture(_stage, sampler.cpp, handle.cpp, _flags) );
  4559. }
  4560. BGFX_C_API void bgfx_encoder_touch(bgfx_encoder* _encoder, bgfx_view_id_t _id)
  4561. {
  4562. return BGFX_ENCODER(touch(_id) );
  4563. }
  4564. 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)
  4565. {
  4566. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4567. BGFX_ENCODER(submit(_id, handle.cpp, _depth, _preserveState) );
  4568. }
  4569. 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)
  4570. {
  4571. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } program = { _program };
  4572. union { bgfx_occlusion_query_handle c; bgfx::OcclusionQueryHandle cpp; } occlusionQuery = { _occlusionQuery };
  4573. BGFX_ENCODER(submit(_id, program.cpp, occlusionQuery.cpp, _depth, _preserveState) );
  4574. }
  4575. 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)
  4576. {
  4577. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4578. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  4579. BGFX_ENCODER(submit(_id, handle.cpp, indirectHandle.cpp, _start, _num, _depth, _preserveState) );
  4580. }
  4581. BGFX_C_API void bgfx_encoder_set_image(bgfx_encoder* _encoder, uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_texture_handle_t _handle, uint8_t _mip, bgfx_access_t _access, bgfx_texture_format_t _format)
  4582. {
  4583. union { bgfx_uniform_handle_t c; bgfx::UniformHandle cpp; } sampler = { _sampler };
  4584. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4585. BGFX_ENCODER(setImage(_stage, sampler.cpp, handle.cpp, _mip, bgfx::Access::Enum(_access), bgfx::TextureFormat::Enum(_format) ) );
  4586. }
  4587. 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)
  4588. {
  4589. union { bgfx_index_buffer_handle_t c; bgfx::IndexBufferHandle cpp; } handle = { _handle };
  4590. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4591. }
  4592. 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)
  4593. {
  4594. union { bgfx_vertex_buffer_handle_t c; bgfx::VertexBufferHandle cpp; } handle = { _handle };
  4595. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4596. }
  4597. 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)
  4598. {
  4599. union { bgfx_dynamic_index_buffer_handle_t c; bgfx::DynamicIndexBufferHandle cpp; } handle = { _handle };
  4600. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4601. }
  4602. 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)
  4603. {
  4604. union { bgfx_dynamic_vertex_buffer_handle_t c; bgfx::DynamicVertexBufferHandle cpp; } handle = { _handle };
  4605. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4606. }
  4607. 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)
  4608. {
  4609. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } handle = { _handle };
  4610. BGFX_ENCODER(setBuffer(_stage, handle.cpp, bgfx::Access::Enum(_access) ) );
  4611. }
  4612. 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)
  4613. {
  4614. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4615. BGFX_ENCODER(dispatch(_id, handle.cpp, _numX, _numY, _numZ, _flags) );
  4616. }
  4617. 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)
  4618. {
  4619. union { bgfx_program_handle_t c; bgfx::ProgramHandle cpp; } handle = { _handle };
  4620. union { bgfx_indirect_buffer_handle_t c; bgfx::IndirectBufferHandle cpp; } indirectHandle = { _indirectHandle };
  4621. BGFX_ENCODER(dispatch(_id, handle.cpp, indirectHandle.cpp, _start, _num, _flags) );
  4622. }
  4623. BGFX_C_API void bgfx_encoder_discard(bgfx_encoder* _encoder)
  4624. {
  4625. BGFX_ENCODER(discard() );
  4626. }
  4627. 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)
  4628. {
  4629. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } dst = { _dst };
  4630. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } src = { _src };
  4631. BGFX_ENCODER(blit(_id, dst.cpp, _dstMip, _dstX, _dstY, _dstZ, src.cpp, _srcMip, _srcX, _srcY, _srcZ, _width, _height, _depth) );
  4632. }
  4633. #undef BGFX_ENCODER
  4634. BGFX_C_API void bgfx_request_screen_shot(bgfx_frame_buffer_handle _handle, const char* _filePath)
  4635. {
  4636. union { bgfx_frame_buffer_handle_t c; bgfx::FrameBufferHandle cpp; } handle = { _handle };
  4637. bgfx::requestScreenShot(handle.cpp, _filePath);
  4638. }
  4639. BGFX_C_API bgfx_render_frame_t bgfx_render_frame(int32_t _msecs)
  4640. {
  4641. return bgfx_render_frame_t(bgfx::renderFrame(_msecs) );
  4642. }
  4643. BGFX_C_API void bgfx_set_platform_data(const bgfx_platform_data_t* _data)
  4644. {
  4645. bgfx::setPlatformData(*(const bgfx::PlatformData*)_data);
  4646. }
  4647. BGFX_C_API const bgfx_internal_data_t* bgfx_get_internal_data()
  4648. {
  4649. return (const bgfx_internal_data_t*)bgfx::getInternalData();
  4650. }
  4651. BGFX_C_API uintptr_t bgfx_override_internal_texture_ptr(bgfx_texture_handle_t _handle, uintptr_t _ptr)
  4652. {
  4653. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4654. return bgfx::overrideInternal(handle.cpp, _ptr);
  4655. }
  4656. 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)
  4657. {
  4658. union { bgfx_texture_handle_t c; bgfx::TextureHandle cpp; } handle = { _handle };
  4659. return bgfx::overrideInternal(handle.cpp, _width, _height, _numMips, bgfx::TextureFormat::Enum(_format), _flags);
  4660. }
  4661. BGFX_C_API bgfx_interface_vtbl_t* bgfx_get_interface(uint32_t _version)
  4662. {
  4663. if (_version == BGFX_API_VERSION)
  4664. {
  4665. #define BGFX_IMPORT \
  4666. BGFX_IMPORT_FUNC(render_frame) \
  4667. BGFX_IMPORT_FUNC(set_platform_data) \
  4668. BGFX_IMPORT_FUNC(get_internal_data) \
  4669. BGFX_IMPORT_FUNC(override_internal_texture_ptr) \
  4670. BGFX_IMPORT_FUNC(override_internal_texture) \
  4671. BGFX_IMPORT_FUNC(vertex_decl_begin) \
  4672. BGFX_IMPORT_FUNC(vertex_decl_add) \
  4673. BGFX_IMPORT_FUNC(vertex_decl_skip) \
  4674. BGFX_IMPORT_FUNC(vertex_decl_end) \
  4675. BGFX_IMPORT_FUNC(vertex_pack) \
  4676. BGFX_IMPORT_FUNC(vertex_unpack) \
  4677. BGFX_IMPORT_FUNC(vertex_convert) \
  4678. BGFX_IMPORT_FUNC(weld_vertices) \
  4679. BGFX_IMPORT_FUNC(topology_convert) \
  4680. BGFX_IMPORT_FUNC(topology_sort_tri_list) \
  4681. BGFX_IMPORT_FUNC(get_supported_renderers) \
  4682. BGFX_IMPORT_FUNC(get_renderer_name) \
  4683. BGFX_IMPORT_FUNC(init) \
  4684. BGFX_IMPORT_FUNC(shutdown) \
  4685. BGFX_IMPORT_FUNC(reset) \
  4686. BGFX_IMPORT_FUNC(frame) \
  4687. BGFX_IMPORT_FUNC(get_renderer_type) \
  4688. BGFX_IMPORT_FUNC(get_caps) \
  4689. BGFX_IMPORT_FUNC(get_hmd) \
  4690. BGFX_IMPORT_FUNC(get_stats) \
  4691. BGFX_IMPORT_FUNC(alloc) \
  4692. BGFX_IMPORT_FUNC(copy) \
  4693. BGFX_IMPORT_FUNC(make_ref) \
  4694. BGFX_IMPORT_FUNC(make_ref_release) \
  4695. BGFX_IMPORT_FUNC(set_debug) \
  4696. BGFX_IMPORT_FUNC(dbg_text_clear) \
  4697. BGFX_IMPORT_FUNC(dbg_text_printf) \
  4698. BGFX_IMPORT_FUNC(dbg_text_vprintf) \
  4699. BGFX_IMPORT_FUNC(dbg_text_image) \
  4700. BGFX_IMPORT_FUNC(create_index_buffer) \
  4701. BGFX_IMPORT_FUNC(destroy_index_buffer) \
  4702. BGFX_IMPORT_FUNC(create_vertex_buffer) \
  4703. BGFX_IMPORT_FUNC(destroy_vertex_buffer) \
  4704. BGFX_IMPORT_FUNC(create_dynamic_index_buffer) \
  4705. BGFX_IMPORT_FUNC(create_dynamic_index_buffer_mem) \
  4706. BGFX_IMPORT_FUNC(update_dynamic_index_buffer) \
  4707. BGFX_IMPORT_FUNC(destroy_dynamic_index_buffer) \
  4708. BGFX_IMPORT_FUNC(create_dynamic_vertex_buffer) \
  4709. BGFX_IMPORT_FUNC(create_dynamic_vertex_buffer_mem) \
  4710. BGFX_IMPORT_FUNC(update_dynamic_vertex_buffer) \
  4711. BGFX_IMPORT_FUNC(destroy_dynamic_vertex_buffer) \
  4712. BGFX_IMPORT_FUNC(get_avail_transient_index_buffer) \
  4713. BGFX_IMPORT_FUNC(get_avail_transient_vertex_buffer) \
  4714. BGFX_IMPORT_FUNC(get_avail_instance_data_buffer) \
  4715. BGFX_IMPORT_FUNC(alloc_transient_index_buffer) \
  4716. BGFX_IMPORT_FUNC(alloc_transient_vertex_buffer) \
  4717. BGFX_IMPORT_FUNC(alloc_transient_buffers) \
  4718. BGFX_IMPORT_FUNC(alloc_instance_data_buffer) \
  4719. BGFX_IMPORT_FUNC(create_indirect_buffer) \
  4720. BGFX_IMPORT_FUNC(destroy_indirect_buffer) \
  4721. BGFX_IMPORT_FUNC(create_shader) \
  4722. BGFX_IMPORT_FUNC(get_shader_uniforms) \
  4723. BGFX_IMPORT_FUNC(set_shader_name) \
  4724. BGFX_IMPORT_FUNC(destroy_shader) \
  4725. BGFX_IMPORT_FUNC(create_program) \
  4726. BGFX_IMPORT_FUNC(create_compute_program) \
  4727. BGFX_IMPORT_FUNC(destroy_program) \
  4728. BGFX_IMPORT_FUNC(is_texture_valid) \
  4729. BGFX_IMPORT_FUNC(calc_texture_size) \
  4730. BGFX_IMPORT_FUNC(create_texture) \
  4731. BGFX_IMPORT_FUNC(create_texture_2d) \
  4732. BGFX_IMPORT_FUNC(create_texture_2d_scaled) \
  4733. BGFX_IMPORT_FUNC(create_texture_3d) \
  4734. BGFX_IMPORT_FUNC(create_texture_cube) \
  4735. BGFX_IMPORT_FUNC(update_texture_2d) \
  4736. BGFX_IMPORT_FUNC(update_texture_3d) \
  4737. BGFX_IMPORT_FUNC(update_texture_cube) \
  4738. BGFX_IMPORT_FUNC(read_texture) \
  4739. BGFX_IMPORT_FUNC(set_texture_name) \
  4740. BGFX_IMPORT_FUNC(get_direct_access_ptr) \
  4741. BGFX_IMPORT_FUNC(destroy_texture) \
  4742. BGFX_IMPORT_FUNC(create_frame_buffer) \
  4743. BGFX_IMPORT_FUNC(create_frame_buffer_scaled) \
  4744. BGFX_IMPORT_FUNC(create_frame_buffer_from_attachment) \
  4745. BGFX_IMPORT_FUNC(create_frame_buffer_from_nwh) \
  4746. BGFX_IMPORT_FUNC(get_texture) \
  4747. BGFX_IMPORT_FUNC(destroy_frame_buffer) \
  4748. BGFX_IMPORT_FUNC(create_uniform) \
  4749. BGFX_IMPORT_FUNC(get_uniform_info) \
  4750. BGFX_IMPORT_FUNC(destroy_uniform) \
  4751. BGFX_IMPORT_FUNC(create_occlusion_query) \
  4752. BGFX_IMPORT_FUNC(get_result) \
  4753. BGFX_IMPORT_FUNC(destroy_occlusion_query) \
  4754. BGFX_IMPORT_FUNC(set_palette_color) \
  4755. BGFX_IMPORT_FUNC(set_view_name) \
  4756. BGFX_IMPORT_FUNC(set_view_rect) \
  4757. BGFX_IMPORT_FUNC(set_view_scissor) \
  4758. BGFX_IMPORT_FUNC(set_view_clear) \
  4759. BGFX_IMPORT_FUNC(set_view_clear_mrt) \
  4760. BGFX_IMPORT_FUNC(set_view_mode) \
  4761. BGFX_IMPORT_FUNC(set_view_frame_buffer) \
  4762. BGFX_IMPORT_FUNC(set_view_transform) \
  4763. BGFX_IMPORT_FUNC(set_view_transform_stereo) \
  4764. BGFX_IMPORT_FUNC(set_view_order) \
  4765. BGFX_IMPORT_FUNC(encoder_set_marker) \
  4766. BGFX_IMPORT_FUNC(encoder_set_state) \
  4767. BGFX_IMPORT_FUNC(encoder_set_condition) \
  4768. BGFX_IMPORT_FUNC(encoder_set_stencil) \
  4769. BGFX_IMPORT_FUNC(encoder_set_scissor) \
  4770. BGFX_IMPORT_FUNC(encoder_set_scissor_cached) \
  4771. BGFX_IMPORT_FUNC(encoder_set_transform) \
  4772. BGFX_IMPORT_FUNC(encoder_alloc_transform) \
  4773. BGFX_IMPORT_FUNC(encoder_set_transform_cached) \
  4774. BGFX_IMPORT_FUNC(encoder_set_uniform) \
  4775. BGFX_IMPORT_FUNC(encoder_set_index_buffer) \
  4776. BGFX_IMPORT_FUNC(encoder_set_dynamic_index_buffer) \
  4777. BGFX_IMPORT_FUNC(encoder_set_transient_index_buffer) \
  4778. BGFX_IMPORT_FUNC(encoder_set_vertex_buffer) \
  4779. BGFX_IMPORT_FUNC(encoder_set_dynamic_vertex_buffer) \
  4780. BGFX_IMPORT_FUNC(encoder_set_transient_vertex_buffer) \
  4781. BGFX_IMPORT_FUNC(encoder_set_instance_data_buffer) \
  4782. BGFX_IMPORT_FUNC(encoder_set_instance_data_from_vertex_buffer) \
  4783. BGFX_IMPORT_FUNC(encoder_set_instance_data_from_dynamic_vertex_buffer) \
  4784. BGFX_IMPORT_FUNC(encoder_set_texture) \
  4785. BGFX_IMPORT_FUNC(encoder_touch) \
  4786. BGFX_IMPORT_FUNC(encoder_submit) \
  4787. BGFX_IMPORT_FUNC(encoder_submit_occlusion_query) \
  4788. BGFX_IMPORT_FUNC(encoder_submit_indirect) \
  4789. BGFX_IMPORT_FUNC(encoder_set_image) \
  4790. BGFX_IMPORT_FUNC(encoder_set_compute_index_buffer) \
  4791. BGFX_IMPORT_FUNC(encoder_set_compute_vertex_buffer) \
  4792. BGFX_IMPORT_FUNC(encoder_set_compute_dynamic_index_buffer) \
  4793. BGFX_IMPORT_FUNC(encoder_set_compute_dynamic_vertex_buffer) \
  4794. BGFX_IMPORT_FUNC(encoder_set_compute_indirect_buffer) \
  4795. BGFX_IMPORT_FUNC(encoder_dispatch) \
  4796. BGFX_IMPORT_FUNC(encoder_dispatch_indirect) \
  4797. BGFX_IMPORT_FUNC(encoder_discard) \
  4798. BGFX_IMPORT_FUNC(encoder_blit) \
  4799. BGFX_IMPORT_FUNC(request_screen_shot)
  4800. static bgfx_interface_vtbl_t s_bgfx_interface =
  4801. {
  4802. #define BGFX_IMPORT_FUNC(_name) BX_CONCATENATE(bgfx_, _name),
  4803. BGFX_IMPORT
  4804. #undef BGFX_IMPORT_FUNC
  4805. };
  4806. return &s_bgfx_interface;
  4807. }
  4808. return NULL;
  4809. }