Qt Quick Ejemplos de partículas: afectores
Esta es una recopilación de ejemplos que utilizan afectores en el sistema de partículas de QML.

Se trata de una recopilación de pequeños ejemplos en QML relacionados con el uso de afectores en el sistema de partículas. Cada ejemplo es un pequeño archivo QML que destaca un tipo o una característica concreta.
«Age» muestra cómo utilizar un afector «Age» para acortar prematuramente la vida de las partículas.
Age {
anchors.fill: parent
system: particles
once: true
lifeLeft: 1200
advancePosition: false
}A medida que se mueve el afector por la pantalla, las partículas que se encuentran en su interior (que aún no se hayan visto afectadas) saltan a un periodo cercano al final de su vida. Esto les da un breve periodo para desvanecerse por completo, pero si se cambia «lifeLeft» a 0 (el valor por defecto), llegarían al final de su vida al instante.
«Attractor» muestra cómo utilizar un afector «Attractor» para simular un agujero negro
Attractor {
id: gs; pointX: root.width/2; pointY: root.height/2; strength: 4000000;
affectedParameter: Attractor.Acceleration
proportionalToDistance: Attractor.InverseQuadratic
}Todas las partículas de la escena, incluidos los gases de escape y los proyectiles de la nave espacial, son atraídas hacia el agujero negro. Este efecto es más intenso cuanto más cerca se está del agujero negro, por lo que los asteroides situados cerca de la parte superior de la pantalla apenas se ven afectados, mientras que los que se encuentran hacia el centro a veces describen curvas drásticas. Para completar el efecto, un afector «Age» cubre el agujero negro para destruir las partículas que entran en contacto con él.
El «Custom Affector» manipula las propiedades de las partículas directamente en JavaScript. Se utiliza un «Affector» para hacer que las hojas se balanceen de un lado a otro mientras caen, lo que les da un aspecto más realista que si simplemente giraran en círculos:
Affector {
width: parent.width
height: parent.height - 100
onAffectParticles: (particles, dt) => {
//Wobbly movement
for (var i=0; i<particles.length; i++) {
var particle = particles[i];
particle.rotation += particle.vx * 0.15 * dt;
particle.update = true;
}
}
}Se utiliza otro para aplicar una fricción ligeramente variable a las hojas al «aterrizar», con el fin de que parezcan más naturales:
Affector {//Custom Friction, adds some 'randomness'
x: -60
width: parent.width + 120
height: 100
anchors.bottom: parent.bottom
onAffectParticles: (particles, dt) => {
for (var i=0; i<particles.length; i++) {
var particle = particles[i];
var pseudoRand = (Math.floor(particle.t*1327) % 10) + 1;
var yslow = dt * pseudoRand * 0.5 + 1;
var xslow = dt * pseudoRand * 0.05 + 1;
if (particle.vy < 1)
particle.vy = 0;
else
particle.vy = (particle.vy / yslow);
if (particle.vx < 1)
particle.vx = 0;
else
particle.vx = (particle.vx / xslow);
particle.update = true;
}
}
}La fricción es similar a la de las hojas que caen en el «Custom Affector», salvo que utiliza una fricción constante durante todo el descenso en lugar de «Custom Affectors».
Friction {
anchors.fill: parent
anchors.margins: -40
factor: 0.4
}La gravedad es un afector práctico para aplicar una aceleración constante a las partículas que se encuentran en su interior
Gravity {
system: sys
magnitude: 32
angle: ground.rotation + 90
}GroupGoal configura dos grupos de partículas para las bolas en llamas y las que no lo están, y ofrece varias formas de realizar la transición entre ellas.
ParticleGroup {
name: "unlit"
duration: 1000
to: {"lighting":1, "unlit":99}
ImageParticle {
source: "images/particleA.png"
colorVariation: 0.1
color: "#2060160f"
}
GroupGoal {
whenCollidingWith: ["lit"]
goalState: "lighting"
jump: true
}
}Las bolas sin llama tienen una probabilidad entre cien de encenderse por sí solas cada segundo, pero también tienen un « GroupGoal » (encendido) activado en todo el grupo. Este afector actúa sobre todas las partículas del grupo «sin encender» cuando chocan con partículas del grupo «encendido», y hace que pasen al grupo «encendido».
ParticleGroup {
name: "lighting"
duration: 100
to: {"lit":1}
}El grupo «lighting» es un grupo intermedio para que el resplandor se acumule y la transición resulte menos brusca. Por lo tanto, pasa automáticamente al grupo «lit» tras 100 ms.
ParticleGroup {
name: "lit"
duration: 10000
onEntered: root.score++
TrailEmitter {
id: fireballFlame
group: "flame"
emitRatePerParticle: 48
lifeSpan: 200
emitWidth: 8
emitHeight: 8
size: 24
sizeVariation: 8
endSize: 4
}
TrailEmitter {
id: fireballSmoke
group: "smoke"El grupo «lit» también cuenta con TrailEmitters para añadir más fuego y humo, pero no realiza transición a ningún sitio. Hay dos objetos « GroupGoal » más que permiten que las partículas del grupo «unlit» pasen al grupo «lighting» (y, posteriormente, al grupo «lit»).
GroupGoal {
groups: ["unlit"]
goalState: "lit"
jump: true
system: particles
x: -15
y: -55
height: 75
width: 30
shape: MaskShape {source: "images/matchmask.png"}
}El primero es simplemente un área vinculada a la ubicación de la imagen de una llama piloto. Cuando las bolas sin iluminar atraviesan la llama, pasan directamente al grupo «lit» porque la llama piloto es muy caliente.
//Click to enflame
GroupGoal {
groups: ["unlit"]
goalState: "lighting"
jump: true
enabled: ma.pressed
width: 18
height: 18
x: ma.mouseX - width/2
y: ma.mouseY - height/2
}El segundo está vinculado a la ubicación de la última interacción del puntero, de modo que al tocar o hacer clic en las bolas sin iluminar (lo cual resulta difícil debido a su movimiento constante) estas pasan al grupo de iluminación.
«Move» muestra algunos efectos sencillos que se pueden conseguir alterando la trayectoria a mitad de camino. Las partículas rojas tienen un afector que influye en su posición, haciendo que den un salto hacia delante de 120 píxeles.
Affector {
groups: ["A"]
x: 120
width: 80
height: 80
once: true
position: PointDirection { x: 120; }
}Las partículas verdes tienen un afector que modifica su velocidad, pero con cierta variación angular. Al añadir una velocidad aleatoria en otra dirección a su velocidad hacia delante ya existente, comienzan a dispersarse en forma de cono.
Affector {
groups: ["B"]
x: 120
y: 240
width: 80
height: 80
once: true
velocity: AngleDirection { angleVariation:360; magnitude: 72 }
}Las partículas azules tienen un afector que influye en su aceleración y, como está configurado en «false», esto restablece la aceleración en lugar de sumársele. Una vez que las partículas azules alcanzan el afector, su velocidad horizontal deja de aumentar a medida que disminuye su velocidad vertical.
Affector {
groups: ["C"]
x: 120
y: 400
width: 80
height: 120
once: true
relative: false
acceleration: PointDirection { y: -80; }
}SpriteGoal tiene un afector que interactúa con el motor de sprites de las partículas, si estas se están dibujando como sprites mediante ImageParticle.
SpriteGoal {
groups: ["meteor"]
system: sys
goalState: "explode"
jump: true
anchors.fill: rocketShip
width: 60
height: 60
}El SpriteGoal sigue la imagen del cohete en pantalla y, cuando interactúa con las partículas dibujadas como sprites por ImageParticle, les indica que pasen inmediatamente al estado «explosión», que en este caso es la animación del asteroide rompiéndose en muchos pedazos.
Turbulence tiene una llama con humo, y ambos conjuntos de partículas se ven afectados por un efector Turbulence. Esto produce un ligero efecto de viento.
Turbulence {
id: turb
enabled: true
height: (parent.height / 2) - 4
width: parent.width
x: parent. width / 4
anchors.fill: parent
NumberAnimation on strength{from: 16; to: 64; easing.type: Easing.InOutBounce; duration: 1800; loops: -1}
}Para que el viento cambie de dirección, sustituye la imagen del parámetro «noiseSource» por una de ruido en blanco y negro (actualmente utiliza una fuente de ruido predeterminada).
Wander utiliza un afector Wander para añadir una ligera deriva horizontal a los copos de nieve a medida que caen.
Wander {
id: wanderer
system: particles
anchors.fill: parent
xVariance: 360/(wanderer.affectedParameter+1);
pace: 100*(wanderer.affectedParameter+1);
}Se obtienen diferentes movimientos al aplicar «Wander» a distintos atributos de la trayectoria, por lo que el ejemplo facilita experimentar y observar las diferencias.
© 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.