En esta página

ParticleAffector QML Type

Aplica modificaciones a los atributos de las partículas lógicas en cualquier momento de su ciclo de vida. Más...

Import Statement: import QtQuick.Particles
Inherited By:

Affector, Age, Attractor, Friction, Gravity, GroupGoal, SpriteGoal, Turbulence, and Wander

Propiedades

Señales

Descripción detallada

El ParticleAffector básico no modifica ningún atributo, pero puede utilizarse para emitir una señal cuando una partícula cumple determinadas condiciones.

Si un «affector» tiene un tamaño definido, solo afectará a las partículas que se encuentren dentro de ese tamaño y posición en pantalla.

Los afectores tienen características de rendimiento diferentes a las del resto de elementos del sistema de partículas. En concreto, presentan algunas simplificaciones para intentar mantener la simulación en tiempo real o a mayor velocidad. Al ejecutar un sistema con afectores, los tiempos de fotograma irregulares que se alargan demasiado (más de un segundo por fotograma) harán que los afectores intenten tomar atajos con una simulación más rápida pero menos precisa. Si el sistema cuenta con varios afectores, no se garantiza el orden en que se aplican y, al simular desplazamientos temporales más grandes, cada uno simulará el desplazamiento completo, lo que puede dar lugar a resultados diferentes en comparación con los desplazamientos temporales más pequeños.

Es posible que en algunos equipos se consiga una simulación precisa con un gran número de partículas (cientos) y varios afectores, pero en equipos menos potentes cabe esperar pequeñas irregularidades en la simulación, ya que esta se realiza con menor granularidad.

Documentación de propiedades

enabled : bool

Si el valor de «enabled» es «false», este afector no afectará a ninguna partícula.

Normalmente se utiliza para activar o desactivar un afector de forma condicional.

El valor por defecto es «true».

groups : list<string>

¿Qué grupos de partículas lógicas se verán afectados?

Si se deja vacío, afectará a todas las partículas.

once : bool

Si «once» se establece en «true», este afector solo afectará a cada partícula una vez a lo largo de su vida útil. Si el afector simula normalmente un efecto continuo a lo largo del tiempo, simulará el efecto de un segundo de tiempo en el único instante en que afecte a la partícula.

El valor por defecto es «false».

shape : Shape

Si se ha definido un tamaño, la propiedad «shape» se puede utilizar para aplicar cambios a un área no rectangular.

system : ParticleSystem

Este es el sistema al que afectará el elemento. Si el « ParticleAffector » es un elemento secundario directo de un « ParticleSystem », se asociará automáticamente a este.

whenCollidingWith : list<string>

Si aquí se especifican grupos de partículas lógicos, el afector de partículas solo se activará si la partícula que se está examinando se cruza con una partícula de uno de estos grupos.

Esto difiere de la propiedad «groups». La propiedad «groups» selecciona qué partículas pueden ser examinadas y, si cumplen otros criterios (entre ellos, encontrarse dentro de los límites de la « ParticleAffector », modificada por la forma), se volverán a comprobar para ver si se cruzan con una partícula de uno de los grupos de partículas de «whenCollidingWith».

Por defecto, no se especifica ningún grupo.

Documentación de señales

affected(real x, real y)

Esta señal se emite cuando se selecciona una partícula para que se vea afectada. No se emitirá si el ` ParticleAffector ` tiene en cuenta una partícula, pero esta no sufre ningún cambio real.

En el caso especial en el que un « ParticleAffector » no tenga ningún efecto posible (por ejemplo, ParticleAffector {}), esta señal se emitirá para todas las partículas que se estén teniendo en cuenta si te conectas a ella. Esto te permite ejecutar código arbitrario en respuesta a las partículas (utiliza el controlador de señales ParticleAffector::onAffectParticles si deseas ejecutar código que afecte a las propias partículas). Dado que esto ejecuta código JavaScript por cada partícula, no se recomienda utilizar esta señal con un sistema de partículas de gran volumen.

(x, y) es la posición actual de la partícula.

Nota: El controlador correspondiente es onAffected.

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