ParticleSystem 管理粒子集合的更新和显示。
Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
optional
对象,具有以下属性:
|
Members
bursts : Array.<ParticleBurst>
一个
ParticleBurst
数组,在周期性时间发射粒子爆发。
-
Default Value:
undefined
complete : Event
当粒子系统达到其生命周期的终点时触发事件。
每秒要发射的粒子数。
-
Default Value:
5
粒子发射器
-
Default Value:
CircleEmitter
emitterModelMatrix : Matrix4
在粒子系统局部坐标系内变换粒子系统发射器的 4x4 变换矩阵。
-
Default Value:
Matrix4.IDENTITY
endColor : Color
粒子在其生命周期结束时的颜色。
-
Default Value:
Color.WHITE
应用于粒子生命周期结束时的图像的最终比例。
-
Default Value:
1.0
用于广告牌的 URI、HTMLImageElement 或 HTMLCanvasElement。
-
Default Value:
undefined
如果为
true
,则粒子系统已达到其生命周期的终点;<否则code>false否则code> 。
粒子系统发射粒子的时间(以秒为单位)。
-
Default Value:
Number.MAX_VALUE
粒子系统是否应该在完成时循环它的爆发。
-
Default Value:
true
maximumImageSize : Cartesian2
设置最大边界 width x height,低于该边界时,将随机缩放粒子图像的尺寸(以像素为单位)。
-
Default Value:
new Cartesian2(1.0, 1.0)
设置粒子的最大质量(以千克为单位)。
-
Default Value:
1.0
设置粒子寿命可能持续时间的最大限制(以秒为单位),低于该限制时将随机选择粒子的实际寿命。
-
Default Value:
5.0
设置最大限制(以米/秒为单位),低于该限制时将随机选择粒子的实际速度。
-
Default Value:
1.0
minimumImageSize : Cartesian2
设置最小边界 width x height,超过该边界时,将随机缩放粒子图像的尺寸(以像素为单位)。
-
Default Value:
new Cartesian2(1.0, 1.0)
设置粒子的最小质量(以千克为单位)。
-
Default Value:
1.0
设置粒子寿命可能持续时间的最小限制(以秒为单位),超过该限制将随机选择粒子的实际寿命。
-
Default Value:
5.0
设置最小限制(以米/秒为单位),超过该限制时将随机选择粒子的实际速度。
-
Default Value:
1.0
modelMatrix : Matrix4
将粒子系统从模型转换为世界坐标的 4x4 变换矩阵。
-
Default Value:
Matrix4.IDENTITY
是否显示粒子系统。
-
Default Value:
true
获取或设置是否粒子大小以米或像素为单位。以米为单位的颗粒大小为
真
;否则,大小以像素为单位。
-
Default Value:
false
startColor : Color
粒子在其生命周期开始时的颜色。
-
Default Value:
Color.WHITE
应用于粒子生命周期开始时图像的初始比例。
-
Default Value:
1.0
updateCallback : ParticleSystem.updateCallback
force 回调数组。回调将传递
Particle
以及与上次
-
Default Value:
undefined
Methods
销毁此对象持有的 WebGL 资源。 销毁对象允许确定性
释放 WebGL 资源,而不是依赖垃圾回收器来销毁这个对象。
一旦对象被销毁,就不应该使用它;调用
一旦对象被销毁,就不应该使用它;调用
isDestroyed
将导致 DeveloperError
异常。 因此
将返回值 (undefined
) 分配给对象,如示例中所示。
Throws:
-
DeveloperError : 这个物体被摧毁了,destroy().
Returns:
true
,如果此对象被销毁;否则为 false
。
Type Definitions
用于在每个时间步长修改粒子属性的函数。这可能包括 force 修改、
颜色、尺寸等。
Name | Type | Description |
---|---|---|
particle |
Particle | 正在更新的粒子。 |
dt |
number | 自上次更新以来的时间(以秒为单位)。 |
Example:
function applyGravity(particle, dt) {
const position = particle.position;
const gravityVector = Cesium.Cartesian3.normalize(position, new Cesium.Cartesian3());
Cesium.Cartesian3.multiplyByScalar(gravityVector, GRAVITATIONAL_CONSTANT * dt, gravityVector);
particle.velocity = Cesium.Cartesian3.add(particle.velocity, gravityVector, particle.velocity);
}