nDisplay コンフィギュレーション ファイルのリファレンス

4.27 以降でも、引き続き .cfg と .ndisplay の両方のコンフィギュレーション ファイルをプロジェクトの コンテンツ ブラウザ にインポートできます。その際、それらは .uasset という新しい形式に変換されます。

クラスタを起動するために、.ndisplay コンフィギュレーション ファイルをエクスポートして使用しできます。この場合、.ndisplay ファイルには nDisplay コンフィグ アセット でのみ構成できる追跡機能やその他の機能は付属していません。

nDisplay クラスタの構成には、nDisplay 3D コンフィグ エディタ を使用することをお勧めします。

nDisplay システムのほとんどの設定要素は、単一のコンフィギュレーション ファイルで定義します。このファイルでは、ネットワークを構成するコンピュータ、各コンピュータ上で Unreal Engine がレンダリングするウィンドウとビューポートの特性、各ビューポートがレンダリングする必要のある仮想ワールドのパーツ、受け入れる入力デバイスのタイプなどが指定されます。

このページでは、nDisplay コンフィギュレーション ファイルで使用可能なすべての設定について説明します。

nDisplay コンフィギュレーション ファイルの概要を把握し、独自のコンフィギュレーション ファイルを作成するには、手始めに nDisplay プラグインで提供されているサンプル コンフィギュレーションを使用することをお勧めします。NDisplay テンプレートからプロジェクトを作成した場合、これらのファイルは「Content/ExampleConfigs」の下にある「Project」フォルダにあります。その他の場合、これらのファイルは、「Templates/TP_nDisplayBP/Content/ExampleConfigs」の下にある Unreal Engine のインストール フォルダにあります。

nDisplay コンフィギュレーション ファイルの構造は、視覚化のレンダリングに使用するさまざまなタイプのコンポーネントに直接関連付けられています。

• コンフィギュレーション ファイルには、設定するコンポーネントのタイプごとに独自の行があり、ユーザーが割り当てる文字列 ID で識別されます。特定のコンフィギュレーション セクションで他のコンフィギュレーション セクションを参照する必要がある場合は、この文字列 ID を使用します。

• このファイルで設定するコンポーネントの多くには、仮想 3D 空間における位置 (および多くの場合回転状態) が定義されています。各オブジェクトの位置と回転状態は、そのオブジェクトの 親 が基準となります。デフォルトでは、すべてのオブジェクトの親は VR 空間の原点です。原点は、VR 空間が開始すると見なされる 3D ワールド空間の任意の点です。また、1 つ以上のコンポーネントの親として機能することができる scene_nodes という特殊な名前付きのトランスフォームを 3D 空間で構成することもできます。このトランスフォームを構成することで、スクリーン、カメラ、その他のコンポーネントの空間レイアウトを簡素化できます。 scene_nodes を使用して、すべてが仮想空間の同じポイントから始まる 3D トランスフォームの階層を構築する方法については、以下の「コンフィギュレーション ファイルのシーン構造体の例」のセクションを参照してください。

• 仮想 3D 空間または実世界の物理空間での測定値を参照するすべてのパラメータは、特に指定のない限り、メートル単位および度単位の値が想定されます。これには、スクリーン、シーン ノード、カメラなどが含まれます。

• スクリーン スペースの測定値を参照するすべてのパラメータは、ピクセル単位の値が想定されます。これには、ウィンドウとビューポートが含まれます。

Cluster Node コンフィギュレーション

nDisplay ネットワークで使用する Unreal Engine アプリケーションの各インスタンスで、cluster_node コンフィギュレーションを定義する必要があります。各 cluster_node コンフィギュレーションには、メイン アプリケーション ウィンドウのプロパティを定義する window コンフィギュレーション セクションへの参照が含まれている必要があります。

cluster_node コンフィギュレーションでは、そのアプリケーション インスタンスを実行するコンピュータのホスト名または IP アドレスも定義します。cluster_node コンフィギュレーションごとに異なる物理コンピュータを設定したり、同一ホスト上で実行される複数の cluster_node コンフィギュレーションを設定することもできます。

