SceneCaptureActor

Export HDR movie from Scene Capture 2D on Unreal Engine 4

概要

Unreal Engine 4を使用して各フレームを.hdrファイルに連番で書き出すためのプラグインです。 Unreal Engine 4のMatineではLDR動画しか書き出せませんが、SceneCaptureActorを使用することで、HDR動画を書き出すことができます。

使用方法

基本設定

1. プロジェクトのソースコードにSceneCaptureActorを追加
2. SceneCaptureActor.hのMYPROJECT2_APIをプロジェクトに応じて書き換え
3. SceneCaptureActor.cppとrgbe.cppの #include "MyProject2.h" をプロジェクトに応じて書き換え
4. コンパイル
5. 全てのクラス -> SceneCapture2Dを配置
6. 新規追加 -> マテリアル -> 描画ターゲット(SceneRenderTarget)を追加
7. SceneCapture2DのTextureTargetにSceneRenderTargetをアタッチ
8. SceneCaptureActorをシーンに配置
9. SceneCaptureActorのrender_texにSceneRenderTargetをアタッチ
10. SceneCaptureActorのpathに書き出し先のパスを設定

出力ファイル

.hdrファイルの連番になります。 書き出したファイルのサンプルはsampleディレクトリにあります。

キューブマップの書き出し

SceneCapture2Dと同様の手順でキューブマップを書き出すことができます。

1. 全てのクラス -> SceneCaptureCubeを配置
2. 新規追加 -> マテリアル -> キューブの描画ターゲット(SceneRenderTargetCube)を追加
3. SceneRenderTargetCubeをrender_tex_cubeにアタッチ
4. path_cubeに書き出し先のパスを設定

キューブマップの仕様は以下のUnreal Engineの仕様に従います。

https://docs.unrealengine.com/latest/JPN/Engine/Content/Types/Textures/Cubemaps/CreatingCubemaps/index.html

Gbufferの書き出し

深度値の書き出し

深度値を書き出したい場合、Post Process MaterialをSceneCapture2Dに適用します。

1. 新規追加 -> マテリアル -> マテリアル(SceneDepth)を追加
2. SceneDepthをダブルクリック、Material DomainをPost Processに設定、SceneDepth UVsを適当な定数で割ってエミッシブカラーに接続
3. Scene Capture 2DのMiscのBlendablesにSceneDepthを設定
4. Scene Capture 2DのCapture SourceをFinal Color (LDR with Post Process)に設定

法線の書き出し

法線を書き出したい場合も、深度値と同様に、Post Process Materialを使用します。 Material EditorでSceneTexture:World Normalをエミッシブカラーに接続して下さい。

Tips

固定フレームレートでの書き出し

Unreal Engineは、BENCHMARKオプションを付けて実行することで、フレームレートを固定することができます。

"UE4Editor.exe" "(.uprojectのフルパス)" -ResX=1920 -ResY=1080 -FPS=60 -BENCHMARK

BENCHMARKオプションの詳細は以下にあります。 https://docs.unrealengine.com/latest/INT/Programming/Basics/CommandLineArguments/index.html

"BENCHMARK: Run game at fixed-step in order to process each frame without skipping any frames. This is useful in conjunction with DUMPMOVIE options."

また、フレームレートの固定は、C++ファイルのBeginPlayで以下のように記述しても行うことができます。

FApp::SetBenchmarking(true);
FApp::SetFixedDeltaTime(1/60);

フルHDでの書き出し

フルHDを書き出す場合は、クロップ機能がご利用頂けます。 テクスチャを2048x2048に設定し、crop_leftとcrop_rightに64を、crop_topとcrop_bottomに484を設定して下さい。

制約

解像度

SceneRenderTargetのサイズは2の乗数かつ正方形である必要があります。 また、Unreal Engineの制約から、出力の最大サイズは2048x2048となります。

実行条件

SceneCaptureActorが使用している、ConstructTexture2D APIの実装に、#if WITH_EDITORが含まれているため、-gameでは動作しません。

謝辞

.hdrファイルの書き出しには、以下のサイトのrgbe.cとrgbe.hを使用させて頂いています。

http://www.graphics.cornell.edu/online/formats/rgbe/