发射器更新组 | 虚幻引擎 4.27 文档

发射器在CPU上tick时，发射器更新（Emitter Update） 模块便会出现。此组中的模块应计算此帧中粒子生成或更新的参数值。以从堆栈顶部到底部的顺序执行模块。

在本文档中，“发射器更新”组中的各类模块会在单独章节中逐个介绍，并且会有表格列出并描述该类模块的可用默认选项。请注意：你可以为Niagara发射器的任意部分创建自定义模块。此处仅列出虚幻引擎4自带的模块。

光束模块

参数	说明
光束发射器设置（Beam Emitter Setup）	此模块提供光束的起点、终点和切线设置。

Chaos模块

模块	说明
从Chaos中生成（Spawn from Chaos）	此模块导致粒子在响应混沌事件时产生。

发射器状态

参数	说明
生命周期模式（Life Cycle Mode）	此设置确定是由发射器本身还是由拥有发射器的系统管理生命周期（循环、存在时间和消亡）。设置包括：系统（System）：当你选择此选项后，所属系统将计算所有生命周期功能。在大多数情况下，让系统计算生命周期可提高优化程度。选择此选项将隐藏其他字段。自身（Self）：当你选择此选项后，发射器本身将计算所有生命周期功能。选择此选项将使下面的其他设置可用。
非活动响应（Inactive Response）	此设置确定当发射器进入非活动状态时会发生什么状况。非活动意味着发射器处于休眠状态，且不再能够生成或管理粒子。选项包括：完成（Complete）：粒子完成任务，然后终止发射器。终止（Kill）：立即终止发射器和粒子。继续（Continue）：发射器停用，但在系统关闭前不会消亡。
循环行为（Loop Behavior）	此选项确定发射器的行为。你可以从下述选项中进行选择：一次（Once）：发射器播放动画一次。多次（Multiple）：发射器以固定次数播放动画。无限（Infinite）：发射器无限次数地播放动画。
循环时长（Loop Duration）	此参数确定循环持续多长时间。
循环时长模式（Loop Duration Mode）	此参数确定循环有限还是无限。
循环延迟（Loop Delay）	此设置将以给定量延迟下一个循环。
可延展性
可延展性模式（Scalability Mode）	此选项确定发射器是从系统获取可延展性设置，还是将具有自身的唯一可延展性设置。你可以从下述选项中进行选择：系统（System）：当你选择此选项后，所属系统将计算所有生命周期功能。在大多数情况下，让系统计算生命周期可提高优化程度。选择此选项将隐藏其他字段。自身（Self）：当你选择此选项后，发射器本身将计算所有生命周期功能。选择此选项将使下面的其他设置可用。
启用距离剔除（Enable Distance Culling）	勾选此复选框以启用。这样可根据发射器与摄像机的距离启用发射器剔除。当发射器与摄像机之间达到一定距离时，发射器可进入休眠、重新唤醒、终止等状态。
启用可视性剔除（Enable Visibility Culling）	勾选此复选框以启用。这样可根据发射器是否对摄像机可见启用剔除发射器。发射器可根据自身处于屏幕内还是屏幕外而进入休眠、重新唤醒、终止等状态。
在唤醒时重置存在时间（Reset Age on Awaken）	勾选此复选框以启用。当此发射器通过可延展性设置进入休眠状态后重新唤醒时，此设置将重置发射器的存在时间。这意味着生成迸发将重新触发，且发射器的生命周期将重新开始。

位置模块

模块	说明
在网格中生成粒子（Spawn Particles in Grid）	此参数根据用户定义的网格分辨率设置生成粒子。

MAX脚本模块

模块	说明
生成MS顶点动画工具变换目标（Spawn MS Vertex Animation Tools Morph Target）	此参数生成并采样先前使用顶点动画工具创建的变换目标纹理。顶点动画工具生成表示变换目标混合形状的纹理。此模块为工具采集的每个顶点生成一个粒子。此模块应与更新MS顶点动画工具变换目标（Update MS Vertex Animation Tools Morph Target）模块配合使用。

生成模块

模块	说明
生成即时迸发（Spawn Burst Instantaneous）	此模块自发生成大量粒子。
每帧生成（Spawn Per Frame）	此模块在各个帧中生成大量粒子。
每单位生成（Spawn Per Unit）	此模块根据以虚幻单位表示的传播距离生成粒子。
生成速率（Spawn Rate）	此模块以特定速率持续生成粒子。

工具模块

模块	说明
发射器帧计数器（Emitter Frame Counter）	在此模块中启用增量计数器将设置一个计数器，该计数器会随着发射器动画中的每一帧递增。

新建暂存区模块

在 添加（Add） 菜单中选择此项目将打开 暂存区（Scratch Pad） 面板（默认情况下，此面板位于 系统概览（System Overview） 旁），然后在 选择（Selection） 面板中放置 暂存区模块。你还可使用 Windows > 暂存区（Windows > Scratch Pad） 来打开暂存区面板。但是，在堆栈中放置暂存区模块之后，你在暂存区中创建的所有模块或动态输入都将自动连接到脚本。如果你使用Windows菜单打开了暂存区面板，则你在其中创建的所有项目都必须手动添加到脚本。

直接设置新值或现有值

从 添加（Add） 菜单中选择此项目将在 选择（Selection） 面板中放置 设置参数（Set Parameter） 模块。单击 加号（Plus sign）（+）图标，以选择 添加参数（Add Parameter） 或 新建参数（Create New Parameter）。

添加参数

假如你选择 添加参数（Add Parameter），你需要从列出的参数中进行选择。这会将该参数添加至发射器生成组中的 设置参数（Set Parameter） 模块。

部分参数可以在其他模块中设置或修改。部分则只能通过“设置参数”模块设置。

参数	说明
Emitter.Age	此参数定义此发射器的年龄。
Emitter.CurrentLoopDelay	此参数定义发射器当前循环重复之前的当前延迟量。
Emitter.CurrentLoopDuration	此参数定义当前发射器循环的时长。
Emitter.ExecutionState	此参数将影响发射器状态。有效值选择包括： Active Inactive InactiveClear Complete
Emitter.ExecutionStateSource	此变量链接到ENiagaraExecutionStateSource参数，指出执行状态设置的源。使用此参数，可延展性可更改状态，但只有在更高优先权的项目未定义此状态时才能更改。
Emitter.LocalSpace	此参数将定义粒子位置对应场景原点或拥有Niagara组件的位置。 False：粒子位置位于场景空间中，并相对于场景原点。位置为 0,0,0 的粒子将在场景原点处渲染。 True：粒子位置位于本地空间中，并相对于拥有Niagara组件的位置。位置为 0,0,0 的粒子将在拥有Niagara组件位置处渲染。
Emitter.LoopCount	此参数定义发射器循环的重复次数。
Emitter.LoopedAge	此参数计算相对于发射器当前循环的发射器年龄。举例而言，若发射器已激活8秒且每5秒循环一次，则发射器的LoopedAge将为 3秒。发射器每次循环时，LoopedAge返回0。
Emitter.NormalizedLoopAge	此参数计算相对于发射器当前循环的发射器年龄，标准化为 0 到 1。将NormalizedLoopAge表达为 LoopedAge 除以 CurrentLoopDuration。若发射器已激活8秒且每5秒循环一次，则发射器的LoopedAge将为 3。发射器的NormalizedLoopAge将为 0.6。
System.ExecutionState	此参数将影响系统状态。可选的有效值包括 Active、Inactive、InactiveClear、Complete、Disabled 和 Num。
System.ExecutionStateSource	此参数指出系统执行状态设置的源。使用此参数，可延展性可更改状态，但只有在更高优先权的项目未定义此状态时才能更改。

新建参数

将在列出的参数中选择 新建参数（Create New Parameter）。此设置会向发射器更新组添加 设置变量（Set Variable） 模块，从而能与常见模块图表外的Niagara参数交互。