コンフィギュレーションの例：

この例では、プライマリ ノード (ネットワークごとに 1 つ) を設定します。

	[cluster_node] id=node_front addr=192.168.0.1 window=wnd_LT sound=true port_cs=41001 port_ss=41002 master=true
Copy full snippet

[cluster_node] id=node_front addr=192.168.0.1 window=wnd_LT sound=true port_cs=41001 port_ss=41002 master=true

この例では、プライマリ以外のクラスタ ノードを示しています。

	[cluster_node] id=node_left addr=192.168.0.2 window=wnd_large sound=false
Copy full snippet

[cluster_node] id=node_left addr=192.168.0.2 window=wnd_large sound=false

パラメータ：

Window コンフィギュレーション

各 window コンフィギュレーションでは、Unreal Engine アプリケーションのインスタンスのメイン ウィンドウの一連のプロパティを定義します。このコンフィギュレーションを使用して、nDisplay がアプリケーションを起動したときのウィンドウの開始サイズや配置、ウィンドウをフルスクリーンで表示するかどうかなどを設定します。

また、1 つ以上の viewport コンフィギュレーションも指定します。このコンフィギュレーションでは、nDisplay でシーンのレンダリングを表示するメイン アプリケーション ウィンドウ内の特定の領域を識別します。

コンフィギュレーションの例：

この例では、単一のビューポートを含むアプリケーション ウィンドウを設定します。

	[window] id=wnd_one fullscreen=false WinX=0 WinY=0 ResX=640 ResY=480 viewports=vp_LT
Copy full snippet

[window] id=wnd_one fullscreen=false WinX=0 WinY=0 ResX=640 ResY=480 viewports=vp_LT

この例では、4 つの個別のビューポートを含むアプリケーション ウィンドウを設定します。

	[window] id=wnd_four fullscreen=false WinX=0 WinY=0 ResX=640 ResY=480 viewports="vp_LT,vp_RB,vp_LB,vp_RT"
Copy full snippet

[window] id=wnd_four fullscreen=false WinX=0 WinY=0 ResX=640 ResY=480 viewports="vp_LT,vp_RB,vp_LB,vp_RT"

パラメータ：

Viewport コンフィギュレーション

上記の各 window コンフィギュレーションでは、1 つ以上の viewport コンフィギュレーションを参照します。参照される各コンフィギュレーションでは、nDisplay がシーンのレンダリングされたビューを表示する必要のあるゲーム ウィンドウの長方形の領域を定義します。

通常、ビューポートはアプリケーション ウィンドウの左上隅から開始して、その幅と高さが親ウィンドウを埋めるように設定されます。ただし、場合によっては、親アプリケーション ウィンドウ内でビューポートのオフセットを調整する必要があります。例えば、一部が重なる 2 つのプロジェクターをセットアップする必要がある場合、または異なる位置で複数の個別のビューポートをホストする 1 つのアプリケーション ウィンドウが必要な場合は、オフセットを調整することをお勧めします。

nDisplay はビューポート レンダリング用に multi-GPU (mGPU) をサポートしているので、特定のビューポートをレンダリングするために 1 つの GPU デバイスを指定して、フレームを別の GPU にコピーして表示することができます。バーチャル プロダクションとインカメラ VFX の例では、インナー フラスタムは 2 つめの GPU で完全にレンダリングすることができるので、パフォーマンスとハードウェア使用量が改善します。NVLink を使うと NVIDIA GPU で、CPU を介さずに GPU から GPU へ直接メモリを転送することができます。NVLink を使わなければ、メモリ転送はピアツーピア (P2P) ではありますが、PCIe の CPU を経由しなければならないので遅くなります。

nDisplay Launcher または SwitchboardNDisplay を起動して mGPU を使用するときに、MaxGPUCount=2 をカスタム コマンドライン引数に追加します。

コンフィギュレーションの例：

	[viewport] id=vp_LT X=0 Y=0 width=300 height=220 projection=proj_simple_LT
Copy full snippet

