Тип QML ImageParticle

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

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

Свойства

• alpha : real
• alphaVariation : real
• autoRotation : bool
• blueVariation : real
• цвет : color
• 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.

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

alpha : real

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

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

Альфа измеряется от 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

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

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

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 : list<Sprite>

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

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

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

spritesInterpolate : bool

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

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

status : Status

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

xVector : StochasticDirection

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

yVector : StochasticDirection

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