ParticleEmitter 是一个特殊对象，它可以将可定制的 2D 粒子发射到世界。要发射和渲染粒子，它必须被父级到一个 Class.BasePart 或一个 Class.附件
当发射器处于 Enabled 且没有零Rate 时，或手动设置Emit 方法时，粒子会自
默认情况下，粒子面向相镜头，但 Orientation 可以修改为尊重粒子速度。
在粒子的 Lifetime 期间，
了解有关创建和自定义粒子发射器的更多信息，请参阅粒子发射器。
代码示例
This rather lengthy code sample shows how every property of a ParticleEmitter can be set, including NumberRange, NumberSequence and ColorSequence properties. Below is how the ParticleEmitter should look after every property is set. Try playing around with the different properties to customize how the effect looks!
local emitter = Instance.new("ParticleEmitter")
-- Number of particles = Rate * Lifetime
emitter.Rate = 5 -- Particles per second
emitter.Lifetime = NumberRange.new(1, 1) -- How long the particles should be alive (min, max)
emitter.Enabled = true
-- Visual properties
emitter.Texture = "rbxassetid://1266170131" -- A transparent image of a white ring
-- For Color, build a ColorSequence using ColorSequenceKeypoint
local colorKeypoints = {
-- API: ColorSequenceKeypoint.new(time, color)
ColorSequenceKeypoint.new(0, Color3.new(1, 1, 1)), -- At t=0, White
ColorSequenceKeypoint.new(0.5, Color3.new(1, 0.5, 0)), -- At t=.5, Orange
ColorSequenceKeypoint.new(1, Color3.new(1, 0, 0)), -- At t=1, Red
}
emitter.Color = ColorSequence.new(colorKeypoints)
local numberKeypoints = {
-- API: NumberSequenceKeypoint.new(time, size, envelop)
NumberSequenceKeypoint.new(0, 1), -- At t=0, fully transparent
NumberSequenceKeypoint.new(0.1, 0), -- At t=.1, fully opaque
NumberSequenceKeypoint.new(0.5, 0.25), -- At t=.5, mostly opaque
NumberSequenceKeypoint.new(1, 1), -- At t=1, fully transparent
}
emitter.Transparency = NumberSequence.new(numberKeypoints)
emitter.LightEmission = 1 -- When particles overlap, multiply their color to be brighter
emitter.LightInfluence = 0 -- Don't be affected by world lighting
-- Speed properties
emitter.EmissionDirection = Enum.NormalId.Front -- Emit forwards
emitter.Speed = NumberRange.new(0, 0) -- Speed of zero
emitter.Drag = 0 -- Apply no drag to particle motion
emitter.VelocitySpread = NumberRange.new(0, 0)
emitter.VelocityInheritance = 0 -- Don't inherit parent velocity
emitter.Acceleration = Vector3.new(0, 0, 0)
emitter.LockedToPart = false -- Don't lock the particles to the parent
emitter.SpreadAngle = Vector2.new(0, 0) -- No spread angle on either axis
-- Simulation properties
local numberKeypoints2 = {
NumberSequenceKeypoint.new(0, 0), -- At t=0, size of 0
NumberSequenceKeypoint.new(1, 10), -- At t=1, size of 10
}
emitter.Size = NumberSequence.new(numberKeypoints2)
emitter.ZOffset = -1 -- Render slightly behind the actual position
emitter.Rotation = NumberRange.new(0, 360) -- Start at random rotation
emitter.RotSpeed = NumberRange.new(0) -- Do not rotate during simulation
-- Create an attachment so particles emit from the exact same spot (concentric rings)
local attachment = Instance.new("Attachment")
attachment.Position = Vector3.new(0, 5, 0) -- Move the attachment upwards a little
attachment.Parent = script.Parent
emitter.Parent = attachment概要
属性
确定所有活跃粒子的全球轴加速，以每秒计算。
当 ParticleEmitter.LightInfluence 为 0 时，调整发射器发出的光。
确定所有活跃粒子的颜色。
确定粒子在衰减过程中会在不同速度的一半速度。
确定发生的对象的面。
确定是否发射粒子。
确定每秒钟在框架中翻页动画的速度。
如果 Texture 与翻译书不兼容，显示错误消息。
确定翻页材料的布局。必须为 None、Grid2x2、Grid4x4 或 Grid8x8。
确定翻书动画的类型。必须是 Loop、OneShot、PingPong 或 Random。
决定是否在随机选择的框架开始动画，而不是总是在框架零开始。
为新发射的粒子定义一个随机的年龄范围。
确定背后的颜色是否要与前方的颜色混合。
决定环境光对多少粒子受到影响。
确定是否需要将粒子固定在发射的零件上。
指定如何引导粒子。
确定每秒钟发射的粒子数量。
确定发射物的角度速度范围，以每秒度数表示。
为新发射的粒子确定旋转的度数。
将发射器的形状设置为“方块子”、“球”、“圆柱”或“盘子”。
设置粒子是否仅向外发射，仅向内发射或向两个方向发射。
影响筒体、圆盘、球体和箱子形状的粒子排放。
将粒子排放设置为“音量”或“表面”。
通过单个粒子的生命时间确定世界的大小。
确定一个随机范围的速度（最低值至最大值），在每秒计量为 stud 的新粒子将发射。
确定角度，在度数上随机发射的粒子。
允许非标准粒子的非线性缩放，曲线控制在其生命时间内。
确定在粒子上渲染的图像。
值 在 0 和 1 之间，控制粒子效果的速度。
确定粒子在其个人生命时间过程中的透明度。
确定子弹的速度是否继承父父元素的一部分。
是否发射的粒子跟随 Workspace.GlobalWind 向矢量力。
确定粒子的前进/后退渲染位置；用于控制粒子在顶部/底部渲染。
方法
清除所有发射的粒子。
发出给定的粒子数。
属性
Acceleration
加速器属性确定加速器的速度在其生命时间变化。它使用 Datatype.Vector3 来确定加速器在全球 Speed / Vector3 / 2>Z2> 轴上的加速。当改变时，这个属性会影响 emitter 的所有发
加速会使溢出的粒子速度降低，如果它们发射在 EmissionDirection 中，它们的溢出速度会变慢。否则，它会加速它们。
Color
颜色 属性确定了所有有效的粒子在其个〖个生命时间〖的颜色。颜色适用于Class.ParticleEmitter.Texture|Texture，当它在渲染时使用粒子的Texture。如果Class.ParticleEmitter
改变此属性会影响 emitter 的所有发射器，当前和未来。
当这个属性使用一个渐变 ColorSequence 时，粒子的现有颜色是由线性使用粒子的年龄和总生命时间来确定的。例如，如果粒子 2 秒前生成，并且有 4 秒的生命时间，颜色将是由 50% 通过 Datatype.ColorSequ 的总生命值决定的。
Drag
拖动属性确定个体粒子在使用叠加式衰减时以何种速度失去半速。拖动通过缩放预期速度从 Class.ParticleEmitter.Speed|Speed 和任何速度由父级从 Speed 继承的速度。设置此属性为负值会使粒子的
EmissionDirection
EmissionDirection 属性确定父对象的脸（ Class.ParticleEmitter.Speed|Speed ）。一个负向 Class.ParticleEmitter.SpreadAngle|SpreadAngle 代表粒子在相反方向发射。1> Class.ParticleEmitter.SpreadAngle|SpreadAngle 更改了发射方向。1>
如果您将 ParticleEmitter 添加到 Attachment （具有方向），而使用此属性，您可以在上下文中使用附件自身（Attachment.Orientation）而不是使用此属性。
Enabled
启用 属性决定是否从发射器发出粒子。将其设置为 false 会使粒子不再生成，但任何已生成的粒子都会保持有效，直到它们过期。此属性有助于您设置一个预制粒子效果，您想要使其无效直到您需要它才能生成粒子。
如果要从禁用发射器中清除所有粒子，请调用 Clear() 。然后，如果需要，请在发射器上调用 Emit() 来发射和渲染粒子。
FlipbookFramerate
FlipbookFramerate 属性决定每秒钟秒内翻页的图像动画速度。喜欢 Lifetime ，您可以设置一个最低和最大范围来随机化翻页的图像动画，最多 30 个框架每秒钟。
FlipbookIncompatible
如果 Texture 在翻译书上不兼容，显示错误消息。翻译书的材质必须为 8×8、16×16、32×32、64×64、128×128、256×256、512×512、或 1024×1024 。
FlipbookLayout
FlipbookLayout 属性决定着花纸的布局。它可以是 Enum.ParticleFlipbookLayout 枚的任意值：
- 无 – 禁用翻译功能，并将纹理用作单个静电纹理在粒子的整个生命时间。
- 网格2x2 – 4个框架动画的 2 × 2 框架。
- Grid4x4 – 16 个框架的 4 × 4 网格动画。
- Grid8x8 – 64 个框架的 8×8 动画架。
FlipbookMode
FlipbookMode 属性确定翻页动画的类型。它可以是 Enum.ParticleFlipbookMode 枚列表的任何值：
- 循环播放 – 持续播放通过所有框架，从最后一个框架开始。
- 一击射击 – 通过动画在粒子的整个生命时间只播放一次。 使用此设置， FlipbookFramerate 属性不适用；
- PingPong – 从第一个到最后一个框架，然后从最后一个到第一个，重复在 Lifetime 的粒子。
- 随机 – 在随机顺序中播放框架，从一个框架到另一个框架之间进行混合/渐变。这可能有助于低速框架上的有机粒子材质，例如星在不同形状之间慢慢闪烁。
FlipbookStartRandom
FlipbookStartRandom 属性决定每个粒子在动画的随机框架开始，而不是总是从第一个框架开始。一个使用案例是启用此属性并将 FlipbookFramerate 设置为零，导致每个发射的粒子都是随机从翻书纹理中选择的静态框架。
Lifetime
使用期 属性定义了新发射的粒子的最大和最小年龄。使用期存储在每个粒子上，因此如果此值改变，现有粒子将保持有效直到它们随机选择的使用期结束。0 将粒子的发射量防止在 0 。
LightEmission
发光表面积计算器 属性确定了 Texture 与颜色之间的混合。一个值为 0 使用 普通 混合模式，而一个值为 1 使用 添加 混合模式。当改变时，这个属性立即影响所有拥有发光表面积的粒子，包括当前和未来的所有粒子。
这个属性不应与 LightInfluence ，它是确定粒子受到环境光的影响的方法。
这个属性会导致粒子在其周围的环境亮起。要实现此目标，请考虑使用一个 Class.PointLight 。
LightInfluence
LightInfluence 属性决定环境光对单个粒子的颜色在渲染时受到多少影响。它必须在 0-1 之间； 在此范围之外的行为对值不起作用 。 在 0 下，粒子不受到光的影响 (它们保留全部亮度); 在 1 下，粒子受到完全的光影响 (在完全黑暗中，粒子会保持完全的亮度)。
默认情况下，这个值是 1 如果使用 Studio 工具插入。 如果使用 Instance.new() 插入，它是 0。
LocalTransparencyModifier
LockedToPart
锁定到部分 属性决定是否允许粒子“贴”到发射源（Attachment 或 BasePart ），其父对象是 1> Class.ParticleEmitter1> 。如果4> true4>，活跃粒子将在锁定步骤移动，如果父对象移动，它
或者，考虑使用 VelocityInheritance 属性，其值为 1，这可能对某些效果更适合。
Orientation
定向属性确定发射器的粒子几何图形的使用哪种方向模式。
| 导航 | 粒子行为 |
|---|
RotSpeed
RotSpeed 属性确定了一个随机的角度速度对于新发射的粒子，它们以每秒度数量计量。随机角度速度在发射时被选择，因此修改此属性不会影响激活粒子。此属性与 Rotation ，影响射线的渲染图像角度。
角度很高的粒子可能会旋转更慢或不旋转 at al全部，因为旋转角度与软件渲染速度同步。例如，如果粒子在每个帧上旋转 360 度，那么旋转角度不会有任何显著的更改。
Rotation
旋转 属性确定新发射的粒子的旋转度数，用于用户界面的显示。 正向值在时钟方向。 此属性通常设置为 [0, 360] 来为新发射的粒子提供一个完全随机的旋转。 RotSpeed 也会影响粒子在其生命时间的
改变此值只会影响新的粒子；现有的粒子会保持其原始旋转。
Shape 属性设置发射器的形状为“方块子”、“球”、“圆柱”或“盘子”。 在您选择后，您可以调整ShapeStyle、ShapeInOut和
ShapePartial
根据 Shape 值，此属性执行不同的动作：
对于圆柱，它的上限轮廓是圆柱的顶部。一个值为 0 表示顶部的圆柱没有任何半径，因此它是一个锥体。一个值为 1 表示圆柱没有任何变形。
对于圆盘，它指定内部圆度比例。一个值为 0 表示圆盘完全关闭 (圆/椭圆)，而一个值为 1 表示仅在圆盘外部边缘发生发射。在 0 和 1 之间的值发生从一个特定的深度的 annulus 。
对于球体，它指定球体上发射的方向角。一个值为 1 表示球体上发射的所有部分；一个值为 0.5 表示球体上发射的半球；一个值为 0 表示只发射一个点在北极上。
了解有关视觉示例，请参阅这里。
Size
大小属性确定世界上所有的有效粒子的个人生命时间上的世界尺寸。该属性代表每个粒子的方块 Texture 的尺寸。它是一个 NumberSequence ，它的工作方式与 1> Class.ParticleEmitter.Transparency|Transparency1> 相似。
粒子的现有大小由使用粒子的年龄和总生命时间来线性处理此序列中的每个字符确定。例如，如果粒子 2 秒前生成，并且具有 4 秒的总生命时间，粒子的大小将是确定的。 为了任何 Datatype.NumberSequ
Speed
速度属性确定一个随机范围的速度(最低到最大)在新的粒子发出,用每秒计量的速度(每秒)。每个粒子的速度都是在发射时选择的,并且在Class.ParticleEmitter.EmissionDirection|EmissionDirection中应用。负值会导致粒子在向后旅行。
注意，改变 Speed 不会影响已激活的粒子，它们保留他们已有的速度。但是， Acceleration ， Drag 和 1> Class.ParticleEmitter.Vel
SpreadAngle
撒射角度 属性确定随机角度，在哪个角度下发射粒子。例如，如果 EmissionDirection 是 顶 (+ 1>Y1>), 此 4>Datatype.Vector24> 描述在 <
将一个轴设置为 360 会导致粒子在 圆 内的所有方向发射。将两个设置为 360 会导致粒子在 球 内的所有方向发射。
Squash
允许非标准的粒子缩放，曲线控制在其生命时间上。大于 0 的值会导致粒子收缩横向，而小于 0 的值会导致粒子垂直向上生长。值小于 0 的值会导致粒子垂直向下生长。
Texture
纹理 属性决定在粒子上渲染的图像。 此图像受到 Color 、Transparency 、1> Class.ParticleEmitter.LightInfluence|LightInfluence1> 和
Transparency
透明度 属性决定了所有激活的粒子在其个人生命时间上的透明度。它与 Size 在如何影响粒子过时方面的工作方式相似。在渲染方面，一个值为 0 是完全可见的 (opaque)，一个值为 1 是完全隐藏的 (不会在全部何情况下渲染)。
粒子的现实透明度是由使用粒子的年龄和总生命时间来线性处理的。例如，如果粒子 2 秒前生成，并且具有 4 秒的生命时间，粒子的透明度将是它在 Datatype.NumberSequ
VelocityInheritance
VelocityInheritance 属性确定子弹部件的 Velocity 是否被子弹发射时的粒子继承。值为 0 表示无需继承速度，而值为 1 表示粒子将以父子 BasePart 的相同速度传播。
使用 Drag 与 Class.ParticleEmitter.Drag|Drag 结合时，粒子发射器可能会出现“落下”粒子从移动部件上移动的情况。
ZOffset
ZOffset 属性确定粒子在屏幕上的前后视图位置，不会改变其大小。当改变时，这个属性会影响当前和未来的粒子。注意，这个属性接受浮点值；它不是 GuiObject.ZIndex (一个整数) 的。
正向值将粒子移动到相机附近，负向值将粒子移动到远处。足够负的值可以使粒子在父亲部分内或在后方渲染。
方法
Clear
清除方法立即清除 Class.ParticleEmitter 通过其自然排放 (不是零 ParticleEmitter 在一个 Rate 上的排放) 或通过 2>Class.ParticleEmitter:emit()2> 发出的所有现有粒子 (5>Class.ParticleEmitter:</
返回
代码示例
This code sample causes a ParticleEmitter to ParticleEmitter:Emit() particles in bursts of 10 every 2 seconds. It ParticleEmitter:Clear()s any existing particles before doing so.
local emitter = script.Parent
while true do
emitter:Clear()
emitter:Emit(10)
task.wait(2)
endEmit
发射方法会使 Class.ParticleEmitter 立即发射指定的粒子数。
参数
要发射的粒子数量。
返回
代码示例
This code sample causes a parent ParticleEmitter to ParticleEmitter:Emit() particles based on how far the parent BasePart moves.
local RunService = game:GetService("RunService")
local emitter = script.Parent
local part = emitter.Parent
local PARTICLES_PER_STUD = 3
local lastPosition = part.Position
local distance = 0
local function onStep()
local displacement = part.Position - lastPosition
distance = distance + displacement.magnitude
local n = math.floor(distance * PARTICLES_PER_STUD)
emitter:Emit(n)
distance = distance - n / PARTICLES_PER_STUD
lastPosition = part.Position
end
RunService.Stepped:Connect(onStep)
emitter.Enabled = falseThis code sample causes a ParticleEmitter to ParticleEmitter:Emit() particles in bursts of 10 every 2 seconds. It ParticleEmitter:Clear()s any existing particles before doing so.
local emitter = script.Parent
while true do
emitter:Clear()
emitter:Emit(10)
task.wait(2)
end