flow graphs for Gtk+ 3

grindhold 397c9e82f2 gflow: added doc comment to before_linking 6 days ago
data d8809aa66c build: exterminate autotools 3 years ago
examples cc2a621a29 gtkflow: made set_node_renderer usable from vala/c 4 weeks ago
libgflow 397c9e82f2 gflow: added doc comment to before_linking 6 days ago
libgtkflow 6ae018cb0a bumped API to 0.4 4 weeks ago
screenshots b4972b08b2 readme: added screenshot of sameline docks 2 years ago
test 55fb9b79f5 updated to year 2019 in copyright notices 3 months ago
.gitignore 8a629cd2bc gitignore: ignore c files by default 1 month ago
.gitlab-ci.yml e591911cd7 gitlab-ci: cd 3 years ago
LICENSE 16cec0bdda added license file 4 years ago
README.md b4972b08b2 readme: added screenshot of sameline docks 2 years ago
meson.build 6ae018cb0a bumped API to 0.4 4 weeks ago
meson_options.txt aab52e6982 build: added valadocs to meson files :fire: 3 years ago

README.md

GtkFlow

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

SameLineDocks

Sinks and Sources may now appear on the same line

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.