Spec-Zone.ru › Qt

Тип QML Particle3D

Абстрактная логическая частица. Подробнее...

Выражение импорта: import QtQuick3D.Particles3D
С момента: Qt 6.2
Наследует:

Object3D

Наследуется от:

ModelBlendParticle3D, ModelParticle3D и SpriteParticle3D

  • Список всех членов, включая унаследованные

Свойства

  • 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API