AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clarify QOpenGLContext::format() docs

Browse Source 
Avoid unrealistic expectations where applications would assume that
requestedFormat() == format().

Change-Id: I12dcfda3d86ce26f1cae9771b1fe2203291864db
Reviewed-by: Sean Harmer <sean.harmer@kdab.com>
This commit is contained in:
Laszlo Agocs 2014-03-07 13:18:34 +01:00 committed by The Qt Project
parent 9152a3bf20
commit ed5e75cf5b
1 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
src/gui/kernel/qopenglcontext.cpp
View File

@ -885,6 +885,20 @@ QFunctionPointer QOpenGLContext::getProcAddress(const QByteArray &procName) cons
Returns the format of the underlying platform context, if create() has been called.
Otherwise, returns the requested format.
The requested and the actual format may differ. Requesting a given OpenGL version does
not mean the resulting context will target exactly the requested version. It is only
guaranteed that the version/profile/options combination for the created context is
compatible with the request, as long as the driver is able to provide such a context.
For example, requesting an OpenGL version 3.x core profile context may result in an
OpenGL 4.x core profile context. Similarly, a request for OpenGL 2.1 may result in an
OpenGL 3.0 context with deprecated functions enabled. Finally, depending on the
driver, unsupported versions may result in either a context creation failure or in a
context for the highest supported version.
Similar differences are possible in the buffer sizes, for example, the resulting
context may have a larger depth buffer than requested. This is perfectly normal.
*/
QSurfaceFormat QOpenGLContext::format() const
{