コンフィギュレーション ファイル

コンフィギュレーション ファイルを使用して、プロジェクトのロード時に初期化されるプロパティの値を設定します。コンフィギュレーションは、セクション内に配置されたキー値ペアで決まります。 任意のキーに対して、1 つ以上の値を関連付けることができます。

Unreal Engine (UE) のコンフィギュレーション ファイルは、オブジェクトや変数のデフォルト値のために使用します。ユーザー入力によるコンフィギュレーションは、キーバインドとして利用できます。[Project Wizard] で新規ブランク プロジェクトを作成すると、 デフォルトで DefaultEngine.ini と DefaultGame.ini が作成されます。テンプレートで始まる新しいプロジェクトは、必要に応じて DefaultEditor.ini および DefaultInput.ini 構成ファイルも 生成する場合があります。

SaveConfig() 関数は Config クラス指定子を用いてクラスで呼び出すことができます。これにより、 Config プロパティ指定子でマークされているプロパティを適切なコンフィギュレーション ファイルに保存します。一般的に SaveConfig() によって保存される変数は、 [(package).(classname)] のフォーマットに従ったセクションのタイトルに入っています。例えば DefaultEngine.ini の [/Script/Engine.Engine] セクションは、Engine パッケージ内に格納された Engine クラスを指します。 ハード コーディングされたセクション名には、いくつかの例外があります。

コンフィギュレーション ファイルの編集を通してのみ、これまで利用可能であった数多くの設定が プロジェクト設定 エディタの Unreal Editor で利用することができます。

設定可能な変数を指定する

コンフィギュレーション ファイルからどの変数を読み出すかを指定するために、こうした変数を含むクラスは UCLASS マクロで Config 指定子をまず与えられなければなりません。

	UCLASS(Config=Game)
	class AExampleClass : public AActor
Copy full snippet

クラスに Config 指定子を付けると、そのクラスがコンフィギュレーション ファイルから読み出された変数を持っていることを表し、コンフィギュレーションがどのファイルから読み出されるかを指定します。 コンフィギュレーション ファイルから読み出す、コンフィギュレーション ファイルに格納するものとして指定するには、Config 指定子も UPROPERTY() マクロに入れる必要があります。

	UCLASS(Config=Game)
	class AExampleClass : public AActor
	{
		GENERATED_UCLASS_BODY()

		UPROPERTY(Config)
		float ExampleVariable;
	};
Copy full snippet

プロパティの Config 指定子にはカテゴリが何もありません。これで、ExampleVariable プロパティは、情報が以下の構文で指定されている限りは、コンフィギュレーション ファイルの階層 にあるどの Game コンフィギュレーション ファイルからも 読み出すことができます。

	[/Script/ModuleName.ExampleClass]
	ExampleVariable=0.0f
Copy full snippet

コンフィギュレーションファイルと継承

Config UCLASS と UPROPERTY の指定子は継承されます。つまり、子クラスは親クラスで Config として指定されているすべての変数を読み込む、 または保存することが可能であり、変数はすべて子クラスの名前を持つセクションの配下にあります。例えば、上の ExampleClass から継承した ChildExampleClass のコンフィギュレーション ファイル情報は、 以下の行のようになり、同じ Game コンフィギュレーション ファイルに保存されます。

	[/Script/ModuleName.ChildExampleClass]
	ExampleVariable=0.0f
Copy full snippet

インスタンス毎のコンフィギュレーション

UE4 には、オブジェクトの設定を必要なコンフィギュレーション ファイルへ保存する機能があります。UCLASS マクロで PerObjectConfig 指定子が使用されている場合、 このクラスのコンフィギュレーション情報は、インスタンス毎に保存されます。この場合、各インスタンスは [ObjectName ClassName] の形式でオブジェクトにちなんで名付けられた .ini ファイルのセクションを持ちます。 このキーワードは子クラスに受け継がれます。

コンフィギュレーションファイルの構造

各コンフィギュレーションのカテゴリには、独自のファイルの階層があり、エンジン固有、プロジェクト固有、およびプラットフォーム固有のコンフィギュレーションを指定します。

コンフィギュレーションのカテゴリ

• Compat
• DeviceProfiles
• Editor
• EditorGameAgnostic
• EditorKeyBindings
• EditorUserSettings
• Engine
• Game
• Input
• Lightmass
• Scalability

ファイルの階層

コンフィギュレーション ファイルの階層は、Base.ini から読み込まれ、階層の後の方のファイルの値は前の値をオーバーライドします。Engine フォルダにあるすべてのファイルは、すべてのプロジェクトに割り当てられますが、 プロジェクト固有の設定はプロジェクト ディレクトリにあるファイルに入れられます。最後に、すべてのプロジェクト固有およびプラットフォーム固有の差分は、[ProjectDirectory]/Saved/Config/[Platform]/[Category].ini に保存されます。

以下のファイル階層例は、コンフィギュレーション ファイルの Engine カテゴリのためのものです。

1. Engine/Config/Base.ini

1. Engine/Config/BaseEngine.ini
2. Engine/Config/[Platform]/base[Platform]Engine.ini
3. [Project Directory]/Config/DefaultEngine.ini
4. Engine/Config/[Platform]/[Platform]Engine.ini
5. [Project Directory]/Config/[Platform]/[Platform]Engine.ini

コンフィギュレーションファイルでの作業

ファイル形式

セクションとキー値ペア

典型的なコンフィギュレーション ファイルは、キー値ペアのセクションで構成され、以下のように配置されます。

	[Section]
	Key=Value
Copy full snippet

特殊文字

• + - プロパティがまだ存在しない場合に行を追加 (以前のコンフィギュレーション ファイルまたは同じコンフィギュレーション ファイルの前のバージョンから) 。
• - - プロパティからエントリを削除 (必ず完全一致であること)。
• . - エントリが既に存在するかどうかに関係なく、プロパティに新しいエントリを追加。
• ! - プロパティからすべてのエントリをクリア。プロパティ名が一致すれば完全一致する必要はありません。

	[/Script/Engine.PlayerInput]
	Bindings=(Name="Q",Command="Foo")
	.Bindings=(Name="Q",Command="Bar")
	.Bindings=(Name="Q",Command="Foo")
Copy full snippet

配列のシンタックス

.ini ファイルの配列のシンタックスは以下のようにフォーマットされています。

	[Section]
	!ArrayVar=anything_since_this_just_clears_it
	+ArrayVar=first_value
	+ArrayVar=second_value
	+ArrayVar=third_value
Copy full snippet

コメント

多くの人は、セミコロンはコンフィギュレーション ファイルのコメントと考えがちですが、正式にはそうではありません (FConfigFile::ProcessInputFileContents はコメントのデリミタとしてセミコロンやその他の文字列をそのように扱いません)。しかし、意図的にコメントのように動作させることができます。理論上では、あらゆる文字で異なるキー値ペアを示すことが可能です。一般的にセミコロンは新しい行の最初に配置されます。コメントのような機能をしますが、実際はそうではありません。

	; This is a Comment
	; So is this!
Copy full snippet