Тип QML AnimatedImage

Воспроизводит анимации, хранящиеся как серия изображений. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• currentFrame : int
• frameCount : int
• paused : bool
• playing : bool
• source : url
• speed : real

Подробное описание

Тип AnimatedImage расширяет возможности типа Image, предоставляя способ воспроизведения анимаций, хранящихся как изображения, содержащие серию кадров, например, те, которые хранятся в файлах GIF.

Информация о текущем кадре и общей длительности анимации может быть получена с помощью свойств currentFrame и frameCount. Вы можете начать, приостановить и остановить анимацию, изменив значения свойств playing и paused.

Полный список поддерживаемых форматов можно определить с помощью QMovie::supportedFormats().

Пример использования

Следующий QML демонстрирует, как отобразить анимированное изображение и получить информацию о его состоянии, например, текущий кадр и общее количество кадров. Результатом является анимированное изображение с простым индикатором прогресса под ним.

Примечание: При кэшировании анимированных изображений каждый кадр анимации будет кэширован.

Установите cache в false, если вы воспроизводите длинную или большую анимацию и хотите сохранить память.

Если данные изображения поступают из последовательного устройства (например, сокета), AnimatedImage может циклически повторяться только если cache установлен в true.

import QtQuick 2.0

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

См. также BorderImage и Image.

Документация по свойствам

currentFrame — это кадр, который в данный момент отображается. Отслеживая изменения этого свойства, вы можете анимировать другие элементы одновременно с изображением.

frameCount — это количество кадров в анимации. Для некоторых форматов анимации frameCount неизвестен и имеет значение ноль.

paused : bool

Это свойство указывает, приостановлено ли анимированное изображение.

По умолчанию это свойство равно false. Установите его в true, чтобы приостановить анимацию.

playing : bool

Это свойство указывает, воспроизводится ли анимированное изображение.

По умолчанию это свойство равно true, что означает, что анимация начнётся сразу.

Примечание: это свойство подвержено изменениям фактического состояния воспроизведения AnimatedImage. Если используются неанимированные изображения, playing необходимо вручную установить в true, чтобы запустить анимацию следующих изображений.

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

source : url

Это свойство содержит URL, ссылающийся на исходное изображение.

AnimatedImage может обрабатывать любые форматы изображений, поддерживаемые Qt, загруженные из любого URL-схемы, поддерживаемой Qt.

См. также QQuickImageProvider.

speed : real

Это свойство содержит скорость анимации.

Скорость измеряется в процентах от исходной скорости анимированного изображения. По умолчанию скорость равна 1.0 (исходная скорость).

Это свойство было введено в QtQuick 2.11.