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

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