En esta página

Uso del sistema de partículas Qt Quick

La documentación de todos los tipos del Sistema de Partículas se encuentra en la página del módulo QtQuick.Particles.

Para utilizar los tipos del módulo de partículas, importa el módulo con la siguiente línea:

import QtQuick.Particles

El sistema de partículas

Este sistema de partículas contiene cuatro tipos principales de tipos QML: ParticleSystem Pintores, Emisores y Afectores.

El tipo ParticleSystem vincula todos los demás tipos, y gestiona la línea de tiempo compartida. Los Pintores, Emisores y Afectores deben tener todos el mismo ParticleSystem para poder interactuar entre sí.

Puedes tener tantos ParticleSystems como quieras sujetos a esta restricción, así que la separación lógica es tener un ParticleSystem para todos los tipos que quieras que interactúen, o sólo uno si el número de tipos es pequeño y se mantienen fácilmente bajo control...

Partículas lógicas

Todos los tipos del sistema de partículas actúan sobre "partículas lógicas". Cada partícula tiene una representación lógica dentro del sistema de partículas, y esto es sobre lo que actúan los tipos. No todas las partículas lógicas necesitan ser visualizadas, y algunas partículas lógicas pueden llevar a que se dibujen múltiples partículas visuales en pantalla.

Grupos de partículas

Cada partícula lógica es miembro de un grupo de partículas, y cada grupo se identifica por un nombre. Si no se ha especificado ningún otro grupo, una partícula lógica pertenece al grupo con el nombre "" (la cadena vacía), que actúa igual que cualquier otro grupo. Los grupos se utilizan con dos propósitos, para controlar partículas y porque pueden tener transiciones de estado estocásticas.

Los grupos controlan partículas porque nunca se puede acceder a una partícula individual con ninguno de los tipos del sistema de partículas. Todos los tipos actúan sobre grupos como un todo, por lo que cualquier partícula que necesite comportarse de forma diferente entre sí (aparte de la habitual variación estocástica de parámetros) necesitará estar en grupos diferentes.

Las partículas también pueden cambiar de grupo dinámicamente. Cuando esto ocurre, la trayectoria de las partículas no se ve alterada, pero pueden actuar sobre ella diferentes ParticlePainters o Affectors. Las partículas pueden tener su grupo cambiado por un Afector, o pueden definirse transiciones de estado estocásticas en un tipo ParticleGroup.

Generalmente, los grupos sólo deben definirse en ParticleGroup si requieren transiciones estocásticas de estado. De lo contrario, es suficiente con que los grupos se definan simplemente mediante las cadenas utilizadas en las propiedades de partícula/partícula de los tipos.

Emisores

Los emisores emiten partículas lógicas en el sistema. Estas partículas tienen trayectoria y vida útil, pero no visualización. Estas partículas se emiten desde la ubicación del Emisor.

Los TrailEmitters son un tipo especial de emisor que emite partículas desde la ubicación de otras partículas lógicas. Cualquier partícula lógica del tipo seguido dentro de los límites de un TrailEmitter provocará la emisión de partículas desde su ubicación, como si hubiera un Emisor sobre ella con las mismas propiedades que el TrailEmitter.

Pintores de partículas

Los pintores son los tipos que visualizan las partículas lógicas. Para cada partícula lógica de los grupos asignados a ella, que se encuentren dentro de sus límites (o fuera, si no se establece la propiedad clip en el tipo) se visualizará de una manera dependiente del tipo de ParticlePainter. El tipo base de ParticlePainter no dibuja nada. ImageParticle renderiza una imagen en la ubicación de la partícula. ItemParticle permite visualizar partículas lógicas utilizando delegados QML arbitrarios. ModelParticle es similar, pero coordina los datos del modelo entre los delegados de forma similar a las clases de vista.

Como ParticlePainter es la clase QML que visualiza las partículas en la escena, es su valor Z el que es importante cuando se trata de colocar partículas por encima o por debajo de otros tipos visualmente.

Afectores

Los afectores son un componente opcional de un sistema de partículas. Pueden realizar una variedad de manipulaciones a la simulación, como alterar la trayectoria de las partículas o terminar prematuramente su vida en la simulación. Por razones de rendimiento, se recomienda no utilizar Afectores en sistemas de partículas de gran volumen.

Parámetros estocásticos

Como los sistemas de partículas se benefician del control estocástico de los parámetros a través de un gran número de instancias, el sistema de partículas utiliza varios tipos de ayudantes estocásticos. Si no desea tener ninguna variación estocástica en estos parámetros, entonces no especifique ninguna variación en estos tipos.

Direcciones

Las direcciones pueden especificarse por ángulo y magnitud, o por componentes x e y. Aunque se puede especificar cualquier dirección con cualquiera de los dos métodos, hay una diferencia significativa entre variar los componentes x e y y variar el ángulo y la magnitud. Variar los componentes x e y dará lugar a un área rectangular alrededor del punto especificado, mientras que variar el ángulo dará lugar a un arco centrado en el punto especificado.

Formas

El sistema de partículas contiene varios tipos que representan formas. Estos tipos no visualizan formas, y se utilizan con el propósito de seleccionar un punto aleatorio dentro de la forma. Si desea un punto específico sin aleatoriedad, utilice una forma de anchura 0 y altura 0 (que es la predeterminada). De lo contrario, puede utilizar los tipos de forma para especificar un área, de modo que el resultado pueda utilizar un punto aleatorio seleccionado de esa área.

Ver también Qt Quick Particles Ejemplos - Emisores, Ejemplos Afectores, Ejemplos Partículas Imagen, y Ejemplos Afectores - Sistema.

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