Тип QML ImageParticle

Для визуализации логических частиц с помощью изображения. Подробнее...

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

Свойства

• alpha : real
• alphaVariation : real
• autoRotation : bool
• blueVariation : real
• цвет : цвет
• colorTable : url
• colorVariation : real
• entryEffect : EntryEffect
• greenVariation : real
• opacityTable : url
• redVariation : real
• вращение : real
• rotationVariation : real
• скоростьВращения : real
• rotationVelocityVariation : real
• sizeTable : url
• источник : url
• sprites : list<Sprite>
• spritesInterpolate : bool
• состояние : Status
• xVector : StochasticDirection
• yVector : StochasticDirection

Подробное описание

Этот элемент отображает логическую частицу как изображение. Изображение может быть

• окрашено
• вращается
• деформировано
• анимация на основе спрайтов

ImageParticles неявно делятся данными о частицах, если несколько ImageParticles рисуют одну и ту же группу логических частиц. Это разделение происходит по четырём перечисленным выше возможностям. Таким образом, если один ImageParticle определяет данные для отрисовки частиц в одной из этих возможностей, а другой — нет, то оба будут отображать частицы одинаково в этом аспекте автоматически. Это полезно в основном, когда есть некоторая случайная вариация частицы, которая должна оставаться с ней при переключении художников. Если оба ImageParticles определяют, как они должны отображаться в этом аспекте, они расходятся, и каждый отображается так, как определено.

Это совместное использование данных происходит за кулисами в зависимости от того, были ли свойства установлены неявно или явно. Один недостаток текущей реализации заключается в том, что переопределять возможности можно только целиком. Поэтому, если вы явно задаёте атрибут, влияющий на цвет, такой как redVariation, и затем сбрасываете его (устанавливая redVariation в неопределённое значение), все данные цвета будут сброшены, и он начнёт принимать неявное значение любого общего цвета от других ImageParticles.

Примечание: Максимальное количество частиц изображения ограничено 16383.

Документация по свойствам

alpha : real

Альфа-канал, применяемый к изображению. Это значение умножается на значение в изображении и на значение в свойстве цвета.

Частицы используют аддитивное смешивание, поэтому меньший alpha на отдельных частицах приводит к более сильным эффектам при наложении нескольких частиц.

Alpha измеряется от 0,0 до 1,0.

По умолчанию 1,0

alphaVariation : real

Изменение альфа-канала между частицами.

Alpha измеряется от 0,0 до 1,0.

По умолчанию 0,0

autoRotation : bool

Если установлено в true, к вращению частиц будет применено дополнительное вращение так, чтобы они смотрели в направлении движения. Чтобы направить частицы в противоположную сторону, установите autoRotation в true, а rotation — в 180.

По умолчанию false

blueVariation : real

Изменение синего канала цвета между частицами.

Цвет измеряется по каждому каналу от 0,0 до 1,0.

По умолчанию 0,0

цвет : color

Если цвет указан, предоставленное изображение будет окрашено им.

По умолчанию белый (без изменений).

colorTable : url

Изображение, чьи цвета будут использоваться как одномерная текстура для определения цвета в течение времени жизни. Например, когда частица находится на полпути своего жизненного цикла, она будет иметь цвет, указанный на полпути по изображению.

Этот цвет смешивается со свойством цвета и цветом исходного изображения.

colorVariation : real

Это число представляет изменение цвета, применяемое к отдельным частицам. Установка colorVariation равносильна установке redVariation, greenVariation и blueVariation на одно и то же число.

Каждый канал может изменяться между частицами на значение, не превышающее colorVariation, от своего обычного цвета.

Цвет измеряется по каждому каналу от 0,0 до 1,0.

По умолчанию 0,0

entryEffect : EntryEffect

Это свойство обеспечивает базовые и дешёвые эффекты входа и выхода для частиц. Для тонкого управления см. sizeTable и opacityTable.

Допустимые значения:

• ImageParticle.None: Частицы просто появляются и исчезают.
• ImageParticle.Fade: Частицы затухают от 0 непрозрачности в начале своего жизненного цикла и затухают до 0 в конце.
• ImageParticle.Scale: Частицы масштабируются с 0 размера в начале своего жизненного цикла и уменьшаются до 0 в конце.

Значение по умолчанию — Fade.

greenVariation : real

Изменение зелёного канала цвета между частицами.

Цвет измеряется по каждому каналу от 0,0 до 1,0.

По умолчанию 0,0

opacityTable : url

Изображение, чья непрозрачность будет использована как одномерная текстура для определения размера в течение времени жизни.

Ожидается, что это свойство будет удалено в ближайшее время в пользу пользовательских кривых сглаживания для определения непрозрачности в течение времени жизни.

redVariation : real

Изменение красного канала цвета между частицами.

Цвет измеряется по каждому каналу от 0,0 до 1,0.

По умолчанию 0,0

rotation : real

Если установлено, изображение будет повернуто на этот угол в градусах перед отображением.

Координаты частиц не преобразуются.

rotationVariation : real

Если установлено, вращение отдельных частиц будет изменяться на это значение между частицами.

rotationVelocity : real

Если установлено, частицы будут вращаться со скоростью в градусах в секунду.

rotationVelocityVariation : real

Если установлено, rotationVelocity отдельных частиц будет изменяться на это значение между частицами.

sizeTable : url

Изображение, чья непрозрачность будет использована как одномерная текстура для определения размера в течение времени жизни.

Ожидается, что это свойство будет удалено в ближайшее время в пользу пользовательских кривых сглаживания для определения размера в течение времени жизни.

source : url

Исходное изображение для использования.

Если изображение представляет собой анимацию спрайтов, используйте свойство sprites вместо этого.

Начиная с Qt 5.2, предоставляются некоторые стандартные изображения в качестве ресурсов для помощи в прототипировании:

qrc:///particleresources/star.png
qrc:///particleresources/glowdot.png
qrc:///particleresources/fuzzydot.png

Обратите внимание, что изображения имеют белый цвет и полупрозрачность, что позволяет максимально эффективно использовать цветовые характеристики и альфа-каналы.

sprites : список<Sprite>

Используемые для отрисовки частицы спрайты.

Обратите внимание, что изображение спрайта будет масштабироваться до квадрата в зависимости от размера отрисовываемой частицы.

Для получения подробной информации см. обзор Анимации спрайтов.

spritesInterpolate : bool

Если установлено в значение true, частицы спрайтов будут интерполироваться между кадрами спрайта при каждой отрисовке кадра, что сделает спрайты плавнее.

По умолчанию значение равно true.

status : Статус

Статус загрузки изображения.

xVector : StochasticDirection

Позволяет деформировать изображение частицы при отрисовке. Прямоугольное изображение будет деформировано таким образом, чтобы горизонтальные стороны имели форму этого вектора вместо (1,0).

yVector : StochasticDirection

Позволяет деформировать изображение частицы при отрисовке. Прямоугольное изображение будет деформировано таким образом, чтобы вертикальные стороны имели форму этого вектора вместо (0,1).