- Qt 6.11
- Qt 3D
- C++ Classes
- Qt3DCore (Deprecated)
- QSkeletonLoader
- Qt 6.11.0 Reference Documentation

# Qt3DCore::QSkeletonLoader Class

class Qt3DCore::QSkeletonLoader

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

Header: | `#include <QSkeletonLoader>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS 3DCore)` `target_link_libraries(mytarget PRIVATE Qt6::3DCore)`
qmake: | `QT += 3dcore`
In QML: | SkeletonLoader
Inherits: | Qt3DCore::QAbstractSkeleton
Status: | Deprecated

- List of all members, including inherited members

## Public Types

enum | Status { NotReady, Ready, Error }

## Properties

- createJointsEnabled : bool
- rootJoint : Qt3DCore::QJoint*
- source : QUrl
- status : Status

## 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
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

## Property Documentation

### createJointsEnabled : bool

This property holds a boolean to indicate whether createJoints is enabled or not.

Access functions:

bool | isCreateJointsEnabled() const
void | setCreateJointsEnabled(bool enabled)

Notifier signal:

void | createJointsEnabledChanged(bool createJointsEnabled)

### `[read-only]` rootJoint : Qt3DCore::QJoint*

This property holds the root joint of the hierarchy of joints forming the skeleton.

Holds the root joint of the skeleton hierarchy loaded from the source.

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)

### `[read-only]` status : Status

Holds the current status of skeleton loading.

Access functions:

Qt3DCore::QSkeletonLoader::Status | status() const

Notifier signal:

void | statusChanged(Qt3DCore::QSkeletonLoader::Status status)

## Member Function Documentation

### `[explicit]` QSkeletonLoader::QSkeletonLoader(Qt3DCore::QNode *parent = nullptr)

Constructs a new QSkeletonLoader with parent.

### `[explicit]` QSkeletonLoader::QSkeletonLoader(const QUrl &source, Qt3DCore::QNode *parent = nullptr)

Constructs a new QSkeletonLoader with parent and sets the source.

### 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.