Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qquick3dnode_p.h
Go to the documentation of this file.
1// Copyright (C) 2019 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
3
4#ifndef QSSGNODE_H
5#define QSSGNODE_H
6
7//
8// W A R N I N G
9// -------------
10//
11// This file is not part of the Qt API. It exists purely as an
12// implementation detail. This header file may change from version to
13// version without notice, or even be removed.
14//
15// We mean it.
16//
17
18#include <QtQuick3D/qquick3dobject.h>
19
20#include <QtGui/QVector3D>
21#include <QtGui/QQuaternion>
22#include <QtGui/QMatrix4x4>
23
24QT_BEGIN_NAMESPACE
25struct QSSGRenderNode;
26class QQuick3DNodePrivate;
27class Q_QUICK3D_EXPORT QQuick3DNode : public QQuick3DObject
28{
29 Q_OBJECT
30 Q_PROPERTY(float x READ x WRITE setX NOTIFY xChanged)
31 Q_PROPERTY(float y READ y WRITE setY NOTIFY yChanged)
32 Q_PROPERTY(float z READ z WRITE setZ NOTIFY zChanged)
33 Q_PROPERTY(QQuaternion rotation READ rotation WRITE setRotation NOTIFY rotationChanged)
34 Q_PROPERTY(QVector3D eulerRotation READ eulerRotation WRITE setEulerRotation NOTIFY eulerRotationChanged)
35 Q_PROPERTY(QVector3D position READ position WRITE setPosition NOTIFY positionChanged)
36 Q_PROPERTY(QVector3D scale READ scale WRITE setScale NOTIFY scaleChanged)
37 Q_PROPERTY(QVector3D pivot READ pivot WRITE setPivot NOTIFY pivotChanged)
38 Q_PROPERTY(float opacity READ localOpacity WRITE setLocalOpacity NOTIFY localOpacityChanged)
39 Q_PROPERTY(bool visible READ visible WRITE setVisible NOTIFY visibleChanged)
40 Q_PROPERTY(QVector3D forward READ forward NOTIFY forwardChanged)
41 Q_PROPERTY(QVector3D up READ up NOTIFY upChanged)
42 Q_PROPERTY(QVector3D right READ right NOTIFY rightChanged)
43 Q_PROPERTY(QVector3D scenePosition READ scenePosition NOTIFY scenePositionChanged)
44 Q_PROPERTY(QQuaternion sceneRotation READ sceneRotation NOTIFY sceneRotationChanged)
45 Q_PROPERTY(QVector3D sceneScale READ sceneScale NOTIFY sceneScaleChanged)
46 Q_PROPERTY(QMatrix4x4 sceneTransform READ sceneTransform NOTIFY sceneTransformChanged)
47 Q_PROPERTY(int staticFlags READ staticFlags WRITE setStaticFlags NOTIFY staticFlagsChanged)
48 Q_PROPERTY(int layers READ layers WRITE setLayers NOTIFY layersChanged REVISION(6, 11))
49
50 QML_NAMED_ELEMENT(Node)
51
52public:
53 enum TransformSpace {
54 LocalSpace,
55 ParentSpace,
56 SceneSpace
57 };
58 Q_ENUM(TransformSpace)
59
60 enum StaticFlags {
61 None
62 };
63 Q_ENUM(StaticFlags)
64
65 explicit QQuick3DNode(QQuick3DNode *parent = nullptr);
66 ~QQuick3DNode() override;
67
68 float x() const;
69 float y() const;
70 float z() const;
71 QQuaternion rotation() const;
72 QVector3D eulerRotation() const;
73 QVector3D position() const;
74 QVector3D scale() const;
75 QVector3D pivot() const;
76 float localOpacity() const;
77 bool visible() const;
78 int staticFlags() const;
79
80 QQuick3DNode *parentNode() const;
81
82 QVector3D forward() const;
83 QVector3D up() const;
84 QVector3D right() const;
85
86 QVector3D scenePosition() const;
87 QQuaternion sceneRotation() const;
88 QVector3D sceneScale() const;
89 QMatrix4x4 sceneTransform() const;
90
91 Q_INVOKABLE void rotate(qreal degrees, const QVector3D &axis, QQuick3DNode::TransformSpace space);
92
93 Q_INVOKABLE QVector3D mapPositionToScene(const QVector3D &localPosition) const;
94 Q_INVOKABLE QVector3D mapPositionFromScene(const QVector3D &scenePosition) const;
95 Q_INVOKABLE QVector3D mapPositionToNode(const QQuick3DNode *node, const QVector3D &localPosition) const;
96 Q_INVOKABLE QVector3D mapPositionFromNode(const QQuick3DNode *node, const QVector3D &localPosition) const;
97 Q_INVOKABLE QVector3D mapDirectionToScene(const QVector3D &localDirection) const;
98 Q_INVOKABLE QVector3D mapDirectionFromScene(const QVector3D &sceneDirection) const;
99 Q_INVOKABLE QVector3D mapDirectionToNode(const QQuick3DNode *node, const QVector3D &localDirection) const;
100 Q_INVOKABLE QVector3D mapDirectionFromNode(const QQuick3DNode *node, const QVector3D &localDirection) const;
101
102 void markAllDirty() override;
103
104 int layers() const;
105
106protected:
107 void connectNotify(const QMetaMethod &signal) override;
108 void disconnectNotify(const QMetaMethod &signal) override;
109 void componentComplete() override;
110
111public Q_SLOTS:
112 void setX(float x);
113 void setY(float y);
114 void setZ(float z);
115 void setRotation(const QQuaternion &rotation);
116 void setEulerRotation(const QVector3D &eulerRotation);
117 void setPosition(const QVector3D &position);
118 void setScale(const QVector3D &scale);
119 void setPivot(const QVector3D &pivot);
120 void setLocalOpacity(float opacity);
121 void setVisible(bool visible);
122 void setStaticFlags(int staticFlags);
123 void setLayers(int newLayers);
124
125Q_SIGNALS:
126 void xChanged();
127 void yChanged();
128 void zChanged();
129 void rotationChanged();
130 void eulerRotationChanged();
131 void positionChanged();
132 void scaleChanged();
133 void pivotChanged();
134 void localOpacityChanged();
135 void visibleChanged();
136 void forwardChanged();
137 void upChanged();
138 void rightChanged();
139 void sceneTransformChanged();
140 void scenePositionChanged();
141 void sceneRotationChanged();
142 void sceneScaleChanged();
143 void staticFlagsChanged();
144
145 void layersChanged();
146
147protected:
148 QQuick3DNode(QQuick3DNodePrivate &dd, QQuick3DNode *parent = nullptr);
149 QSSGRenderGraphObject *updateSpatialNode(QSSGRenderGraphObject *node) override;
150 virtual void itemChange(ItemChange, const ItemChangeData &) override;
151
152private:
153 friend QQuick3DSceneManager;
154 Q_DISABLE_COPY(QQuick3DNode)
155 Q_DECLARE_PRIVATE(QQuick3DNode)
156};
157
158QT_END_NAMESPACE
159
160QML_DECLARE_TYPE(QQuick3DNode)
161
162#endif // QSSGNODE_H
QQuick3DObject
\qmltype Object3D \inqmlmodule QtQuick3D \nativetype QQuick3DObject \inherits QtObject
Definition qquick3dobject.h:22
QSSGCleanupObject::cleanupResources
Q_INVOKABLE void cleanupResources()
Definition qquick3dscenemanager.cpp:48
QSSGRenderer::QSSGRenderContextInterface
friend class QSSGRenderContextInterface
Definition qssgrenderer_p.h:101
Q_DECLARE_TYPEINFO
Q_DECLARE_TYPEINFO(QObjectPrivate::ConnectionList, Q_RELOCATABLE_TYPE)
qHash
constexpr size_t qHash(const QSize &s, size_t seed=0) noexcept
Definition qsize.h:191