From 89cb92f838b43123f51bfddba433bfe54c0e855d Mon Sep 17 00:00:00 2001 From: Laszlo Agocs Date: Tue, 24 Mar 2015 17:42:39 +0100 Subject: Document AA_* that must be set before app construction After seeing multiple apps falling into the trap of setting AA_ShareOpenGLContexts after constructing the q(gui)app, it is time to add some more docs regarding this. Task-number: QTBUG-47637 Change-Id: I01b5be0980d038efc56fd649d4a1fee26c33aef8 Reviewed-by: Andy Shaw Reviewed-by: Giuseppe D'Angelo --- src/corelib/global/qnamespace.qdoc | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) (limited to 'src') diff --git a/src/corelib/global/qnamespace.qdoc b/src/corelib/global/qnamespace.qdoc index aeff9502fe..a912e65d30 100644 --- a/src/corelib/global/qnamespace.qdoc +++ b/src/corelib/global/qnamespace.qdoc @@ -170,12 +170,13 @@ \value AA_UseDesktopOpenGL Forces the usage of desktop OpenGL (for example, \e opengl32.dll or \e libGL.so) on platforms that use dynamic loading - of the OpenGL implementation. - This value has been added in Qt 5.3. + of the OpenGL implementation. This value has been added in Qt 5.3. + This attribute must be set before Q(Gui)Application is constructed. \value AA_UseOpenGLES Forces the usage of OpenGL ES 2.0 or higher on platforms that use dynamic loading of the OpenGL implementation. - This value has been added in Qt 5.3. + This value has been added in Qt 5.3. This attribute must be set + before Q(Gui)Application is constructed. \value AA_UseSoftwareOpenGL Forces the usage of a software based OpenGL implementation on platforms that use dynamic loading of the OpenGL @@ -186,13 +187,15 @@ \c opengl32sw.dll and can be overridden by setting the environment variable \e QT_OPENGL_DLL. See the platform-specific pages, for instance \l{Qt for Windows}, for more information. This value has - been added in Qt 5.4. + been added in Qt 5.4. This attribute must be set before + Q(Gui)Application is constructed. \value AA_ShareOpenGLContexts Enables resource sharing between the OpenGL contexts used by classes like QOpenGLWidget and QQuickWidget. This allows sharing OpenGL resources, like textures, between QOpenGLWidget instances that belong to different top-level windows. This value has - been added in Qt 5.4. + been added in Qt 5.4. This attribute must be set before + Q(Gui)Application is constructed. \value AA_SetPalette Indicates whether a palette was explicitly set on the QApplication/QGuiApplication. This value has been added in Qt 5.5. -- cgit v1.2.3