Тип QML ImageParticle
Для визуализации логических частиц с помощью изображения. Подробнее...
| Заявление об импорте: | import QtQuick.Particles 2.0 |
| Наследует: |
Свойства
- 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
Альфа, применяемая к изображению. Это значение умножается на значение в изображении и на значение в свойстве цвета.
Частицы имеют аддитивное наложение, поэтому меньший альфа-канал на отдельных частицах приводит к более сильным эффектам при наложении нескольких частиц.
Альфа измеряется от 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
поворот : real
Если задано, изображение будет повернуто на этот угол в градусах перед отрисовкой.
Координаты частиц не преобразуются.
rotationVariation : real
Если установлено, вращение отдельных частиц будет меняться на эту величину между частицами.
скоростьПоворота : real
Если установлено, частицы будут вращаться с этой скоростью в градусах/секунду.
rotationVelocityVariation : real
Если установлено, скоростьПоворота отдельных частиц будет меняться на эту величину между частицами.
sizeTable : url
Изображение, непрозрачность которого будет использоваться как 1D-текстура для определения размера на протяжении срока жизни.
Ожидается, что это свойство будет удалено в ближайшее время в пользу настраиваемых кривых сглаживания для определения размера на протяжении срока жизни.
источник : url
Исходное изображение для использования.
Если изображение является анимацией спрайтов, используйте свойство спрайтов вместо этого.
С Qt 5.2 предоставляются некоторые стандартные изображения в виде ресурсов для упрощения прототипирования:
| qrc:///particleresources/star.png | |
| qrc:///particleresources/glowdot.png | |
| qrc:///particleresources/fuzzydot.png |
Обратите внимание, что изображения имеют белый цвет и полупрозрачность, что позволяет максимально эффективно использовать цветовые характеристики и альфа-каналы.
Используемые для отрисовки частицы спрайты.
Обратите внимание, что изображение спрайта будет масштабироваться до квадрата в зависимости от размера отрисовываемой частицы.
Для получения подробной информации см. обзор Анимации спрайтов.
spritesInterpolate : bool
Если установлено в значение true, частицы спрайтов будут интерполироваться между кадрами спрайта при каждой отрисовке кадра, что сделает спрайты плавнее.
По умолчанию значение равно true.
status : Статус
Статус загрузки изображения.
xVector : StochasticDirection
Позволяет деформировать изображение частицы при отрисовке. Прямоугольное изображение будет деформировано таким образом, чтобы горизонтальные стороны имели форму этого вектора вместо (1,0).
yVector : StochasticDirection
Позволяет деформировать изображение частицы при отрисовке. Прямоугольное изображение будет деформировано таким образом, чтобы вертикальные стороны имели форму этого вектора вместо (0,1).
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qml-qtquick-particles-imageparticle.html