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

# ParticleCustomShape3D QML Type

Loads custom particle shapes for emitters and affectors. More...

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

- List of all members, including inherited members

## Properties

- randomizeData : bool
- source : url

## Detailed Description

The ParticleCustomShape3D element can be used to load custom particle shapes.

For example, to emit particles from positions defined in heart.cbor:

     ParticleEmitter3D {
         shape: ParticleCustomShape3D {
             source: "heart.cbor"
         }
         ...
     }

The format of CBOR shape files is following:

     [
       "QQ3D_SHAPE", // string
       version, // integer
       [
         posX, // float
         posY, // float
         posZ, // float
         posX, // float
         ...
       ]
     ]

To assist in generating these shape files you can use the shapegen tool.

## Property Documentation

### randomizeData : bool

This property holds whether the particles are used in random order instead of in the order they are specified in the source.

The default value is `false`.

### source : url

This property holds the location of the shape file.

Warning: source is expected to contain trusted content. Application developers are advised to carefully consider the potential implications before passing in user-provided source files that are not part of the application.