Spec-Zone.ru › Qt 6.0

Тип QML ImageParticle

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

Заявление об импорте: import QtQuick.Particles 2.0
Наследует:

ParticlePainter

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

Свойства

  • 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

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

sprites : список<Sprite>

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

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

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API