이 페이지에서는 데이터스미스(Datasmith)가 Autodesk Revit 씬을 언리얼 에디터로 임포트하는 방법에 대해 설명합니다. 이 설명은 데이터스미스 개요 및 데이터스미스 임포트 프로세스 소개에 나와 있는 기본적인 프로세스를 따르지만, Revit에 한정되는 특수한 변환 동작이 일부 추가됩니다. 데이터스미스를 사용하여 Revit 씬을 언리얼 에디터로 임포트하려는 경우, 이 페이지는 씬이 변환되는 방식과 언리얼 에디터에서 해당 결과물을 사용하여 작업하는 방법을 이해하는 데 도움이 될 수 있습니다.


Revit 워크플로
데이터스미스는 Revit용 익스포트 플러그인 워크플로를 사용합니다. 데이터스미스를 사용하여 Revit 콘텐츠를 언리얼 엔진으로 가져오려면 다음 단계를 따릅니다.
-
Revit용 플러그인을 설치합니다. 자세한 내용은 아래의 설치 노트 를 참고하세요.
-
Revit 콘텐츠를
*.udatasmith*
파일로 익스포트합니다. 자세한 내용은 Revit 에서 데이터스미스 콘텐츠 익스포트 페이지를 참고하세요. 그 대신 일괄적으로 익스포트할 수도 있습니다. -
아직 활성화되지 않은 경우, 프로젝트에 대해 임포터(Importers) > 데이터스미스 임포터(Datasmith Importer) 플러그인을 활성화합니다.
-
언리얼 에디터 툴바에 있는 데이터스미스 임포터를 사용하여 .udatasmith 파일을 임포트합니다. 자세한 내용은 페이지를 참고하세요.
설치 노트
데이터스미스 익스포트 플러그인 페이지에서 Revit용 데이터스미스 익스포터(Datasmith Exporter for Revit) 플러그인을 다운로드하여 설치해야 Revit 콘텐츠를 익스포트할 수 있습니다.
플러그인이 지원하는 Revit 버전을 확인하려면 데이터스미스 지원 소프트웨어 및 파일 타입 페이지를 참고하세요.
데이터스미스 익스포트 플러그인 다운로드 링크는 조직 내외부에 제한 없이 공유할 수 있습니다. 하지만 데이터스미스 익스포트 플러그인 자체를 배포하는 것은 허용되지 않습니다.
Revit 플러그인용 데이터스미스 익스포터를 설치하기 전에 다음 사항을 확인합니다.
-
Revit이 실행 중이 아니어야 합니다.
-
사용하려는 언리얼 엔진 버전에 맞는 익스포터 플러그인용 인스톨러를 다운로드해야 합니다.
-
Revit 플러그인용 데이터스미스 익스포터의 이전 버전을 먼저 모두 삭제해야 합니다.
인스톨러를 다운로드한 후 더블클릭하여 연 다음에 화면의 지시 사항을 따릅니다.
익스포터 플러그인을 설치한 후 Revit을 실행하면 "이 애드인의 퍼블리셔를 검증할 수 없습니다. 어떻게 할까요?"라는 메시지가 표시될 수 있습니다. 이 경우, 항상 로드(Always Load) 를 클릭하여 Revit을 실행할 때마다 데이터스미스 익스포터 플러그인을 사용하도록 합니다.
Revit 플러그인용 데이터스미스 익스포터를 제거해야 하는 경우 기타 Windows 애플리케이션과 같이 제어판(Control Panel) 에서 제거 작업을 수행할 수 있습니다.
익스포트되는 항목 제어
데이터스미스 익스포터 플러그인을 사용하여 씬을 익스포트하려면 항상 Revit에서 3D 뷰를 선택하고 활성 상태여야 합니다. 그 3D 뷰의 가시성 설정이 Revit의 어떤 요소를 익스포트되는 .udatasmith 파일에 포함시킬지 결정합니다. 이 동작을 활용하면 Revit에서 언리얼 엔진으로 익스포트할 콘텐츠를 완전히 제어할 수 있습니다.
Revit 파일에 이미 있는 3D 뷰를 사용할 수 있습니다. 그러나 언리얼 엔진으로 가져올 오브젝트를 완전히 제어하려면, Revit에서 3D View 를 새로 구성하고, 리얼타임 시각화에 필요한 오브젝트만 표시되도록 뷰를 구성합니다.
Revit은 3D View 안에서 오브젝트 가시성 제어를 위한 툴과 기법을 다수 제공합니다. 예:
- Graphics > Visibility/Graphics Overrides 로 레벨의 다양한 오브젝트 및 오브젝트 카테고리 가시성을 제어할 수 있습니다.
- Section Box로 익스포트할 지오메트리를 잘라낼 수 있습니다. 섹션 박스 안의 오브젝트만 언리얼 엔진으로 익스포트됩니다. 참고로 섹션 박스 경계에 걸치는 오브젝트는, 아래 이미지에서 벽, 바닥, 가구 같은 경우 지오메트리가 잘립니다. 언리얼 엔진 안에서 익스포트된 오브젝트를 표현하는 스태틱 메시 에셋은 Section Box 안의 부분만 남습니다.
- Revit의 Temporary Hide and Isolate (임시 숨김 및 고립) 설정이 유지됩니다.
- 현재 3D View 에 보이는 지오메트리 오브젝트만 익스포트됩니다. 지오메트리가 아닌 오브젝트는 무시합니다.
데이터스미스 익스포터는 오브젝트 표시 숨김 선택 사항을 따르지만, Revit 뷰포트에 3D View 를 그리는 방식을 제어하는 다른 세팅은 고려하지 않습니다. 예를 들어 3D View 에 설정된 Graphics > Graphic Display Options (Realistic vs. Shaded Model Display, Cast Shadows 등) 또는 Camera > Rendering Settings (Draft vs. High Quality settings, Lighting schemes, 등)은 고려하지 않습니다.
Revit 3D View 의 가시성 제어에 대한 자세한 내용은 Visibility and Graphic Display in Project Views Revit 도움말 페이지를 참고하세요.
지오메트리
일반적으로 Revit 씬에서 개별적으로 선택할 수 있는 각 요소는 언리얼에 별도의 스태틱 메시 에셋으로 변환됩니다. 일부 요소는 난간처럼 더 작은 부분으로 이루어진 경우 더 작은 스태틱 메시로 나뉠 수도 있습니다.
모든 경우, 각 스태틱 메시 에셋의 지오메트리는 파일 익스포트 당시 Revit 오브젝트 치수에 일치하도록 설정됩니다. 파라미터 세팅 및 컨스트레인트는 언리얼 엔진으로 가져오지 않습니다. 즉 예를 들어 언리얼 에디터에서 바닥을 위 아래로 이동한 경우, Revit에서는 새 위치에 맞도록 벽의 높이가 늘고 줄지만, 여기서는 그렇지 않습니다.
인스턴싱
같은 군에 속하는 오브젝트가 둘 있고, 파라미터 값이 똑같은 경우, 두 오브젝트 모두 데이터스미스 씬에서 같은 스태틱 메시 에셋의 인스턴스로 표현됩니다.
테셀레이션
데이터스미스는 Revit의 내장 테셀레이션 서비스를 사용하여 씬 지오메트리의 트라이앵글 메시를 생성합니다. 대부분의 경우 언리얼 엔진에서 사용하기에 적합한 지오메트리가 생성됩니다. 하지만 프로젝트에서 이 표면에 문제가 있는 경우, 언리얼 에디터에서 제공되는 메시 복잡도 감소 툴, 예를 들어 프록시 지오메트리 툴 같은 것을 사용할 수 있습니다.
연결된 모델
Revit 씬에 연결된 모델, 즉 다른 Revit 파일에 대한 레퍼런스가 있는 경우 데이터스미스는 Revit 파일에 저장된 경로를 사용하여 컴퓨터에서 연결된 파일을 찾으려고 시도합니다. 데이터스미스는 언리얼 엔진에서 생성한 데이터스미스 씬에서 찾을 수 있는 모든 연결된 파일의 데이터를 포함합니다.
머티리얼 및 텍스처
Revit 씬의 각기 다른 유형의 표면에 대해 데이터스미스는 언리얼 엔진 프로젝트에 새 머티리얼 에셋을 생성하고, 데이터스미스 씬 에셋 옆에 있는 Materials 폴더에 저장합니다. 이 머티리얼의 목적은 Revit의 표면 모습 구성 방식을 따르는 동시에, Revit에서 사용하던 것과 거의 비슷한 프로퍼티 세트를 노출시키는 것입니다.
Revit | 언리얼 |
데이터스미스는 현재 Revit의 디퓨즈 맵과 컬러, 투명도, 컷아웃, 범프 세팅을 언리얼 엔진 머티리얼로 변환하는 것을 지원합니다.
언리얼 에디터에서 머티리얼을 수정하려면:
- 콘텐츠 브라우저 에서 더블클릭합니다. 또는 수정하려는 머티리얼을 사용하는 레벨의 액터를 선택한 다음, 디테일 패널에서 머티리얼을 더블클릭합니다.
- 위에 표시된 머티리얼 에디터를 열면 디테일 패널 상단의 Parameter Groups 섹션에서 이 파라미터를 수정할 수 있습니다. 언리얼 렌더러에 노출된 다른 내장 파라미터를 수정할 수도 있습니다.
- 프로퍼티의 디폴트 값을 덮어쓰려면, 먼저 머티리얼의 프로퍼티 이름 왼쪽 박스를 체크하여 활성화합니다. 그런 다음 프로퍼티에 사용하려는 값을 설정합니다.
이 에셋 각각은 머티리얼 인스턴스이며, 그 부모는 데이터스미스 플러그인에 내장된 RevitMaster 머티리얼입니다. 이 부모 머티리얼을 열면 머티리얼 인스턴스에 노출된 프로퍼티 각각이 머티리얼 그래프에 어떻게 연결되어 있는지 확인할 수 있습니다.
텍스처 및 UV 래핑
데이터스미스는 Revit Material 에 사용된 텍스처를 에셋으로 임포트하고, 데이터스미스 씬 에셋 옆 Textures 폴더에 저장합니다.
텍스처 에셋을 사용하는 각 머티리얼 에셋에는 Revit Texture Editor 와 비슷한 컨트롤이 제공되므로, 머티리얼을 사용하는 3D 오브젝트 표면에 적용된 텍스처 매핑 방식을 제어할 수 있습니다.

