SwiftShader

简介

SwiftShader[^1]是一个高性能的基于CPU的Vulkan[^3] 1.3图形API实现[^2]。它的目标是为高级3D图形提供硬件独立性。

注意：ANGLE项目可用于实现OpenGL ES 3.1的分层实现[^4]（又称"SwANGLE"）。

构建

SwiftShader库可以在Windows、Linux和macOS上构建。
同时也支持Android和Chrome（OS）构建环境。

CMake
为Linux、macOS或Windows安装CMake，并使用图形界面或运行以下终端命令：
```
cd build
cmake ..
cmake --build . --parallel

./vk-unittests
```
提示：设置CMAKE_BUILD_PARALLEL_LEVEL环境变量以控制并行级别。
Visual Studio
要构建Vulkan ICD库，请使用Visual Studio 2019打开项目文件夹并等待其运行CMake。在解决方案资源管理器中打开CMake目标视图，选择vk_swiftshader项目进行构建。

使用方法

SwiftShader库作为图形驱动程序的替代品。

在Windows上，大多数应用程序可以通过将SwiftShader的DLL放在与可执行文件相同的文件夹中来使用它们。在Linux上，可以使用LD_LIBRARY_PATH环境变量或-rpath链接器选项来指示应用程序首先在指定目录中搜索共享库。

通常，Vulkan应用程序在Windows上查找名为vulkan-1.dll的共享库（在Linux上为vulkan-1.so）。这个"加载器"库然后将API调用重定向到实际的可安装客户端驱动程序（ICD）。SwiftShader的ICD名为libvk_swiftshader.dll，但可以将其重命名为vulkan-1.dll以便应用程序直接加载。或者，您可以将VK_ICD_FILENAMES环境变量设置为构建目录下生成的vk_swiftshader_icd.json文件的路径（例如.\SwiftShader\build\Windows\vk_swiftshader_icd.json）。要了解更多关于Vulkan加载的工作原理，请阅读此处的官方文档。

贡献

请查看CONTRIBUTING.txt了解重要的贡献要求。

SwiftShader的规范仓库托管在： https://swiftshader.googlesource.com/SwiftShader

所有更改必须在Gerrit审核工具中进行审核和批准： https://swiftshader-review.googlesource.com。在上传更改之前，您必须使用Google帐户登录此站点。

接下来，在此处验证您的帐户： https://swiftshader.googlesource.com/new-password（使用与配置为[Git提交作者](https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup#_your_identity)相同的电子邮件地址）。

所有更改都需要在提交消息中包含Change-ID标记。可以使用提交钩子自动添加此标记，可以在以下位置找到： https://gerrit-review.googlesource.com/tools/hooks/commit-msg。您可以执行`git clone https://swiftshader.googlesource.com/SwiftShader`并手动将提交钩子放在`SwiftShader/.git/hooks/`中，或者一次性克隆仓库并安装提交钩子：

git clone https://swiftshader.googlesource.com/SwiftShader && (cd SwiftShader && git submodule update --init --recursive third_party/git-hooks && ./third_party/git-hooks/install_hooks.sh)

在Windows上，此命令行需要使用Git Bash Shell。

通过执行以下命令将更改上传到Gerrit：

git push origin HEAD:refs/for/master

准备就绪后，在您的更改上添加项目所有者作为审核者。

一些测试将自动针对更改运行。值得注意的是，presubmit.sh验证更改是否已使用clang-format 11.0.1进行格式化。大多数IDE都附带clang-format支持，但可能需要升级/降级到clang-format版本11.0.0发布版本（特别是Chromium的buildtools有一个clang-format二进制文件，可能是一个中间版本，产生不同的格式化结果）。