summaryrefslogtreecommitdiffstats
path: root/src/render/frontend/qcamera.h
diff options
context:
space:
mode:
authorPaul Lemire <paul.lemire@kdab.com>2016-01-15 15:09:44 +0100
committerSean Harmer <sean.harmer@kdab.com>2016-01-16 17:17:49 +0000
commitb0404a42ced2ea5a583e1c6ddc22940ffdc1e48e (patch)
treeb073c3c680e388bda00228b204743b092b11de6a /src/render/frontend/qcamera.h
parent8656b95ffb67efe7dd1cc3a65b12d277e83e1d22 (diff)
Move QCamera/QCameraLens to Qt3DRender
Also get rid of Qt3DRender::QWindow and of the hard codes camera controller. Change-Id: I307735d01caf97b7a690b28de8dc99fc9866c35f Reviewed-by: Sean Harmer <sean.harmer@kdab.com>
Diffstat (limited to 'src/render/frontend/qcamera.h')
-rw-r--r--src/render/frontend/qcamera.h173
1 files changed, 173 insertions, 0 deletions
diff --git a/src/render/frontend/qcamera.h b/src/render/frontend/qcamera.h
new file mode 100644
index 000000000..737b7415a
--- /dev/null
+++ b/src/render/frontend/qcamera.h
@@ -0,0 +1,173 @@
+/****************************************************************************
+**
+** Copyright (C) 2014 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:LGPL3$
+** 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 The Qt Company. For licensing terms
+** and conditions see http://www.qt.io/terms-conditions. For further
+** information use the contact form at http://www.qt.io/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 3 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPLv3 included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU Lesser General Public License version 3 requirements
+** will be met: https://www.gnu.org/licenses/lgpl.html.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 2.0 or later 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 2.0 requirements will be
+** met: http://www.gnu.org/licenses/gpl-2.0.html.
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#ifndef QT3DRENDER_CAMERA_H
+#define QT3DRENDER_CAMERA_H
+
+#include <Qt3DCore/qentity.h>
+#include <Qt3DRender/qt3drender_global.h>
+#include <Qt3DRender/qcameralens.h>
+#include <QMatrix4x4>
+#include <QQuaternion>
+#include <QVector3D>
+
+QT_BEGIN_NAMESPACE
+
+namespace Qt3DCore {
+class QEntity;
+class QTransform;
+}
+
+namespace Qt3DRender {
+
+class QCameraPrivate;
+
+class QT3DRENDERSHARED_EXPORT QCamera : public Qt3DCore::QEntity
+{
+ Q_OBJECT
+ // CameraLens
+ Q_PROPERTY(Qt3DRender::QCameraLens::ProjectionType projectionType READ projectionType WRITE setProjectionType NOTIFY projectionTypeChanged)
+ Q_PROPERTY(float nearPlane READ nearPlane WRITE setNearPlane NOTIFY nearPlaneChanged)
+ Q_PROPERTY(float farPlane READ farPlane WRITE setFarPlane NOTIFY farPlaneChanged)
+ Q_PROPERTY(float fieldOfView READ fieldOfView WRITE setFieldOfView NOTIFY fieldOfViewChanged)
+ Q_PROPERTY(float aspectRatio READ aspectRatio WRITE setAspectRatio NOTIFY aspectRatioChanged)
+ Q_PROPERTY(float left READ left WRITE setLeft NOTIFY leftChanged)
+ Q_PROPERTY(float right READ right WRITE setRight NOTIFY rightChanged)
+ Q_PROPERTY(float bottom READ bottom WRITE setBottom NOTIFY bottomChanged)
+ Q_PROPERTY(float top READ top WRITE setTop NOTIFY topChanged)
+ Q_PROPERTY(QMatrix4x4 projectionMatrix READ projectionMatrix NOTIFY projectionMatrixChanged)
+ // LookAt
+ Q_PROPERTY(QVector3D position READ position WRITE setPosition NOTIFY positionChanged)
+ Q_PROPERTY(QVector3D upVector READ upVector WRITE setUpVector NOTIFY upVectorChanged)
+ Q_PROPERTY(QVector3D viewCenter READ viewCenter WRITE setViewCenter NOTIFY viewCenterChanged)
+ Q_PROPERTY(QVector3D viewVector READ viewVector NOTIFY viewVectorChanged)
+ Q_PROPERTY(QMatrix4x4 viewMatrix READ viewMatrix NOTIFY viewMatrixChanged)
+
+public:
+ explicit QCamera(QNode *parent = 0);
+ ~QCamera();
+
+ enum CameraTranslationOption {
+ TranslateViewCenter,
+ DontTranslateViewCenter
+ };
+ Q_ENUM(CameraTranslationOption)
+
+ QCameraLens *lens() const;
+ Qt3DCore::QTransform *transform() const;
+
+ QQuaternion tiltRotation(float angle) const;
+ QQuaternion panRotation(float angle) const;
+ QQuaternion rollRotation(float angle) const;
+ QQuaternion rotation(float angle, const QVector3D &axis) const;
+
+ // Translate relative to camera orientation axes
+ Q_INVOKABLE void translate(const QVector3D& vLocal, CameraTranslationOption option = TranslateViewCenter);
+
+ // Translate relative to world axes
+ Q_INVOKABLE void translateWorld(const QVector3D& vWorld, CameraTranslationOption option = TranslateViewCenter);
+
+ Q_INVOKABLE void tilt(float angle);
+ Q_INVOKABLE void pan(float angle);
+ Q_INVOKABLE void pan(float angle, const QVector3D &axis);
+ Q_INVOKABLE void roll(float angle);
+
+ Q_INVOKABLE void tiltAboutViewCenter(float angle);
+ Q_INVOKABLE void panAboutViewCenter(float angle);
+ Q_INVOKABLE void panAboutViewCenter(float angle, const QVector3D &axis);
+ Q_INVOKABLE void rollAboutViewCenter(float angle);
+
+ Q_INVOKABLE void rotate(const QQuaternion& q);
+ Q_INVOKABLE void rotateAboutViewCenter(const QQuaternion& q);
+
+ QCameraLens::ProjectionType projectionType() const;
+ float nearPlane() const;
+ float farPlane() const;
+ float fieldOfView() const;
+ float aspectRatio() const;
+ float left() const;
+ float right() const;
+ float bottom() const;
+ float top() const;
+ QMatrix4x4 projectionMatrix() const;
+ QVector3D position() const;
+ QVector3D upVector() const;
+ QVector3D viewCenter() const;
+ QVector3D viewVector() const;
+ QMatrix4x4 viewMatrix() const;
+
+public Q_SLOTS:
+ void setProjectionType(QCameraLens::ProjectionType type);
+ void setNearPlane(float nearPlane);
+ void setFarPlane(float farPlane);
+ void setFieldOfView(float fieldOfView);
+ void setAspectRatio(float aspectRatio);
+ void setLeft(float left);
+ void setRight(float right);
+ void setBottom(float bottom);
+ void setTop(float top);
+ void setPosition(const QVector3D &position);
+ void setUpVector(const QVector3D &upVector);
+ void setViewCenter(const QVector3D &viewCenter);
+
+Q_SIGNALS:
+ void projectionTypeChanged(QCameraLens::ProjectionType projectionType);
+ void nearPlaneChanged(float nearPlane);
+ void farPlaneChanged(float farPlane);
+ void fieldOfViewChanged(float fieldOfView);
+ void aspectRatioChanged(float aspectRatio);
+ void leftChanged(float left);
+ void rightChanged(float right);
+ void bottomChanged(float bottom);
+ void topChanged(float top);
+ void projectionMatrixChanged(const QMatrix4x4 &projectionMatrix);
+ void positionChanged(const QVector3D &position);
+ void upVectorChanged(const QVector3D &upVector);
+ void viewCenterChanged(const QVector3D &viewCenter);
+ void viewVectorChanged(const QVector3D &viewVector);
+ void viewMatrixChanged(const QMatrix4x4 &viewMatrix);
+
+protected:
+ Q_DECLARE_PRIVATE(QCamera)
+ QT3D_CLONEABLE(QCamera)
+ QCamera(QCameraPrivate &dd, QNode *parent = 0);
+};
+
+} // namespace Qt3DRender
+
+QT_END_NAMESPACE
+
+#endif // QT3DRENDER_CAMERA_H