Qt Quick 3D - Ejemplo de banco de pruebas de partículas 3D
Muestra cómo utilizar el módulo «Particles3D» de Qt Quick.

Este ejemplo muestra diferentes formas de utilizar las funciones del módulo « QtQuick3D.Particles3D ». El módulo «Particles Testbed» contiene una recopilación de ejemplos; algunos se centran en una función concreta y otros combinan varias funciones para conseguir el aspecto deseado.
Características comunes
Los ejemplos del entorno de pruebas comparten algunas características comunes. Para salir del ejemplo y volver a la pantalla de inicio, pulsa la flecha de retroceso situada en la esquina superior izquierda.
La esquina inferior derecha de cada ejemplo contiene un icono que abre la vista de registro. Desde esta vista, puedes ver diferentes datos de depuración sobre las partículas. Cada « ParticleSystem3D » tiene su propia fila en la que se muestran los datos de « ParticleSystem3DLogging ».

La esquina superior derecha de la mayoría de los ejemplos contiene una vista de configuración que se puede mostrar u ocultar haciendo clic en su icono. Esta configuración ayuda a demostrar las características individuales de la API, así como el comportamiento dinámico de los sistemas de partículas.

Ejemplo «Snowing»
Repasemos los conceptos básicos de Particles3D analizando el ejemplo «Snowing».

En primer lugar, importa el módulo « QtQuick3D.Particles3D » con la siguiente instrucción:
import QtQuick3D.Particles3DParticleSystem3D es la raíz del sistema de partículas, que gestiona la sincronización del sistema y agrupa todos los demás elementos relacionados, como partículas, emisores y afectores.
ParticleSystem3D {
id: psystem
// Start so that the snowing is in full steam
startTime: 15000A continuación, creamos un ` SpriteParticle3D `, que es una partícula visual de textura 2D. Si necesitáramos partículas de modelo 3D, podríamos utilizar alternativamente ` ModelParticle3D`. Es importante definir la cantidad de partículas con ` maxAmount ` para que se asignen tamaños de búfer óptimos. Aquí nuestros copos de nieve son blancos, con opacidad variable, y aparecen y desaparecen en 1000 ms.
SpriteParticle3D {
id: snowParticle
sprite: Texture {
source: "images/snowflake.png"
}
maxAmount: 1500 * sliderIntensity.sliderValue
color: "#ffffff"
colorVariation: Qt.vector4d(0.0, 0.0, 0.0, 0.5);
fadeInDuration: 1000
fadeOutDuration: 1000
}A continuación, necesitaremos ParticleEmitter3D para emitir las partículas de snowParticle mencionadas anteriormente. La propiedad shape define el área en la que se realiza la emisión. Aquí definimos que los copos de nieve tengan rotaciones y tamaños variados. Con la propiedad velocity puedes definir la dirección y la velocidad iniciales de las partículas emitidas. Cada partícula de copo de nieve permanece durante 15 segundos y el emiting rate se controla mediante los controles deslizantes de configuración.
ParticleEmitter3D {
id: emitter
particle: snowParticle
position: Qt.vector3d(0, 1000, -350)
depthBias: -100
scale: Qt.vector3d(15.0, 0.0, 15.0)
shape: ParticleShape3D {
type: ParticleShape3D.Sphere
}
particleRotationVariation: Qt.vector3d(180, 180, 180)
particleRotationVelocityVariation: Qt.vector3d(50, 50, 50);
particleScale: 2.0
particleScaleVariation: 0.5;
velocity: VectorDirection3D {
direction: Qt.vector3d(0, sliderVelocityY.sliderValue, 0)
directionVariation: Qt.vector3d(0, sliderVelocityY.sliderValue * 0.4, 0)
}
emitRate: sliderEmitRate.sliderValue * sliderIntensity.sliderValue
lifeSpan: 15000
}Normalmente también se utilizan algunos afectores para hacer más interesante el movimiento de las partículas. En este ejemplo de nevada utilizamos « Wander3D » para que los copos de nieve vuelen siguiendo curvas onduladas, así como « PointRotator3D » para simular un tiempo ventoso.
Wander3D {
enabled: checkBoxWanderEnabled.checked
globalAmount: Qt.vector3d(sliderWanderGlobalAmount.sliderValue, 0, sliderWanderGlobalAmount.sliderValue)
globalPace: Qt.vector3d(sliderWanderGlobalPace.sliderValue, 0, sliderWanderGlobalPace.sliderValue)
uniqueAmount: Qt.vector3d(sliderWanderUniqueAmount.sliderValue, 0, sliderWanderUniqueAmount.sliderValue)
uniquePace: Qt.vector3d(sliderWanderUniquePace.sliderValue, 0, sliderWanderUniquePace.sliderValue)
uniqueAmountVariation: sliderWanderUniqueAmountVariation.sliderValue
uniquePaceVariation: sliderWanderUniquePaceVariation.sliderValue
}
PointRotator3D {
enabled: checkBoxRotatorEnabled.checked
pivotPoint: Qt.vector3d(0, 0, -350)
direction: Qt.vector3d(0, 1, 0)
magnitude: sliderRotatorMagnitude.sliderValue
}© 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.