AnimatedSprite QML Type

Dessine une animation de sprite. Plus d'informations...

Import Statement: import QtQuick
Inherits:

Item

Propriétés

Signaux

Méthodes

Description détaillée

AnimatedSprite assure le rendu et le contrôle des animations qui sont fournies sous forme d'images multiples dans le même fichier image. Vous pouvez les lire à une vitesse fixe, à la fréquence d'images de votre écran, ou les faire avancer manuellement et contrôler leur progression.

Prenons l'exemple de la feuille de sprites suivante :

Elle peut être divisée en quatre images :

Pour lire chacune de ces images à une vitesse de 500 millisecondes par image, on peut utiliser le code suivant :

CodeRésultat
AnimatedSprite {
    source: "loading.png"
    frameWidth: 64
    frameHeight: 64
    frameCount: 4
    frameDuration: 500
}

Par défaut, les images sont interpolées (mélangées) pour rendre l'animation plus fluide. Pour désactiver cette fonction, réglez interpolate sur false:

CodeRésultat
AnimatedSprite {
    source: "loading.png"
    frameWidth: 64
    frameHeight: 64
    frameCount: 4
    frameDuration: 500
    interpolate: false
}

Pour contrôler la façon dont AnimatedSprite réagit à la mise à l'échelle, utilisez la propriété smooth.

Notez que contrairement à SpriteSequence, le type AnimatedSprite n'utilise pas Sprite pour définir plusieurs animations, mais encapsule lui-même une seule animation.

Voir aussi Animations de sprites.

Documentation sur les propriétés

currentFrame : int

Lorsque l'animation est en pause, l'image en cours peut être avancée manuellement en définissant cette propriété ou en appelant advance().


finishBehavior : enumeration

Le comportement lorsque l'animation se termine d'elle-même.

ConstanteDescription
FinishAtInitialFrameLorsque l'animation se termine, elle revient à l'image initiale. C'est le comportement par défaut.
FinishAtFinalFrameLorsque l'animation se termine, elle reste sur l'image finale.

frameCount : int

Nombre d'images dans ce site AnimatedSprite.


frameDuration : int

Durée de chaque image de l'animation en millisecondes. Les valeurs inférieures ou égales à 0 ne sont pas valides.

Si frameRate est valide, il sera utilisé pour calculer la durée des images. Dans le cas contraire, et si frameDuration est valide, frameDuration sera utilisé.

La modification de ce paramètre redémarre l'animation.


frameHeight : int

Hauteur d'une seule image dans ce site AnimatedSprite.

Ce paramètre peut être omis s'il s'agit du seul sprite du fichier.


frameRate : real

Nombre d'images par seconde à afficher dans l'animation. Les valeurs inférieures ou égales à 0 ne sont pas valides.

Si frameRate est valide, il sera utilisé pour calculer la durée des images. Dans le cas contraire, et si frameDuration est valide, frameDuration sera utilisé.

La modification de ce paramètre redémarre l'animation.


frameSync : bool

Si true, l'animation n'aura pas de durée. Au lieu de cela, l'animation avancera d'une image chaque fois qu'une image est rendue à l'écran. Cela permet de synchroniser l'animation avec le taux de peinture plutôt qu'avec le temps écoulé.

Si frameSync est défini sur true, il est prioritaire sur frameRate et frameDuration.

La valeur par défaut est false.

La modification de ce paramètre redémarre l'animation.


frameWidth : int

Largeur d'une seule image sur ce site AnimatedSprite.

Ce paramètre peut être omis s'il s'agit du seul sprite du fichier.


frameX : int

La coordonnée X dans le fichier image de la première image de l'animation AnimatedSprite.

Peut être omis si la première image commence dans le coin supérieur gauche du fichier.


frameY : int

La coordonnée Y dans le fichier image de la première image de AnimatedSprite.

Peut être omise si la première image commence dans le coin supérieur gauche du fichier.


interpolate : bool

Si true, l'interpolation se produira entre les images du sprite pour rendre l'animation plus fluide.

La valeur par défaut est true.


loops : int

Après avoir joué l'animation autant de fois, l'animation s'arrêtera automatiquement. Les valeurs négatives ne sont pas valables.

Si cette valeur est fixée à AnimatedSprite.Infinite, l'animation ne s'arrêtera pas d'elle-même.

La valeur par défaut est AnimatedSprite.Infinite


paused : bool

Lorsque l'animation est en pause, l'image en cours peut être avancée manuellement.

La valeur par défaut est false.


reverse : bool

Si true, l'animation sera jouée en sens inverse.

La valeur par défaut est false.


running : bool

Si le sprite est animé ou non.

La valeur par défaut est true


source : url

La source de l'image pour l'animation.

Si frameHeight et frameWidth ne sont pas spécifiés, on suppose qu'il s'agit d'une longue rangée d'images carrées. Sinon, il peut s'agir de plusieurs rangées contiguës ou d'images rectangulaires. Lorsqu'une rangée est épuisée, la suivante est utilisée.

Si frameX et frameY sont spécifiés, la rangée de cadres sera prise avec cette coordonnée x/y comme coin supérieur gauche.


Signal Documentation

finished()

Ce signal est émis lorsque le sprite a fini de s'animer.

Il n'est pas émis lorsque la propriété running est définie sur false, ni pour les sprites dont la propriété loops est définie sur AnimatedSprite.Infinite.

Remarque : le gestionnaire correspondant est onFinished.


Documentation de la méthode

int advance()

Avance l'animation du sprite d'une image.


int pause()

Met en pause l'animation du sprite. Cette méthode ne fait rien si paused vaut true.

Voir également resume().


int restart()

Arrête, puis démarre l'animation du sprite.


int resume()

Reprend l'animation du sprite si paused est true; sinon, cela ne fait rien.

Voir aussi pause().


start()

Démarre l'animation du sprite. Si l'animation est déjà en cours, l'appel à cette méthode n'a aucun effet.

Voir aussi stop().


stop()

Arrête l'animation du sprite. Si l'animation n'est pas en cours, l'appel à cette méthode n'a aucun effet.

Voir aussi start().


© 2025 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.