Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

> プログラミングとスクリプト言語 > ブループリントビジュアルスクリプティング > ブループリントのテクニカルガイド > ブループリントコンパイラの概要

Light Theme

Dark Theme

ブループリントコンパイラの概要

ブループリントのコンパイル手順

専門用語

FKismetCompilerContext: コンパイルを処理するクラスです。新しいインスタンスは、コンパイルするとスポーンされます。コンパイル中のクラスやブループリントなどに関する参照を格納します。
FKismetFunctionContext: 関連するグラフ、プロパティ、生成した UFunction など、単一関数をコンパイルするための情報を保持します。
FNodeHandlingFunctor: コンパイラでノードのクラスを 1 つだけ処理するヘルパークラスです (シングルトンパターン)。ピン接続を登録しコンパイルステートメントを生成する関数を格納します。
FKismetCompiledStatement: コンパイラの作業単位です。コンパイラは、ノードを一連のコンパイル済みのステートメントへ変換します。つまり、バックエンドをバイトコード操作へ変換します。
FKismetTerm: グラフのターミナルです (リテラル、定数、または参照変数)。データピン接続はそれぞれ、これらのいずれかに関連付いています！Scratch の変数、中間結果など、NodeHandlingFunctor に独自のターミナルを作成することも出来ます。

コンパイルプロセス

ブループリントをコンパイルする基本プロセスについて以下で説明します。

(アイテムをクリックして表示)

*完全コンパイルのみ

クラスの整理

クラスはインプレース (in-place) でコンパイルされます。つまり同じ UBlueprintGeneratedClass は整理されて何度も繰り返し使用されます。従ってクラスへのポインタを修正する必要がありません。CleanAndSanitizeClass() は、 CleanAndSanitizeClass() は、クラスからプロパティと関数を一時パッケージ内のトラッシュクラスへ移動させて、クラスにあるデータをクリアします。

クラスプロパティの作成

コンパイラは、クラスに必要な UProperty 全てを検索するために、ブループリントの NewVariables 配列およびその他の場所 (コンストラクション・スクリプトなど) をイタレートします。その後、関数 CreateClassVariablesFromBlueprint() の UClass のスコープ上に UProperties が作成されます。

関数リストの作成

コンパイラは、イベントグラフを処理し、通常の関数グラフを処理し、関数を プリコンパイル する、つまり各コンテキストに対して PrecompileFunction() を呼び出すことによって、クラスの関数リストを作成します。

イベントグラフの処理

イベントグラフの処理は、CreateAndProcessUberGraph() 関数によって行われます。従って、全てのイベントグラフを 1 つの大きなグラフへコピーします。その後、ノードの拡張が可能になります。続いてグラフ内の各イベントノードに対して関数スタブが作成され、各イベントグラフに対して FKismetFunctionContext が作成されます

関数グラフの処理

通常の関数グラフの処理は、ProcessOneFunctionGraph() 関数によって行われます。これは、各グラフを一時グラフに複製し、そこでノードが拡張可能になります。各関数グラフに対して
FKismetFunctionContext も作成されます。

関数のプリコンパイル

関数のプリコンパイルは、各コンテキストの PrecompileFunction() によって処理されます。この関数は、以下のアクションを行います。

実行をスケジュールしてデータ依存関係を計算します。
スケジュール外または非データ依存のノードを取り除きます。
ノードハンドラ―の RegisterNets() を残りのノードそれぞれで実行します。
これにより関数内の値に FKismetTerms を作成します。
UFunction と関連プロパティを作成します。

クラスのバインドおよびリンク

コンパイラがクラスに対する UProperties と UFunctions を認識したので、コンパイラはクラスをバインドおよびリンクすることができます。これには、プロパティチェーン、プロパティサイズ、関数マップなどを書き込むことを伴います。この時点で、基本的にクラスヘッダがありますが、最終的なフラグとメタデータおよびクラスのデフォルトオブジェクト (CDO) がありません。

関数のコンパイル

残りのノードのために FKismetCompiledStatment オブジェクトを生成します。 AppendStatementForNode() を使用して、ノードハンドラ―の Compile() 関数を用いて実現しました従って、ローカルでの使用に限り、コンパイル関数で FKismetTerm オブジェクトを作成します。

クラスのコンパイルの完了

クラスのコンパイルを終了するために、コンパイラはクラスのフラグを確定し、親クラスからフラグとメタデータを伝搬してから、コンパイルが問題なく終了したことを確認するために、いくつかの最終チェックを実行します。

バックエンドによる生成コードの吐き出し

バックエンドはステートメントのコレクションを各関数コンテキストからコードへ変換します。以下の 2 種類のバックエンドを使用します。

FKismetCompilerVMBackend - FKCS をアンリアル・スクリプトの VM バイトコードへ変換します。これはその後、関数のスクリプト配列でシリアル化されます。
FKismetCppBackend - デバッグ作業限定で C++ のようなコードを吐き出します。

クラスのデフォルトオブジェクトプロパティのコピー

特殊な関数、CopyPropertiesForUnrelatedObjects() を使用して、コンパイラは古い CDO からの値を新しい CDO にコピーします。プロパティは、シリアル化をタグ付けしてコピーされるため、名前が統一されている限り、正確に転送されます。CDO のコンポーネントは再インスタンス化されてこの段階で的確に修正されます。GeneratedClass CDO は信頼できる CDO です。

再インスタンス化

クラスのサイズ変更やプロパティが追加または削除された可能性があるため、コンパイラはコンパイルしたばかりのクラスですべてのオブジェクトを再インスタンス化する必要があります。このプロセスでは、TObjectIterator を使用してクラスのすべてのインスタンスを検索し、新しいインスタンスをスポーンした後に、 CopyPropertiesForUnrelatedObjects() を使用して旧インスタンスから新インスタンスにコピーします。

詳細は、FBlueprintCompileReinstancer クラスを参照してください

タグ

Blueprints

このページは Unreal Engine の前のバージョン用です。現在リリースされている Unreal Engine 5.2 に対して更新は行われていません。

Unreal Engine のドキュメントを改善するために協力をお願いします！どのような改善を望んでいるかご意見をお聞かせください。

調査に参加する

キャンセル

ブループリント コンパイラの概要