From c8a04f9412c1e765a98be86387fd848ca7ea6993 Mon Sep 17 00:00:00 2001
From: Gunnar Sletta <gunnar.sletta@digia.com>
Date: Mon, 7 Jan 2013 16:20:39 +0100
Subject: [PATCH] Greatly improved Scene Graph Overview documentation

Change-Id: I86b6bb9007d268ec039614a1693ecd839901e6d9
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
---
 .../doc/images/sg-renderloop-singlethreaded.jpg    |  Bin 0 -> 29515 bytes
 src/quick/doc/images/sg-renderloop-threaded.jpg    |  Bin 0 -> 45262 bytes
 .../doc/src/concepts/visualcanvas/scenegraph.qdoc  |  240 +++++++++++++++++---
 src/quick/items/qquickitem.cpp                     |   20 ++-
 src/quick/items/qquickwindow.cpp                   |  100 +++-----
 src/quick/scenegraph/coreapi/qsgmaterial.cpp       |   11 +
 src/quick/scenegraph/coreapi/qsgnode.cpp           |   13 +
 src/quick/scenegraph/util/qsgflatcolormaterial.cpp |    1 +
 src/quick/scenegraph/util/qsgsimplematerial.cpp    |    2 +
 src/quick/scenegraph/util/qsgtexturematerial.cpp   |    4 +
 .../scenegraph/util/qsgvertexcolormaterial.cpp     |    1 +
 11 files changed, 292 insertions(+), 100 deletions(-)
 create mode 100644 src/quick/doc/images/sg-renderloop-singlethreaded.jpg
 create mode 100644 src/quick/doc/images/sg-renderloop-threaded.jpg

diff --git a/src/quick/doc/images/sg-renderloop-singlethreaded.jpg b/src/quick/doc/images/sg-renderloop-singlethreaded.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..c6d1577138fdf60aeff29e2fe6b8a2f0e78a8281
GIT binary patch
literal 29515
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
D_9osh

literal 0
HcmV?d00001

