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: |
Propiedades
- duration : int
- durationVariation : int
- hideAtEnd : bool
- positionVariation : vector3d
- positionsAmount : int
- shape : ParticleAbstractShape3D
- useCachedPositions : bool
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 se encuentra lejos, utiliza Gravity3D.
La posición de atracción se define bien mediante position y positionVariation, bien mediante shape. Si se definen ambas, se utiliza shape.
Documentación de propiedades
duration : int
Esta propiedad define, en milisegundos, el tiempo que tardan las partículas en llegar a la posición de atracción. Cuando el valor es -1, se utiliza la vida útil 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 se sitúa 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 llega al atractor.
El valor por defecto es « false ».
positionVariation : vector3d
Esta propiedad define la variación de la posición de atracción. Se puede utilizar para que las partículas no se atraigan hacia un único punto, sino de forma aleatoria hacia un área más amplia. A continuación se muestra un ejemplo de cómo atraer partículas hacia un punto aleatorio dentro del cubo (50, 50, 50) en la posición (100, 0, 0) en un intervalo de entre 2 y 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éanse también « Node::position » y « shape ».
positionsAmount : int
Esta propiedad define el número de posiciones posibles almacenadas dentro de la forma del atractor. Por defecto, este número es igual al número de partículas, pero se puede utilizar un valor menor para reducir el tamaño de la caché. Se puede utilizar un valor mayor para aumentar la aleatoriedad.
shape : ParticleAbstractShape3D
Esta propiedad define una « ParticleAbstractShape3D » para la atracción de partículas. Cada partícula será atraída hacia una posición aleatoria dentro de esta forma. Se trata de una alternativa para definir « position » y « positionVariation ». A continuación se muestra un ejemplo de cómo atraer partículas hacia un punto aleatorio dentro de una esfera mediante el extremo de las partículas lifeSpan:
Attractor3D {
position: Qt.vector3d(100, 0, 0)
shape: ParticleShape3D {
type: ParticleShape3D.Sphere
fill: true
}
}Véase 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 almacenadas en caché ofrecen resultados menos aleatorios, pero mejoran 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.