![]() |
Qt 6.x
The Qt SDK
|
#include <qquick3dcamera_p.h>
Public Slots | |
void | setFrustumCullingEnabled (bool frustumCullingEnabled) |
void | setLookAtNode (QQuick3DNode *node) |
Q_REVISION (6, 5) void setLevelOfDetailBias(float new LevelOFDetailBias) | |
![]() | |
void | setX (float x) |
void | setY (float y) |
void | setZ (float z) |
void | setRotation (const QQuaternion &rotation) |
void | setEulerRotation (const QVector3D &eulerRotation) |
void | setPosition (const QVector3D &position) |
void | setScale (const QVector3D &scale) |
void | setPivot (const QVector3D &pivot) |
void | setLocalOpacity (float opacity) |
void | setVisible (bool visible) |
void | setStaticFlags (int staticFlags) |
![]() | |
void | update () |
void | setParentItem (QQuick3DObject *parentItem) |
![]() | |
void | deleteLater () |
\threadsafe | |
Public Member Functions | |
Q_INVOKABLE QVector3D | mapToViewport (const QVector3D &scenePos) const |
\qmlmethod vector3d Camera::mapToViewport(vector3d scenePos) | |
Q_INVOKABLE QVector3D | mapFromViewport (const QVector3D &viewportPos) const |
\qmlmethod vector3d Camera::mapFromViewport(vector3d viewportPos) | |
QVector3D | mapToViewport (const QVector3D &scenePos, qreal width, qreal height) |
QVector3D | mapFromViewport (const QVector3D &viewportPos, qreal width, qreal height) |
Q_INVOKABLE void | lookAt (const QVector3D &scenePos) |
\qmlmethod vector3d Camera::lookAt(vector3d scenePos) | |
Q_INVOKABLE void | lookAt (QQuick3DNode *node) |
\qmlmethod vector3d Camera::lookAt(QtQuick3D::Node node) | |
void | updateGlobalVariables (const QRectF &inViewport) |
bool | frustumCullingEnabled () const |
\qmlproperty bool Camera::frustumCullingEnabled | |
QQuick3DNode * | lookAtNode () const |
\qmlproperty Node Camera::lookAtNode | |
Q_REVISION (6, 5) float levelOfDetailBias() const | |
![]() | |
QQuick3DNode (QQuick3DNode *parent=nullptr) | |
\qmltype Node \inherits Object3D \inqmlmodule QtQuick3D | |
~QQuick3DNode () override | |
float | x () const |
\qmlproperty real QtQuick3D::Node::x | |
float | y () const |
\qmlproperty real QtQuick3D::Node::y | |
float | z () const |
\qmlproperty real QtQuick3D::Node::z | |
QQuaternion | rotation () const |
\qmlproperty quaternion QtQuick3D::Node::rotation | |
QVector3D | eulerRotation () const |
\qmlproperty vector3d QtQuick3D::Node::eulerRotation | |
QVector3D | position () const |
\qmlproperty vector3d QtQuick3D::Node::position | |
QVector3D | scale () const |
\qmlproperty vector3d QtQuick3D::Node::scale | |
QVector3D | pivot () const |
\qmlproperty vector3d QtQuick3D::Node::pivot | |
float | localOpacity () const |
\qmlproperty real QtQuick3D::Node::opacity | |
bool | visible () const |
\qmlproperty bool QtQuick3D::Node::visible | |
int | staticFlags () const |
\qmlproperty int QtQuick3D::Node::staticFlags | |
QQuick3DNode * | parentNode () const |
QVector3D | forward () const |
\qmlproperty vector3d QtQuick3D::Node::forward \readonly | |
QVector3D | up () const |
\qmlproperty vector3d QtQuick3D::Node::up \readonly | |
QVector3D | right () const |
\qmlproperty vector3d QtQuick3D::Node::right \readonly | |
QVector3D | scenePosition () const |
\qmlproperty vector3d QtQuick3D::Node::scenePosition \readonly | |
QQuaternion | sceneRotation () const |
\qmlproperty quaternion QtQuick3D::Node::sceneRotation \readonly | |
QVector3D | sceneScale () const |
\qmlproperty vector3d QtQuick3D::Node::sceneScale \readonly | |
QMatrix4x4 | sceneTransform () const |
\qmlproperty matrix4x4 QtQuick3D::Node::sceneTransform \readonly | |
Q_INVOKABLE void | rotate (qreal degrees, const QVector3D &axis, QQuick3DNode::TransformSpace space) |
\qmlmethod QtQuick3D::Node::rotate(real degrees, vector3d axis, enumeration space) | |
Q_INVOKABLE QVector3D | mapPositionToScene (const QVector3D &localPosition) const |
\qmlmethod vector3d QtQuick3D::Node::mapPositionToScene(vector3d localPosition) | |
Q_INVOKABLE QVector3D | mapPositionFromScene (const QVector3D &scenePosition) const |
\qmlmethod vector3d QtQuick3D::Node::mapPositionFromScene(vector3d scenePosition) | |
Q_INVOKABLE QVector3D | mapPositionToNode (const QQuick3DNode *node, const QVector3D &localPosition) const |
\qmlmethod vector3d QtQuick3D::Node::mapPositionToNode(QtQuick3D::Node node, vector3d localPosition) | |
Q_INVOKABLE QVector3D | mapPositionFromNode (const QQuick3DNode *node, const QVector3D &localPosition) const |
\qmlmethod vector3d QtQuick3D::Node::mapPositionFromNode(QtQuick3D::Node node, vector3d localPosition) | |
Q_INVOKABLE QVector3D | mapDirectionToScene (const QVector3D &localDirection) const |
\qmlmethod vector3d QtQuick3D::Node::mapDirectionToScene(vector3d localDirection) | |
Q_INVOKABLE QVector3D | mapDirectionFromScene (const QVector3D &sceneDirection) const |
\qmlmethod vector3d QtQuick3D::Node::mapDirectionFromScene(vector3d sceneDirection) | |
Q_INVOKABLE QVector3D | mapDirectionToNode (const QQuick3DNode *node, const QVector3D &localDirection) const |
\qmlmethod vector3d QtQuick3D::Node::mapDirectionToNode(QtQuick3D::Node node, vector3d localDirection) | |
Q_INVOKABLE QVector3D | mapDirectionFromNode (const QQuick3DNode *node, const QVector3D &localDirection) const |
\qmlmethod vector3d QtQuick3D::Node::mapDirectionFromNode(QtQuick3D::Node node, vector3d localDirection) | |
void | markAllDirty () override |
![]() | |
Q_INVOKABLE | QObject (QObject *parent=nullptr) |
Constructs an object with parent object parent. | |
virtual | ~QObject () |
Destroys the object, deleting all its child objects. | |
virtual bool | event (QEvent *event) |
This virtual function receives events to an object and should return true if the event e was recognized and processed. | |
virtual bool | eventFilter (QObject *watched, QEvent *event) |
Filters events if this object has been installed as an event filter for the watched object. | |
QString | objectName () const |
Q_WEAK_OVERLOAD void | setObjectName (const QString &name) |
Sets the object's name to name. | |
void | setObjectName (QAnyStringView name) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
QBindable< QString > | bindableObjectName () |
bool | isWidgetType () const |
Returns true if the object is a widget; otherwise returns false . | |
bool | isWindowType () const |
Returns true if the object is a window; otherwise returns false . | |
bool | isQuickItemType () const |
Returns true if the object is a QQuickItem; otherwise returns false . | |
bool | signalsBlocked () const noexcept |
Returns true if signals are blocked; otherwise returns false . | |
bool | blockSignals (bool b) noexcept |
If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). | |
QThread * | thread () const |
Returns the thread in which the object lives. | |
void | moveToThread (QThread *thread) |
Changes the thread affinity for this object and its children. | |
int | startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer) |
This is an overloaded function that will start a timer of type timerType and a timeout of interval milliseconds. | |
int | startTimer (std::chrono::milliseconds time, Qt::TimerType timerType=Qt::CoarseTimer) |
void | killTimer (int id) |
Kills the timer with timer identifier, id. | |
template<typename T > | |
T | findChild (const QString &aName=QString(), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
Returns the child of this object that can be cast into type T and that is called name, or \nullptr if there is no such object. | |
template<typename T > | |
QList< T > | findChildren (const QString &aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. | |
template<typename T > | |
QList< T > | findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. | |
const QObjectList & | children () const |
Returns a list of child objects. | |
void | setParent (QObject *parent) |
Makes the object a child of parent. | |
void | installEventFilter (QObject *filterObj) |
Installs an event filter filterObj on this object. | |
void | removeEventFilter (QObject *obj) |
Removes an event filter object obj from this object. | |
QMetaObject::Connection | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
bool | disconnect (const char *signal=nullptr, const QObject *receiver=nullptr, const char *member=nullptr) const |
bool | disconnect (const QObject *receiver, const char *member=nullptr) const |
void | dumpObjectTree () const |
Dumps a tree of children to the debug output. | |
void | dumpObjectInfo () const |
Dumps information about signal connections, etc. | |
bool | setProperty (const char *name, const QVariant &value) |
Sets the value of the object's name property to value. | |
bool | setProperty (const char *name, QVariant &&value) |
QVariant | property (const char *name) const |
Returns the value of the object's name property. | |
QList< QByteArray > | dynamicPropertyNames () const |
QBindingStorage * | bindingStorage () |
const QBindingStorage * | bindingStorage () const |
QObject * | parent () const |
Returns a pointer to the parent object. | |
bool | inherits (const char *classname) const |
Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false . | |
![]() | |
QQmlParserStatus () | |
virtual | ~QQmlParserStatus () |
virtual void | classBegin ()=0 |
Invoked after class creation, but before any properties have been set. | |
virtual void | componentComplete ()=0 |
Invoked after the root component that caused this instantiation has completed construction. | |
Protected Member Functions | |
QQuick3DCamera (QQuick3DNodePrivate &dd, QQuick3DNode *parent=nullptr) | |
\qmltype Camera \inherits Node \inqmlmodule QtQuick3D | |
QSSGRenderGraphObject * | updateSpatialNode (QSSGRenderGraphObject *node) override |
![]() | |
void | connectNotify (const QMetaMethod &signal) override |
void | disconnectNotify (const QMetaMethod &signal) override |
void | componentComplete () override |
Invoked after the root component that caused this instantiation has completed construction. | |
QQuick3DNode (QQuick3DNodePrivate &dd, QQuick3DNode *parent=nullptr) | |
QSSGRenderGraphObject * | updateSpatialNode (QSSGRenderGraphObject *node) override |
virtual void | itemChange (ItemChange, const ItemChangeData &) override |
![]() | |
virtual QSSGRenderGraphObject * | updateSpatialNode (QSSGRenderGraphObject *node) |
virtual void | markAllDirty () |
virtual void | itemChange (ItemChange, const ItemChangeData &) |
QQuick3DObject (QQuick3DObjectPrivate &dd, QQuick3DObject *parent=nullptr) | |
void | classBegin () override |
Invoked after class creation, but before any properties have been set. | |
void | componentComplete () override |
Invoked after the root component that caused this instantiation has completed construction. | |
bool | isComponentComplete () const |
virtual void | preSync () |
![]() | |
QObject * | sender () const |
Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns \nullptr. | |
int | senderSignalIndex () const |
int | receivers (const char *signal) const |
Returns the number of receivers connected to the signal. | |
bool | isSignalConnected (const QMetaMethod &signal) const |
virtual void | timerEvent (QTimerEvent *event) |
This event handler can be reimplemented in a subclass to receive timer events for the object. | |
virtual void | childEvent (QChildEvent *event) |
This event handler can be reimplemented in a subclass to receive child events. | |
virtual void | customEvent (QEvent *event) |
This event handler can be reimplemented in a subclass to receive custom events. | |
virtual void | connectNotify (const QMetaMethod &signal) |
virtual void | disconnectNotify (const QMetaMethod &signal) |
QObject (QObjectPrivate &dd, QObject *parent=nullptr) | |
Properties | |
bool | frustumCullingEnabled |
QQuick3DNode * | lookAtNode |
float | levelOfDetailBias |
\qmlproperty float Camera::levelOfDetailBias | |
![]() | |
float | x |
float | y |
float | z |
QQuaternion | rotation |
QVector3D | eulerRotation |
QVector3D | position |
QVector3D | scale |
QVector3D | pivot |
float | opacity |
bool | visible |
QVector3D | forward |
QVector3D | up |
QVector3D | right |
QVector3D | scenePosition |
QQuaternion | sceneRotation |
QVector3D | sceneScale |
QMatrix4x4 | sceneTransform |
int | staticFlags |
![]() | |
QQuick3DObject * | parent |
\qmlproperty Object3D QtQuick3D::Object3D::parent This property holds the parent of the Object3D in a 3D scene. | |
![]() | |
QString | objectName |
the name of this object | |
Additional Inherited Members | |
![]() | |
enum | TransformSpace { LocalSpace , ParentSpace , SceneSpace } |
enum | StaticFlags { None } |
![]() | |
static QMetaObject::Connection | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
\threadsafe | |
static QMetaObject::Connection | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
template<typename Func1 , typename Func2 > | |
static QMetaObject::Connection | connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::ContextTypeForFunctor< Func2 >::ContextType *context, Func2 &&slot, Qt::ConnectionType type=Qt::AutoConnection) |
template<typename Func1 , typename Func2 > | |
static QMetaObject::Connection | connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 &&slot) |
static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
\threadsafe | |
static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
static bool | disconnect (const QMetaObject::Connection &) |
Disconnect a connection. | |
template<typename Func1 , typename Func2 > | |
static bool | disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot) |
template<typename Func1 > | |
static bool | disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *receiver, void **zero) |
![]() | |
QScopedPointer< QObjectData > | d_ptr |
![]() | |
template< class T > T | qobject_cast (const QObject *object) |
Returns the given object cast to type T if the object is of type T (or of a subclass); otherwise returns \nullptr. | |
template< typename T > T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
template< typename T > QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
QObjectList | |
\macro Q_CLASSINFO(Name, Value) | |
Definition at line 23 of file qquick3dcamera_p.h.
|
explicitprotected |
\qmltype Camera \inherits Node \inqmlmodule QtQuick3D
Defines an abstract base for Cameras.
A Camera defines how the content of the 3D scene is projected onto a 2D surface, such as a View3D. A scene needs at least one Camera in order to visualize its contents.
It is possible to position and rotate the Camera like any other spatial \l{QtQuick3D::Node}{Node} in the scene. The \l{QtQuick3D::Node}{Node}'s location and orientation determines where the Camera is in the scene, and what direction it is facing. The default orientation of the camera has its forward vector pointing along the negative Z axis and its up vector along the positive Y axis.
Together with the position and orientation, the frustum defines which parts of a scene are visible to the Camera and how they are projected onto the 2D surface. The different Camera subtypes provide multiple options to determine the shape of the Camera's frustum.
\list
To illustrate the difference, these screenshots show the same scene as projected by a PerspectiveCamera and an OrthographicCamera. Notice how the red box is smaller than the green box in the image rendered using the perspective projection. \table \header
Definition at line 72 of file qquick3dcamera.cpp.
bool QQuick3DCamera::frustumCullingEnabled | ( | ) | const |
\qmlproperty bool Camera::frustumCullingEnabled
When this property is true
, objects outside the camera frustum will be culled, meaning they will not be passed to the renderer. By default this property is set to false
. For scenes where all or most objects are inside the camera frustum, frustum culling is an unnecessary performance overhead. But for complex scenes where large parts are located outside the camera's view, enabling frustum culling may improve performance.
Definition at line 84 of file qquick3dcamera.cpp.
|
signal |
\qmlmethod vector3d Camera::lookAt(vector3d scenePos)
Sets the rotation value of the Camera so that it is pointing at scenePos.
Definition at line 295 of file qquick3dcamera.cpp.
References QQuick3DNode::eulerRotation, qRadiansToDegrees(), QQuick3DNode::scenePosition, QQuick3DNode::setEulerRotation(), QVector3D::x(), QVector3D::y(), and QVector3D::z().
Referenced by lookAt().
void QQuick3DCamera::lookAt | ( | QQuick3DNode * | node | ) |
\qmlmethod vector3d Camera::lookAt(QtQuick3D::Node node)
Sets the rotation value of the Camera so that it is pointing at node.
Definition at line 321 of file qquick3dcamera.cpp.
References lookAt(), and QQuick3DNode::scenePosition.
QQuick3DNode * QQuick3DCamera::lookAtNode | ( | ) | const |
\qmlproperty Node Camera::lookAtNode
If this property is set to a non-null
value, the rotation of this camera is automatically updated so that this camera keeps looking at the specified node whenever the scene position of this camera or the specified node changes. By default this property is set to {null}.
Definition at line 109 of file qquick3dcamera.cpp.
\qmlmethod vector3d Camera::mapFromViewport(vector3d viewportPos)
Transforms viewportPos from viewport space (2D) into global scene space (3D).
The x- and y-values of viewportPos must be normalized, with the top-left of the viewport at [0, 0] and the bottom-right at [1, 1]. The z-value is interpreted as the distance from the near clip plane of the frustum (clipNear).
If viewportPos cannot successfully be mapped to a position in the scene, a position of [0, 0, 0] is returned.
Definition at line 213 of file qquick3dcamera.cpp.
References direction, QQuick3DObjectPrivate::get(), QMatrix4x4::inverted(), QSSGRenderCamera::projection, qFuzzyIsNull(), qIsNaN(), QQuick3DNode::sceneTransform, QVector4D::setX(), QVector4D::setY(), QVector4D::setZ(), QQuick3DObjectPrivate::spatialNode, QVector4D::toVector3D(), mat44::transform(), QVector4D::w(), QVector4D::x(), QVector4D::y(), and QVector3D::z().
Referenced by mapFromViewport(), and QQuick3DViewport::mapTo3DScene().
QVector3D QQuick3DCamera::mapFromViewport | ( | const QVector3D & | viewportPos, |
qreal | width, | ||
qreal | height | ||
) |
Definition at line 275 of file qquick3dcamera.cpp.
References QQuick3DObjectPrivate::get(), mapFromViewport(), QQuick3DObjectPrivate::spatialNode, and updateSpatialNode().
\qmlmethod vector3d Camera::mapToViewport(vector3d scenePos)
Transforms scenePos from global scene space (3D) into viewport space (2D).
The returned position is normalized, with the top-left of the viewport at [0, 0] and the bottom-right at [1, 1]. The returned z-value will contain the distance from the near clip plane of the frustum (clipNear) to scenePos in scene coordinates. If the distance is negative, the point is behind camera.
If scenePos cannot successfully be mapped to a position in the viewport, a position of [0, 0, 0] is returned.
Definition at line 150 of file qquick3dcamera.cpp.
References direction, QVector3D::dotProduct(), QQuick3DObjectPrivate::get(), QMatrix4x4::inverted(), QVector3D::length(), QSSGRenderCamera::projection, qFuzzyIsNull(), qIsNaN(), QQuick3DNode::sceneTransform, QVector3D::setX(), QVector3D::setY(), QVector3D::setZ(), QVector4D::setZ(), QQuick3DObjectPrivate::spatialNode, QVector4D::toVector3D(), toVector3D(), mat44::transform(), QVector4D::w(), QVector3D::x(), and QVector3D::y().
Referenced by QQuick3DViewport::mapFrom3DScene(), and mapToViewport().
Definition at line 259 of file qquick3dcamera.cpp.
References QQuick3DObjectPrivate::get(), mapToViewport(), QQuick3DObjectPrivate::spatialNode, and updateSpatialNode().
|
signal |
QQuick3DCamera::Q_REVISION | ( | 6 | , |
5 | |||
) | const |
|
signal |
|
newslot |
|
slot |
Definition at line 89 of file qquick3dcamera.cpp.
References emit, frustumCullingEnabled, frustumCullingEnabledChanged(), and QQuick3DObject::update().
|
slot |
Definition at line 114 of file qquick3dcamera.cpp.
References QObject::connect(), disconnect(), emit, and QQuick3DNode::scenePositionChanged().
Definition at line 328 of file qquick3dcamera.cpp.
References QSSGRenderCamera::calculateGlobalVariables(), QQuick3DObjectPrivate::get(), and QQuick3DObjectPrivate::spatialNode.
Referenced by QQuick3DViewport::setCamera().
|
overrideprotectedvirtual |
Reimplemented from QQuick3DObject.
Reimplemented in QQuick3DCustomCamera, QQuick3DFrustumCamera, QQuick3DOrthographicCamera, and QQuick3DPerspectiveCamera.
Definition at line 338 of file qquick3dcamera.cpp.
References camera, QSSGRenderCamera::CameraDirty, QQuick3DObjectPrivate::get(), QQuick3DNode::markAllDirty(), qUpdateIfNeeded(), and QQuick3DNode::updateSpatialNode().
Referenced by mapFromViewport(), mapToViewport(), QQuick3DCustomCamera::updateSpatialNode(), QQuick3DOrthographicCamera::updateSpatialNode(), and QQuick3DPerspectiveCamera::updateSpatialNode().
|
readwrite |
Definition at line 76 of file qquick3dcamera_p.h.
Referenced by setFrustumCullingEnabled().
|
readwrite |
\qmlproperty float Camera::levelOfDetailBias
This property changes the size a model needs to be when rendered before the automatic level of detail meshes are used. Each generated level of detail mesh contains an ideal size value that each level should be shown, which is a ratio of how much of the rendered scene will be that mesh. A model that represents only a few pixels on screen will not require the full geometry to look correct, so a lower level of detail mesh will be used instead in this case. This value is a bias to the ideal value such that a value smaller than 1.0
will require an even smaller rendered size before switching to a lesser level of detail. Values above 1.0
will lead to lower levels of detail being used sooner. A value of 0.0
will disable the usage of levels of detail completely.
The default value is 1.0
Definition at line 76 of file qquick3dcamera_p.h.
|
readwrite |
Definition at line 76 of file qquick3dcamera_p.h.