https://github.com/shadowsocks-net/qnodeeditor
https://github.com/shadowsocks-net/qnodeeditor
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/shadowsocks-net/qnodeeditor
- Owner: Shadowsocks-NET
- License: bsd-3-clause
- Created: 2021-05-10T11:04:43.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2021-08-22T14:33:37.000Z (almost 4 years ago)
- Last Synced: 2025-02-07T15:23:36.552Z (5 months ago)
- Language: C++
- Size: 2.2 MB
- Stars: 1
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### About this Fork
This repository keeps master branch aligned with the original repository [paceholder/nodeeditor](https://github.com/paceholder/nodeeditor).
In the **develop branch** can be found some fix or feature never merged in the original repository and some additional feature.
The status of the current improvements can be found in issues tracker.
However the main changes involve:
* CMake Qt6 compatibie
* Copy/paste functionality.
* Allow multiple connection for a single input port.
* Subcategories for nodes.
* Dynamic ports nodes.
* Fixed cyclic loop crash.
### Purpose
**NodeEditor** is conceived as a general-purpose Qt-based library aimed at
graph-controlled data processing. Nodes represent algorithms with certain inputs
and outputs. Connections transfer data from the output (source) of the first node
to the input (sink) of the second one.
**NodeEditor** framework is a Visual [Dataflow
Programming](https://en.wikipedia.org/wiki/Dataflow_programming) tool. A library
client defines models and registers them in the data model registry. Further
work is driven by events taking place in DataModels and Nodes. The model
computing is triggered upon arriving of any new input data. The computed result
is propagated to the output connections. Each new connection fetches available
data and propagates is further.
Each change in the source node is immediately propagated through all the
connections updating the whole graph.
### Platforms
* OSX (Apple Clang - LLVM 3.6), Linux (x64, gcc-7.0, clang-7): [](https://travis-ci.org/paceholder/nodeeditor)
* Windows (Win32, x64, msvc2017, MinGW 5.3): [](https://ci.appveyor.com/project/paceholder/nodeeditor/branch/master)
### Dependencies
* Qt > 5.12
* CMake 3.4
* Catch2
### Current state
* Model-based nodes
* Automatic data propagation
* Datatype-aware connections
* Embedded Qt widgets
* One-output to many-input connections
* JSON-based interface styles
* Saving scenes to JSON files
### Building
#### Linux
~~~
git clone [email protected]:paceholder/nodeeditor.git
cd nodeeditor
mkdir build
cd build
cmake ..
make -j && make install
~~~
#### Qt Creator
1. Open `CMakeLists.txt` as project.
2. If you don't have the `Catch2` library installed, go to `Build Settings`, disable the checkbox `BUILD_TESTING`.
3. `Build -> Run CMake`
4. `Build -> Build All`
5. Click the button `Run`
### Roadmap
1. Extend set of examples
2. GUI: fix scrolling for scene view window scrolling
3. Implement grouping nodes
4. Split graph and GUI parts
5. Build data propagation on top of the graph code
### Citing
Dmitry Pinaev et al, Qt5 Node Editor, (2017), GitHub repository, https://github.com/paceholder/nodeeditor
BibTeX
@misc{Pinaev2017,
author = {Dmitry Pinaev et al},
title = {Qt5 Node Editor},
year = {2017},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/paceholder/nodeeditor}},
commit = {1d1757d09b03cea0e4921bc19659465fe6e65b9b}
}
### Youtube video:
[](https://www.youtube.com/watch?v=pxMXjSvlOFw)
### Now with styles
[](https://www.youtube.com/watch?v=i_pB-Y0hCYQ)
### Buy me a beer
[](https://paypal.me/DmitryPinaev)
### Showcase
#### [Chigraph](https://github.com/chigraph/chigraph)
Chigraph is a programming language for beginners that is unique in that it is an
intuitive flow graph:
It features easy bindings to C/C++, package management, and a cool interface.
#### [Spkgen particle engine editor](https://github.com/fredakilla/spkgen)
Spkgen is an editor for the SPARK particles engine using a node-based interface
to create particles effects for games.