feat(积木模式): begin

Author: yyc-git

doc/第三轮.org

@@ -1,3 +1,13 @@
+总结：
+- 修改了错误
+- 隐藏代码的实现细节，进行抽象，读者可到代码库中详细了解它们
+- 圆润过渡语
+- 补充内容
+- 明确总-分结构
+
+
+
+
 * TODO 修改结构性错误
 
 

doc/第五轮.org

@@ -1,3 +1,7 @@
+* TODO 图片使用白底
+
+
+
 * TODO 交稿给编辑老师，改错(use markdown)
 
 

doc/第四轮.org

@@ -1,5 +1,41 @@
+* TODO 修改UML描述
+
+** TODO 增加： 我们介绍下各个模块的依赖关系：xxx
+
+
+** TODO UML中的函数增加返回值类型？
+
+
 * TODO 修改代码
 
+** TODO 都改为调用模块.xxx函数
+
+如：
+Client
+```ts
+...
+
+let engineState = createState()
+
+engineState = registerAllPipelines(engineState)
+
+...
+```
+
+改为：
+Client
+```ts
+...
+
+let engineState = World.createState()
+
+engineState = World.registerAllPipelines(engineState)
+
+...
+```
+
+
+
 ** TODO state的名字重命名为对应的state名
 
 如管道模式->story_improve->Client：
@@ -10,7 +46,31 @@
 来自拼接模式
 
 
-* TODO 给出代码：在“总”中给出进一步的说明
+* TODO 给出代码：在“总”中给出进一步的说明每一步的关系
+
+如将下面的描述：
+首先，我们看下用户的代码；
+然后，我们看下Engine的代码
+然后，我们看下创建EngineState的代码
+然后，我们看下创建场景的代码
+然后，我们看下初始化的代码
+然后，我们看下主循环的代码
+最后，我们运行代码
+
+改为：
+首先，我们看下用户的代码；
+然后，因为用户调用了Engine的API，所以我们看下Engine的代码
+然后，我们依次看下用户代码中每个步骤的相关代码，它们包括：
+- 创建EngineState的代码
+- 创建场景的代码
+- 初始化的代码
+- 主循环的代码
+
+最后，我们运行代码
+
+
+
+
 
 
 * TODO 每个模式的具体案例增加到4个

packages/ECS模式/article.md

@@ -1189,7 +1189,7 @@ export let setPositionComponent = (worldState: worldState, gameObject: gameObjec
 挂载其它组件...
 ```
 
-SceneAPI封装了创建场景的API -->
+SceneAPI提供了创建场景的API -->
 
 
 <!-- GameObjectManager的相关代码如下：
@@ -1587,7 +1587,7 @@ Component+GameObject层为组件和GameObject，它们现在只是有一个numbe
 我们看下World这一层：
 
 - World
-该角色是门户，封装了API，实现了初始化和主循环的逻辑
+该角色是门户，提供了API，实现了初始化和主循环的逻辑
 
 
 

packages/多线程模式/article.md

@@ -47,7 +47,7 @@ TODO tu
 
 Client是用户
 
-WorldForNoWorker是门户，封装了引擎的API
+WorldForNoWorker是门户，提供了引擎的API
 
 
 我们来看下管道这个部分：
@@ -1079,7 +1079,7 @@ X Worker对应某个其它线程，包括了运行在该线程的模块
 该角色是用户
 
 - WorldForMainWorker
-该角色是门户，封装了系统API
+该角色是门户，提供了系统API
 
 - PipelineManager
 该角色负责管理管道

packages/拼接模式/article.md

@@ -94,7 +94,7 @@ PBRMaterialShaderGLSL（Add Define）是在PBRMaterialShaderGLSL（Default）基
 
 我们看下引擎这个部分：
 
-Engine是引擎的门户，负责封装API给Client
+Engine是引擎的门户，负责提供API给Client
 Engine有一个EngineState，用来保存引擎的所有数据；
 
 InitBasicMaterialShader负责初始化所有基础材质的Shader，判断基础材质是否支持功能，支持的话就将BasicMaterialShaderGLSL（Default）修改为BasicMaterialShaderGLSL（Add Define），然后创建对应的Shader
@@ -269,7 +269,7 @@ initBasicMaterialShader函数初始化所有基础材质的shader，它调用Ini
 <!-- 它们的对应关系为：因为一个shaderIndex对应一个Shader，一个Shader对应一套GLSL(VS GLSL和FS GLSL)，所以一个shaderIndex对应一套GLSL -->
 
 Material、ShaderIndex、Program、GLSL对应关系如下图所示：
-![image](https://img2023.cnblogs.com/blog/419321/202304/419321-20230403160828435-1930437553.png)
+![image](https://img2023.cnblogs.com/blog/419321/202305/419321-20230501123700400-921756639.png)
 
 在后面渲染时，我们会首先通过Material拿到ShaderIndex，然后通过ShaderIndex再拿到Program，最后use Program
 
@@ -666,7 +666,7 @@ ChunkHandler负责拼接Target GLSL和获得Send Config
 
 
 Engine、Render跟之前一样
-<!-- Engine是引擎的门户，负责封装API给Client -->
+<!-- Engine是引擎的门户，负责提供API给Client -->
 <!-- Engine有一个EngineState，用来保存引擎的所有数据； -->
 
 InitMaterialShader负责初始化所有材质的Shader，它有两个函数：initBasicMaterialShader、initPBRMaterialShader，分别负责初始化所有基础材质的Shader和初始化所有PBR材质的Shader
@@ -1022,11 +1022,15 @@ varying vec2 v_diffuseMapCoord0;
 其它区域包括的代码如下：
 @top包括了define之前的代码，如精度代码:
 ```glsl
+@top
 precision highp float;
+@end
 ```
 @define包括了define的代码，如：
 ```glsl
+@define
 define B 2;
+@end
 ```
 @funcDeclare包括了函数声明的代码，如：
 ```glsl