flow graphs for Gtk+ 3 and Gtk 4

grindhold 12dfff3486 gtkflow: packed node flags into a struct 6 years ago
data d8809aa66c build: exterminate autotools 7 years ago
examples b626319196 examples: added multisink example 6 years ago
libgflow 23b0c9e056 gflow: fixed unlinking behaviour of sources 6 years ago
libgtkflow 95b7a84211 gtkflow: packed node flags into a struct 6 years ago
screenshots e2c6ad571b readme: add screenshots to repo 6 years ago
test 9350e1868b gflow: allow null als value-type for sinks/sources 6 years ago
.gitignore d8809aa66c build: exterminate autotools 7 years ago
.gitlab-ci.yml e591911cd7 gitlab-ci: cd 7 years ago
LICENSE 16cec0bdda added license file 9 years ago
README.md e2c6ad571b readme: add screenshots to repo 6 years ago
meson.build 5b9db7ee9f Update meson.build 6 years ago
meson_options.txt aab52e6982 build: added valadocs to meson files :fire: 7 years ago

README.md

GtkFlow

Here you see libgtkflow, a universal library for drawing flow graphs with Gtk+ 3.

GtkFlowMultisink

We now have Sinks that can receive data from multiple sources!

GtkFlowColor

A more recent screenshot showing off libgtkflow with Gtk > 3.20. It looks a bit clearer.

LibGtkFlow

This is libgtkflow running inside firefox via broadway ↑

GtkFlowWindows

GtkFlow runs unter that strange M$-operating-system, too ↑

GtkFlowRes

The newest stuff in libgtkflow's development ↑ Nodes can be deleted by clicking the X-button in the upper right corner. Nodes are resizable by drag-n-dropping the lower right corner. The types of the docks can be printed along with their names

GtkFlowEvopop

This is a screenshot of libgtkflow rendered with the evopop Gtk3 theme ↑

GtkFlow

This here is the included advanced calculator demo application ↑

Flow graphs are a possibility to let your user model flows of data from, through and into several stations.

Motivation

I love Flowgraphs in other programs and i want to have them in my favourite UI-toolkit Gtk. I ran into some programs which implemented similar functionality but they all didn't feel or even look very Gtk-like/GNOMEy.

Possible Usages

Specific:

Unspecific:

  • Video Compositing (maybe PiTiVi)
  • Visualizing dependencies of objects (e.g. debian packages in apt)

  • … and whatever you can think up.

Stability

Consider the API unstable for now. You will encounter bugs.

Building

Make sure you get the following Dependencies:

  • libgtk-3-dev
  • gobject-introspection
  • meson
  • vala
  • (valadoc)

Then do the following:

$ git clone https://github.com/grindhold/libgtkflow
$ cd libgtkflow
$ mkdir build
$ cd build
$ meson ..
$ ninja
# sudo ninja install

Examples

libgtkflow supports GObject-Introspection which means you can consume it in various popular languages including but not limited to: Python, Perl, Lua, JS, PHP. I compiled some examples on how to program against the library in Python in the examples-folder.

Feel free to add examples for your favorite language.

Note: If you installed the library in /usr/local, you have to export the following environment variables for the examples to work:

$ export LD_LIBRARY_PATH=/usr/local/lib/x86_64-linux-gnu
$ export GI_TYPELIB_PATH=/usr/local/lib/x86_64-linux-gnu/girepository-1.0/

Please be aware that on other architectures than amd64 you will have to change the multiarch string x86_64-linux-gnu to something else that makes sense on your machine.