Skip to content

Latest commit

 

History

History
69 lines (43 loc) · 5.89 KB

README.md

File metadata and controls

69 lines (43 loc) · 5.89 KB

gsnodegraph

Powerful custom node graph widget for wxPython.

"gsnodegraph demo"

Highly inspired by the overall look of the nodes in Blender 3D, if you couldn't tell. So if you've always wanted to find a node editor similar to Blender's, this is likely your repo. ;)

It is specifically aimed towards an image-editing node editor setup and is setup with styling specific to Gimel Studio by default. However, many colors and settings can be changed via the constants.py file and/or it can be adapted and changed for other node graph use-cases with a little knowlege of wxPython.

Usage

Simply pip install gsnodegraph and run the main.py found in this repo to see the node graph demo. The nodegraph.py file shows how you can customize and override the node graph. The nodes.py file in the nodes folder gives a demo of how to setup nodes to work with the node graph.

For a real-life example of this node graph in action, see Gimel Studio a node-based 2D image editor for which this node graph is originally intended.

Status & Roadmap

Most of the functionality for a basic node graph is already here, with more features and fixes planned.

Roadmap/TODO

  • Zoom/pan canvas (still buggy)
  • Basic node drag n' drop
  • Box selection
  • Multi-selection (still buggy)
  • Sockets and wires
  • Properties-based
  • Multi-input and outputs
  • PYPI package
  • Node delete, duplicate and mute
  • Refactor out context menu so that it can be created/edited outside of this package
  • Ctrl+LMB to set node connected to Output #98
  • Support for image thumbnails with expand and collapse functionality #24
  • Support for different input datatypes #83
  • Auto connect nodes when dropped/dragged over a wire
  • Keyboard shortcuts
  • Configurable settings via constants.py
  • Lock zoom to a predefined range
  • Node groups (or "nodes inside of a node") #81
  • Swap node inputs functionality

Extra possiblities (may or may not happen...or may not be included in this package)

  • Nodegraph minimap?
  • Support for multiple output nodes?
  • Auto-arrange nodes in node graph (organize the nodes)?
  • Set image as background of node graph (WIP)

Contributing

All contributions are welcome! Feel free to open a PR or ask questions. :)

Releasing on PyPI

Navigate to the root directory

Run py -m build

Then run twine upload dist/* and follow the prompts.

License

gsnodegraph is licensed under the Apache 2.0 license. Feel free to use this as a starting point, etc for your own projects.