Unreal Engine の Niagara の Emitter Spawn グループのリファレンス | Unreal Engine 5.7 ドキュメンテーション

Emitter Spawn モジュールは、エミッタが CPU で作成された際に 1 回実行されます。このセクションのモジュールでは、デフォルト値を初期化するか、初期セットアップを実行します。モジュールはそれぞれスタックの上から下の順に実行されます。

このドキュメントには、Emitter Spawn グループ内の各モジュールタイプを説明するセクションがそれぞれあり、利用可能なデフォルトオプションを説明する表が記載されています。なお、Niagara エミッタのどの部分でもカスタムモジュールを作成できることに留意してください。ここでは、Unreal Engine 4 に自動的に含まれるモジュールについてのみ取り上げます。

Location モジュール

モジュール	説明
Spawn Particles in Grid	ユーザー定義のグリッド解像度設定に基づいてパーティクルをスポーンします。

MAX Scripts モジュール

モジュール	説明
Spawn MS Vertex Animation Tools Morph Target	頂点アニメーションツールで作成されたモーフターゲットテクスチャをスポーンしてサンプリングします。頂点アニメーションツールでは、モーフターゲットのブレンド形状を表すテクスチャを生成します。このモジュールは、ツールがキャプチャしたすべての頂点に対して 1 つのパーティクルをスポーンします。これは、Update MS Vertex Animation Tools Morph Target モジュールとの併用を想定しています。
Update MS Vertex Animation Tools Morph Target	Spawn MS Vertex Animation Tools Morph Target モジュールでスポーンされたパーティクルを受け取って、選択した位置に配置します。

モジュール

説明

Spawn MS Vertex Animation Tools Morph Target

頂点アニメーションツールで作成されたモーフターゲットテクスチャをスポーンしてサンプリングします。頂点アニメーションツールでは、モーフターゲットのブレンド形状を表すテクスチャを生成します。このモジュールは、ツールがキャプチャしたすべての頂点に対して 1 つのパーティクルをスポーンします。これは、Update MS Vertex Animation Tools Morph Target モジュールとの併用を想定しています。

Update MS Vertex Animation Tools Morph Target

Spawn MS Vertex Animation Tools Morph Target モジュールでスポーンされたパーティクルを受け取って、選択した位置に配置します。

Spawning モジュール

モジュール	説明
Spawn Per Unit	Unreal 単位での移動距離に基づいてパーティクルをスポーンするモジュールです。
Spawn Rate	特定の割合でパーティクルをスポーンし続けるモジュールです。

New Scratch Pad Module (新しいスクラッチパッドモジュール)

[Add] (プラス記号) メニューでアイテムを選択すると [Scratch Pad] パネルが開き (デフォルトで System Overview の横にドックします)、[Selection] パネルに [Scratch Pad module] が配置されます。[Windows] > [Scratch Pad] からも Scratch Pad パネルを開くことができます。ただし、スタック内に Scratch Pad モジュールを配置することで、[Scratch Pad] で作成するモジュールまたは動的入力はすべて自動的にスクリプトに接続されます。[Windows] メニューから [Scratch Pad] パネルを開いた場合は、[Scratch Pad] パネルで作成した項目をすべて手作業でスクリプトに追加する必要があります。

Set New or Existing Value Directly (新規または既存の値を直接設定)

[Add] メニュー内のこの項目を選択すると、[Selection] パネルに Set Parameter モジュールが追加されます。Add Parameter (パラメータを追加) または Create New Parameter (新規パラメータを作成) を選択するには、プラス記号 (+) のアイコンをクリックします。

Add Parameter

Add Parameter を選択したら、リストされているパラメータから選択します。これにより、そのパラメータが Emitter Spawn グループ内の Set Parameter モジュールに追加されます。

パラメータの中には、他のモジュールで設定や修正ができるものがあります。また、Set Parameter モジュールを使用してのみ設定可能なパラメータもあります。

