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

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