Тип 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

Сигналы

• finished()

Методы

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

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

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

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

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

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

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

finished()

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

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

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

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

int advance()

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

int pause()

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

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

int restart()

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

int resume()

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

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