ParticleSceneShape3D QML Type
Offers particle shape from a scene for emitters and affectors. More...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.11 |
| Inherits: |
Properties
- excludedNodes : list<Node>
- geometry : Node
- scene : Node
- sceneCenter : Node
- sceneExtents : Node
- shapeResolution : real
Detailed Description
The ParticleSceneShape3D element can be used to get particle shape from a 3D scene. The shape envelopes the scene into single shape based on the models in a scene.
For example,
ParticleEmitter3D {
id: emitter
particle: particle
...
shape: ParticleSceneShape3D {
id: sceneShape
scene: sceneRoot
sceneCenter: node.scenePosition
sceneExtents: Qt.vector3d(1000, 500, 1000)
}
...
}Property Documentation
excludedNodes : list<Node>
This property holds the list of nodes that are excluded when building the shape. Model is excluded from the shape if it is one of the nodes or their child node.
geometry : Node
This property holds the geometry of the generated shape. It can be used to render the shape to visualize it.
scene : Node
This property holds the root node of the scene. The scene shape is dynamically calculated based on the child models of the scene. If the scene changes, the shape is recalculated. If a model is not visible in the scene, it won't be included in the shape. Only the node visibility is checked by the implementation. If the material is fully transparent or the node gets filtered out, the shape will still contain those nodes unless they are manyally excluded.
sceneCenter : Node
This property holds the center point where the shape is calculated.
The default value is Qt.vector3(0, 0, 0).
sceneExtents : Node
This property holds the extents for which the shape is calculated. The extents are added to the scene center and any polygon outside this volume are left out of the shape. If this value is empty, all polygons are included.
The default value is Qt.vector3(0, 0, 0).
shapeResolution : real [default: 10.0;]
This property holds the resolution of the shape. The higher the value the more accurately the shape resembles individual models.
The minimum value is 1.0, the maximum value is 100.0;
© 2025 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.