데이터프렙 선택 레퍼런스

데이터프렙 단계에서 씬 엘리먼트를 필터링하고 선택하는 방법에 대해 자세히 살펴봅니다.

이 페이지에서는 비주얼 데이터프렙(Visual Dataprep) 시스템에서 연산하려는 씬 엘리먼트를 확인할 때 사용할 수 있는 각 선택 기준(Select By) 블록에 대해 설명합니다.

선택 기준 블록 타입은 입력할 수 있는 다양한 기준을 제공합니다. 비주얼 데이터프렙 시스템이 데이터프렙 그래프에서 각 액션을 수행할 때는 먼저 해당 액션에 정의된 모든 연산이 임포트된 씬의 전체 액터와 에셋에 적용되어야 한다고 가정합니다. 하지만 이 페이지에서 설명하는 선택 기준 블록이 액션에 포함되는 경우, 비주얼 데이터프렙 시스템에서는 각 씬 엘리먼트가 선택 기준 블록에 구성된 기준에 부합하는지 확인합니다. 씬 엘리먼트가 기준을 충족하지 않는 경우 비주얼 데이터프렙 시스템은 현재 액션에 대해 연산을 적용하는 씬 엘리먼트 목록에서 해당 엘리먼트를 제거합니다. 배경 정보는 데이터프렙 임포트 커스터마이제이션 페이지를 참고하세요.

선택 기준 으로 확인된 씬 엘리먼트에서 수행할 수 있는 연산에 대한 자세한 내용은 데이터프렙 연산 레퍼런스 페이지를 참고하세요.

조건으로 선택

조건으로 선택(Select By Condition) 블록은 해당 엘리먼트에 대해 지정된 조건이 true인 경우에만 씬 엘리먼트를 선택합니다.

클래스임

언리얼 엔진으로 임포트한 이후 클래스가 클래스(Class) 세팅에서 지정한 클래스 이름에 해당하는 경우에만 클래스임(Is Class Of) 블록을 사용하여 씬 엘리먼트를 선택합니다.

이 필터는 에셋, 액터, 컴포넌트를 선택할 수 있습니다.

클래스임

세팅

설명

클래스

이 블록으로 선택하기 위해 씬 엘리먼트가 모두 일치해야 하는 클래스입니다.

자손 클래스 포함(Should Include Child Class)

언리얼 엔진 클래스가 클래스 세팅에서 설정한 클래스로부터 파생된 경우 씬 엘리먼트가 완전히 일치하는 것으로 이 블록이 간주할지 결정합니다.

  • 이 세팅은 기본적으로 활성화되며, 해당 블록은 세팅에서 지정한 클래스로부터 클래스가 파생된 씬 엘리먼트를 모두 허용합니다.

  • 이 세팅을 비활성화하면 해당 블록은 클래스가 세팅과 정확히 일치하는 씬 엘리먼트만 허용합니다.

예를 들어 클래스 세팅을 액터(Actor) 에 설정한 상황에서 고려 중인 씬 엘리먼트에 StaticMeshActor 클래스가 있는 경우를 가정할 수 있습니다. 이 경우 StaticMeshActor 가 베이스 액터 클래스에서 상속하기 때문에 자손 클래스 포함 세팅이 활성화되어 있는 경우에만 클래스임 블록이 해당 씬 엘리먼트를 선택합니다.

재키팅/숨겨짐 선택

이 필터를 사용하려면 데이터프렙 지오메트리 연산(Dataprep Geometry Operations) 플러그인을 활성화해야 합니다.

재키팅/숨겨짐 선택(Jacketing/Select Hidden) 필터를 사용하면 이전에 선택한 하나 이상의 액터 내부에 있는 엘리먼트를 선택할 수 있습니다.

재키팅/숨겨짐 선택

세팅

설명

정확도(Accuracy)

어떤 엘리먼트가 액터의 경계 내부 또는 외부에 있는지 결정하기 위해 데이터스미스에서 사용하는 복셀 그리드의 정확도를 정의합니다.

병합 거리(Merge Distance)

오클루전 테스트에서 채워진 것으로 간주되는 오클루전 볼륨 간격의 최대 크기를 설정합니다.

플로트로 선택

