Тип 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 в undefined), все данные цвета будут сброшены, и он начнет иметь неявное значение любого общего цвета от других ImageParticles.

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

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

alpha : real

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

Частицы имеют аддитивное смешивание, поэтому меньший 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

цвет : цвет

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

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

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

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

Если изображение является анимацией спрайта, используйте свойство 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).