NodeGraphProcessor 使用教程

NodeGraphProcessor 使用教程

项目地址:https://gitcode.com/gh_mirrors/no/NodeGraphProcessor

1. 项目介绍

NodeGraphProcessor 是一个基于 Unity UIElements 和 C# 的节点图编辑器框架，专注于数据处理。它提供了一个强大的 C# API，允许开发者实现条件图、依赖图、处理图等多种类型的节点图。该框架基于 Unity 的 GraphView 技术，具有高性能和良好的扩展性，适用于处理大型图结构。

2. 项目快速启动

2.1 安装 NodeGraphProcessor

2.1.1 通过 Unity Package Manager 安装

1. 下载 NodeGraphProcessor 的 GitHub 仓库。
2. 在 Unity 中打开 Package Manager，点击右上角的 "+" 按钮，选择 "Add package from disk"。
3. 选择下载的仓库中的 package.json 文件，点击 "Open"。

2.1.2 通过 OpenUPM 安装

1. 安装 openupm-cli：

   npm install -g openupm-cli
   

2. 使用 openupm-cli 安装 NodeGraphProcessor：

   openupm add com.alelievr.node-graph-processor
   

2.2 创建第一个节点图

1. 创建一个新的 C# 脚本，命名为 SubNode.cs：

   using System;
   using System.Collections.Generic;
   using UnityEngine;
   using GraphProcessor;
   
   [System.Serializable]
   [NodeMenuItem("Operations/Sub")]
   public class SubNode : BaseNode
   {
       [Input(name = "A")]
       public float inputA;
   
       [Input(name = "B")]
       public float inputB;
   
       [Output(name = "Out")]
       public float output;
   
       public override string name => "Sub";
   
       protected override void Process()
       {
           output = inputA - inputB;
       }
   }
   

2. 在 Unity 中创建一个新的 ScriptableObject，命名为 MyGraph.asset，并将其类型设置为 BaseGraph。

3. 在 MyGraph 中添加 SubNode，并连接输入和输出端口。

3. 应用案例和最佳实践

3.1 应用案例

NodeGraphProcessor 可以用于创建各种类型的节点图，例如：

• 条件图：用于逻辑判断和条件分支。
• 依赖图：用于管理任务之间的依赖关系。
• 处理图：用于数据处理和计算。

3.2 最佳实践

• 模块化设计：将复杂的逻辑拆分为多个小节点，便于管理和维护。
• 性能优化：对于大型图结构，使用图处理器来优化节点执行顺序。
• 自定义节点：通过扩展 BaseNode 类来创建自定义节点，满足特定需求。

4. 典型生态项目

• Mixture：一个基于 NodeGraphProcessor 的材质混合工具，用于创建复杂的材质效果。
• NodeBasedDialogueSystem：一个基于 NodeGraphProcessor 的对话系统，用于创建交互式对话树。

通过以上步骤，您可以快速上手 NodeGraphProcessor，并利用其强大的功能构建复杂的节点图应用。

NodeGraphProcessor Node graph editor framework focused on data processing using Unity UIElements and C# 4.6 项目地址: https://gitcode.com/gh_mirrors/no/NodeGraphProcessor