플로트로 선택(Select By Float) 블록은 씬 엘리먼트의 일부 숫자 프로퍼티가 지정된 한계치를 기준으로 보다 작음(Less Than), 보다 큼(Greater Than) 또는 거의 같음(Is Nearly Equal) 인 경우에만 씬 엘리먼트를 선택합니다.

두 숫자 간 차이가 0.0001 미만인 경우 플로트로 선택 블록은 이 두 숫자를 거의 같음 으로 간주합니다.

바운딩 볼륨

씬 엘리먼트가 3D 공간(바운딩 박스)에서 규모를 갖추고 있으며 바운딩 박스의 총볼륨이 세팅에서 지정한 비교값을 충족하는 경우에만 바운딩 볼륨(Bounding Volume) 블록을 사용하여 씬 엘리먼트를 선택합니다.

이 필터는 에셋, 액터, 컴포넌트를 선택할 수 있습니다.

바운딩 볼륨

세팅

설명

드롭다운 메뉴(Dropdown Menu)

오브젝트의 바운딩 볼륨과 지정한 볼륨 사이에서 수행하려는 수학적 비교 타입입니다. 보다 작음, 보다 큼 또는 거의 같음 이 있습니다.

플로트 값(Float Value)

오브젝트의 바운딩 볼륨과 비교하려는 볼륨으로, 단위는 세제곱센티미터(cm³)입니다.

예를 들어 스태틱 메시에 가로세로가 각각 100cm인 바운딩 볼륨이 있는 경우를 가정할 수 있습니다. 여기서 바운딩 박스의 볼륨은 100x100, 즉 10,000cm³입니다. 따라서 10,000보다 큰 수를 기준으로 보다 작음 또는 10,000보다 작은 수를 기준으로 보다 큼 으로 블록을 설정하면 이 블록은 해당 스태틱 메시를 선택합니다.

인티저로 선택

인티저로 선택(Select By Integer) 블록은 씬 엘리먼트의 일부 숫자 프로퍼티가 지정된 한계치를 기준으로 보다 작음, 보다 큼 또는 거의 같음 인 경우에만 씬 엘리먼트를 선택합니다.

트라이앵글 수

트라이앵글 수가 세팅에서 지정한 비교값을 충족하는 스태틱 메시 액터와 스태틱 메시 에셋만 트라이앵글 수(Triangle Count) 블록을 사용하여 선택합니다.

이 필터는 에셋, 액터, 컴포넌트를 선택할 수 있습니다.

트라이앵글 수

세팅

설명

드롭다운 메뉴

메시의 트라이앵글 수와 지정한 숫자 사이에서 수행하려는 수학적 비교 타입입니다. 보다 작음, 보다 큼 또는 거의 같음 이 있습니다.

인티저 값(Integer Value)

오브젝트의 트라이앵글 수와 비교하려는 숫자입니다.

예를 들어 스태틱 메시 액터 또는 에셋에 트라이앵글이 2,000개가 있는 경우, 2,000보다 큰 숫자를 기준으로 보다 작음 또는 2,000보다 작은 숫자를 기준으로 보다 큼 으로 블록을 설정하면 이 블록은 해당 오브젝트를 선택합니다.

버텍스 수

버텍스 수가 세팅에서 지정한 비교값을 충족하는 스태틱 메시 액터와 스태틱 메시 에셋만 버텍스 수(Vertex Count) 블록을 사용하여 선택합니다.

이 필터는 에셋, 액터, 컴포넌트를 선택할 수 있습니다.

버텍스 수

세팅

설명

드롭다운 메뉴

메시의 버텍스 수와 지정한 숫자 사이에서 수행하려는 수학적 비교 타입입니다. 보다 작음, 보다 큼 또는 거의 같음 이 있습니다.

인티저 값

오브젝트의 버텍스 수와 비교하려는 숫자입니다.

예를 들어 스태틱 메시 액터 또는 에셋에 버텍스가 5,000개 있는 경우, 5,000보다 큰 숫자를 기준으로 보다 작음 또는 5,000보다 작은 숫자를 기준으로 보다 큼 으로 블록을 설정하면 이 블록은 해당 오브젝트를 선택합니다.

스트링으로 선택

스트링으로 선택(Select By String) 블록은 씬 엘리먼트의 지정된 스트링 프로퍼티가 지정한 스트링 패턴과 일치하는 경우에만 씬 엘리먼트를 선택합니다.

