Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cb109/qtnodes
:twisted_rightwards_arrows: Node graph visualization and editing with PySide.
https://github.com/cb109/qtnodes
Last synced: 5 days ago
JSON representation
:twisted_rightwards_arrows: Node graph visualization and editing with PySide.
- Host: GitHub
- URL: https://github.com/cb109/qtnodes
- Owner: cb109
- License: mit
- Created: 2015-11-18T23:30:35.000Z (almost 9 years ago)
- Default Branch: develop
- Last Pushed: 2021-06-16T20:55:45.000Z (over 3 years ago)
- Last Synced: 2024-08-02T12:44:42.551Z (3 months ago)
- Language: Python
- Homepage:
- Size: 8.99 MB
- Stars: 155
- Watchers: 19
- Forks: 34
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-starred - cb109/qtnodes - :twisted_rightwards_arrows: Node graph visualization and editing with PySide. (others)
README
# qtnodes
Node graph visualization and editing with PySide.
Very **WIP** right now, the goal is to have a bunch of premade components that make it easy to implement a node graph to store and modify arbitrary data.
The UI part is coming along nicely, but no actual data handling is attached to it yet.
## UI Example
Although this graph makes no sense, it shows the current look and feel:
## Code Example
```python
from PySide import QtGui
from qtnodes import (Header, Node, InputKnob,
OutputKnob, NodeGraphWidget)
class Multiply(Node):
def __init__(self, *args, **kwargs):
super(Multiply, self).__init__(*args, **kwargs)
self.addHeader(Header(node=self, text=self.__class__.__name__))
self.addKnob(InputKnob(name="x"))
self.addKnob(InputKnob(name="y"))
self.addKnob(OutputKnob(name="value"))
app = QtGui.QApplication([])
graph = NodeGraphWidget()
graph.registerNodeClass(Multiply)
graph.addNode(Multiply())
graph.show()
app.exec_()
```
## Usage
To start a small demo:
$ python -m qtnodes
You can load example **.json** files from `examples/`.
### Scene
- **Pan the viewport**: Hold the middle mousebutton and drag.
- **Zoom the viewport**: Use the mouse wheel.
- **Save scene to file:** Rightclick > Scene > Save As...
- **Load scene from file:** Rightclick > Scene > Open File...
- **Merge scene from file:** Rightclick > Scene > Merge File...
- **Clear complete scene:** Rightclick > Scene > Clear Scene
- **Hold scene state:** Rightclick > Scene > Hold
- **Fetch scene state:** Rightclick > Scene > Fetch
- **Autolayout scene:** Rightclick > Scene > Auto Layout
Please note: The automatic layout needs [graphviz](http://www.graphviz.org), which means its `dot` command must be on **PATH**.
### Nodes
- **Select a node**: Leftclick its header.
- **Select multiple nodes**: Leftclick and drag a rectangle over the nodes, release to select.
- **Create a node**: Rightclick > Nodes, choose a node type.
- **Move a node**: Leftclick and drag its header.
- **Delete a node**: Select it then press `DELETE`.
- **Create a connection**: Hover over a knob, then leftclick and drag to another knob. You can only connect inputs to outputs and vice versa.
- **Remove a connection**: Hold `ALT` (on Windows, use `CTRL` on Linux/MacOs), the connections turn red, click one to remove it.
## Credits
This started as a port of the original Qt/C++ tool `qnodeseditor` by Stanislaw Adaszewski, see:
http://algoholic.eu/qnodeseditor-qt-nodesports-based-data-processing-flow-editor/
Additional sources and inspirations:
- http://austinjbaker.com/node-editor-prototype
- http://nukengine.com/blog/category/all/qt-node-editor/
- http://blog.interfacevision.com/design/design-visual-progarmming-languages-snapshots/
- https://github.com/Tillsten/qt-dataflow
- https://gist.github.com/dbr/1255776 (Nuke node layout with graphviz)
## License
**MIT**, see [LICENSE.txt](LICENSE.txt)