Improve 2

Author: Mysvac

README.md

@@ -31,51 +31,55 @@
 
 **文档网站：<https://mysvac.github.io/vulkan-hpp-tutorial>**
 
-备用\(更新滞后\)：<https://vulkan.mysvac.com>
+备用站点：<https://vulkan.mysvac.com>
 
-**注意：文档正在制作、重构与改善中。**
+> 注意：文档代码已经完善，部分文字描述正在改善中。
 
 ### 教程简介
 
 本教程是 Vulkan 的入门教程，将系统讲解 Vulkan 图形与计算 API 的基础知识与实际应用。
 
 教程将使用 C++ 编写代码，借助 Vulkan-Hpp 封装，充分利用 RAII 等现代 C++ 特性。
 
-> 注：Vulkan-Hpp 是 Vulkan SDK 的官方组成部分，非第三方库
+> 注：Vulkan-Hpp 是 Vulkan SDK 的官方组成部分，非第三方库。
 
 **教程大致内容如下：**
 
 1. 介绍基础概念
 2. 配置开发环境
 3. 绘制第一个三角形
-4. 实现高级功能
+4. 扩展基础功能
 
 ### 项目结构
-- `src` 中存放Cpp完整代码。
-- `shaders`中存放shader代码。
-- `docs` 中存放文档
-    - `md` 中存放教程文档。
-    - `images` 相关图片资源
-    - `codes` 中存放每一节的代码和差异文件。
+
+- `src` 存放C++完整代码
+- `shaders` 存放shader代码
+- `texture` 存放纹理图片
+- `models` 存放模型文件
+- `docs` 存放静态站点相关资源
+    - `md` 存放教程文档
+    - `images` 图片资源
+    - `res` 其他资源
+    - `codes` 每一节的代码和差异文件。
 
 
 ### 代码说明
 