모든 스트링 조건에서 단일 스트링 또는 스트링 배열을 사용할 수 있습니다. 두 옵션 사이를 토글하려면 단일로 전환/배열로 전환(Switch to Single/Switch to Array) 버튼을 클릭합니다. 스트링 배열의 경우 필터는 배열 엘리먼트 중 최소 하나와 일치하는 오브젝트(필터 제한에 따라 액터, 에셋 및/또는 컴포넌트)를 모두 반환합니다.

단일 스트링 및 스트링 배열 간 전환

스트링으로 선택 블록은 다음과 같이 3개의 스트링 비교를 제공합니다.

세팅

설명

포함(Contains)

고려 중인 씬 엘리먼트의 스트링 프로퍼티 값 내에 제공한 스트링이 전부 포함되는 경우 비교에 성공합니다. 이 타입의 비교에서는 와일드카드를 사용할 수 없습니다. *? 는 문자 그대로 처리됩니다.

와일드카드 일치(Matches Wildcard)

다음 와일드카드 문자를 사용할 때 고려 중인 씬 엘리먼트의 스트링 프로퍼티 전체 길이와 제공한 스트링의 전체 길이가 일치하는 경우 비교에 성공합니다.

  • 패턴 내 별표(*)는 개수와 상관없이 스트링 프로퍼티 문자를 대체할 수 있습니다.

  • 패턴 내 물음표(?)는 스트링 프로퍼티의 0개 또는 1개 문자를 대체할 수 있습니다.

패턴은 스트링의 전체 길이와 일치해야 합니다. 비교하려는 스트링 프로퍼티 값 내에서 나타날 수 있는 부분 스트링을 제공하려면 스트링 패턴 앞뒤에 별표(*)를 붙입니다. 예를 들어 스트링 프로퍼티 값이 MyActorName`인 경우 A*tor 패턴은 일치하지 않지만 *A*tor*`는 일치합니다.

정확하게 일치(Exact Match)

고려 중인 씬 엘리먼트의 스트링 프로퍼티 값과 제공한 스트링이 정확히 일치하는 경우에만 비교에 성공합니다. 길이가 같은 것은 물론이고 동일한 문자가 모두 똑같은 순서로 되어 있어야 합니다.

액터 라벨

지정한 스트링이 월드 아웃라이너 프리뷰(World Outliner Preview) 에 있는 액터에 할당된 이름과 일치하는 경우에만 액터 라벨(Actor Label) 블록을 사용하여 데이터프렙 프리뷰 씬에서 액터를 선택합니다. 이는 월드 아웃라이너 프리뷰 패널에 표시되는 모든 항목을 선택한다는 의미입니다.

이 필터는 액터와 에셋만 선택할 수 있습니다.

액터 라벨

세팅

설명

드롭다운 메뉴

액터 라벨과 제공한 스트링 사이에서 수행하려는 스트링 비교 타입입니다. 자세한 내용은 위의 스트링으로 선택을 참고하세요.

액터 라벨(스트링) 박스(Actor Label (String) Box)

액터 라벨을 기준으로 테스트하려는 스트링 패턴입니다.

메타데이터 값

세팅에 지정한 키(Key) 를 포함하는 데이터스미스 메타데이터가 액터에 있으며 해당 데이터스미스 메타데이터 키의 값이 세팅에 제공한 스트링 값과 일치하는 경우에만 메타데이터 값(Metadata Value) 블록을 사용하여 데이터프렙 프리뷰 씬에서 액터를 선택합니다. 이는 월드 아웃라이너 프리뷰 패널에 표시되는 모든 항목을 선택한다는 의미입니다.

이 필터는 에셋, 액터, 컴포넌트를 선택할 수 있습니다.

메타데이터 값

세팅

설명

드롭다운 메뉴

액터의 데이터스미스 메타데이터 값과 제공한 스트링 사이에서 수행하려는 스트링 비교 타입입니다. 자세한 내용은 위의 스트링으로 선택을 참고하세요.

메타데이터(스트링) 박스(Metadata (String) Box)

액터의 데이터스미스 메타데이터 값을 기준으로 테스트하려는 스트링 패턴입니다.

키 박스(Key Box)

액터의 데이터스미스 메타데이터에서 찾으려는 키의 이름입니다.

