언리얼 엔진의 nDisplay 환경설정 파일 레퍼런스 | 언리얼 엔진 5.2 문서

언리얼 엔진 4.27부터 .cfg 및 .ndisplay 환경설정 파일을 모두 프로젝트의 콘텐츠 브라우저(Content Browser) 로 임포트할 수 있으며, 이는 새 .uasset 포맷으로 변환됩니다.

.ndisplay 환경설정 파일을 익스포트하고 사용하여 클러스터를 실행할 수 있습니다. .ndisplay 파일에는 nDisplay 환경설정 에셋(nDisplay Config Asset) 에서만 환경설정될 수 있는 트래킹 및 기타 기능이 없습니다.

nDisplay 클러스터 환경설정에는 nDisplay 3D 환경설정 에디터를 사용할 것을 권장합니다.

nDisplay 시스템의 대부분은 하나의 환경설정 파일에 정의합니다. 이 파일에는 네트워크를 이루는 컴퓨터, 각 컴퓨터에서 언리얼 엔진이 렌더링할 창과 뷰포트의 특징, 각 뷰포트가 렌더링할 가상 월드 부분, 받으려는 입력 디바이스 타입 등이 포함됩니다.

이 문서에서는 nDisplay 환경설정 파일에 있는 모든 세팅에 대해 설명합니다.

nDisplay 환경설정 파일을 이해하고 직접 만들어보기 가장 좋은 방법은 nDisplay 플러그인에 제공된 예시 환경설정으로 시작하는 것입니다. nDisplay 템플릿에서 프로젝트를 만든 경우 Content/ExampleConfigs 폴더에서 찾을 수 있습니다. 아니라면 언리얼 엔진 설치 폴더 아래 Templates/TP_nDisplayBP/Content/ExampleConfigs 에서 찾을 수 있습니다.

nDisplay 환경설정 파일의 구조는 시각화 렌더링에 사용되는 여러 컴포넌트 타입에 직접 묶여 있습니다.

환경설정하는 각기 다른 컴포넌트 타입마다 파일에 고유의 줄이 있으며, 할당하는 문자열 ID 로 식별합니다. 한 환경설정 섹션이 다른 섹션을 레퍼런스해야 할 때 이 문자열 ID 를 사용합니다.
이 파일에 환경설정하는 컴포넌트 다수에는 가상 3D 공간의 위치가 (종종 회전도) 정의되어 있습니다. 각 오브젝트의 위치와 회전은 그 오브젝트의 부모 에 상대적입니다. 기본적으로 모든 오브젝트의 부모는 VR 공간 원점으로, VR 공간의 시작으로 간주되는 3D 월드 공간 내 임의의 포인트입니다. 3D 공간에 하나 이상의 컴포넌트에 대한 부모 역할을 할 수 있는 scene_nodes라는 특정 이름의 트랜스폼을 구성할 수 있습니다. 이는 화면, 카메라, 기타 컴포넌트의 공간 레이아웃을 단순화하는 데 도움이 됩니다. scene_nodes를 사용하여 가상 공간의 동일 포인트에서 한꺼번에 시작되는 3D 트랜스폼 계층구조를 빌드하려면, 아래 환경설정 파일 씬 계층구조 예시 섹션을 참고하세요.
가상 3D 공간이나 현실 물리적 공간을 측정하는 모든 파라미터 단위 기대값은 별도로 지정하지 않은 경우 미터 또는 도입니다. 여기에는 화면, 씬 노드, 카메라 등이 포함됩니다.
화면 공간을 측정하는 모든 파라미터 기대값은 픽셀 단위입니다. 여기에는 창과 뷰포트가 포함됩니다.

클러스터 노드 환경설정

nDisplay 네트워크에서 사용할 언리얼 엔진 애플리케이션의 각 인스턴스에 대해 cluster_node 환경설정을 정의해야 합니다. 각 cluster_node 환경설정에는 메인 애플리케이션 창의 프로퍼티를 정의하는 창 환경설정 섹션에 대한 레퍼런스가 있어야 합니다.

cluster_node 환경설정은 애플리케이션 인스턴스를 실행하는 컴퓨터의 호스트 이름 또는 IP 주소를 정의하기도 합니다. 각 cluster_node 환경설정에 대해 각기 다른 물리적 컴퓨터를 구성해도 되고, 같은 호스트에 실행되는 cluster_node 환경설정이 여러 개여도 됩니다.

환경설정 예시:

