Commit 89cb92f8 authored by Laszlo Agocs's avatar Laszlo Agocs
Browse files

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: default avatarAndy Shaw <andy.shaw@theqtcompany.com>
Reviewed-by: default avatarGiuseppe D'Angelo <giuseppe.dangelo@kdab.com>
Showing with 8 additions and 5 deletions
...@@ -170,12 +170,13 @@ ...@@ -170,12 +170,13 @@
\value AA_UseDesktopOpenGL Forces the usage of desktop OpenGL (for example, \value AA_UseDesktopOpenGL Forces the usage of desktop OpenGL (for example,
\e opengl32.dll or \e libGL.so) on platforms that use dynamic loading \e opengl32.dll or \e libGL.so) on platforms that use dynamic loading
of the OpenGL implementation. 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_UseOpenGLES Forces the usage of OpenGL ES 2.0 or higher on \value AA_UseOpenGLES Forces the usage of OpenGL ES 2.0 or higher on
platforms that use dynamic loading of the OpenGL implementation. 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 \value AA_UseSoftwareOpenGL Forces the usage of a software based OpenGL
implementation on platforms that use dynamic loading of the OpenGL implementation on platforms that use dynamic loading of the OpenGL
...@@ -186,13 +187,15 @@ ...@@ -186,13 +187,15 @@
\c opengl32sw.dll and can be overridden by setting the environment \c opengl32sw.dll and can be overridden by setting the environment
variable \e QT_OPENGL_DLL. See the platform-specific pages, for variable \e QT_OPENGL_DLL. See the platform-specific pages, for
instance \l{Qt for Windows}, for more information. This value has 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 \value AA_ShareOpenGLContexts Enables resource sharing between the OpenGL
contexts used by classes like QOpenGLWidget and QQuickWidget. This contexts used by classes like QOpenGLWidget and QQuickWidget. This
allows sharing OpenGL resources, like textures, between QOpenGLWidget allows sharing OpenGL resources, like textures, between QOpenGLWidget
instances that belong to different top-level windows. This value has 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 \value AA_SetPalette Indicates whether a palette was explicitly set on the
QApplication/QGuiApplication. This value has been added in Qt 5.5. QApplication/QGuiApplication. This value has been added in Qt 5.5.
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment