> For the complete documentation index, see [llms.txt](https://doc.playturbo.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.playturbo.cn/ke-wan-gong-ju-zi-you-bian-ji-qi/zi-you-bian-ji-qi-shi-yong-zhi-nan/bian-ji-ye-mian-fen-qu-jie-shao/can-shu-she-zhi-qu/wai-guan-tu-ceng-can-shu/li-zi-can-shu.md).

# 粒子参数

## <mark style="color:$primary;">一、粒子贴图</mark>

粒子贴图即粒子的样式

<table data-full-width="false"><thead><tr><th width="125">图片</th><th width="97">参数类型</th><th width="135">说明</th><th width="317">操作步骤</th><th>操作步骤补充</th></tr></thead><tbody><tr><td><img src="/files/MJ1EojTSOPZUuDaHb5Xo" alt=""></td><td><strong>粒子贴图</strong></td><td>支持粒子贴图预览/替换</td><td><p></p><ul><li>点击替换按钮，调起图片素材面板</li><li>可通过图片库/我的资产库/项目资产/本地上传四种渠道选择或上传粒子贴图素材</li><li>点击添加按钮即可完成替换</li></ul></td><td><p></p><p><img src="/files/oThH2eUry2YeLNbJjhLN" alt=""></p></td></tr></tbody></table>

## <mark style="color:$primary;">二、播放设置</mark>

播放设置一栏支持调整粒子的播放次数、点击开始播放粒子特效、点击暂停播放粒子特效

<table data-full-width="false"><thead><tr><th width="127">图片</th><th width="97">参数类型</th><th width="190" align="center">说明</th><th width="225">操作步骤</th><th>操作步骤补充</th></tr></thead><tbody><tr><td><img src="/files/dANexE9yAAoUKGebnzra" alt=""></td><td><strong>播放次数</strong></td><td align="center"><br>1. 默认循环播放粒子<br>2. 支持编辑粒子播放次数<br></td><td>在框内键入数字或点击右侧按钮，则自动取消勾选循环播放</td><td><img src="/files/1l3I7n5QiIYfZ5RDX0w2" alt=""></td></tr><tr><td><img src="/files/885kAiUbz97xpUHTxrFg" alt=""></td><td><strong>开始播放粒子特效</strong></td><td align="center">支持播放预览粒子特效</td><td>点击即可播放粒子特效</td><td>/</td></tr><tr><td><img src="/files/885kAiUbz97xpUHTxrFg" alt=""></td><td><strong>暂停播放粒子特效</strong></td><td align="center">支持停止播放粒子特效</td><td>点击即可暂停播放粒子特效</td><td>/</td></tr></tbody></table>

## <mark style="color:$primary;">三、粒子参数</mark>

粒子包含发射区域、发射空间、粒子数量、产生频率、粒子尺寸、透明度、旋转角度、速度、生命周期等参数

<table data-full-width="false"><thead><tr><th width="137">图片</th><th width="98">功能</th><th width="297">说明</th><th>预览图</th></tr></thead><tbody><tr><td><img src="/files/5rQlvODOSoLYz1hnZGkz" alt=""></td><td><strong>发射区域</strong></td><td><p><br>1. 控制粒子发射的出生位置<br>2. 支持Point/Line/Circle/Retangle（即：点/线段/圆/矩形）4种发射区域类型</p><p>3.可调整区域长度与区域旋转角度<br></p></td><td>从上到下<br>图1：Point<br>图2：Line<br>图3：Circle<br>图4：Retangle<br><img src="/files/QFYkRacGr5WTB8Rd9dfb" alt=""></td></tr><tr><td><img src="/files/cKeNcc5iAJkWFss4e72t" alt=""></td><td><strong>发射空间</strong></td><td>支持World/Local两种模式</td><td>从左到右<br>图1：World模式，发射出去的粒子将不受粒子系统节点的影响<br>图2： Local模式 ，发射出去的粒子将跟随粒子系统节点一起移动<br><img src="/files/G8YuE3amAI2Avt5dtLy5" alt=""></td></tr><tr><td><img src="/files/ki3slVdxgHTphhmiFnnF" alt=""></td><td><strong>粒子数量</strong></td><td>1. 建议数值范围：1~20<br>2. 每批次发射的粒子数量</td><td></td></tr><tr><td><img src="/files/ohiGRtMW4y01WR1EBv7C" alt=""></td><td><strong>产生频率</strong></td><td>每一批粒子发射的时间间隔，以秒为单位</td><td></td></tr><tr><td><img src="/files/liQvpNK2RIKhMedi8avq" alt=""></td><td><strong>粒子尺寸</strong></td><td>1. 建议数值范围：0~100<br>2. 当粒子数量达到峰值时将暂停发射</td><td><img src="/files/94PE61A1dZ6YAoMAV8qV" alt=""></td></tr><tr><td><img src="/files/k2LcsprJJ3TGmZLvTaqR" alt=""></td><td><strong>透明度</strong></td><td>1. 数值范围：0~1（0 指全透明、1 指不透明）<br>2. 用来控制粒子的出生时的透明度，透明度在指定范围（最小值和最大值）内随机取值</td><td>从左到右<br>图1：初始透明度 = 0.5<br>图2：初始透明度 = 1<br>图3：初始透明度 0.5～1<br><img src="/files/YtAT9zrY3p0oOeHXDZCr" alt=""></td></tr><tr><td><img src="/files/h0B8Ubii0ybeDGqq0PVe" alt=""></td><td><strong>旋转角度</strong></td><td><p>1. 数值范围：</p><p>0～360°正值时，顺时针旋转</p><p>0～-360°负值时，逆时针旋转<br>2. 用来控制粒子出生后每秒旋转的角度，在指定范围内随机取值</p></td><td><p>从上到下</p><p>图1：角速度=0</p><p>图2：角速度=360，粒子在1s内旋旋转360°</p><p>图3：角速度 0～360<img src="/files/hfI33541FocBfp3Kbmfy" alt=""></p></td></tr><tr><td><img src="/files/F8OLhLUiiPHLtvCjVfwC" alt=""></td><td><strong>速度</strong></td><td>1. 建议数值范围：-2000～-2000，按照50的倍数调整效果更佳<br>2. 用来控制粒子的出生时的速度，速度值在指定范围（最小值和最大值）内随机取值。<br>3. 速度值与方向对应关系：正值往右发射，负值往左发射<br><img src="/files/8ZwbjhyCxn0MN3cyIcJq" alt=""></td><td>从上到下<br>图1：初始速度 = 200<br>图2：初始速度 = 400<br>图3：初始速度 200～400<img src="/files/Fs5i6bMdviyShQL1LS2c" alt=""></td></tr><tr><td><img src="/files/e4zTl1F6VdKHB8hfwyuA" alt=""></td><td><strong>生命周期</strong></td><td>每个粒子的存活的时长，在指定范围（最小值和最大值）内随机取值，以秒为单位</td><td>从左到右<br>图1：生命时长 = 1s<br>图2：生命时长 = 2s<br>图3：生命时长 1～2s<br><img src="/files/GR5dE3Uz5uqgz7gzgsaX" alt=""></td></tr></tbody></table>

## <mark style="color:$primary;">四、物理参数</mark>

物理参数支持调整X方向的重力与Y方向的重力

<table data-full-width="false"><thead><tr><th width="150">图片</th><th width="113">功能</th><th width="349">说明</th><th>预览图</th></tr></thead><tbody><tr><td><img src="/files/mB1TZTyUM1reThzZ2BL4" alt=""></td><td><strong>重力</strong></td><td><p><br>1. 建议数值范围：-2000～-2000，按照50的倍数调整效果更佳<br>2. 为粒子增加重力加速度，可以让粒子在原本轨迹的基础上，模拟真实世界，增加抛物线的效果<br>3. 重力数值与XY轴方向的对应关系如图：</p><p>以发射器的中心为原点<br> X轴原点左侧为负值，原点右侧为正值<br>Y轴原点下面为正值，原点上面为负值<br><img src="/files/LsODFuEgkvjmJzCBFnKO" alt=""></p></td><td><img src="/files/IEi6bhhCyKGfWZNWkwiz" alt=""></td></tr></tbody></table>