Animation Budget Allocator

Animation Budget Allocator (または Anim Budgeter) システムは、スケルタル メッシュ コンポーネントのティックを動的にスロットリングすることで実行されるアニメーション データにかかる時間を制限します。 そのシステムを使用すると、最小限のシステム オーバーヘッドで知覚できるアニメーション品質を最大にしながら、固定の CPU バジェットを (超えないようにして) 実行できます。

システムはプラットフォームごとに (ゲームスレッドで実行する作業のミリ秒 (ms) で) 固定の割り当てバジェット時間を決定し、必要な作業がすべて実行できるか、または削減する必要があるかどうかを計算します。 作業を減らす必要がある場合は、重要度に応じて複数の領域を対象に負荷を動的に調整して、固定 (ゲームスレッド) 割り当てバジェット内に収まるようにします。 その領域は次のとおりです。

• ティックを停止し、マスター ポーズ コンポーネント を使用する。

• より低いレートで更新を実行する。

• 更新間の補間をするかしないか。 

Anim Budgeter を有効にする

Animation Budget Allocator を使うには、まず [Plugins] メニューから有効にする必要があります。

1. [Edit (編集)] > [Plugins] オプションから [Plugins] メニューを開きます。 

2. [Programming] の下で、Animation Budget Allocator プラグインを有効にしてエディタを再起動します。 

クリックして拡大

Anim Budgeter を使用する