- Revit의 Position > Offset 값은 각 맵 유형에 대한 UVOffsetX 및 UVOffsetY 세팅으로 모델링됩니다.
- Revit의 Position > Rotation 값은 각 맵 유형에 대한 UVWAngle 세팅으로 모델링됩니다.
- Revit의 Scale 값은 실제 치수 기반이며, 언리얼 엔진 머티리얼에서 스케일 배율로 변환됩니다. 이 스케일의 절대값을 높이면, 오브젝트의 텍스처가 작아집니다.
데이터스미스는 체크무늬, 노이즈, 타일 등과 같은 절차적 텍스처를 변환하지 않습니다.
데이터스미스 씬 계층구조 생성
데이터스미스 익스포터 플러그인은 Revit의 씬 전체 계층구조를 반영하기 위한 의도로 데이터스미스 씬에 부모 자손 액터 계층구조를 생성합니다. Revit에서와 똑같은 개념으로 언리얼 엔진 레벨의 액터 체계를 정리하여 오브젝트 검색과 조작을 쉽게 하기 위한 것입니다.
이 씬 계층구조를 생성하는 규칙은 다음과 같습니다.
-
Revit의 각 Level(레벨), 예로 Ground Floor, Level 1, Level 2 등은 데이터스미스 씬 계층구조에 별도의 액터로 반영됩니다.
-
각 레벨 안에서 Revit의 다른 씬 엘리먼트의 호스트 가 되는 오브젝트는 그 오브젝트의 부모가 됩니다.
-
Revit 레벨 및 호스트를 나타내는 부모 액터 아래, 각 지오메트리 오브젝트를 나타내는 스태틱 메시 액터를 찾을 수 있습니다.
예를 들어 Level 1 이라는 액터에는 각 벽을 나타내는 액터가 들어 있습니다. 이 액터 각각은 차례로 벽이 호스트인 각 지오메트리 오브젝트 (즉 각 문, 창문, 또는 벽 섹션)에 대해 자손이 있는 다른 부모 액터로 나타납니다.
-
커튼 벽이나 레일 등 대부분의 '복합' Revit 오브젝트에서 씬 계층구조는 오직 하나의 액터만 포함하여 복합 오브젝트를 나타냅니다. 액터에는 복합 엘리먼트를 구성하는 서브 오브젝트에 대한 스태틱 메시 컴포넌트가 포함되어 있습니다.
예를 들어 Revit의 커튼 벽은 보통 언리얼 엔진에 단일 액터로 들어옵니다. 해당 액터는 커튼 벽을 구성하는 각 문설주 및 패널마다 별도의 스태틱 메시 컴포넌트를 갖습니다.
라이트
데이터스미스가 Revit 씬의 라이트를 언리얼 엔진으로 임포트할 때, 강도에 설정한 물리적 단위를 유지합니다.
카메라
Revit 3D View 를 임포트할 때, 데이터스미스는 언리얼 에디터 레벨에 CineCameraActor 를 하나 만듭니다. Revit 3D View 의 카메라 위치와 방향으로 이 카메라를 배치하여 비슷한 시야를 유지합니다. 레벨 뷰포트 또는 월드 아웃라이너 에서 이 CineCameraActor 를 선택하면, 그 시점의 프리뷰가 .udatasmith 파일 익스포트 당시 Revit 3D View 의 Crop Region 과 매우 비슷한 것을 확인할 수 있습니다.
데이터스미스는 직교 투영 모드, 기울임(tilt), 이동(shift), 크롭 영역(Crop Region)같은 원근 보정을 포함하여 Revit에서 사용할 수 있는 일부 카메라 개념을 처리하지 못합니다.
최상의 결과를 얻으려면:
- 3D View 의 Camera > Projection Mode 세팅을 Perspective 로 설정합니다.
- Revit 3D View 의 Crop Region 이 언리얼 엔진에서 잡으려는 카메라 뷰에 집중되도록 설정합니다.
- Revit의 카메라 대상 지점 중심이 크롭 영역 안에 있는지 확인합니다. 카메라를 다른 평면도와 입면도 모드로 확인할 수 있습니다. 원근 뷰를 이동한 경우, 언리얼 엔진의 결과가 예상대로 표시되지 않을 수 있습니다.
예를 들어 아래 3D View 는 원근 카메라 중심이 크롭 영역에 있어, 변환이 잘 됩니다.
그러나 다음 3D View 는 크롭 영역을 수동 조정해서 원근 영역의 한 쪽 모서리가 대상 지점 쪽으로 균등하지 않게 이동했습니다. 그러면 잘 변환되지 않습니다.
카테고리
씬의 오브젝트가 최소 하나는 들어 있는 Revit Category (카테고리) 각각은 언리얼 에디터에 별도의 레이어로 가져옵니다.