[viewport] id=vp_LT X=0 Y=0 width=300 height=220 projection=proj_simple_LT

パラメータ：

通常、コンピュータにインストールおよび有効化された最初の GPU は 0 と呼ばれます。その他の GPU は 1、2、... 、n と数字が増えていきます。使用しているコンピュータの設定の OS 情報で GPU デバイス番号を確認することができます。Windows の場合、GPU デバイス番号は タスクマネージャー で確認できます。

1. タスクマネージャー を開きます。
2. [Performance (パフォーマンス)] タブに切り替えます。

3. ウィンドウの左側にはマシンに入っている GPU とデバイス番号が表示されます。

   

GPU が 1 つのコンピュータは、タスクマネージャで GPU は「GPU 0」というラベルが付きます。

Projection コンフィギュレーション

上記の各 viewport コンフィギュレーションは、ビューポートで描画の必要があるレンダリングされた画像を定義する projection コンフィギュレーションを参照します。

最も一般的な状況ではプロジェクション タイプ simple を使用します。これは、nDisplay コンフィギュレーション ファイルの他の場所の screen コンフィギュレーションのセクションで定義された視錐台を使用して、現在のカメラの位置から仮想ワールドをレンダリングするタイプです。

mpcdi、easyblend、vioso、domeprojection などの他の投影タイプでは、他の方法を使用してビューポート用のレンダリングされたコンテンツを定義します。また、画像を長方形のビューポートにレンダリングする前に追加の修正を行ったり、追加のレンダリング手法を適用したりすることもできます。例えば、投影では、カーブしたサーフェスで表示した場合に自然に見えるように、画像を押しつぶしたり、伸ばしたり、歪ませたりすることができます。

コンフィギュレーションの例：

次の例では、最も単純なユース ケースを示します。このユース ケースは、レンダリングされた画像を歪めたり修正したりすることなく、scr_LT という名前のスクリーン コンフィギュレーションで定義された視錐台をビューポートに直接ルーティングします。

	[projection] id=proj_simple_LT type=simple screen=scr_LT
Copy full snippet

[projection] id=proj_simple_LT type=simple screen=scr_LT

次の例では、プロジェクション タイプを使用して、スケーラブル ディスプレイのコンフィギュレーション ファイルで定義されたサーフェスにレンダリングする方法を示しています。

	[projection] id=proj_easyblend_1 type="easyblend" file="D:\eb_data\ScalableData.pol_1" origin=easyblend_origin_1 scale=0.1
Copy full snippet

[projection] id=proj_easyblend_1 type="easyblend" file="D:\eb_data\ScalableData.pol_1" origin=easyblend_origin_1 scale=0.1

次の例では、プロジェクション タイプmpcdi を使用して、MPCDI コンフィギュレーション ファイルで定義されたサーフェスにレンダリングする方法を示しています。

	[projection] id=proj_mpcdi_LT type="mpcdi" file="D:\rot90_flat.mpcdi" buffer="Mosaic" region="Monitor_R" origin=mpcdi_origin
Copy full snippet

[projection] id=proj_mpcdi_LT type="mpcdi" file="D:\rot90_flat.mpcdi" buffer="Mosaic" region="Monitor_R" origin=mpcdi_origin

次の例では、プロジェクションタイプ mpcdi を使用して、指定された .png ファイルで定義されたアルファ ブレンディング マップを使用して、指定された .pfm ジオメトリ ファイルで定義されたカーブしたサーフェスにレンダリングする方法を示しています。

	[projection] id=proj_mpcdi_LT type="mpcdi" pfm="D:\geom_displayLeft1.pfm" alpha="D:\Left1blend.png" alpha_gamma=2 origin=mpcdi_origin
Copy full snippet

[projection] id=proj_mpcdi_LT type="mpcdi" pfm="D:\geom_displayLeft1.pfm" alpha="D:\Left1blend.png" alpha_gamma=2 origin=mpcdi_origin

