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, utilice ModelParticle3D o SpriteParticle3D en su lugar.
Nota: A diferencia de los materiales utilizados con los modelos, las partículas se renderizan por defecto asumiendo la semitransparencia, y por tanto con la mezcla activada. Este es el comportamiento deseado la mayoría de las veces debido a las texturas de las partículas, variaciones de color (alfa), desvanecimientos, etc. Si no necesita el blending, configure hasTransparency a false para posibles ganancias 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 puede definirse con particleRotation. |
Particle3D.AlignTowardsTarget | Alinea las partículas hacia la dirección alignTargetPosition. |
Particle3D.AlignTowardsStartVelocity | Alinea las partículas hacia su dirección inicial velocity. |
FadeType : enumeration
Define el tipo de efecto de desvanecimiento.
| Constante | Descripción |
|---|---|
Particle3D.FadeNone | Sin desvanecimiento. |
Particle3D.FadeOpacity | Desvanece la opacidad de las partículas desde/hasta 0.0. |
Particle3D.FadeScale | Desvanece la escala de las partículas desde/hasta 0.0. |
SortMode : enumeration
Define el modo de ordenación de las partículas. El modo de clasificación determina el orden en que se dibujan las partículas.
| Constante | Descripción |
|---|---|
Particle3D.SortNone | Sin ordenación. |
Particle3D.SortNewest | Ordenar según el tiempo de vida de la partícula, la más nueva primero. |
Particle3D.SortOldest | Ordenar según el tiempo de vida de las partículas, las más antiguas primero. |
Particle3D.SortDistance | Ordenar en base a la distancia a la cámara, la más lejana primero. |
alignMode : AlignMode
Esta propiedad define el modo de alineación utilizado para las partículas. La alineación de las partículas se refiere a la dirección en la que están orientadas.
Nota: Cuando la propiedad SpriteParticle3D billboard se establece en true, alignMode no tiene efecto.
El valor por defecto es Particle3D.AlignNone.
Ver también alignTargetPosition.
alignTargetPosition : vector3d
Esta propiedad define la posición a la que se alinean las partículas. Esta propiedad sólo tiene efecto cuando alignMode tiene el valor Particle3D.AlignTowardsTarget.
Véase también alignMode.
color : color
Esta propiedad define el color base que se utiliza para colorear las partículas.
El valor por defecto es "#FFFFFF" (blanco).
colorVariation : vector4d
Esta propiedad define la variación de color que se utiliza para colorear las partículas. Los valores están en orden RGBA y cada valor debe estar entre 0.0 (sin variación) y 1.0 (variación completa).
Por ejemplo, para crear partículas que tendrán 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 desvanecimiento.
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 totalmente visible de la partícula 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 desvanecimiento utilizado 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 utilizado 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 alguna transparencia y debe mezclarse con el fondo. Normalmente esto debería ser verdadero, como cuando el color de la partícula no tiene alfa completo, la textura contiene píxeles semitransparentes o la opacidad de las partículas se desvanece hacia dentro o hacia fuera. Establecer esto a false puede ser una optimización en casos específicos.
El valor por defecto es true.
Ver 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 maxAmount es demasiado pequeño, las partículas se reutilizan antes de llegar al final de su lifeSpan. Si el maxAmount es demasiado grande, se asigna memoria innecesaria para las partículas.
Nota: Cambiar el maxAmount reinicia todas las partículas en el sistema de partículas.
El valor por defecto es 100.
sortMode : SortMode
Esta propiedad define el modo de ordenación utilizado para las partículas.
El valor por defecto es Particle3D.SortNone.
unifiedColorVariation : bool
Esta propiedad define si el colorVariation debe aplicarse uniformemente para todos los canales de color. Esto significa que todas las variaciones se aplican con la misma cantidad aleatoria.
Por ejemplo, para crear partículas que tendrán colores amarillos entre #ffff00 y #7f7f00, de forma 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.