ModelParticle3D QML Type
Partícula que utiliza un modelo 3D de « Qt Quick ». Más información...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: |
Propiedades
- delegate : Component
- instanceTable : Instancing
Descripción detallada
ModelParticle3D es un elemento de partícula lógico que crea partículas a partir de un componente 3D « Qt Quick » Model.
Documentación de propiedades
delegate : Component
El delegado proporciona una plantilla que define cada objeto instanciado por la partícula.
Por ejemplo, para asignar 200 partículas de cubos rojos:
Component {
id: particleComponent
Model {
source: "#Cube"
scale: Qt.vector3d(0.2, 0.2, 0.2)
materials: DefaultMaterial { }
}
}
ModelParticle3D {
id: particleRed
delegate: particleComponent
maxAmount: 200
color: "#ff0000"
}Nota: El contenido instanciado desde el delegado conserva su propia asignación de « layers »; el valor de «layers» del « ParticleSystem3D » no se le aplica. Para renderizar las partículas en una capa de contenido específica, configura la propiedad «layers» en los nodos del delegado.
instanceTable : Instancing
La tabla `instanceTable` permite acceder a la tabla ` Instancing ` de la partícula del modelo. ` ModelParticle3D ` utiliza una tabla de instancias interna para implementar un renderizado eficiente. Esta tabla se puede aplicar a la propiedad ` instancing ` de los modelos que no forman parte del sistema de partículas.
También es posible utilizar esta función para proporcionar una tabla de instanciación sin mostrar ninguna partícula. Para ello, basta con omitir la propiedad ` delegate `. Por ejemplo:
ParticleSystem3D {
id: psystem
ModelParticle3D {
id: particleRed
maxAmount: 200
color: "#ff0000"
colorVariation: Qt.vector4d(0.5,0.5,0.5,0.5)
}
ParticleEmitter3D {
particle: particleRed
velocity: VectorDirection3D {
direction: Qt.vector3d(-20, 200, 0)
directionVariation: Qt.vector3d(20, 20, 20)
}
particleScale: 0.2
emitRate: 20
lifeSpan: 2000
}
}
Model {
source: "#Sphere"
instancing: particleRed.instanceTable
materials: PrincipledMaterial {
baseColor: "yellow"
}
}© 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.