Тип QML Sprite

Определяет анимации спрайтов. Подробнее...

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

Свойства

• duration : int
• durationVariation : int
• frameCount : int
• frameDuration : int
• frameDurationVariation : int
• frameHeight : int
• frameRate : qreal
• frameRateVariation : qreal
• frameSync : bool
• frameWidth : int
• frameX : int
• frameY : int
• name : string
• randomStart : bool
• reverse : bool
• source : url
• to : QVariantMap

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

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

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

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

duration : int

Продолжительность анимации. Значения ниже 0 недействительны.

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

durationVariation : int

Продолжительность анимации может изменяться на эту величину. Изменение никогда не уменьшит длительность анимации до значения меньше 0.

durationVariation вступит в силу только в том случае, если duration используется для расчета продолжительности кадров.

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

frameCount : int

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

frameDuration : int

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

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

frameDurationVariation : int

Продолжительность кадра в анимации может изменяться на эту величину. Изменение никогда не уменьшит длительность анимации до значения меньше 0.

frameDurationVariation вступит в силу только в том случае, если frameDuration используется для расчета продолжительности кадров.

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

frameHeight : int

Высота одного кадра в этом спрайте.

frameRate : qreal

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

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

frameRateVariation : qreal

Частота кадров между анимациями может изменяться на эту величину. Изменение никогда не уменьшит длительность анимации до значения меньше 0.

frameRateVariation вступит в силу только в том случае, если frameRate используется для расчета продолжительности кадров.

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

frameSync : bool

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

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

По умолчанию значение равно false.

frameWidth : int

Ширина одного кадра в этом спрайте.

frameX : int

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

frameY : int

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

name : string

Имя этого спрайта, которое используется в свойстве to других спрайтов.

randomStart : bool

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

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

По умолчанию значение равно false.

reverse : bool

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

По умолчанию значение равно false.

source : url

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

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

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

to : QVariantMap

Список других спрайтов и взвешенных переходов к ним, например, {"a":1, "b":2, "c":0} указывает, что одна треть должна перейти к спрайту "a", когда этот спрайт закончит, и две трети должны перейти к спрайту "b", когда этот спрайт закончит. Поскольку переходы выбираются случайным образом, эти пропорции не будут точными. С "c":0 в списке, ни один спрайт не будет случайным образом переходить к "c", но это будет допустимый путь, если цель спрайта будет задана.

Если список не указан или сумма весов в списке равна нулю, то спрайт повторит себя после завершения.