3.1.12 ParticleSystem 组件参考

优质
小牛编辑
133浏览
2023-12-01

概述

该组件是用来读取 粒子资源 数据,并且对其进行一系列例如播放、暂停、销毁等操作。

创建方式

ParticleSystem 组件可通过编辑器和脚本两种方式创建,如下所示

1、通过编辑器创建

点击 属性检查器 下方的 添加组件 按钮,然后从 渲染组件 中选择 ParticleSystem,即可添加 ParticleSystem 组件到节点上。

2、通过脚本创建

  // 创建一个节点
  var node = new cc.Node();
  // 将节点添加到场景中
  cc.director.getScene().addChild(node);
  // 添加粒子组件到 Node 上
  var particleSystem = node.addComponent(cc.ParticleSystem);
  // 接下去就可以对 particleSystem 这个对象进行一系列操作了

ParticleSystem 的脚本接口请参考 ParticleSystem API

ParticleSystem 属性

属性功能说明
Preview在编辑器模式下预览粒子,启用后选中粒子时,粒子将自动播放
Play On Load如果设置为 true 运行时会自动发射粒子
Auto Remove On Finish粒子播放完毕后自动销毁所在的节点
FilePlist 格式的粒子配置文件
Custom是否自定义粒子属性。开启该属性后可自定义以下部分粒子属性
Sprite Frame自定义的粒子贴图
Duration发射器生存时间,单位秒,-1 表示持续发射
Emission Rate每秒发射的粒子数目
Life粒子的运行时间及变化范围
Total Particle粒子最大数量
Start Color粒子初始颜色
Start Color Var粒子初始颜色变化范围
End Color粒子结束颜色
End Color Var粒子结束颜色变化范围
Angle粒子角度及变化范围
Start Size粒子的初始大小及变化范围
End Size粒子结束时的大小及变化范围
Start Spin粒子开始自旋角度及变化范围
End Spin粒子结束自旋角度及变化范围
Source Pos发射器位置
Pos Var发射器位置的变化范围。(横向和纵向)
Position Type粒子位置类型,包括 FREERELATIVEGROUPED 三种。详情可参考 PositionType API
Emitter Mode发射器类型,包括 GRAVITYRADIUS 两种。详情可参考 EmitterMode API
Gravity重力。仅在 Emitter Mode 设为 GRAVITY 时生效
Speed速度及变化范围。仅在 Emitter Mode 设为 GRAVITY 时生效
Tangential Accel每个粒子的切向加速度及变化范围,即垂直于重力方向的加速度。仅在 Emitter Mode 设为 GRAVITY 时生效
Radial Accel粒子径向加速度及变化范围,即平行于重力方向的加速度。仅在 Emitter Mode 设为 GRAVITY 时生效
Rotation Is Dir每个粒子的旋转是否等于其方向。仅在 Emitter Mode 设为 GRAVITY 时生效
Start Radius初始半径及变化范围,表示粒子发射时相对发射器的距离。仅在 Emitter Mode 设为 RADIUS 时生效
End Radius结束半径。仅在 Emitter Mode 设为 RADIUS 时生效
Rotate Per S粒子每秒围绕起始点的旋转角度及变化范围。仅在 Emitter Mode 设为 RADIUS 时生效
Src Blend Factor混合显示两张图片时,原图片的取值模式。可参考 BlendFactor API
Dst Blend Factor混合显示两张图片时,目标图片的取值模式。可参考 BlendFactor API