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

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