예를 들어 임포트 이후 다음과 같은 데이터스미스 메타데이터 세트가 할당된 액터를 가지고 있는 경우를 가정할 수 있습니다.

DatasmithUserData-metadatakey.png

값을 카테고리(Category) 로 설정하면 포함 연산을 선택하고 세 번째 열의 스트링 패턴을 Floor 또는 Floors 로 설정하여 이 액터를 선택할 수 있습니다.

데이터스미스 메타데이터에 대한 자세한 내용은 데이터스미스 메타데이터 사용법 페이지를 참고하세요.

오브젝트 이름

지정한 스트링이 콘텐츠 브라우저 프리뷰(Content Browser Preview) 에 있는 에셋에 할당된 이름과 일치하는 경우에만 오브젝트 이름(Object Name) 블록을 사용하여 에셋을 선택합니다. 이는 콘텐츠 브라우저 프리뷰 패널에 있는 스태틱 메시, 텍스처, 머티리얼, 애니메이션을 선택한다는 의미입니다.

이 필터는 에셋, 액터, 컴포넌트를 선택할 수 있습니다.

오브젝트 이름

세팅

설명

드롭다운 메뉴

씬 엘리먼트의 이름과 제공한 스트링 사이에서 수행하려는 스트링 비교 타입입니다. 자세한 내용은 위의 스트링으로 선택을 참고하세요.

오브젝트 이름(스트링) 박스(Object Name (String) Box)

오브젝트 이름을 기준으로 테스트하려는 스트링 패턴입니다.

액터 레이어

액터가 지정한 레이어에 있는 경우에만 액터 레이어(Actor Layer) 블록을 사용하여 데이터프렙 프리뷰 씬에서 액터를 선택합니다. 이는 월드 아웃라이너 프리뷰 패널에 표시되는 모든 항목을 선택한다는 의미입니다.

이 필터는 액터만 선택할 수 있습니다.

액터 레이어

세팅

설명

드롭다운 메뉴

액터 레이어와 제공한 스트링 사이에서 수행하려는 스트링 비교 타입입니다. 자세한 내용은 위의 스트링으로 선택을 참고하세요.

액터 라벨(스트링) 박스(Actor Label (String) Box)

액터 레이어를 기준으로 테스트하려는 스트링 패턴입니다.

데이터프렙 에디터(Dataprep Editor)에는 뷰포트에 표시되는 레이어를 제어할 수 있는 레이어(Layers) 패널이 없습니다. 하지만 월드 아웃라이너 프리뷰 패널을 사용하여 씬에서 각 액터가 할당된 레이어를 볼 수 있습니다. 이렇게 하려면 월드 아웃라이너 프리뷰 패널 오른쪽의 드롭다운 화살표를 클릭하여 메뉴에서 레이어 를 선택합니다.

월드 아웃라이너 프리뷰에서 레이어 표시

태그 값

태그(Tag) 세팅에 지정한 액터 태그가 씬 엘리먼트에 있는 경우에만 태그 값(Tag Value) 블록을 사용하여 씬 엘리먼트를 선택합니다.

이 필터는 에셋, 액터, 컴포넌트를 선택할 수 있습니다.

액터 태그가 있는 경우

세팅

설명

드롭다운 메뉴

액터 라벨과 제공한 스트링 사이에서 수행하려는 스트링 비교 타입입니다. 자세한 내용은 위의 스트링으로 선택을 참고하세요.

태그(스트링) 박스(Tag (String) Box)

찾으려는 태그의 이름입니다.

이 값과 정확히 일치하는 태그가 있는 액터만 선택됩니다.

예를 들어 액터가 다음과 같은 태그 세트와 함께 임포트되는 경우를 가정할 수 있습니다.

3ds Max에서 기술 정보를 보여주는 액터 태그 목록

액터 태그(Actor Tag) 블록에서 이 액터를 선택하려면 세팅 값을 Max.superclassof: GeometryClass , Max.classof: EditablePolyMesh , Max.handle: 407 로 설정하거나 위 목록에 있는 기타 값으로 설정합니다.

데이터스미스가 임포트한 액터 태그에 대한 자세한 내용은 데이터스미스 임포트 프로세스에 대하여를 참고하세요.

언리얼 엔진의 이전 버전을 위해 작성된 페이지입니다. 현재 언리얼 엔진 5 버전을 위해 업데이트되지 않았습니다.