- Qt 6.8
- Qt Quick 3D
- QML Types
- QtQuick3D.Particles3D
- Wander3D
- Qt Quick 3D | Commercial or GPLv3

# Wander3D QML Type

Applies random wave curves to particles. More...

Import Statement: | `import QtQuick3D.Particles3D`
Since: | Qt 6.2
Inherits: | Affector3D

- List of all members, including inherited members

## Properties

- fadeInDuration : int
- fadeOutDuration : int
- globalAmount : vector3d
- globalPace : vector3d
- globalPaceStart : vector3d
- uniqueAmount : vector3d
- uniqueAmountVariation : real
- uniquePace : vector3d
- uniquePaceVariation : real

## Detailed Description

This element applies random wave curves to particles. Curves can combine global values which are the same for all particles and unique values which differ randomly.

## Property Documentation

fadeInDuration : int

This property defines the duration in milliseconds for fading in the affector. After this duration, the wandering will be in full effect. Setting this can be useful to emit from a specific position or shape, otherwise wander will affect position also at the beginning.

The default value is `0`.

fadeOutDuration : int

This property defines the duration in milliseconds for fading out the affector. Setting this can be useful to reduce the wander when the particle life time ends, for example when combined with Attractor3D so end positions will match the shape.

The default value is `0`.

globalAmount : vector3d

This property defines how long distance each particle moves at the ends of curves. So if the value is for example (100, 10, 0), all particles wander between (100, 10, 0) and (-100, -10, 0).

The default value is `(0.0, 0.0, 0.0)`.

globalPace : vector3d

This property defines the pace (frequency) each particle wanders in curves per second.

The default value is `(0.0, 0.0, 0.0)`.

globalPaceStart : vector3d

This property defines the starting point for the pace (frequency). The meaningful range is between 0 .. 2 * PI. For example, to animate the x-coordinate of the pace start:

     PropertyAnimation on globalPaceStart {
         loops: Animation.Infinite
         duration: 2000
         from: Qt.vector3d(0, 0, 0)
         to: Qt.vector3d(Math.PI * 2, 0, 0)
     }

The default value is `(0.0, 0.0, 0.0)`.

uniqueAmount : vector3d

This property defines how long distance each particle moves at the ends of curves at maximum.

The default value is `(0.0, 0.0, 0.0)`.

uniqueAmountVariation : real

This property defines variation for uniqueAmount between 0.0 and 1.0. When the amount variation is 0.0, every particle reaches maximum amount. When it's 0.5, every particle reaches between 0.5 - 1.5 of the amount. For example if uniqueAmount is (100, 50, 20) and uniqueAmountVariation is 0.1, the particles maximum wave distances are something random between (110, 55, 22) and (90, 45, 18).

The default value is `0.0`.

uniquePace : vector3d

This property defines the unique pace (frequency) each particle wanders in curves per second.

The default value is `(0.0, 0.0, 0.0)`.

uniquePaceVariation : real

This property defines the unique pace (frequency) variation for each particle between 0.0 and 1.0. When the variation is 0.0, every particle wander at the same frequency. For example if uniquePace is (1.0, 2.0, 4.0) and uniquePaceVariation is 0.5, the particles wave paces are something random between (2.0, 4.0, 8.0) and (0.5, 1.0, 2.0).

The default value is `0.0`.