QGLFunctions - cross-platform access to ES2.0 API

2 files changed, 245 insertions, 0 deletions

diff --git a/tests/auto/qglfunctions/qglfunctions.pro b/tests/auto/qglfunctions/qglfunctions.pro
new file mode 100644
index 0000000..aa81547
--- /dev/null
+++ b/tests/auto/qglfunctions/qglfunctions.pro
@@ -0,0 +1,7 @@
+load(qttest_p4)
+requires(contains(QT_CONFIG,opengl))
+QT += opengl
+
+win32:!wince*: DEFINES += QT_NO_EGL
+
+SOURCES += tst_qglfunctions.cpp
diff --git a/tests/auto/qglfunctions/tst_qglfunctions.cpp b/tests/auto/qglfunctions/tst_qglfunctions.cpp
new file mode 100644
index 0000000..8d6be73
--- /dev/null
+++ b/tests/auto/qglfunctions/tst_qglfunctions.cpp
@@ -0,0 +1,238 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the QtOpenGL module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include <QtTest/QtTest>
+#include <QtOpenGL/qglfunctions.h>
+
+class tst_QGLFunctions : public QObject
+{
+    Q_OBJECT
+public:
+    tst_QGLFunctions() {}
+    ~tst_QGLFunctions() {}
+
+private slots:
+    void features();
+    void multitexture();
+    void blendColor();
+
+private:
+    static bool hasExtension(const char *name);
+};
+
+bool tst_QGLFunctions::hasExtension(const char *name)
+{
+    QString extensions =
+        QString::fromLatin1
+            (reinterpret_cast<const char *>(glGetString(GL_EXTENSIONS)));
+    return extensions.split(QLatin1Char(' ')).contains
+        (QString::fromLatin1(name));
+}
+
+// Check that the reported features are consistent with the platform.
+void tst_QGLFunctions::features()
+{
+    // Before being associated with a context, there should be
+    // no features enabled.
+    QGLFunctions funcs;
+    QVERIFY(!funcs.openGLFeatures());
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::Multitexture));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::Shaders));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::Buffers));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::Framebuffers));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::BlendColor));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::BlendEquation));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::BlendEquationSeparate));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::BlendFuncSeparate));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::BlendSubtract));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::CompressedTextures));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::Multisample));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::StencilSeparate));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::NPOTTextures));
+
+    // Make a context current.
+    QGLWidget glw;
+    glw.makeCurrent();
+    funcs.initializeGLFunctions();
+
+    // Validate the features against what we expect for this platform.
+#if defined(QT_OPENGL_ES_2)
+    QGLFunctions::OpenGLFeatures allFeatures =
+        (QGLFunctions::Multitexture |
+         QGLFunctions::Shaders |
+         QGLFunctions::Buffers |
+         QGLFunctions::Framebuffers |
+         QGLFunctions::BlendColor |
+         QGLFunctions::BlendEquation |
+         QGLFunctions::BlendEquationSeparate |
+         QGLFunctions::BlendFuncSeparate |
+         QGLFunctions::BlendSubtract |
+         QGLFunctions::CompressedTextures |
+         QGLFunctions::Multisample |
+         QGLFunctions::StencilSeparate |
+         QGLFunctions::NPOTTextures);
+    QVERIFY((funcs.openGLFeatures() & allFeatures) == allFeatures);
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::Multitexture));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::Shaders));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::Buffers));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::Framebuffers));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::BlendColor));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::BlendEquation));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::BlendEquationSeparate));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::BlendFuncSeparate));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::BlendSubtract));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::CompressedTextures));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::Multisample));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::StencilSeparate));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::NPOTTextures));
+#elif defined(QT_OPENGL_ES)
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::Multitexture));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::Buffers));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::CompressedTextures));
+    QVERIFY(funcs.hasOpenGLFeature(QGLFunctions::Multisample));
+
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::Shaders));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::BlendColor));
+    QVERIFY(!funcs.hasOpenGLFeature(QGLFunctions::StencilSeparate));
+
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::Framebuffers),
+             hasExtension("GL_OES_framebuffer_object"));
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::BlendEquationSeparate),
+             hasExtension("GL_OES_blend_equation_separate"));
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::BlendFuncSeparate),
+             hasExtension("GL_OES_blend_func_separate"));
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::BlendSubtract),
+             hasExtension("GL_OES_blend_subtract"));
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::NPOTTextures),
+             hasExtension("GL_OES_texture_npot"));
+#else
+    // We check for both the extension name and the minimum OpenGL version
+    // for the feature.  This will help us catch situations where a platform
+    // doesn't list an extension by name but does have the feature by virtue
+    // of its version number.
+    QGLFormat::OpenGLVersionFlags versions = QGLFormat::openGLVersionFlags();
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::Multitexture),
+             hasExtension("GL_ARB_multitexture") ||
+             (versions & QGLFormat::OpenGL_Version_1_3) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::Shaders),
+             hasExtension("GL_ARB_shader_objects") ||
+             (versions & QGLFormat::OpenGL_Version_2_0) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::Buffers),
+             (versions & QGLFormat::OpenGL_Version_1_5) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::Framebuffers),
+             hasExtension("GL_EXT_framebuffer_object") ||
+             hasExtension("GL_ARB_framebuffer_object"));
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::BlendColor),
+             hasExtension("GL_EXT_blend_color") ||
+             (versions & QGLFormat::OpenGL_Version_1_2) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::BlendEquation),
+             (versions & QGLFormat::OpenGL_Version_1_2) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::BlendEquationSeparate),
+             hasExtension("GL_EXT_blend_equation_separate") ||
+             (versions & QGLFormat::OpenGL_Version_2_0) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::BlendFuncSeparate),
+             hasExtension("GL_EXT_blend_func_separate") ||
+             (versions & QGLFormat::OpenGL_Version_1_4) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::BlendSubtract),
+             hasExtension("GL_EXT_blend_subtract"));
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::CompressedTextures),
+             hasExtension("GL_ARB_texture_compression") ||
+             (versions & QGLFormat::OpenGL_Version_1_3) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::Multisample),
+             hasExtension("GL_ARB_multisample") ||
+             (versions & QGLFormat::OpenGL_Version_1_3) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::StencilSeparate),
+             (versions & QGLFormat::OpenGL_Version_2_0) != 0);
+    QCOMPARE(funcs.hasOpenGLFeature(QGLFunctions::NPOTTextures),
+             hasExtension("GL_ARB_texture_non_power_of_two") ||
+             (versions & QGLFormat::OpenGL_Version_2_0) != 0);
+#endif
+}
+
+// Verify that the multitexture functions appear to resolve and work.
+void tst_QGLFunctions::multitexture()
+{
+    QGLFunctions funcs;
+    QGLWidget glw;
+    glw.makeCurrent();
+    funcs.initializeGLFunctions();
+
+    if (!funcs.hasOpenGLFeature(QGLFunctions::Multitexture))
+        QSKIP("Multitexture functions are not supported", SkipSingle);
+
+    funcs.glActiveTexture(GL_TEXTURE1);
+
+    GLint active = 0;
+    glGetIntegerv(GL_ACTIVE_TEXTURE, &active);
+    QVERIFY(active == GL_TEXTURE1);
+
+    funcs.glActiveTexture(GL_TEXTURE0);
+
+    active = 0;
+    glGetIntegerv(GL_ACTIVE_TEXTURE, &active);
+    QVERIFY(active == GL_TEXTURE0);
+}
+
+// Verify that the glBlendColor() function appears to resolve and work.
+void tst_QGLFunctions::blendColor()
+{
+    QGLFunctions funcs;
+    QGLWidget glw;
+    glw.makeCurrent();
+    funcs.initializeGLFunctions();
+
+    if (!funcs.hasOpenGLFeature(QGLFunctions::BlendColor))
+        QSKIP("glBlendColor() is not supported", SkipSingle);
+
+    funcs.glBlendColor(0.0f, 1.0f, 0.0f, 1.0f);
+
+    GLfloat colors[4] = {0.5f, 0.5f, 0.5f, 0.5f};
+    glGetFloatv(GL_BLEND_COLOR, colors);
+
+    QCOMPARE(colors[0], 0.0f);
+    QCOMPARE(colors[1], 1.0f);
+    QCOMPARE(colors[2], 0.0f);
+    QCOMPARE(colors[3], 1.0f);
+}
+
+QTEST_MAIN(tst_QGLFunctions)
+
+#include "tst_qglfunctions.moc"