Тип QML SpriteSequence3D
Обеспечивает возможности последовательности изображений для частиц Sprite. Подробнее...
| Заявление об импорте: | import QtQuick3D.Particles3D |
| С: | Qt 6.2 |
| Наследует: |
Свойства
- AnimationDirection : перечисление
- animationDirection : AnimationDirection
- duration : int
- durationVariation : int
- frameCount : int
- frameIndex : int
- interpolate : bool
- randomStart : bool
Подробное описание
Элемент SpriteSequence3D поддерживает анимированные изображения с несколькими кадрами. Кадры должны быть выровнены по горизонтали на изображении, первый кадр слева, последний справа.
Чтобы сделать SpriteParticle3D анимированной последовательностью, установите свойство spriteSequence.
Документация по свойствам
AnimationDirection : перечисление
Определяет направление воспроизведения анимации последовательности.
| Константа | Описание |
|---|---|
SpriteSequence3D.Normal |
Анимация от первого кадра до последнего. По достижении последнего кадра возвращается к первому. |
SpriteSequence3D.Reverse |
Анимация от последнего кадра к первому. По достижении первого кадра возвращается к последнему. |
SpriteSequence3D.Alternate |
Анимация от первого кадра к последнему. По достижении последнего или первого кадра направление анимации меняется. Это обеспечивает плавную анимацию последовательности, даже если первый и последний кадры не совпадают. |
SpriteSequence3D.AlternateReverse |
Анимация от последнего кадра к первому. По достижении последнего или первого кадра направление анимации меняется. Это обеспечивает плавную анимацию последовательности, даже если первый и последний кадры не совпадают. |
SpriteSequence3D.SingleFrame |
Не анимировать кадр. Когда randomStart ложно, рендерится кадр frameIndex. Когда randomStart истинно, каждая частица рендерит случайный кадр. |
animationDirection : AnimationDirection
Это свойство определяет направление анимации последовательности.
Значение по умолчанию — SpriteSequence3D.Normal.
См. также randomStart.
duration : int
Это свойство определяет продолжительность в миллисекундах, за которую последовательность спрайтов выполняет анимацию. Например, если продолжительность составляет 400 а frameCount равна 8, каждый кадр будет отображаться в течение 50 миллисекунд. Если значение равно -1, используется значение lifeSpan частицы.
Значение по умолчанию — -1.
durationVariation : int
Это свойство определяет вариацию продолжительности в миллисекундах. Фактическая продолжительность анимации составляет от duration - durationVariation до duration + durationVariation.
Значение по умолчанию — 0 (без вариации).
frameCount : int
Это свойство определяет количество кадров изображения в sprite. Частица анимируется через эти кадры во время своего duration. Кадры должны быть расположены по горизонтали в одном файле изображения. Например, sprite может быть изображением 512x64 с frameCount кадров размером 8. Это сделает размер каждого кадра частицы 64x64 пикселей.
Значение по умолчанию — 1.
Примечание: Если ваше изображение содержит только один кадр спрайта, не определяйте свойство spriteSequence вообще.
См. также interpolate.
frameIndex : int
Это свойство определяет начальный индекс кадра. Это положение между кадрами, где начинается анимация. Например, когда frameIndex равно 5, а animationDirection равно Normal, первый рендерный кадр — 5. Если animationDirection равно Reverse, первый рендерный кадр — 4.
Значение frameIndex должно быть между 0 и frameCount - 1. Если animationDirection равно SingleFrame и randomStart равно false, все частицы будут рендерить спрайты с frameIndex.
Значение по умолчанию — 0.
См. также randomStart и animationDirection.
interpolate : bool
Это свойство определяет, интерполируются ли спрайты (смешиваются) между кадрами для создания более плавной анимации.
Значение по умолчанию — true.
См. также frameCount.
randomStart : bool
Это свойство определяет, должна ли анимация начинаться с случайного кадра между 0 и frameCount - 1. Это позволяет анимациям не выглядеть так, как будто все они только что начались.
Значение по умолчанию — false.
См. также animationDirection.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtquick3d-particles3d-spritesequence3d.html