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


Revit 워크플로
데이터스미스는 Revit용 익스포트 플러그인 워크플로를 사용합니다. 데이터스미스를 사용하여 Revit 콘텐츠를 언리얼 엔진으로 가져오려면 다음 단계를 따릅니다.
-
Revit용 플러그인을 설치합니다. 자세한 내용은 아래의 설치 노트 를 참고하세요.
-
Revit 콘텐츠를
*.udatasmith
파일로 익스포트합니다. Revit에서 데이터스미스 콘텐츠 익스포트 페이지를 참고하세요. 또는 Dynamo를 사용하여 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 파일에 이미 있는 3D 뷰를 사용할 수 있습니다. 그러나 언리얼 엔진으로 가져올 오브젝트를 전체적으로 제어하려면, Revit에서 3D View 를 새로 구성하고, 리얼타임 시각화에 필요한 오브젝트만 표시되도록 뷰를 구성합니다.
Revit은 3D View 안에서 오브젝트 가시성 제어를 위한 툴과 기법을 다수 제공합니다. 예를 들면 다음과 같습니다.
- Graphics > Visibility/Graphics Overrides 로 레벨의 다양한 오브젝트 및 오브젝트 카테고리 가시성을 제어할 수 있습니다.
- 섹션 박스로 익스포트할 지오메트리를 잘라낼 수 있습니다. 섹션 박스 안의 오브젝트만 언리얼 엔진으로 익스포트됩니다. 참고로 섹션 박스 경계에 걸치는 오브젝트는, 아래 이미지에서 벽, 바닥, 가구 같은 경우 지오메트리가 잘립니다. 언리얼 엔진 안에서 익스포트된 오브젝트를 표현하는 스태틱 메시 에셋은 섹션 박스 안의 지오메트리만 포함합니다.
- Revit의 Temporary Hide and Isolate 세팅이 유지됩니다.
- 현재 3D View 에 보이는 지오메트리 오브젝트만 익스포트됩니다. 지오메트리가 아닌 오브젝트는 무시합니다.
데이터스미스 익스포터는 오브젝트 표시 숨김 선택 사항을 따르지만, Revit 뷰포트에 3D View 를 그리는 방식을 제어하는 다른 세팅은 고려하지 않습니다. 예를 들어 3D View 에 설정된 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의 내장 테셀레이션 서비스를 사용하여 씬 지오메트리의 트라이앵글 메시를 생성합니다. 대부분의 경우 언리얼 엔진에서 사용하기에 적합한 지오메트리가 생성됩니다. 하지만 프로젝트에서 이 표면에 문제가 있는 경우, 언리얼 에디터에서 제공되는 메시 복잡도 감소 툴, 예를 들어 프록시 지오메트리 툴 같은 것을 사용할 수 있습니다.
Datasmith Export Settings 패널에서 Revit이 생성하는 메시에 대한 테셀레이션 레벨을 수동으로 지정할 수도 있습니다. 이러한 레벨은 Revit API가 정의합니다.

테셀레이션의 기본 레벨은 레벨 8입니다. 이 값은 Revit FBX Exporter와 동일한 메시 해상도를 제공합니다.
레벨 2 | 레벨 8 |
연결된 모델
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 의 카메라 위치와 방향으로 이 카메라를 배치하여 비슷한 시야를 유지합니다. '레벨 뷰포트(Level Viewport)' 또는 월드 아웃라이너(World Outliner) 에서 이 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 카테고리는 언리얼 에디터에 별도의 레이어로 가져옵니다.

언리얼 에디터에서 이 레이어를 사용하여 카테고리를 표시하고 숨기거나, 할당된 오브젝트를 조사하고 선택할 수 있습니다.
참고로 Revit SDK 가 익스포터에 제공하는 정보가 항상 모든 씬 오브젝트를 카테고리에 연결해 주지는 않습니다. Revit에서 할당된 카테고리가 없는 오브젝트는 언리얼 에디터에서 어떤 레이어에도 할당되지 않습니다.
메타데이터
Revit 뷰의 엘리먼트를 선택하면 해당 엘리먼트에 할당된 모든 인스턴스 프로퍼티 목록이 프로퍼티 팔레트에 표시됩니다. 이 값을 자유롭게 변경하고 커스텀 프로퍼티를 추가할 수 있습니다.
이 프로퍼티를 설정하고 사용하는 방법에 대한 자세한 내용은 Revit 도움말을 참고하세요.
데이터스미스를 사용하여 Revit 씬을 언리얼 에디터로 임포트하는 경우 데이터스미스는 언리얼 엔진 레벨에 해당 엘리먼트에 대해 스태틱 메시 액터를 만들고, 각 Revit 엘리먼트에 대한 모든 인스턴스 프로퍼티를 해당 스태틱 메시 액터의 메타데이터로 할당합니다. 이 메타데이터는 오브젝트의 비어 있지 않은 Revit 타입에 대한 타입 프로퍼티도 포함합니다.
데이터스미스 메타데이터는 항상 키-값 짝의 수평 목록이기 때문에, 프로퍼티 팔레트의 카테고리 제목(위 그림에서 보이는 Constraints, Structural, Dimensions, Identity Data 등)은 포함되지 않습니다. 실제 프로퍼티의 이름과 값만 보존됩니다.
일부 다른 더 기술적인 내부 정보는 컴포넌트 태그를 사용해서 각 액터에 어태치합니다. 특히 언리얼 에디터에서 데이터 준비를 자동화하기 위해 블루프린트나 Python 스크립트를 사용하는 경우, 이 정보를 액터 식별에 유용하게 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- Revit.Instance.Depth. - Revit 씬 계층구조에서 오브젝트의 패밀리 인스턴스 또는 패밀리 심볼의 깊이입니다.
- Revit.Instance.Id. - Revit 문서에서 오브젝트의 패밀리 인스턴스 또는 패밀리 심볼의 ID 입니다.
- Revit.Host.Id. - 오브젝트의 패밀리 인스턴스가 호스트일 때, 이 값이 Revit 문서의 패밀리 인스턴스 호스트 ID 가 됩니다.

Revit 내 데이터스미스 툴바의 Settings 메뉴에서 .udatasmith
파일 또는 다이렉트 링크를 통해 익스포트되는 메타데이터의 양을 필터링할 수 있습니다. 이렇게 하면 익스포트할 데이터의 양을 줄일 수 있으며, 이는 익스포트 성능과 익스포트한 데이터스미스 씬의 크기 모두에 영향을 미칩니다.

메타데이터 익스포트 세팅입니다.
Add Group과 Remove Selected 버튼을 사용하여 익스포트한 데이터스미스 씬에 포함시키려고 하는 메타데이터를 추가하거나 제거합니다.
다음 사항에 유의하세요.
-
메타데이터 카테고리는 Revit에서 정의되며 변경할 수 없습니다.
-
이 필터는
.udatasmnith
파일로 진행되는 일반 익스포트와 다이렉트 링크 구성 모두에 영향을 미칩니다. -
익스포트 필터에 추가한 카테고리 목록은 Revit 파일에 저장됩니다.
-
목록이 완전히 비어 있다면 모든 메타데이터가 익스포트됩니다.
RPC 오브젝트
데이터스미스는 RPC(Rich Photorealistic Content) 오브젝트를 Revit 씬에서 언리얼 엔진으로 가져옵니다. Revit 씬의 RPC 오브젝트 타입마다 데이터스미스는 Revit에서 볼 수 있는 지오메트리를 새 스태틱 메시 에셋으로 임포트합니다. Revit 씬에 배치한 RPC 오브젝트 타입마다 데이터스미스는 언리얼 엔진 레벨에서 3D 스페이스의 동일한 위치 및 오리엔테이션에 새 스태틱 메시 액터를 생성합니다.

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

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