• Stars
    star
    2,137
  • Rank 21,593 (Top 0.5 %)
  • Language
    C#
  • License
    MIT License
  • Created over 6 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Node graph editor framework focused on data processing using Unity UIElements and C# 4.6

NodeGraphProcessor

Node graph editor framework focused on data processing using Unity UIElements, GraphView and C# 4.7

Discord Codacy Badge openupm

This node based solution provides a great C# API allowing you to implement conditional graphs, dependencies graphs, processing graphs and more.
image

Based on Unity's GraphView technology, NodeGraphProcessor is also very fast and works well with large graphs.
Performance

Simple and powerful C# node API to create new nodes and custom views.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using GraphProcessor;
using System.Linq;

[System.Serializable, NodeMenuItem("Operations/Sub")] // Add the node in the node creation context menu
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";

    // Called when the graph is process, process inputs and assign the result in output.
    protected override void Process()
    {
        output = inputA - inputB;
    }
}

Unity Compatible versions

This project requires at least Unity 2020.2 with a scripting runtime version of 4.x in player settings.
The current Unity version used for the project is 2020.2.0f1, if you want to install NodeGraphProcessor in an older unity project, you can install it via Open UPM (minimum version: Unity 2019.3).

Installation

Instructions

Install Manually

There are two ways to install this asset: you can use the Unity package manager or move the entire repo inside your Assets folder. To install using the package manager:

  • download this repo
  • inside the package manager click the '+' button at the bottom to add a package from disk
  • then select the package.json file located in Assets/NodeGraphProcessor
  • package is installed :)

Install via OpenUPM

The package is available on the openupm registry. It's recommended to install it via openupm-cli.

openupm add com.alelievr.node-graph-processor

Install via Git

Alternatively, you can use the git address feature in the package manager on the branch #upm, it only contains the package but it may be out of sync compared to master.

Note that you'll not have access to the examples provided in this repo because the package only include the core of NodeGraphProcessor.

Community

Join the NodeGraphProcessor Discord server!

Features

  • Node and Graph property serialization (as json)
  • Scriptable Object to store graph as a Unity asset.
  • Highly customizable and simple node and links API
  • Support multi-input into a container (multiple float into a list of float for example)
  • Graph processor which execute node's logic with a dependency order
  • Documented C# API to add new nodes / graphs
  • Exposed parameters that can be set per-asset to customize the graph processing from scripts or the inspector
  • Parameter set mode, you can now output data from thegraph using exposed parameters. Their values will be updated when the graph is processed
  • Search window to create new nodes
  • Colored groups
  • Node messages (small message with it's icon beside the node)
  • Stack Nodes
  • Relay nodes
  • Display additional settings in the inspector
  • Node creation menu on edge drop
  • Simplified edge connection compared to default GraphView (ShaderGraph and VFX Graph)
  • Multiple graph window workflow (copy/paste)
  • Vertical Ports
  • Sticky notes (requires Unity 2020.1)
  • Renamable nodes

More details are available in the Changelog

Documentation

API doc is available here: alelievr.github.io/NodeGraphProcessor

The user manual is hosted using Github Wiki.

Remaining to do

  • Investigate for ECS/Jobs integration
  • API to create the graph in C#
  • Subgraphs

For more details consult our Github Project page.

Projects made with NodeGraphProcessor

Mixture

image

Want to be in the made with list? Send a message to the issue #14

Gallery

Minimap

Relay nodes

Node connection menu

Node creation menu

Graph Parameters

Groups

Node Settings

Node Messages

Conditional Processing (in Example)

Stacks

Relay Node Packing

Node Inspector

Improved Edge Connection

Multi-Window support

Field Drawers (Thanks @TeorikDeli!)

Sticky Notes (2020.1 or more required)

image

Vertical Ports

image

Drag And Drop Objects

CreateNodeFromObject

Renamable nodes

Just add this bit of code in your Node script to make it renamable in the UI.

        public override bool	isRenamable => true;

RenamableNode

More Repositories

1

HDRP-Custom-Passes

A bunch of custom passes made for HDRP
C#
1,260
star
2

Mixture

Mixture is a powerful node-based tool crafted in unity to generate all kinds of textures in realtime
C#
930
star
3

libft-unit-test

C
447
star
4

Procedural-Worlds-Editor

Procedural World Editor is a node based procedural terrain generator
C#
273
star
5

HDRP-UI-Camera-Stacking

Optimized implementation of camera stacking for UI only in HDRP.
ShaderLab
135
star
6

MasterUnityHandles

Unity custom handles examples
C#
96
star
7

printf-unit-test

C++
30
star
8

SOIL2

C
15
star
9

ProceduralTerrainGPU

HLSL
11
star
10

shaderRender

C
9
star
11

PolygonBurst

C#
7
star
12

VoxelEngine

Vulkan engine in c++ exploiting the compute shaders to generate voxel terrain
C++
6
star
13

ShaderSourceExtractor

Unity shader source extractor
ShaderLab
5
star
14

MixAndGameJam_2019

Mix and Game jam 2019
C#
5
star
15

PostEffects

Small unity post processing effects missing from the post processing stack
C#
5
star
16

THE_FUTURE

program used to render shaders on multiple imacs during the artistik rezo party
GLSL
5
star
17

UnityGraphSerialization

Unity graph serialization tests
C#
4
star
18

42sh

42sh
C
4
star
19

LightweightGraphicCore

Lightweight Graphic Vulkan wrapper to manage windows, allocations, shader compilation, GUI and more
C++
4
star
20

DistanceFieldGraph

C#
3
star
21

GGJ2019

C#
3
star
22

ProceduralTextureExporter

C#
3
star
23

Mixture-dev

ShaderLab
3
star
24

DistributionVisualization

C#
2
star
25

Coders-of-the-caribbean

Unity visualizer for CondiinGame challenge: Coders of the Caribbean
C#
2
star
26

Ludum-Dare-43

C#
2
star
27

Touhou-jam

C#
1
star
28

2D-JamStartupKit

A Unity kit of assets and scripts for game jams
C#
1
star
29

Unity-analytics-test

C#
1
star
30

JamKit

A bunch of useful scripts for jam games
C#
1
star
31

Binary-Security

C
1
star
32

Open-Game-Jam-1

C#
1
star
33

AudioFractal

Little Audio fractal visualizer using KlakLasp
C#
1
star
34

malloc

C
1
star
35

HDRP-Mobile

Unlock HDRP to build on mobile devices
C#
1
star