次の例では、 vioso 投影タイプを使用して、ネイティブ VIOSO ファイルで定義されたサーフェスにレンダリングする方法を示しています。

	[projection] id=proj_vioso_1 type="vioso" file="D:\left.vwf" origin=vioso_origin base="[1000 0 0 0] [0 1000 0 0] [0 0 1000 0] [0 0 1000 1]"
Copy full snippet

[projection] id=proj_vioso_1 type="vioso" file="D:\left.vwf" origin=vioso_origin base="[1000 0 0 0] [0 1000 0 0] [0 0 1000 0] [0 0 1000 1]"

次の例では、 domeprojection 投影タイプを使用して、 .xml キャリブレーション ファイルの DomeProjection で定義されたサーフェスにレンダリングする方法を示しています。

	[projection] id=proj_domeprojection_1 type=domeprojection file="D:\config.xml" origin=domeprojection_origin channel=0
Copy full snippet

[projection] id=proj_domeprojection_1 type=domeprojection file="D:\config.xml" origin=domeprojection_origin channel=0

パラメータ：

プロジェクションが type=simple の場合、さらに次のパラメータも受け入れます。

プロジェクションが type=easyblend の場合、さらに次のパラメータも受け入れます。

プロジェクションが type=mpcdi または type=picp_mpcdi の場合、さらに次のパラメータも受け入れます。

nDisplay では、現在、MPCDI バージョン 1.0、および 2D および A3D (すなわち Advanced 3D) のプロファイル タイプのみをサポートします。

type=vioso である投影では、さらに次のパラメータも受け入れます。

type=domeprojection である投影では、さらに次のパラメータも受け入れます。

プロジェクションが type=manual の場合は、nDisplay がレンダリングするための視点回転と錐台を定義するために、次のパラメータも受け入れます。マトリクスまたは角度のいずれかを使って錐台を設定することができます。

type=camera が他の追加パラメータを受け付けない場合のプロジェクション。実行時にプループリントまたは C++ API のいずれかを使用してプロジェクション ポリシーに対してカメラを設定します。

type=mesh と type=picp_mesh が他の追加パラメータを受け付けない場合のプロジェクション。実行時にプループリントまたは C++ API のいずれかを使用してプロジェクション ポリシーに対してスタティックメッシュ コンポーネントを設定します。

Screen コンフィギュレーション

プロジェクション タイプ simple 使用する各種出力ディスプレイは、3D VR 空間におけるサイズと配置が定義済みの長方形で定義される視錐台を使用して、現在のカメラ位置からシーンをレンダリングします。このような各長方形は、screen コンフィギュレーションで定義します。通常、これらの各プロジェクション スクリーンは、プロジェクション スクリーンのレンダリングに使用する物理スクリーンと同じ寸法を VR 空間に持ちます。

スクリーンのピボット ポイントは、常に正確な中間点にあります。

コンフィギュレーションの例：

この定義は、親のすぐ前にある 3m x 3m のスクリーンを表します。スクリーンのピボット ポイントは size パラメータで定義された長方形の中心にあるため、Z 軸で 1.5 m のオフセットを追加して、スクリーンをその高さの半分のみ上に移動します。

	[screen] id=screen_front loc="X=1.5.Y=0,Z=1.5" rot="P=0,Y=0,R=0" size="X=3,Y=3" parent=screens
Copy full snippet

[screen] id=screen_front loc="X=1.5.Y=0,Z=1.5" rot="P=0,Y=0,R=0" size="X=3,Y=3" parent=screens

ビューアの左側のスクリーンを定義するには、スクリーンを左に移動して (Y 軸の負の値)、ローカル Y 軸を中心に回転します (ヨー)。 

	[screen] id=screen_left loc="X=0,y=-1.5,Z=1.5" rot="P=0,Y=-90,R=0" size="X=3,Y=3" parent=screens
Copy full snippet

[screen] id=screen_left loc="X=0,y=-1.5,Z=1.5" rot="P=0,Y=-90,R=0" size="X=3,Y=3" parent=screens

パラメータ：

PostProcess コンフィギュレーション

postprocess コンフィギュレーションは、ウィンドウ に対して生成された画像をレンダリング前に Unreal Engine のインスタンスによってどのようにポストプロセスするかを定義します。 nDisplay は現在、 OutputRemap と TextureShare の 2 つのポストプロセス タイプをサポートしています。

