Files

boybook 9a0334ee84 first commit

2025-03-17 13:24:39 +08:00

10 KiB

Raw Blame History

front, hard, time

front	hard	time
	入门	分钟

粒子特效

本文档主要包括三个部分：

粒子属性介绍

对粒子的每一个属性进行了介绍，方便读者了解particle json
粒子效果规范

对游戏中最大可支持的粒子效果提供了约束，保证粒子效果在大部分机型上能够流畅运行
粒子调试指令集

针对粒子编辑器暂时不能外放的现状，提供了实时预览粒子的游戏指令集，方便调试粒子效果

1. 粒子属性

粒子特效的配置文件为json格式，如下图所示：

客户端中的粒子特效会根据数值变化，实时呈现不同的粒子效果，以下为对粒子配置文件json的解释。

1.1 Initial

关于粒子属性：

3个数值框的，从左向右分别对应x，y，z，如Constant Force、Direction等
2个数值框的，从左向右分别对应最小值和最大值
粒子发射器的属性并不是完全如上对应的数值，而是最大值和最小值之间的一个随机值

如上图，Direction具有标有min和max的两个值，分别对应最小值和最大值
粒子发射器发射的粒子，实际为空间中的一个朝向相机的矩形面片，这在粒子的size设置的时候只设置x,y得到体现。

下面简单介绍每个属性的作用及样例：

Constant Force

粒子受力，相当于粒子运动过程中的加速度

Direction

粒子发射的初始方向，取值为min和max之间的差值

Damping Force

阻力理解为方向与粒子速度方向相反的加速度，每一帧的运算的公式为：

v = v - damping force * v v为粒子当前速度,所以damping force实际上起到了逆向加速度因子的作用。

Active Time与Inactive Time

Active Time

粒子发射器活跃时间

Inactive Time

粒子发射器冷却时间

Active Time与Inactive Time这两个值是配合使用的，即粒子发射器每活跃Active Time之后，冷却Inactive Time，然后继续循环

在使用的时候，可以将Active Time当作发射器生命周期，方便调试有时间限制的效果。如果将Active Time设置为0，粒子发射器会一直发射，没有停歇

普通效果建议不设置这两个值，或者都设为0

需要实现循环喷射效果时可以使用这两个参数

Particle Size

粒子出生时的大小，当前只有x,y值有效，z值无效，留给以后发射立方体用

游戏中一个地形块的大小为1，以此作为尺寸参考

Time To Live

粒子生命周期，即每个粒子的存在时间

Velocity

粒子初始速度

Rotation（废弃，建议使用Rotation Range）

粒子初始角度，即粒子绕z轴的旋转的角度（0~360）

Rotation Speed（废弃，建议使用Rotation Speed Range）

粒子自转速度，每秒旋转Rotation Speed角度

Rotation Range

粒子初始旋转角度，即初始时刻粒子绕x，y，z三轴的旋转角度（0-360）

{
    "particleeffect": {
        "rotationRange": {
            "max": "90.0 90.0 90.0",
            "min": "0.0 0.0 0.0"
        },
        ...
    }
}

Rotation Speed Range

粒子自转速度，即绕x，y，z轴每秒旋转的角度（0-360）

{
    "particleeffect": {
        "rotationSpeedRange": {
            "max": "90.0 90.0 90.0",
            "min": "0.0 0.0 0.0"
        },
        ...
    }
}

1.2 Variation

该参数与粒子生命周期内的形变有关

Add：粒子尺寸每秒增加倍数，即size = size * (1 + add)，默认该值为0.0。
Multiply：粒子尺寸每秒尺寸缩放倍数，即size = size * multiply，默认值为1.0。
每秒粒子尺寸的计算公式为：size = size * multiply * (1 + add)

1.3 Color

Color

设置粒子颜色，格式为RGBA

Color Fade

该参数与粒子生命周期内的颜色变化有关

粒子在生命周期中，可以在不同的时间点设置不同的颜色关键帧，粒子的颜色逐渐向关键帧渐变。

如上图所示，粒子在0.00s时，颜色为(0.50，0.30，0.50，1.0)，在0.5s时颜色值为(1.0，0.0，1.0，1.0)，在2.0s时为(0.0，0.0，0.0，1.0)

Color与Color Fade

设置Color就不可设置Color Fade，设置Color Fade就不可设置Color，二者的关系是互斥的

如果二者均不设置，则直接读取贴图的颜色

Enable Color与Enable Texture

部分粒子配置中会出现"enablecolor"和"enabletexture"配置项，他们都能影响粒子颜色的计算流程：

粒子的初始颜色为纯白不透明
若Enable Color启用，则粒子颜色会乘上Color或Color Fade中配置的颜色值，否则跳过
若Enable Texture启用，则粒子颜色还会乘上贴图的颜色，否则只会乘上贴图的透明度

二者均不设置的情况下，
只要Color或Color Fade中任一配置存在，则Enable Color启用，同时Enable Texture禁用，效果为使用设置指定的颜色；
要是Color和Color Fade的设置均不存在，则Enable Color禁用，同时Enable Texture启用，效果恰为直接读取贴图颜色。

1.4 Emitter

该部分主要介绍与发射器有关的参数

处于性能考虑，每秒最多发射3000颗粒子

Number Of Particles

同时存活的粒子最大数量

Emitter Size

粒子发射器尺寸，即粒子出生空间大小，(0，0，0)说明粒子都从原点出生

否则，粒子从定义的空间中随机位置生成

Emission Rate

粒子发射率，数值越高，发射频率越高

左为min，右为max

下图可以理解为最少每秒发射40次，最多每秒发射50次

Emission Shape

粒子发射器形状，当前支持球形和立方体，参数分别为“Box”、”Sphere”

1.5 Resource

Material

无效，开发中。

Texture

可参考demo中的bb.png和bb.json进行阅读

"name"为粒子纹理路径，路径从textures开始，不需要后缀

如果想添加新的纹理，需要将png（必须为png）文件放置在particle路径中

"ani"为粒子序列帧
- "ani"中"name"为序列帧的json配置文件路径，从textures开始，不需要后缀
- "ani"中"fps"为序列帧播放帧率（注意数字要加引号），最小值为0，默认值为30
- "ani"中"shuffle"为序列帧是否乱序播放（第一帧就开始随机），默认值为false（注意不加引号；图中未配置，使用默认值）