QSkeletonLoader Class

(Qt3DCore::QSkeletonLoader)

Used to load a skeleton of joints from file More...

Header: #include <QSkeletonLoader>
qmake: QT += 3dcore
Since: Qt 5.10
Instantiated By: SkeletonLoader
Inherits: Qt3DCore::QAbstractSkeleton

Public Types

enum Status { NotReady, Ready, Error }

Properties

Public Functions

QSkeletonLoader(Qt3DCore::QNode *parent = nullptr)
QSkeletonLoader(const QUrl &source, Qt3DCore::QNode *parent = nullptr)
bool isCreateJointsEnabled() const
Qt3DCore::QJoint *rootJoint() const
QUrl source() const
Status status() const

Public Slots

void setCreateJointsEnabled(bool enabled)
void setSource(const QUrl &source)

Signals

void createJointsEnabledChanged(bool createJointsEnabled)
void rootJointChanged(Qt3DCore::QJoint *rootJoint)
void sourceChanged(const QUrl &source)
void statusChanged(Status status)

Protected Functions

void sceneChangeEvent(const Qt3DCore::QSceneChangePtr &change) override

Additional Inherited Members

  • 1 public variable inherited from QObject
  • 10 static public members inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

Used to load a skeleton of joints from file

Use SkeletonLoader if you wish to load a whole skeleton from file rather than creating the joints yourself using Skeleton and Joints. Creating a skeleton and binding the vertices of a mesh to the skeleton is most easily performed in a 3D digital content creation tool such as Blender. The resulting skeleton and mesh can then be exported in a suitable format such as glTF 2 for consumption by Qt 3D.

Member Type Documentation

enum QSkeletonLoader::Status

This enum identifies the status of skeleton.

ConstantValueDescription
Qt3DCore::QSkeletonLoader::NotReady0The skeleton has not been loaded yet
Qt3DCore::QSkeletonLoader::Ready1The skeleton was successfully loaded
Qt3DCore::QSkeletonLoader::Error2An error occurred while loading the skeleton

Property Documentation

createJointsEnabled : bool

Access functions:

bool isCreateJointsEnabled() const
void setCreateJointsEnabled(bool enabled)

Notifier signal:

void createJointsEnabledChanged(bool createJointsEnabled)

rootJoint : Qt3DCore::QJoint * const

Access functions:

Qt3DCore::QJoint *rootJoint() const

Notifier signal:

void rootJointChanged(Qt3DCore::QJoint *rootJoint)

source : QUrl

Holds the source url from which to load the skeleton.

Access functions:

QUrl source() const
void setSource(const QUrl &source)

Notifier signal:

void sourceChanged(const QUrl &source)

status : const Status

Holds the current status of skeleton loading.

Access functions:

Status status() const

Notifier signal:

void statusChanged(Status status)

Member Function Documentation

QSkeletonLoader::QSkeletonLoader(Qt3DCore::QNode *parent = nullptr)

Constructs a new QSkeletonLoader with parent.

QSkeletonLoader::QSkeletonLoader(const QUrl &source, Qt3DCore::QNode *parent = nullptr)

Default constructs an instance of QSkeletonLoader.

[protected] void QSkeletonLoader::sceneChangeEvent(const Qt3DCore::QSceneChangePtr &change)