Uso del sistema de partículas « Qt Quick »
La documentación sobre todos los tipos de sistemas de partículas se puede consultar 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.ParticlesEl sistema de partículas
Este sistema de partículas contiene cuatro tipos principales de tipos QML: « ParticleSystem », «Painters», «Emitters» y «Affectors».
El tipo « ParticleSystem » vincula todos los demás tipos y gestiona la línea de tiempo compartida. Los «Painters», «Emitters» y «Affectors» deben tener todos el mismo « ParticleSystem » para poder interactuar entre sí.
Puedes tener tantos «ParticleSystems» como desees, siempre que se respete esta restricción; por lo tanto, la separación lógica consiste en tener un único « ParticleSystem » para todos los tipos que desees que interactúen, o solo uno si el número de tipos es reducido y se pueden controlar fácilmente.
Partículas lógicas
Todos los tipos de sistemas 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 es sobre esta sobre la que actúan los tipos. No todas las partículas lógicas tienen que visualizarse, y algunas partículas lógicas podrían dar lugar a que se dibujen varias partículas visuales en pantalla.
Grupos de partículas
Cada partícula lógica forma parte de un grupo de partículas, y cada grupo se identifica mediante 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 funciona igual que cualquier otro grupo. Los grupos se utilizan con dos fines: para controlar las partículas y porque pueden tener transiciones de estado estocásticas.
Los grupos controlan las partículas porque nunca se puede acceder a una partícula individual con ninguno de los tipos de sistemas de partículas. Todos los tipos actúan sobre los grupos en su conjunto, por lo que cualquier partícula que deba comportarse de forma diferente a las demás (aparte de la variación habitual de los parámetros estocásticos) deberá estar en un grupo distinto.
Las partículas también pueden cambiar de grupo de forma dinámica. Cuando esto ocurre, la trayectoria de las partículas no se ve alterada, pero pueden verse afectadas por diferentes ParticlePainters o Affectors. El grupo de las partículas puede ser modificado por un Affector, o bien pueden definirse transiciones de estado estocásticas en un tipo de « ParticleGroup ».
Por lo general, los grupos solo deben definirse en un « ParticleGroup » si requieren transiciones de estado estocásticas. De lo contrario, basta con que los grupos se definan simplemente mediante las cadenas de caracteres utilizadas en las propiedades «particle» o «particles» de los tipos.
Emisores
Los emisores emiten partículas lógicas al sistema. Estas partículas tienen una trayectoria y una vida útil, pero no se visualizan. 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 indicado dentro de los límites de un « TrailEmitter » provocará la emisión de partículas desde su ubicación, como si hubiera un emisor en ella con las mismas propiedades que el « TrailEmitter ».
ParticlePainters
Los «Painters» son los tipos que visualizan las partículas lógicas. Por cada partícula lógica de los grupos que se le hayan asignado, que se encuentre dentro de sus límites (o fuera de ellos, si no se configura la propiedad «clip» en el tipo), se visualizará de una manera que depende del tipo de « ParticlePainter ». El tipo base ` ParticlePainter ` no dibuja nada. ` ImageParticle ` representa 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.
Dado que el « ParticlePainter » es el tipo QML que visualiza las partículas en la escena, es su valor Z el que resulta importante a la hora de colocar visualmente las partículas por encima o por debajo de otros tipos.
Afectores
Los afectores son un componente opcional de un sistema de partículas. Pueden realizar diversas manipulaciones en la simulación, como alterar la trayectoria de las partículas o poner fin prematuramente a su vida en la simulación. Por motivos de rendimiento, se recomienda no utilizar afectores en sistemas de partículas de gran volumen.
Parámetros estocásticos
Dado que los sistemas de partículas se benefician del control estocástico de los parámetros en un gran número de instancias, el sistema de partículas utiliza varios tipos auxiliares estocásticos. Si no deseas que haya ninguna variación estocástica en estos parámetros, no especifiques ninguna variación en estos tipos.
Direcciones
Las direcciones pueden especificarse mediante el ángulo y la magnitud, o mediante los componentes x e y. Aunque cualquier dirección puede especificarse con cualquiera de los dos métodos, existe una diferencia significativa entre variar los componentes x e y y variar el ángulo y la magnitud. Variar las 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 las formas, sino que se utilizan con el fin de seleccionar un punto aleatorio dentro de la forma. Si deseas un punto específico sin aleatoriedad, utiliza una forma de ancho 0 y altura 0 (que es el valor por defecto). De lo contrario, puede utilizar los tipos de forma para especificar un área, de modo que el resultado utilice un punto aleatorio seleccionado de dicha área.
Véase también Qt Quick Ejemplos de partículas: emisores, ejemplos de afectores, ejemplos de partículas de imagen y ejemplo de 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.