FBX 테스트 빌더

자동화 시스템의 일부인 FBX Test Builder(FBX 테스트 빌더)는 개별 FBX 파일에 대해 별도의 테스트를 만들 수 있도록 해주는 플러그인입니다. FBX 테스트 빌더는 단일 FBX 파일에 대해 임포트 및 리임포트 후 예상 결과 배열과 비교하는 데 사용할 수 있는 테스트 플랜을 만듭니다. 생성되는 테스트 플랜은 JSON 파일에 저장되며, 테스트 대상 FBX 파일과 확장자를 제외한 이름이 같습니다.

FBX 테스트 빌더로 테스트 플랜을 만들면 FBX 파일에 대해 선택된 작업을 한 뒤 예상 결과 배열과 비교하여 완료된 테스트의 성공 또는 실패 여부를 판가름할 수 있습니다.

플러그인 활성화

FBX 자동화 테스트를 만들기 전, 먼저 편집 > Plugins (플러그인) > Testing (테스팅)에서 FBXAutomationTestBuilder 플러그인을 활성화시켜야 합니다.

클릭하면 원본을 확인합니다.

플러그인 활성화 이후, 엔진을 재시작한 뒤 열어볼 수 있습니다.

클릭하면 원본을 확인합니다.

FBX 테스트 빌더는 파일 메뉴의 창 > 자동화 툴 > FBX Test Builder 로 열 수 있습니다.

클릭하면 원본을 확인합니다.

테스트 플랜 만들기

FBX 테스트 빌더를 사용하면, 선택된 Action (액션 또는 동작)을 수행하고 일련의 Expected Results (예상 결과)를 통해 주어진 FBX 파일에 대해 성공 또는 실패 여부를 판단합니다. 이러한 액션 및 결과 세트를 Test Plan (테스트 플랜)이라 합니다.

액션

각 테스트 플랜에 대해, 수행할 수 있는 핵심 액션은 다섯 가지이며, 각 액션에는 저다마 범주가 있어 올바른 테스트를 수행하는 데 사용됩니다. 이러한 액션과 그 범주는 개괄적으로 다음과 같습니다:

예상 결과

각 테스트 플랜에 대해, 예상 결과 목록을 평가하여 테스트 성공 또는 실패 여부를 판단합니다.

예상 결과 구성

Expected Result (예상 결과) 구성을 위해, 텍스처와 머티리얼이 여섯 개 쓰인 박스 메시가 포함된 FBX 를 예로 들겠습니다.

1. 추가 (+) 버튼을 눌러 Expected Result (예상 결과)를 추가한 뒤 검사에 사용하고자 하는 Expected Preset Type (예상 프리셋 유형)을 선택하세요.

   

2. 테스트하고자 하는 예상 프리셋 유형에 해당하는 Expected Presets Data (예상 프리셋 데이터) 유형을 선택하세요. 이 예제에서는 Mesh Materials Number (메시 머티리얼 수) 유형을 선택하여 포함된 FBX 를 임포트할 때 머티리얼이 여섯 개 들어있는지 검사하도록 하겠습니다.

   

3. Mesh Materials Number (메시 머티리얼 수) 프리셋 유형에서 기대하는 것은 인티저 하나 뿐이며, (필수 데이터 유형은 위 표 또는 프리셋 툴팁 참고) 이를 통해 임포트중인 머티리얼 수를 검사합니다. Expected Presets Data Integer (예상 프리셋 데이터 인티저)를 한 번 클릭하여 예상 결과 검사를 배열에 추가합니다.

   

4. 배열 엘리먼트 0 에는, FBX 와 함께 임포트해야 하는 머티리얼 수를 입력합니다. 이 예제에서 기대하는 머티리얼 수는 6 개입니다.

   

5. 필수 임포트 옵션이 제대로 구성되었는지 확인해야 선택한 예상 프리셋 유형에 필요한 모든 것이 제대로 임포트될 것입니다. 예를 들어 Box FBX 는 FBX 에서 머티리얼과 텍스처를 임포트해야 하므로, Import Materials (머티리얼 임포트)와 Import Textures (텍스처 임포트) 옵션이 켜져있어야 합니다.

   