언리얼 에디터에서 이 레이어를 사용하여 카테고리를 표시하고 숨기거나, 할당된 오브젝트를 조사하고 선택할 수 있습니다.
참고로 Revit SDK 가 익스포터에 제공하는 정보가 항상 모든 씬 오브젝트를 카테고리에 연결해 주지는 않습니다. Revit에서 할당된 카테고리가 없는 오브젝트는 언리얼 에디터에서 어떤 레이어에도 할당되지 않습니다.
메타데이터
데이터스미스는 Revit 오브젝트 관련 메타데이터를 임포트하고, 그 메타데이터를 언리얼 엔진 내 각 Revit 오브젝트를 나타내는 액터에 붙입니다.
언리얼 엔진에서 만드는 런타임 환경에서 사용하려는 대부분의 메타데이터는 데이터스미스 메타데이터로 임포트됩니다. 여기에는 Revit에서 각 오브젝트에 설정한 인스턴스 프로퍼티와 비어 있지 않은 유형 프로퍼티가 포함됩니다. 임포트되는 프로퍼티 유형과 에디터 에셋 준비 스크립트 및 런타임 게임플레이 스크립트에서 액세스하는 방법 관련 자세한 내용은, Using Datasmith Metadata 페이지를 참고하세요.
일부 다른 더 기술적인 내부 정보는 컴포넌트 태그를 사용해서 각 액터에 붙입니다. 특히 언리얼 에디터에서 데이터 준비를 자동화하기 위해 블루프린트나 Python 스크립트를 사용하는 경우, 이 정보를 액터 식별에 유용하게 사용할 수 있습니다.
- Revit.Instance.Depth. - Revit 씬 계층구조에서 오브젝트의 패밀리 인스턴스 또는 패밀리 심볼의 깊이입니다.
- Revit.Instance.Id. - Revit 문서에서 오브젝트의 패밀리 인스턴스 또는 패밀리 심볼의 ID 입니다.
- Revit.Host.Id. - 오브젝트의 패밀리 인스턴스가 호스트일 때, 이 값이 Revit 문서의 패밀리 인스턴스 호스트 ID 가 됩니다.

