Change Subpass dependency content

Author: Mysvac

docs/index.md

@@ -26,10 +26,6 @@ comments: true
 - [CMake](https://cmake.org/) 构建系统
 - [vcpkg](https://vcpkg.io/) 依赖管理
 
-`CMake` 用于项目构建，实现跨平台的项目配置，要求读者了解 CMake 的基础使用。
-
-`vcpkg` 用于管理第三方库，主要用于安装 `glfw3` 和 `glm` 等依赖，这非常简单。
-
 ## **其他说明**
 
 Vulkan SDK 本身由 C 编写，因此具有更好的跨语言兼容性，可通过 C 接口供其他语言调用。

docs/md/00/00_intro.md

@@ -70,7 +70,7 @@ comments: true
 
 3. 然后需要找一些机器人帮我们画画，也就是物理设备 `VkPhysicalDevice` ，常代指 GPU 。
 
-4. 机器人有很多机械臂，有的可以画画，有的可以扫地，我们需要选择合适的机械臂去完成任务。一个机械臂对应一个队列 `VkQueue` ，一组支持特定功能的机械臂称为队列族 `VkQueueFamily` ，比如绘画队列族。
+4. 机器人有很多机械臂，有的可以画画，有的可以扫地，我们需要选择合适的机械臂去完成任务。一个机械臂对应一个队列 `VkQueue` ，一组支持特定功能的机械臂称为队列族 `VkQueueFamily` ，比如计算队列族。
 
 5. 机器人\(GPU\)的型号不同，但我们希望有相同的操作方式，于是设计了统一的接口，这就是逻辑设备 `VkDevice` ，用于抽象物理设备。
 
@@ -80,29 +80,25 @@ comments: true
 
 8. 我们看画的速度和机器人画画的速度不一样，为了保证效率，可以用一个盒子作为缓冲。机器人往盒子里放画，扫描仪从盒子里拿画。这个盒子就是交换链 `VkSwapchainKHR` 。
 
-9. 特别的是，这些画画的纸可以重复使用，所以盒子里的纸的总数是固定的。这些纸就是图像 `VkImage` ，交换链中的图像总数固定。
+9. 这些纸代指图像 `VkImage`，还需要一个标记描述纸张的材质等信息，即 `VkImageView` ，描述图像的基本信息。
 
-10. 不同的纸可能有不同的材质和大小，所以我们需要给每个纸写一个标签。这个标签就是图像视图 `VkImageView` ，描述图像的基本信息。
+10. 现在机器人终于可以画画了，我们要为他准备一个画桌，用于放置画纸等工具。这个画桌就是帧缓冲 `VkFrameBuffer` ，一帧代指一幅图像。
 
-11. 现在机器人终于可以画画了，我们要为他准备一个画桌，用于放置画纸等工具。这个画桌就是帧缓冲 `VkFrameBuffer` ，一帧代指一幅图像。
+11. 我们还要为机器人设计一个房子，这个房子代指渲染通道 `VkRenderPass`，而纸张对应其中的附件 `Attachments`。
 
-12. 我们还要为机器人设计一个房子，这个房子代指渲染通道 `VkRenderPass`，而纸张对应其中的附件 `Attachments`。
+12. 虽然这些附件放置\(绑定\)在画桌\(帧缓冲\)上，但我们需要提前写明房子中有哪些附件，即附件描述 `AttachmentDesctiption` 。 
 
-13. 虽然这些附件放置\(绑定\)在画桌\(帧缓冲\)上，但我们需要为房子贴上告示牌，写明房子内有哪些附件，即附件描述 `AttachmentDesctiption` 。 
+13. 机器人很笨，只能看着流程图画画，所以你需要在房子中放置一些流程图。这个流程图就代指图形管线 `VkGraphicsPipeline` 。
 
-14. 机器人很笨，只能看着流程图画画，所以你需要在房子中放置一些流程图。这个流程图就代指图形管线 `VkGraphicsPipeline` 。
+14. 图形管线的某几个部分是可编程的，这里就用到了着色器模块 `Shader Module` 。
 
-15. 一个大房子分成多个小房间（可以只有一个），可以用不同的房间干不同的事，这些小房间就是子通道 `VkSubpass` ，一个子通道绑定一个图形管线。
+15. 这些机器人很呆，需要你写信告诉他该画画了、如何画画。这些信代指命令缓冲 `VkCommandBuffer` 。
 
-16. 我们有一份流程图的模版，只需要修改它的部分内容就可以变成新的流程图。其中某几个部分是可编程的，这里就用到了着色器模块 `Shader Module` 。
+16. 信可以重用，我们使用一个命令池 `VkCommandPool` 管理这些资源。
 
-17. 这些机器人很呆，需要你写信告诉他该画画了，在哪个房子的哪些房间根据哪些流程图画画。这些信代指命令缓冲 `VkCommandBuffer` 。
+17. 我们需要保证机器人先画画，画完才能放入扫描仪，因此使用信号量 `Semaphore` 处理 GPU 自身的同步。还要保证机器人先完成一张画，我们再给它新的信，所以使用围栏 `Fence` 处理 CPU 和 GPU 之间的同步。
 
-18. 特殊的是信可以重用，我们使用一个命令池 `VkCommandPool` 管理这些资源。
-
-19. 事情一多，机器人做起来就乱了。要保证它先画画，画完才能把画拿出去，所以我们用信号量 `Semaphore` 处理 GPU 自身的同步。还要保证机器人先完成一张画，我们再寄出新的信，所以我们使用围栏 `Fence` 处理 CPU 和 GPU 之间的同步。
-
-绘制第一个三角形大致就是这些内容，你目前**不需要记住**，在后面的学习中随时可以回顾此内容。
+绘制第一个三角形大致就是这些步骤，你目前**不需要记住**，在后面的学习中随时可以回顾此内容。
 
 ### 注意
 

docs/md/00/01_env.md

@@ -12,81 +12,61 @@ comments: true
 > 作为跨平台的教程，我们不限制编译器的选择，但请保证它支持您需要的 C++ 标准。
 
 ## **安装 Vulkan SDK**
+
 Vulkan SDK 是开发Vulkan应用程序的核心组件，包含：
 
 - 头文件
 - 函数加载器
 - 标准验证层
-- 着色器编译支持
-- ······
+- 开发辅助库
 
 可以从 [LunarG官网](https://vulkan.lunarg.com/) 下载SDK，无需注册账户。
 
+### Windows
 
-### Windows 安装
-1. 从 **[官网](https://vulkan.lunarg.com/)** 下载 Vulkan SDK 并运行安装程序，**允许它设置环境变量**
-2. 验证安装：
-    - 进入 SDK 安装目录的 Bin 子目录
-    - 运行 vkcube.exe 演示程序
-    - 应看到旋转的立方体窗口
+从 [官网](https://vulkan.lunarg.com/sdk/home#windows) 下载 Vulkan SDK 并运行安装程序，**允许它设置环境变量**（如果可选）。
 
-![cube](../../images/0001/cube_demo.png)
+#### 验证安装：
 
-### Linux
+进入 SDK 安装目录的 Bin 子目录，运行 vkcube.exe 演示程序：
 
-#### 图形界面安装
-参考Windows安装方法。
+![cube](../../images/0001/cube_demo.png)
 
-#### 命令行安装：
-Ubuntu/Debian系
-```shell
-sudo apt install vulkan-tools libvulkan-dev vulkan-validationlayers-dev spirv-tools
-```
+### Linux
 
-Fedora/RHEL系
-```shell 
-sudo dnf install vulkan-tools vulkan-loader-devel mesa-vulkan-devel vulkan-validation-layers-devel
-```
+推荐 [LunarG官网](https://vulkan.lunarg.com/sdk/home#linux) 下载。
 
-Arch Linux
-```shell
-sudo pacman -S vulkan-devel
-```
+使用命令行安装请参考 [此文档](https://vulkan.lunarg.com/doc/sdk/latest/linux/getting_started.html) 。
 
 #### 验证安装：
+
 ```shell
 vkcube
 ```
 
-确保您看到以下窗口弹出
+确保您看到以下窗口弹出：
 
 ![cube](../../images/0001/cube_demo_nowindow.png)
 
 
-### MacOS 安装
-
-要求：
-
-- MacOS 10.11或更高版本
-- 支持Metal API的硬件
+### MacOS
 
-步骤：
+要求：MacOS 10.11或更高版本，支持Metal API的硬件。
 
-1. 从 [LunarG官网](https://vulkan.lunarg.com/) 下载SDK
+从 [LunarG官网](https://vulkan.lunarg.com/sdk/home#mac) 下载 SDK 并解压到选定目录。
 
-2. 解压到选定目录
-
-3. 运行 `Applications` 目录下的 `vkcube` 演示程序
+#### 验证安装：
 
-您应该看到以下内容
+运行 `Applications` 目录下的 `vkcube` 演示程序，您应该看到以下内容：
 
 ![cube](../../images/0001/cube_demo_mac.png)
 
 ## **依赖库安装**
 
-我们使用 vcpkg 作为跨平台包管理器，安装方式请参考 [官方文档](https://learn.microsoft.com/zh-cn/vcpkg/get_started/overview) 。
+我们使用 vcpkg 进行依赖管理，它是由微软管理，是 C++ 目前最通用的包管理工具，安装方式请参考 [官方文档](https://learn.microsoft.com/zh-cn/vcpkg/get_started/overview) 。
 
 ### GLFW
+
 Vulkan 本身是一个平台无关的 API，不包含用于创建窗口以显示渲染结果的工具。
 我们将使用 [GLFW](http://www.glfw.org/) 库来创建窗口，它支持 Windows、Linux 和 MacOS，且和 Vulkan 有很好的集成。
 
@@ -95,14 +75,21 @@ Vulkan 本身是一个平台无关的 API，不包含用于创建窗口以显示
 vcpkg install glfw3
 ```
 
+> Vulkan SDK 还内置了 SDL2 窗口库，它更加强大，但远比 GLFW 复杂。
+> GAMES104 的 Piccolo 引擎也使用 GLFW ，它完全可以满足本教程的需求。
+
 ### GLM
-与 DirectX 12 不同，Vulkan 不包含用于线性代数运算的库。我们使用 [GLM](https://github.com/g-truc/glm) 线性代数库，它专为图形 API 设计，常用于 OpenGL 与 Vulkan 。
+
+与 DirectX 12 不同，Vulkan 并不内置线性代数工具。我们使用 [GLM](https://github.com/g-truc/glm) 线性代数库，它专为图形 API 设计，常用于 OpenGL 与 Vulkan 。
 
 安装命令：
+
 ```shell
 vcpkg install glm
 ```
 
+> SDK 中其实附带了 glm ，但这里依然推荐你使用 vcpkg 安装。
+
 ## **项目初始化**
 
 ### 目录结构
@@ -119,11 +106,10 @@ vcpkg install glm
 
 ### CMake配置
 
-1. 设置工具链为vcpkg。
-2. 设定项目C++标准。
-3. 查找Vulkan，glm，glfw3三个库。
-4. 添加主程序。
-5. 链接库。
+1. 设置工具链为 vcpkg 。
+2. 设定项目 C++ 标准。
+3. 查找 Vulkan，glm，glfw3 三个库。
+4. 添加主程序并链接库。
 
 **参考代码：**
 
@@ -208,7 +194,7 @@ int main() {
 }
 ```
 
-你无需理解上述C++代码的含义，这只是测试库是否成功导入。
+你无需理解上述 C++ 代码的含义，这只是测试库是否成功导入。
 
 ### 构建运行
 
@@ -236,16 +222,16 @@ build/HelloVulkan
 
 ### 关于CMake预设
 
-注意：**CMake预设不是必须的**，我们没有复杂的配置需求，你完全可以通过上面两行简单的CMake指令构建项目！
+**CMake预设不是必须的**，我们没有复杂的配置需求，你完全可以通过上面两行简单的CMake指令构建项目！
 
-如果你喜欢使用 `CMakePresets.json` （它可以很好地和 CLion、VSCode、Visual Studio 配合），可以参考 **[这个](../../codes/00/01_env/CMakePresets.json)** 预设模板。
+如果你喜欢使用 `CMakePresets.json` \(它可以很好地和 CLion、VSCode、Visual Studio 集成\)，可以参考 **[这个](../../codes/00/01_env/CMakePresets.json)** 预设模板。
 
 此预设模板使用 Ninja 作为生成器，提供了 MSVC/GNU/Clang 工具链的预设配置。
 
 ## **代码编辑器**
 
 建议使用一个足够智能的编辑器。
-当你不确定某些函数的参数和它的含义时，可以右键函数并跳转到它的定义并查看实现。Visual Studio / VSCode / CLion都能提供此功能。
+当你不确定某些函数的参数和它的含义时，可以右键函数跳转到它的定义并查看实现。Visual Studio / VSCode / CLion 都提供此功能。
 
 --- 
 

docs/md/00/02_diff.md

@@ -181,10 +181,4 @@ VkSemaphore ctype_semaphore = **raii_semaphore;
 | 扩展名    | 保持宏定义不变            | 保持宏定义不变       |
 | 结构体初始化 | 需手动设置大部分内容         | 构造函数提供成员初始化   |
 
-> 提示：本教程主要使用 C++ RAII 封装，既保持现代 C++ 风格，又能简化资源管理。
-
----
-
-下面让我们开始绘制第一个三角形！！
-
 ---

docs/md/01/00_base.md

@@ -5,7 +5,7 @@ comments: true
 # **基础代码**
 
 ## **总体结构**
-在“开发环境”章节中，我们创建了一个 Vulkan 项目，其中包含所有正确的配置，并使用示例代码进行了测试。
+在“开发环境”章节中，我们创建了一个 Vulkan 项目，包含了所有正确的配置，并使用示例代码进行了测试。
 
 在本章中，我们将从以下代码开始，请修改 `main.cpp` 。
 
@@ -60,6 +60,7 @@ int main() {
 `vk::SystemError` 可以捕获大部分 Vulkan 异常，你可以使用 `.code()` 成员函数判断异常类型。
 
 ## **集成 GLFW**
+
 离屏渲染无需窗口也能完美运行，但我们希望实时地显示一些东西。
 
 ### 1. 添加GLFW支持
@@ -131,7 +132,8 @@ void mainLoop() {
 它循环并检查事件，例如按下 `X` 按钮，直到窗口被用户关闭。 `glfwPollEvents` 函数将处理本次循环期间发生的所有窗口事件。
 
 ### 5. 清理资源
-一旦窗口关闭，我们需要销毁窗口并终止 GLFW 本身从而清理资源。
+
+在窗口关闭后，我们需要销毁窗口并终止 GLFW 本身从而清理资源。
 
 ```cpp
 void cleanup() {
@@ -142,17 +144,12 @@ void cleanup() {
 
 ## **尝试运行**
 
-现在运行程序，您应该看到一个标题为 Vulkan 的窗口出现，直到应用程序在窗口关闭时终止。
+现在运行程序，您应该看到一个标题为 Vulkan 的窗口出现，可以点击关闭按键结束程序。
 
 ![empty_window](../../images/0001/glfw.png)
 
 ---
 
-需要说明的是，基础部分的代码重点在于功能演示，因此可能忽略**可选**的 `const` 与 `static` 等 C++ 标识符细节。
-但进阶部分会提供尽量优雅的基础代码框架。
-
----
-
 **[C++代码](../../codes/01/00_base/main.cpp)**
 
 **[CMake代码](../../codes/01/00_base/CMakeLists.txt)**

docs/md/01/01_instance.md

@@ -96,11 +96,7 @@ vk::InstanceCreateInfo createInfo(
 `flags` 参数是标志位，用于控制特殊行为，默认认初始化为空，大多时候无需修改。
 还有其他参数，但都提供了默认初始化，无需手动设置。
 
-`&applicationInfo` 传入指针，需要注意生命周期：
-
-1. `CreateInfo`仅用于提供配置信息。
-2. `CreateInfo`在创建对应资源后就无用了。
-3. 只需要保证指针在创建对象时有效。
+`&applicationInfo` 传入指针，需要注意生命周期：`CreateInfo`仅用于提供配置信息，它在创建对应资源后就无用了，因此只需保证指针在创建对象时有效。
 
 ### 3. 创建实例
 
@@ -160,6 +156,8 @@ Vulkan-Hpp 需要调用底层C接口，所以这些配置信息采用相同的
 > 实际上，每个成员变量还有自身的 `setter` ，他们和直接赋值是等效的。  
 > 为了方便区分，如果是单参数，本教程直接赋值而不用 `setter` 函数。  
 
+此外，这些 setter 函数返回对象自身的引用，因此可以链式调用。
+
 ### 3. 测试与运行
 
 现在尝试构建与运行项目，非MacOS不应该出现错误。
@@ -169,15 +167,14 @@ Vulkan-Hpp 需要调用底层C接口，所以这些配置信息采用相同的
 > 特征：err.code() 为  `vk::Result::eErrorIncompatibleDriver`
 
 在使用 MoltenVK SDK 的 MacOS 上，可能抛出异常，因为 MacOS 在运行 Vulkan 时必须启用转换层扩展。
+我们需要修改 `CreateInfo` 配置：
 
-**解决方案：**
+- 添加 `vk::KHRPortabilityEnumerationExtensionName` 扩展
+- 添加 `vk::InstanceCreateFlagBits::eEnumeratePortabilityKHR` 标志位
 
-1. 修改 `CreateInfo` 
-2. 添加 `vk::KHRPortabilityEnumerationExtensionName` 扩展
-3. 添加 `vk::InstanceCreateFlagBits::eEnumeratePortabilityKHR` 标志位
 
+通常代码可能如下所示：
 
-通常代码可能如下所示
 ```cpp
 std::vector<const char*> requiredExtensions( glfwExtensions, glfwExtensions + glfwExtensionCount );
 requiredExtensions.emplace_back(vk::KHRPortabilityEnumerationExtensionName);

docs/md/01/03_physicaldevice.md

@@ -45,8 +45,8 @@ void selectPhysicalDevice() {
 }
 ```
 
-> 你可能见过 `vk::raii::PhysicalDevices` 类型，它末尾多了个 `s`。  
-> 他实际上继承了 `std::vector<vk::raii::PhysicalDevice>` ，二者功能基本一致。
+> 你可能见过 `vk::raii::PhysicalDevices` 类型，末尾多了个 `s`。  
+> 它实际上继承了 `std::vector<vk::raii::PhysicalDevice>` ，二者功能基本一致。
 
 ### 3. 设备适用性检查
 

docs/md/01/04_device.md

@@ -66,17 +66,15 @@ queueCreateInfo.setQueuePriorities( queuePriority );
 
 ### 3. 指定设备特性
 
-目前我们不需要任何特殊的东西，可以直接使用默认值。 当我们开始使用 Vulkan 做更有趣的事情时，会回来修改到这个结构。
-
 我们之前提到过，物理设备还有很多可选特性，它们的支持性取决于具体的 GPU 硬件。
 如果需要使用这些特性，要在逻辑设备创建时显式启用它们，但我们现在还没有需要的特性。
 
+目前我们不需要任何特殊的东西，可以直接使用默认值。 当我们开始使用 Vulkan 做更有趣的事情时，会回来修改到这个结构。
+
 ```cpp
 vk::PhysicalDeviceFeatures deviceFeatures;
 ```
 
-后续章节提到的“需要启用 GPU 特性”指得就是这里。
-
 ### 4. 创建信息
 
 有了前面的两个结构，我们就可以填写 `vk::DeviceCreateInfo` 结构了。
@@ -87,22 +85,12 @@ createInfo.setQueueCreateInfos( queueCreateInfo );
 createInfo.pEnabledFeatures = &deviceFeatures;
 ```
 
-其余信息与 `vk::InstanceCreateInfo` 结构相似，并要求您指定扩展。不同之处在于这次这些是设备特定的。
-
-> 注意，虽然设备特定的“层”已废弃，但仍然需要指定设备特定的扩展与设备特性。
+其余信息与 `vk::InstanceCreateInfo` 结构相似，并要求您指定扩展，但这次是设备特定的。
+我们暂时没有扩展需要添加，因此无需填写。
 
-### 5. 验证层
-
-设备特定的层很早就被废弃，你无需也不应该使用它们，以下代码将被 Vulkan 忽略。
-
-```cpp
-if constexpr (ENABLE_VALIDATION_LAYER) {
-    // 无效代码
-    createInfo.setPEnabledLayerNames( REQUIRED_LAYERS );
-}
-```
+> 实例除了“扩展”外还有“层”的概念。设备特定的“层”已弃用很久了，请不要使用它。
 
-### 6. 创建逻辑设备
+### 5. 创建逻辑设备
 
 目前我们不需要任何设备特定的扩展，可以实例化逻辑设备了：
 

docs/md/01/10_surface.md

@@ -160,7 +160,7 @@ m_graphicsQueue = m_device.getQueue( graphics.value(), 0 );
 m_presentQueue = m_device.getQueue( present.value(), 0 );
 ```
 
-如果队列族相同，这两个句柄很可能具有相同的值，但这依然可以正常运行。
+如果队列族相同，这两个句柄很可能具有相同的值，但依然可以正常运行。
 
 ## **测试**