Back to Qt.io
Contact Us Blog Download Qt

TargetDirection3D QML Type

For specifying a direction towards the target position. More...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Direction3D

Properties

Detailed Description

This element sets emitted particle velocity towards the target position.

For example, to emit particles towards position (100, 0, 0) with random magnitude between 10..20:

ParticleEmitter3D {
    ...
    velocity: TargetDirection3D {
        position: Qt.vector3d(100, 0, 0)
        normalized: true
        magnitude: 15.0
        magnitudeVariation: 5.0
    }
}

Property Documentation

magnitude : real

This property defines the magnitude in position change per second. Negative magnitude accelerates the opposite way from the position. When the normalized is false, this is multiplied with the distance to the target position.

The default value is 1.0.

See also magnitudeVariation.


magnitudeVariation : real

This property defines the magnitude variation in position change per second. When the normalized is false, this is multiplied with the distance to the target position.

The default value is 0.0.

See also magnitude.


normalized : bool

This property defines if the distance to position should be considered as normalized or not. When this is false, distance to the position affects the magnitude of the particles velocity. When set to true, distance is normalized and velocity amount comes only from magnitude and magnitudeVariation.

The default value is false.

See also magnitude and magnitudeVariation.


position : vector3d

This property defines the position for particles target.

The default value is (0, 0, 0) (the center of the emitter).

See also positionVariation.


positionVariation : vector3d

This property defines the position variation for particles target.

The default value is (0, 0, 0) (no variation).

See also position.


© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.