Skybox example

Demonstrate the use of a CubeMapTexture

Note: cubemap textures added to the example resources assets as webp

Change-Id: I68256c204c3ccde7a4cc744238135dbd9b317198
Reviewed-by: Sean Harmer <sean.harmer@kdab.com>

21 files changed, 341 insertions, 2 deletions

diff --git a/examples/exampleresources/assets/cubemaps/miramar/README.TXT b/examples/exampleresources/assets/cubemaps/miramar/README.TXT
new file mode 100644
index 000000000..680005eac
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/miramar/README.TXT
@@ -0,0 +1,15 @@
+THIS SKY WAS UPDATED AT THE 27TH
+THE ORIG HAD SOME ERRORS
+
+MIRAMAR
+high res 1024^2 environment map
+ships as TGA.
+
+
+By Jockum Skoglund aka hipshot
+hipshot@zfight.com
+www.zfight.com
+Stockholm, 2005 08 25
+
+
+Modify however you like, just cred me for my work, maybe link to my page.
diff --git a/examples/exampleresources/assets/cubemaps/miramar/miramar_negx.webp b/examples/exampleresources/assets/cubemaps/miramar/miramar_negx.webp
new file mode 100644
index 000000000..1ea719fb3
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/miramar/miramar_negx.webp
diff --git a/examples/exampleresources/assets/cubemaps/miramar/miramar_negy.webp b/examples/exampleresources/assets/cubemaps/miramar/miramar_negy.webp
new file mode 100644
index 000000000..5329f6ac9
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/miramar/miramar_negy.webp
diff --git a/examples/exampleresources/assets/cubemaps/miramar/miramar_negz.webp b/examples/exampleresources/assets/cubemaps/miramar/miramar_negz.webp
new file mode 100644
index 000000000..2bae54690
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/miramar/miramar_negz.webp
diff --git a/examples/exampleresources/assets/cubemaps/miramar/miramar_posx.webp b/examples/exampleresources/assets/cubemaps/miramar/miramar_posx.webp
new file mode 100644
index 000000000..ec33d1eb7
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/miramar/miramar_posx.webp
diff --git a/examples/exampleresources/assets/cubemaps/miramar/miramar_posy.webp b/examples/exampleresources/assets/cubemaps/miramar/miramar_posy.webp
new file mode 100644
index 000000000..6d36fcba5
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/miramar/miramar_posy.webp
diff --git a/examples/exampleresources/assets/cubemaps/miramar/miramar_posz.webp b/examples/exampleresources/assets/cubemaps/miramar/miramar_posz.webp
new file mode 100644
index 000000000..327041c71
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/miramar/miramar_posz.webp
diff --git a/examples/exampleresources/assets/cubemaps/night/night_negx.webp b/examples/exampleresources/assets/cubemaps/night/night_negx.webp
new file mode 100644
index 000000000..1c595caf3
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/night/night_negx.webp
diff --git a/examples/exampleresources/assets/cubemaps/night/night_negy.webp b/examples/exampleresources/assets/cubemaps/night/night_negy.webp
new file mode 100644
index 000000000..9a597d998
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/night/night_negy.webp
diff --git a/examples/exampleresources/assets/cubemaps/night/night_negz.webp b/examples/exampleresources/assets/cubemaps/night/night_negz.webp
new file mode 100644
index 000000000..a05772c23
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/night/night_negz.webp
diff --git a/examples/exampleresources/assets/cubemaps/night/night_posx.webp b/examples/exampleresources/assets/cubemaps/night/night_posx.webp
new file mode 100644
index 000000000..0b15aa6eb
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/night/night_posx.webp
diff --git a/examples/exampleresources/assets/cubemaps/night/night_posy.webp b/examples/exampleresources/assets/cubemaps/night/night_posy.webp
new file mode 100644
index 000000000..23cd803a9
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/night/night_posy.webp
diff --git a/examples/exampleresources/assets/cubemaps/night/night_posz.webp b/examples/exampleresources/assets/cubemaps/night/night_posz.webp
new file mode 100644
index 000000000..4899aa98e
--- /dev/null
+++ b/examples/exampleresources/assets/cubemaps/night/night_posz.webp
diff --git a/examples/exampleresources/example-assets.qrc b/examples/exampleresources/example-assets.qrc
index 9ae2b6d71..ccfac6563 100644
--- a/examples/exampleresources/example-assets.qrc
+++ b/examples/exampleresources/example-assets.qrc
@@ -85,5 +85,17 @@
         <file>assets/textures/pattern_09/specular.webp</file>
         <file>assets/textures/pattern_09/normal.webp</file>
         <file>assets/textures/pattern_09/diffuse.webp</file>
