summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorTopi Reinio <topi.reinio@qt.io>2020-10-29 23:13:47 +0100
committerTopi Reinio <topi.reinio@qt.io>2020-10-30 06:19:26 +0100
commitafa341375d17deda23cfb568090af8006108268c (patch)
tree9a5e4bf98570e9b569078cb823cd57b8a49629dd /src
parentae347b23d6cb28e51f49a520ec44471a2194160e (diff)
Doc: Fix documentation warnings for Qt OpenGL
Task-number: QTBUG-86295 Change-Id: I4fff2d61f8f0513181150954440c9357acf73c1d Reviewed-by: Paul Wicking <paul.wicking@qt.io>
Diffstat (limited to 'src')
-rw-r--r--src/opengl/doc/images/openglwindow-example.pngbin0 -> 19920 bytes
-rw-r--r--src/opengl/doc/qtopengl.qdocconf3
-rw-r--r--src/opengl/qopenglversionfunctions.cpp8
-rw-r--r--src/opengl/qopenglversionfunctionsfactory.cpp8
4 files changed, 14 insertions, 5 deletions
diff --git a/src/opengl/doc/images/openglwindow-example.png b/src/opengl/doc/images/openglwindow-example.png
new file mode 100644
index 0000000000..63ba4ed2f4
--- /dev/null
+++ b/src/opengl/doc/images/openglwindow-example.png
Binary files differ
diff --git a/src/opengl/doc/qtopengl.qdocconf b/src/opengl/doc/qtopengl.qdocconf
index 857ad46c8f..f225e19df2 100644
--- a/src/opengl/doc/qtopengl.qdocconf
+++ b/src/opengl/doc/qtopengl.qdocconf
@@ -19,7 +19,8 @@ sourcedirs += .. \
exampledirs += ../../../examples/opengl \
. \
snippets \
- ..
+ .. \
+ ../../gui/doc/snippets
imagedirs += images \
../../../examples/opengl/doc/images
diff --git a/src/opengl/qopenglversionfunctions.cpp b/src/opengl/qopenglversionfunctions.cpp
index 64d9d11218..487bc56b48 100644
--- a/src/opengl/qopenglversionfunctions.cpp
+++ b/src/opengl/qopenglversionfunctions.cpp
@@ -247,9 +247,9 @@ void QAbstractOpenGLFunctionsPrivate::removeExternalFunctions(QOpenGLContext *co
A pointer to an object of the class corresponding to the version and
profile of OpenGL in use can be obtained from
- QOpenGLContext::versionFunctions(). If obtained in this way, note that
- the QOpenGLContext retains ownership of the object. This is so that only
- one instance need be created.
+ QOpenGLVersionFunctionsFactory::get(). If obtained in this way, note that
+ the QOpenGLContext retains ownership of the object. This is so that the
+ instance can be cached and shared.
Before calling any of the exposed OpenGL functions you must ensure that the
object has resolved the function pointers to the OpenGL functions. This
@@ -266,7 +266,7 @@ void QAbstractOpenGLFunctionsPrivate::removeExternalFunctions(QOpenGLContext *co
profile. This is obviously a lot easier to debug than undefined behavior
at run time.
- \sa QOpenGLContext::versionFunctions()
+ \sa QOpenGLVersionFunctionsFactory::get()
*/
/*!
Constructs a QAbstractOpenGLFunctions object.
diff --git a/src/opengl/qopenglversionfunctionsfactory.cpp b/src/opengl/qopenglversionfunctionsfactory.cpp
index d377c64961..6415c9439f 100644
--- a/src/opengl/qopenglversionfunctionsfactory.cpp
+++ b/src/opengl/qopenglversionfunctionsfactory.cpp
@@ -162,6 +162,14 @@ static QAbstractOpenGLFunctions *createFunctions(const QOpenGLVersionProfile &ve
}
/*!
+ \class QOpenGLVersionFunctionsFactory
+ \inmodule QtOpenGL
+ \since 6.0
+ \brief Provides access to OpenGL functions for a specified version and
+ profile.
+*/
+
+/*!
\fn static T *QOpenGLVersionFunctionsFactory::get(QOpenGLContext *context)
\overload get()