En esta página

Attractor3D QML Type

Atrae partículas hacia una posición o una forma. Más...

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

Affector3D

Propiedades

Descripción detallada

Este elemento atrae partículas hacia una posición dentro de la vista 3D. Para modelar la gravedad de un objeto masivo cuyo centro de gravedad está lejos, utilice Gravity3D.

La posición de atracción se define con position y positionVariation o con shape. Si se definen ambos, se utiliza shape.

Documentación de propiedades

duration : int

Esta propiedad define la duración en milisegundos que tardan las partículas en alcanzar la posición de ataque. Cuando el valor es -1, se utiliza el lifeSpan de la partícula como duración.

El valor por defecto es -1.

durationVariation : int

Esta propiedad define la variación de la duración en milisegundos. La duración real para alcanzar el atractor está entre duration - durationVariation y duration + durationVariation.

El valor por defecto es 0 (sin variación).

hideAtEnd : bool

Esta propiedad define si la partícula debe desaparecer cuando alcanza el atractor.

El valor por defecto es false.

positionVariation : vector3d

Esta propiedad define la variación en la posición de atracción. Se puede utilizar para no atraer a un solo punto, pero al azar hacia un área más amplia. Aquí hay un ejemplo de cómo atraer partículas hacia algún punto aleatorio dentro del cubo (50, 50, 50) en la posición (100, 0, 0) dentro de 2 a 4 segundos:

Attractor3D {
    position: Qt.vector3d(100, 0, 0)
    positionVariation: Qt.vector3d(50, 50, 50)
    duration: 3000
    durationVariation: 1000
}

El valor por defecto es (0, 0, 0) (sin variación).

Véase también Node::position y shape.

positionsAmount : int

Esta propiedad define la cantidad de posiciones posibles almacenadas dentro de la forma del atractor. Por defecto, la cantidad es igual al número de partículas, pero se puede utilizar una cantidad menor para una caché más pequeña. Una cantidad mayor se puede utilizar para una aleatorización adicional.

shape : ParticleAbstractShape3D

Esta propiedad define un ParticleAbstractShape3D para la atracción de partículas. Cada partícula será atraída a una posición aleatoria dentro de esta forma. Esta es una alternativa para definir position y positionVariation. Aquí hay un ejemplo de cómo atraer partículas a algún punto aleatorio dentro de la esfera al final de las partículas lifeSpan:

Attractor3D {
    position: Qt.vector3d(100, 0, 0)
    shape: ParticleShape3D {
        type: ParticleShape3D.Sphere
        fill: true
    }
}

Ver también Node::position y positionVariation.

useCachedPositions : bool

Esta propiedad define si el atractor almacena en caché las posibles posiciones dentro de su forma. Las posiciones en caché dan resultados menos aleatorios pero son mejores para el rendimiento.

El valor por defecto es true.

© 2026 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.