From 6f6fe27cf48ddcc98deb3c5d9b65a9a00a90bf02 Mon Sep 17 00:00:00 2001 From: Gunnar Sletta Date: Mon, 6 Feb 2012 16:40:55 +0100 Subject: Warnings in the before/afterRender docs Change-Id: I2311e574b45d518893ef868fdcf51053dc43bb13 Reviewed-by: Kim M. Kalland --- src/quick/items/qquickcanvas.cpp | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/src/quick/items/qquickcanvas.cpp b/src/quick/items/qquickcanvas.cpp index 72300f9ce5..660d7df77e 100644 --- a/src/quick/items/qquickcanvas.cpp +++ b/src/quick/items/qquickcanvas.cpp @@ -1891,9 +1891,12 @@ QDeclarativeIncubationController *QQuickCanvas::incubationController() const The GL context used for rendering the scene graph will be bound at this point. - Since this signal is emitted from the scene graph rendering thread, the receiver should - be on the scene graph thread or the connection should be Qt::DirectConnection. + \warning Since this signal is emitted from the scene graph rendering thread, the + receiver should be on the scene graph thread or the connection should be Qt::DirectConnection. + \warning Make very sure that a signal handler for beforeRendering leaves the GL + context in the same state as it was when the signal handler was entered. Failing to + do so can result in the scene not rendering properly. */ /*! @@ -1906,8 +1909,12 @@ QDeclarativeIncubationController *QQuickCanvas::incubationController() const The GL context used for rendering the scene graph will be bound at this point. - Since this signal is emitted from the scene graph rendering thread, the receiver should - be on the scene graph thread or the connection should be Qt::DirectConnection. + \warning Since this signal is emitted from the scene graph rendering thread, the + receiver should be on the scene graph thread or the connection should be Qt::DirectConnection. + + \warning Make very sure that a signal handler for afterRendering() leaves the GL + context in the same state as it was when the signal handler was entered. Failing to + do so can result in the scene not rendering properly. */ -- cgit v1.2.3