GTK Scene Graph Kit
GTK Scene Graph Kit (GSK) is the rendering and scene graph API for GTK introduced with version 3.90. GSK lies between the graphical control elements (widgets) and the rendering.
|Original author(s)||Manuelle Bassi et al.|
|Developer(s)||The GNOME Project|
|Initial release||March 24, 2017|
|Stable release||3.24.4 (January 21, 2019 ) [±]|
|Preview release||3.94 / 3.23.0|
(June 28, 2018
June 21, 2018 ) [±]
|Operating system||Part of GTK+|
GSK is part of GTK. GSK is meant to be used by GTK itself and by GTK-based applications that wish to replace Clutter for their UI. Applications that made use of Clutter instead of using only GTK are e.g. GNOME Shell, GNOME Videos, GNOME Boxes and Cheese.
Any application which makes use of GTK's graphical control elements (widgets), as opposed to those applications getting a GTK window and then drawing themselves on it, benefit from GSK.
Drawing graphical control elements (widgets) without a scenegraph leads to rendering things that don't show up on the screen, things that do not need to be rendered; hence it leads to avoidable performance and battery life losses. The scenegraph is used to do hidden surface determination.
The way widgets were drawn in GTK+ (when not using Clutter), was, that a draw function (part of GDK hence the name (GIMP "Drawing" Kit)) drew everything. There was no way to know, what has just been drawn. To know where the mouse pointer was currently hovering over, the current position had to be computed. With GSK, it should be fairly easy to write complex graphical control elements (widgets) and still track easily the whereabout of the mouse pointer.
It was decided for GTK to move to a Cascading Style Sheet (CSS)-based model for how graphical control elements (widgets) are styled (i.e. themed/skinned) and rendered. In CSS, shadows, borders, padding and style properties have well-defined semantics. Some of those semantics are difficult to implement with the old GTK drawing model.
GSK makes use of graphene, an external library which houses a collection of geometry types — points, sizes, rectangles, vectors, quads, quaternions, matrices. graphene has been ported to the Meson build system.
GSK rendering pipeline
- The lower layer is a simple rendering tree of operations; it can be transformed into appropriate rendering commands with minimal state changes, so it gets transformed into the rendering pipeline. The tree of rendering operations is represented by GskRenderNode instances; an instance of GskRenderer takes the render nodes and submits them (after potentially reordering and transforming them to a more appropriate representation) to the underlying graphic system.
- higher layer: a complex set of logical layers; it adds a high level convenience API for application developers.
Clutter was released to the public on June 22, 2006. The integration library "clutter-gtk" has been available since 2006-11-29.
At the 2nd Desktop Summit in August 2011 in Berlin there was quite some talk regarding "GTK+ 4.0 and Clutter 2.0".
Idea to introduce a scene graph to GTK+
In 2008 developers such as Havoc Pennington were considering to add a scene canvas to GTK+, as people outside of GTK+ were making use of things like Clutter, Pigment, HippoCanvas or GooCanvas. It was proposed to make graphical control elements (widgets) one kind of object in a more flexible scene graph.
- before GSK drawing used to be done by GDK ... handling basic rendering such as drawing primitives, raster graphics (bitmaps), cursors, fonts, as well as window events and drag-and-drop functionality
In June 2006 Clutter, an OpenGL-based 'interactive canvas' library, was released. Clutter has its own scene graph, and GNOME developers preferred to use Clutter's scene graph with GTK+, facilitated by a library called clutter-gtk. Clutter can be embedded into every GNOME application by using the clutter-gtk library. The clutter-gtk library provides a GtkClutterEmbed GTK+ widget which can be used to display a ClutterStage.
Some thought went into how to merge Clutter and GTK in a better way than the clutter-gtk library.
In 2011 Firefox introduced "Azure" and Joe Drew and Bas Schouten bothered with some explanations.
- At GUADEC2013 in Brno Emmanuele shared his idea on implementing a scene graph and an animation framework inside the GNOME platform (after working for the past 6 years on Clutter).
- GTK+ Scene Graph Kit (GSK) is the forthcoming scene graph for GTK+ in the process of being written by Emanuele Bassi.
- 2014-Jul-30 Emanuelle stated, he thought there shouldn't be a – stand-alone – Clutter 2.0.
There was a presentation at the 2014 Developer Experience Hackfest regarding a new scene graph for GTK+ aimed at being merged into GTK+ 3.16. Then GSK was planned to be ready and fully integrated into GTK+ version 3.20, to be released in March 2016. This was postponed to 3.22., and then finally merged into 3.90.
- Bassi, Emmanuele (2014-05-02). "Graphene".
- Bassi, Emmanuele (2016-10-18). "Initial implementation of GSK rendering pipeline".
- Bassi, Emmanuele (2006-11-29). "add clutter-gtk".
- Bassi, Emmanuele (2011-08-31). "GTK+ 4.0 and Clutter 2.0: rainbows and unicorns".
- Pennington, Havoc (2008-03-07). "Havoc Pennington's scene graph proposal".
- Bassi, Emmanuele (2014-07-29). "The GTK+ Scene Graph Kit".
- "clutter-gtk on git.gnome".
- "Introducing the Azure project". 2011-04-26.
- "Comparing Performance: Azure vs Cairo". 2011-06-06.
- "Releasing Azure". 2011-08-16.
- Bassi, Emmanuele (2013-08-12). "Future in the past GTK scene-graph".
- Bassi, Emmanuele (2014-07-29). "The GTK+ Scene Graph Kit".
- Bassi, Emmanuele (2014-07-30). "Halting Problem – Future in the Past".
- "2014 Developer Experience Hackfest: A scene graph for GTK+ 3.16".
- "GNOME Wiki: roadmap for GTK+".
- Bassi, Emmanuele (2016-08-16). "GTK: are we in the future, yet?".
- "Qt Quick Scene Graph".
- GNOME Reference Manual for GSK4 unstable
- GSK Demystified (I),(II),(III) – Emmanuele Bassi, 2016/08
- GSK code from release GTK+ 3.89.5
- The modern Gtk drawing model – Alexander Larsson, 2013/11/04
- Overview of GTK+ and its Libraries - The GTK+ Project