bgfx是一个开源的图形api无关的渲染库,由于工作需要,充分认识和感受其源码和相关案例,鄙人花费了一些时间来搭建其环境,在此做一个记录。
一、源码准备
1. 下载bgfx源码:GitHub - bkaradzic/bgfx: Cross-platform, graphics API agnostic, "Bring Your Own Engine/Framework" style rendering library. 到指定目录(我的是E:\SDKLibary\BGFX), 并解压;
2. 下载bx(作者的一个工具库)源码:GitHub - bkaradzic/bx: Base library used across multiple projects到指定目录(我的是E:\SDKLibary\BGFX),并解压;
3. 下载bimg(作者的一个工具库)源码: https://github.com/bkaradzic/bimg 到指定目录(我的是E:\SDKLibary\bimg),并解压;
PS: 以上3个库源码也可以使用git clone 方式来获取:
git clone git://github.com/bkaradzic/bx.git
git clone git://github.com/bkaradzic/bimg.git
git clone git://github.com/bkaradzic/bgfx.git
因此,目录结构截图如下:
二、配置环境
1. 打开终端:ctrl + R,输入cmd,回车
2. 切换到目录E:\SDKLibary\BGFX\bgfx,执行命令:
..\bx\tools\bin\windows\genie.exe --with-tools --with-examples --with-shared-lib vs2019
等待Generate Done 即可。此时,bgfx目录下就多了个.build目录
3. 直接打开 E:\SDKLibary\BGFX\bgfx\.build\projects\vs2019\bgfx.sln工程文件, 然后执行Build即可!
三、运行测试的结果
Build结束之后,点击运行第一个example,效果如下:
四、注意事项
1. 在build工程项目文件的时候有时候会出现“
WindowsSDK.targets(46,5): error MSB8036: The Windows SDK version 8.1 was not found. Install the required version of Windows SDK or change the SDK version in the project property pages or by right-clicking the solution and selecting "Retarget solution".
1>Done building project "example-glue.vcxproj" -- FAILED.
”的错误,此时按照其提示“Install the required version of Windows SDK or change the SDK version in the project property pages”来做即可。
其他可参考: