- Qt 6.12
- Qt Quick 3D
- QML Types
- QtQuick3D.Particles3D
- TargetDirection3D
- Qt Quick 3D | Commercial or GPLv3

# TargetDirection3D QML Type

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

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

- List of all members, including inherited members

## Properties

- magnitude : real
- magnitudeVariation : real
- normalized : bool
- position : vector3d
- positionVariation : vector3d

## 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.