+        <file>assets/cubemaps/miramar/miramar_negx.webp</file>
+        <file>assets/cubemaps/miramar/miramar_negy.webp</file>
+        <file>assets/cubemaps/miramar/miramar_negz.webp</file>
+        <file>assets/cubemaps/miramar/miramar_posx.webp</file>
+        <file>assets/cubemaps/miramar/miramar_posy.webp</file>
+        <file>assets/cubemaps/miramar/miramar_posz.webp</file>
+        <file>assets/cubemaps/night/night_negx.webp</file>
+        <file>assets/cubemaps/night/night_negy.webp</file>
+        <file>assets/cubemaps/night/night_negz.webp</file>
+        <file>assets/cubemaps/night/night_posx.webp</file>
+        <file>assets/cubemaps/night/night_posy.webp</file>
+        <file>assets/cubemaps/night/night_posz.webp</file>
     </qresource>
 </RCC>
diff --git a/examples/exampleresources/exampleresources.pro b/examples/exampleresources/exampleresources.pro
index af2145c5f..9f3d394ef 100644
--- a/examples/exampleresources/exampleresources.pro
+++ b/examples/exampleresources/exampleresources.pro
@@ -31,4 +31,5 @@ OTHER_FILES += \
     assets/textures/pattern_09/* \
     assets/chest/* \
     assets/houseplants/* \
-    assets/metalbarrel/*
+    assets/metalbarrel/* \
+    assets/cubemaps/*
diff --git a/examples/examples.pro b/examples/examples.pro
index d321e4202..7f7e681bf 100644
--- a/examples/examples.pro
+++ b/examples/examples.pro
@@ -27,7 +27,8 @@ SUBDIRS += \
     materials-cpp \
     dynamicscene-cpp \
     scene3d \
-    enabled-qml
+    enabled-qml \
+    skybox
 
 # TODO Port the old examples to new APIs
 #SUBDIRS += qt3d
diff --git a/examples/skybox/Skybox.qml b/examples/skybox/Skybox.qml
new file mode 100644
index 000000000..504d3c347
--- /dev/null
+++ b/examples/skybox/Skybox.qml
@@ -0,0 +1,137 @@
+/****************************************************************************
+**
+** Copyright (C) 2015 Klaralvdalens Datakonsult AB (KDAB).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the Qt3D module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Digia.  For licensing terms and
+** conditions see http://qt.digia.com/licensing.  For further information
+** use the contact form at http://qt.digia.com/contact-us.
+**
+** 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, Digia gives you certain additional
+** rights.  These rights are described in the Digia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+import Qt3D 2.0
+import Qt3D.Render 2.0
+
+Entity {
+
+    property alias cameraPosition: cameraTranslate.translation;
+
+    property TextureCubeMap skyboxTexture: TextureCubeMap {
+        generateMipMaps: false
+        magnificationFilter: Texture.Linear
+        minificationFilter: Texture.Linear
+        wrapMode {
+            x: WrapMode.ClampToEdge
+            y: WrapMode.ClampToEdge
+            z: WrapMode.ClampToEdge
+        }
+        source: "qrc:/assets/cubemaps/miramar/miramar"
+    }
+
+    ShaderProgram {
+        id: gl3SkyboxShader
+
+        vertexShaderCode: "
+        #version 140
+
+        in vec3 vertexPosition;
+        out vec3 texCoord0;
+
+        uniform mat4 mvp;
+
+        void main()
+        {
+            texCoord0 = vertexPosition;
+            gl_Position = mvp * vec4(vertexPosition, 1.0);
+        }
+        "
+        fragmentShaderCode: "
+        #version 140
+
+        in vec3 texCoord0;
+        out vec4 fragColor;
+        uniform samplerCube skyboxTexture;
+
+        void main()
+        {
+            fragColor = texture(skyboxTexture, texCoord0);
+        }
+        "
+    }
+
+    CuboidMesh {
+        id: cuboidMesh
+        yzMeshResolution: Qt.size(2, 2)
+        xzMeshResolution: Qt.size(2, 2)
+        xyMeshResolution: Qt.size(2, 2)
+    }
+
+    Transform {
+        id: transform
+        Scale { id: scaleTransform; scale: 1000.0 }
+        Translate { id: cameraTranslate; }
+    }
+
+    Material {
+        id: skyboxMaterial
+
+        parameters: [
+            Parameter { name: "skyboxTexture"; value: skyboxTexture}
+        ]
+
+        effect: Effect {
+            techniques: [
+                // GL3 Technique
+                Technique {
+                    openGLFilter {
+                        api: OpenGLFilter.Desktop
+                        profile: OpenGLFilter.Core
+                        majorVersion: 3
+                        minorVersion: 1
+                    }
+                    renderPasses: RenderPass {
+                        shaderProgram: gl3SkyboxShader
+                        renderStates: [
+                            // cull front faces
+                            CullFace { mode: CullFace.Front },
+                            DepthTest { func: DepthTest.LessOrEqual }
+                        ]
+                    }
+                }
+            ]
+        }
+    }
+
+    components: [cuboidMesh, skyboxMaterial, transform]
+}
+
diff --git a/examples/skybox/main.cpp b/examples/skybox/main.cpp
new file mode 100644
index 000000000..04cc46389
--- /dev/null
+++ b/examples/skybox/main.cpp
@@ -0,0 +1,73 @@
+/****************************************************************************
+**
+** Copyright (C) 2015 Klaralvdalens Datakonsult AB (KDAB).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the Qt3D module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Digia.  For licensing terms and
+** conditions see http://qt.digia.com/licensing.  For further information
+** use the contact form at http://qt.digia.com/contact-us.
+**
+** 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, Digia gives you certain additional
+** rights.  These rights are described in the Digia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include <Qt3DCore/window.h>
+#include <Qt3DRenderer/QRenderAspect>
+#include <Qt3DInput/QInputAspect>
+#include <Qt3DQuick/QQmlAspectEngine>
+
+#include <exampleresources.h>
+
+#include <QGuiApplication>
+#include <QtQml>
+
+int main(int argc, char* argv[])
+{
+    QGuiApplication app(argc, argv);
+
+    initializeAssetResources("../exampleresources/example-assets.qrb");
+
+    Qt3D::Window view;
+    Qt3D::Quick::QQmlAspectEngine engine;
+
+    engine.aspectEngine()->registerAspect(new Qt3D::QRenderAspect());
+    engine.aspectEngine()->registerAspect(new Qt3D::QInputAspect());
+
+    QVariantMap data;
+    data.insert(QStringLiteral("surface"), QVariant::fromValue(static_cast<QSurface *>(&view)));
+    data.insert(QStringLiteral("eventSource"), QVariant::fromValue(&view));
+    engine.aspectEngine()->setData(data);
+    engine.aspectEngine()->initialize();
+
+    engine.setSource(QUrl("qrc:/main.qml"));
+    view.show();
+    return app.exec();
+}
diff --git a/examples/skybox/main.qml b/examples/skybox/main.qml
new file mode 100644
index 000000000..c8e0e2ded
--- /dev/null
+++ b/examples/skybox/main.qml
@@ -0,0 +1,83 @@
+/****************************************************************************
+**
+** Copyright (C) 2015 Klaralvdalens Datakonsult AB (KDAB).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the Qt3D module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Digia.  For licensing terms and
+** conditions see http://qt.digia.com/licensing.  For further information
+** use the contact form at http://qt.digia.com/contact-us.
+**
+** 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, Digia gives you certain additional
+** rights.  These rights are described in the Digia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+import Qt3D 2.0
+import Qt3D.Render 2.0
+
+Entity {
+   id: root
+
+   components: FrameGraph {
+       ForwardRenderer {
+           camera: basicCamera
+           clearColor: "black"
+       }
+   }
+
+   Camera {
+       id: basicCamera
+       projectionType: CameraLens.PerspectiveProjection
+       fieldOfView: 60
+       aspectRatio: 16/9
+       nearPlane:   0.01
+       farPlane:    1000.0
+       viewCenter: Qt.vector3d( 0.0, 0.0, 0.0 )
+       upVector:   Qt.vector3d( 0.0, 1.0, 0.0 )
+       position: Qt.vector3d( 0.0, 0.0, -40.0 )
+   }
+
+   // So that the camera is rendered always at the same position as the camera
+   Skybox {
+       cameraPosition: basicCamera.position
+   }
+
+   Configuration  {
+       controlledCamera: basicCamera
+   }
+
+   Entity {
+       components: [
+           SphereMesh { radius: 5 },
+           PhongMaterial { diffuse: "dodgerblue" }
+       ]
+   }
+}
+
diff --git a/examples/skybox/skybox.pro b/examples/skybox/skybox.pro
new file mode 100644
index 000000000..c58d7f90e
--- /dev/null
+++ b/examples/skybox/skybox.pro
@@ -0,0 +1,11 @@
+TEMPLATE = app
+
+QT += 3dcore 3drenderer 3dinput 3dquick qml quick
+
+include("../exampleresources/exampleresources.pri")
+
+RESOURCES += \
+    skybox.qrc
+
+SOURCES += \
+    main.cpp
diff --git a/examples/skybox/skybox.qrc b/examples/skybox/skybox.qrc
new file mode 100644
index 000000000..927dfb169
--- /dev/null
+++ b/examples/skybox/skybox.qrc
@@ -0,0 +1,6 @@
+<RCC>
+    <qresource prefix="/">
+        <file>main.qml</file>
+        <file>Skybox.qml</file>
+    </qresource>
+</RCC>