- Qt 6.12
- Qt Quick 3D
- QML Types
- QtQuick3D.Particles3D
- ParticleSceneShape3D
- Qt Quick 3D | Commercial or GPLv3

# ParticleSceneShape3D QML Type

Offers particle shape from a scene for emitters and affectors. More...

Import Statement: | `import QtQuick3D.Particles3D`
Since: | Qt 6.11
Inherits: | ParticleAbstractShape3D

- List of all members, including inherited members

## 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;