参数	类型	说明
音频示波器（Audio Oscilloscope）	数据接口（Data Interface）	此参数向发射器添加新的音频示波器数据接口模块。此音频示波器模块可以直接访问音频信号的波形数据。
音频频谱（Audio Spectrum）	数据接口（Data Interface）	此参数向发射器添加新的音频频谱数据接口模块。此音频频谱模块可以根据音频在特定频率下的响度来驱动可视化。
布尔（Bool）	基元（Primitive）	此参数添加具有true/false复选框的设置变量模块。
摄像机查询（Camera Query）	数据接口（Data Interface）	此参数向发射器添加新的摄像机查询数据接口模块。此数据接口可以用于检索指定控制器索引的摄像机信息（摄像机位置、旋转、FOV等）。
碰撞查询（Collision Query）	数据接口（Data Interface）	此参数向发射器堆栈添加碰撞数据接口。此参数常与碰撞模块配合使用。
旋度噪点（Curl Noise）	数据接口（Data Interface）	此参数向发射器堆栈添加旋度噪点数据接口。若将此参数与旋度噪点力模块配合使用，此数据接口会将不同类型的噪点注入模拟。
彩色曲线（Curve for Colors）	数据接口（Data Interface）	此参数为模拟添加四通道彩色曲线数据接口。可通过动态输入或其他模块对此曲线进行采样，以创建随时间变化的颜色。
浮点曲线（Curve for Floats）	数据接口（Data Interface）	此参数为模拟添加单通道曲线数据接口。可通过动态输入或其他模块对此曲线进行采样，以创建随时间变化的浮点值。
矢量2D曲线（Curve for Vector 2Ds）	数据接口（Data Interface）	此参数为模拟添加双通道曲线数据接口。可通过动态输入或其他模块对此曲线进行采样，以创建随时间变化的浮点值对。
矢量三通道曲线（Curve for Vector 3s）	数据接口（Data Interface）	此参数为模拟添加三通道曲线数据接口。可通过动态输入或其他模块对此曲线进行采样，以创建随时间变化的浮点值集。
矢量四通道曲线（Curve for Vector 4s）	数据接口（Data Interface）	此参数为模拟添加四通道曲线数据接口。可通过动态输入或其他模块对此曲线进行采样，以创建随时间变化的浮点值集。
ENiagaraBooleanLogicOps	枚举	此枚举供各种模块和动态输入使用，用于通过以下布尔逻辑进行测试：大于大于或等于等于不等于
ENiagaraCoordinateSpace	枚举	此枚举供各种模块和动态输入使用，用于区分坐标空间：模拟（Simulation）：如果已将发射器设置为本地，则请使用本地。否则使用世界。世界（World）：在游戏的世界空间内。本地（Local）：在所属组件的坐标空间内。
ENiagaraExecutionState	枚举（Enum）	管理系统或发射器执行状态的参数（例如 Emitter.ExecutionState 或 System.ExecutionState）将使用此列举类型。
ENiagaraExecutionStateSource	枚举（Enum）	指示执行状态设置的源。它用于允许可延展性更改状态，但只有在状态尚未被具有更高优先权的对象所定义时才有效。
ENiagara ExpansionMode	枚举	此枚举供位置模块使用，用于确定扩展的起始点所在：内部（Inside）居中（Centered）外部（Outside）
ENiagaraOrientationAxis	枚举	此枚举供数个模块使用，用于确定使用哪个轴进行计算： X轴（X Axis） Y轴（Y Axis） Z轴（Z Axis）
ENiagaraRandomnessMode	枚举	设置此发射器使用的随机数生成类型。有效选择有：模拟默认值（Simulation Defaults）确定性（Deterministic）非确定性（Non-Deterministic）
浮点（Float）	基元（Primitive）	此参数创建浮点值变量。
Grid2D收集（Grid2D Collection）	数据接口（Data Interface）	此参数与模拟阶段配合使用。它使用户能够读取或写入2D数据数组，然后在模拟阶段期间迭代网格中的每个像素。
Int32	基元（Primitive）	此参数创建整数变量。
线性颜色（Linear Color）	基元（Primitive）	此参数创建以取色器形式表示的RGBA颜色变量。
矩阵（Matrix）	基元（Primitive）	此参数创建4x4矩阵变量。
网格体三坐标（Mesh Tri Coordinate）	结构体（Struct）	这是一个简单的结构体，它包含了三角形指数以及该三角形面上的重心坐标。
相邻网格3D（Neighbor Grid 3D）	数据接口（Data Interface）	此参数与模拟阶段配合使用。它使用户能够读取或写入3D数据数组，然后在模拟阶段期间迭代体积中的每个像素。
Niagara ID	结构体（Struct）	此参数是用于追踪粒子的两部分结构体。该粒子的间接表中的索引。用于快速访问该粒子的数据。该粒子在现存粒子中始终具有唯一性，但该粒子消逝后会被重用。AcquireTag 是获取此ID时的唯一标签。当一个粒子消亡且另一个粒子重新使用消亡粒子的索引时，利用该标签可对这两个粒子进行区分。
Occlusion Query	数据接口（Data Interface）	此参数将向发射器添加新的遮挡查询数据接口模块。此数据接口用于读取深度缓冲遮挡信息。它只能与GPU发射器一起使用。
粒子属性读取器（Particle Attribute Reader）	数据接口（Data Interface）	此参数向发射器添加新的粒子属性读取器数据接口。此数据接口不仅可用于查询来自其他发射器的粒子有效荷载值，而且有时比事件更易于使用。
四元数（Quat）	基元（Primitive）	此参数创建四元数变量，用于代表旋转。
简单计数器（Simple Counter）	数据接口（Data Interface）	此参数将向发射器添加新的简单计数器数据接口模块。此数据接口将使你能够指令线程安全计数器递增计数。它只能与CPU发射器一起使用。
骨架网格体（Skeletal Mesh）	数据接口（Data interface）	这是一个数据接口，能够与骨架网格体的骨骼或套接字和蒙皮几何体交互。
生成信息（Spawn Info）	结构体（Struct）	此参数是生成所用的结构体，以指定要创建的粒子数量（Count）、从当前帧开始时间到开始生成之间的 InterpStartDt 或偏移、定义粒子生成时间间隔的 IntervalDt，以及可将生成粒子归属于不同类别的 SpawnGroup。
样条（Spline）	数据接口（Data interface）	这是一个数据接口，能够与样条资产交互。
静态网格体（Static Mesh）	数据接口（Data interface）	这是一个数据接口，能够与静态网格体的表面交互。
纹理取样（Texture Sample）	数据接口（Data interface）	这是一个数据接口，能够与GPU上的纹理交互。
矢量（Vector）	基元（Primitive）	此参数创建三通道浮点值集。
矢量2D（Vector 2D）	基元（Primitive）	此参数创建双通道浮点值集。
矢量4（Vector 4）	基元（Primitive）	此参数创建四通道浮点值集。
矢量场（Vector Field）	数据接口（Data Interface）	这是一个数据接口，能够查询矢量场。
体积纹理取样（Volume Texture Sample）	数据接口（Data Interface）	此参数向发射器添加新的体积纹理数据接口模块。你可以使用此参数来进行体积纹理取样。