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

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

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

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

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

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", но это будет допустимый путь, если цель спрайта установлена.

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