bgfx.cpp 190 KB

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