QSkeletonLoader Class

class Qt3DCore::QSkeletonLoader

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

Header:	#include <QSkeletonLoader>
CMake:	find_package(Qt6 COMPONENTS 3dcore REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3dcore)
qmake:	QT += 3dcore
Since:	Qt 5.10
Instantiated By:	SkeletonLoader
Inherits:	Qt3DCore::QAbstractSkeleton

• List of all members, including inherited members

Public Types

enum	Status { NotReady, Ready, Error }

Properties

• createJointsEnabled : bool
• source : QUrl
• status : const Status

Public Functions

	QSkeletonLoader(const QUrl &source, Qt3DCore::QNode *parent = nullptr)
	QSkeletonLoader(Qt3DCore::QNode *parent = nullptr)
bool	isCreateJointsEnabled() const
Qt3DCore::QJoint *	rootJoint() const
QUrl	source() const
Qt3DCore::QSkeletonLoader::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(Qt3DCore::QSkeletonLoader::Status status)

Detailed Description

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.

Constant	Value	Description
Qt3DCore::QSkeletonLoader::NotReady	0	The skeleton has not been loaded yet
Qt3DCore::QSkeletonLoader::Ready	1	The skeleton was successfully loaded
Qt3DCore::QSkeletonLoader::Error	2	An error occurred while loading the skeleton

Member Function Documentation

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

Constructs a new QSkeletonLoader with parent and sets the source.

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

Constructs a new QSkeletonLoader with parent.

bool QSkeletonLoader::isCreateJointsEnabled() const

Returns a boolean indicating whether CreateJoints is enabled or not. The default value is false.

Note: Getter function for property createJointsEnabled.

Qt3DCore::QJoint *QSkeletonLoader::rootJoint() const

Returns the root joint of the hierarchy of joints forming the skeleton.

Note: Getter function for property rootJoint.