Тип QML AnimatedSprite

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

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

Свойства

• currentFrame : int
• 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

Методы

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

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

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

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

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

currentFrame : int

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

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, как верхним левым углом.

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

int advance()

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

int pause()

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

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

int restart()

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

int resume()

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

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