[tutorial] add trim tutorial

ChunelFeng · ChunelFeng · commit f279714d0997 · 2024-09-28T22:34:12.000+08:00
diff --git a/README.md b/README.md
@@ -340,6 +340,9 @@ int main() {
 * 优化`event`(事件)机制，异步事件可以等待结束
 * 发布 [CGraph-lite](https://github.com/ChunelFeng/CGraph-lite) 项目，提供简单DAG构图和参数传递功能。接口完全兼容，可无缝切换至本项目
 
+[2024.09.28 - v2.6.2 - Chunel]
+* 更新`tutorial`内容
+
 </details>
 
 ------------
diff --git a/tutorial/BUILD b/tutorial/BUILD
@@ -39,6 +39,7 @@ CGRAPH_TUTORIAL_LIST = [
          "T24-Fence",
          "T25-Coordinator",
          "T26-Mutable",
+         "T27-Trim",
         ]
 
 [
diff --git a/tutorial/CMakeLists.txt b/tutorial/CMakeLists.txt
@@ -28,6 +28,7 @@ set(CGRAPH_TUTORIAL_LIST
          T24-Fence
          T25-Coordinator
          T26-Mutable
+         T27-Trim
         )
 
 
diff --git a/tutorial/T26-Mutable.cpp b/tutorial/T26-Mutable.cpp
@@ -3,7 +3,7 @@
 @Contact: chunel@foxmail.com
 @File: T26-Mutable.cpp
 @Time: 2023/11/15 21:18
-@Desc: 
+@Desc: 本例主要演示，通过 GMutable 在pipeline执行的过程中，修改 GMutable 中的依赖关系逻辑
 ***************************/
 
 #include "MyGMutable/MyMutable.h"
diff --git a/tutorial/T27-Trim.cpp b/tutorial/T27-Trim.cpp
@@ -0,0 +1,41 @@
+/***************************
+@Author: Chunel
+@Contact: chunel@foxmail.com
+@File: T27-Trim.cpp
+@Time: 2024/9/28 21:43
+@Desc: 本例主要演示，通过 Trim() 方法，修剪pipeline中的冗余依赖逻辑
+***************************/
+
+#include "MyGNode/MyNode1.h"
+#include "MyGNode/MyNode2.h"
+
+using namespace CGraph;
+
+void tutorial_trim() {
+    GPipelinePtr pipeline = GPipelineFactory::create();
+    GElementPtr a, b, c, d = nullptr;
+
+    pipeline->registerGElement<MyNode1>(&a, {}, "nodeA");
+    pipeline->registerGElement<MyNode2>(&b, {a}, "nodeB");
+    pipeline->registerGElement<MyNode1>(&c, {a}, "nodeC");
+
+    /**
+     * 可以看出，d节点 对a 的依赖，是可有可无的
+     * 建议通过 trim() 接口删除冗余依赖
+     * 参考文档：http://www.chunel.cn/archives/cgraph-remove-redundancy-link
+     */
+    pipeline->registerGElement<MyNode2>(&d, {a, b, c}, "nodeD");
+
+    auto trimSize = pipeline->trim();
+    CGRAPH_ECHO("trim size is: %u", trimSize);
+
+    // 查看 trim后的效果
+    pipeline->dump();
+    GPipelineFactory::remove(pipeline);
+}
+
+
+int main() {
+    tutorial_trim();
+    return 0;
+}
diff --git a/xmake.lua b/xmake.lua
@@ -42,7 +42,8 @@ tutorial_list = {
         "T23-Some",
         "T24-Fence",
         "T25-Coordinator",
-        "T26-Mutable"
+        "T26-Mutable",
+        "T27-Trim",
 }
 
 -- add tutorial target one by one

Original file line number	Diff line number	Diff line change
`@@ -39,6 +39,7 @@ CGRAPH_TUTORIAL_LIST = [`
`39`	`39`	`"T24-Fence",`
`40`	`40`	`"T25-Coordinator",`
`41`	`41`	`"T26-Mutable",`
	`42`	`+ "T27-Trim",`
`42`	`43`	`]`
`43`	`44`
`44`	`45`	`[`
Original file line number	Diff line number	Diff line change
`@@ -28,6 +28,7 @@ set(CGRAPH_TUTORIAL_LIST`
`28`	`28`	`T24-Fence`
`29`	`29`	`T25-Coordinator`
`30`	`30`	`T26-Mutable`
	`31`	`+ T27-Trim`
`31`	`32`	`)`
`32`	`33`
`33`	`34`
Original file line number	Diff line number	Diff line change
`@@ -42,7 +42,8 @@ tutorial_list = {`
`42`	`42`	`"T23-Some",`
`43`	`43`	`"T24-Fence",`
`44`	`44`	`"T25-Coordinator",`
`45`		`- "T26-Mutable"`
	`45`	`+ "T26-Mutable",`
	`46`	`+ "T27-Trim",`
`46`	`47`	`}`
`47`	`48`
`48`	`49`	`-- add tutorial target one by one`