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

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