Sur cette page

Qt3DCore::QSkeletonLoader Class

class Qt3DCore::QSkeletonLoader

Permet de charger un squelette d'articulations à partir d'un fichier. Plus...

En-tête : #include <QSkeletonLoader>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3DCore)
target_link_libraries(mytarget PRIVATE Qt6::3DCore)
qmake : QT += 3dcore
En QML : SkeletonLoader
Hérite : Qt3DCore::QAbstractSkeleton
Statut : Déclassé

Types publics

enum Status { NotReady, Ready, Error }

Propriétés

Fonctions publiques

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

Emplacements publics

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

Signaux

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

Description détaillée

Utilisez SkeletonLoader si vous souhaitez charger un squelette entier à partir d'un fichier plutôt que de créer les articulations vous-même à l'aide de Skeleton et Joints. La création d'un squelette et la liaison des sommets d'un maillage au squelette s'effectuent plus facilement dans un outil de création de contenu numérique 3D tel que Blender. Le squelette et le maillage résultants peuvent ensuite être exportés dans un format approprié tel que glTF 2 pour être utilisés par Qt 3D.

Documentation sur les types de membres

enum QSkeletonLoader::Status

Cette énumération identifie le statut du squelette.

ConstanteValeurDescription de l'état
Qt3DCore::QSkeletonLoader::NotReady0Le squelette n'a pas encore été chargé
Qt3DCore::QSkeletonLoader::Ready1Le squelette a été chargé avec succès
Qt3DCore::QSkeletonLoader::Error2Une erreur s'est produite lors du chargement du squelette

Documentation sur les propriétés

createJointsEnabled : bool

Cette propriété contient un booléen indiquant si createJoints est activé ou non.

Fonctions d'accès :

bool isCreateJointsEnabled() const
void setCreateJointsEnabled(bool enabled)

Signal du notificateur :

void createJointsEnabledChanged(bool createJointsEnabled)

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

Cette propriété contient l'articulation racine de la hiérarchie des articulations formant le squelette.

Contient l'articulation racine de la hiérarchie du squelette chargée à partir de la source.

Fonctions d'accès :

Qt3DCore::QJoint *rootJoint() const

Signal de notification :

void rootJointChanged(Qt3DCore::QJoint *rootJoint)

source : QUrl

Contient l'url source à partir de laquelle le squelette doit être chargé.

Fonctions d'accès :

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

Signal de notification :

void sourceChanged(const QUrl &source)

[read-only] status : Status

Indique l'état actuel du chargement du squelette.

Fonctions d'accès :

Qt3DCore::QSkeletonLoader::Status status() const

Signal du notificateur :

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

Fonction membre Documentation

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

Construit un nouveau QSkeletonLoader avec parent.

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

Construit un nouveau QSkeletonLoader avec parent et définit source.

bool QSkeletonLoader::isCreateJointsEnabled() const

Renvoie un booléen indiquant si CreateJoints est activé ou non. La valeur par défaut est false.

Note : Fonction Getter pour la propriété createJointsEnabled.

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

Renvoie l'articulation racine de la hiérarchie des articulations formant le squelette.

Note : Fonction Getter pour la propriété rootJoint.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.