パラメータ	説明
Emitter.Age	このエミッタの存続期間を定義します。
Emitter.CurrentLoopDelay	エミッタの現在のループが繰り返されるまでの、現在の遅延の量を定義します。
Emitter.CurrentLoopDuration	現在のエミッタのループの長さを定義します。
Emitter.ExecutionState	エミッタの状態に影響を及ぼすパラメータです。有効値は以下のとおりです。 Active Inactive InactiveClear Complete
Emitter.ExecutionStateSource	実行状態設定のソースを示します。これは、その状態がより高い優先度が設定されている要素で定義されていない場合にのみ、スケーラビリティで状態を変更できるようにするために使用されます。
Emitter.LocalSpace	このパラメータでは、パーティクルの位置の基準を、ワールド基点または所有する Niagara コンポーネントの場所のいずれにするかを定義します。 False:パーティクルの位置は WorldSpace 内になり、ワールド基点を基準とします。位置が 0,0,0 のパーティクルは、ワールド基点でレンダリングされます。 True:パーティクルの位置は LocalSpace 内になり、所有する 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 (新規パラメータを作成)

Create New Parameter を選択するときは、リストされたパラメータから選択します。これにより、そのパラメータが Emitter Spawn グループ内の Set Parameter モジュールに追加されます。

パラメータ	タイプ	説明
Audio Oscilloscope	データインターフェース	新しい Audio Oscilloscope データインターフェースモジュールをエミッタに追加します。Audio Oscilloscope モジュールでは、オーディオ信号の波形に直接アクセスすることができます。
Audio Spectrum	データインターフェース	新しい Audio Spectrum データインターフェースモジュールをエミッタに追加します。Audio Spectrum モジュールでは、特定の周波数でのオーディオ音量に応じてビジュアリゼーションを作成できます。
Bool	プリミティブ	true/false チェックボックスを含む Set Variable モジュールを追加します。
Camera Query	データインターフェース	新しい Camera Query データインターフェースモジュールをエミッタに追加します。このデータインターフェースは、特定のコントローラーインデックスのカメラ情報 (カメラ位置、回転、FOV など) の取得に使用できます。
Collision Query	データインターフェース	エミッタスタックにコリジョンデータインターフェースを追加します。これは、通常、コリジョンモジュールと併用します。
Curl Noise	データインターフェース	カールノイズデータインターフェースをエミッタスタックに追加します。これを Curl Noise Force モジュールと併用すると、このデータインターフェースでは異なるタイプのノイズをシミュレーションに挿入します。
Curve for Colors	データインターフェース	シミュレーション用に 4 チャンネルのカラーカーブデータインターフェースを追加します。このカーブを動的入力またはその他のモジュールによってサンプリングすることで、時間によって変化するカラーを作成できます。
Curve for Floats	データインターフェース	シミュレーション用に単一チャンネルのカーブデータインターフェースを追加します。このカーブを動的入力またはその他のモジュールによってサンプリングすることで、時間によって変化する浮動小数 (Float) 値を作成できます。
Curve for Vector 2Ds	データインターフェース	シミュレーション用に 2 チャンネルのカーブデータインターフェースを追加します。このカーブを動的入力またはその他のモジュールによってサンプリングすることで、時間によって変化する浮動小数 (Float) 値のペアを作成できます。
Curve for Vector 3s	データインターフェース	シミュレーション用に 3 チャンネルのカーブデータインターフェースを追加します。このカーブを動的入力またはその他のモジュールによってサンプリングすることで、時間によって変化する一連の浮動小数 (Float) 値を作成できます。
Curve for Vector 4s	データインターフェース	シミュレーション用に 4 チャンネルのカーブデータインターフェースを追加します。このカーブを動的入力またはその他のモジュールによってサンプリングすることで、時間によって変化する一連の浮動小数 (Float) 値を作成できます。
ENiagaraBooleanLogicOps	列挙型	次のブール論理を使ってテストを行う各種モジュールおよび動的入力で使用される列挙型です。 Greater Than Greater Than Or Equal To Equal To Not Equal To (～と等しくない)
ENiagaraCoordinateSpace	列挙型	複数の座標空間を区別するために各種モジュールおよび動的入力で使用される列挙型です。 Simulation:エミッタが [Local (ローカル)] に設定されている場合は、[Local] を使用します。それ以外の場合は、[World (ワールド)] を使用します。 World:ゲームのワールド空間内です。 Local:所有するコンポーネントの座標空間内です。
ENiagaraExecutionState	列挙型	この列挙型は、Emitter.ExecutionState や System.ExecutionState など、システムまたはエミッタの実行状態を管理するパラメータによって使用されます。
ENiagaraExecutionStateSource	列挙型	実行状態設定のソースを示します。これは、その状態がより高い優先度が設定されている要素で定義されていない場合にのみ、スケーラビリティで状態を変更できるようにするために使用されます。
ENiagara ExpansionMode	列挙型	拡張の原点を以下のいずれかに決定するために Location モジュールで使用される列挙型です。 Inside Centered Outside
ENiagaraOrientationAxis	列挙型	どの軸で計算するかを決定するために、いくつかのモジュールで使用される列挙型です。 X Axis Y Axis Z Axis
ENiagaraRandomnessMode	列挙型	このエミッタで使用される乱数生成のタイプを設定します。有効な選択肢は以下のとおりです。 Simulation Defaults Deterministic Non-Deterministic (非決定的)
Float	プリミティブ	浮動小数値の変数を作成します。
Grid2D Collection	データインターフェース	シミュレーションの段階で使用するパラメータです。これにより、ユーザーはデータの 2D 配列を読み取ったり書き込んだりでき、シミュレーションの段階でグリッド内でピクセルごとにイテレーションできるようになります。
Int32	プリミティブ	整数変数を作成します。
Linear Color	プリミティブ	カラーピッカーとして表される RGBA 色の変数を作成します。
Matrix	プリミティブ	4x4 の行列変数を作成します。
Mesh Tri Coordinate	構造体	トライアングル表面の重心座標を伴うトライアングルのインデックスを含む単純な構造体です。
Neighbor Grid 3D	データインターフェース	シミュレーションの段階で使用するパラメータです。これにより、ユーザーはデータの 3D 配列を読み取ったり書き込んだりでき、シミュレーションの段階でボリューム内でピクセルごとにイテレーションできるようになります。
Niagara ID	構造体	パーティクルの追跡に使用される 2 要素からなる構造体です。パーティクルデータに迅速にアクセスできるようになります。Niagara ID は、現在存続しているパーティクル間において常に一意であり、パーティクルの消滅後には再利用されます。AcquireTag はこの ID が取得されたときの一意のタグです。特定のパーティクルが消滅し、別のパーティクルがその消滅したパーティクルのインデックスを再利用する際に、それらのパーティクルを区別できます。
Occlusion Query	データインターフェース	新しい Occlusion Query データインターフェースモジュールをエミッタに追加します。このデータインターフェースは深度バッファオクルージョン情報の読み取りに使用します。 GPU エミッタでのみ使用可能です。
Particle Attribute Reader	データインターフェース	新しい Particle Attribute Reader データインターフェースをエミッタに追加します。このデータインターフェースは、他のエミッタからのパーティクルペイロード値に対するクエリに使用でき、状況によっては Events よりも使いやすい場合があります。
Quat	プリミティブ	回転を表すクォータニオン変数を作成します。
Simple Counter	データインターフェース	新しい Simple Counter データインターフェースモジュールをエミッタに追加します。このデータインターフェースにより、スレッドセーフなカウンターを増大させることができます。 CPU エミッタでのみ使用可能です。
Skeletal Mesh	データインターフェース	これは関数を含むデータインターフェースで、スケルタルメッシュのボーンまたはソケットとスキンジオメトリとのやり取りに使用します。
Spawn Info	構造体	パーティクルの作成回数を表す Count、スポーンを開始する現在のフレームの開始時間からのオフセットである InterpStartDt、スポーンされるパーティクル間の間隔を定義する IntervalDt、スポーンしたパーティクルを異なるカテゴリに属させる SpawnGroup を指定するためにスポーンで使用される構造体です。
Spline	データインターフェース	Spline アセットとやりとりするデータインターフェースです。
Static Mesh	データインターフェース	これは関数を含むデータインターフェースで、スタティックメッシュのサーフェスとのやり取りに使用します。
Texture Sample	データインターフェース	これは関数を含むデータインターフェースで、GPU 上のテクスチャとのやり取りに使用します。
Vector	プリミティブ	3 チャンネルの一連の浮動小数値を作成します。
Vector 2D	プリミティブ	2 チャンネルの一連の浮動小数値を作成します。
Vector 4	プリミティブ	4 チャンネルの浮動小数点のセットを作成します。
Vector Field	データインターフェース	これは関数を含むデータインターフェースで、ベクターフィールドのクエリに使用します。
Volume Texture Sample	データインターフェース	新しい Volume Texture データインターフェースモジュールをエミッタに追加します。これはボリュームテクスチャのサンプリングに使用できます。