AnimatedImage QML Type

Spielt Animationen ab, die als eine Reihe von Bildern gespeichert sind. Mehr...

Import Statement:	`import QtQuick`
Inherits:	Image

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Detaillierte Beschreibung

Der Typ AnimatedImage erweitert die Eigenschaften des Typs Image und bietet eine Möglichkeit, Animationen abzuspielen, die als Bilder mit einer Reihe von Frames gespeichert sind, wie z. B. in GIF-Dateien.

Informationen über das aktuelle Bild und die Gesamtlänge der Animation können über die Eigenschaften currentFrame und frameCount abgerufen werden. Sie können die Animation starten, pausieren und stoppen, indem Sie die Werte der Eigenschaften playing und paused ändern.

Die vollständige Liste der unterstützten Formate kann mit QMovie::supportedFormats() ermittelt werden.

Beispielverwendung

Das folgende QML-Beispiel zeigt, wie man ein animiertes Bild anzeigt und Informationen über seinen Zustand erhält, z. B. das aktuelle Bild und die Gesamtzahl der Bilder. Das Ergebnis ist ein animiertes Bild mit einer einfachen Fortschrittsanzeige darunter.

Hinweis: Wenn animierte Bilder zwischengespeichert werden, wird jedes Bild der Animation zwischengespeichert.

Setzen Sie den Cache auf false, wenn Sie eine lange oder große Animation abspielen und Speicherplatz sparen wollen.

Wenn die Bilddaten von einem sequenziellen Gerät (z. B. einem Socket) stammen, kann AnimatedImage nur dann eine Schleife abspielen, wenn cache auf true gesetzt ist.

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"
    }
}

Siehe auch BorderImage und Image.

Dokumentation der Eigenschaft

currentFrame : int

frameCount : int [read-only]

currentFrame ist der Rahmen, der gerade sichtbar ist. Wenn Sie diese Eigenschaft auf Änderungen überwachen, können Sie andere Elemente gleichzeitig mit dem Bild animieren.

frameCount ist die Anzahl der Bilder in der Animation. Bei einigen Animationsformaten ist frameCount unbekannt und hat den Wert Null.

paused : bool

Diese Eigenschaft legt fest, ob das animierte Bild angehalten wird.

Standardmäßig ist diese Eigenschaft falsch. Setzen Sie sie auf true, wenn Sie die Animation anhalten wollen.

playing : bool

Diese Eigenschaft gibt an, ob das animierte Bild abgespielt wird.

Standardmäßig ist diese Eigenschaft true, was bedeutet, dass die Animation sofort abgespielt wird.

Hinweis: Diese Eigenschaft wird durch Änderungen des aktuellen Abspielstatus von AnimatedImage beeinflusst. Wenn nicht animierte Bilder verwendet werden, muss playing manuell auf true gesetzt werden, um die nachfolgenden Bilder zu animieren.

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

source : url

Diese Eigenschaft enthält die URL, die auf das Quellbild verweist.

AnimatedImage kann jedes von Qt unterstützte Bildformat verarbeiten, das von jedem von Qt unterstützten URL-Schema geladen wird. Sie ist jedoch nicht mit QQuickImageProvider kompatibel.

sourceSize : size

Diese Eigenschaft enthält die skalierte Breite und Höhe des Vollbildes.

Im Gegensatz zu den Eigenschaften width und height, die das Bild skalieren, legt diese Eigenschaft die maximale Anzahl von Pixeln fest, die für zwischengespeicherte Frames gespeichert werden, damit große Animationen nicht mehr Speicher als nötig verbrauchen.

Wenn die Originalgröße größer als sourceSize ist, wird das Bild verkleinert.

Die natürliche Größe des Bildes kann wiederhergestellt werden, indem diese Eigenschaft auf undefined gesetzt wird.

Hinweis: Wenn diese Eigenschaft dynamisch geändert wird, muss die Bildquelle neu geladen werden, möglicherweise sogar aus dem Netzwerk, wenn sie sich nicht im Festplatten-Cache befindet.

Siehe auch Image::sourceSize.

speed : real [since QtQuick 2.11]

Diese Eigenschaft gibt die Geschwindigkeit der Animation an.

Die Geschwindigkeit wird in Prozent der ursprünglichen Geschwindigkeit des animierten Bildes gemessen. Die Standardgeschwindigkeit ist 1.0 (Originalgeschwindigkeit).

Diese Eigenschaft wurde in QtQuick 2.11 eingeführt.

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