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