Qt3DAnimation::QAbstractAnimationClip Class
class Qt3DAnimation::QAbstractAnimationClipQAbstractAnimationClip est la classe de base des types fournissant des données d'animation par images clés. En savoir plus...
| En-tête : | #include <qabstractanimationclip.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3danimation) target_link_libraries(mytarget PRIVATE Qt6::3danimation) |
| qmake : | QT += 3danimation |
| Hérite de : | Qt3DCore::QNode |
| Hérité par : | Qt3DAnimation::QAnimationClip et Qt3DAnimation::QAnimationClipLoader |
| Statut : | Aperçu technologique |
Cette classe est en préversion technologique et est susceptible d'être modifiée.
Propriétés
- duration : float
Fonctions publiques
| virtual | ~QAbstractAnimationClip() |
| float | duration() const |
Signaux
| void | durationChanged(float duration) |
Description détaillée
Pour utiliser le framework d’animation par images clés du module Animation d’ Qt 3D, le composant d’animation utilisé doit recevoir les données d’animation par images clés. Ces données sont fournies par l’une des sous-classes concrètes de QAbstractAnimationClip :
QAnimationClip doit être utilisé lorsque vous souhaitez créer les données d'animation par programmation au sein de votre application. Les données proprement dites sont définies à l'aide d'un type de valeur QAnimationClipData.
Si vous chargez des données d’animation précalculées à partir d’un fichier, par exemple celles créées par un artiste, utilisez alors la classe ` QAnimationClipLoader ` et définissez sa propriété ` source `.
Une fois que le clip d’animation a été renseigné avec des données à l’aide des méthodes ci-dessus, la propriété `duration` (en lecture seule) sera mise à jour par le backend d’animation ` Qt 3D `.
L’utilisation typique des clips d’animation est la suivante :
auto animator = new QClipAnimator();
auto clip = new QAnimationClipLoader();
clip->setSource(QUrl::fromLocalFile("bounce.json"));
animator->setClip(clip);
animator->setChannelMapper(...);
animator->setRunning(true);Les clips d’animation sont également utilisés comme valeurs des nœuds feuilles dans les arbres de mélange d’animations :
// Create leaf nodes of blend tree
auto slideClipValue = new QClipBlendValue(
new QAnimationClipLoader(QUrl::fromLocalFile("slide.json")));
auto bounceClipValue = new QClipBlendValue(
new QAnimationClipLoader(QUrl::fromLocalFile("bounce.json")));
// Create blend tree inner node
auto additiveNode = new QAdditiveClipBlend();
additiveNode->setBaseClip(slideClipValue);
additiveNode->setAdditiveClip(bounceClipValue);
additiveNode->setAdditiveFactor(0.5f);
// Run the animator
auto animator = new QBlendedClipAnimator();
animator->setBlendTree(additiveNode);
animator->setChannelMapper(...);
animator->setRunning(true);Voir également Qt3DAnimation::QAnimationClip et Qt3DAnimation::QAnimationClipLoader.
Documentation sur les propriétés
[read-only] duration : float
Contient la durée du clip d'animation en secondes. Cette valeur est mise à jour dès que les données d'animation sont fournies à ` Qt 3D ` via l'une des sous-classes concrètes.
Fonctions d'accès :
| float | duration() const |
Signal de notification :
| void | durationChanged(float duration) |
© 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.