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

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