이 예시는(네트워크당 하나의) 프라이머리 노드를 환경설정합니다.

	[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

파라미터:

파라미터	필수 여부	디폴트	설명
id	필수		이 클러스터 노드 환경설정의 고유한 이름입니다.
addr	필수		이 언리얼 엔진 인스턴스를 실행할 컴퓨터의 IP 주소입니다. IPv4 주소여야 합니다. IPv6는 지원하지 않습니다.
window	필수		언리얼 엔진 애플리케이션이 인스턴스에 대한 메인 창의 크기와 위치를 정의하는 창 환경설정 이름입니다.
sound	선택 사항	`false`	이 언리얼 엔진 인스턴스의 사운드 재생 여부입니다. 선택 사항이며 디폴트 값은 `false` 입니다.
port_cs	선택 사항	`14001`	프라이머리 노드가 클러스터 동기화를 위해 클러스터 내 다른 노드와 교신할 때 사용하는 포트입니다. port_ss 는 스왑 동기화용, port_ce 는 클러스터 이벤트용입니다. 선택 사항이며 디폴트 값은 `14001`, `14002`, `14003` 입니다.
port_ss	선택 사항	`14002`	프라이머리 노드가 스왑 동기화를 위해 클러스터 내 다른 노드와 교신할 때 사용하는 포트입니다.
port_ce	선택 사항	`14003`	프라이머리 노드가 클러스터 이벤트용으로 클러스터 내 다른 노드와 교신할 때 사용하는 포트입니다.
master	선택 사항	`false`	이 언리얼 엔진 인스턴스가 클러스터의 프라이머리 노드인지 여부입니다. 하나의 cluster_node 섹션만 이 파라미터를 `true` 로 설정할 수 있습니다.
gpu	선택 사항		이 언리얼 인스턴스가 렌더링에 사용해야 하는 GPU의 인덱스입니다. 이런 방식으로 GPU 인스턴스를 설정하는 것은 `r.GraphicsAdapter` 콘솔 변수를 이용하는 방법과 동일합니다.

창 환경설정

각 창 환경설정은 언리얼 엔진 애플리케이션 인스턴스의 기본 창에 대한 프로퍼티 세트를 정의합니다. nDisplay가 애플리케이션을 시작할 때 창의 시작 크기와 배치, 그리고 창이 전체 화면을 차지할지 여부와 같은 것을 환경설정하는 데 사용합니다.

또한 nDisplay가 씬의 렌더링으로 채울 메인 프로그램 창의 특정 영역을 식별하는 하나 이상의 뷰포트 환경설정을 제공합니다.

환경설정 예시:

이 예시에서는 단일 뷰포트가 포함된 애플리케이션 창을 환경설정합니다.

	[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"

파라미터:

파라미터	필수 여부	디폴트	설명
id	필수		이 뷰포트 환경설정의 고유 이름입니다.
fullscreen	선택 사항	`false`	이 창을 전체화면 모드로 실행할지 여부를 결정합니다. 이 값을 `false` 로 설정하면, 아래의 WinX, WinY, ResX, RexY 세팅을 제공해야 합니다.
WinX	선택 사항	`0`	데스크톱의 애플리케이션 창 왼쪽 상단 구석 X 위치를 화면 좌측 끝에서부터 스크린 스페이스 픽셀 단위로 지정합니다.
WinY	선택 사항	`0`	데스크톱의 애플리케이션 창 왼쪽 상단 구석 Y 위치를 화면 상단 끝에서부터 스크린 스페이스 픽셀 단위로 지정합니다.
ResX	필수	`0`	애플리케이션 창의 가로 크기를 스크린 스페이스 픽셀 단위로 지정합니다. 전체화면 이 `false` 로 설정된 경우, 이 값이 필요합니다. 전체화면 이 `true` 로 설정된 경우, 이 값은 무시됩니다.
ResY	필수	`0`	애플리케이션 창의 세로 크기를 스크린 스페이스 픽셀 단위로 지정합니다. 전체화면 이 `false` 로 설정된 경우입니다. 전체화면 이 `true` 로 설정된 경우, 이 값은 무시됩니다.
viewports	필수		nDisplay가 씬의 렌더링된 뷰를 채우는 메인 애플리케이션 창의 영역을 정의하는 하나 이상의 뷰포트 환경설정 섹션을 참고하세요. 뷰포트를 하나 이상 지정하는 경우, 따옴표로 묶고 쉼표로 구분된 뷰포트 환경설정 섹션 이름 목록을 사용해야 합니다. 위의 환경설정 예시 섹션에서 `wnd_four` 예시를 참고하세요. 목록의 순서는 시각적 순서 또는 뷰포트 배치에 영향을 주지 않습니다. 부모 창의 뷰포트 배치는 명명된 뷰포트 환경설정에서 정의됩니다. 사용하는 뷰포트 정의가 창의 크기를 초과하지 않는지 확인하세요.
postprocess	선택 사항		nDisplay가 최종 이미지를 창에 렌더링하기 전에 최종 생성 출력 이미지에 적용할 포스트 프로세싱 작업을 정의하는 하나 이상의 포스트 프로세스 환경설정 ID를 지정합니다. 선택 사항입니다. 최종 이미지를 렌더링하기 전에 변환할 필요가 있을 때만 이 파라미터를 사용하세요. 여러 포스트프로세스 환경설정을 제공하는 경우, nDisplay는 순서대로 변환을 적용합니다.