summaryrefslogtreecommitdiffstats
path: root/examples
diff options
context:
space:
mode:
authorLeena Miettinen <riitta-leena.miettinen@qt.io>2016-06-07 11:26:24 +0200
committerJani Heikkinen <jani.heikkinen@qt.io>2016-06-08 09:49:30 +0000
commita30b9dc1f32fca8857773c14a9b5535c431f84b0 (patch)
tree00e9564b80928e0316a325641004f4d84bd7ca2c /examples
parente6a1238709b703cf7f1ed8f08b4ea6241b9786f4 (diff)
Doc: Add docs for the Deferred Renderer example
Change-Id: Icc1e688ffb44431841054324fddecb2b6402d94b Reviewed-by: Topi Reiniƶ <topi.reinio@theqtcompany.com> Reviewed-by: Paul Lemire <paul.lemire@kdab.com>
Diffstat (limited to 'examples')
-rw-r--r--examples/qt3d/deferred-renderer-cpp/doc/src/deferred-renderer-cpp.qdoc21
1 files changed, 21 insertions, 0 deletions
diff --git a/examples/qt3d/deferred-renderer-cpp/doc/src/deferred-renderer-cpp.qdoc b/examples/qt3d/deferred-renderer-cpp/doc/src/deferred-renderer-cpp.qdoc
index 65311e77f..610270316 100644
--- a/examples/qt3d/deferred-renderer-cpp/doc/src/deferred-renderer-cpp.qdoc
+++ b/examples/qt3d/deferred-renderer-cpp/doc/src/deferred-renderer-cpp.qdoc
@@ -29,4 +29,25 @@
\example deferred-renderer-cpp
\title Qt 3D: Deferred Renderer C++ Example
\ingroup qt3d-examples-cpp
+ \brief A C++ application that demonstrates rendering to an intermediate
+ G-buffer.
+
+ \e {Deferred Renderer} demonstrates using a two pass rendering method.
+ First, all the meshes in the scene are drawn using the same shader that will
+ output the following values for each fragment: world normal vector, color,
+ depth, and world position vector.
+
+ Each of these values will be stored in a texture, which together form what
+ is called the G-buffer. Nothing is drawn onscreen during the first pass, but
+ rather drawn into the G-buffer ready for later use.
+
+ Once all the meshes have been drawn, the G-buffer is filled with all the
+ meshes that can currently be seen by the camera. The second render pass is
+ then used to render the scene to the back buffer with the final color
+ shading by reading the values from the G-buffer textures and outputting a
+ color onto a full screen quad.
+
+ For more information, see \l{Deferred Renderer}.
+
+ \include examples-run.qdocinc
*/