Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

ブループリン トマクロ または マクロ は、本質的にノードの折り畳まれたグラフと同一です。トンネルノードで指定される エントリーポイントと出口点があります。それぞれのトンネルは、別のブループリントやグラフに使用されるとマクロノード上で可視化できる 実行またはデータピンがいくつもあります。

ブループリントマクロの作成

ブループリントマクロは Blueprint 関数と同様に、Blueprint クラスまたは Level ブループリント内で作成することができます。これらをブループリント マクロ ライブラリとしてまとめることもできます。

以下の方法でブループリント クラス、Level ブループリント、ブループリント マクロ ライブラリ内にブループリント マクロを作成します。

1. 関数リストヘッダー の [Add (追加)] ボタン をクリックして、 [My Blueprint] タブで新規マクロを作成します。

2. ブループリント マクロの名前を入力します。

ブループリント エディタの [Graph] タブで、ブループリント マクロが新規のタブとして開きます。

ブループリント マクロは、 [My Blueprint] タブを右クリックして、 [Macro] を選択して作成することも出来ます。

ブループリント マクロの構築

ブループリント マクロを初めて作成すると、 Inputs トンネルノードと Outputs トンネルノードが格納された新規のグラフが開きます。

ブループリント マクロの [Details] ペインで、実行およびデータの入出力ピンを追加することができます。ブループリント マクロの [Description (説明)] 、 [Category (カテゴリ)] 、 [Instance Color (インスタンス カラー)] を設定することもできます。

以下の手順で、入力または出力パラメータを追加します。

1. [Details (詳細)] ペインの [Inputs (入力)] または [Outputs (出力)] セクションのいずれかの [New (新規)] ボタンをクリックします。

2. 新パラメータに名前をつけて、ドロップダウン メニューを使用してタイプを設定します。この例では、 Score という Integer データの入力パラメータ、 Test という入力実行ピン、 Win および Lose という名前の 2 つの出力実行ピンがあります。

   ブループリント マクロ グラフのトンネルノードは、自動的に正確なピンで更新されます。

3. パラメータの入力を拡大することによって、デフォルト値を設定することも出来ます。

ノード端にあるパラメータのピンの位置を変更したい場合、 [Details] ペイン入力を展開して上下の矢印キーを使用します。

ブループリント マクロに機能性を持たせるには、データと実行ワイヤーを Inputs と Outputs トンネルノードのピンと接続して、間にネットワークを作成します。

この例のブループリント マクロは、Macro に入力されるスコアが勝つために必要なスコアを上回る大きさであるかをチェックし、 比較結果に基づいて、別の出力実行フローをトリガーします。 Test と Score ピンは、ブループリント マクロ グラフでワイヤーが交差するのを防ぐために [Details (詳細)] ペインで上下矢印キーを使用してフリップされることに留意してください。

関数と違ってマクロは 1 つ以上の実行ピンを持つことができます。つまり、別の出力実行ピンを、グラフロジックの結果に基づいてアクティベートするという 実行フローを使用することができます。また、Macro 内のノードが実行ノードではない限り、単にデータを操作する実行ピンを持たない Macro を持つことができます。

マクロの実装

Macro ノードを別のブループリント グラフへ追加する方法はいくつかあります。Function ノードや Custom Event Call ノードのように、ブループリントのグラフから 複数の Macro ノードのコピーを追加することができます。

マクロを追加するには、グラフを 右クリック して表示されるコンテキストメニューで [Macro] を選択します。

または、別のノードのピンをドラッグ、ドロップします。対応する変数タイプとフロー方向のパラメータピンがある場合、コンテクストメニューにマクロが表示されます。

別の方法として、 [My Blueprint] タブからマクロをグラフへドラッグ＆ドロップすることも出来ます。

Macro ノードがグラフへ追加されると、その他のノード同様に動作して入出力ピンは状況に応じてワイヤー接続されます。Macro ノードを ダブルクリック すると Macro のグラフが開きます。