En esta página

Particle3D QML Type

Partícula lógica abstracta. Más...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Object3D

Inherited By:

LineParticle3D, ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D

Propiedades

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.

ConstanteDescripción
Particle3D.AlignNoneSin alineación. La rotación de las partículas se puede definir con ` particleRotation`.
Particle3D.AlignTowardsTargetAlinea las partículas en la direcci alignTargetPosition.
Particle3D.AlignTowardsStartVelocityAlinea las partículas en la direcci velocity e de su punto de partida.

FadeType : enumeration

Define el tipo de efecto de fundido.

ConstanteDescripción
Particle3D.FadeNoneSin desvanecimiento.
Particle3D.FadeOpacityAtenúa la opacidad de las partículas desde/hasta 0,0.
Particle3D.FadeScaleAtenú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.

ConstanteDescripción
Particle3D.SortNoneSin ordenación.
Particle3D.SortNewestOrdenar según la vida útil de la partícula, de más reciente a más antigua.
Particle3D.SortOldestOrdenar según la vida útil de la partícula, primero las más antiguas.
Particle3D.SortDistanceOrdenar 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.