Qt Quick Ejemplos de partículas - Sistema

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

Partículas circulares con bordes negros sobre fondo azul que representan a varios pintores

Se trata de una recopilación de pequeños ejemplos en QML relacionados con el uso de «Affectors» en el sistema de partículas. Cada ejemplo es un pequeño archivo QML que destaca un tipo o característica concretos.

La comparación dinámica contrasta el uso del sistema de partículas con la obtención de un efecto similar mediante el siguiente código, que instancia dinámicamente tipos Image.

Item {
    id: fakeEmitter
    function burst(number) {
        while (number > 0) {
            let item = fakeParticle.createObject(root)
            item.lifeSpan = Math.random() * 5000 + 5000
            item.x = Math.random() * (root.width / 2) + (root.width / 2)
            item.y = 0
            number--
        }
    }

    Component {
        id: fakeParticle
        Image {
            id: container
            property int lifeSpan: 10000
            width: 32
            height: 32
            source: "qrc:///particleresources/glowdot.png"
            PropertyAnimation on y { from: -16; to: root.height - 16; duration: container.lifeSpan; running: true }
            SequentialAnimation on opacity {
                running: true
                NumberAnimation { from: 0; to: 1; duration: 500 }
                PauseAnimation { duration: container.lifeSpan - 1000 }
                NumberAnimation { from: 1; to: 0; duration: 500 }
                ScriptAction { script: container.destroy(); }
            }
        }
    }
}

Observa cómo los objetos `Image` no pueden colorearse aleatoriamente.

«Start» y «Stop» simplemente establecen los estados de ejecución y pausa de un « ParticleSystem ». Aunque el sistema no realiza ninguna simulación cuando está detenido o en pausa, al reiniciar se reanuda la simulación desde el principio, mientras que al reanudarla se retoma desde donde se había quedado.

Los cambios de grupo temporizados son un ejemplo que destaca el tipo « ParticleGroup ». Aunque normalmente basta con hacer referencia a los grupos mediante un nombre de cadena, se pueden conseguir efectos adicionales configurando las propiedades de los grupos. El primer grupo tiene una duración variable, pero siempre realiza una transición al segundo grupo.

ParticleGroup {
    name: "fire"
    duration: 2000
    durationVariation: 2000
    to: {"splode":1}
}

El segundo grupo tiene un « TrailEmitter » y una duración fija para emitir hacia el tercer grupo. Al colocar el « TrailEmitter » como hijo directo del « ParticleGroup », este selecciona automáticamente ese grupo para seguirlo.

ParticleGroup {
    name: "splode"
    duration: 400
    to: {"dead":1}
    TrailEmitter {
        group: "works"
        emitRatePerParticle: 100
        lifeSpan: 1000
        maximumEmitted: 1200
        size: 8
        velocity: AngleDirection {angle: 270; angleVariation: 45; magnitude: 20; magnitudeVariation: 20;}
        acceleration: PointDirection {y:100; yVariation: 20}
    }
}

El tercer grupo tiene un «Affector» como hijo directo, lo que hace que el «affector» se dirija automáticamente a este grupo. El «affector» permite que, tan pronto como las partículas entren en este grupo, se pueda invocar una función de ráfaga en otro emisor, utilizando las posiciones x e y de dicha partícula.

ParticleGroup {
    name: "dead"
    duration: 1000
    Affector {
        once: true
        onAffected: (x, y)=> worksEmitter.burst(400,x,y)
    }
}

Si TrailEmitter no se adapta a tus necesidades de emisores múltiples, también puedes crear emisores de forma dinámica sin dejar de utilizar el mismo ParticleSystem y la misma partícula de imagen

for (var i = 0; i < 8; i++) {
    let obj = emitterComp.createObject(root)
    obj.x = x
    obj.y = y
    obj.targetX = Math.random() * 240 - 120 + obj.x
    obj.targetY = Math.random() * 240 - 120 + obj.y
    obj.life = Math.round(Math.random() * 2400) + 200
    obj.emitRate = Math.round(Math.random() * 32) + 32
    obj.go()
}

Ten en cuenta que este efecto, una ráfaga de lanzas arcoíris voladoras, quedaría mejor con « TrailEmitter ». En este ejemplo se realiza únicamente con emisores dinámicos para mostrar el concepto de forma más sencilla.

«Multiple Painters» muestra cómo controlar el orden de pintura de partículas individuales. Aunque el orden de pintura de las partículas dentro de un «ImagePainter» no está definido de forma estricta, los objetos « ImageParticle » siguen las reglas normales de ordenación Z para Qt Quick elementos. Este ejemplo te permite pintar el interior de las partículas por encima de los bordes negros utilizando un par de ImageParticles, cada uno de los cuales pinta partes diferentes de la misma partícula lógica.

Proyecto de ejemplo en code.qt.io

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