언리얼 엔진 5 문서가 에픽 디벨로퍼 커뮤니티로 이전되었습니다

데이터스미스 임포터는 처리하는 오브젝트의 메타데이터를 자동으로 가져올 수 있습니다. 메타데이터란 3D 디자인 또는 캐드 프로그램에서 그 오브젝트에 설정해 둔 정보를 말합니다. 메타데이터는 애셋이 나타내는 현실의 기계 부품 또는 건축 요소 관련 정보를 저장하는 데 자주 쓰입니다. 예를 들어 그 부품의 가격, 소재, 무게나 단열 효율과 같은 물리적 속성, 부품에 적용할 수 있는 최대 토그화 같은 사용 정보같은 것입니다. 프로젝트에 필요할 수도 있는 애셋 관련 다른 유형 정보를 메타데이터에 저장할 수도 있습니다.

언리얼 엔진 및 언리얼 에디터에서 이 메타데이터를 유용하게 사용할 수 있는 방법은 두 가지입니다.

• 애셋 아피프라인에서 - 애셋을 임포트하고 레벨을 구성할 때 메타데이터를 사용하면 다른 처리가 필요한 애셋과 액터 유형을 구분하는 데 도움이 됩니다. 예를 들어,
  

  • 데이터스미스 임포트 프로세스 도중 최종 씬에 필요치 않아 임포트를 생략할 수 있는 애셋 유형을 식별할 수 있습니다.

  • 임포트 후 레벨의 액터 중 병합, 결합, 대체, 또는 그 머티리얼을 대체할 액터를 식별할 수 있습니다.

• 게임 런타임에서 - 런타임에 메타데이터를 사용하면, 소스 디자인 툴에서 액터에 설정된 정보를 사용자에게 표시할 수 있습니다. 예를 들어,

  • 레벨의 오브젝트에 구조적 특성 관련 정보가 담긴 BIM 데이터가 있는 경우, 상호작용형 체험에서 플레이어가 씬의 그 오브젝트를 선택하면 그 정보를 시각화할 수 있습니다.

  • 제품 컨피켜레이터 프로젝트에서 플레이어가 여러 디자인 옵션 중 하나를 선택하면, 게임플레이 로직을 통해 보이는 애셋에 할당된 비용 메타데이터에 따라 플레이어의 현재 선택 비용 총합을 계산하여 표시할 수 있습니다.

여기서는 데이터스미스 임포트 프로세스를 통해 언리얼로 메타데이터를 가져오는 방법, 에디터와 런타임 양쪽에서 스크립트를 통해 액세스하는 법을 설명합니다.

메타데이터 소스

현재 메타데이터를 임포트를 지원하는 디자인 툴은 다음과 같습니다.

• Autodesk 3ds Max

• Autodesk Revit

• Dassault Systèmes Solidworks

• Trimble SketchUp Pro

• Maxon Cinema 4D

Autodesk 3ds Max

3ds Max 오브젝트의 Object Properties 창 User Defined 탭에 메타데이터를 추가합니다.

3ds Max 에서 메시의 이 패널을 여는 방법은 다음과 같습니다.

1. 아웃라이너 또는 뷰포트에서 메시를 선택합니다.

2. 우클릭 컨텍스트 메뉴에서 Properties 또는 Object Properties , 또는 메인 메뉴의 Edit > Properties 를 선택합니다.

3. 이 패널에 메타데이터를 위와 같이 키 = 값 짝으로 입력합니다.

   주의할 점은 등호 (=) 양쪽에 한 칸 띄워야 합니다 . 띄우지 않으면 데이터스미스가 인식하지 못해 예상대로 임포트할 수 없습니다.

Autodesk Revit

Revit 뷰의 엘리먼트를 선택하면, 해당 엘리먼트에 할당된 모든 인스턴스 프로퍼티 목록이 Properties 팔레트에 표시됩니다. 이 값을 자유롭게 변경하고 커스텀 프로퍼티를 추가할 수 있습니다.

이 프로퍼티 설정 및 사용법 관련 자세한 내용은 Revit help 페이지를 참고하세요.

