Тип 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, анимация не имеет продолжительности. Вместо этого анимация переходит к следующему кадру каждый раз, когда кадр рендерится на экране. Это синхронизирует анимацию с частотой обновления экрана, а не с elapsed time.

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

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