Particle3D QML Type
Partícula lógica abstracta. Más...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | LineParticle3D, ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D |
Propiedades
- AlignMode : enumeration
- FadeType : enumeration
- SortMode : enumeration
- alignMode : AlignMode
- alignTargetPosition : vector3d
- color : color
- colorVariation : vector4d
- fadeInDuration : int
- fadeInEffect : FadeType
- fadeOutDuration : int
- fadeOutEffect : FadeType
- hasTransparency : bool
- maxAmount : int
- sortMode : SortMode
- unifiedColorVariation : bool
Descripción detallada
Este elemento define las propiedades comunes de las partículas lógicas. Particle3D es una clase base abstracta de partículas; utiliza en su lugar ModelParticle3D o SpriteParticle3D.
Nota: A diferencia de los materiales utilizados con los modelos, las partículas se representan por defecto con semitransparencia, por lo que la mezcla está activada. Este es el comportamiento deseado en la mayoría de los casos debido a las texturas de las partículas, las variaciones de color (alfa), los desvanecimientos, etc. Si no necesitas la mezcla, configura hasTransparency en false para obtener posibles mejoras de rendimiento.
Documentación de propiedades
AlignMode : enumeration
Define el tipo de alineación.
| Constante | Descripción |
|---|---|
Particle3D.AlignNone | Sin alineación. La rotación de las partículas se puede definir con ` particleRotation`. |
Particle3D.AlignTowardsTarget | Alinea las partículas en la direcci alignTargetPosition. |
Particle3D.AlignTowardsStartVelocity | Alinea las partículas en la direcci velocity e de su punto de partida. |
FadeType : enumeration
Define el tipo de efecto de fundido.
| Constante | Descripción |
|---|---|
Particle3D.FadeNone | Sin desvanecimiento. |
Particle3D.FadeOpacity | Atenúa la opacidad de las partículas desde/hasta 0,0. |
Particle3D.FadeScale | Atenúa la escala de la partícula desde/hasta 0,0. |
SortMode : enumeration
Define el modo de ordenación de la partícula. El modo de ordenación determina el orden en el que se dibujan las partículas.
| Constante | Descripción |
|---|---|
Particle3D.SortNone | Sin ordenación. |
Particle3D.SortNewest | Ordenar según la vida útil de la partícula, de más reciente a más antigua. |
Particle3D.SortOldest | Ordenar según la vida útil de la partícula, primero las más antiguas. |
Particle3D.SortDistance | Ordenar según la distancia a la cámara, las más lejanas primero. |
alignMode : AlignMode
Esta propiedad define el modo de alineación que se utiliza para las partículas. La alineación de las partículas se refiere a la dirección hacia la que están orientadas.
Nota: Cuando la propiedad « SpriteParticle3D » billboard está establecida en « true », «alignMode» no tiene ningún efecto.
El valor predeterminado es « Particle3D.AlignNone ».
Véase también « alignTargetPosition ».
alignTargetPosition : vector3d
Esta propiedad define la posición con respecto a la cual se alinean las partículas. Esta propiedad solo surte efecto cuando la opción « alignMode » está configurada en « Particle3D.AlignTowardsTarget ».
Véase también « alignMode ».
color : color
Esta propiedad define el color base que se utiliza para dar color a las partículas.
El valor por defecto es « "#FFFFFF" » (blanco).
colorVariation : vector4d
Esta propiedad define la variación de color que se utiliza para dar color a las partículas. Los valores se expresan en orden RGBA y cada valor debe estar comprendido entre 0,0 (sin variación) y 1,0 (variación total).
Por ejemplo, para crear partículas que tengan colores rojos translúcidos entre #ff0000 y #e50000, con una opacidad del 40 % al 60 %:
ModelParticle3D {
...
color: "#7fff0000"
colorVariation: Qt.vector4d(0.1, 0.0, 0.0, 0.2)
}El valor por defecto es (0, 0, 0, 0) (sin variación).
Véase también unifiedColorVariation.
fadeInDuration : int
Esta propiedad define la duración, en milisegundos, del efecto de aparición gradual.
Nota: Las duraciones de desvanecimiento forman parte de las partículas lifeSpan. Así, por ejemplo, si lifeSpan es 3000, fadeInDuration es 500 y fadeOutDuration es 500, el tiempo en el que la partícula está totalmente visible es de 2000 ms.
El valor por defecto es 250.
Véase también fadeInEffect y fadeOutDuration.
fadeInEffect : FadeType
Esta propiedad define el efecto de fundido que se utiliza cuando aparecen las partículas.
El valor por defecto es « Particle3D.FadeOpacity ».
Véase también « fadeInDuration » y « fadeOutEffect ».
fadeOutDuration : int
Esta propiedad define la duración, en milisegundos, del efecto de desvanecimiento.
El valor por defecto es 250.
Véase también fadeOutEffect y fadeInDuration.
fadeOutEffect : FadeType
Esta propiedad define el efecto de desvanecimiento que se aplica cuando las partículas alcanzan su lifeSpan y desaparecen.
El valor por defecto es Particle3D.FadeOpacity.
Véase también « fadeOutDuration » y « fadeInEffect ».
hasTransparency : bool
Esta propiedad define si la partícula tiene transparencia y debe fusionarse con el fondo. Normalmente, este valor debe ser «true», por ejemplo, cuando el color de la partícula no tiene un alfa completo, la textura contiene píxeles semitransparentes o la opacidad de la partícula se atenúa o se intensifica progresivamente. Establecer este valor en «false» puede suponer una optimización en casos concretos.
El valor por defecto es « true ».
Véase también color, fadeInEffect y fadeOutEffect.
maxAmount : int
Esta propiedad define la cantidad máxima de partículas que pueden existir al mismo tiempo. Puedes utilizar « particlesUsed » para depurar la eficiencia con la que se utilizan las partículas asignadas. Si el valor de «maxAmount» es demasiado pequeño, las partículas se reutilizan antes de que lleguen al final de su ciclo de vida ( lifeSpan). Si el valor de «maxAmount» es demasiado grande, se asigna memoria innecesaria a las partículas.
Nota: Al modificar el valor de maxAmount, se reinician todas las partículas del sistema de partículas.
El valor por defecto es 100.
sortMode : SortMode
Esta propiedad define el modo de ordenación que se utiliza para las partículas.
El valor por defecto es « Particle3D.SortNone ».
unifiedColorVariation : bool
Esta propiedad define si el « colorVariation » debe aplicarse de forma uniforme a todos los canales de color. Esto significa que todas las variaciones se aplican con el mismo grado de aleatoriedad.
Por ejemplo, para crear partículas que tengan colores amarillos comprendidos entre #ffff00 y #7f7f00, de modo que los valores de los canales de color R y G sean siempre los mismos:
ModelParticle3D {
...
color: "#ffff00"
colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
unifiedColorVariation: true
}El valor por defecto es false.
Véase también colorVariation.
© 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.