diff options
88 files changed, 669 insertions, 703 deletions
diff --git a/examples/qt3d/advancedcustommaterial/doc/src/advancedcustommaterial.qdoc b/examples/qt3d/advancedcustommaterial/doc/src/advancedcustommaterial.qdoc index eeb59f07b..0f8a95dab 100644 --- a/examples/qt3d/advancedcustommaterial/doc/src/advancedcustommaterial.qdoc +++ b/examples/qt3d/advancedcustommaterial/doc/src/advancedcustommaterial.qdoc @@ -27,7 +27,7 @@ /*! \example advancedcustommaterial - \title Qt 3D: Advanced custom material QML Example + \title Qt 3D: Advanced Custom Material QML Example \ingroup qt3d-examples-qml \brief Demonstrates creating advanced materials in Qt3D diff --git a/examples/qt3d/pbr-materials/doc/src/materials.qdoc b/examples/qt3d/pbr-materials/doc/src/materials.qdoc index c96bb0843..7a0e5d9a4 100644 --- a/examples/qt3d/pbr-materials/doc/src/materials.qdoc +++ b/examples/qt3d/pbr-materials/doc/src/materials.qdoc @@ -26,7 +26,7 @@ ****************************************************************************/ /*! - \example materials + \example pbr-materials \title Qt 3D: PBR Materials QML Example \ingroup qt3d-examples-qml \brief A QML application that demonstrates using PBR materials. diff --git a/examples/qt3d/planets-qml/images/nasa/qt_attribution.json b/examples/qt3d/planets-qml/images/nasa/qt_attribution.json index 174e092ef..400c405fb 100644 --- a/examples/qt3d/planets-qml/images/nasa/qt_attribution.json +++ b/examples/qt3d/planets-qml/images/nasa/qt_attribution.json @@ -2,6 +2,7 @@ "Id": "nasa-jpl", "Name": "Jet Propulsion Laboratory Photojournal", "QDocModule": "qt3d", + "QtParts": ["examples"], "Description": "The NASA/JPL Photojournal provides high quality images related to space research and exploration", "QtUsage": "Used in Qt 3D planets-qml example.", diff --git a/examples/qt3d/scene3d/doc/src/scene3d.qdoc b/examples/qt3d/scene3d/doc/src/scene3d.qdoc index fd324e6a4..c6deb6546 100644 --- a/examples/qt3d/scene3d/doc/src/scene3d.qdoc +++ b/examples/qt3d/scene3d/doc/src/scene3d.qdoc @@ -33,7 +33,7 @@ \image scene3d.png - \e {Scene3D} demonstrates visualizing a 3D scene from a Qt Quick + This example demonstrates visualizing a 3D scene from a Qt Quick application. The 3D scene contains a single active camera and a single active light source. Visualized data is assumed to be at a fixed location. diff --git a/examples/qt3d/simplecustommaterial/doc/src/simplecustommaterial.qdoc b/examples/qt3d/simplecustommaterial/doc/src/simplecustommaterial.qdoc index 678a8f2d7..d10927d39 100644 --- a/examples/qt3d/simplecustommaterial/doc/src/simplecustommaterial.qdoc +++ b/examples/qt3d/simplecustommaterial/doc/src/simplecustommaterial.qdoc @@ -27,9 +27,9 @@ /*! \example simplecustommaterial - \title Qt 3D: Simple custom material QML Example + \title Qt 3D: Simple Custom Material QML Example \ingroup qt3d-examples-qml - \brief Demonstrates creating a custom material in Qt3D + \brief Demonstrates creating a custom material in Qt 3D. \image simple-custom-material.jpg @@ -37,7 +37,7 @@ \include examples-run.qdocinc - \section1 Specifying the scene + \section1 Specifying the Scene The example uses \l Scene3D to render a scene which will use the custom material. The scene contains a plane model, which uses the custom material. @@ -46,7 +46,7 @@ \skipto Entity \printto - \section1 Specifying the material + \section1 Specifying the Material The material is specified in \l{simplecustommaterial/SimpleMaterial.qml}{SimpleMaterial.qml} using \l Material type. First the material specifies parameters, diff --git a/src/animation/animation.pro b/src/animation/animation.pro index 066985760..b7d08416c 100644 --- a/src/animation/animation.pro +++ b/src/animation/animation.pro @@ -21,6 +21,4 @@ HEADERS += \ SOURCES += \ animationlogging.cpp -QMAKE_DOCS = $$PWD/doc/qt3danimation.qdocconf - load(qt_module) diff --git a/src/animation/backend/bezierevaluator.cpp b/src/animation/backend/bezierevaluator.cpp index 320f8b7ad..8a7f0139b 100644 --- a/src/animation/backend/bezierevaluator.cpp +++ b/src/animation/backend/bezierevaluator.cpp @@ -101,6 +101,8 @@ float BezierEvaluator::valueForTime(float time) const } /*! + \internal + Calculates the value of the Bezier parameter, u, for the requested time which is the x coordinate of the Keyframes. diff --git a/src/animation/backend/clipblendnode.cpp b/src/animation/backend/clipblendnode.cpp index 94a956837..81fc61910 100644 --- a/src/animation/backend/clipblendnode.cpp +++ b/src/animation/backend/clipblendnode.cpp @@ -93,7 +93,7 @@ ClipResults ClipBlendNode::clipResults(Qt3DCore::QNodeId animatorId) const return ClipResults(); } -/*! +/* \fn QVector<Qt3DCore::QNodeId> ClipBlendNode::currentDependencyIds() const \internal @@ -115,7 +115,7 @@ ClipResults ClipBlendNode::clipResults(Qt3DCore::QNodeId animatorId) const evaluated in one pass, and the tree in a subsequent pass. */ -/*! +/* \fn QVector<Qt3DCore::QNodeId> ClipBlendNode::allDependencyIds() const \internal @@ -126,7 +126,7 @@ ClipResults ClipBlendNode::clipResults(Qt3DCore::QNodeId animatorId) const parameter. Not just those bounding the current blend value. */ -/*! +/* \internal Fetches the ClipResults from the nodes listed in the dependencyIds diff --git a/src/animation/doc/qt3danimation.qdocconf b/src/animation/doc/qt3danimation.qdocconf deleted file mode 100644 index 74c185e7f..000000000 --- a/src/animation/doc/qt3danimation.qdocconf +++ /dev/null @@ -1,43 +0,0 @@ -include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf) -include(../../doc/qt3d-config.qdocconf) - -project = Qt3DAnimation -description = Qt 3D Animation Reference Documentation -version = $QT_VERSION - -qhp.projects = Qt3DAnimation - -qhp.Qt3DAnimation.file = qt3danimation.qhp -qhp.Qt3DAnimation.namespace = org.qt-project.qt3danimation.$QT_VERSION_TAG -qhp.Qt3DAnimation.virtualFolder = qt3danimation -qhp.Qt3DAnimation.indexTitle = Qt 3D Animation -qhp.Qt3DAnimation.indexRoot = - -qhp.Qt3DAnimation.filterAttributes = qt3danimation $QT_VERSION qtrefdoc -qhp.Qt3DAnimation.customFilters.Qt.name = Qt3DAnimation $QT_VERSION -qhp.Qt3DAnimation.customFilters.Qt.filterAttributes = qt3danimation $QT_VERSION - -qhp.Qt3DAnimation.subprojects = classes qmltypes - -qhp.Qt3DAnimation.subprojects.classes.title = C++ Classes -qhp.Qt3DAnimation.subprojects.classes.indexTitle = Qt 3D Animation C++ Classes -qhp.Qt3DAnimation.subprojects.classes.selectors = class doc:headerfile -qhp.Qt3DAnimation.subprojects.classes.sortPages = true - -qhp.Qt3DAnimation.subprojects.qmltypes.title = QML Types -qhp.Qt3DAnimation.subprojects.qmltypes.indexTitle = Qt 3D Animation QML Types -qhp.Qt3DAnimation.subprojects.qmltypes.selectors = qmltype -qhp.Qt3DAnimation.subprojects.qmltypes.sortPages = true - -tagfile = qt3danimation.tags - -depends += qtcore qtgui qtqml qtquick qtdoc qmake - -# dependencies to other Qt 3D modules -depends += qt3d qt3dcore qt3drender qt3dlogic \ - qt3dinput qt3dextras qt3dscene2d - -sourcedirs += .. -headerdirs += .. -imagedirs += images -exampledirs += snippets diff --git a/src/animation/frontend/qabstractclipanimator.cpp b/src/animation/frontend/qabstractclipanimator.cpp index f531127c7..ba5d9456b 100644 --- a/src/animation/frontend/qabstractclipanimator.cpp +++ b/src/animation/frontend/qabstractclipanimator.cpp @@ -218,7 +218,7 @@ QClock *QAbstractClipAnimator::clock() const } /*! - \property int QAbstractClipAnimator::normalizedTime + \property Qt3DAnimation::QAbstractClipAnimator::normalizedTime This property holds the clips normalized time. */ diff --git a/src/animation/frontend/qchannelmappingcreatedchange.cpp b/src/animation/frontend/qchannelmappingcreatedchange.cpp index 6da1eb23e..6812278ac 100644 --- a/src/animation/frontend/qchannelmappingcreatedchange.cpp +++ b/src/animation/frontend/qchannelmappingcreatedchange.cpp @@ -49,9 +49,9 @@ QChannelMappingCreatedChangeBasePrivate::QChannelMappingCreatedChangeBasePrivate } /*! - \class QChannelmappingCreatedChangeBase + \class Qt3DAnimation::QChannelMappingCreatedChangeBase \inmodule Qt3DCore - \brief Base class for handling creation changes for QAbstractSkeleton sub-classes + \brief Base class for handling creation changes for QAbstractSkeleton sub-classes. */ QChannelMappingCreatedChangeBase::QChannelMappingCreatedChangeBase(const QAbstractChannelMapping *mapping) : Qt3DCore::QNodeCreatedChangeBase(*new QChannelMappingCreatedChangeBasePrivate(mapping), mapping) diff --git a/src/animation/frontend/qclipblendnodecreatedchange.cpp b/src/animation/frontend/qclipblendnodecreatedchange.cpp index 0dc417b1c..5192e6a01 100644 --- a/src/animation/frontend/qclipblendnodecreatedchange.cpp +++ b/src/animation/frontend/qclipblendnodecreatedchange.cpp @@ -49,7 +49,7 @@ QClipBlendNodeCreatedChangeBasePrivate::QClipBlendNodeCreatedChangeBasePrivate(c } /*! - \class QClipBlendNodeCreateChangeBase + \class Qt3DAnimation::QClipBlendNodeCreatedChangeBase \inherits Qt3DCore::QNodeCreatedChangeBase \inmodule Qt3DAnimation \brief Base class for changes in QClipBlendNode @@ -63,9 +63,9 @@ QClipBlendNodeCreatedChangeBase::~QClipBlendNodeCreatedChangeBase() { } /*! - typedef Qt3DAnimation::QClipBlendNodeCreatedChangeBasePtr + \typedef Qt3DAnimation::QClipBlendNodeCreatedChangeBasePtr - A shared pointer for QClipBlendNodeCreatedChangeBase + A shared pointer for QClipBlendNodeCreatedChangeBase. */ } // Qt3DAnimation diff --git a/src/animation/frontend/qkeyframe.cpp b/src/animation/frontend/qkeyframe.cpp index 1d63af3ab..2b2dc24bd 100644 --- a/src/animation/frontend/qkeyframe.cpp +++ b/src/animation/frontend/qkeyframe.cpp @@ -44,9 +44,9 @@ QT_BEGIN_NAMESPACE namespace Qt3DAnimation { /*! - \class QKeyframe + \class Qt3DAnimation::QKeyFrame \inmodule Qt3DAnimation - \brief A base class for handling keyframes + \brief A base class for handling keyframes. */ } // namespace Qt3DAnimation diff --git a/src/animation/frontend/qlerpclipblend.cpp b/src/animation/frontend/qlerpclipblend.cpp index 3b26adbaa..12f4d7aec 100644 --- a/src/animation/frontend/qlerpclipblend.cpp +++ b/src/animation/frontend/qlerpclipblend.cpp @@ -69,12 +69,12 @@ namespace Qt3DAnimation { \inherits Qt3DAnimation::QAbstractClipBlendNode \brief Performs a linear interpolation of two animation clips based on a - normalized factor + normalized factor. \since 5.9 QLerpClipBlend can be useful to create advanced animation effects based on - individual animation clips. For instance, given a player character,, lerp + individual animation clips. For instance, given a player character, lerp blending could be used to combine a walking animation clip with an injured animation clip based on a blend factor that increases the more the player gets injured. This would then allow with blend factor == 0 to have a non @@ -224,32 +224,6 @@ void QLerpClipBlend::setEndClip(Qt3DAnimation::QAbstractClipBlendNode *endClip) emit endClipChanged(endClip); } -/*! - \qmlproperty list<AnimationClip> LerpBlend::clips - - Holds the list of AnimationClip nodes against which the blending is performed. - - \note Only the two first AnimationClip are used, subsequent ones are ignored -*/ - - -/*! - \fn void QLerpClipBlend::addClip(QAbstractAnimationClip *clip); - Adds a \a clip to the blending node's clips list. - - \note Only the two first AnimationClip are used, subsequent ones are ignored - */ - -/*! - \fn void QLerpClipBlend::removeClip(QAbstractAnimationClip *clip); - Removes a \a clip from the blending node's clips list. - */ - -/*! - \fn QVector<QAbstractAnimationClip *> QLerpClipBlend::clips() const; - Returns the list of QAnimationClip against which the blending is performed. - */ - } // Qt3DAnimation QT_END_NAMESPACE diff --git a/src/core/aspects/qaspectmanager.cpp b/src/core/aspects/qaspectmanager.cpp index 375a4ed83..0b00e6ef3 100644 --- a/src/core/aspects/qaspectmanager.cpp +++ b/src/core/aspects/qaspectmanager.cpp @@ -68,6 +68,10 @@ QT_BEGIN_NAMESPACE namespace Qt3DCore { +/*! + \class Qt3DCore::QAspectManager + \internal +*/ QAspectManager::QAspectManager(QObject *parent) : QObject(parent) , m_root(nullptr) @@ -198,7 +202,7 @@ void QAspectManager::setRootEntity(Qt3DCore::QEntity *root, const QVector<Qt3DCo } /*! - * \fn void Qt3DCore::QAspectManager::registerAspect(Qt3DCore::QAbstractAspect *aspect) + * \internal * * Registers a new \a aspect. */ diff --git a/src/core/changes/qnodecommand.cpp b/src/core/changes/qnodecommand.cpp index 8222ada4d..2be939624 100644 --- a/src/core/changes/qnodecommand.cpp +++ b/src/core/changes/qnodecommand.cpp @@ -83,7 +83,14 @@ QNodeCommand::CommandId QNodeCommandPrivate::createId() */ /*! - * Constructs a new QNodeCommand with \a node. + * \typedef QNodeCommand::CommandId + * + * Type of the command id, defined either as quint64 or quint32 + * depending on the platform support. + */ + +/*! + * Constructs a new QNodeCommand with \a id. */ QNodeCommand::QNodeCommand(QNodeId id) : QSceneChange(*new QNodeCommandPrivate(), CommandRequested, id) diff --git a/src/core/changes/qscenechange.cpp b/src/core/changes/qscenechange.cpp index 03fe7e5d7..87bf06ea0 100644 --- a/src/core/changes/qscenechange.cpp +++ b/src/core/changes/qscenechange.cpp @@ -56,6 +56,7 @@ namespace Qt3DCore { * \value PropertyUpdated A QNode property has been updated. * \value PropertyValueAdded A QNode has been added to the scene. * \value PropertyValueRemoved A QNode has been removed from the scene. + * \value CommandRequested A QNodeCommand has been sent between a node and its backend. * \value ComponentAdded A QComponent has been added to a QEntity. * \value ComponentRemoved A QComponent has been removed from a QEntity. * \value CallbackTriggered A QNode triggered a callback. @@ -78,7 +79,7 @@ QSceneChangePrivate::~QSceneChangePrivate() * \class Qt3DCore::QSceneChange * \inheaderfile Qt3DCore/QSceneChange * \inmodule Qt3DCore - * \brief The base class for changes that can be sent and received by Qt3D's change notification system + * \brief The base class for changes that can be sent and received by Qt3D's change notification system. */ /*! @@ -127,7 +128,7 @@ QSceneChange::~QSceneChange() } /*! - * \return scene change type. + * Returns the scene change type. */ ChangeFlag QSceneChange::type() const Q_DECL_NOTHROW { @@ -136,7 +137,7 @@ ChangeFlag QSceneChange::type() const Q_DECL_NOTHROW } /*! - Set the Delivery flags of the change to \a flags + Sets the delivery flags of the change to \a flags. */ void QSceneChange::setDeliveryFlags(DeliveryFlags flags) Q_DECL_NOTHROW { @@ -145,7 +146,7 @@ void QSceneChange::setDeliveryFlags(DeliveryFlags flags) Q_DECL_NOTHROW } /*! - \return the set delivery flags + Returns the set delivery flags. */ QSceneChange::DeliveryFlags QSceneChange::deliveryFlags() const Q_DECL_NOTHROW { diff --git a/src/core/core.pro b/src/core/core.pro index 742085ac7..8e65fafab 100644 --- a/src/core/core.pro +++ b/src/core/core.pro @@ -20,6 +20,4 @@ include(transforms/transforms.pri) include(resources/resources.pri) include(services/services.pri) -QMAKE_DOCS = $$PWD/doc/qt3dcore.qdocconf - load(qt_module) diff --git a/src/core/doc/qt3dcore.qdocconf b/src/core/doc/qt3dcore.qdocconf deleted file mode 100644 index 3b772aec1..000000000 --- a/src/core/doc/qt3dcore.qdocconf +++ /dev/null @@ -1,47 +0,0 @@ -include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf) -include(../../doc/qt3d-config.qdocconf) - -project = Qt3DCore -description = Qt 3D Core Reference Documentation -version = $QT_VERSION - -qhp.projects = Qt3DCore - -qhp.Qt3DCore.file = qt3dcore.qhp -qhp.Qt3DCore.namespace = org.qt-project.qt3dcore.$QT_VERSION_TAG -qhp.Qt3DCore.virtualFolder = qt3dcore -qhp.Qt3DCore.indexTitle = Qt 3D Core -qhp.Qt3DCore.indexRoot = - -qhp.Qt3DCore.filterAttributes = qt3dcore $QT_VERSION qtrefdoc -qhp.Qt3DCore.customFilters.Qt.name = Qt3DCore $QT_VERSION -qhp.Qt3DCore.customFilters.Qt.filterAttributes = qt3dcore $QT_VERSION - -qhp.Qt3DCore.subprojects = classes qmltypes - -qhp.Qt3DCore.subprojects.classes.title = C++ Classes -qhp.Qt3DCore.subprojects.classes.indexTitle = Qt 3D Core C++ Classes -qhp.Qt3DCore.subprojects.classes.selectors = class doc:headerfile -qhp.Qt3DCore.subprojects.classes.sortPages = true - -qhp.Qt3DCore.subprojects.qmltypes.title = QML Types -qhp.Qt3DCore.subprojects.qmltypes.indexTitle = Qt 3D Core QML Types -qhp.Qt3DCore.subprojects.qmltypes.selectors = qmltype -qhp.Qt3DCore.subprojects.qmltypes.sortPages = true - -tagfile = qt3dcore.tags - -depends += qtcore qtgui qtqml qtquick qtdoc qmake - -# dependencies to other Qt 3D modules -depends += qt3d qt3drender qt3dlogic qt3dinput \ - qt3dextras qt3danimation qt3dscene2d - -sourcedirs += .. \ - ../../quick3d/quick3d - -headerdirs += .. \ - ../../quick3d/quick3d - -imagedirs += images -exampledirs += snippets diff --git a/src/core/nodes/qnode.cpp b/src/core/nodes/qnode.cpp index ecdc83b2c..b370102d4 100644 --- a/src/core/nodes/qnode.cpp +++ b/src/core/nodes/qnode.cpp @@ -984,9 +984,9 @@ QNodeCommand::CommandId QNode::sendCommand(const QString &name, } /*! - * \brief Send a command back to the backend node + * \brief Send a \a command back to the backend node. * - * Assumes the command is to be to sent back in reply to itself to the backend node + * Assumes the command is to be to sent back in reply to itself to the backend node. * * \sa QNodeCommand, QNode::sendCommand */ diff --git a/src/core/nodes/qnodeid.cpp b/src/core/nodes/qnodeid.cpp index 7e392137e..3e11733e6 100644 --- a/src/core/nodes/qnodeid.cpp +++ b/src/core/nodes/qnodeid.cpp @@ -89,7 +89,7 @@ namespace Qt3DCore { /*! * \fn Qt3DCore::QNodeId::operator bool() const - * \TODO + * Returns \TODO */ /*! diff --git a/src/doc/Qt3DDoc b/src/doc/Qt3DDoc new file mode 100644 index 000000000..496730dd4 --- /dev/null +++ b/src/doc/Qt3DDoc @@ -0,0 +1,24 @@ +#include <Qt3DCore/Qt3DCore> +#include <Qt3DLogic/Qt3DLogic> +#include <Qt3DRender/Qt3DRender> +#include <Qt3DInput/Qt3DInput> +#include <Qt3DQuick/Qt3DQuick> +#include <Qt3DQuickRender/Qt3DQuickRender> +#include <Qt3DQuickInput/Qt3DQuickInput> +#include <Qt3DQuickAnimation/Qt3DQuickAnimation> +#include <Qt3DAnimation/Qt3DAnimation> +#include <Qt3DQuickExtras/Qt3DQuickExtras> +#include <Qt3DQuickScene2D/Qt3DQuickScene2D> +#include <Qt3DExtras/Qt3DExtras> + +// partial list of private headers +#include "../core/aspects/qaspectmanager_p.h" +#include "../core/transforms/matrix4x4_p.h" +#include "../core/transforms/vector3d_p.h" +#include "../render/raycasting/qray3d_p.h" +#include "../input/frontend/qabstractphysicaldeviceproxy_p.h" +#include "../input/frontend/qinputdeviceintegration_p.h" +#include "../animation/frontend/qchannelmappingcreatedchange_p.h" +#include "../animation/frontend/qclipblendnodecreatedchange_p.h" +#include "../animation/backend/clipblendnode_p.h" +#include "../quick3d/imports/scene3d/scene3ditem_p.h" diff --git a/src/doc/qt3d-config.qdocconf b/src/doc/qt3d-config.qdocconf deleted file mode 100644 index b5f1fad8f..000000000 --- a/src/doc/qt3d-config.qdocconf +++ /dev/null @@ -1,36 +0,0 @@ -examplesinstallpath = qt3d - -# Dependencies to Qt documentation -depends += qtcore qtgui qtqml qtquick qtdoc qmake - -# Exclude private header files from the documentation build -excludefiles += "*_p.h" - -examples.fileextensions += "*.fraq *.geom *.vert" -examples.imageextensions += "*.png" - -macro.TODO = " " - -Cpp.ignoretokens += QT3DINPUTSHARED_EXPORT \ - QT3DCORESHARED_EXPORT \ - QT3DLOGIC_PRIVATE_EXPORT \ - QT3DLOGICSHARED_EXPORT \ - QT3DRENDERSHARED_EXPORT \ - QT3DRENDERSHARED_PRIVATE_EXPORT \ - QT3DQUICKSHARED_PRIVATE_EXPORT \ - QT3DEXTRASSHARED_EXPORT \ - QT3DANIMATIONSHARED_EXPORT \ - QT3DQUICKSCENE2DSHARED_EXPORT - -Cpp.ignoredirectives += Q_DECLARE_LOGGING_CATEGORY - -manifestmeta.highlighted.names = \ - "Qt3D/Qt 3D: Advanced custom material QML Example" \ - "Qt3D/Qt 3D: Audio Visualizer Example" \ - "Qt3D/Qt 3D: Planets QML Example" - -manifestmeta.thumbnail.names += "Qt3D/Qt 3D: Deferred Renderer C++ Example" - -navigation.landingpage = "Qt 3D" -navigation.cppclassespage = "Qt 3D C++ Classes" -navigation.qmltypespage = "Qt 3D QML Types" diff --git a/src/doc/qt3d.qdocconf b/src/doc/qt3d.qdocconf index b397f1837..d4eb41601 100644 --- a/src/doc/qt3d.qdocconf +++ b/src/doc/qt3d.qdocconf @@ -1,10 +1,21 @@ include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf) -include(qt3d-config.qdocconf) project = Qt3D description = Qt 3D Reference Documentation version = $QT_VERSION +moduleheader = Qt3DDoc +includepaths = -I . \ + -I $QT_INSTALL_HEADERS \ + -I $QT_INSTALL_HEADERS/Qt3DCore \ + -I $QT_INSTALL_HEADERS/Qt3DCore/$QT_VERSION \ + -I $QT_INSTALL_HEADERS/Qt3DAnimation \ + -I $QT_INSTALL_HEADERS/Qt3DAnimation/$QT_VERSION \ + -I $QT_INSTALL_HEADERS/Qt3DInput \ + -I $QT_INSTALL_HEADERS/Qt3DInput/$QT_VERSION + +examplesinstallpath = qt3d + qhp.projects = Qt3D qhp.Qt3D.file = qt3d.qhp @@ -26,7 +37,7 @@ qhp.Qt3D.subprojects.classes.sortPages = true qhp.Qt3D.subprojects.qmltypes.title = QML Types qhp.Qt3D.subprojects.qmltypes.indexTitle = Qt 3D QML Types -qhp.Qt3D.subprojects.qmltypes.selectors = qmltype +qhp.Qt3D.subprojects.qmltypes.selectors = qmlclass qhp.Qt3D.subprojects.qmltypes.sortPages = true qhp.Qt3D.subprojects.examples.title = Examples @@ -34,16 +45,87 @@ qhp.Qt3D.subprojects.examples.indexTitle = Qt 3D Examples qhp.Qt3D.subprojects.examples.selectors = doc:example qhp.Qt3D.subprojects.examples.sortPages = true -# dependencies to other Qt 3D modules -depends += qt3dcore qt3drender qt3dlogic qt3dinput \ - qt3dextras qt3danimation qt3dscene2d - tagfile = qt3d.tags -headerdirs += src -sourcedirs += src +depends += qtcore qtgui qtqml qtquick qtdoc + +headerdirs += . \ + ../render \ + ../core \ + ../logic \ + ../plugins \ + ../quick3d/quick3d \ + ../input \ + ../extras \ + ../animation \ + ../quick3d/quick3dscene2d \ + ../quick3d/imports/scene3d + +# Exclude private header files from the documentation build +excludefiles += "*_p.h" + +# Add some private headers explicitly to avoid documentation warnings +headers = ../core/transforms/matrix4x4_p.h \ + ../core/transforms/vector3d_p.h \ + ../render/raycasting/qray3d_p.h \ + ../animation/frontend/qchannelmappingcreatedchange_p.h \ + ../input/frontend/qabstractphysicaldeviceproxy_p.h \ + ../input/frontend/qinputdeviceintegration_p.h \ + ../quick3d/imports/scene3d/scene3ditem_p.h + +sourcedirs += . \ + ../render \ + ../core \ + ../logic \ + ../plugins \ + ../quick3d/quick3d \ + ../input \ + ../extras \ + ../animation \ + ../quick3d/quick3dscene2d \ + ../quick3d/imports/scene3d + exampledirs += ../../examples/qt3d \ snippets -imagedirs += images +examples.fileextensions += "*.fraq *.geom *.vert" +examples.imageextensions += "*.png" + +excludedirs += \ + ../plugins/renderplugins + +macro.TODO = " " +imagedirs += images \ + ../../examples/qt3d/shadow-map-qml/doc/images \ + ../../examples/qt3d/basicshapes-cpp/doc/images \ + ../../examples/qt3d/planets-qml/doc/images \ + ../../examples/qt3d/wireframe/doc/images \ + ../../examples/qt3d/audio-visualizer-qml/doc/images \ + ../../examples/qt3d/simplecustommaterial/doc/images \ + ../../examples/qt3d/scene2d/doc/images \ + ../../examples/qt3d/advancedcustommaterial/doc/images + +Cpp.ignoretokens += QT3DINPUTSHARED_EXPORT \ + QT3DCORESHARED_EXPORT \ + QT3DLOGIC_PRIVATE_EXPORT \ + QT3DLOGICSHARED_EXPORT \ + QT3DRENDERSHARED_EXPORT \ + QT3DRENDERSHARED_PRIVATE_EXPORT \ + QT3DQUICKSHARED_PRIVATE_EXPORT \ + QT3DEXTRASSHARED_EXPORT \ + QT3DANIMATIONSHARED_EXPORT \ + QT3DQUICKSCENE2DSHARED_EXPORT + +Cpp.ignoredirectives += Q_DECLARE_LOGGING_CATEGORY + +manifestmeta.highlighted.names = \ + "Qt3D/Qt 3D: Advanced custom material QML Example" \ + "Qt3D/Qt 3D: Audio Visualizer Example" \ + "Qt3D/Qt 3D: Planets QML Example" + +manifestmeta.thumbnail.names += "Qt3D/Qt 3D: Deferred Renderer C++ Example" + +navigation.landingpage = "Qt 3D" +navigation.cppclassespage = "Qt 3D C++ Classes" +navigation.qmltypespage = "Qt 3D QML Types" diff --git a/src/render/doc/src/levelofdetailloader.qdoc b/src/doc/src/levelofdetailloader.qdoc index 6294e4735..6294e4735 100644 --- a/src/render/doc/src/levelofdetailloader.qdoc +++ b/src/doc/src/levelofdetailloader.qdoc diff --git a/src/core/doc/src/qcircularbuffer.qdoc b/src/doc/src/qcircularbuffer.qdoc index e313a7375..e313a7375 100644 --- a/src/core/doc/src/qcircularbuffer.qdoc +++ b/src/doc/src/qcircularbuffer.qdoc diff --git a/src/extras/doc/src/qmlextracontrollers.qdoc b/src/doc/src/qmlextracontrollers.qdoc index 737d0f823..737d0f823 100644 --- a/src/extras/doc/src/qmlextracontrollers.qdoc +++ b/src/doc/src/qmlextracontrollers.qdoc diff --git a/src/extras/doc/src/qmlextramaterials.qdoc b/src/doc/src/qmlextramaterials.qdoc index 48f1a2326..48f1a2326 100644 --- a/src/extras/doc/src/qmlextramaterials.qdoc +++ b/src/doc/src/qmlextramaterials.qdoc diff --git a/src/doc/src/qt3d-index.qdoc b/src/doc/src/qt3d-index.qdoc index 0e889e652..eaeaf789e 100644 --- a/src/doc/src/qt3d-index.qdoc +++ b/src/doc/src/qt3d-index.qdoc @@ -68,7 +68,7 @@ For a C++ application that performs 2D or 3D rendering, collision detection, and also handle user input, add the following line to its - \l qmake \c .pro file: + qmake \c .pro file: \badcode QT += 3dcore 3drender 3dinput 3dlogic 3dextras 3danimation diff --git a/src/doc/src/qt3d-module.qdoc b/src/doc/src/qt3d-module.qdoc index cb08a60c0..2e6eff6b2 100644 --- a/src/doc/src/qt3d-module.qdoc +++ b/src/doc/src/qt3d-module.qdoc @@ -96,6 +96,7 @@ import Qt3D.Extras 2.0 import Qt3D.Animation 2.9 import Qt3D.Scene2D 2.9 + import Qt3D.Scene3D 2.9 \endcode \section1 QML Types @@ -124,4 +125,7 @@ \section2 Qt 3D Scene2D Module \generatelist {qmltypesbymodule Qt3D.Scene2D} \noautolist + + \section2 Qt 3D Scene3D Module + \generatelist {qmltypesbymodule Qt3D.Scene3D} */ diff --git a/src/doc/src/qt3d-overview.qdoc b/src/doc/src/qt3d-overview.qdoc index e1f3d8629..2b261ebbc 100644 --- a/src/doc/src/qt3d-overview.qdoc +++ b/src/doc/src/qt3d-overview.qdoc @@ -88,8 +88,12 @@ variables in a GLSL shader program that is itself specified in the referenced effect property. - For examples of using materials, see the \l {Qt 3D: Materials C++ Example} - and \l {Qt 3D: Materials QML Example}. + For examples of using materials, see the following examples: + \list + \li \l {Qt 3D: Simple Custom Material QML Example} + \li \l {Qt 3D: Advanced Custom Material QML Example} + \li \l {Qt 3D: PBR Materials QML Example} + \endlist \section2 Shaders diff --git a/src/animation/doc/src/qt3danimation-module.qdoc b/src/doc/src/qt3danimation-module.qdoc index 918c401f9..631e449e2 100644 --- a/src/animation/doc/src/qt3danimation-module.qdoc +++ b/src/doc/src/qt3danimation-module.qdoc @@ -32,7 +32,7 @@ \preliminary \keyword Qt 3D Animation - \brief The Qt 3D Animation module provides a set of prebuilt elements to help + \brief The Qt 3D Animation modules provides a set of prebuilt elements to help you get started with Qt 3D. This module is still in development but is available as a technology preview. @@ -43,7 +43,7 @@ \qtvariable 3danimation \code - #include <Qt3DAnimation> + #include <Qt3DAnimation> \endcode To link against the corresponding C++ library, add the following to your qmake project file: @@ -229,6 +229,4 @@ \badcode import Qt3D.Animation 2.9 \endcode - - \section1 QML Types */ diff --git a/src/extras/doc/src/qt3dextras-module.qdoc b/src/doc/src/qt3dextras-module.qdoc index 98cfdf17a..7aa042160 100644 --- a/src/extras/doc/src/qt3dextras-module.qdoc +++ b/src/doc/src/qt3dextras-module.qdoc @@ -129,6 +129,4 @@ \badcode import Qt3D.Extras 2.0 \endcode - - \section1 QML Types */ diff --git a/src/input/doc/src/qt3dinput-module.qdoc b/src/doc/src/qt3dinput-module.qdoc index 7739d596d..0fbe0aef1 100644 --- a/src/input/doc/src/qt3dinput-module.qdoc +++ b/src/doc/src/qt3dinput-module.qdoc @@ -28,7 +28,6 @@ /*! \module Qt3DInput \title Qt 3D Input C++ Classes - \keyword Qt 3D Input \brief The Qt 3D Input module provides classes for handling user input in applications using Qt3D. \since 5.7 diff --git a/src/logic/doc/src/qt3dlogic-module.qdoc b/src/doc/src/qt3dlogic-module.qdoc index 8994b8bcd..8994b8bcd 100644 --- a/src/logic/doc/src/qt3dlogic-module.qdoc +++ b/src/doc/src/qt3dlogic-module.qdoc diff --git a/src/render/doc/src/qt3drender-framegraph.qdoc b/src/doc/src/qt3drender-framegraph.qdoc index 98eee0e40..44b1cbe89 100644 --- a/src/render/doc/src/qt3drender-framegraph.qdoc +++ b/src/doc/src/qt3drender-framegraph.qdoc @@ -129,7 +129,7 @@ example, if you want to use different rendering approaches for indoor and outdoor scenes or to enable or disable some special effect. - \code + \badcode Entity { id: sceneRoot components: RenderSettings { @@ -141,7 +141,7 @@ \note activeFrameGraph is the default property of the FrameGraph component in QML. - \code + \badcode Entity { id: sceneRoot components: RenderSettings { @@ -150,7 +150,7 @@ } \endcode - \section2 How the Framegraph is Used + \section2 How the Framegraph Is Used \list \li The Qt 3D renderer performs a \e{depth first traversal} of the @@ -192,7 +192,7 @@ we render to an intermediate \e G-buffer. Here is a simple FrameGraph that can be used for forward rendering: - \code + \badcode Viewport { rect: Qt.rect(0.0, 0.0, 1.0, 1.0) property alias camera: cameraSelector.camera @@ -231,7 +231,7 @@ nearer to the root of the framegraph as this will result in fewer leaf nodes, and hence, fewer RenderViews overall. - \code + \badcode Viewport { rect: Qt.rect(0.0, 0.0, 1.0, 1.0) property alias camera: cameraSelector.camera @@ -246,7 +246,7 @@ } \endcode - \code + \badcode CameraSelector { Viewport { rect: Qt.rect(0.0, 0.0, 1.0, 1.0) @@ -268,7 +268,7 @@ \image multiviewport.png - \code + \badcode Viewport { id: mainViewport rect: Qt.rect(0, 0, 1, 1) @@ -416,7 +416,7 @@ many games due to the ability to use large numbers of dynamic lights at the expense of additional GPU memory usage. - \code + \badcode Viewport { rect: Qt.rect(0.0, 0.0, 1.0, 1.0) diff --git a/src/render/doc/src/qt3drender-geometry.qdoc b/src/doc/src/qt3drender-geometry.qdoc index 6d86b92e7..03e84b1d7 100644 --- a/src/render/doc/src/qt3drender-geometry.qdoc +++ b/src/doc/src/qt3drender-geometry.qdoc @@ -54,7 +54,7 @@ \li \l {GeometryRenderer} \endlist - \section2 Buffer Object + \section2 Buffer The Qt3DRender::QBuffer class stores the raw data. This acts purely as an array of memory. In most cases a Qt3DRender::QBuffer will be used @@ -71,7 +71,7 @@ } \endcode - \section2 Attribute Object + \section2 Attribute Qt3DRender::QAttribute specifies how data contained in the referenced buffer should be extracted and passed to an input of a vertex shader. It @@ -97,7 +97,7 @@ } \endcode - \section2 Geometry Object + \section2 Geometry A Qt3DRender::QGeometry aggregates various attributes to form a piece of geometry. Usually a proper geometry will provide an attribute for vertex @@ -131,7 +131,7 @@ } \endcode - \section2 GeometryRenderer Object + \section2 GeometryRenderer Qt3DRender::QGeometryRenderer is a QComponent which when aggregated by a QEntity allows to draw the Qt3DRender::QGeometry it references. It provides diff --git a/src/render/doc/src/qt3drender-module.qdoc b/src/doc/src/qt3drender-module.qdoc index 3a7a6f6bb..fabdd4220 100644 --- a/src/render/doc/src/qt3drender-module.qdoc +++ b/src/doc/src/qt3drender-module.qdoc @@ -40,7 +40,6 @@ /*! \module Qt3DRender \title Qt 3D Render C++ Classes - \keyword Qt 3D Render \brief The Qt 3D Render module contains functionality to support 2D and 3D rendering using Qt 3D. \since 5.7 @@ -101,6 +100,4 @@ \badcode import Qt3D.Render 2.0 \endcode - - \section1 QML Types */ diff --git a/src/render/doc/src/qt3drender-protips.qdoc b/src/doc/src/qt3drender-protips.qdoc index 801c4a993..c78f3d598 100644 --- a/src/render/doc/src/qt3drender-protips.qdoc +++ b/src/doc/src/qt3drender-protips.qdoc @@ -49,6 +49,13 @@ stages you may end up, in the best cases with something different than what you expected, in the worst cases with a black screen. + \list + \li \l {Technique Selection} + \li \l {Order Matters} + \li \l {Blending} + \li \l {Useful Tools} + \endlist + \section2 Technique Selection Qt 3D provides a technique selection mechanism allowing you to provide @@ -74,10 +81,10 @@ \list \li Filtering with a Qt3DRender::QLayer component and - Qt3DRender::QLayerFilter in the FrameGraph. + Qt3DRender::QLayerFilter in the FrameGraph \li RenderPass or Technique filtering using Qt3DRender::QRenderPassFilter - or Qt3DRender::QTechniqueFilter in the FrameGraph. + or Qt3DRender::QTechniqueFilter in the FrameGraph \endlist @@ -107,17 +114,17 @@ Given the rather limited of troubleshooting given by Qt 3D in its first versions it sometimes helps to have tools to capture OpenGL draw calls and - get more clues about what's happening: + get more clues about what's happening \list \li \l {https://github.com/apitrace/apitrace}{apitrace} \li \l {https://github.com/ValveSoftware/vogl}{vogl} \endlist - These tools allow you to gather traces of all OpenGL calls being made + These tools allow you to gather traces of all the OpenGL calls being made by a Qt 3D application. Having a look at a generated trace file may help - you verify that draw calls are being made, textures are correctly uploaded, - uniforms are set with proper values, and so on. + you verify that draw calls are being made, textures correctly uploaded, + uniforms set with proper values, ... There are plans for Qt 3D tooling in later releases. */ diff --git a/src/quick3d/quick3dscene2d/doc/src/qt3dscene2d-module.qdoc b/src/doc/src/qt3dscene2d-module.qdoc index 8809f469a..400b8b19f 100644 --- a/src/quick3d/quick3dscene2d/doc/src/qt3dscene2d-module.qdoc +++ b/src/doc/src/qt3dscene2d-module.qdoc @@ -94,6 +94,4 @@ \badcode import Qt3D.Scene2D 2.9 \endcode - - \section1 QML Types */ diff --git a/src/doc/src/qt3dscene3d-module.qdoc b/src/doc/src/qt3dscene3d-module.qdoc new file mode 100644 index 000000000..08cf2d371 --- /dev/null +++ b/src/doc/src/qt3dscene3d-module.qdoc @@ -0,0 +1,54 @@ +/**************************************************************************** +** +** Copyright (C) 2018 The Qt Company Ltd and/or its subsidiary(-ies). +** Contact: https://www.qt.io/licensing/ +** +** This file is part of the Qt3D module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL$ +** 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 https://www.qt.io/terms-conditions. For further +** information use the contact form at https://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.LGPL3 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-3.0.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 (at your option) the GNU General +** Public license version 3 or any later version approved by the KDE Free +** Qt Foundation. The licenses are as published by the Free Software +** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 +** included in the packaging of this file. Please review the following +** information to ensure the GNU General Public License requirements will +** be met: https://www.gnu.org/licenses/gpl-2.0.html and +** https://www.gnu.org/licenses/gpl-3.0.html. +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +/*! + \qmlmodule Qt3D.Scene3D 2.0 + \preliminary + \title Qt 3D Scene3D QML Types + \ingroup qmlmodules + \ingroup qt3d-qmlmodules-preliminary + + \brief Provides Qt 3D QML types for the Scene3D module. + + To import and use the module's QML types, use the following statement: + + \badcode + import Qt3D.Scene3D 2.0 + \endcode +*/ diff --git a/src/extras/defaults/qabstractcameracontroller.cpp b/src/extras/defaults/qabstractcameracontroller.cpp index 2ebf187aa..527ee7e8d 100644 --- a/src/extras/defaults/qabstractcameracontroller.cpp +++ b/src/extras/defaults/qabstractcameracontroller.cpp @@ -62,6 +62,7 @@ QAbstractCameraControllerPrivate::QAbstractCameraControllerPrivate() , m_rightMouseButtonAction(new Qt3DInput::QAction()) , m_altButtonAction(new Qt3DInput::QAction()) , m_shiftButtonAction(new Qt3DInput::QAction()) + , m_escapeButtonAction(new Qt3DInput::QAction()) , m_rxAxis(new Qt3DInput::QAxis()) , m_ryAxis(new Qt3DInput::QAxis()) , m_txAxis(new Qt3DInput::QAxis()) @@ -72,6 +73,7 @@ QAbstractCameraControllerPrivate::QAbstractCameraControllerPrivate() , m_rightMouseButtonInput(new Qt3DInput::QActionInput()) , m_altButtonInput(new Qt3DInput::QActionInput()) , m_shiftButtonInput(new Qt3DInput::QActionInput()) + , m_escapeButtonInput(new Qt3DInput::QActionInput()) , m_mouseRxInput(new Qt3DInput::QAnalogAxisInput()) , m_mouseRyInput(new Qt3DInput::QAnalogAxisInput()) , m_mouseTzXInput(new Qt3DInput::QAnalogAxisInput()) @@ -122,6 +124,11 @@ void QAbstractCameraControllerPrivate::init() m_shiftButtonInput->setSourceDevice(m_keyboardDevice); m_shiftButtonAction->addInput(m_shiftButtonInput); + // Escape Button Action + m_escapeButtonInput->setButtons(QVector<int>() << Qt::Key_Escape); + m_escapeButtonInput->setSourceDevice(m_keyboardDevice); + m_escapeButtonAction->addInput(m_escapeButtonInput); + //// Axes // Mouse X @@ -187,6 +194,7 @@ void QAbstractCameraControllerPrivate::init() m_logicalDevice->addAction(m_rightMouseButtonAction); m_logicalDevice->addAction(m_altButtonAction); m_logicalDevice->addAction(m_shiftButtonAction); + m_logicalDevice->addAction(m_escapeButtonAction); m_logicalDevice->addAxis(m_rxAxis); m_logicalDevice->addAxis(m_ryAxis); m_logicalDevice->addAxis(m_txAxis); @@ -202,6 +210,13 @@ void QAbstractCameraControllerPrivate::init() QObject::connect(q, &Qt3DCore::QEntity::enabledChanged, m_logicalDevice, &Qt3DInput::QLogicalDevice::setEnabled); + + QObject::connect(m_escapeButtonAction, &Qt3DInput::QAction::activeChanged, + q, [this](bool isActive) { + if (isActive && m_camera) + m_camera->viewAll(); + }); + q->addComponent(m_frameAction); q->addComponent(m_logicalDevice); } @@ -242,7 +257,7 @@ void QAbstractCameraControllerPrivate::applyInputAccelerations() */ /*! - \fn void QAbstractCameraController::moveCamera(const InputState &state, float dt) = 0 + \fn void Qt3DExtras::QAbstractCameraController::moveCamera(const InputState &state, float dt) = 0 This method is called whenever a frame action is triggered. Derived classes must override this method to implement the camera movement @@ -290,7 +305,7 @@ QAbstractCameraController::~QAbstractCameraController() } /*! - \property QAbstractCameraController::camera + \property Qt3DExtras::QAbstractCameraController::camera Holds the currently controlled camera. */ @@ -301,12 +316,12 @@ Qt3DRender::QCamera *QAbstractCameraController::camera() const } /*! - \property QAbstractCameraController::linearSpeed + \property Qt3DExtras::QAbstractCameraController::linearSpeed Holds the current linear speed of the camera controller. Linear speed determines the movement speed of the camera. - The default is 10.0. + The default is \c {10.0}. */ float QAbstractCameraController::linearSpeed() const { @@ -315,12 +330,12 @@ float QAbstractCameraController::linearSpeed() const } /*! - \property QAbstractCameraController::lookSpeed + \property Qt3DExtras::QAbstractCameraController::lookSpeed Holds the current look speed of the camera controller. The look speed determines the turn rate of the camera pan and tilt. - The default is 180.0. + The default is \c {180.0}. */ float QAbstractCameraController::lookSpeed() const { @@ -329,7 +344,7 @@ float QAbstractCameraController::lookSpeed() const } /*! - \property QAbstractCameraController::acceleration + \property Qt3DExtras::QAbstractCameraController::acceleration Holds the current acceleration of the camera controller. */ @@ -340,7 +355,7 @@ float QAbstractCameraController::acceleration() const } /*! - \property QAbstractCameraController::deceleration + \property Qt3DExtras::QAbstractCameraController::deceleration Holds the current deceleration of the camera controller. */ diff --git a/src/extras/defaults/qabstractcameracontroller_p.h b/src/extras/defaults/qabstractcameracontroller_p.h index 00424a55b..51f66cb3d 100644 --- a/src/extras/defaults/qabstractcameracontroller_p.h +++ b/src/extras/defaults/qabstractcameracontroller_p.h @@ -92,6 +92,7 @@ public: Qt3DInput::QAction *m_rightMouseButtonAction; Qt3DInput::QAction *m_altButtonAction; Qt3DInput::QAction *m_shiftButtonAction; + Qt3DInput::QAction *m_escapeButtonAction; Qt3DInput::QAxis *m_rxAxis; Qt3DInput::QAxis *m_ryAxis; @@ -104,6 +105,7 @@ public: Qt3DInput::QActionInput *m_rightMouseButtonInput; Qt3DInput::QActionInput *m_altButtonInput; Qt3DInput::QActionInput *m_shiftButtonInput; + Qt3DInput::QActionInput *m_escapeButtonInput; Qt3DInput::QAnalogAxisInput *m_mouseRxInput; Qt3DInput::QAnalogAxisInput *m_mouseRyInput; diff --git a/src/extras/defaults/qfirstpersoncameracontroller.cpp b/src/extras/defaults/qfirstpersoncameracontroller.cpp index 0561bbc37..50015225c 100644 --- a/src/extras/defaults/qfirstpersoncameracontroller.cpp +++ b/src/extras/defaults/qfirstpersoncameracontroller.cpp @@ -73,6 +73,9 @@ namespace Qt3DExtras { \row \li Page up and page down keys \li Move the camera vertically relative to camera viewport. + \row + \li Escape + \li Moves the camera so that entire scene is visible in the camera viewport. \endtable */ diff --git a/src/extras/defaults/qorbitcameracontroller.cpp b/src/extras/defaults/qorbitcameracontroller.cpp index 61b930569..6d3e83bcb 100644 --- a/src/extras/defaults/qorbitcameracontroller.cpp +++ b/src/extras/defaults/qorbitcameracontroller.cpp @@ -90,6 +90,9 @@ QOrbitCameraControllerPrivate::QOrbitCameraControllerPrivate() \li Alt key \li Changes the behovior of the arrow keys to pan and tilt the camera around the view center. Disables the page up and page down keys. + \row + \li Escape + \li Moves the camera so that entire scene is visible in the camera viewport. \endtable */ diff --git a/src/extras/doc/qt3dextras.qdocconf b/src/extras/doc/qt3dextras.qdocconf deleted file mode 100644 index 470a80450..000000000 --- a/src/extras/doc/qt3dextras.qdocconf +++ /dev/null @@ -1,43 +0,0 @@ -include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf) -include(../../doc/qt3d-config.qdocconf) - -project = Qt3DExtras -description = Qt 3D Extras Reference Documentation -version = $QT_VERSION - -qhp.projects = Qt3DExtras - -qhp.Qt3DExtras.file = qt3dextras.qhp -qhp.Qt3DExtras.namespace = org.qt-project.qt3dextras.$QT_VERSION_TAG -qhp.Qt3DExtras.virtualFolder = qt3dextras -qhp.Qt3DExtras.indexTitle = Qt 3D Extras -qhp.Qt3DExtras.indexRoot = - -qhp.Qt3DExtras.filterAttributes = qt3dextras $QT_VERSION qtrefdoc -qhp.Qt3DExtras.customFilters.Qt.name = Qt3DExtras $QT_VERSION -qhp.Qt3DExtras.customFilters.Qt.filterAttributes = qt3dextras $QT_VERSION - -qhp.Qt3DExtras.subprojects = classes qmltypes - -qhp.Qt3DExtras.subprojects.classes.title = C++ Classes -qhp.Qt3DExtras.subprojects.classes.indexTitle = Qt 3D Extras C++ Classes -qhp.Qt3DExtras.subprojects.classes.selectors = class doc:headerfile -qhp.Qt3DExtras.subprojects.classes.sortPages = true - -qhp.Qt3DExtras.subprojects.qmltypes.title = QML Types -qhp.Qt3DExtras.subprojects.qmltypes.indexTitle = Qt 3D Extras QML Types -qhp.Qt3DExtras.subprojects.qmltypes.selectors = qmltype -qhp.Qt3DExtras.subprojects.qmltypes.sortPages = true - -tagfile = qt3dextras.tags - -depends += qtcore qtgui qtqml qtquick qtdoc qmake - -# dependencies to other Qt 3D modules -depends += qt3d qt3dcore qt3drender qt3dlogic \ - qt3dinput qt3danimation qt3dscene2d - -sourcedirs += .. -headerdirs += .. -imagedirs += images -exampledirs += snippets diff --git a/src/extras/extras.pro b/src/extras/extras.pro index 700d39dea..22c9fcb93 100644 --- a/src/extras/extras.pro +++ b/src/extras/extras.pro @@ -7,8 +7,6 @@ DEFINES += QT3DEXTRAS_LIBRARY # Qt3D is free of Q_FOREACH - make sure it stays that way: DEFINES += QT_NO_FOREACH -QMAKE_DOCS = $$PWD/doc/qt3dextras.qdocconf - load(qt_module) include (geometries/geometries.pri) diff --git a/src/extras/geometries/qplanegeometry.cpp b/src/extras/geometries/qplanegeometry.cpp index 0176accdd..7c77f5028 100644 --- a/src/extras/geometries/qplanegeometry.cpp +++ b/src/extras/geometries/qplanegeometry.cpp @@ -284,13 +284,14 @@ public: * \brief The QPlaneGeometry class allows creation of a plane in 3D space. * \since 5.7 * \ingroup geometries - * \inherits Qt3DRender::QGeometry * * The QPlaneGeometry class is most commonly used internally by the QPlaneMesh * but can also be used in custom Qt3DRender::QGeometryRenderer subclasses. */ /*! + * \fn Qt3DExtras::QPlaneGeometry::QPlaneGeometry(QNode *parent) + * * Constructs a new QPlaneGeometry with \a parent. */ QPlaneGeometry::QPlaneGeometry(QPlaneGeometry::QNode *parent) diff --git a/src/input/doc/qt3dinput.qdocconf b/src/input/doc/qt3dinput.qdocconf deleted file mode 100644 index 6ca49d09a..000000000 --- a/src/input/doc/qt3dinput.qdocconf +++ /dev/null @@ -1,43 +0,0 @@ -include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf) -include(../../doc/qt3d-config.qdocconf) - -project = Qt3DInput -description = Qt 3D Input Reference Documentation -version = $QT_VERSION - -qhp.projects = Qt3DInput - -qhp.Qt3DInput.file = qt3dinput.qhp -qhp.Qt3DInput.namespace = org.qt-project.qt3dinput.$QT_VERSION_TAG -qhp.Qt3DInput.virtualFolder = qt3dinput -qhp.Qt3DInput.indexTitle = Qt 3D Input -qhp.Qt3DInput.indexRoot = - -qhp.Qt3DInput.filterAttributes = qt3dinput $QT_VERSION qtrefdoc -qhp.Qt3DInput.customFilters.Qt.name = Qt3DInput $QT_VERSION -qhp.Qt3DInput.customFilters.Qt.filterAttributes = qt3dinput $QT_VERSION - -qhp.Qt3DInput.subprojects = classes qmltypes - -qhp.Qt3DInput.subprojects.classes.title = C++ Classes -qhp.Qt3DInput.subprojects.classes.indexTitle = Qt 3D Input C++ Classes -qhp.Qt3DInput.subprojects.classes.selectors = class doc:headerfile -qhp.Qt3DInput.subprojects.classes.sortPages = true - -qhp.Qt3DInput.subprojects.qmltypes.title = QML Types -qhp.Qt3DInput.subprojects.qmltypes.indexTitle = Qt 3D Input QML Types -qhp.Qt3DInput.subprojects.qmltypes.selectors = qmltype -qhp.Qt3DInput.subprojects.qmltypes.sortPages = true - -tagfile = qt3dinput.tags - -depends += qtcore qtgui qtqml qtquick qtdoc qmake - -# dependencies to other Qt 3D modules -depends += qt3d qt3dcore qt3drender qt3dlogic \ - qt3dextras qt3danimation qt3dscene2d - -sourcedirs += .. -headerdirs += .. -imagedirs += images -exampledirs += snippets diff --git a/src/input/frontend/qabstractphysicaldevice.cpp b/src/input/frontend/qabstractphysicaldevice.cpp index dc54228d4..120ec43a2 100644 --- a/src/input/frontend/qabstractphysicaldevice.cpp +++ b/src/input/frontend/qabstractphysicaldevice.cpp @@ -196,7 +196,7 @@ void QAbstractPhysicalDevice::removeAxisSetting(QAxisSetting *axisSetting) } /*! - \return the axisSettings associated with this device. + Returns the axisSettings associated with this device. */ QVector<QAxisSetting *> QAbstractPhysicalDevice::axisSettings() const { @@ -204,7 +204,7 @@ QVector<QAxisSetting *> QAbstractPhysicalDevice::axisSettings() const return d->m_axisSettings; } -/*! +/* Used to notify observers that an axis value has been changed. */ void QAbstractPhysicalDevicePrivate::postAxisEvent(int axis, qreal value) @@ -216,7 +216,7 @@ void QAbstractPhysicalDevicePrivate::postAxisEvent(int axis, qreal value) notifyObservers(change); } -/*! +/* Used to notify observers that an button value has been changed. */ void QAbstractPhysicalDevicePrivate::postButtonEvent(int button, qreal value) diff --git a/src/input/frontend/qactioninput.cpp b/src/input/frontend/qactioninput.cpp index b8db101d8..9f32f57cc 100644 --- a/src/input/frontend/qactioninput.cpp +++ b/src/input/frontend/qactioninput.cpp @@ -118,7 +118,7 @@ QVector<int> QActionInput::buttons() const The current source device of the QActionInput. */ /*! - \fn QActionInput::sourceDeviceChanged(QAbstractPhysicalDevice *sourceDevice) + \fn Qt3DInput::QActionInput::sourceDeviceChanged(QAbstractPhysicalDevice *sourceDevice) This signal is emitted when the source device associated with the action input is changed to \a sourceDevice. */ @@ -166,7 +166,7 @@ QAbstractPhysicalDevice *QActionInput::sourceDevice() const } /*! - \fn QActionInput::buttonsChanged(const QVector<int> &buttons) + \fn Qt3DInput::QActionInput::buttonsChanged(const QVector<int> &buttons) This signal is emitted when the buttons associated with the action input is changed. The buttons changed are \a buttons diff --git a/src/input/frontend/qaxissetting.cpp b/src/input/frontend/qaxissetting.cpp index 8f1a8d797..4a8f37785 100644 --- a/src/input/frontend/qaxissetting.cpp +++ b/src/input/frontend/qaxissetting.cpp @@ -128,7 +128,7 @@ bool QAxisSetting::isSmoothEnabled() const /*! - \fn QAxisSetting::deadZoneRadiusChanged(float deadZoneRadius) + \fn Qt3DInput::QAxisSetting::deadZoneRadiusChanged(float deadZoneRadius) This signal is emitted when the Dead Zone radius associated with the axis setting is changed to \a deadZoneRadius. */ @@ -161,7 +161,7 @@ void QAxisSetting::setDeadZoneRadius(float deadZoneRadius) } /*! - \fn QAxisSetting::axesChanged(const QVector<int> &axes) + \fn Qt3DInput::QAxisSetting::axesChanged(const QVector<int> &axes) This signal is emitted when the axes associated with the axis setting is changed to \a axes. */ @@ -194,7 +194,7 @@ void QAxisSetting::setAxes(const QVector<int> &axes) } /*! - \fn QAxisSetting::smoothChanged(bool smooth) + \fn Qt3DInput::QAxisSetting::smoothChanged(bool smooth) This signal is emitted when the smoothing state is changed to \a smooth. */ diff --git a/src/input/frontend/qinputaspect.cpp b/src/input/frontend/qinputaspect.cpp index b37e32d43..1bc57579f 100644 --- a/src/input/frontend/qinputaspect.cpp +++ b/src/input/frontend/qinputaspect.cpp @@ -172,7 +172,7 @@ QInputAspect::~QInputAspect() { } -/*! +/* Create each of the detected input device integrations through the Integration Factory */ void QInputAspectPrivate::loadInputDevicePlugins() @@ -193,10 +193,10 @@ void QInputAspectPrivate::loadInputDevicePlugins() /*! Create a physical device identified by \a name using the input device integrations present - returns a nullptr if it is not found. - \note caller is responsible for ownership + returns a \c nullptr if it is not found. + + \note Caller is responsible for ownership. */ -// Note: caller is responsible for ownership QAbstractPhysicalDevice *QInputAspect::createPhysicalDevice(const QString &name) { Q_D(QInputAspect); @@ -204,7 +204,7 @@ QAbstractPhysicalDevice *QInputAspect::createPhysicalDevice(const QString &name) } /*! - \return a list of all available physical devices. + Returns a list of all available physical devices. */ QStringList QInputAspect::availablePhysicalDevices() const { diff --git a/src/input/frontend/qinputdeviceintegration.cpp b/src/input/frontend/qinputdeviceintegration.cpp index 5140776bf..2fd3f45ed 100644 --- a/src/input/frontend/qinputdeviceintegration.cpp +++ b/src/input/frontend/qinputdeviceintegration.cpp @@ -61,7 +61,7 @@ QInputDeviceIntegrationPrivate::QInputDeviceIntegrationPrivate() */ /*! - Create a new QInputDeviceIntegration with parent /a parent + Creates a new QInputDeviceIntegration with \a parent. */ QInputDeviceIntegration::QInputDeviceIntegration(QObject *parent) : QObject(*new QInputDeviceIntegrationPrivate, parent) @@ -75,7 +75,8 @@ QInputDeviceIntegration::QInputDeviceIntegration(QInputDeviceIntegrationPrivate } /*! - Register a corresponding backend class for this front end implementation + Registers a corresponding backend class for this front end implementation + with \a metaObject and \a functor. */ void QInputDeviceIntegration::registerBackendType(const QMetaObject &metaObject, const Qt3DCore::QBackendNodeMapperPtr &functor) { @@ -84,7 +85,7 @@ void QInputDeviceIntegration::registerBackendType(const QMetaObject &metaObject, } /*! - Called by the InputAspect object after the Integration has been created + Called by the InputAspect object after the integration has been created with \a aspect. */ void QInputDeviceIntegration::initialize(QInputAspect *aspect) { @@ -106,7 +107,7 @@ QInputAspect *QInputDeviceIntegration::inputAspect() const } // namespace Qt3DInput /*! - \fn QInputDeviceIntegration::createPhysicalDevice(const QString &name) + \fn Qt3DInput::QInputDeviceIntegration::createPhysicalDevice(const QString &name) Create the Physical device identified by \a name. @@ -114,15 +115,15 @@ QInputAspect *QInputDeviceIntegration::inputAspect() const */ /*! - \fn QInputDeviceIntegration::physicalDevices() const + \fn Qt3DInput::QInputDeviceIntegration::physicalDevices() const - \return the list of node ids for physical devices associated with this QInputDeviceIntegration. + Returns the list of node ids for physical devices associated with this QInputDeviceIntegration. */ /*! - \fn QInputDeviceIntegration::physicalDevice(Qt3DCore::QNodeId id) const + \fn Qt3DInput::QInputDeviceIntegration::physicalDevice(Qt3DCore::QNodeId id) const - \return the QAbstractPhysicalDevice identified by the given id if it is related to this QInputDeviceIntegration. + Returns the QAbstractPhysicalDevice identified by the given \a id if it is related to this QInputDeviceIntegration. */ QT_END_NAMESPACE diff --git a/src/input/frontend/qkeyboardhandler.cpp b/src/input/frontend/qkeyboardhandler.cpp index c13939c04..2741288ef 100644 --- a/src/input/frontend/qkeyboardhandler.cpp +++ b/src/input/frontend/qkeyboardhandler.cpp @@ -192,7 +192,7 @@ void QKeyboardHandler::sceneChangeEvent(const Qt3DCore::QSceneChangePtr &change) */ /*! - \property QKeyboardHandler::sourceDevice + \property Qt3DInput::QKeyboardHandler::sourceDevice Holds the keyboard device of the QKeyboardHandler. Without a valid device, the QKeyboardHandler won't receive any event. @@ -232,7 +232,7 @@ QKeyboardDevice *QKeyboardHandler::sourceDevice() const */ /*! - \property QKeyboardHandler::focus + \property Qt3DInput::QKeyboardHandler::focus Holds \c true if the QKeyboardHandlers has focus. */ @@ -269,410 +269,484 @@ Qt3DCore::QNodeCreatedChangeBasePtr QKeyboardHandler::createNodeCreationChange() /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit0Pressed(KeyEvent event) - This signal is emitted when the 0 key is pressed with the event details being contained within \a event + + This signal is emitted when the 0 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit1Pressed(KeyEvent event) - This signal is emitted when the 1 key is pressed with the event details being contained within \a event + + This signal is emitted when the 1 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit2Pressed(KeyEvent event) - This signal is emitted when the 2 key is pressed with the event details being contained within \a event + + This signal is emitted when the 2 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit3Pressed(KeyEvent event) - This signal is emitted when the 3 key is pressed with the event details being contained within \a event + + This signal is emitted when the 3 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit4Pressed(KeyEvent event) - This signal is emitted when the 4 key is pressed with the event details being contained within \a event + + This signal is emitted when the 4 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit5Pressed(KeyEvent event) - This signal is emitted when the 5 key is pressed with the event details being contained within \a event + + This signal is emitted when the 5 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit6Pressed(KeyEvent event) - This signal is emitted when the 6 key is pressed with the event details being contained within \a event + + This signal is emitted when the 6 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit7Pressed(KeyEvent event) - This signal is emitted when the 7 key is pressed with the event details being contained within \a event + + This signal is emitted when the 7 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit8Pressed(KeyEvent event) - This signal is emitted when the 8 key is pressed with the event details being contained within \a event + + This signal is emitted when the 8 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::digit9Pressed(KeyEvent event) - This signal is emitted when the 9 key is pressed with the event details being contained within \a event + + This signal is emitted when the 9 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::leftPressed(KeyEvent event) - This signal is emitted when the left key is pressed with the event details being contained within \a event + + This signal is emitted when the left key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::rightPressed(KeyEvent event) + This signal is emitted when the right key is pressed with the event details being contained within \a event */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::upPressed(KeyEvent event) - This signal is emitted when the up key is pressed with the event details being contained within \a event + + This signal is emitted when the up key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::downPressed(KeyEvent event) - This signal is emitted when the down key is pressed with the event details being contained within \a event + + This signal is emitted when the down key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::tabPressed(KeyEvent event) - This signal is emitted when the tab key is pressed with the event details being contained within \a event + + This signal is emitted when the tab key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::backtabPressed(KeyEvent event) - This signal is emitted when the backtab key is pressed with the event details being contained within \a event + + This signal is emitted when the backtab key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::asteriskPressed(KeyEvent event) - This signal is emitted when the * key is pressed with the event details being contained within \a event + + This signal is emitted when the * key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::numberSignPressed(KeyEvent event) - This signal is emitted when the number sign key is pressed with the event details being contained within \a event + This signal is emitted when the number sign key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::escapePressed(KeyEvent event) - This signal is emitted when the escape key is pressed with the event details being contained within \a event + This signal is emitted when the escape key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::returnPressed(KeyEvent event) - This signal is emitted when the return key is pressed with the event details being contained within \a event + + This signal is emitted when the return key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::enterPressed(KeyEvent event) - This signal is emitted when the enter key is pressed with the event details being contained within \a event + This signal is emitted when the enter key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::deletePressed(KeyEvent event) - This signal is emitted when the delete key is pressed with the event details being contained within \a event + + This signal is emitted when the delete key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::spacePressed(KeyEvent event) - This signal is emitted when the space key is pressed with the event details being contained within \a event + + This signal is emitted when the space key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::backPressed(KeyEvent event) - This signal is emitted when the back key is pressed with the event details being contained within \a event + + This signal is emitted when the back key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::cancelPressed(KeyEvent event) - This signal is emitted when the cancel key is pressed with the event details being contained within \a event + + This signal is emitted when the cancel key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::selectPressed(KeyEvent event) - This signal is emitted when the select key is pressed with the event details being contained within \a event + + This signal is emitted when the select key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::yesPressed(KeyEvent event) - This signal is emitted when the yes key is pressed with the event details being contained within \a event + + This signal is emitted when the yes key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::noPressed(KeyEvent event) - This signal is emitted when the yes key is pressed with the event details being contained within \a event + + This signal is emitted when the yes key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::context1Pressed(KeyEvent event) - This signal is emitted when the context 1 key is pressed with the event details being contained within \a event + + This signal is emitted when the context 1 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::context2Pressed(KeyEvent event) - This signal is emitted when the context 2 key is pressed with the event details being contained within \a event + + This signal is emitted when the context 2 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::context3Pressed(KeyEvent event) - This signal is emitted when the context 2 key is pressed with the event details being contained within \a event + + This signal is emitted when the context 2 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::context4Pressed(KeyEvent event) - This signal is emitted when the context 4 key is pressed with the event details being contained within \a event + + This signal is emitted when the context 4 key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::callPressed(KeyEvent event) - This signal is emitted when the call key is pressed with the event details being contained within \a event + + This signal is emitted when the call key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::hangupPressed(KeyEvent event) - This signal is emitted when the hangup key is pressed with the event details being contained within \a event + + This signal is emitted when the hangup key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::flipPressed(KeyEvent event) - This signal is emitted when the flip key is pressed with the event details being contained within \a event + + This signal is emitted when the flip key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::menuPressed(KeyEvent event) - This signal is emitted when the menu key is pressed with the event details being contained within \a event + + This signal is emitted when the menu key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::volumeUpPressed(KeyEvent event) - This signal is emitted when the volume up key is pressed with the event details being contained within \a event + + This signal is emitted when the volume up key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::volumeDownPressed(KeyEvent event) - This signal is emitted when the volume down key is pressed with the event details being contained within \a event + + This signal is emitted when the volume down key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::pressed(KeyEvent event) - This signal is emitted when a key is pressed with the event details being contained within \a event + + This signal is emitted when a key is pressed with the event details being contained within \a event. */ /*! \qmlsignal Qt3D.Input::KeyboardHandler::released(KeyEvent event) - This signal is emitted when a key is released with the event details being contained within \a event + + This signal is emitted when a key is released with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit0Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 0 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit0Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 0 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit1Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 1 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit1Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 1 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit2Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 2 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit2Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 2 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit3Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 3 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit3Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 3 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit4Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 4 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit4Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 4 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit5Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 5 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit5Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 5 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit6Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 6 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit6Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 6 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit7Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 7 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit7Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 7 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit8Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the 8 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::digit8Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the 8 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::digit9Pressed(Qt3DInput::QKeyEvent *event) + \fn Qt3DInput::QKeyboardHandler::digit9Pressed(Qt3DInput::QKeyEvent *event) + This signal is emitted when the 9 key is pressed with the event details being contained within \a event */ /*! - \fn QKeyboardHandler::leftPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the left key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::leftPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the left key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::rightPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the right key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::rightPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the right key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::upPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the up key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::upPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the up key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::downPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the down key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::downPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the down key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::tabPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the tab key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::tabPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the tab key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::backtabPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the backtab key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::backtabPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the backtab key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::asteriskPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the * key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::asteriskPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the * key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::numberSignPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the number sign key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::numberSignPressed(Qt3DInput::QKeyEvent *event) + This signal is emitted when the number sign key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::escapePressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the escape key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::escapePressed(Qt3DInput::QKeyEvent *event) + This signal is emitted when the escape key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::returnPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the return key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::returnPressed(Qt3DInput::QKeyEvent *event) + This signal is emitted when the return key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::enterPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the enter key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::enterPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the enter key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::deletePressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the delete key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::deletePressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the delete key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::spacePressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the space key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::spacePressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the space key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::backPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the back key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::backPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the back key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::cancelPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the cancel key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::cancelPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the cancel key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::selectPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the select key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::selectPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the select key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::yesPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the yes key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::yesPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the yes key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::noPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the yes key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::noPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the yes key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::context1Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the context 1 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::context1Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the context 1 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::context2Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the context 2 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::context2Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the context 2 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::context3Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the context 2 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::context3Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the context 2 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::context4Pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the context 4 key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::context4Pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the context 4 key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::callPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the call key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::callPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the call key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::hangupPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the hangup key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::hangupPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the hangup key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::flipPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the flip key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::flipPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the flip key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::menuPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the menu key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::menuPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the menu key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::volumeUpPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the volume up key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::volumeUpPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the volume up key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::volumeDownPressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when the volume down key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::volumeDownPressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when the volume down key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::pressed(Qt3DInput::QKeyEvent *event) - This signal is emitted when a key is pressed with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::pressed(Qt3DInput::QKeyEvent *event) + + This signal is emitted when a key is pressed with the event details being contained within \a event. */ /*! - \fn QKeyboardHandler::released(Qt3DInput::QKeyEvent *event) - This signal is emitted when a key is released with the event details being contained within \a event + \fn Qt3DInput::QKeyboardHandler::released(Qt3DInput::QKeyEvent *event) + + This signal is emitted when a key is released with the event details being contained within \a event. */ } // namespace Qt3DInput diff --git a/src/input/frontend/qkeyevent.cpp b/src/input/frontend/qkeyevent.cpp index 2d9226c4e..a70a2970b 100644 --- a/src/input/frontend/qkeyevent.cpp +++ b/src/input/frontend/qkeyevent.cpp @@ -167,7 +167,7 @@ QKeyEvent::~QKeyEvent() */ /*! - \property QKeyEvent::key + \property Qt3DInput::QKeyEvent::key \readonly This property holds the code of the key that was pressed or released. @@ -178,7 +178,7 @@ QKeyEvent::~QKeyEvent() */ /*! - \property QKeyEvent::text + \property Qt3DInput::QKeyEvent::text \readonly This property holds the Unicode text that the key generated. The text @@ -188,7 +188,7 @@ QKeyEvent::~QKeyEvent() */ /*! - \property QKeyEvent::modifiers + \property Qt3DInput::QKeyEvent::modifiers \readonly This property holds the keyboard modifier flags that existed immediately @@ -198,14 +198,14 @@ QKeyEvent::~QKeyEvent() */ /*! - \property QKeyEvent::isAutoRepeat + \property Qt3DInput::QKeyEvent::isAutoRepeat \readonly Holds whether this event comes from an auto-repeating key. */ /*! - \property QKeyEvent::count + \property Qt3DInput::QKeyEvent::count \readonly Holds the number of keys involved in this event. If \l text is not empty, @@ -213,7 +213,7 @@ QKeyEvent::~QKeyEvent() */ /*! - \property QKeyEvent::nativeScanCode + \property Qt3DInput::QKeyEvent::nativeScanCode \readonly This property contains the native scan code of the key that was pressed. @@ -222,7 +222,7 @@ QKeyEvent::~QKeyEvent() */ /*! - \property QKeyEvent::accepted + \property Qt3DInput::QKeyEvent::accepted Setting \e accepted to \c true prevents the key event from being propagated to the item's parent. @@ -232,17 +232,17 @@ QKeyEvent::~QKeyEvent() */ /*! - \fn bool QKeyEvent::matches(QKeySequence::StandardKey key_) const + \fn bool Qt3DInput::QKeyEvent::matches(QKeySequence::StandardKey key_) const - \return \c true if the key event matches the given standard key \a key_; otherwise + Returns \c true if the key event matches the given standard key \a key_; otherwise returns \c false. \sa QKeySequence::StandardKey */ /*! - \fn QEvent::Type QKeyEvent::type() const - \return the type of event + \fn QEvent::Type Qt3DInput::QKeyEvent::type() const + Returns the type of the event. */ diff --git a/src/input/frontend/qmousehandler.cpp b/src/input/frontend/qmousehandler.cpp index 895cbc49a..824e30492 100644 --- a/src/input/frontend/qmousehandler.cpp +++ b/src/input/frontend/qmousehandler.cpp @@ -89,7 +89,7 @@ void QMouseHandlerPrivate::mouseEvent(const QMouseEventPtr &event) emit q->released(event.data()); break; #if QT_CONFIG(gestures) - case Qt::TapGesture: + case QEvent::Gesture: emit q->clicked(event.data()); break; #endif @@ -202,57 +202,57 @@ void QMouseHandlerPrivate::mouseEvent(const QMouseEventPtr &event) */ /*! - \fn QMouseHandler::clicked(Qt3DInput::QMouseEvent *mouse) + \fn Qt3DInput::QMouseHandler::clicked(Qt3DInput::QMouseEvent *mouse) This signal is emitted when a mouse button is clicked with the event details being contained within \a mouse */ /*! - \fn QMouseHandler::doubleClicked(Qt3DInput::QMouseEvent *mouse) + \fn Qt3DInput::QMouseHandler::doubleClicked(Qt3DInput::QMouseEvent *mouse) This signal is emitted when a mouse button is double clicked with the event details being contained within \a mouse */ /*! - \fn QMouseHandler::entered() + \fn Qt3DInput::QMouseHandler::entered() */ /*! - \fn QMouseHandler::exited() + \fn Qt3DInput::QMouseHandler::exited() */ /*! - \fn QMouseHandler::pressed(Qt3DInput::QMouseEvent *mouse) + \fn Qt3DInput::QMouseHandler::pressed(Qt3DInput::QMouseEvent *mouse) This signal is emitted when a mouse button is pressed with the event details being contained within \a mouse */ /*! - \fn QMouseHandler::released(Qt3DInput::QMouseEvent *mouse) + \fn Qt3DInput::QMouseHandler::released(Qt3DInput::QMouseEvent *mouse) This signal is emitted when a mouse button is released with the event details being contained within \a mouse */ /*! - \fn QMouseHandler::pressAndHold(Qt3DInput::QMouseEvent *mouse) + \fn Qt3DInput::QMouseHandler::pressAndHold(Qt3DInput::QMouseEvent *mouse) This signal is emitted when a mouse button is pressed and held down with the event details being contained within \a mouse */ /*! - \fn QMouseHandler::positionChanged(Qt3DInput::QMouseEvent *mouse) + \fn Qt3DInput::QMouseHandler::positionChanged(Qt3DInput::QMouseEvent *mouse) This signal is emitted when the mouse position changes with the event details being contained within \a mouse */ /*! - \fn QMouseHandler::wheel(Qt3DInput::QWheelEvent *wheel) + \fn Qt3DInput::QMouseHandler::wheel(Qt3DInput::QWheelEvent *wheel) This signal is emitted when the mouse wheel is used with the event details being contained within \a wheel @@ -300,7 +300,7 @@ void QMouseHandler::setSourceDevice(QMouseDevice *mouseDevice) } /*! - * \property QMouseHandler::sourceDevice + * \property Qt3DInput::QMouseHandler::sourceDevice * * Holds the current mouse source device of the QMouseHandler instance. */ @@ -311,7 +311,7 @@ QMouseDevice *QMouseHandler::sourceDevice() const } /*! - * \property QMouseHandler::containsMouse + * \property Qt3DInput::QMouseHandler::containsMouse * * Holds \c true if the QMouseHandler currently contains the mouse. * diff --git a/src/input/input.pro b/src/input/input.pro index 7db74cfde..73a571c9f 100644 --- a/src/input/input.pro +++ b/src/input/input.pro @@ -17,6 +17,4 @@ HEADERS += \ qt3dinput_global.h \ qt3dinput_global_p.h -QMAKE_DOCS = $$PWD/doc/qt3dinput.qdocconf - load(qt_module) diff --git a/src/logic/doc/qt3dlogic.qdocconf b/src/logic/doc/qt3dlogic.qdocconf deleted file mode 100644 index 8f7196991..000000000 --- a/src/logic/doc/qt3dlogic.qdocconf +++ /dev/null @@ -1,43 +0,0 @@ -include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf) -include(../../doc/qt3d-config.qdocconf) - -project = Qt3DLogic -description = Qt 3D Logic Reference Documentation -version = $QT_VERSION - -qhp.projects = Qt3DLogic - -qhp.Qt3DLogic.file = qt3dlogic.qhp -qhp.Qt3DLogic.namespace = org.qt-project.qt3dlogic.$QT_VERSION_TAG -qhp.Qt3DLogic.virtualFolder = qt3dlogic -qhp.Qt3DLogic.indexTitle = Qt 3D Logic -qhp.Qt3DLogic.indexRoot = - -qhp.Qt3DLogic.filterAttributes = qt3dlogic $QT_VERSION qtrefdoc -qhp.Qt3DLogic.customFilters.Qt.name = Qt3DLogic $QT_VERSION -qhp.Qt3DLogic.customFilters.Qt.filterAttributes = qt3dlogic $QT_VERSION - -qhp.Qt3DLogic.subprojects = classes qmltypes - -qhp.Qt3DLogic.subprojects.classes.title = C++ Classes -qhp.Qt3DLogic.subprojects.classes.indexTitle = Qt 3D Logic C++ Classes -qhp.Qt3DLogic.subprojects.classes.selectors = class doc:headerfile -qhp.Qt3DLogic.subprojects.classes.sortPages = true - -qhp.Qt3DLogic.subprojects.qmltypes.title = QML Types -qhp.Qt3DLogic.subprojects.qmltypes.indexTitle = Qt 3D Logic QML Types -qhp.Qt3DLogic.subprojects.qmltypes.selectors = qmltype -qhp.Qt3DLogic.subprojects.qmltypes.sortPages = true - -tagfile = qt3dlogic.tags - -depends += qtcore qtgui qtqml qtquick qtdoc qmake - -# dependencies to other Qt 3D modules -depends += qt3d qt3dcore qt3drender qt3dinput \ - qt3dextras qt3danimation qt3dscene2d - -sourcedirs += .. -headerdirs += .. -imagedirs += images -exampledirs += snippets diff --git a/src/logic/logic.pro b/src/logic/logic.pro index 2fd73391c..584b9af4b 100644 --- a/src/logic/logic.pro +++ b/src/logic/logic.pro @@ -13,6 +13,4 @@ gcov { include(logic.pri) -QMAKE_DOCS = $$PWD/doc/qt3dlogic.qdocconf - load(qt_module) diff --git a/src/logic/qframeaction.cpp b/src/logic/qframeaction.cpp index f6ae70516..37a00fc18 100644 --- a/src/logic/qframeaction.cpp +++ b/src/logic/qframeaction.cpp @@ -125,7 +125,7 @@ void QFrameAction::onTriggered(float dt) */ /*! - \fn QFrameAction::triggered(float dt) + \fn Qt3DLogic::QFrameAction::triggered(float dt) This signal is emitted each frame with \a dt being the time since the last triggering. */ } // namespace Qt3DLogic diff --git a/src/plugins/geometryloaders/fbx/fbxgeometryloader.cpp b/src/plugins/geometryloaders/fbx/fbxgeometryloader.cpp index 10870dde8..355096448 100644 --- a/src/plugins/geometryloaders/fbx/fbxgeometryloader.cpp +++ b/src/plugins/geometryloaders/fbx/fbxgeometryloader.cpp @@ -235,7 +235,7 @@ FbxGeometryLoader::~FbxGeometryLoader() } /*! - Give the list of attributes that can be used to render + Gives the list of attributes that can be used to render a 3D form. Returns a pointer to the geometry object. */ @@ -245,7 +245,8 @@ QGeometry *Qt3DRender::FbxGeometryLoader::geometry() const } /*! - Load the specified \a subMesh using device \a ioDev. + Loads the specified \a subMesh using a device \a ioDev. Returns \c true + on success, \c false otherwise. */ bool Qt3DRender::FbxGeometryLoader::load(QIODevice *ioDev, const QString &subMesh) { diff --git a/src/plugins/sceneparsers/assimp/assimpimporter.cpp b/src/plugins/sceneparsers/assimp/assimpimporter.cpp index ad53916fd..fdfc095c6 100644 --- a/src/plugins/sceneparsers/assimp/assimpimporter.cpp +++ b/src/plugins/sceneparsers/assimp/assimpimporter.cpp @@ -128,7 +128,7 @@ const QString TANGENT_ATTRIBUTE_NAME = QAttribute::defaultTangentAttributeName() const QString TEXTCOORD_ATTRIBUTE_NAME = QAttribute::defaultTextureCoordinateAttributeName(); const QString COLOR_ATTRIBUTE_NAME = QAttribute::defaultColorAttributeName(); -/*! +/* * Returns a QMatrix4x4 from \a matrix; */ QMatrix4x4 aiMatrix4x4ToQMatrix4x4(const aiMatrix4x4 &matrix) Q_DECL_NOTHROW @@ -139,7 +139,7 @@ QMatrix4x4 aiMatrix4x4ToQMatrix4x4(const aiMatrix4x4 &matrix) Q_DECL_NOTHROW matrix.d1, matrix.d2, matrix.d3, matrix.d4); } -/*! +/* * Returns a QString from \a str; */ inline QString aiStringToQString(const aiString &str) @@ -168,7 +168,7 @@ QString texturePath(const aiString &path) return p; } -/*! +/* * Returns the Qt3DRender::QParameter with named \a name if contained by the material * \a material. If the material doesn't contain the named parameter, a new * Qt3DRender::QParameter is created and inserted into the material. diff --git a/src/plugins/sceneparsers/gltf/gltfio.cpp b/src/plugins/sceneparsers/gltf/gltfio.cpp index c7c7a00dd..bfe99ab3f 100644 --- a/src/plugins/sceneparsers/gltf/gltfio.cpp +++ b/src/plugins/sceneparsers/gltf/gltfio.cpp @@ -189,7 +189,7 @@ bool GLTFIO::setJSON(const QJsonDocument &json ) return true; } -/*! +/* * Sets the \a path used by the parser to load the scene file. * If the file is valid, parsing is automatically triggered. */ @@ -217,7 +217,7 @@ void GLTFIO::setSource(const QUrl &source) setBasePath(finfo.dir().absolutePath()); } -/*! +/* * Returns true if the extension of \a path is supported by the * GLTF parser. */ diff --git a/src/plugins/sceneparsers/gltf/gltfparser.cpp b/src/plugins/sceneparsers/gltf/gltfparser.cpp index 8d5696b82..881e7f1b2 100644 --- a/src/plugins/sceneparsers/gltf/gltfparser.cpp +++ b/src/plugins/sceneparsers/gltf/gltfparser.cpp @@ -189,7 +189,7 @@ bool GLTFParser::setJSON(const QJsonDocument &json ) return true; } -/*! +/* * Sets the \a path used by the parser to load the scene file. * If the file is valid, parsing is automatically triggered. */ @@ -215,7 +215,7 @@ void GLTFParser::setSource(const QUrl &source) setBasePath(QFileInfo(path).dir().absolutePath()); } -/*! +/* * Returns true if the extension of \a path is supported by the * GLTF parser. */ diff --git a/src/quick3d/imports/scene3d/scene3ditem.cpp b/src/quick3d/imports/scene3d/scene3ditem.cpp index 2c20fa789..740fda294 100644 --- a/src/quick3d/imports/scene3d/scene3ditem.cpp +++ b/src/quick3d/imports/scene3d/scene3ditem.cpp @@ -72,17 +72,33 @@ QT_BEGIN_NAMESPACE namespace Qt3DRender { /*! - \class Qt3DCore::Scene3DItem + \class Qt3DRender::Scene3DItem \internal - \brief The Qt3DCore::Scene3DItem class is a QQuickItem subclass used to integrate + \brief The Scene3DItem class is a QQuickItem subclass used to integrate a Qt3D scene into a QtQuick 2 scene. - The Qt3DCore::Scene3DItem class renders a Qt3D scene, provided by a Qt3DCore::QEntity - into a multisampled Framebuffer object that is later blitted into a non - multisampled Framebuffer object to be then renderer through the use of a + The Scene3DItem class renders a Qt3D scene, provided by a Qt3DCore::QEntity + into a multisampled Framebuffer object that is later blitted into a + non-multisampled Framebuffer object to be then rendered through the use of a Qt3DCore::Scene3DSGNode with premultiplied alpha. */ + +/*! + \qmltype Scene3D + \inherits Item + \inqmlmodule Qt3D.Scene3D + + \preliminary + + \brief The Scene3D type is used to integrate a Qt3D scene into a QtQuick 2 + scene. + + The Scene3D type renders a Qt3D scene, provided by an \l Entity, into a + multisampled Framebuffer object. This object is later blitted into a + non-multisampled Framebuffer object, which is then rendered with + premultiplied alpha. + */ Scene3DItem::Scene3DItem(QQuickItem *parent) : QQuickItem(parent) , m_entity(nullptr) @@ -105,11 +121,23 @@ Scene3DItem::~Scene3DItem() // Scene3DSGNode still exist and will perform their cleanup on their own. } +/*! + \qmlproperty list<string> Scene3D::aspects + + \brief \TODO + */ QStringList Scene3DItem::aspects() const { return m_aspects; } +/*! + \qmlproperty Entity Scene3D::entity + + \default + + \brief \TODO + */ Qt3DCore::QEntity *Scene3DItem::entity() const { return m_entity; @@ -177,6 +205,16 @@ void Scene3DItem::setHoverEnabled(bool enabled) } } +/*! + \qmlproperty enumeration Scene3D::cameraAspectRatioMode + + \value Scene3D.AutomaticAspectRatio + Automatic aspect ratio. + + \value Scene3D.UserAspectRatio + User defined aspect ratio. + \brief \TODO + */ Scene3DItem::CameraAspectRatioMode Scene3DItem::cameraAspectRatioMode() const { return m_cameraAspectRatioMode; @@ -240,7 +278,11 @@ void Scene3DItem::setWindowSurface(QObject *rootObject) } } } +/*! + \qmlmethod void Scene3D::setItemAreaAndDevicePixelRatio(size area, real devicePixelRatio) + \brief \TODO + */ void Scene3DItem::setItemAreaAndDevicePixelRatio(QSize area, qreal devicePixelRatio) { Qt3DRender::QRenderSurfaceSelector *surfaceSelector = Qt3DRender::QRenderSurfaceSelectorPrivate::find(m_entity); @@ -250,6 +292,11 @@ void Scene3DItem::setItemAreaAndDevicePixelRatio(QSize area, qreal devicePixelRa } } +/*! + \qmlproperty bool Scene3D::hoverEnabled + + \c true if hover events are accepted. + */ bool Scene3DItem::isHoverEnabled() const { return acceptHoverEvents(); @@ -280,6 +327,11 @@ void Scene3DItem::updateCameraAspectRatio() } /*! + \qmlproperty bool Scene3D::multisample + + \c true if a multi-sample render buffer is in use. + */ +/*! \return \c true if a multisample renderbuffer is in use. */ bool Scene3DItem::multisample() const diff --git a/src/quick3d/imports/scene3d/scene3drenderer.cpp b/src/quick3d/imports/scene3d/scene3drenderer.cpp index 1c9fec4d2..b3cac0dcd 100644 --- a/src/quick3d/imports/scene3d/scene3drenderer.cpp +++ b/src/quick3d/imports/scene3d/scene3drenderer.cpp @@ -92,17 +92,18 @@ private: }; /*! - \class Qt3DCore::Scene3DRenderer + \class Qt3DRender::Scene3DRenderer \internal - \brief The Qt3DCore::Scene3DRenderer class takes care of rendering a Qt3D scene + \brief The Scene3DRenderer class takes care of rendering a Qt3D scene within a Framebuffer object to be used by the QtQuick 2 renderer. - The Qt3DCore::Scene3DRenderer class renders a Qt3D scene as provided by a Qt3DCore::Scene3DItem. + The Scene3DRenderer class renders a Qt3D scene as provided by a Scene3DItem. It owns the aspectEngine even though it doesn't instantiate it. The shutdown procedure is a two steps process that goes as follow: + \list \li The window is closed \li This triggers the windowsChanged signal which the Scene3DRenderer @@ -112,6 +113,7 @@ private: \li The destroyed signal of the window is also connected to the Scene3DRenderer. When triggered in the context of the main thread, the cleanup slot is called. + \endlist There is an alternate shutdown procedure in case the QQuickItem is destroyed with an active window which can happen in the case where the @@ -146,7 +148,7 @@ Scene3DRenderer::Scene3DRenderer(Scene3DItem *item, Qt3DCore::QAspectEngine *asp // So that we can schedule the cleanup QObject::connect(m_item, &QQuickItem::windowChanged, this, &Scene3DRenderer::onWindowChanged, Qt::QueuedConnection); // Main thread -> updates the rendering window - QObject::connect(m_item, &QQuickItem::windowChanged, [this] (QQuickWindow *w) { + QObject::connect(m_item, &QQuickItem::windowChanged, this, [this] (QQuickWindow *w) { QMutexLocker l(&m_windowMutex); m_window = w; }); diff --git a/src/quick3d/imports/scene3d/scene3dsgmaterial.cpp b/src/quick3d/imports/scene3d/scene3dsgmaterial.cpp index a47d00268..1b8b08a4e 100644 --- a/src/quick3d/imports/scene3d/scene3dsgmaterial.cpp +++ b/src/quick3d/imports/scene3d/scene3dsgmaterial.cpp @@ -44,14 +44,14 @@ QT_BEGIN_NAMESPACE namespace Qt3DRender { /*! - \class Qt3DCore::Scene3DSGMaterial + \class Qt3DRender::Scene3DSGMaterial \internal - \inherit QSGMaterial + \inherits QSGMaterial - \brief The Qt3DRender::Scene3DSGMaterial class is a custom QSGMaterial subclass used to - render a Qt3DRender::Scene3DSGNode + \brief The Scene3DSGMaterial class is a custom QSGMaterial subclass used to + render a Scene3DSGNode - The Qt3DRender::Scene3DSGMaterial class renders a texture using premultiplied + The Scene3DSGMaterial class renders a texture using premultiplied alpha unlike the QSGSimpleTextureMaterial. This is needed to properly integrate alpha blending from a Qt3D scene diff --git a/src/quick3d/quick3d/items/quick3dnodeinstantiator.cpp b/src/quick3d/quick3d/items/quick3dnodeinstantiator.cpp index 21f58e56d..057883edc 100644 --- a/src/quick3d/quick3d/items/quick3dnodeinstantiator.cpp +++ b/src/quick3d/quick3d/items/quick3dnodeinstantiator.cpp @@ -44,6 +44,7 @@ #include <QtQml/QQmlComponent> #include <QtQml/QQmlError> #include <QtQml/QQmlInfo> +#include <QQmlIncubator> #include <Qt3DCore/private/qnode_p.h> #include <QtQml/private/qqmlchangeset_p.h> diff --git a/src/quick3d/quick3dscene2d/doc/qt3dscene2d.qdocconf b/src/quick3d/quick3dscene2d/doc/qt3dscene2d.qdocconf deleted file mode 100644 index 06e67daa5..000000000 --- a/src/quick3d/quick3dscene2d/doc/qt3dscene2d.qdocconf +++ /dev/null @@ -1,45 +0,0 @@ -include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf) -include(../../../doc/qt3d-config.qdocconf) - -project = Qt3DScene2D -description = Qt 3D Scene2D Reference Documentation -version = $QT_VERSION - -qhp.projects = Qt3DScene2D - -qhp.Qt3DScene2D.file = qt3dscene2d.qhp -qhp.Qt3DScene2D.namespace = org.qt-project.qt3dscene2d.$QT_VERSION_TAG -qhp.Qt3DScene2D.virtualFolder = qt3dscene2d -qhp.Qt3DScene2D.indexTitle = Qt 3D Scene2D -qhp.Qt3DScene2D.indexRoot = - -qhp.Qt3DScene2D.filterAttributes = qt3dscene2d $QT_VERSION qtrefdoc -qhp.Qt3DScene2D.customFilters.Qt.name = Qt3DScene2D $QT_VERSION -qhp.Qt3DScene2D.customFilters.Qt.filterAttributes = qt3dscene2d $QT_VERSION - -qhp.Qt3DScene2D.subprojects = classes qmltypes - -qhp.Qt3DScene2D.subprojects.classes.title = C++ Classes -qhp.Qt3DScene2D.subprojects.classes.indexTitle = Qt 3D Scene2D C++ Classes -qhp.Qt3DScene2D.subprojects.classes.selectors = class doc:headerfile -qhp.Qt3DScene2D.subprojects.classes.sortPages = true - -qhp.Qt3DScene2D.subprojects.qmltypes.title = QML Types -qhp.Qt3DScene2D.subprojects.qmltypes.indexTitle = Qt 3D Scene2D QML Types -qhp.Qt3DScene2D.subprojects.qmltypes.selectors = qmltype -qhp.Qt3DScene2D.subprojects.qmltypes.sortPages = true - -tagfile = qt3dscene2d.tags - -depends += qtcore qtgui qtqml qtquick qtdoc qmake - -# dependencies to other Qt 3D modules -depends += qt3d qt3dcore qt3drender qt3dlogic \ - qt3dinput qt3dextras qt3danimation - -sourcedirs += .. - -headerdirs += .. - -imagedirs += images -exampledirs += snippets diff --git a/src/quick3d/quick3dscene2d/items/scene2dmanager.cpp b/src/quick3d/quick3dscene2d/items/scene2dmanager.cpp index 8829715d7..c5aeed278 100644 --- a/src/quick3d/quick3dscene2d/items/scene2dmanager.cpp +++ b/src/quick3d/quick3dscene2d/items/scene2dmanager.cpp @@ -92,7 +92,8 @@ Scene2DManager::Scene2DManager(QScene2DPrivate *priv) // Create window to render the QML with m_sharedObject->m_quickWindow = new QQuickWindow(m_sharedObject->m_renderControl); - m_sharedObject->m_quickWindow->setClearBeforeRendering(false); + m_sharedObject->m_quickWindow->setClearBeforeRendering(true); + m_sharedObject->m_quickWindow->setColor(Qt::transparent); connect(m_sharedObject->m_renderControl, &QQuickRenderControl::renderRequested, this, &Scene2DManager::requestRender); diff --git a/src/quick3d/quick3dscene2d/quick3dscene2d.pro b/src/quick3d/quick3dscene2d/quick3dscene2d.pro index b85863328..fb599187b 100644 --- a/src/quick3d/quick3dscene2d/quick3dscene2d.pro +++ b/src/quick3d/quick3dscene2d/quick3dscene2d.pro @@ -25,6 +25,4 @@ HEADERS += \ include(./items/items.pri) -QMAKE_DOCS = $$PWD/doc/qt3dscene2d.qdocconf - load(qt_module) diff --git a/src/render/doc/qt3drender.qdocconf b/src/render/doc/qt3drender.qdocconf deleted file mode 100644 index a3a827678..000000000 --- a/src/render/doc/qt3drender.qdocconf +++ /dev/null @@ -1,43 +0,0 @@ -include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf) -include(../../doc/qt3d-config.qdocconf) - -project = Qt3DRender -description = Qt 3D Render Reference Documentation -version = $QT_VERSION - -qhp.projects = Qt3DRender - -qhp.Qt3DRender.file = qt3drender.qhp -qhp.Qt3DRender.namespace = org.qt-project.qt3drender.$QT_VERSION_TAG -qhp.Qt3DRender.virtualFolder = qt3drender -qhp.Qt3DRender.indexTitle = Qt 3D Render -qhp.Qt3DRender.indexRoot = - -qhp.Qt3DRender.filterAttributes = qt3drender $QT_VERSION qtrefdoc -qhp.Qt3DRender.customFilters.Qt.name = Qt3DRender $QT_VERSION -qhp.Qt3DRender.customFilters.Qt.filterAttributes = qt3drender $QT_VERSION - -qhp.Qt3DRender.subprojects = classes qmltypes - -qhp.Qt3DRender.subprojects.classes.title = C++ Classes -qhp.Qt3DRender.subprojects.classes.indexTitle = Qt 3D Render C++ Classes -qhp.Qt3DRender.subprojects.classes.selectors = class doc:headerfile -qhp.Qt3DRender.subprojects.classes.sortPages = true - -qhp.Qt3DRender.subprojects.qmltypes.title = QML Types -qhp.Qt3DRender.subprojects.qmltypes.indexTitle = Qt 3D Render QML Types -qhp.Qt3DRender.subprojects.qmltypes.selectors = qmltype -qhp.Qt3DRender.subprojects.qmltypes.sortPages = true - -tagfile = qt3drender.tags - -depends += qtcore qtgui qtqml qtquick qtdoc qmake - -# dependencies to other Qt 3D modules -depends += qt3d qt3dcore qt3dlogic qt3dinput \ - qt3dextras qt3danimation qt3dscene2d - -sourcedirs += .. -headerdirs += .. -imagedirs += images -exampledirs += snippets diff --git a/src/render/framegraph/qblitframebuffer.cpp b/src/render/framegraph/qblitframebuffer.cpp index d5484b719..b0a29eab8 100644 --- a/src/render/framegraph/qblitframebuffer.cpp +++ b/src/render/framegraph/qblitframebuffer.cpp @@ -324,7 +324,7 @@ void QBlitFramebuffer::setSourceRect(const QRectF &inputRect) } /*! - Sets the destination rectangle to \a inputRect. The coordinates are assumed + Sets the destination rectangle to \a outputRect. The coordinates are assumed to follow the normal Qt coordinate system, meaning Y runs from top to bottom. */ diff --git a/src/render/frontend/qabstractfunctor.cpp b/src/render/frontend/qabstractfunctor.cpp index 9f4727865..4be1da595 100644 --- a/src/render/frontend/qabstractfunctor.cpp +++ b/src/render/frontend/qabstractfunctor.cpp @@ -72,7 +72,8 @@ namespace Qt3DRender { This method is used to cast functor \a other to type T if the other is of type T (or of subclass); otherwise returns 0. This method works similarly - to \l QObject::qobject_cast, except with functors derived from QAbstractFunctor. + to \l [QtCore] {qobject_cast(const QObject *object)}{qobject_cast()}, + except with functors derived from QAbstractFunctor. \warning If T was not declared with \l QT3D_FUNCTOR macro, then the results are undefined. */ diff --git a/src/render/frontend/qcamera.cpp b/src/render/frontend/qcamera.cpp index 73ec2c71f..274b555f6 100644 --- a/src/render/frontend/qcamera.cpp +++ b/src/render/frontend/qcamera.cpp @@ -735,11 +735,11 @@ void QCamera::viewSphere(const QVector3D ¢er, float radius) } /*! - * Rotates and moves the camera so that it's viewCenter is the center of the entity's bounding volume - * and the entire entity fits in the view port. + * Rotates and moves the camera so that it's viewCenter is the center of the + * \a {entity}'s bounding volume and the entire entity fits in the view port. * * \note Only works if the lens is in perspective projection mode. - * \sa Qt3D.Render::Camera::projectionType + * \sa {Qt3D.Render::Camera::projectionType}{Camera.projectionType} */ void QCamera::viewEntity(Qt3DCore::QEntity *entity) { diff --git a/src/render/frontend/qcameralens.cpp b/src/render/frontend/qcameralens.cpp index c9be49484..6c3598fe2 100644 --- a/src/render/frontend/qcameralens.cpp +++ b/src/render/frontend/qcameralens.cpp @@ -132,6 +132,10 @@ namespace Qt3DRender { /*! * \qmlproperty matrix4x4 CameraLens::projectionMatrix * Holds the current projection matrix of the camera lens. + * + * \note This will set the projection type to + * Qt3DRender::QCameraLens::CustomProjection and thus ignore all other camera + * parameters that might have been specified. * \readonly */ diff --git a/src/render/frontend/qpickingsettings.cpp b/src/render/frontend/qpickingsettings.cpp index 5a49cd182..66d3fc912 100644 --- a/src/render/frontend/qpickingsettings.cpp +++ b/src/render/frontend/qpickingsettings.cpp @@ -61,7 +61,7 @@ namespace Qt3DRender { In both cases, a ray will be cast through the scene to find geometry intersecting the ray. - \sa QObjectPicker, QPickEvent, QPickTriangleEvent, QRayCaster, QScreenRayCaster. + \sa QObjectPicker, QPickEvent, QPickTriangleEvent, QRayCaster, QScreenRayCaster */ /*! @@ -151,7 +151,7 @@ float QPickingSettings::worldSpaceTolerance() const * any edge of the entity's mesh component. * \value PointPicking An entity is considered picked if the picking ray intersects with * any point of the entity's mesh component. - * \value PrimitePicking An entity is considered picked if the picking ray intersects with + * \value PrimitivePicking An entity is considered picked if the picking ray intersects with * any point, edge or triangle of the entity's mesh component. */ @@ -285,7 +285,7 @@ void QPickingSettings::setFaceOrientationPickingMode(QPickingSettings::FaceOrien Holds the threshold, in model space coordinates, used to evaluate line and point picking. */ /*! - * Set the threshold used for line and point picking + * Sets the threshold used for line and point picking to \a worldSpaceTolerance. */ void QPickingSettings::setWorldSpaceTolerance(float worldSpaceTolerance) { diff --git a/src/render/jobs/pickboundingvolumejob.cpp b/src/render/jobs/pickboundingvolumejob.cpp index 5884a8f67..2f1eb4cd8 100644 --- a/src/render/jobs/pickboundingvolumejob.cpp +++ b/src/render/jobs/pickboundingvolumejob.cpp @@ -387,7 +387,7 @@ void PickBoundingVolumeJob::dispatchPickEvents(const QMouseEvent &event, break; } #if QT_CONFIG(gestures) - case Qt::TapGesture: { + case QEvent::Gesture: { objectPicker->onClicked(pickEvent); break; } diff --git a/src/render/materialsystem/qgraphicsapifilter.cpp b/src/render/materialsystem/qgraphicsapifilter.cpp index a94018360..65ad77d28 100644 --- a/src/render/materialsystem/qgraphicsapifilter.cpp +++ b/src/render/materialsystem/qgraphicsapifilter.cpp @@ -141,6 +141,8 @@ QGraphicsApiFilter::~QGraphicsApiFilter() \value OpenGLES QSurfaceFormat::OpenGLES \value OpenGL QSurfaceFormat::OpenGL + \value Vulkan Vulkan + \value DirectX DirectX */ diff --git a/src/render/picking/qabstractraycaster.cpp b/src/render/picking/qabstractraycaster.cpp index 804a7e7fb..4d7a77765 100644 --- a/src/render/picking/qabstractraycaster.cpp +++ b/src/render/picking/qabstractraycaster.cpp @@ -111,9 +111,9 @@ void QAbstractRayCasterPrivate::dispatchHits(const QAbstractRayCaster::Hits &hit Furthermore, Qt3DRender::QLayer components can be used to control how entities, or entity sub-graphs, react to ray casting. - Note: components derived from QAbstractRayCaster should not be shared amount multiple entities. + \note Components derived from QAbstractRayCaster should not be shared amount multiple entities. - \sa Qt3DRender::QRayCaster, Qt3DRender::QScreenRayCaster, Qt3DRender::QObjectPicker, Qt3DRender::QPickSettings + \sa Qt3DRender::QRayCaster, Qt3DRender::QScreenRayCaster, Qt3DRender::QObjectPicker, Qt3DRender::QPickingSettings */ /*! \qmltype AbstractRayCaster @@ -144,7 +144,7 @@ void QAbstractRayCasterPrivate::dispatchHits(const QAbstractRayCaster::Hits &hit Note: components derived from AbstractRayCaster should not be shared amount multiple entities. - \sa Qt3D.Render::RayCaster, Qt3D.Render::ScreenRayCaster, Qt3D.Render::ObjectPicker, Qt3D.Render::PickSettings + \sa Qt3D.Render::RayCaster, Qt3D.Render::ScreenRayCaster, Qt3D.Render::ObjectPicker, Qt3D.Render::PickingSettings */ /*! diff --git a/src/render/picking/qraycaster.cpp b/src/render/picking/qraycaster.cpp index cbc536d46..cfe5bce1b 100644 --- a/src/render/picking/qraycaster.cpp +++ b/src/render/picking/qraycaster.cpp @@ -82,34 +82,36 @@ namespace Qt3DRender { */ /*! - \property QVector3D origin + \property Qt3DRender::QRayCaster::origin - Holds the origin of the 3d ray in local coordinates. + Holds the origin of the 3D ray in local coordinates. */ /*! - \qmlproperty Vector3D origin + \qmlproperty vector3d Qt3D.Render::RayCaster::origin - Holds the origin of the 3d ray in local coordinates. + Holds the origin of the 3D ray in local coordinates. */ /*! - \property QVector3D direction + \property Qt3DRender::QRayCaster::direction - Holds the direction of the 3d ray. This should be a unit vector. + Holds the direction of the 3D ray. This should be a unit vector. */ + /*! - \qmlproperty Vector3D direction + \qmlproperty vector3D Qt3D.Render::RayCaster::direction - Holds the direction of the 3d ray. This should be a unit vector. + Holds the direction of the 3D ray. This should be a unit vector. */ /*! - \property float length + \property Qt3DRender::QRayCaster::length - Holds the length of the 3d ray. + Holds the length of the 3D ray. */ + /*! - \qmlproperty real direction + \qmlproperty real Qt3D.Render::RayCaster::length Holds the length of the 3d ray. */ @@ -169,7 +171,7 @@ float QRayCaster::length() const } /*! - * \brief Set the length of the ray to \a length + * \brief Sets the length of the ray to \a length. * * If the value is less than or equal to zero, the ray is concidered to be infinite. */ @@ -183,7 +185,7 @@ void QRayCaster::setLength(float length) } /*! - * Convenience method to enable the component and trigger tests using the current ray + * Convenience method to enable the component and trigger tests using the current ray. */ void QRayCaster::trigger() { @@ -191,7 +193,8 @@ void QRayCaster::trigger() } /*! - * Convenience method to set the ray details and enable the component to trigger tests + * Convenience method to set the ray details \a origin, \a direction, and \a length, + * and enable the component to trigger tests. */ void QRayCaster::trigger(const QVector3D &origin, const QVector3D &direction, float length) { diff --git a/src/render/picking/qscreenraycaster.cpp b/src/render/picking/qscreenraycaster.cpp index 5850353f3..99c3015f5 100644 --- a/src/render/picking/qscreenraycaster.cpp +++ b/src/render/picking/qscreenraycaster.cpp @@ -56,7 +56,7 @@ namespace Qt3DRender { \inherits QAbstractRayCaster QScreenRayCaster can be used to perform ray casting tests by specifying coordinates in - screen space, which will be used to construct an actual 3d ray between the near and + screen space, which will be used to construct an actual 3D ray between the near and far planes. \sa QRayCaster @@ -69,29 +69,28 @@ namespace Qt3DRender { \instantiates Qt3DRender::QScreenRayCaster ScreenRayCaster can be used to perform ray casting tests by specifying coordinates in - screen space, which will be used to construct an actual 3d ray between the near and + screen space, which will be used to construct an actual 3D ray between the near and far planes. \sa RayCaster */ /*! - \property QPoint position + \property Qt3DRender::QScreenRayCaster::position - Holds the screen space position used to compute the actual 3d ray for intersection tests. + Holds the screen space position used to compute the actual 3D ray for intersection tests. Note: the coordinates will be used for every available render surface as long as they are in the valid range. */ /*! - \qmlproperty Point2D position + \qmlproperty point Qt3D.Render::ScreenRayCaster::position - Holds the length of the 3d ray. + Holds the length of the 3D ray. - Note: the coordinates will be used for every available render surface as long as they are + \note The coordinates will be used for every available render surface as long as they are in the valid range. */ - QScreenRayCaster::QScreenRayCaster(Qt3DCore::QNode *parent) : QAbstractRayCaster(parent) { @@ -126,7 +125,7 @@ void QScreenRayCaster::setPosition(const QPoint &position) } /*! - Convenience method to enable the component and trigger tests using the current coordinate value + Convenience method to enable the component and trigger tests using the current coordinate value. */ void QScreenRayCaster::trigger() { @@ -134,7 +133,7 @@ void QScreenRayCaster::trigger() } /*! - Convenience method to set the coordinate value and enable the component to trigger tests + Convenience method to set the coordinate value \a position and enable the component to trigger tests. */ void QScreenRayCaster::trigger(const QPoint &position) { diff --git a/src/render/raycasting/qray3d.cpp b/src/render/raycasting/qray3d.cpp index 6d8469aa1..d8ad25b50 100644 --- a/src/render/raycasting/qray3d.cpp +++ b/src/render/raycasting/qray3d.cpp @@ -47,6 +47,11 @@ namespace Qt3DRender { namespace RayCasting { /*! + \namespace Qt3DRender::RayCasting + \internal +*/ + +/*! \internal \class Qt3DRender::RayCasting::QRay3D \inmodule Qt3DRender @@ -83,7 +88,7 @@ QRay3D::QRay3D() } /*! - \fn Qt3DRender::RayCasting::QRay3D::QRay3D(const QVector3D &origin, const QVector3D &direction, float distance) + \fn Qt3DRender::RayCasting::QRay3D::QRay3D(const Vector3D &origin, const Vector3D &direction, float distance) Construct a ray given its defining \a origin, \a direction and \a distance. The \a direction does not need to be normalized. @@ -117,7 +122,7 @@ Vector3D QRay3D::origin() const } /*! - \fn void Qt3DRender::RayCasting::QRay3D::setOrigin(const QVector3D &value) + \fn void Qt3DRender::RayCasting::QRay3D::setOrigin(const Vector3D &value) Sets the origin point of this ray to \a value. @@ -141,7 +146,7 @@ Vector3D QRay3D::direction() const } /*! - \fn void Qt3DRender::RayCasting::QRay3D::setDirection(const QVector3D &direction) + \fn void Qt3DRender::RayCasting::QRay3D::setDirection(const Vector3D &direction) Sets the direction vector of this ray to \a direction. @@ -194,7 +199,7 @@ bool QRay3D::operator!=(const QRay3D &other) const } /*! - Returns true if \a point lies on this ray; false otherwise. + Returns \c true if \a point lies on this ray; \c false otherwise. */ bool QRay3D::contains(const Vector3D &point) const { @@ -208,7 +213,7 @@ bool QRay3D::contains(const Vector3D &point) const } /*! - Returns true if \a ray lies on this ray; false otherwise. If true, + Returns \c true if \a ray lies on this ray; \c false otherwise. If true, this implies that the two rays are actually the same, but with different origin() points or an inverted direction(). */ @@ -285,7 +290,7 @@ float QRay3D::distance(const Vector3D &point) const } /*! - \fn Qt3DRender::RayCasting::QRay3D &Qt3DRender::RayCasting::QRay3D::transform(const QMatrix4x4 &matrix) + \fn Qt3DRender::RayCasting::QRay3D &Qt3DRender::RayCasting::QRay3D::transform(const Matrix4x4 &matrix) Transforms this ray using \a matrix, replacing origin() and direction() with the transformed versions. @@ -294,7 +299,7 @@ float QRay3D::distance(const Vector3D &point) const */ /*! - \fn Qt3DRender::RayCasting::QRay3D Qt3DRender::RayCasting::QRay3D::transformed(const QMatrix4x4 &matrix) const + \fn Qt3DRender::RayCasting::QRay3D Qt3DRender::RayCasting::QRay3D::transformed(const Matrix4x4 &matrix) const Returns a new ray that is formed by transforming origin() and direction() using \a matrix. @@ -344,7 +349,7 @@ QDebug operator<<(QDebug dbg, const QRay3D &ray) #ifndef QT_NO_DATASTREAM /*! - \relates Qt3DRender::QRay3D + \relates Qt3DRender::RayCasting::QRay3D Writes the given \a ray to the given \a stream and returns a reference to the stream. @@ -359,7 +364,7 @@ QDataStream &operator<<(QDataStream &stream, const QRay3D &ray) } /*! - \relates Qt3DRender::QRay3D + \relates Qt3DRender::RayCasting::QRay3D Reads a 3D ray from the given \a stream into the given \a ray and returns a reference to the stream. diff --git a/src/render/render.pro b/src/render/render.pro index fae103b2c..ea5ce7dc5 100644 --- a/src/render/render.pro +++ b/src/render/render.pro @@ -52,6 +52,4 @@ MODULE_PLUGIN_TYPES = \ geometryloaders \ renderplugins -QMAKE_DOCS = $$PWD/doc/qt3drender.qdocconf - load(qt_module) diff --git a/src/render/renderers/opengl/graphicshelpers/submissioncontext.cpp b/src/render/renderers/opengl/graphicshelpers/submissioncontext.cpp index 3ebc965df..4ec929b6e 100644 --- a/src/render/renderers/opengl/graphicshelpers/submissioncontext.cpp +++ b/src/render/renderers/opengl/graphicshelpers/submissioncontext.cpp @@ -144,6 +144,8 @@ void copyGLFramebufferDataToImage(QImage &img, const uchar *srcData, uint stride template<typename GenericState> void applyStateHelper(const GenericState *state, SubmissionContext *gc) { + Q_UNUSED(state); + Q_UNUSED(gc); } template<> diff --git a/src/render/renderers/opengl/opengl.pri b/src/render/renderers/opengl/opengl.pri index a669bf4ba..22a32d30f 100644 --- a/src/render/renderers/opengl/opengl.pri +++ b/src/render/renderers/opengl/opengl.pri @@ -13,6 +13,3 @@ gcov { QMAKE_CXXFLAGS += -fprofile-arcs -ftest-coverage QMAKE_LFLAGS += -fprofile-arcs -ftest-coverage } - -# otherwise mingw headers do not declare common functions like ::strcasecmp -win32-g++*:QMAKE_CXXFLAGS_CXX11 = -std=gnu++0x diff --git a/src/render/renderstates/qrenderstatecreatedchange.cpp b/src/render/renderstates/qrenderstatecreatedchange.cpp index 666543c39..02989a29e 100644 --- a/src/render/renderstates/qrenderstatecreatedchange.cpp +++ b/src/render/renderstates/qrenderstatecreatedchange.cpp @@ -64,7 +64,7 @@ public: Render::StateMask m_type; }; -/*! +/* * The constructor creates a new QRenderStateCreatedChangeBase::QRenderStateCreatedChangeBase * instance with the specified \a renderState. */ @@ -73,8 +73,8 @@ QRenderStateCreatedChangeBase::QRenderStateCreatedChangeBase(const QRenderState { } -/*! - * \return the current render state type +/* + * Returns the current render state type. */ Render::StateMask QRenderStateCreatedChangeBase::renderStateType() const { |