-教程将使用 C++ 编写代码，使用C++20标准，并使用以下工具链：
+教程将使用 C++ 编写代码，采用C++20标准，并使用以下工具链：
 
 - [Vulkan SDK](https://lunarg.com/vulkan-sdk/)
 - [GLM](http://glm.g-truc.net/) 线性代数库
 - [GLFW](http://www.glfw.org/) 窗口库
 - [CMake](https://cmake.org/) 构建系统
 - [vcpkg](https://vcpkg.io/) 依赖管理
 
-正如教程名，我还会使用 Vulkan SDK 为C++提供的 `vulkan-hpp` 封装，且使用内部的 `raii` 封装，使用更加现代的C++接口。
+正如教程名，我们会使用 Vulkan SDK 为C++提供的 `vulkan-hpp` 和 `raii` 封装，它提供了更现代的C++接口。
 
 
-虽然 `vulkan-hpp` 提供了模块支持，但是我们还需要使用 `glfw3` 库和 `glm` 库，将他们模块化是比较繁琐的，
-这超出了本教程的目的，因此不使用C++20的模块功能。
+虽然 `vulkan-hpp` 提供了模块支持，但是我们还需要使用 `glfw3` 库和 `glm` 库，将它们模块化是比较繁琐的，
+这超出了本教程的范围，因此不使用C++20的模块功能。
 
-> C++23 的标准库模块与标准库头文件似乎是冲突的，这很可能导致显著延缓C++模块化的发展
+> C++23 的标准库模块与标准库头文件似乎是冲突的，这很可能显著延缓C++社区模块化的进度
 
 `CMake` 用于项目构建，实现跨平台的项目，但要求读者了解CMake基础使用。
 
@@ -93,7 +97,7 @@ Vulkan SDK本身由C编写，这带来更好的跨语言能力，可以其他语
 
 
 
-### 参考资料
+### 项目参考资料
 
 Vulkan-hpp文档 [vulkan-hpp](https://github.com/KhronosGroup/Vulkan-Hpp) 。
 

docs/index.md

@@ -26,8 +26,7 @@
 - [CMake](https://cmake.org/) 构建系统
 - [vcpkg](https://vcpkg.io/) 依赖管理
 
-正如教程名，我会使用 Vulkan SDK 为C++提供的 `vulkan-hpp` 封装，且使用内部的 `raii` 封装，它提供了更现代的C++接口。
-
+正如教程名，我们会使用 Vulkan SDK 为C++提供的 `vulkan-hpp` 和 `raii` 封装，它提供了更现代的C++接口。
 
 虽然 `vulkan-hpp` 提供了模块支持，但是我们还需要使用 `glfw3` 库和 `glm` 库，将它们模块化是比较繁琐的，
 这超出了本教程的范围，因此不使用C++20的模块功能。

docs/md/0140_recreateswapchain.md

@@ -3,7 +3,8 @@
 ## **前言**
 
 现在我们已经成功绘制了第一个三角形，但是还有些特殊情况没有处理。
-当窗口表面发送变化时，交换链可能不再适配窗口表面。一种可能的原因是窗口被调整，我们需要捕获此事件并重建交换链。
+当窗口表面发送变化时，交换链可能不再适配窗口表面。
+一种可能的原因是窗口大小被调整，我们需要捕获此事件并重建交换链。
 
 ## **重建交换链**
 

docs/md/0200_vertexinput.md

@@ -1,13 +1,13 @@
-# 顶点输入描述
+# **顶点输入描述**
 
-## 前言
+## **前言**
 
-在后面几章，我们将使用内存中的顶点缓冲数据代替Shader中的硬编码数据。
+在后面几章，我们将使用内存中的顶点缓冲区\(vertex buffers\)数据代替Shader中的硬编码数据。
 
-我们将从最简单的方式开始，创建CPU可见缓冲然后直接用`memcpy`将顶点数据复制进去。
-之后我们将了解如何使用暂存缓冲将顶点数据复制进高性能显存中。
+我们将从最简单的方式开始，创建CPU可见缓冲区然后直接用 `memcpy` 将顶点数据复制进去。
+之后我们将了解如何使用暂存缓冲区\(staging buffers\)将顶点数据复制进高性能显存中。
 
-## 顶点着色器
+## **顶点着色器**
 
 首先我们需要改变顶点着色器的代码，不再包含硬编码的顶点数据。
 顶点数据将从外部获取，通过`in`关键字：
@@ -29,7 +29,7 @@ void main() {
 `inPosition` 和 `inColor` 是顶点参数，是每个顶点在顶点缓冲中指定的属性。
 
 我们之前提过，一个`location`只能放一个资源，所以我们的位置和颜色信息需要放在不同的`location`中。
-我们通过输入接收了资源，所以`location = 0`暂时空了，可以用于输出。
+注意 `inPosition` 是外部->顶点着色器，`fragColor`是顶点着色器->片段着色器，所以二者不冲突。
 
 特殊的是，某些类型需要多个槽位，比如使用`dvec3`时，后一个变量的索引至少要高2：
 
@@ -40,7 +40,7 @@ layout(location = 2) in vec3 inColor;
 
 您可以在 [OpenGL wiki](https://www.khronos.org/opengl/wiki/Layout_Qualifier_(GLSL)) 中找到有关 layout 限定符的更多信息。
 
-## 顶点数据、
+## **顶点数据**
 
 现在回到C++代码，我们要将顶点数据从着色器代码移动到C++程序代码的数组中。
 
@@ -72,12 +72,12 @@ inline static const std::vector<Vertex> vertices = {
 };
 ```
 
-我们使用的位置和颜色值与之前完全相同，但现在它们组合成一个顶点数组。这被称为*交错*顶点属性。
+我们使用的位置和颜色值与之前完全相同，但现在它们组合成一个顶点数组，这被称为“交错顶点属性”。
 
 下一步要告诉 Vulkan 这些数据上传到GPU内存后如何传递给顶点着色器。
 我们需要两个结构体传达这些信息。
 
-## 绑定描述
+## **绑定描述**
 
 第一个结构体是 `vk::VertexInputBindingDescription` ，我们添加一个静态成员函数用于填充信息：
 
@@ -94,7 +94,7 @@ struct Vertex {
 };
 ```
 
-顶点绑定描述了从内存中通过顶点集合加载顶点的速率。
+顶点绑定描述结构体描述了从内存中通过顶点集合加载顶点的“速率”。
 它规定了单个数据条目的字节数，以及要在每个顶点还是每个实例时读取一条数据。
 
 ```cpp
@@ -109,14 +109,14 @@ bindingDescription.inputRate = vk::VertexInputRate::eVertex;
 
 `inputRate`参数具有以下两种枚举值：
 
-| 枚举 | 意义 |  
+| `vk::VertexInputRate` | 意义 |  
 |------|------|
 | `eVertex` | 在处理每个顶点时读取一条 |
 | `eInstance` | 在处理每个实例时读取一条 |
 
 我们不会使用实例化渲染，因此使用每个顶点读取一条。实际我们每条数据就对应一个顶点。
 
-## 属性描述
+## **属性描述**
 
 第二个结构体是 `vk::VertexInputAttributeDescription` ，它描述了如何处理顶点的输入数据。
 我们依然添加一个静态成员函数：
@@ -169,7 +169,7 @@ attributeDescriptions[1].offset = offsetof(Vertex, color);
 
 > 注意这里的`format`对应的是`vec3`。
 
-## 管线顶点输入
+## **管线顶点输入**
 
 我们现在需要设置图形管线的配置，让它接收这些数据。现在修改`createGraphicsPipeline`函数，找到`vertexInputInfo`变量并添加信息：
 
@@ -183,7 +183,7 @@ vertexInputInfo.setVertexBindingDescriptions(bindingDescription);
 vertexInputInfo.setVertexAttributeDescriptions(attributeDescriptions);
 ```
 
-## 最后
+## **最后**
 
 现在管线已准备好接受指定格式的顶点数据并将其传递给顶点着色器。
 

docs/md/0201_vertexbuffer.md

@@ -1,13 +1,15 @@
-# 创建顶点缓冲
+# **创建顶点缓冲**
 
-## 前言
+## **前言**
 
 缓冲(Buffers)在 Vulkan 中是一个用于存储任意数据的区域，它可以被显卡读取。
 在本节中，我们将用它存储顶点数据。
 与其他的 Vulkan 对象不同，缓冲并不会自动分配内存。
 我们在之前的章节中见识到了Vulkan API的可控性，内存管理也是其中之一。
 
-## 创建缓冲
+> 本教程中有时叫它“缓冲区”，但大多数时候直接称为“缓冲”，二者是一样的。
+
+## **创建缓冲**
 
 在`initVulkan`中创建一个新的函数`createVertexBuffer`，放在`createCommandBuffers`之前：
 
@@ -46,7 +48,7 @@ vk::BufferCreateInfo bufferInfo;
 bufferInfo.size = sizeof(vertices[0]) * vertices.size();
 ```
 
-第二个参数是`usage`，它表示这些数据的用途。它本身是个位枚举，可以同时表示多种用途。
+第二个参数是`usage`，它表示这些数据的用途，可以是多个位掩码的组合。
 我们需要的是顶点缓冲，所以可以这样写：
 
 ```cpp
@@ -88,7 +90,7 @@ void createVertexBuffer() {
 }
 ```
 
-## 内存需求
+## **内存需求**
 
 虽然缓冲已经创建了，但它实际还未分配任何内存。分配内存的第一步是查询他的内存需求量：
 
@@ -104,8 +106,8 @@ vk::MemoryRequirements memRequirements = m_vertexBuffer.getMemoryRequirements();
 | `alignment` | 内存对齐方式，取决于`bufferInfo.usage`和`bufferInfo.flags` |
 | `memoryTypeBits` | 适用于缓冲的内存类型的位字段 |
 
-显卡可以分配不同类型的内存，这些不同的内存类型可能有不同的操作或性能表现。
-我们需要结合需求寻找正确的内存类型，现在让我们创建新函数`findMemoryType`
+显卡可以分配不同类型的内存\(显存\)，这些不同的内存类型可能有不同的操作或性能表现。
+我们需要根据需求寻找合适的内存类型，现在让我们创建新函数`findMemoryType`
 
 ```cpp
 uint32_t findMemoryType(uint32_t typeFilter, vk::MemoryPropertyFlags properties) {
@@ -120,11 +122,10 @@ uint32_t findMemoryType(uint32_t typeFilter, vk::MemoryPropertyFlags properties)
 auto memProperties = m_physicalDevice.getMemoryProperties();
 ```
 
-> 以`2`位后缀的类型大多数是在原基础上支持了`pNext`指针，我们使用普通函数即可。
-
 `vk::PhysicalDeviceMemoryProperties`结构体中有两个数组 `memoryTypes` 和 `memoryHeaps`。
-第二个数组内存堆是不同的内存资源，比如VRAM耗尽时专用于VRAM和RAM交换的空间。而不同的内存类型存在于这些堆中。
-现在我们只关心类型而不关心它来自哪个堆，但显然这也会影响性能。
+第二个数组“内存堆”是不同的内存资源，比如VRAM耗尽时专用于VRAM和RAM交换的空间。而不同的内存类型存在于这些堆中。
+
+作为初学者，我们现在只关心类型而不关心它来自哪个堆，但需要记得后者其实也会影响性能。
 
 让我们找一个合适的内存类型：
 
@@ -155,7 +156,7 @@ for(uint32_t i = 0; i < memProperties.memoryTypeCount; ++i){
 }
 ```
 
-## 内存分配
+## **内存分配**
 
 现在我们有办法找到正确的内存类型了，将这些信息都记入 `vk::MemoryAllocateInfo` 结构体中。
 
@@ -167,7 +168,7 @@ allocInfo.memoryTypeIndex = findMemoryType( memRequirements.memoryTypeBits,
 );
 ```
 
-`eHostVisible` 表示可以被CPU访问， `eHostCoherent` 表示内存自动同步。
+`eHostVisible` 表示可以被CPU\(主机\)访问， `eHostCoherent` 表示内存自动同步。
 
 分配内存非常简单，我们首先在 `m_vertexBuffer` **上方**创建一个新变量，然后使用 `allocateMemory` 分配资源：
 
@@ -188,9 +189,9 @@ m_vertexBufferMemory = m_device.allocateMemory( allocInfo );
 m_vertexBuffer.bindMemory(m_vertexBufferMemory, 0);
 ```
 
-右边的`0`是内存区域内的偏移量，通过此变量可以让一块内存分成多个区域。此内存转为顶点缓冲分配，偏移量应为0。
+右边的`0`是内存区域内的偏移量，通过此变量可以让一块内存分成多个区域。此内存专为顶点缓冲分配，偏移量应为0。
 
-## 填充顶点缓冲
+## **填充顶点缓冲**
 
 现在是时候把顶点数据拷贝到缓冲中了。我们使用`mapMemory`获取内存地址指针:
 
@@ -225,7 +226,7 @@ m_vertexBufferMemory.unmapMemory();
 刷新内存范围和使用一致性内存堆意味着驱动程序可以注意到我们写入了缓冲，但这不意味着在GPU上可见。
 GPU上的数据转移是个隐含的过程，规范只[告诉我们](https://www.khronos.org/registry/vulkan/specs/1.3-extensions/html/chap7.html#synchronization-submission-host-writes)，它保证在下次调用`queue.submit`时完成。
 
-## 绑定顶点缓冲
+## **绑定顶点缓冲**
 
 剩下的就是在渲染操作期间绑定顶点缓冲，我们扩展`recordCommandBuffer`函数来执行此操作。
 
@@ -245,7 +246,7 @@ commandBuffer.draw(static_cast<uint32_t>(vertices.size()), 1, 0, 0);
 `bindVertexBuffers`的第一个参数指定顶点缓冲绑定点的偏移量。
 我们还修改了`draw`，传递缓冲中得到顶点数，而不是硬编码的`3`。
 
-## 测试
+## **测试**
 
 现在运行程序，你应该可以看到熟悉的三角形：