From 1aa4cfab2d437210b8c0b064fa3bd071e53374c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Samuel=20R=C3=B8dal?= <sroedal@trolltech.com>
Date: Fri, 11 Sep 2009 17:32:43 +0200
Subject: Added example to docs for QPainter::beginNativePainting().

Hopefully this helps clarify the use of beginNativePainting().

Reviewed-by: Trond
---
 doc/src/snippets/code/src_gui_painting_qpainter.cpp | 17 +++++++++++++++++
 src/gui/painting/qpainter.cpp                       |  9 +++++++--
 2 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/doc/src/snippets/code/src_gui_painting_qpainter.cpp b/doc/src/snippets/code/src_gui_painting_qpainter.cpp
index 8dfda66..0226161 100644
--- a/doc/src/snippets/code/src_gui_painting_qpainter.cpp
+++ b/doc/src/snippets/code/src_gui_painting_qpainter.cpp
@@ -241,3 +241,20 @@ QImage image(":/images/myImage.png");
 QPainter painter(this);
 painter.drawImage(target, image, source);
 //! [20]
+
+
+//! [21]
+QPainter painter(this);
+painter.fillRect(0, 0, 128, 128, Qt::green);
+painter.beginNativePainting();
+
+glEnable(GL_SCISSOR_TEST);
+glScissor(0, 0, 64, 64);
+
+glClearColor(1, 0, 0, 1);
+glClear(GL_COLOR_BUFFER_BIT);
+
+glDisable(GL_SCISSOR_TEST);
+
+painter.endNativePainting();
+//! [21]
diff --git a/src/gui/painting/qpainter.cpp b/src/gui/painting/qpainter.cpp
index 2dcc20c..a9257c7 100644
--- a/src/gui/painting/qpainter.cpp
+++ b/src/gui/painting/qpainter.cpp
@@ -1894,8 +1894,13 @@ QPaintEngine *QPainter::paintEngine() const
 
 /*!
     Flushes the painting pipeline and prepares for the user issuing
-    native painting commands. Must be followed by a call to
-    endNativePainting().
+    commands directly to the underlying graphics context. Must be
+    followed by a call to endNativePainting().
+
+    Here is an example that shows intermixing of painter commands
+    and raw OpenGL commands:
+
+    \snippet doc/src/snippets/code/src_gui_painting_qpainter.cpp 21
 
     \sa endNativePainting()
 */
-- 
cgit v0.12