Тип QML Particle3D
Абстрактная логическая частица. Подробнее...
| Выражение импорта: | import QtQuick3D.Particles3D |
| С момента: | Qt 6.2 |
| Наследует: | |
| Наследуется от: |
Свойства
- AlignMode : перечисление
- FadeType : перечисление
- SortMode : перечисление
- alignMode : AlignMode
- alignTargetPosition : vector3d
- цвет : цвет
- colorVariation : vector4d
- fadeInDuration : int
- fadeInEffect : FadeType
- fadeOutDuration : int
- fadeOutEffect : FadeType
- hasTransparency : bool
- maxAmount : int
- sortMode : SortMode
- unifiedColorVariation : bool
Подробное описание
Этот элемент определяет общие свойства логических частиц. Particle3D — это абстрактный базовый класс частиц, вместо него используйте ModelParticle3D или SpriteParticle3D.
Примечание: В отличие от материалов, используемых с моделями, частицы по умолчанию рендерятся с полупрозрачностью и включённым смешиванием. Это желаемое поведение в большинстве случаев из-за текстур частиц, цветовых (альфа) вариаций, эффектов затухания и т. д. Если вам не нужно смешивание, установите hasTransparency в false для возможного повышения производительности.
Документация по свойствам
AlignMode : перечисление
Определяет тип выравнивания.
| Константа | Описание |
|---|---|
Particle3D.AlignNone |
Без выравнивания. Поворот частиц можно определить с помощью particleRotation. |
Particle3D.AlignTowardsTarget |
Выравнивание частиц по направлению alignTargetPosition. |
Particle3D.AlignTowardsStartVelocity |
Выравнивание частиц по направлению начальной скорости. |
FadeType : перечисление
Определяет тип эффекта затухания.
| Константа | Описание |
|---|---|
Particle3D.FadeNone |
Без затухания. |
Particle3D.FadeOpacity |
Затухание непрозрачности частицы от/до 0,0. |
Particle3D.FadeScale |
Затухание масштаба частицы от/до 0,0. |
SortMode : перечисление
Определяет режим сортировки частиц. Режим сортировки определяет порядок отрисовки частиц.
| Константа | Описание |
|---|---|
Particle3D.SortNone |
Без сортировки. |
Particle3D.SortNewest |
Сортировка по времени жизни частицы, самые новые — первыми. |
Particle3D.SortOldest |
Сортировка по времени жизни частицы, самые старые — первыми. |
Particle3D.SortDistance |
Сортировка по расстоянию до камеры, самые далёкие — первыми. |
alignMode : AlignMode
Это свойство определяет режим выравнивания, используемый для частиц. Выравнивание частиц — это направление, в котором смотрят частицы.
Примечание: Когда свойство SpriteParticle3D billboard установлено в true, alignMode не оказывает влияния.
Значение по умолчанию — Particle3D.AlignNone.
См. также alignTargetPosition.
alignTargetPosition : vector3d
Это свойство определяет позицию, к которой выравниваются частицы. Это свойство действует только когда alignMode установлено в Particle3D.AlignTowardsTarget.
См. также alignMode.
цвет : цвет
Это свойство определяет базовый цвет, используемый для окрашивания частиц.
Значение по умолчанию — "#FFFFFF" (белый).
colorVariation : vector4d
Это свойство определяет вариацию цвета, используемую для окрашивания частиц. Значения в порядке RGBA, и каждое значение должно быть между 0,0 (без вариации) и 1,0 (полная вариация).
Например, чтобы создать частицы, которые будут иметь полупрозрачные красные цвета между #ff0000 и #e50000, с 40% до 60% непрозрачности:
ModelParticle3D {
...
color: "#7fff0000"
colorVariation: Qt.vector4d(0.1, 0.0, 0.0, 0.2)
} Значение по умолчанию — (0, 0, 0, 0) (без вариации).
См. также unifiedColorVariation.
fadeInDuration : int
Это свойство определяет длительность эффекта появления в миллисекундах.
Примечание: Длительности затухания являются частью жизненного цикла частиц lifeSpan. Так, например, если lifeSpan равно 3000, fadeInDuration равно 500 и fadeOutDuration равно 500, полностью видимое время частицы составляет 2000 мс.
Значение по умолчанию — 250.
См. также fadeInEffect и fadeOutDuration.
fadeInEffect : FadeType
Это свойство определяет эффект затухания, используемый при появлении частиц.
Значение по умолчанию — Particle3D.FadeOpacity.
См. также fadeInDuration и fadeOutEffect.
fadeOutDuration : int
Это свойство определяет длительность эффекта затухания в миллисекундах.
Значение по умолчанию — 250.
См. также fadeOutEffect и fadeInDuration.
fadeOutEffect : FadeType
Это свойство определяет эффект затухания, используемый, когда частицы достигают своего lifeSpan и исчезают.
Значение по умолчанию — Particle3D.FadeOpacity.
См. также fadeOutDuration и fadeInEffect.
hasTransparency : bool
Это свойство определяет, имеет ли частица прозрачность и должна ли она смешиваться с фоном. Обычно это должно быть true, например, когда цвет частицы не имеет полного альфа-канала, текстура содержит полупрозрачные пиксели или непрозрачность частиц плавно изменяется. Установка в false может быть оптимизацией в некоторых случаях.
Значение по умолчанию — true.
См. также цвет, fadeInEffect и fadeOutEffect.
maxAmount : int
Это свойство определяет максимальное количество частиц, которые могут существовать одновременно. Для отладки эффективности использования выделенных частиц можно использовать particlesUsed. Если maxAmount слишком мал, частицы повторно используются до достижения конца их lifeSpan. Если maxAmount слишком велик, происходит ненужное выделение памяти для частиц.
Примечание: Изменение maxAmount сбрасывает все частицы в системе частиц.
Значение по умолчанию равно 100.
sortMode : SortMode
Это свойство определяет режим сортировки, используемый для частиц.
Значение по умолчанию равно Particle3D.SortNone.
unifiedColorVariation : bool
Это свойство определяет, должно ли colorVariation применяться равномерно ко всем цветовым каналам. Это означает, что все изменения применяются с одинаковым случайным значением.
Например, чтобы создать частицы, которые будут иметь желтые цвета между #ffff00 и #7f7f00, так что значения цветовых каналов R и G всегда одинаковы:
ModelParticle3D {
...
color: "#ffff00"
colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
unifiedColorVariation: true
} Значение по умолчанию равно false.
См. также colorVariation.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtquick3d-particles3d-particle3d.html