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

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