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

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