diff --git a/src/quick/doc/images/sg-renderloop-threaded.jpg b/src/quick/doc/images/sg-renderloop-threaded.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..2f7d97591bda47a1334b3a2841a7c5a0a8bb332c
GIT binary patch
literal 45262
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
K>(l#}x&IGQ<?8_e

literal 0
HcmV?d00001

diff --git a/src/quick/doc/src/concepts/visualcanvas/scenegraph.qdoc b/src/quick/doc/src/concepts/visualcanvas/scenegraph.qdoc
index 60c4cf1..099c7eb 100644
--- a/src/quick/doc/src/concepts/visualcanvas/scenegraph.qdoc
+++ b/src/quick/doc/src/concepts/visualcanvas/scenegraph.qdoc
@@ -51,7 +51,7 @@ reduction like this can greatly improve performance on some hardware.
 
 The scene graph is closely tied to Qt Quick 2.0 and can not be used
 stand-alone. The scene graph is managed and rendered by the
-QQuickWindow class and custom Item elements can add their graphical
+QQuickWindow class and custom Item types can add their graphical
 primitives into the scene graph through a call to
 QQuickItem::updatePaintNode().
 
@@ -63,54 +63,212 @@ graph will even be rendered on a dedicated render thread while the GUI
 thread is preparing the next frame's state.
 
 
+\section1 Qt Quick Scene Graph Structure
 
-\section1 Scene Graph Nodes
+The scene graph is composed of a number of predefined node types, each
+serving a dedicated purpose. Although we refer to it as a scene graph,
+a more precise definition is node tree. The tree is built from
+QQuickItem types in the QML scene and internally the scene is then
+processed by a renderer which draws the scene. The nodes themselves do
+\b not contain any active drawing code nor virtual \c paint()
+function.
 
-The scene graph can only contain a predefined set of node types, each
-serving a dedicated purpose.
+Even though the node tree is mostly built internally by the existing
+Qt Quick QML types, it is possible for users to also add complete
+subtrees with their own content, including subtrees that represent 3D
+models.
 
-\list
 
-\li QSGGeometryNode - for all rendered content in the scene
-graph. In most cases, it will be enough for a custom QQuickItem object to
-simply return a single QSGGeometryNode object from the
-QQuickItem::updatePaintNode() call. 
+\section2 Nodes
 
-\li QSGTransformNode - implements transformations in the scene
-graph. Nested transforms are multiplied together.
+The most important node for users is the \l QSGGeometryNode. It is
+used to define custom graphics by defining its geometry and
+material. The geometry is defined using \l QSGGeometry and describes
+the shape or mesh of the graphical primitive. It can be a line, a
+rectangle, a polygon, many disconnected rectangles, or complex 3D
+mesh. The material defines how the pixels in this shape are filled.
 
-\li QSGOpacityNode - for node opacity changes. Nested opacity nodes have
-cumulative effect.
+A node can have any number of children and geometry nodes will be
+rendered so they appear in child-order with parents behind their
+children. \note This does not say anything about the actual rendering
+order in the renderer. Only the visual output is guaranteed.
 
-\li QSGClipNode - implements clipping in the scene graph. Nested clips
-are intersected.
+The available nodes are:
+\annotatedlist{qtquick-scenegraph-nodes}
 
-\li QSGNode - base class for all nodes in the scene graph. Its primary purpose
-is provide the ability to insert nodes into the scene graph that do not affect
-the rendering, such as the shared root for a subtree of geometry nodes.
+Custom nodes are added to the scene graph by subclassing
+QQuickItem::updatePaintNode() and setting the
+\l {QQuickItem::ItemHasContents} flag.
 
-\endlist
+\warning It is crucial that OpenGL operations and interaction with the
+scene graph happens exclusively on the render thread, primarily
+during the updatePaintNode() call. The rule of thumb is to only
+use classes with the "QSG" prefix inside the
+QQuickItem::updatePaintNode() function.
+
+For more details, see the \l {Custom Geometry Example}.
+
+\section3 Preprocessing
+
+Nodes have a virtual QSGNode::preprocess() function, which will be
+called before the scene graph is rendered. Node subclasses can set the
+flag \l QSGNode::UsePreprocess and override the QSGNode::preprocess()
+function to do final preparation of their node. For example, dividing a
+bezier curve into the correct level of detail for the current scale
+factor or updating a section of a texture.
+
+\section3 Node Ownership
 
 Ownership of the nodes is either done explicitly by the creator or by
-the scene graph by setting the flag \l QSGNode::OwnedByParent on
-it. Assigning ownership to the scene graph is often preferable as it
+the scene graph by setting the flag \l QSGNode::OwnedByParent.
+Assigning ownership to the scene graph is often preferable as it
 simplifies cleanup when the scene graph lives outside the GUI thread.
 
 
+\section2 Materials
+
+The material describes how the interior of a geometry in a \l
+QSGGeometryNode is filled. It encapsulates an OpenGL shader program
+and provides ample flexibility in what can be achieved, though most of
+the Qt Quick items themselves only use very basic materials, such as
+solid color and texture fills.
+
+For users who just want to apply custom shading to a QML Item type,
+it is possible to do this directly in QML using the \l ShaderEffect
+type.
 
-\section1 Rendering
+Below is a complete list of material classes:
+\annotatedlist{qtquick-scenegraph-materials}
+
+For more details, see the \l {Simple Material Example}
+
+
+\section2 Convenience Nodes
+
+The scene graph API is very low-level and focuses on performance
+rather than convenience. Writing custom geometries and materials from
+scratch, even the most basic ones, requires a non-trivial amount of
+code. For this reason, the API includes a few convenience classes to
+make the most common custom nodes readily available.
+
+\list
+\li \l QSGSimpleRectNode - a QSGGeometryNode subclass which defines a
+rectangular geometry with a solid color material.
+
+\li \l QSGSimpleTextureNode - a QSGGeometryNode subclass which defines
+a rectangular geometry with a texture material.
+\endlist
+
+
+
+\section1 Scene Graph and Rendering
 
 The rendering of the scene graph happens internally in the
-QQuickWindow class and is described under the \l{Scene Graph and
-Rendering} section.
+QQuickWindow class, and there is no public API to access it. There are
+however, a few places in the rendering pipeline where the user can
+attach application code. This can be to add custom scene graph
+content or render raw OpenGL content. The integration points are
+defined by the render loop.
+
+
+\section2 Threaded Render Loop
+
+On many configurations, the scene graph rendering will happen on a
+dedicated render thread. This is done to increase parallelism of
+multi-core processors and make better use of stall times such as
+waiting for a blocking swap buffer call. This offers significant
+performance improvements, but imposes certain restrictions on where
+and when interaction with the scene graph can happen.
 
-How to integrate QPainter based graphics is explained in \l{Custom
-Items using QPainter}.
+The following is a simple outline of how a frame gets
+composed with the threaded render loop.
 
-\section1 Mixing Scene Graph and OpenGL
+\image sg-renderloop-threaded.jpg
+
+\list 1
+
+\li A change occurs in the QML scene, causing \c QQuickItem::update()
+to be called. This can be the result of for instance an animation or
+user input. An event is posted to the render thread to initiate a new
+frame.
+
+\li The render thread prepares to draw a new frame and makes the
+OpenGL context current and initiates a blocks on the GUI thread.
+
+\li While the render thread is preparing the new frame, the GUI thread
+calls QQuickItem::updatePolish() to do final touch-up of items before
+they are rendered.
+
+\li GUI thread is blocked.
+
+\li The QQuickWindow::beforeSynchronizing() signal is emitted.
+Applications can make direct connections (using Qt::DirectConnection)
+to this signal to do any preparation required before calls to
+QQuickItem::updatePaintNode().
 
-The scene graph offers two methods for integrating OpenGL
-content. 
+\li Synchronization of the QML state into the scene graph. This is
+done by calling the QQuickItem::updatePaintNode() function on all
+items that have changed since the previous frame. This is the only
+time the QML items and the nodes in the scene graph interact.
+
+\li GUI thread block is released.
+
+\li The scene graph is rendered:
+    \list 1
+
+    \li The QQuickWindow::beforeRendering() signal is
+    emitted. Applications can make direct connections
+    (using Qt::DirectConnection) to this signal to use custom OpenGL calls
+    which will then stack visually beneath the QML scene.
+
+    \li Items that have specified QSGNode::UsePreprocess, will have their
+    QSGNode::preprocess() function invoked.
+
+    \li The renderer processes the nodes and calls OpenGL functions.
+
+    \li The QQuickWindow::afterRendering() signal is
+    emitted. Applications can make direct connections
+    (using Qt::DirectConnection) to this signal to use custom OpenGL calls
+    which will then stack visually over the QML scene.
+
+    \li The rendered frame is swapped and QQuickWindow::frameSwapped()
+    is emitted.
+
+    \endlist
+
+\li While the render thread is rendering, the GUI is free to advance
+animations, process events, etc.
+
+\endlist
+
+The threaded renderer is currently used by default on Linux, Mac OS X
+and EGLFS based QPA platforms, but this is subject to change. It is
+possible to force use of the threaded renderer by setting \c
+{QML_FORCE_THREADED_RENDERER=1} in the environment.
+
+
+\section2 Non-threaded Render Loop
+
+The non-threaded render loop is currently used by default on Windows
+and non-EGLFS based embedded platforms. This is mostly a precautionary
+measure, as not all combinations of OpenGL drivers and windowing
+systems have been tested.
+
+Even when using the non-threaded render loop, you should write your
+code as if you are using the threaded renderer, as failing to do so
+will make the code non-portable.
+
+The following is a simplified illustration of the frame rendering
+sequence in the non-threaded renderer.
+
+\image sg-renderloop-singlethreaded.jpg
+
+
+\section2 Mixing Scene Graph and OpenGL
+
+The scene graph offers two methods for integrating OpenGL content:
+by calling OpenGL commands directly and by creating a textured node
+in the scene graph.
 
 By connecting to the \l QQuickWindow::beforeRendering() and \l
 QQuickWindow::afterRendering() signals, applications can make OpenGL
@@ -122,6 +280,10 @@ needed to perform the rendering. The downside is that Qt Quick decides
 when to call the signals and this is the only time the OpenGL
 application is allowed to draw. 
 
+The \l {OpenGL Under QML} example gives an example on how to use use
+these signals.
+
+
 The other alternative is to create a FramebufferObject, render into it
 and use the result as a textured node in the scene graph, for instance
 using a QSGSimpleTextureNode. A simple way of doing the same is to use
@@ -131,7 +293,8 @@ the OpenGL rendering and QPainter::endNativePainting() after. When
 OpenGL content is integrated with a texture and FramebufferObject, the
 application has more control over when the content is rendered. For
 instance, the application can create a second QOpenGLContext on the
-GUI thread which shares memory with the scene graph's OpenGL context and drive the rendering manually.
+GUI thread which shares memory with the scene graph's OpenGL context
+and drive the rendering manually.
 
 \warning When mixing OpenGL content with scene graph rendering, it is
 important the application does not leave the OpenGL context in a state
@@ -143,6 +306,19 @@ behavior.
 rendering might be happening outside the GUI thread. 
 
 
+\section2 Custom Items using QPainter
+
+The QQuickItem provides a subclass, QQuickPaintedItem, which allows
+the users to render content using QPainter.
+
+\warning Using QQuickPaintedItem uses an indirect 2D surface to render
+its content, either using software rasterization or using an OpenGL
+framebuffer object (FBO), so the rendering is a two-step
+operation. First rasterize the surface, then draw the surface. Using
+scene graph API directly is always significantly faster.
+
+
+
 \section1 Scene Graph Backend
 
 In addition to the public API, the scene graph has an adaptation layer
@@ -155,7 +331,7 @@ It includes:
 
 \li Custom textures; specifically the implementation of
 QQuickWindow::createTextureFromImage and the internal representation
-of the texture used by \l Image and \l BorderImage elements.
+of the texture used by \l Image and \l BorderImage types.
 
 \li Custom renderer; the adaptation layer lets the plugin decide how
 the scene graph is traversed and rendered, making it possible to
@@ -163,7 +339,7 @@ optimize the rendering algorithm for a specific hardware or to make
 use of extensions which improve performance.
 
 \li Custom scene graph implementation of many of the default QML
-elements, including its text and font rendering.
+types, including its text and font rendering.
 
 \li Custom animation driver; allows the animation system to hook
 into the low-level display vertical refresh to get smooth rendering.
diff --git a/src/quick/items/qquickitem.cpp b/src/quick/items/qquickitem.cpp
index 3907c91..08f60ae 100644
--- a/src/quick/items/qquickitem.cpp
+++ b/src/quick/items/qquickitem.cpp
@@ -1552,7 +1552,7 @@ void QQuickItemPrivate::updateSubFocusItem(QQuickItem *scope, bool focus)
     You can subclass QQuickItem to provide your own custom visual item
     that inherits these features.
 
-    \section2 Custom Items using Scene Graph
+    \section1 Custom Scene Graph Items
 
     All visual QML items are rendered using the scene graph, a
     low-level, high-performance rendering stack, closely tied to
@@ -1570,7 +1570,7 @@ void QQuickItemPrivate::updateSubFocusItem(QQuickItem *scope, bool focus)
     To read more about how the scene graph rendering works, see
     \l{Scene Graph and Rendering}
 
-    \section2 Custom Items using QPainter
+    \section1 Custom QPainter Items
 
     The QQuickItem provides a subclass, QQuickPaintedItem, which
     allows the users to render content using QPainter.
@@ -2972,9 +2972,11 @@ void QQuickItem::geometryChanged(const QRectF &newGeometry, const QRectF &oldGeo
 }
 
 /*!
-    Called by the rendering thread, as a result of
-    QQuickItem::update(), when it is time to sync the state of the QML
-    objects with the scene graph objects.
+    Called on the render thread when it is time to sync the state
+    of the item with the scene graph.
+
+    The function is called as a result of QQuickItem::update(), if
+    the user has set the QQuickItem::ItemHasContents flag on the item.
 
     The function should return the root of the scene graph subtree for
     this item. Most implementations will return a single
@@ -3005,11 +3007,17 @@ void QQuickItem::geometryChanged(const QRectF &newGeometry, const QRectF &oldGeo
     the visual outcome is identical.
 
     \warning It is crucial that OpenGL operations and interaction with
-    the scene graph happens exclusively on the rendering thread,
+    the scene graph happens exclusively on the render thread,
     primarily during the QQuickItem::updatePaintNode() call. The best
     rule of thumb is to only use classes with the "QSG" prefix inside
     the QQuickItem::updatePaintNode() function.
 
+    \warning This function is called on the render thread. This means any
+    QObjects or thread local storage that is created will have affinity to the
+    render thread, so apply caution when doing anything other than rendering
+    in this function. Similarily for signals, these will be emitted on the render
+    thread and will thus often be delivered via queued connections.
+
     \sa QSGMaterial, QSGSimpleMaterial, QSGGeometryNode, QSGGeometry,
     QSGFlatColorMaterial, QSGTextureMaterial, QSGNode::markDirty()
  */
diff --git a/src/quick/items/qquickwindow.cpp b/src/quick/items/qquickwindow.cpp
index d484d42..f812840 100644
--- a/src/quick/items/qquickwindow.cpp
+++ b/src/quick/items/qquickwindow.cpp
@@ -859,87 +859,63 @@ void QQuickWindowPrivate::cleanup(QSGNode *n)
 
     For easily displaying a scene from a QML file, see \l{QQuickView}.
 
-    \section1 Scene Graph and Rendering
 
-    The QQuickWindow uses a scene graph on top of OpenGL to render. This scene graph is disconnected
-    from the QML scene and potentially lives in another thread, depending on the platform
-    implementation. Since the rendering scene graph lives independently from the QML scene, it can
-    also be completely released without affecting the state of the QML scene.
 
-    The sceneGraphInitialized() signal is emitted on the rendering thread before the QML scene is
-    rendered to the screen for the first time. If the rendering scene graph has been released
-    the signal will be emitted again before the next frame is rendered.
+    \section1 Rendering
 
-    The rendering of each frame is broken down into the following
-    steps, in the given order:
+    QQuickWindow uses a scene graph on top of OpenGL to
+    render. This scene graph is disconnected from the QML scene and
+    potentially lives in another thread, depending on the platform
+    implementation. Since the rendering scene graph lives
+    independently from the QML scene, it can also be completely
+    released without affecting the state of the QML scene.
 
-    \list 1
+    The sceneGraphInitialized() signal is emitted on the rendering
+    thread before the QML scene is rendered to the screen for the
+    first time. If the rendering scene graph has been released, the
+    signal will be emitted again before the next frame is rendered.
 
-    \li The QQuickWindow::beforeSynchronizing() signal is emitted.
-    Applications can make direct connections (Qt::DirectConnection)
-    to this signal to do any preparation required before calls to
-    QQuickItem::updatePaintNode().
-
-    \li Synchronization of the QML state into the scene graph. This is
-    done by calling the QQuickItem::updatePaintNode() function on all
-    items that have changed since the previous frame. When a dedicated
-    rendering thread is used, the GUI thread is blocked during this
-    synchroniation. This is the only time the QML items and the nodes
-    in the scene graph interact.
-
-    \li The window to be rendered is made current using
-    QOpenGLContext::makeCurrent().
-
-    \li The QQuickWindow::beforeRendering() signal is
-    emitted. Applications can make direct connections
-    (Qt::DirectConnection) to this signal to use custom OpenGL calls
-    which will then stack visually beneath the QML scene.
 
-    \li Items that have specified QSGNode::UsesPreprocess, will have their
-    QSGNode::preprocess() function invoked.
+    \section2 Integration with OpenGL
 
-    \li The QQuickWindow is cleared according to what is specified
-    using QQuickWindow::setClearBeforeRendering() and
-    QQuickWindow::setClearColor().
+    It is possible to integrate OpenGL calls directly into the
+    QQuickWindow using the same OpenGL context as the Qt Quick Scene
+    Graph. This is done by connecting to the
+    QQuickWindow::beforeRendering() or QQuickWindow::afterRendering()
+    signal.
 
-    \li The scene graph is rendered.
+    \note When using QQuickWindow::beforeRendering(), make sure to
+    disable clearing before rendering with
+    QQuickWindow::setClearBeforeRendering().
 
-    \li The QQuickWindow::afterRendering() signal is
-    emitted. Applications can make direct connections
-    (Qt::DirectConnection) to this signal to use custom OpenGL calls
-    which will then stack visually over the QML scene.
 
-    \li The rendered frame is swapped and QQuickWindow::frameSwapped()
-    is emitted.
+    \section2 Exposure and Visibility
 
-    \endlist
-
-    All of the above happen on the rendering thread, when applicable.
-
-    While the scene graph is being rendered on the rendering thread, the GUI will process animations
-    for the next frame. This means that as long as users are not using scene graph API
-    directly, the added complexity of a rendering thread can be completely ignored.
-
-    When a QQuickWindow is programatically hidden with hide() or setVisible(false), it will
-    stop rendering and its scene graph and OpenGL context might be released. The
-    sceneGraphInvalidated() signal will be emitted when this happens.
+    When a QQuickWindow instance is deliberately hidden with hide() or
+    setVisible(false), it will stop rendering and its scene graph and
+    OpenGL context might be released. The sceneGraphInvalidated()
+    signal will be emitted when this happens.
 
-    \warning It is crucial that OpenGL operations and interaction with the scene graph happens
-    exclusively on the rendering thread, primarily during the updatePaintNode() phase.
+    \warning It is crucial that OpenGL operations and interaction with
+    the scene graph happens exclusively on the rendering thread,
+    primarily during the updatePaintNode() phase.
 
-    \warning As signals related to rendering might be emitted from the rendering thread,
-    connections should be made using Qt::DirectConnection
+    \warning As signals related to rendering might be emitted from the
+    rendering thread, connections should be made using
+    Qt::DirectConnection.
 
 
     \section2 Resource Management
 
-    QML will typically try to cache images, scene graph nodes, etc to improve performance, but in
-    some low-memory scenarios it might be required to aggressively release these resources. The
-    releaseResources() can be used to force clean up of certain resources. Calling releaseResources()
-    may result in the entire scene graph and its OpenGL context being deleted. The
+    QML will try to cache images and scene graph nodes to
+    improve performance, but in some low-memory scenarios it might be
+    required to aggressively release these resources. The
+    releaseResources() can be used to force the clean up of certain
+    resources. Calling releaseResources() may result in the entire
+    scene graph and its OpenGL context being deleted. The
     sceneGraphInvalidated() signal will be emitted when this happens.
 
-    \sa {OpenGL Under QML Example}
+    \sa {OpenGL Under QML}
 
 */
 
diff --git a/src/quick/scenegraph/coreapi/qsgmaterial.cpp b/src/quick/scenegraph/coreapi/qsgmaterial.cpp
index f8f426f..0e40a01 100644
--- a/src/quick/scenegraph/coreapi/qsgmaterial.cpp
+++ b/src/quick/scenegraph/coreapi/qsgmaterial.cpp
@@ -44,12 +44,21 @@
 
 QT_BEGIN_NAMESPACE
 
+/*!
+    \group qtquick-scenegraph-materials
+    \title Qt Quick Scene Graph Material Classes
+    \brief classes used to define materials in the Qt Quick Scene Graph.
+
+    This page lists the material classes in \l {Qt Quick}'s
+    \l {scene graph}{Qt Quick Scene Graph}.
+ */
 
 /*!
     \class QSGMaterialShader
     \brief The QSGMaterialShader class represents an OpenGL shader program
     in the renderer.
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     The QSGMaterialShader API is very low-level. A more convenient API, which
     provides almost all the same features, is available through
@@ -479,6 +488,7 @@ static void qt_print_material_count()
     \class QSGMaterialType
     \brief The QSGMaterialType class is used as a unique type token in combination with QSGMaterial.
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     It serves no purpose outside the QSGMaterial::type() function.
  */
@@ -487,6 +497,7 @@ static void qt_print_material_count()
     \class QSGMaterial
     \brief The QSGMaterial class encapsulates rendering state for a shader program.
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     The QSGMaterial API is very low-level. A more convenient API, which
     provides almost all the same features, is available through
diff --git a/src/quick/scenegraph/coreapi/qsgnode.cpp b/src/quick/scenegraph/coreapi/qsgnode.cpp
index fa56c3b..5995dc8 100644
--- a/src/quick/scenegraph/coreapi/qsgnode.cpp
+++ b/src/quick/scenegraph/coreapi/qsgnode.cpp
@@ -59,10 +59,19 @@ static void qt_print_node_count()
 #endif
 
 /*!
+    \group qtquick-scenegraph-nodes
+    \title Qt Quick Scene Graph Node classes
+    \brief Nodes that can be used as part of the scene graph.
+
+    This page lists the nodes in \l {Qt Quick}'s \l {scene graph}{Qt Quick Scene Graph}.
+ */
+
+/*!
     \class QSGNode
     \brief The QSGNode class is the base class for all nodes in the scene graph.
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-nodes
 
     The QSGNode class can be used as a child container. Children are added with
     the appendChildNode(), prependChildNode(), insertChildNodeBefore() and
@@ -739,6 +748,7 @@ void QSGBasicGeometryNode::setGeometry(QSGGeometry *geometry)
     \brief The QSGGeometryNode class is used for all rendered content in the scene graph.
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-nodes
 
     The QSGGeometryNode consists of geometry and material. The geometry defines the mesh,
     the vertices and their structure, to be drawn. The Material defines how the shape is
@@ -964,6 +974,7 @@ void QSGGeometryNode::setInheritedOpacity(qreal opacity)
     \brief The QSGClipNode class implements the clipping functionality in the scene graph.
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-nodes
 
     Clipping applies to the node's subtree and can be nested. Multiple clip nodes will be
     accumulated by intersecting all their geometries. The accumulation happens
@@ -1052,6 +1063,7 @@ void QSGClipNode::setClipRect(const QRectF &rect)
     \brief The QSGTransformNode class implements transformations in the scene graph
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-nodes
 
     Transformations apply the node's subtree and can be nested. Multiple transform nodes
     will be accumulated by intersecting all their matrices. The accumulation happens
@@ -1188,6 +1200,7 @@ void QSGRootNode::notifyNodeChange(QSGNode *node, DirtyState state)
     \brief The QSGOpacityNode class is used to change opacity of nodes.
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-nodes
 
     Opacity applies to its subtree and can be nested. Multiple opacity nodes
     will be accumulated by multiplying their opacity. The accumulation happens
diff --git a/src/quick/scenegraph/util/qsgflatcolormaterial.cpp b/src/quick/scenegraph/util/qsgflatcolormaterial.cpp
index 4c76f65..3072012 100644
--- a/src/quick/scenegraph/util/qsgflatcolormaterial.cpp
+++ b/src/quick/scenegraph/util/qsgflatcolormaterial.cpp
@@ -124,6 +124,7 @@ const char *FlatColorMaterialShader::fragmentShader() const {
     solid colored geometry in the scene graph.
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     The flat color material will fill every pixel in a geometry using
     a solid color. The color can contain transparency.
diff --git a/src/quick/scenegraph/util/qsgsimplematerial.cpp b/src/quick/scenegraph/util/qsgsimplematerial.cpp
index 612dbbe..bed1b71 100644
--- a/src/quick/scenegraph/util/qsgsimplematerial.cpp
+++ b/src/quick/scenegraph/util/qsgsimplematerial.cpp
@@ -46,6 +46,7 @@
     building custom materials for the scene graph.
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     Where the QSGMaterial and QSGMaterialShader API requires a bit of
     boilerplate code to create a functioning material, the
@@ -221,6 +222,7 @@
     \class QSGSimpleMaterial
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     \brief The QSGSimpleMaterial class is a template generated class
     used to store the state used with a QSGSimpleMateralShader.
diff --git a/src/quick/scenegraph/util/qsgtexturematerial.cpp b/src/quick/scenegraph/util/qsgtexturematerial.cpp
index 3100a84..ff91109 100644
--- a/src/quick/scenegraph/util/qsgtexturematerial.cpp
+++ b/src/quick/scenegraph/util/qsgtexturematerial.cpp
@@ -131,6 +131,8 @@ void QSGOpaqueTextureMaterialShader::updateState(const RenderState &state, QSGMa
     \class QSGOpaqueTextureMaterial
     \brief The QSGOpaqueTextureMaterial class provides a convenient way of
     rendering textured geometry in the scene graph.
+    \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     The opaque textured material will fill every pixel in a geometry with
     the supplied texture. The material does not respect the opacity of the
@@ -323,6 +325,8 @@ int QSGOpaqueTextureMaterial::compare(const QSGMaterial *o) const
     \class QSGTextureMaterial
     \brief The QSGTextureMaterial class provides a convenient way of
     rendering textured geometry in the scene graph.
+    \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     The textured material will fill every pixel in a geometry with
     the supplied texture.
diff --git a/src/quick/scenegraph/util/qsgvertexcolormaterial.cpp b/src/quick/scenegraph/util/qsgvertexcolormaterial.cpp
index 7536712..29f95e5 100644
--- a/src/quick/scenegraph/util/qsgvertexcolormaterial.cpp
+++ b/src/quick/scenegraph/util/qsgvertexcolormaterial.cpp
@@ -114,6 +114,7 @@ const char *QSGVertexColorMaterialShader::fragmentShader() const {
     colored geometry in the scene graph.
 
     \inmodule QtQuick
+    \ingroup qtquick-scenegraph-materials
 
     The vertex color material will give each vertex in a geometry a color. Pixels between
     vertices will be linearly interpolated. The colors can contain transparency.
-- 
1.7.2.5