En esta página

ParticleSystem3D QML Type

Un sistema que incluye los tipos «partícula», «emisor» y «afector». Más...

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

Node

Propiedades

Métodos

Descripción detallada

Este elemento es la raíz del sistema de partículas, que gestiona la sincronización del sistema y agrupa todos los demás elementos relacionados, como partículas, emisores y afectores. Para agrupar los elementos del sistema, estos deben ser hijos directos de ParticleSystem3D, como se muestra a continuación:

ParticleSystem3D {
    ParticleEmitter3D {
        ...
    }
    SpriteParticle3D {
        ...
    }
}

O bien, si los elementos del sistema no son hijos directos, deben utilizar la propiedad « system » para indicar a qué ParticleSystem3D pertenecen. De esta forma:

ParticleSystem3D {
    id: psystem
}
ParticleEmitter3D {
    system: psystem
    ...
}
SpriteParticle3D {
    system: psystem
    ...
}

Documentación de la propiedad

logging : bool

Establece este valor en «true» para recopilar loggingData.

Nota: Esta propiedad afecta en cierta medida al rendimiento, por lo que no debe activarse en las versiones definitivas.

El valor por defecto es false.

Véase también loggingData.

loggingData : ParticleSystem3DLogging [read-only]

Esta propiedad contiene datos de registro que pueden resultar útiles a la hora de desarrollar y optimizar los efectos de partículas.

Nota: Esta propiedad solo contiene datos correctos cuando la opción « logging » está configurada en « true » y el sistema de partículas está en ejecución.

Véase también « logging ».

paused : bool

Esta propiedad define si el sistema está actualmente en pausa. Si la opción «En pausa» se establece en « true », el sistema de partículas no avanzará en la simulación. Cuando la opción «En pausa» se vuelva a establecer en « false », la simulación se reanudará desde el mismo punto en el que se detuvo.

El valor por defecto es false.

running : bool

Esta propiedad define si el sistema está actualmente en ejecución. Si la opción «Running» se establece en « false », el sistema de partículas detendrá la simulación. Todas las partículas se destruirán cuando el sistema vuelva a estar en ejecución.

La opción «Running» debe establecerse en « false » cuando se modifique o anime manualmente la propiedad « time ».

El valor por defecto es « true ».

seed : int

Esta propiedad define el valor inicial que se utiliza para la aleatorización de las partículas. Con el mismo valor inicial, el efecto de las partículas será idéntico en cada ejecución. Esto resulta útil cuando se prefiere un comportamiento determinista en lugar de uno aleatorio.

El valor por defecto es 0 cuando useRandomSeed está establecido en false, y un valor intermedio 1..INT32_MAX cuando useRandomSeed está establecido en true.

Nota: Esta propiedad no debe modificarse durante las animaciones de partículas.

Véase también useRandomSeed.

startTime : int

Esta propiedad define el tiempo, en milisegundos, en el que se inicia el sistema. Esto puede resultar útil para «calentar» el sistema, de modo que ya se haya emitido un conjunto de partículas. Si, por ejemplo, startTime se establece en 2000 y el sistema « time » se anima de 0 a 1000, en realidad la animación muestra partículas desde los 2000 hasta los 3000 ms.

El valor por defecto es ` 0`.

time : int

Esta propiedad define el tiempo en milisegundos para el sistema.

Nota: Al modificar la propiedad «time», normalmente se debe establecer « running » en « false ».

A continuación se muestra un ejemplo de cómo animar manualmente el sistema durante 3 segundos, en bucle, a media velocidad:

ParticleSystem3D {
    running: false
    NumberAnimation on time {
        loops: Animation.Infinite
        from: 0
        to: 3000
        duration: 6000
    }
}

useRandomSeed : bool

Esta propiedad define si la semilla del sistema de partículas debe ser aleatoria o definida por el usuario. Cuando se true, cada vez que se reinicia el sistema de partículas se genera un nuevo valor aleatorio para « seed ».

El valor por defecto es « true ».

Nota: Esta propiedad no debe modificarse durante las animaciones de partículas.

Véase también « seed ».

Documentación del método

void reset()

Este método restablece el estado interno del sistema de partículas a su estado inicial. Se puede utilizar cuando una propiedad de « running » está en « false » para restablecer el sistema. El « running » está en « true »: no es necesario llamar a este método, ya que el sistema gestiona el estado interno; sin embargo, cuando está en « false », es necesario indicar al sistema cuándo debe restablecerse.

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