OutputRemap を使用して、nDisplay によって生成された 2D イメージをアプリケーション ウィンドウの 2D 領域にマップする方法を制御できます。例えば、出力画像を部分的に平行移動、回転、スケールしてアプリケーション ウィンドウの異なる領域に表示させることができます。この操作を行うには、UV マッピング設定がされた平面ジオメトリを含む .obj が必要です。nDisplay は プレーンに対して設定した UV マッピングを使って、出力画像をどのようにアプリケーション ウィンドウの各部分に表示するのか決定します。

TextureShare を使用して、他のアプリケーションからテクスチャを受け取り、指定したビューポートにそれを表示することができます。この操作を行うためには、Texture Share アイテムの名前とそのテクスチャを表示するビューポートでポストプロセスを定義する必要があります。

コンフィギュレーションの例：

次の例は、 2 つの .obj ファイルを使って OutputRemap ポストプロセス タイプを使用する方法を示しています。

	[window] id=somewindow ... postprocess="pp_1, pp_2"
	[postprocess] id=pp_1 type="OutputRemap" file="remap_1.obj"
	[postprocess] id=pp_2 type="OutputRemap" file="remap_2.obj"
Copy full snippet

[window] id=somewindow ... postprocess="pp_1, pp_2" [postprocess] id=pp_1 type="OutputRemap" file="remap_1.obj" [postprocess] id=pp_2 type="OutputRemap" file="remap_2.obj"

次の例は、 TextureShare を使って vp_1 ビューポート用に出力されたフレームを外部アプリケーションと共有し、サードパーティ ソースからテクスチャを受け取り、それを vp_ext ビューポートに表示する例を示しています。

	[window] id=somewindow viewports="vp_1" fullscreen="false" 窶ｦ postprocess="pp_sharenode_ext"
	[viewport] id=vp_1 ... projection="proj_screen_1" share=true
	[viewport] id=vp_ext ... projection=""
	[postprocess] id=pp_sharednode_ext type="TextureShare" destination="vp_ext" source="thirdpartyapp_viewport_rendering"
Copy full snippet

[window] id=somewindow viewports="vp_1" fullscreen="false" 窶ｦ postprocess="pp_sharenode_ext" [viewport] id=vp_1 ... projection="proj_screen_1" share=true [viewport] id=vp_ext ... projection="" [postprocess] id=pp_sharednode_ext type="TextureShare" destination="vp_ext" source="thirdpartyapp_viewport_rendering"

パラメータ：

Camera コンフィギュレーション

nDisplay クラスタのすべてのインスタンスは、仮想ワールドの同じ位置からシーンをレンダリングします。この場合の使用する可能性のある視点は、camera コンフィギュレーション行でそれぞれ定義されます。

これらの視点は、実行時に切り替えることができます。トラッキング デバイスで各カメラの視点を制御することもできます。

コンフィギュレーションの例：

	[camera] id=camera_static loc="X=0.Y=0,Z=1.7" tracker_id=VRPNTracking tracker_ch=0
Copy full snippet

[camera] id=camera_static loc="X=0.Y=0,Z=1.7" tracker_id=VRPNTracking tracker_ch=0

パラメータ：

Scene Node コンフィギュレーション

コンフィギュレーション ファイルでは、シーン ノードの階層を定義できます。各シーン ノードは 3D 空間でのトランスフォームを表します。カメラ、投影スクリーンなど、3D 空間での位置および回転状態を必要とするコンフィギュレーション ファイルで設定した要素はすべて、このような scene_node コンフィギュレーションのいずれかを親として使用できます。これは、視覚化システムのすべての異なるコンポーネント間の空間的な関係を定義するうえで役立ちます。

Scene Node は、カメラと同じように、VR トラッキング デバイスでも制御できます。

コンフィギュレーションの例：

