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

ConstanteDescripción
Particle3D.AlignNoneSin alineación. La rotación de las partículas puede definirse con particleRotation.
Particle3D.AlignTowardsTargetAlinea las partículas hacia la dirección alignTargetPosition.
Particle3D.AlignTowardsStartVelocityAlinea las partículas hacia su dirección inicial velocity.

FadeType : enumeration

Define el tipo de efecto de desvanecimiento.

ConstanteDescripción
Particle3D.FadeNoneSin desvanecimiento.
Particle3D.FadeOpacityDesvanece la opacidad de las partículas desde/hasta 0.0.
Particle3D.FadeScaleDesvanece 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.

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