Sur cette page

Qt3DCore::QSkeletonLoader Class

class Qt3DCore::QSkeletonLoader

Permet de charger un squelette de joints à partir d'un fichier. En savoir 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 de : Qt3DCore::QAbstractSkeleton
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

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 la fonction ` SkeletonLoader ` si vous souhaitez charger un squelette complet à partir d'un fichier plutôt que de créer vous-même les articulations à l'aide des fonctions `Skeleton` et `Joints`. La création d’un squelette et la liaison des sommets d’un maillage à ce squelette s’effectuent plus facilement dans un outil de création de contenu numérique 3D tel que Blender. Le squelette et le maillage ainsi obtenus peuvent ensuite être exportés dans un format adapté, tel que glTF 2, pour être utilisés par Qt 3D.

Documentation sur les types de membres

enum QSkeletonLoader::Status

Cette énumération identifie l'état du squelette.

ConstanteValeurDescription
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 une valeur booléenne indiquant si la fonction `createJoints` est activée ou non.

Fonctions d'accès :

bool isCreateJointsEnabled() const
void setCreateJointsEnabled(bool enabled)

Signal de notification :

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 depuis 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 charger le squelette.

Fonctions d'accès :

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

Signal de notification :

void sourceChanged(const QUrl &source)

[read-only] status : Status

Contient l'état actuel du chargement du squelette.

Fonctions d'accès :

Qt3DCore::QSkeletonLoader::Status status() const

Signal de notification :

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

Documentation des fonctions membres

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

Crée un nouvel objet `QSkeletonLoader` à l'aide de ` parent`.

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

Crée un nouvel objet QSkeletonLoader avec ` parent ` et définit la propriété ` source`.

bool QSkeletonLoader::isCreateJointsEnabled() const

Renvoie une valeur booléenne indiquant si la fonction CreateJoints est activée ou non. La valeur par défaut est « false ».

Remarque : fonctiongetter pour la propriété ` createJointsEnabled`.

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

Renvoie le nœud racine de la hiérarchie des nœuds formant le squelette.

Remarque : fonctiongetter 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.