# Common模块

# 概述

Common(粒子系统通用模块),用于设定粒子的初始属性值,如初速度、旋转、颜色、生命时间等。

image.png

# 属性描述

属性 功能 类型
startLifeTime 粒子的生命时长。 number
scalingMode 缩放模式。 engine.Particle.ParticleCommon.ScalingMode
    Hierarchy 表示粒子的大小受自身和所有父节点的缩放值的叠加影响。
(对于2d粒子,粒子大小会受到设计宽高的变化而影响,需要将transform2D.scale设为较大的值才能显示出来)
engine.Particle.ParticleCommon.ScalingMode.Hierarchy
    Local Local表示粒子的大小仅受自身缩放值影响。
(对于2d粒子,粒子大小不受设计宽高变化的影响,粒子的 size 值直接设置到裁剪空间)
engine.Particle.ParticleCommon.ScalingMode.Local
    Shape Shape表示粒子的大小不受自身和父节点缩放值的影响。
(对于2d粒子,粒子大小不受设计宽高变化的影响,粒子的 size 值直接设置到裁剪空间)
engine.Particle.ParticleCommon.ScalingMode.Shape
simulationSpace 模拟粒子所在的空间。 engine.Particle.ParticleCommon.SimulationSpace
    Local 粒子在局部空间中。 engine.Particle.ParticleCommon.SimulationSpace.Local
    World 粒子在世界空间中。 engine.Particle.ParticleCommon.SimulationSpace.World
startSpeed 每个粒子的初始速度大小。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startSize3D 是否开启 XYZ 三个方向的大小设置。 boolean
startSize 若startSize3D为 false 时,每个粒子的初始大小。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startSizeX 若startSize3D为 true 时,粒子的 X 轴方向初始大小。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startSizeY 若startSize3D为 true 时,粒子的 Y 轴方向初始大小。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startSizeZ 若startSize3D为 true 时,粒子的 Z 轴方向初始大小。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startRotation3D 是否开启 XYZ 三个方向的旋转设置。 boolean
startRotation 若startSize3D为 false 时,每个粒子的初始旋转角度。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startRotationX 若startSize3D为 true 时,每个粒子在 X 轴的初始旋转角度。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startRotationY 若startSize3D为 true 时,每个粒子在 Y 轴的初始旋转角度。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startRotationZ 若startSize3D为 true 时,每个粒子在 Z 轴的初始旋转角度。 engine.Particle.AdvancedProperty.ConstantProperty
engine.Particle.AdvancedProperty.TwoConstantsProperty
engine.Particle.AdvancedProperty.CurveProperty
engine.Particle.AdvancedProperty.TwoCurvesProperty
startColor 每个粒子的初始颜色。 engine.Particle.AdvancedProperty.OneColorProperty
engine.Particle.AdvancedProperty.TwoColorsProperty
engine.Particle.AdvancedProperty.GradientProperty
engine.Particle.AdvancedProperty.TwoGradientsProperty

注意:

对于2d粒子来说,transform2d的 size 属性不会对粒子大小产生任何影响。2d粒子的缩放取决于 common 模块中的 scalingMode 属性。当 scalingMode 为Local和 Shape 时,粒子不受世界矩阵的影响,所以不会随设计宽高的变化而变化,直接进入裁剪空间。当 scalingMode 为Hierarchy时,粒子会受到世界矩阵的影响,因为2d的世界矩阵会根据设计宽高进行了相应的缩放,所以transform2D的 scale 属性需要设大相应的倍数才能看到粒子。