Тип ImageParticle QML

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

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

Свойства

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

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

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

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

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

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

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

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

alpha : real

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

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

Альфа измеряется от 0,0 до 1,0.

Значение по умолчанию — 1,0.

alphaVariation : real

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

Альфа измеряется от 0,0 до 1,0.

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

autoRotation : bool

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

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

blueVariation : real

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

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

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

color : color

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

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

colorTable : url

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

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

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

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

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

redVariation : real

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

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

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

rotation : real

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

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

rotationVariation : real

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

rotationVelocity : real

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

rotationVelocityVariation : real

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

sizeTable : url

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

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

source : url

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

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

Начиная с 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).