데이터스미스를 사용해 Revit 씬을 언리얼 에디터로 임포트할 때, 언리얼 엔진 레벨에 해당 엘리먼트에 대해 스태틱 메시 액터를 만들고, 각 Revit 엘리먼트에 대한 모든 인스턴스 프로퍼티를 그 스태틱 메시 액터의 메타데이터로 할당합니다. 이 메타데이터는 오브젝트의 비어 있지 않은 Revit 유형에 대한 유형 프로퍼티도 포함합니다.

데이터스미스 메타데이터는 항상 키-값 짝의 수평 목록이기 때문에, Properties 팔레트의 (위 그림에서 보이는 Constraints , Structural , Dimensions , Identity Data 같은) 카테고리 제목은 포함되지 않습니다. 실제 프로퍼티의 이름과 값만 보존됩니다.

Dassault Systèmes SolidWorks

SolidWorks 파일을 임포트할 때, 데이터스미스가 생성하는 스태틱 메시 액터 각각에 프리셋 메타데이터 최소량을 추가하여, 원본 Solidworks 디자인에서 그 메시의 어셈블리와 파트 이름을 나타냅니다. 하지만 데이터스미스는 현재 파트와 어셈블리에 추가한 커스텀 메타데이터 프로퍼티를 가져오지 않습니다.

Trimble SketchUp Pro

SketchUp 에서 만든 컴포넌트 각각에 대해, 가격, 크기, 상태와 같은 Advanced Attributes 를 추가할 수 있습니다.

데이터스미스는 이 Advanced Attributes 를 전부 임포트하며, Type 값도 있으면 메타데이터에 포함시킵니다.

Maxon Cinema 4D

Cinema 4D 에서, 씬의 각 오브젝트에 User Data 를 추가하려면 Attributes 패널에서 User Data > Manage User Data 를 선택하면 됩니다.

그 방법 관련 자세한 정보는 Cinema 4D documentation 페이지를 참고하세요.

데이터 변환에 적용되는 중요한 사항 몇 가지입니다:

• Cinema 4D 에서, User Data 를 계층 그룹으로 체계를 구성할 수 있지만, 언리얼 엔진의 데이터스미스 메타데이터는 항상 키와 값을 평평한 목록으로 저장합니다. User Data 에 위와 같이 그룹이 있는 경우, 데이터스미스는 계층구조를 평탄화시켜 모든 그룹의 메타데이터 키 전부를 하나의 평평한 목록에 넣습니다.

  예를 들어, 아래 이지미에서, 그룹이 임포트되지 않은 것이 보이며, 중첩된 ( IntegerData , VectorData , ColorData , BooleanData ) 프로퍼티는 StringData 및 FloatData 의 형제로 이동되었습니다.

• Cinema 4D 에서 User Data 에 설정한 데이터 유형과 상관 없이, 데이터스미스 메타데이터에 저장되는 값은 항상 스트링입니다. 가능한 한 데이터스미스는 원본 데이터 값을 스트링으로 변환해서 파싱을 통해 관련 정보를 추출할 수 있도록 하고 있습니다. 하지만 일부 복잡하거나 특수 목적 Cinema 4D 데이터 유형은 지원하지 않는데, 예를 들어 그레이디언트, 다른 씬 오브젝트로의 링크, 우선순위 값, 스플라인 등입니다.

  예를 들어, 아래 이미지에서 ColorData 및 VertexData 항목이 스트링으로 변환되어 각각 원본 컬러 및 버텍스의 RGB 및 XYZ 값이 들어있는 모습을 볼 수 있습니다.

• 데이터스미스는 메타데이터 키 이름에 영숫자, 하이픈, 밑줄만 허용합니다. User Data 이름에 다른 글자가 포함된 경우, 밑줄로 자동 변환됩니다.

다음 이미지는 위에 표시된 User Data 임포트 결과를 나타냅니다:

언리얼 에디터에서 메타데이터 보기

데이터스미스 임포트 프로세스가 완료된 이후, 디테일 패널의 Asset User Data 섹션 아래에서 레벨의 스태틱 메시 액터의 메타데이터를 볼 수 있습니다.

