Тип 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 не использует типы Sprite для определения нескольких анимаций, а вместо этого инкапсулирует одну анимацию.

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

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().