- Qt 6.9
- Qt Quick
- QML Types
- QtQuick.Particles
- Particle
- Qt 6.9.1 Reference Documentation

# Particle QML Type

Represents particles manipulated by emitters and affectors. More...

Import Statement: | `import QtQuick.Particles`

- List of all members, including inherited members

## Properties

- alpha : real
- autoRotate : bool
- ax : real
- ay : real
- blue : real
- currentSize : real
- endSize : real
- green : real
- initialAX : real
- initialAY : real
- initialVX : real
- initialVY : real
- initialX : real
- initialY : real
- lifeLeft : real
- lifeSpan : real
- red : real
- rotation : real
- rotationVelocity : real
- startSize : real
- t : real
- update : bool
- vx : real
- vy : real
- x : real
- xDeformationVectorX : real
- xDeformationVectorY : real
- y : real
- yDeformationVectorX : real
- yDeformationVectorY : real

## Detailed Description

Particle elements are always managed internally by the ParticleSystem and cannot be created in QML. However, sometimes they are exposed via signals so as to allow arbitrary changes to the particle state

## Property Documentation

alpha : real

ImageParticle can draw colorized particles. When it does so, alpha is used as the alpha channel of the color applied to the source image.

Values are from 0.0 to 1.0.

autoRotate : bool

If autoRotate is true, then the particle's rotation will be set so that it faces the direction of travel, plus any rotation from the rotation or rotationVelocity properties.

ax : real

The current x acceleration of the particle.

ay : real

The current y acceleration of the particle.

blue : real

ImageParticle can draw colorized particles. When it does so, blue is used as the blue channel of the color applied to the source image.

Values are from 0.0 to 1.0.

currentSize : real

The currentSize of the particle, interpolating between startSize and endSize based on the currentTime.

endSize : real

The size in pixels that the particle image is at the end of its life. If this value is less than 0, then it is disregarded and the particle will have its startSize for the entire lifetime.

green : real

ImageParticle can draw colorized particles. When it does so, green is used as the green channel of the color applied to the source image.

Values are from 0.0 to 1.0.

initialAX : real

The x acceleration of the particle at the beginning of its lifetime.

The method of simulation prefers to have the initial values changed, rather than determining and changing the value at a given time. Change initial values in CustomEmitters instead of the current values.

initialAY : real

The y acceleration of the particle at the beginning of its lifetime.

The method of simulation prefers to have the initial values changed, rather than determining and changing the value at a given time. Change initial values in CustomEmitters instead of the current values.

initialVX : real

The x velocity of the particle at the beginning of its lifetime.

The method of simulation prefers to have the initial values changed, rather than determining and changing the value at a given time. Change initial values in CustomEmitters instead of the current values.

initialVY : real

The y velocity of the particle at the beginning of its lifetime.

The method of simulation prefers to have the initial values changed, rather than determining and changing the value at a given time. Change initial values in CustomEmitters instead of the current values.

initialX : real

The x coordinate of the particle at the beginning of its lifetime.

The method of simulation prefers to have the initial values changed, rather than determining and changing the value at a given time. Change initial values in CustomEmitters instead of the current values.

initialY : real

The y coordinate of the particle at the beginning of its lifetime.

The method of simulation prefers to have the initial values changed, rather than determining and changing the value at a given time. Change initial values in CustomEmitters instead of the current values.

lifeLeft : real

The time in seconds that the particle has left to live at the current point in time.

lifeSpan : real

The time in seconds that the particle will live for.

red : real

ImageParticle can draw colorized particles. When it does so, red is used as the red channel of the color applied to the source image.

Values are from 0.0 to 1.0.

rotation : real

Degrees clockwise that the particle image is rotated at the beginning of its life.

rotationVelocity : real

Degrees clockwise per second that the particle image is rotated at while alive.

startSize : real

The size in pixels that the particle image is at the start of its life.

t : real

The time, in seconds since the beginning of the simulation, that the particle was born.

update : bool

Inside an Affector, the changes made to the particle will only be applied if update is set to true.

vx : real

The current x velocity of the particle.

vy : real

The current y velocity of the particle.

x : real

The current x coordinate of the particle.

xDeformationVectorX : real

The x component of the deformation vector along the X axis. ImageParticle can draw particles across non-square shapes. It will draw the texture rectangle across the parallelogram drawn with the x and y deformation vectors.

xDeformationVectorY : real

The x component of the deformation vector along the X axis. ImageParticle can draw particles across non-square shapes. It will draw the texture rectangle across the parallelogram drawn with the x and y deformation vectors.

y : real

The current y coordinate of the particle.

yDeformationVectorX : real

The y component of the deformation vector along the X axis. ImageParticle can draw particles across non-square shapes. It will draw the texture rectangle across the parallelogram drawn with the x and y deformation vectors.

yDeformationVectorY : real

The y component of the deformation vector along the Y axis. ImageParticle can draw particles across non-square shapes. It will draw the texture rectangle across the parallelogram drawn with the x and y deformation vectors.