次の行では、2 つのノードの階層を定義しています。ここで、子ノードには親の前に 2 m のオフセットがあります。

	[scene_node] id=vr_space_root loc="X=0.Y=0,Z=0" rot="P=0,Y=0,R=0"
	[scene_node] id=walls_front_group loc="X=2.Y=0,Z=0" rot="P=0,Y=0,R=0" parent= vr_space_root
Copy full snippet

[scene_node] id=vr_space_root loc="X=0.Y=0,Z=0" rot="P=0,Y=0,R=0" [scene_node] id=walls_front_group loc="X=2.Y=0,Z=0" rot="P=0,Y=0,R=0" parent= vr_space_root

次の行では、VR トラッキング デバイスによって制御されるように設定されているシーン ノードを示しています。

	[scene_node] id=cave_wand loc="X=0, Y=0,Z=1" tracker_id=CaveTracking tracker_ch=1
Copy full snippet

[scene_node] id=cave_wand loc="X=0, Y=0,Z=1" tracker_id=CaveTracking tracker_ch=1

パラメータ：

Input コンフィギュレーション

nDisplay システムに入力を提供する必要のある各デバイスの input セクションを定義します。例えば、各 camera および各 scene_node は、必要に応じて、input セクションで設定し、camera または scene_node コンフィギュレーションで参照する VR トラッキング デバイスで制御できます。または、トラッカー、コントローラー、およびキーボードを設定して、汎用入力イベントを Unreal Engine 入力システムに送信したり、それらのイベントと入力値をプロジェクトのゲームプレイ スクリプトで応答できる汎用 nDisplay ブループリント ノードにバインドする必要がある場合があります。

input_setup セクションを使用して、これらの入力デバイスの特定のチャネル、ボタン、またはキーを、Unreal Engine 内の特定のタイプの入力イベントおよび値にバインドする方法を制御することもできます。

nDisplay 入力で実行できる内容の概要については、「Live Link VRPN」を参照してください。

コンフィギュレーションの例：

このコンフィギュレーションでは、nDisplay をセットアップして VRPN ロケーション トラッキング デバイスから入力を取得します。通常、このタイプのデバイスは、カメラまたは視聴者の頭部に取り付けるか、視聴者が保持します。camera または scene_node コンフィギュレーションでこの input コンフィギュレーションを参照することにより、トラッカーからカメラの位置またはシーン ノードの位置を自動的に制御できます。または、プロジェクトのブループリント コードでこのトラッカーの値を取得できます。

	[input] id=CaveTracking type=tracker [email protected] loc="X=-1.5,Y=0,Z=3.4" rot="P-0,Y=0,R=0" front=X right=Y up=-Z
Copy full snippet

[input] id=CaveTracking type=tracker addr=Tracker0@192.168.0.1 loc="X=-1.5,Y=0,Z=3.4" rot="P-0,Y=0,R=0" front=X right=Y up=-Z

パラメータ：

type=tracker のデバイスの場合、さらに次のパラメータも受け入れます。

デバイスが type=keyboard の場合、さらに次のパラメータも受け入れます。

Input Setup コンフィギュレーション

各 input_setup コンフィギュレーション セクションでは、指定された input デバイスの追加のコンフィギュレーション パラメータを指定します。この追加パラメータでは、通常、指定されたデバイスのチャネルまたはキーを汎用 nDisplay ブループリント入力ノードにバインドします。

コンフィギュレーションの例：

このコンフィギュレーションでは、チャネル 0 でイベントを生成するボタンが押されると、ブループリントの [Input (入力)] > [N Display Events (N ディスプレイ イベント)] > nDisplay Button 0 ノードからイベントが生成されるように ID コントローラーで入力デバイスをセットアップします。

	[input_setup] id=controller ch=0 bind="nDisplay Button 0"
Copy full snippet

[input_setup] id=controller ch=0 bind="nDisplay Button 0"

次のコンフィギュレーションは上記と似ています。ただし、アナログ値 (通常はコントローラーの軸) を nDisplay のアナログ値にバインドする点が異なります。ブループリントの [Input (入力)] >[N Display Events (N ディスプレイ イベント)] > nDisplay Analog 0 ノードを使用して、コントローラーの軸が使用されている場合を検出したり、[Input (入力)] >[N Display Values (N Display 値)] > nDisplay Analog 0 を使用して現在のフレームの値を取得することができます。

	[input_setup] id=test_axes ch=0 bind="nDisplay Analog 0"