RPC 오브젝트
데이터스미스는 RPC(Rich Photorealistic Content) 오브젝트를 Revit 씬에서 언리얼 엔진으로 가져옵니다. Revit 씬의 RPC 오브젝트 유형마다 데이터스미스는 Revit에서 볼 수 있는 지오메트리를 새 스태틱 메시 에셋으로 임포트합니다. Revit 씬에 배치한 RPC 오브젝트 유형마다 데이터스미스는 언리얼 엔진 레벨에서 3D 스페이스의 동일한 위치 및 오리엔테이션에 새 스태틱 메시 액터를 생성합니다.

언리얼 엔진 레벨에서 이 RPC 오브젝트는 Revit.RPC 컴포넌트 태그가 할당된 액터를 찾으면 됩니다.

이는 Revit에서 사용된 자리표시자 안투라지 오브젝트를 3D 리얼타임 시각화에 보다 적합한 항목으로 대체하는 방식을 자동화하는 데 유용합니다.
이 페이지에 사용된 모든 씬과 모델은 Turbosquid에서 제공해 주셨습니다.
측량 기준점과 프로젝트 기준점
Revit 씬에 측량 기준점과 프로젝트 기준점이 있는 경우, 데이터스미스는 이러한 기준점을 언리얼 엔진 레벨로 임포트하고 보이지 않는 지오메트리를 포함하는 플레인 액터로 이를 나타냅니다. 이는 해당 액터에 대한 데이터스미스의 측량 기준점과 프로젝트 기준점 데이터를 다음과 같이 기록합니다.
![]() |
![]() |
---|---|
프로젝트 기준점 | 측량 기준점 |
자세한 내용은 위의 메타데이터 및 데이터스미스 메타데이터 사용법을 참고하세요.