Anim Budgeter を使用するには、「`」(Backtick キー) もしくは日本語環境では「@」を押して次のコンソール コマンドを入力します。

• 有効にするには「a.Budget.Enabled 1」

• 無効にするには「a.Budget.Enabled 0」

プラグインを有効にすると、Anim Budgeter が自動的に有効となります。

Enable Animation Budget ブループリント ノードを使用して Anim Budgeter の有効と無効を切り替えることも可能です。

現時点では、ブループリントに公開されている機能はこれだけです。それ以外のシステムはコンソール変数と C++ API コールでアクセスします。

デバッグ表示を有効にするには以下の通り実行します。

デバッグ情報の表示機能は現在 GitHUb のマスター ブランチのみで利用できます。この機能は 4.23 でさらに広く使用可能になります。

• デバッグ表示を有効にするには「a.Budget.Debug.Enabled 1」

• デバッグ表示を無効にするには「a.Budget.Debug.Enabled 0」

有効にすると、実行時にビューポート内にグラフが表示されます。

グラフは次のもので構成されています。

1. ミリ秒単位の時間は 1 カーネル約 20 フレームとスムーズになり、傾向や 1 ティックあたりの時間がわかりやすくなりました。 

2. 合計時間

3. Anim Budget (点線)

4. パフォーマンス (実線)

パフォーマンスは、実行する必要がある作業量によって異なります。 下記、点線は Anim Budget で実線はパフォーマンスです。 1 人のキャラクター (プレイヤー) がティックしているので、現在は割り当てバジェットの範囲内です。

以下では、キャラクター数を 10 に増やすと、パフォーマンスにスパイクが (ノイズ線) が現れるようになり、それに対する影響がわかります。 パフォーマンスには 2 本の線があります。灰色の線は実際のシステム パフォーマンスで、少しノイズが多く、システムの負荷によって変動します。 滑らかな白い線は、実際のシステム パフォーマンスをより正確に示しています。

以下の最後の例では、キャラクター数を 100 以上に増やしていることから、パフォーマンスが割り当てバジェット (点線) 周辺で推移していることがわかります。

クリックして拡大

これはアニメーション専用で、アニメーションがティックされる頻度を表します。

Anim Budgeter は、システムが行っている処理の全体量を割り当てバジェット内に収めるようにし、システムが生み出すことができる品質の最大化を試みます。 最も近くて重要なメッシュを可能な限り最高のフレームレートで実行しようとし、重要でないものや遠くにあるメッシュのフレームレートを低くします。 これは、実行する必要がある作業の総量が割り当てを埋める間にすべて行われます。

各スケルタル メッシュには、デバッグ データが表示されます。

数字はメッシュが更新されているレートを示します。 値が「1」の場合は、更新中であり、すべてのフレームでティックすることを意味します。 値が「5」の場合は、5 フレームごとに更新を行いティックすることを意味します。

一例として、Fortnite では、キャラクターはいくつかのスケルタル メッシュ (頭、ボディ、バックパックなど) で構成されていて、それらはすべて所定の時間と場所でティックします。 Anim Budgeter を実行すると、数値で表されるメッシュの更新頻度に加えて、 Lo、Hi、I のテキストが使用されていることがわかります。 これはメッシュがどのようにティックされるかを表します。

• Hi (または高詳細度) - スケルタル メッシュ コンポーネントで、より高負荷なロジックを実行していることを意味します。 

• Lo (または低詳細度) - 高負荷なロジック (余分なキャラクターのパーツやさらに高負荷なタスクなど、距離がある時にスキップ可能なもの) が実行されていないことを意味します。 

• I (または補間) - スケルタル メッシュがフレーム間を補間していることを意味します。 

以下の例は、必要なアニメーション作業量に基づいて Anim Budgeter の更新と優先順位がどのようにシフトされるかを示しています。

Anim Budgeter C++ API

下記のエンジンのインストール フォルダ内にある Anim Budgeter の C++ ファイルにアクセスできます。

• Engine\Plugins\Runtime\AnimationBudgetAllocator\Source\AnimationBudgetAllocator\Public\

以下は IAnimationBudgetAllocator.h: です。

	// Copyright 1998-2019 Epic Games, Inc. All Rights Reserved.
	#pragma once
	class USkeletalMeshComponentBudgeted;
	class UWorld;
	struct FAnimationBudgetAllocatorParameters;
	/**
	* 指定された割り当てバジェットを維持するためにスケルタル メッシュ コンポーネントのティック レートを動的に管理します。
	*/
	class IAnimationBudgetAllocator
	{
	public:
		/** 指定されたワールドの割り当てバジェットを取得します */
		static ANIMATIONBUDGETALLOCATOR_API IAnimationBudgetAllocator* Get(UWorld* InWorld);
		/**
		* コンポーネントを割り当てシステムに登録します。コンポーネントがすでに登録されている場合、この関数は何もしません。
		* この関数が呼ばれると次のようになります。
		* - デフォルトのティック関数の無効
		* - URO の無効
		* - 並列アニメーション タスクの割り当てシステムへの転送
		*/
		virtual void RegisterComponent(USkeletalMeshComponentBudgeted* InComponent) = 0;
		/**
		* 割り当てシステムからのコンポーネントの登録解除。 コンポーネントが登録されていない場合、この関数は何もしません。
		* この関数が呼ばれると次のようになります。
		* - デフォルトのティック機能の再有効化
		* - URO の再有効化
		* - 並列アニメーション タスクの内部関数への転送
		*/
		virtual void UnregisterComponent(USkeletalMeshComponentBudgeted* InComponent) = 0;
		/**
		* このコンポーネントの重要度と前提条件を更新します。
		* 前提条件が外部から変更されている可能性がある場合に呼び出す必要があります。
		*/
		virtual void UpdateComponentTickPrerequsites(USkeletalMeshComponentBudgeted* InComponent) = 0;
		/**
		* 指定されたコンポーネントに重要度と他のフラグを設定します。
		* この情報は、コンポーネントのティック レートを動的に制御するために使用されます。
		*/
		virtual void SetComponentSignificance(USkeletalMeshComponentBudgeted* Component, float Significance, bool bNeverSkip = false, bool bTickEvenIfNotRendered = false, bool bAllowReducedWork = true, bool bForceInterpolate = false) = 0;
	/** 指定されたコンポーネントをティックするかどうかを設定します。 バジェット割り当てが無効になっている場合、Component->SetComponentTickEnabled(bShouldTick) が呼び出されます。 */
		virtual void SetComponentTickEnabled(USkeletalMeshComponentBudgeted* Component, bool bShouldTick) = 0;
		/** 指定されたコンポーネントがティックするかどうかを設定します */
		virtual bool IsComponentTickEnabled(USkeletalMeshComponentBudgeted* Component) const = 0;
		/** 指定されたコンポーネントがティックするように設定されているかどうかを取得します */
		virtual void SetIsRunningReducedWork(USkeletalMeshComponentBudgeted* Component, bool bInReducedWork) = 0;
	/** コンポーネントの作業量を削減したことを通知します */
		virtual void SetGameThreadLastTickTimeMs(int32 InManagerHandle, float InGameThreadLastTickTimeMs) = 0;
		/** 作業完了時間を設定します */
		virtual void SetGameThreadLastCompletionTimeMs(int32 InManagerHandle, float InGameThreadLastCompletionTimeMs) = 0;
		/** フレームごとにシステムをティックします */
		virtual void Update(float DeltaSeconds) = 0;
		/** このバジェット割り当てアロケータが有効かどうかを設定します */
		virtual void SetEnabled(bool bInEnabled) = 0;
		/** このバジェット割り当てアロケータが有効かどうかを取得します */
		virtual bool GetEnabled() const = 0;
		/** 異なるパラメータを設定します */
		virtual void SetParameters(const FAnimationBudgetAllocatorParameters& InParameters) = 0;
	};
Copy full snippet

// Copyright 1998-2019 Epic Games, Inc. All Rights Reserved. #pragma once class USkeletalMeshComponentBudgeted; class UWorld; struct FAnimationBudgetAllocatorParameters; /** * 指定された割り当てバジェットを維持するためにスケルタル メッシュ コンポーネントのティック レートを動的に管理します。 */ class IAnimationBudgetAllocator { public: /** 指定されたワールドの割り当てバジェットを取得します */ static ANIMATIONBUDGETALLOCATOR_API IAnimationBudgetAllocator* Get(UWorld* InWorld); /** * コンポーネントを割り当てシステムに登録します。コンポーネントがすでに登録されている場合、この関数は何もしません。 * この関数が呼ばれると次のようになります。 * - デフォルトのティック関数の無効 * - URO の無効 * - 並列アニメーション タスクの割り当てシステムへの転送 */ virtual void RegisterComponent(USkeletalMeshComponentBudgeted* InComponent) = 0; /** * 割り当てシステムからのコンポーネントの登録解除。 コンポーネントが登録されていない場合、この関数は何もしません。 * この関数が呼ばれると次のようになります。 * - デフォルトのティック機能の再有効化 * - URO の再有効化 * - 並列アニメーション タスクの内部関数への転送 */ virtual void UnregisterComponent(USkeletalMeshComponentBudgeted* InComponent) = 0; /** * このコンポーネントの重要度と前提条件を更新します。 * 前提条件が外部から変更されている可能性がある場合に呼び出す必要があります。 */ virtual void UpdateComponentTickPrerequsites(USkeletalMeshComponentBudgeted* InComponent) = 0; /** * 指定されたコンポーネントに重要度と他のフラグを設定します。 * この情報は、コンポーネントのティック レートを動的に制御するために使用されます。 */ virtual void SetComponentSignificance(USkeletalMeshComponentBudgeted* Component, float Significance, bool bNeverSkip = false, bool bTickEvenIfNotRendered = false, bool bAllowReducedWork = true, bool bForceInterpolate = false) = 0; /** 指定されたコンポーネントをティックするかどうかを設定します。 バジェット割り当てが無効になっている場合、Component->SetComponentTickEnabled(bShouldTick) が呼び出されます。 */ virtual void SetComponentTickEnabled(USkeletalMeshComponentBudgeted* Component, bool bShouldTick) = 0; /** 指定されたコンポーネントがティックするかどうかを設定します */ virtual bool IsComponentTickEnabled(USkeletalMeshComponentBudgeted* Component) const = 0; /** 指定されたコンポーネントがティックするように設定されているかどうかを取得します */ virtual void SetIsRunningReducedWork(USkeletalMeshComponentBudgeted* Component, bool bInReducedWork) = 0; /** コンポーネントの作業量を削減したことを通知します */ virtual void SetGameThreadLastTickTimeMs(int32 InManagerHandle, float InGameThreadLastTickTimeMs) = 0; /** 作業完了時間を設定します */ virtual void SetGameThreadLastCompletionTimeMs(int32 InManagerHandle, float InGameThreadLastCompletionTimeMs) = 0; /** フレームごとにシステムをティックします */ virtual void Update(float DeltaSeconds) = 0; /** このバジェット割り当てアロケータが有効かどうかを設定します */ virtual void SetEnabled(bool bInEnabled) = 0; /** このバジェット割り当てアロケータが有効かどうかを取得します */ virtual bool GetEnabled() const = 0; /** 異なるパラメータを設定します */ virtual void SetParameters(const FAnimationBudgetAllocatorParameters& InParameters) = 0; };

追加のコンソール コマンド

Anim Budgeter のデバッグには、次のコンソール コマンドも使用できます。