Тип 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 координатой в качестве верхнего левого угла.

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

[since 5.12] finished()

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

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

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

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

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

int advance()

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

int pause()

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

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

int restart()

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

int resume()

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

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

[since 5.15] start()

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

Этот метод был представлен в Qt 5.15.

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

[since 5.15] stop()

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

Этот метод был представлен в Qt 5.15.

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