1. ParticleLayer
粒子系统图层
1.1. 初始化 new ParticleLayer(options)
Param | Type | Default | Description |
---|---|---|---|
options | Object |
包含以下参数的对象 |
|
[options.image] | String |
可选,粒子图片,火、喷泉、烟雾等图片,如果设置,则使用此值覆盖particleType输入。 |
|
[options.particleType] | String |
'fire' |
可选,当image为空时,设置默认常用类型的粒子图片,火:'fire'、喷泉:'fountain'、烟雾:'smoke'等类型,默认为'fire'。 |
[options.emitterType] | String |
'circle' |
可选,扩散类型 圆形 circle、 盒子 box 、球形 sphere、 锥 cone,默认为'circle'。 |
[options.emissionRate] | Number |
5 |
可选, 每秒要发射的粒子数,默认为5。 |
[options.particleLife] | Number |
可选,如果设置,则使用此值覆盖minimumParticleLife和maximumParticleLife输入。 |
|
[options.minimumParticleLife] | Number |
1 |
可选,设置以秒为单位的粒子生命的可能持续时间的最小范围,在该时间范围内可以随机选择粒子的实际生命,默认为1。 |
[options.maximumParticleLife] | Number |
1 |
可选,设置粒子寿命的可能持续时间的最大限制(以秒为单位),在该范围内将随机选择粒子的实际寿命,默认为1。 |
[options.speed] | Number |
可选,如果设置,则用该值覆盖minimumSpeed和maximumSpeed输入。 |
|
[options.minimumSpeed] | Number |
1 |
可选,设置以米/秒为单位的最小界限,高于该界限时,将随机选择粒子的实际速度,默认为1。 |
[options.maximumSpeed] | Number |
1 |
可选,设置以米/秒为单位的最大范围,在该范围内将随机选择粒子的实际速度,默认为4。 |
[options.scale] | Number |
可选,设置缩放比例,以在粒子的生命周期内应用于粒子的图像,如果设置,则用该值覆盖startScale和endScale输入。 |
|
[options.startScale] | Number |
1 |
可选,在粒子寿命开始时应用于粒子图像的初始比例,默认为1。 |
[options.endScale] | Number |
5.0 |
可选,在粒子寿命结束时应用于粒子图像的最终比例,默认为5。 |
[options.imageSize] | Array |
可选,如果设置,则将覆盖用来缩放粒子图像尺寸(以像素为单位)的minimumImageSize和maximumImageSize输入。 |
|
[options.minimumImageSize] | Array |
[2.0, 2.0] |
可选,设置宽度的最小范围,以高度为单位,在该范围之上可以随机缩放粒子图像的尺寸(以像素为单位),默认为[2.0, 2.0]。 |
[options.maximumImageSize] | Array |
[10.0, 10.0] |
可选,设置最大宽度宽度(以高度为单位),在该范围内可以随机缩放粒子图像的尺寸(以像素为单位),默认为[10.0, 10.0]。 |
[options.lifetime] | Number |
16 |
可选,粒子系统发射粒子的时间(以秒为单位),默认为16。 |
[options.sizeInMeters] | Boolean |
可选,options.sizeInMeters 设置粒子的大小是米还是像素。 true 以米为单位调整粒子大小;否则,大小以像素为单位。 |
|
[options.show] | Boolean |
true |
可选, 是否显示粒子系统,true 为显示,false为隐藏,默认为true。 |
[options.loop] | Boolean |
true |
可选, 粒子系统完成后是否应该循环爆发,true 为显示,false为隐藏,默认为true。 |
[options.color] | String |
可选,设置粒子在其粒子寿命期间的颜色。 |
|
[options.startColor] | String |
'#FFFFFF' |
可选,粒子在其生命初期的颜色,默认为'#FFFFFF'。 |
[options.endColor] | String |
'#FFFFFF' |
可选,粒子寿命结束时的颜色,默认为'#FFFFFF'。 |
[options.startOpacity] | Number |
1 |
可选,粒子在其生命初期的颜色的不透明度,默认为1。 |
[options.endOpacity] | Number |
0.9 |
可选,粒子寿命结束时的颜色的不透明度,默认为0.9。 |
[options.gravity] | Number |
2 |
可选,粒子的重力加速度,默认为2。 |
Example
let particle = new BOSGeo.ParticleLayer({
// image: 'Assets/Images/effect/fire.png',
particleType: 'fire',
emitterType: 'circle', // 扩散类型 圆形 circle 盒子 box 球形 sphere cone
gravity: 0.0,
emissionRate: 200.0,
// imageSize: [15,15],
minimumParticleLife: 1.5,
maximumParticleLife: 1.8,
minimumSpeed: 7.0,
maximumSpeed: 9.0,
startScale: 3,
endScale: 1.5,
lifetime: 5,
startOpacity: 0.8,
endOpacity: 0.3,
startColor: '#b02b1a',
endColor: '#000000'
});
particle.modelMatrix = BOSGeo.GeoUtil.computeModelMatrix(113.10635, 23.02892, 17.06, 0, 0, 0);
1.2. 属性
属性名 | Type | Default | Description |
---|---|---|---|
modelMatrix | Matrix4 |
将粒子系统从模型转换为世界坐标的4x4转换矩阵 |
1.3. 方法
1.3.1. particleLayer.zoomTo()
缩放至图层
Example
particle.zoomTo();
1.3.2. particleLayer.setVisible(visible)
设置显隐
Param | Type | Description |
---|---|---|
visible | Boolean |
true为显示,false为隐藏 |
Example
particle.setVisible(false);
1.3.3. particleLayer.remove()
移除
Example
particle.remove();