object:createParticle()

类型 函数
对象 粒子系统
库 physics.*
返回值 无
修订版本 版本 2024.3703
关键词 createParticle, physics, LiquidFun
另请参阅 physics.newParticleSystem()
object:destroyParticles()
object:createGroup()
粒子碰撞

概述

此函数用于在粒子系统中创建单个粒子。

语法

ParticleSystem:createParticle( params )
参数 (必填)

表. 指定粒子属性（标志）的表 — 有效条目请参阅下一节。

重要

当通过 particleCollision 事件实现粒子碰撞时，必须为每个粒子设置 "fixtureContactListener" 标志。如果省略此标志，将不会收到粒子碰撞响应。

参数参考

要了解有关粒子可用参数的更多信息，请参阅 LiquidFun 程序员指南。

标志 (可选)

字符串 或 表. 以下字符串之一或包含逗号分隔的这些字符串列表的表。

  • "water"（水）
  • "zombie"（僵尸）
  • "wall"（墙）
  • "spring"（弹簧）
  • "elastic"（弹性）
  • "viscous"（粘性）
  • "powder"（粉末）
  • "tensile"（张力）
  • "colorMixing"（颜色混合）
  • "destructionListener"（销毁监听器）
  • "barrier"（障碍）
  • "staticPressure"（静态压力）
  • "reactive"（反应性）
  • "repulsive"（排斥性）
  • "fixtureContactListener"（夹具接触监听器）
  • "fixtureContactFilter"（夹具接触过滤器）
  • "particleContactFilter"（粒子接触过滤器）
x (可选)

数字. 生成的粒子在内容空间中的起始 **x** 位置。

y (可选)

数字. 生成的粒子在内容空间中的起始 **y** 位置。

velocityX (可选)

数字. 生成的粒子的 **x** 速度。

velocityY (可选)

数字. 生成的粒子的 **y** 速度。

颜色 (可选)

表. 生成的粒子的 RGB+A 颜色设置表。

color = { 0, 0.3, 1, 1 }
生命周期 (可选)

数字. 生成的粒子的生命周期，以秒为单位。

示例

ParticleSystem:createParticle(
    {
        flags = { "water", "colorMixing" },
        x = 0,
        y = 0,
        velocityX = 256,
        velocityY = 480,
        color = { 0, 0, 1, 1 },
        lifetime = 32.0
    }
)