Emitter for logical particles. 更多...
| import 语句： | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| 继承： | Node |
| 继承者： | TrailEmitter3D |
This element emits logical particles into the ParticleSystem3D , with the given starting attributes.
At least one emitter is required to have particles in the ParticleSystem3D . There are a few different ways to control the emitting amount:
|
depthBias : real |
Holds the depth bias of the emitter. Depth bias is added to the object distance from camera when sorting objects. This can be used to force rendering order between objects close to each other, that might otherwise be rendered in different order in different frames. Negative values cause the sorting value to move closer to the camera while positive values move it further from the camera.
|
emitBursts : List < EmitBurst3D > |
This property takes a list of EmitBurst3D elements, to declaratively define bursts. If the burst starting time, amount, and duration are known beforehand, it is better to use this property than e.g. calling burst () 采用 Timer .
For example, to emit 100 particles at the beginning, and 50 particles at 2 seconds:
ParticleEmitter3D { emitBursts: [ EmitBurst3D { time: 0 amount: 100 }, EmitBurst3D { time: 2000 amount: 50 } ] }
另请参阅 burst ().
|
emitRate : real |
This property defines the constant emitting rate in particles per second. For example, if the emitRate is 120 and system animates at 60 frames per second, 2 new particles are emitted at every frame.
默认值为
0
.
|
enabled : bool |
If enabled is set to
false
, this emitter will not emit any particles. Usually this is used to conditionally turn an emitter on or off. If you want to continue emitting burst, keep
emitRate
at 0 instead of toggling this to
false
.
默认值为
true
.
|
lifeSpan : int |
This property defines the lifespan of a single particle in milliseconds.
默认值为
1000
.
另请参阅 lifeSpanVariation .
|
lifeSpanVariation : int |
This property defines the lifespan variation of a single particle in milliseconds.
For example, to emit particles which will exist between 3 and 4 seconds:
ParticleEmitter3D {
...
lifeSpan: 3500
lifeSpanVariation: 500
}
默认值为
0
.
另请参阅 lifeSpan .
|
particle : Particle3D |
This property defines the logical particle which this emitter emits. Emitter must have a particle defined, or it doesn't emit anything. Particle can be either SpriteParticle3D or ModelParticle3D .
|
particleEndScale : real |
This property defines the scale multiplier of the particles at the end of particle lifeSpan . To have variation in the particle end sizes, use particleEndScaleVariation . When the value is negative, end scale is the same as the particleScale , so scale doesn't change during the particle lifeSpan .
默认值为
-1.0
.
另请参阅 particleScale and particleScaleVariation .
|
particleEndScaleVariation : real |
This property defines the scale variation of the particles in the end. When the value is negative, particleScaleVariation is used also for the end scale. For example, to emit particles which start at scale 0.5 - 1.5 and end at scale 1.0 - 5.0:
ParticleEmitter3D {
...
particleScale: 1.0
particleScaleVariation: 0.5
particleEndScale: 3.0
particleEndScaleVariation: 2.0
}
默认值为
-1.0
.
另请参阅 particleEndScale .
|
particleRotation : vector3d |
This property defines the rotation of the particles in the beginning. Rotation is defined as degrees in euler angles.
另请参阅 particleRotationVariation .
|
particleRotationVariation : vector3d |
This property defines the rotation variation of the particles in the beginning. Rotation variation is defined as degrees in euler angles.
For example, to emit particles in fully random rotations:
ParticleEmitter3D {
...
particleRotationVariation: Qt.vector3d(180, 180, 180)
}
另请参阅 particleRotation .
|
particleRotationVelocity : vector3d |
This property defines the rotation velocity of the particles in the beginning. Rotation velocity is defined as degrees per second in euler angles.
另请参阅 particleRotationVelocityVariation .
|
particleRotationVelocityVariation : vector3d |
This property defines the rotation velocity variation of the particles. Rotation velocity variation is defined as degrees per second in euler angles.
For example, to emit particles in random rotations which have random rotation velocity between -100 and 100 degrees per second into any directions:
ParticleEmitter3D {
...
particleRotationVariation: Qt.vector3d(180, 180, 180)
particleRotationVelocityVariation: Qt.vector3d(100, 100, 100)
}
另请参阅 particleRotationVelocity .
|
particleScale : real |
This property defines the scale multiplier of the particles at the beginning. To have variation in the particle sizes, use particleScaleVariation .
默认值为
1.0
.
另请参阅 particleEndScale and particleScaleVariation .
|
particleScaleVariation : real |
This property defines the scale variation of the particles. For example, to emit particles at scale 0.5 - 1.5:
ParticleEmitter3D {
...
particleScale: 1.0
particleScaleVariation: 0.5
}
默认值为
0.0
.
另请参阅 particleScale and particleEndScaleVariation .
|
shape : ParticleAbstractShape3D |
This property defines optional shape for the emitting area. It can be either ParticleShape3D or ParticleModelShape3D . Shape is scaled, positioned and rotated based on the emitter node properties. When the Shape fill property is set to false, emitting happens only from the surface of the shape.
When the shape is not defined, emitting is done from the center point of the emitter node.
|
system : ParticleSystem3D |
This property defines the ParticleSystem3D for the emitter. If system is direct parent of the emitter, this property does not need to be defined.
|
velocity : Direction3D |
This property can be used to set a starting velocity for emitted particles. If velocity is not set, particles start motionless and velocity comes from affectors if they are used.
This method emits count amount of particles from this emitter immediately.
This method emits count amount of particles from this emitter during the next duration 毫秒。
|
vector3d burst ( int count , int duration , vector3d position ) |
This method emits count amount of particles from this emitter during the next duration milliseconds. The particles are emitted as if the emitter was at position but all other properties are the same.