6. Save JSON (JSON 저장) 버튼을 누르면 Test Plan (테스트 플랜)이 세션 프론트엔드 자동화 탭에 추가됩니다. 이 파일은 Engine/Import/FBX/[NameOfTheFBX] 에서 찾을 수 있습니다.

   	이미지를 클릭하면 원본을 확인합니다.
   FBX 테스트 에디터	세션 프론트엔드 자동화 탭

7. 테스트 실행 이후, 운영 체제는 지정된 LOD(0) 의 메시 머티리얼 수 (6) 가 임포트된 애셋 수와 맞는지 검사합니다.

   이미지를 클릭하면 원본을 확인합니다.

   테스트가 실패한 경우, 자동화 탭에서 실패한 테스트를 선택하면 자동화 테스트 결과 패널 아래에서 그 이유를 확인할 수 있습니다.

   이미지를 클릭하면 원본을 확인합니다.

   또한 메시지 로그 창이 떠 테스트 성공 또는 실패 여부가 표시되며, 세션 프론트엔드 창이 열려있지 않아도 실패 이유를 확인할 수 있습니다.

임포트 옵션

예상 결과 테스트 플랜을 구성한 이후, 테스트하고자 하는 액션이 제대로 임포트/리임포트 설정되어 있는지도 확인해야 합니다. 예를 들어, 머티리얼 일정 갯수를 임포트하는 FBX 를 테스트하는 경우, Import Materials (머티리얼 임포트) 옵션이 켜져있어야 합니다. 이 옵션은 콘텐츠 브라우저를 통해 에디터에 애셋을 임포트할 때 사용할 수 있는 것과 동일한 옵션입니다.

자세한 정보는 FBX 임포트 옵션 문서를 참고하세요.

테스트 플랜 생성 절차

FBX 테스팅을 위한 테스트 플랜 생성 방법은 다음과 같습니다:

1. 테스트하고자 하는 FBX 를 다음 위치로 복사합니다:

            [언리얼 엔진 루트 디렉터리]/Engine/Content/FBXEditorAutomation
   		
   Copy full snippet

   [언리얼 엔진 루트 디렉터리]/Engine/Content/FBXEditorAutomation

2. 이 폴더 위치에 있는 FBX 는 자동으로 Select an FBX file (FBX 파일 선택) 드롭다운 목록에 채워집니다.

   

3. Select a Test Plane (테스트 플랜 선택) 드롭다운을 사용하여 Create new plan (새 플랜 생성)을 선택한 뒤 기존의 것을 선택하면 편집합니다.

   

4. 다음 칸을 채웁니다:

   General: 일반:

   
   • Test Plan Name 테스트 플랜 이름 - 테스트 플랜 목록에서 선택하여 사용할 수 있도록 이름을 지어줍니다.
   • Action 액션 - FBX 파일에 실행할 작업 유형을 선택합니다. 예: 임포트, 리임포트, LOD 추가, LOD 리임포트, 임포트 리로드 등입니다.
   • LOD Index LOD 인덱스 - LOD 리임포트를 사용하는 경우, 리임포트하고자 하는 LOD 인덱스를 여기 입력합니다.
   • Delete Folder Assets 폴더 애셋 삭제 - 테스트 플랜 마지막에 임포트된 애셋을 삭제할지 입니다.

   Expected Results: 예상 결과:

   
   • 예상 프리셋 유형을 설정하고 테스트 완료에 필요한 필수 데이터를 채웁니다.

   Import Options: 임포트 옵션:

   
   • 이 FBX 임포트 테스트를 성공적으로 하기 위해 필요한 임포트 옵션을 설정합니다.

5. Save JSON (JSON 저장) 버튼을 눌러 테스트 플랜을 저장하면 자동화 테스팅 도중 이 FBX 파일에 대해 실행시킬 수 있는 테스트로 추가됩니다.