1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
/****************************************************************************
**
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the QtQuick3D module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** GNU Lesser General Public License Usage
** 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.
**
** 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.
**
** Other Usage
** Alternatively, this file may be used in accordance with the terms and
** conditions contained in a signed written agreement between you and Nokia.
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef QGLCAMERA_H
#define QGLCAMERA_H
#include "qt3dglobal.h"
#include "qglnamespace.h"
#include <QtCore/qobject.h>
#include <QtCore/qsize.h>
#include <QtGui/qvector3d.h>
#include <QtGui/qmatrix4x4.h>
#include <QtGui/qquaternion.h>
QT_BEGIN_HEADER
QT_BEGIN_NAMESPACE
QT_MODULE(Qt3D)
class QGLCameraPrivate;
class QGLPainter;
class Q_QT3D_EXPORT QGLCamera : public QObject
{
Q_OBJECT
Q_ENUMS(ProjectionType RotateOrder)
Q_PROPERTY(ProjectionType projectionType READ projectionType WRITE setProjectionType NOTIFY projectionChanged)
Q_PROPERTY(qreal fieldOfView READ fieldOfView WRITE setFieldOfView NOTIFY projectionChanged)
Q_PROPERTY(qreal nearPlane READ nearPlane WRITE setNearPlane NOTIFY projectionChanged)
Q_PROPERTY(qreal farPlane READ farPlane WRITE setFarPlane NOTIFY projectionChanged)
Q_PROPERTY(QSizeF viewSize READ viewSize WRITE setViewSize NOTIFY projectionChanged)
Q_PROPERTY(QSizeF minViewSize READ minViewSize WRITE setMinViewSize NOTIFY projectionChanged SCRIPTABLE false)
Q_PROPERTY(int screenRotation READ screenRotation WRITE setScreenRotation NOTIFY projectionChanged SCRIPTABLE false)
Q_PROPERTY(QVector3D eye READ eye WRITE setEye NOTIFY viewChanged)
Q_PROPERTY(QVector3D upVector READ upVector WRITE setUpVector NOTIFY viewChanged)
Q_PROPERTY(QVector3D center READ center WRITE setCenter NOTIFY viewChanged)
Q_PROPERTY(qreal eyeSeparation READ eyeSeparation WRITE setEyeSeparation NOTIFY viewChanged)
Q_PROPERTY(QVector3D motionAdjustment READ motionAdjustment WRITE setMotionAdjustment DESIGNABLE false NOTIFY viewChanged SCRIPTABLE false)
Q_PROPERTY(bool adjustForAspectRatio READ adjustForAspectRatio WRITE setAdjustForAspectRatio NOTIFY viewChanged)
public:
explicit QGLCamera(QObject *parent = 0);
~QGLCamera();
enum ProjectionType
{
Perspective,
Orthographic
};
QGLCamera::ProjectionType projectionType() const;
void setProjectionType(QGLCamera::ProjectionType value);
qreal fieldOfView() const;
void setFieldOfView(qreal angle);
qreal nearPlane() const;
void setNearPlane(qreal value);
qreal farPlane() const;
void setFarPlane(qreal value);
QSizeF viewSize() const;
void setViewSize(const QSizeF& size);
QSizeF minViewSize() const;
void setMinViewSize(const QSizeF& size);
int screenRotation() const;
void setScreenRotation(int angle);
QVector3D eye() const;
void setEye(const QVector3D& vertex);
QVector3D upVector() const;
void setUpVector(const QVector3D& vector);
QVector3D center() const;
void setCenter(const QVector3D& vertex);
qreal eyeSeparation() const;
void setEyeSeparation(qreal value);
QVector3D motionAdjustment() const;
void setMotionAdjustment(const QVector3D& vector);
bool adjustForAspectRatio() const;
void setAdjustForAspectRatio(bool value);
QQuaternion tilt(qreal angle) const;
QQuaternion pan(qreal angle) const;
QQuaternion roll(qreal angle) const;
void rotateEye(const QQuaternion& q);
void rotateCenter(const QQuaternion& q);
QVector3D translation(qreal x, qreal y, qreal z) const;
QMatrix4x4 projectionMatrix(qreal aspectRatio) const;
QMatrix4x4 modelViewMatrix(QGL::Eye eye = QGL::NoEye) const;
QVector3D mapPoint
(const QPoint& point, qreal aspectRatio,
const QSize& viewportSize) const;
enum RotateOrder
{
TiltPanRoll,
TiltRollPan,
PanTiltRoll,
PanRollTilt,
RollTiltPan,
RollPanTilt
};
public Q_SLOTS:
void translateEye(qreal x, qreal y, qreal z);
void translateCenter(qreal x, qreal y, qreal z);
void tiltPanRollCenter(qreal tiltAngle, qreal panAngle, qreal rollAngle,
QGLCamera::RotateOrder order = TiltPanRoll);
void tiltPanRollEye(qreal tiltAngle, qreal panAngle, qreal rollAngle,
QGLCamera::RotateOrder order = TiltPanRoll);
Q_SIGNALS:
void projectionChanged();
void viewChanged();
private:
QGLCameraPrivate *d_ptr;
QGLCameraPrivate *d_func() const { return d_ptr; }
Q_DISABLE_COPY(QGLCamera)
};
#ifndef QT_NO_DEBUG_STREAM
#include <QtCore/qdebug.h>
Q_QT3D_EXPORT QDebug operator<<(QDebug dbg, const QGLCamera &order);
#endif
QT_END_NAMESPACE
QT_END_HEADER
#endif
|
