编译 bgfx（以windows10/VS2019为例）

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”来做即可。

其他可参考：

（1）如何编译 bgfx_huangzhipeng的专栏-CSDN博客

（2）bgfx跨平台渲染库学习笔记:环境搭建_用打游戏的时间写代码-CSDN博客