Copy full snippet

[input_setup] id=test_axes ch=0 bind="nDisplay Analog 0"

パラメータ：

一般的なコンフィギュレーション

general コンフィギュレーション行には、nDisplay クラスタの全体的な動作を制御するパラメータが含まれています。

コンフィギュレーションの例：

	[general] swap_sync_policy=1
Copy full snippet

[general] swap_sync_policy=1

パラメータ：

NVIDIA コンフィギュレーション

general コンフィギュレーション レクションにおいて swap_sync_policy の値を 2 にすると、NVIDIA セクションのパラメータを使ってフレーム ロックに関連する特定のハードウェ設定の調整が可能になります。

Network コンフィギュレーション

network コンフィギュレーション セクションでは、nDisplay クラスタ ノード間のネットワーク通信に関連するタイムアウトおよびその他の設定を制御するために使用できる設定を指定します。

nDisplay コンフィギュレーション ファイルには、network セクションを含めないか、または 1 つのみ含めることができます。

コンフィギュレーションの例：

	[network] cln_conn_tries_amount=10 cln_conn_retry_delay=1000 game_start_timeout=30000 barrier_wait_timeout=5000
Copy full snippet

[network] cln_conn_tries_amount=10 cln_conn_retry_delay=1000 game_start_timeout=30000 barrier_wait_timeout=5000

パラメータ：

cln_conn_tries_amount 設定および cln_conn_retry_delay 設定は連携して、クラスタ ノードが起動時にプライマリ ノードへの接続を試行する最長時間を指定します。例えば、cln_conn_tries_amount が「10」に設定され、cln_conn_retry_delay が「1000」ミリ秒に設定されているとします。起動時に各ノードはプライマリ PC への接続を個々みます。その接続が失敗した場合、再試行するまで 1000 ミリ秒待機します。その試行も失敗した場合、さらに 1000 ミリ秒待機します。10 回連続で失敗すると、クラスタ ノードは自動的に終了します。クラスタ ノードがプライマリ PC に接続するとすぐに、回数のカウントが停止します。

Info コンフィギュレーション

info コンフィギュレーション行には具体的に、コンフィギュレーション ファイルと互換性があることが判明している nDisplay と Unreal Engine の最新バージョンに関するオプションの情報が含まれています。

コンフィギュレーションの例：

	[info] version=22
Copy full snippet

[info] version=22

パラメータ：

カスタム コンフィギュレーション パラメータ

custom コンフィギュレーション セクションを含めて、独自にカスタムしたキー / 値のペアを nDisplay クラスター ノードに与えることができます。好きな数だけパラメータと値を [cluster] 行に含めることができます。後でこれらの設定値を実行時に nDisplay ブループリントまたは C++ API から取得することができます。

コンフィギュレーションの例：

	[custom] stringParameter=myValue numberParameter=2
Copy full snippet

[custom] stringParameter=myValue numberParameter=2

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

具体的な例を確認するには、「wall_flat_3x2.cfg」サンプル ファイルを開いてください。このサンプル ファイルは「Templates/TP_nDisplayBP/Content/ExampleConfigs」の下にある Unreal Engine のインストール フォルダにあります。このファイルでは 6 つの投影スクリーンを定義します。各投影スクリーンは、個別の物理コンピュータによってレンダリングされます。

また、このファイルでは複数の scene_node を定義しています。これらは連携して、次の階層を作成します。

この階層のノードの相対的な位置と回転状態では、6 つの投影スクリーンがカメラから 1 メートルの距離で隣り合って並ぶように、VR 空間でのカメラと 6 つのスクリーンの配置がレイアウトされます。 

なお、このコンフィギュレーションでは、シーンをレンダリングするモニターの端部を考慮して、隣接する各投影スクリーンの間に小さなスペースが含まれます。