UE4 CPU負荷軽減についてのメモ

# 概要
UnrealEngine のCPU負荷軽減について注意すべき項目のメモ書きです。

## 更新履歴
| 日付 | 内容 |
|:----|:-----|
|2020/03/31| socketがついたボーンのLODについての記述を訂正 |
|2020/05/22| ShowMaterialSectionについての追記 |
|2020/06/21| アニメ―ション通知のLODについて追記 |


## 環境
Windows10
Visual Studio 2017
UnrealEngine 4.22, 4.24

## 参考
以下を参考にさせて頂きました、ありがとうございます。

[UnrealEngine公式：アクターのTick](https://docs.unrealengine.com/ja/Programming/UnrealArchitecture/Actors/Ticking/index.html)
[UnrealEngine公式：動的解像度](https://docs.unrealengine.com/ja/Engine/Rendering/DynamicResolution/index.html)
[UnrealEngine公式：アニメ―ション最適化](https://docs.unrealengine.com/ja/Engine/Animation/Optimization/index.html)
[60fpsアクションを実現する秘訣を伝授 基礎編](https://www.slideshare.net/EpicGamesJapan/ue4-festeast2019-60fpsbasic)
[60fpsアクションを実現する秘訣を伝授 解析編](https://www.slideshare.net/EpicGamesJapan/ue4-festeast2019-60fpsanalysis)
[UE4 BPとC++のパフォーマンス比較検証](http://unrealengine.hatenablog.com/entry/2019/10/29/000653)
[【CEDEC 2018】CPUコストを削減して思い通りの演出を！　UE4で多数のキャラクターを活かすためのテクニック](https://www.slideshare.net/EpicGamesJapan/cedec2018-ue4-111105729)
[UEでゲームスレッドのCPUパフォーマンスをどう改善するか](https://www.unrealengine.com/ja/blog/how-to-improve-game-thread-cpu-performance)
[UE4 LODs for Optimization -Beginner-](https://www.slideshare.net/com044/lods-for-optimization-beginner)
[[UE4] LODを視覚化するコマンド](https://qiita.com/EGJ-Ken_Kuwano/items/e6fd25e896148e4fe4b5)
[背景コリジョン作成においてのベストプラクティス](https://udn.unrealengine.com/questions/530689/view.html)
[UE4 LODs for Optimization -Beginner-](https://www.slideshare.net/com044/lods-for-optimization-beginner)
[【UE4】URO(UpdateRateOptimizations)でアニメーションの最適化](https://logicalbeat.jp/blog/6222/)


# ブループリント
実装コストを無視するなら全てC++で作成したほうがいいです（VM呼び出しが減るため）。

## Tick処理
[プロジェクト設定] -> [基本設定] -> [Blueprints]でデフォルトのTickを切ることができます。
![Projctsetting_bp.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/bc93da70-0f50-9bbd-7d3a-cca31d14cd17.jpeg)

`PrimaryActorTick.bCanEverTick`　`PrimaryComponentTick.bCanEverTick` が trueなC++クラスから継承されたBPはTick可能です。
他に親クラスのメタ情報 `meta =(ChildCannotTick)`や `meta=(ChildCanTick)`でも設定可能なようです。

コンソールコマンド`[dumpticks]`で確認可能です。（そのままだと見にくいですが）

あとは`[Tick Interval]`を調整して毎フレーム呼び出しをしないような調整をするのも良いと思われます。

## BlueprintNativeEvent
Blueprintからの呼び出しが可能でC++側での実装も持っているメソッド。C++側では_Implementation をつけて実装する必要があります。

```cpp:.h
UFUNCTION(BlueprintNativeEvent, BlueprintCallable)
void Update();
```

```cpp:.cpp
void AMyActor::Update_Implementation()
{
// C++側の実装
}
```

BP側での実装がなくても実装があるかどうかの確認分の処理がかかるため重くなるので、C++のみで済むならUFUNCTIONをなくして実装すると良いそうです。


## UFUNCTION,UPROPERTY
UObject数が増えるため、不要なUFUNCTION,UPROPERTYは付けない方が良いみたいです。原因としてはUObject数増加によるGCの負荷がかかります。

シーン中のオブジェクトを調べるには以下コマンドが有用です。（`-alphasort`はアルファベット順にソートするオプションです）

```
>obj list -alphasort
```



# モデル - LOD
アニメ―ション関連処理でのCPU負荷を軽減するためのLOD関連の設定です。

デフォルトのオート設定は微妙なので LODSettings にて設定をする必要があります。
![Mesh_LODSetting.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/4ecbf275-f467-fb96-8eb5-14b3a485ca7e.jpeg)

LODは処理負荷軽減の効果が高いため、LOD設定は最優先で設定をすべきかと思います。



## スタティックメッシュコンポーネント
最小のLODレベルが設定やLODレベルの固定ができます、重要度が低いメッシュには別途設定をすると負荷軽減が期待できます。

BPだと最小のLODレベルの設定メソッドがでませんでした。。
![StaticMesh_BP_LOD.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/efa3674d-9fee-c2d6-a927-50b43370b0c0.jpeg)


関連する UStaticMeshComponentクラスの設定

```cpp:StaticMeshComponent.h

// 0の場合、LODレベルを自動選択します。 0より大きい場合、（ForcedLodModel-1）に強制します。
UPROPERTY(EditAnywhere, AdvancedDisplay, BlueprintReadOnly, Category=LOD)
int32 ForcedLodModel;

// このStaticMeshComponentを最後のフレームにレンダリングするために必要なLOD。
UPROPERTY()
int32 PreviousLODLevel;

// このコンポーネントに使用される最小のLODを指定します。
// ForcedLodModelが有効な場合、これは無視されます。
UPROPERTY(EditAnywhere, AdvancedDisplay, BlueprintReadOnly, Category=LOD, meta=(editcondition = "bOverrideMinLOD"))
int32 MinLOD;

// MinLOD設定をオーバーライドするか
UPROPERTY(EditAnywhere, AdvancedDisplay, BlueprintReadOnly, Category=LOD)
uint8 bOverrideMinLOD:1;

```


## スケルタルメッシュコンポーネント
最小のLODレベルやLODレベルの固定が設定できます、重要度が低いメッシュには別途設定をすると負荷軽減が期待できます。

BPでも指定可能です。
![SkeletalMesh_BP_LOD.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/6ac5b9ff-4787-2f94-d101-0a2d58863a5c.jpeg)

関連する USkinnedMeshComponentクラスの設定

```cpp:SkinnedMeshComponent.h

// 0の場合、LODレベルを自動選択します。 0より大きい場合、（ForcedLodModel-1）に強制します。
UPROPERTY(EditAnywhere, AdvancedDisplay, BlueprintReadOnly, Category=LOD)
int32 ForcedLodModel;

// このコンポーネントが使用する最小LODレベル （例えば、2に設定した場合、2 + LODモデルのみが使用されます。）これは、一定の距離にあることが知られていて、ズームインするとより良いLODレベルが必要なメッシュに使用します。
UPROPERTY(EditAnywhere, AdvancedDisplay, BlueprintReadOnly, Category=LOD)
int32 MinLodModel;

// UpdateSkelPoseによって「予測」された最高のLODレベルです。これは、ボーンが基づいて更新されたものであるため、これよりも優れたLODでのレンダリングは許可されません。
int32 PredictedLODLevel;


// メッシュのMinLODではなく、このコンポーネントの MinLodModelで指定されたMinLODの値を使用するか
UPROPERTY(EditAnywhere, AdvancedDisplay, BlueprintReadOnly, Category = LOD)
uint8 bOverrideMinLod:1;
```

### ソケット設定における注意1
~~ソケットが設定されたボーンツリーはLODの削減対象にならないので、ソケットを使用する際は注意が必要です。~~

<font color=red>▼訂正</font>
ソケットを選択 -> [Socket Parameters] -> [Force Always Animated] のチェックを外すとソケットが設定されていてもLODに影響はありませんでした。
![ForceAlwaysAnimated.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/9b6fabfc-53c6-83ac-713f-d78bb40c73eb.png)
デフォルトではチェックが入っているようなので、設定に注意!

### ソケット設定における注意2
ソケットや物理アセットで使われているボーンのトランスフォームはボーンLODに関係なく計算されているらしいので、多数使用する場合は注意が必要です。


### メッシュのマテリアル単位で表示を切り替える
メッシュのマテリアル単位で表示 `ShowMaterialSection` で切り替えることができます。

![showmaterialsection.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/8b6435bf-a8c0-0435-ea26-3757302fcc67.jpeg)

C++だと以下のようなコードになります。

```cpp:.cpp
int32 _MatIndex = SkeletalMeshComponent->GetMaterialIndex(TEXT("head00"));
int32 _SectionIndex = 1;
int32 _LODIndex = 0;

SkeletalMeshComponent->ShowMaterialSection(_MatIndex, _SectionIndex, false, _LODIndex);

```

セクションとはスケルタルメッシュビュワーで見た時の以下の項目になります。
![Section.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/c92b1bfd-1ba6-0562-1a58-29f7cc42ba7f.jpeg)

`ShowMaterialSection` のコードは以下の様になっています。

```cpp:Components/SkinnedMeshComponent.cpp
void USkinnedMeshComponent::ShowMaterialSection(int32 MaterialID, int32 SectionIndex, bool bShow, int32 LODIndex)
{
	if (!SkeletalMesh)
	{
		// スケルタルメッシュがないので何もしない 
		return;
	}
	// このコンポーネントのLOD情報が初期化されていることを確認してください
	InitLODInfos();
	if (LODInfo.IsValidIndex(LODIndex))
	{
		const FSkeletalMeshLODInfo& SkelLODInfo = *SkeletalMesh->GetLODInfo(LODIndex);
		FSkelMeshComponentLODInfo& SkelCompLODInfo = LODInfo[LODIndex];
		TArray<bool>& HiddenMaterials = SkelCompLODInfo.HiddenMaterials;
	
		// まだ割り当てられていない場合は割り当てる
		if ( HiddenMaterials.Num() != SkeletalMesh->Materials.Num() )
		{
			// Materials.Num（）は<= SkeletalMesh-> Materials.Num（）でなければならないため、skeletalmeshコンポーネントを使用します
			HiddenMaterials.Empty(SkeletalMesh->Materials.Num());
			HiddenMaterials.AddZeroed(SkeletalMesh->Materials.Num());
		}
		// 有効なLODInfo LODMaterialMapがある場合は、マテリアルインデックスをルーティングします。
		int32 UseMaterialIndex = MaterialID;			
		if(SkelLODInfo.LODMaterialMap.IsValidIndex(SectionIndex) && SkelLODInfo.LODMaterialMap[SectionIndex] != INDEX_NONE)
		{
			UseMaterialIndex = SkelLODInfo.LODMaterialMap[SectionIndex];
			UseMaterialIndex = FMath::Clamp( UseMaterialIndex, 0, HiddenMaterials.Num() );
		}
		// マップされたセクションマテリアルエントリを表示/非表示としてマーク
		if (HiddenMaterials.IsValidIndex(UseMaterialIndex))
		{
			HiddenMaterials[UseMaterialIndex] = !bShow;
		}

		if ( MeshObject )
		{
			// 更新された非表示セクションのレンダリングスレッドを送信する必要があります
			FSkeletalMeshObject* InMeshObject = MeshObject;
			ENQUEUE_RENDER_COMMAND(FUpdateHiddenSectionCommand)(
				[InMeshObject, HiddenMaterials, LODIndex](FRHICommandListImmediate& RHICmdList)
			{
				InMeshObject->SetHiddenMaterials(LODIndex, HiddenMaterials);
			});
		}
	}
}
```

これを読むと、`SectionIndex` は `MaterialID` を探す場合に使用しているようです。`MaterialID` と `LODIndex` が確定している場合は -1 で問題ないようです。


上記を利用して、ボーンのアニメ―ションを止めて（ボーンを減らして）メッシュでの切り替えで表現すると処理軽減になるケースがあるかもしれません。
（この場合、切り替え用の通知などをアニメ―ションシーケンスに仕込んだりの手間がかかりますが）


# アニメ―ション
プロファイラでの[AnimGameThreadTime]はアニメ―ション関連処理の時間のようです。

## BPでの毎フレーム呼び出し処理のC++への移行
BPでの処理は呼び出しコストが高いので毎フレーム呼び出すような処理はC++への移行を検討した方が良いです。

![BP_UpdateAnimation.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/47e750b9-fb71-5415-4b7f-923b5552bbd6.jpeg)


```cpp:MyAnimInstance.cpp
void UMyAnimInstance::NativeUpdateAnimation(float DeltaTimeX)
{
	Super::NativeUpdateAnimation(DeltaTimeX);

	// [イベントBlueprint Update Animation]の処理をここに置く
}
```


## マルチスレッドでのアニメ―ション更新
アニメ―ションBPの[クラス設定] -> [Optimization] の [Use Multi Threaded Animation Update]をチェックするとゲームスレッド外での処理になるようです。デフォルトではプロジェクト設定にあります。

![AnimBP_Optimaization.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/f725b58e-d6ba-d1fa-0664-367becd370b7.jpeg)

ただしルートモーションを使用する場合はマルチスレッド更新ではなくなるので要注意です。

## Visibility Based Anim Tick Option
アニメーションのTickとボーン更新頻度の設定です。
スケルタルメッシュコンポーネント の [Optimization] -> [Visibility Based Anim Tick Option] の設定を [Only Tick Pose when Rendered] にすると画面外でのボーン計算がなくなるため負荷が下がります。
ただしアニメ―ションの計算がなくなることでのアクターの挙動に影響がないようなつくりにする必要があります。（アニメーションに通知を埋め込んでいる場合など）

![SkeletalMesh_Optimization.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/2cfb3121-b100-d3e7-336b-a2ba00e1fdf4.jpeg)

### Always Tick Pose and Refresh Bones
常にアニメーションのtick、ボーンも更新。

### Always Tick Pose
常にアニメーションのtick、レンダリング時のみボーンを更新。

### Only Tick Montages when Not Rendered
レンダリング時のみ、アニメーションのtickしてボーンを更新。
レンダリングされない場合、モンタージュのみ更新。

### OnlyTick Pose when Rendered
レンダリング時のみ、アニメーションのtickしてボーンを更新。


## Enable Update Rate Optimization
[Enable Update Rate Optimization] を有効にすると距離に応じた最適化がかかります。（同時に[Display Debug Update Rate Optimizations]を有効にするとアクターのバウンディングボックスの色が変わってチェックができます）

![SkeletalMesh_Optimization2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/1bf5a0df-f325-0333-344e-3da1cd410271.jpeg)

このようにバウンディングボックスの色でチェックができます。
![DebugURO.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/cfd7326e-5fca-147e-0438-a01cfefb4e1b.jpeg)


C++は以下のメンバ変数で変更可能です。

```cpp:SkinnedMeshComponent.h
	// Update Rate
	/** TRUEの場合、オーナーはアニメ―ションの更新および評価頻度を判断します。 AnimUpdateRateTick()を参照。 
	 * パフォーマンスに対し、フレームスキップを有効にします。（例えばスクリーンのビジビリティとサイズに基づいて） */
	UPROPERTY(EditAnywhere, AdvancedDisplay, BlueprintReadWrite, Category=Optimization)
	uint8 bEnableUpdateRateOptimizations:1;

	/** 更新レート最適化のオンスクリーンデバッグ作業を有効にします。 
	 * 赤 = 0フレームをスキップ、緑 = 1フレームをスキップ、
	 * 青 = 2フレームをスキップ、黒 = 2フレーム以上をスキップを意味します。
	 */
	UPROPERTY(EditAnywhere, AdvancedDisplay, BlueprintReadWrite, Category=Optimization)
	uint8 bDisplayDebugUpdateRateOptimizations:1;
```

コンソールコマンドでのスキップフレームの変更も可能です。

```console:コンソールコマンド
強制的にUpdateRateOpitimaization を ON にする
> a.URO.Enable

スキップさせたいフレーム数の設定をする
> a.URO.ForceAnimRate [数字]
```

重要ではないメッシュのアニメ―ションを指定してスキップすると良いと思われます。

アニメ―ション更新のレートコントロール関連のC++コードは以下にあります。

```cpp:SkinnedMeshComponent.h
	/** Delegate when AnimUpdateRateParams is created, to override its default settings. */
	FOnAnimUpdateRateParamsCreated OnAnimUpdateRateParamsCreated;

	/** Animation Update Rate optimization parameters. */
	struct FAnimUpdateRateParameters* AnimUpdateRateParams;
```

**FAnimUpdateRateParameters** は　"Engine/Source/Runtime/Engine/Classes/Engine/EngineType.h" に定義されています。

```cpp:EngineType.h
/*
デフォルト設定
	BaseVisibleDistanceFactorThesholds.Add(0.4f)
	BaseVisibleDistanceFactorThesholds.Add(0.2f)
意味：
0フレームスキップ：MaxDistanceFactor > 0.4f
1フレームスキップ：MaxDistanceFactor > 0.2f
2フレームスキップ：MaxDistanceFactor > 0.0f
*/
```
となっています。これを自前で設定する場合のコード例が以下になります。
スケルタルメッシュを取得して直接パラメータを書き換えています。

以下のコード例では距離でのフレームスキップが4段階で、非表示のスキップ数を10にしています。

```cpp:.cpp
// UROを有効にする
GetSkeletalMeshComponent()->bEnableUpdateRateOptimizations = true;
// アニメ―ション更新パラメータを書き換える
auto _Params = GetSkeletalMeshComponent()->AnimUpdateRateParams;
_Params->BaseVisibleDistanceFactorThesholds.Empty();
_Params->BaseVisibleDistanceFactorThesholds.Add(0.1f);
_Params->BaseVisibleDistanceFactorThesholds.Add(0.01f);
_Params->BaseVisibleDistanceFactorThesholds.Add(0.001f);
_Params->MaxEvalRateForInterpolation = 4;	// 補間がかかるフレームスキップ数
_Params->BaseNonRenderedUpdateRate = 10;	// 非表示時のフレームスキップ数

```

更新レートを見る場合は以下のように取得できます。

```cpp:.cpp
int32 _UpdateRate = GetSkeletalMeshComponent()->AnimUpdateRateParams->UpdateRate;
```

bDisplayDebugUpdateRateOptimizations での更新レートの数値を取るものです。


## アニメ―ション通知(AnimationNotify)のLOD設定
アニメ―ション通知系にもLOD設定ができます。
[詳細] -> [Trigger Settings] -> [Notify Filter Type] を `LOD` にして、[Notify Filter LOD] にスケルタルメッシュLODレベルを指定します。指定されたレベルの数値以上で通知が発行されません。

▼LOD2から通知が発行されない設定例（LOD0, LOD1なら通常動作になります）
![Notify_LOD.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/3bedba39-bfaa-3809-3fa3-2d8c39992f0b.jpeg)


## アニメ―ションノードのLOD設定
ボーン毎のレイヤーブレンドなどのノードにもLOD設定ができます。
[詳細] -> [Performance] -> [LOD Threshold] にLODレベルを設定します。

![AnimNode_LOD.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/e9f7421d-9dc3-bbcc-6a27-f220b2946db6.jpeg)

アニメ―ション通知と設定の仕方が違うので注意が必要です。


# コリジョン
プロファイラの[UpdateOverlaps Time] はコリジョンチェックにかかる処理時間のようです。
コリジョンの複雑度がそのまま処理にかかるようなので、表示用メッシュをそのままコリジョンとして使う[Use Complex Collision As Simple]は要注意。
基本は「シンプルに（凸包）」「数を少なく」のようです。

また、Overlapイベントを発生させるフラグの bGenerateOverlapEvents は不要な所でもtrueになっていると負荷が増えるので要注意です。


# UMG
BPがやはり重くなりがちなので処理部分はC++で書くと良いです。（実装コストが大変ですが）
あとはそもそもの表示量を減らすことや、ネイティブ化をしてみるのも検討に値するかと思います。

## RetainerBox
RenderTargetを使用して描画タイミングを調整できる機能です。
[Render Rules]の[Phase]が更新タイミング、[Phase Count]更新間隔です。
これを増やすことで描画間隔を減らすことができます。（例：Phase Count = 3 なら描画フレームの3回に1回描画される）

![UMG_RetainerBox.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/6551b950-dbc8-e60c-f289-a0aadf4e98dc.jpeg)

更新タイミング[Phase]を分けないと負荷が減らないことに注意。


## InvalidationBox
ジオメトリをキャッシュして更新をなくす機能です。
通常では描画の更新が行われないため、任意のタイミングで更新を制御する必要があります。また、[Preformance]->[IsVolatile] のチェックを入れた Widget はキャッシュ対象から外されます。
以下のノードを使って更新を制御できます。

`InvalidateCache`  キャッシュを破棄して再度キャッシュする
`SetCanCache`  キャッシュの有効/無効を制御
`GetCanCache`  キャッシュ有効/無効状態を取得

![UMG_InvalidationBox.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/0d6eb37d-e9a1-bf6c-5639-a1d1b26adefa.jpeg)


## performance設定
### Tick Frequency
[詳細] -> [Performance] -> [Tick Frequency] はデフォルトで[Auto]になっているのを[Never]にすると更新処理が止まり負荷が軽減します。
更新がなくても呼び出し負荷がかかるため、更新不要なUMGは設定すべきです。

![UMG_TickFrequency.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/7b5ba64a-1bc8-c912-eb34-aa8042b7204d.jpeg)

このメンバは privateで、変更するメソッドが見当たらないため、C++からの制御はできないようです。

```cpp:UserWidget.h
private:
	UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Performance", meta=(AllowPrivateAccess="true"))
	EWidgetTickFrequency TickFrequency;
```

### Is Volatile

![UMG_performance.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/303806/aa800c4a-ea22-9d25-5401-a03982c2964c.jpeg)

動的で変化が大きいUIの場合はここにチェックを入れてキャッシュをなくし、キャッシュのコストを抑えると有効な場合があります。

```cpp:Widget.h
protected:
	/* trueの場合、ウィジェットまたはその子のジオメトリまたはレイアウト情報はキャッシュされません。
	このウィジェットがすべてのフレームを変更するが、無効化パネル内に残したい場合は、フレームごとに無効化するのではなく、
	揮発性にする必要があります。これにより、無効化パネルが実際に何もキャッシュしなくなります。*/
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Performance")
	uint8 bIsVolatile:1;

public:
	/** Sets the forced volatility of the widget. */
	UFUNCTION(BlueprintCallable, Category="Widget")
	void ForceVolatile(bool bForce);
```

制御用メソッド `ForceVolatile` があります。


# メモリアロケート
Binned Allocator3 というアロケーターを使用しているようで、2に比べメモリ消費の最適化が行われていますが、CPU負荷が少しあがっているようです。
2に切り替えるには以下の設定を追加することで可能なようです。

```cs:*.Target.cs
GlobalDefinitions.Add("USE_MALLOC_BINNED3=0");
```

詳細はエンジンソースの
"Engine\Source\Runtime\Core\Private\Windows\WindowsPlatformMemory.cpp"
辺りを参照すると良いようです。
外部ライブラリのメモリアロケータ―を使うことも可能なようですが、プラットフォーム毎の修正が必要となります。
特定のプラットフォームだけにする場合は以下のように処理ができます。

```cs:*.Target.cs
if(Target.Platform == UnrealTargetPlatform.??? ){
 // 特定プラットフォームだけ
}
```


## TArray
UEでの動的配列です。動的なメモリ確保をなるべくなくすことが重要です。

### Slack[^1] のリサイズをしない
配列の要素数の上限が分かる場合は、Reserve で確保し、配列を消す場合も Empty ではなく Reset を使うと Slackのリサイズが行われないため余計なメモリ確保が起こりません。

[^1]: TArray配列の内部バッファをUE用語でslackと呼ぶようです。

### TInlineAllocator を使う

```cpp
TArray<UStaticMeshComponent*, TInlineAllocator<10>> _StaticMeshComponent;
```

指定サイズでの静的領域を確保します、ただし指定サイズより大きくなるとコストが増えるようなので使い方に注意が必要です。


### ローカル参照時はautoで参照しない
配列データの参照を返す以下のようなメソッドがある場合、

```cpp:.h
const TArray<FMiscData>& GetMiscData() const;
```

以下のようなローカル変数で参照をする時、

```cpp:.cpp

void Exec()
{
	// autoで受ける
	auto _MiscData = GetMiscData();
	// 型を明示して受ける
	const TArray<FMiscData>& _MiscData2 = GetMiscData();
}
```

ローカルで受ける場合、autoではなく、型を明示したほうが処理が速いです。
プロファイラで見た所、autoで受ける際に内部で slackの変更がかかっているようです。


# プラグイン
パフォーマンス改善につながりそうなプラグインです。
どれもプロジェクト毎にカスタムする必要があります。

## Animation Budget Allocator
スケルタルメッシュコンポーネントのTickを動的にスキップする管理をするプラグインです。複数メッシュに予算（バジェット）を設定してその範囲を超えないように管理できます。
[Animation Budget Allocator](https://docs.unrealengine.com/ja/Engine/Animation/AnimationBudgetAllocator/index.html)

## Significance Manager
パフォーマンス管理のためのオブジェクト単位の重要度を調整/管理するプラグインです。
[Significance Manager](https://docs.unrealengine.com/ja/Engine/Performance/SignificanceManager/index.html)


# プロファイル誘導最適化(Profile Guided Optimization : PGO)
事前準備と計測用パッケージが必要。
自動プレイ等がないとツラい？


# まとめ
CPU負荷を減らすのは事前の設計と機能把握が重要であると思われます。
方法はたくさんありますが、１つ１つこまめにやっていかないと全体の処理負荷軽減にはなりません。