Тип QML AnimatedSprite

Отображает анимацию спрайта. Подробнее...

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

Свойства

• currentFrame : int
• finishBehavior : перечисление
• frameCount : int
• frameDuration : int
• frameHeight : int
• frameRate : qreal
• frameSync : bool
• frameWidth : int
• frameX : int
• frameY : int
• interpolate : bool
• loops : int
• paused : bool
• reverse : bool
• running : bool
• source : url

Сигналы

• finished()

Методы

• int advance()
• int pause()
• int restart()
• int resume()
• start()
• stop()

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

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

Рассмотрим следующий спрайт-лист:

Он может быть разделен на четыре кадра:

Чтобы воспроизвести каждый из этих кадров со скоростью 500 миллисекунд на кадр, можно использовать следующий код:

Код	Результат
AnimatedSprite { source: "loading.png" frameWidth: 64 frameHeight: 64 frameCount: 4 frameDuration: 500 }

По умолчанию кадры интерполируются (смешиваются), чтобы анимация выглядела плавнее. Чтобы отключить это, установите interpolate в false:

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

Чтобы управлять тем, как AnimatedSprite реагирует на масштабирование, используйте свойство smooth.

Обратите внимание, что в отличие от SpriteSequence, тип AnimatedSprite не использует Sprite для определения нескольких анимаций, а вместо этого инкапсулирует одну анимацию.

См. также Анимации спрайтов.

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

currentFrame : int

При паузе текущий кадр можно вручную продвинуть, установив это свойство или вызвав advance().

finishBehavior : перечисление

Поведение при завершении анимации.

frameCount : int

Количество кадров в этом AnimatedSprite.

frameDuration : int

Продолжительность каждого кадра анимации в миллисекундах. Значения, меньшие или равные 0, недопустимы.

Если frameRate является допустимым, он будет использоваться для расчета длительности кадров. В противном случае, и если frameDuration допустим, frameDuration будет использован.

Изменение этого параметра перезапустит анимацию.

frameHeight : int

Высота одного кадра в этом AnimatedSprite.

Может быть опущено, если это единственный спрайт в файле.

frameRate : qreal

Кадров в секунду для отображения в анимации. Значения, меньшие или равные 0, недопустимы.

Если frameRate является допустимым, он будет использоваться для расчета длительности кадров. В противном случае, и если frameDuration допустим, frameDuration будет использован.

Изменение этого параметра перезапустит анимацию.

frameSync : bool

Если true, анимация не будет иметь длительности. Вместо этого анимация будет переходить к следующему кадру каждый раз, когда кадр отображается на экране. Это синхронизирует его со скоростью отрисовки, а не с истекшим временем.

Если frameSync установлен в true, он переопределяет как frameRate, так и frameDuration.

По умолчанию false.

Изменение этого параметра перезапустит анимацию.

frameWidth : int

Ширина одного кадра в этом AnimatedSprite.

Может быть опущено, если это единственный спрайт в файле.

frameX : int

Координата X в файле изображения первого кадра AnimatedSprite.

Может быть опущено, если первый кадр начинается в левом верхнем углу файла.

frameY : int

Координата Y в файле изображения первого кадра AnimatedSprite.

Может быть опущено, если первый кадр начинается в левом верхнем углу файла.

interpolate : bool

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

По умолчанию true.

loops : int

После воспроизведения анимации это количество раз анимация автоматически остановится. Отрицательные значения недопустимы.

Если это значение установлено в AnimatedSprite.Infinite, анимация не будет останавливаться самостоятельно.

По умолчанию AnimatedSprite.Infinite

paused : bool

При паузе текущий кадр можно вручную продвинуть.

По умолчанию false.

reverse : bool

Если true, анимация будет воспроизводиться в обратном порядке.

По умолчанию false.

running : bool

Анимация спрайта воспроизводится или нет.

По умолчанию true

source : url

Источник изображения для анимации.

Если frameHeight и frameWidth не указаны, предполагается, что это одна длинная строка квадратных кадров. В противном случае, это могут быть несколько смежных строк или прямоугольных кадров, когда одна строка заканчивается, используется следующая.

Если frameX и frameY указаны, ряд кадров будет взят с координатой x/y как верхним левым углом.

Документация по сигналам

finished()

Этот сигнал испускается, когда анимация спрайта завершается.

Он не излучается, когда свойство running установлено в false, а также для спрайтов, у которых свойство loops установлено в AnimatedSprite.Infinite.

Примечание: Соответствующий обработчик — onFinished.

Этот сигнал был введён в Qt 5.12.

Документация по методам

int advance()

Передвигает анимацию спрайта на один кадр.

int pause()

Приостанавливает анимацию спрайта. Это ничего не делает, если свойство paused установлено в true.

См. также resume().

int restart()

Останавливает, а затем запускает анимацию спрайта.

int resume()

Возобновляет анимацию спрайта, если свойство paused установлено в true; в противном случае ничего не делает.

См. также pause().

start()

Запускает анимацию спрайта. Если анимация уже запущена, вызов этого метода не оказывает никакого влияния.

Этот метод был введён в Qt 5.15.

См. также stop().

stop()

Останавливает анимацию спрайта. Если анимация не запущена, вызов этого метода не оказывает никакого влияния.

Этот метод был введён в Qt 5.15.

См. также start().