AnimatedImage QML Type

Joue des animations stockées sous la forme d'une série d'images. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• currentFrame : int
• frameCount : int
• paused : bool
• playing : bool
• source : url
• sourceSize : size
• speed : real (since QtQuick 2.11)

Description détaillée

Le type AnimatedImage étend les caractéristiques du type Image et permet de lire des animations stockées sous forme d'images contenant une série de trames, telles que celles stockées dans les fichiers GIF.

Les propriétés currentFrame et frameCount permettent d'obtenir des informations sur l'image en cours et sur la durée totale de l'animation. Vous pouvez démarrer, mettre en pause et arrêter l'animation en modifiant les valeurs des propriétés playing et paused.

La liste complète des formats pris en charge peut être déterminée à l'aide de QMovie::supportedFormats().

Exemple d'utilisation

Le code QML suivant montre comment afficher une image animée et obtenir des informations sur son état, telles que l'image en cours et le nombre total d'images. Le résultat est une image animée avec un simple indicateur de progression en dessous.

Remarque: lorsque les images animées sont mises en cache, chaque image de l'animation est mise en cache.

Réglez le cache sur false si vous jouez une animation longue ou volumineuse et que vous souhaitez économiser de la mémoire.

Si les données de l'image proviennent d'un périphérique séquentiel (par exemple, un socket), AnimatedImage ne peut boucler que si la valeur de cache est fixée à true.

import QtQuick

Rectangle {
    width: animation.width; height: animation.height + 8

    AnimatedImage { id: animation; source: "animation.gif" }

    Rectangle {
        property int frames: animation.frameCount

        width: 4; height: 8
        x: (animation.width - width) * animation.currentFrame / frames
        y: animation.height
        color: "red"
    }
}

Voir également BorderImage et Image.

Documentation sur les propriétés

currentFrame est le cadre actuellement visible. En surveillant les changements de cette propriété, vous pouvez animer d'autres éléments en même temps que l'image.

frameCount est le nombre d'images de l'animation. Pour certains formats d'animation, frameCount est inconnu et a une valeur de zéro.

paused : bool

Cette propriété indique si l'image animée est mise en pause.

Par défaut, cette propriété vaut false. Définissez-la à true si vous souhaitez mettre l'animation en pause.

playing : bool

Cette propriété indique si l'image animée est en cours de lecture.

Par défaut, cette propriété vaut true, ce qui signifie que l'animation commence immédiatement.

Remarque: cette propriété est affectée par les modifications de l'état de lecture de AnimatedImage. Si des images non animées sont utilisées, playing devra être manuellement remplacé par true afin d'animer les images suivantes.

AnimatedImage {
    onStatusChanged: playing = (status == AnimatedImage.Ready)
}

source : url

Cette propriété contient l'URL qui fait référence à l'image source.

AnimatedImage peut gérer n'importe quel format d'image supporté par Qt, chargé à partir de n'importe quel schéma d'URL supporté par Qt. Elle n'est cependant pas compatible avec QQuickImageProvider.

sourceSize : size

Cette propriété contient la largeur et la hauteur mises à l'échelle de l'image pleine page.

Contrairement aux propriétés width et height, qui mettent à l'échelle la peinture de l'image, cette propriété définit le nombre maximal de pixels stockés pour les images mises en cache afin que les animations de grande taille n'utilisent pas plus de mémoire que nécessaire.

Si la taille originale est supérieure à sourceSize, l'image est réduite.

La taille naturelle de l'image peut être rétablie en définissant cette propriété sur undefined.

Voir également Image::sourceSize.

speed : real [since QtQuick 2.11]

Cette propriété définit la vitesse de l'animation.

La vitesse est mesurée en pourcentage de la vitesse de l'image animée originale. La vitesse par défaut est 1.0 (vitesse originale).

Cette propriété a été introduite dans QtQuick 2.11.