데이터스미스 메타데이터는 현재 에디터에서 읽기 전용입니다.

블루프린트 및 Python 에서 메타데이터 액세스

씬 오브젝트에 연관된 메타데이터에 액세스하는 방법은 여러가지입니다. 그 방법은 메타데이터에 액세스할 시점이 데이터스미스 임포트 프로세스 도중인지 완료 이후인지에 따라 달라집니다.

임포트 도중 메타데이터 액세스

데이터스미스 임포트 프로세스 도중 메타데이터에 액세스하려면, 예를 들어 씬에 언리얼 애셋을 생성하기 전 필터로 거를 메시를 식별하려는 경우, 데이터스미스 씬 또는 데이터스미스 CAD 씬에서 메타데이터를 읽으면 됩니다. 입력 프로세스 도중 스크립트를 실행하는 방법 관련 배경 정보는 데이터스미스 임포트 프로세스 커스터마이징 문서를 참고하세요.

데이터스미스 씬의 메시 액터 엘리먼트 에 붙은 메타데이터를 찾을 수 있습니다.

key_name = "name"
remove_keyword = "Clutch"
meshes_to_skip = set([])
# "name" 키를 가진 씬 엘리먼트를 전부 구합니다.
objects_and_values = ds_scene_in_memory.get_all_objects_and_values_for_key(key_name, unreal.DatasmithMeshActorElement)
objects = objects_and_values[0]
values = objects_and_values[1]
# 반복처리하면서 값이 키워드에 일치하는 것을 찾습니다.
for index, value in enumerate(values):
    if remove_keyword in value:
        print("removing actor named: " + value)
        # 씬에서 메시 액터 엘리먼트를 제거하고, 목록에 나중에 제거할 메시 엘리먼트를 넣습니다.
        mesh_actor = objects[index]
        mesh = mesh_actor.get_mesh_element()
        meshes_to_skip.add(mesh)
        ds_scene_in_memory.remove_mesh_actor(mesh_actor)
# 임포트할 필요가 없는 모든 메시를 제거합니다.
for mesh in meshes_to_skip:
    mesh_name = mesh.get_element_name()
    print("removing mesh named " + mesh_name)
    ds_scene_in_memory.remove_mesh(mesh)

임포트 이후 메타데이터에 액세스

임포트 프로세스가 데이터스미스 또는 CAD 씬을 마무리하여 언리얼 애셋과 액터로 가져왔으면, 데이터스미스 씬에 있는 각 메시 엘리먼트의 메타데이터를 그 스태틱 메시 애셋의 인스턴스를 표현하는 레벨의 모든 액터에도 적용합니다. 그런 다음 블루프린트 또는 Python 을 사용하여 레벨의 스태틱 메시 액터 일부 또는 전부에 대한 메타데이터를 얻을 수 있습니다.

import unreal
new_actor_name = "Exterior Walls"
metadata_key = "Type"
metadata_value = "Wall: Exterior"
meshes_to_join = set([])
# 현재 레벨의 액터를 대상으로 반복처리합니다.
all_actors = unreal.EditorLevelLibrary.get_all_level_actors()
for actor in all_actors:
    # 위에서 설정한 키가 있으면 그에 대한 이 애셋의 데이터스미스 메타데이터 값을 구합니다.
    actor_value = unreal.DatasmithContentLibrary.get_datasmith_user_data_value_for_key(actor, metadata_key)
    # 키가 존재하고, 그 값에 위에 설정한 키워드가 있으면, 목록에 액터를 추가합니다.
    if actor_value and metadata_value in actor_value:
        print("found a matching actor: " + actor_value)
        meshes_to_join.add(actor)
# 위에서 찾은 모든 액터를 하나의 액터 아래 여러 컴포넌트로 합칩니다.
options = unreal.EditorScriptingJoinStaticMeshActorsOptions(destroy_source_actors=True, new_actor_label=new_actor_name, rename_components_from_source=True)
unreal.EditorLevelLibrary.join_static_mesh_actors(meshes_to_join, options)
print "Merged all actors!"