object:destroyParticles()

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

概述

此函数用于移除区域内的所有粒子。它将返回一个 数字，指示已销毁的粒子数量。

语法

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

表。 一个指定要销毁的粒子区域的表 — 有效条目请参见下一节。

参数参考

x (可选)

数字。 销毁区域的 x 位置，在内容空间中。

y (可选)

数字。 销毁区域的 y 位置，在内容空间中。

angle (可选)

数字。 销毁区域的起始角度（旋转）。

矩形区域

halfWidth (可选)

数字。 所需矩形销毁区域宽度的一半。

halfHeight (可选)

数字。 所需矩形销毁区域高度的一半。

圆形区域

radius (可选)

数字。 所需圆形销毁区域的半径。

任意形状

shape (可选)

数组。 最多包含八个 x 和 y 坐标的数组，用于生成任意凸形销毁区域。

示例

local number_of_particles_destroyed = ParticleSystem:destroyParticles(
    {
        x = 123,
        y = 456,
        angle = 45,
        halfWidth = 16,
        halfHeight = 16
    }
)